Smart • Fast • Minimal • Powered by OpenAI + Google Gemini
LUCA is a smart, interactive study assistant built with React + Vite, crafted to deliver a clean, modern, and highly responsive learning experience. Designed with a strong focus on minimalism and clarity, LUCA transforms traditional study workflows into an intuitive, AI-powered environment.
- Neon-purple theme
- Manrope font
- Smooth micro-animations
- Timestamped message bubbles
- Draggable mini panels
- Expandable utility tools:
- Focus Timer
- Stopwatch
- Notes
- Multi-tool popups
- Blur-aware UI to prevent overlapping visual noise
 |
 |
 |
 |
 |
 |
| Area | Technology |
|---|---|
| AI Models | OpenAI GPT, Google Gemini |
| Frontend | React 19, Vite, CSS Modules, Manrope Font, HTML, CSS, JavaScript |
| Dev Dependencies | React-DOM 19, ESLint, @vitejs/plugin-react |
| Deployment | Vercel |
| Version Control | Git + GitHub |
- Real-time messaging with timestamps and smooth scroll-to-bottom logic using message refs.
- Typing indicator animations with animated dots.
- File uploads with contextual AI responses.
- Full conversation history maintained in component state.
- Right-side floating menu for user settings:
- Language, region, and study preferences
- Appearance customization (theme, fonts, bubble styles)
- Notification preferences (study reminders, focus alerts)
- Privacy & storage controls
- Floating UI elements:
- Draggable mini-panels
- Expand-on-demand tools (Focus timer, Stopwatch, Notes)
- Blur logic ensures floating tools don’t conflict with main UI.
Follow these steps to set up and run the project locally:
# 1. Clone the repository
git clone https://github.com/WafryAhamed/Luca.git
cd Luca
# 2. Install dependencies
npm install
# 3. Run the development server
npm run dev
# The app will be available at http://localhost:5173
# 4. Build the project for production
npm run build
# 5. Preview the production build
npm run preview
# 6. Lint the code for errors or style issues
npm run lint
# 7. (Optional) Fix any vulnerabilities automatically
npm audit fix --force
We welcome contributions from everyone! For major changes, please open an issue first to discuss what you’d like to change.
Before submitting a pull request, make sure your code follows the project’s coding style and passes all tests. Any ideas, bug fixes, or improvements are appreciated!
Thank you for helping make this project better! 💖
