A beautifully designed, unified dashboard engineered to maximize cognitive potential, maintain deep work flow states, and intelligently adapt to your study and work patterns.
- Dynamic Study Planner: Automatically generates weekly subject schedules based on your stream, exam dates, and available hours.
- RAG Notes Assistant: Upload your PDF study materials and chat instantly with an AI that retrieves precise answers directly from your notes.
- Smart Nudges & Preparation Advice: Daily AI-generated insights analyzing your focus history to give actionable productivity advice.
- Floating AI Widget: A premium, globally accessible AI chat assistant ready to provide coaching and context-aware feedback at any moment.
- Pomodoro Timer: Customizable focus intervals, visual progress rings, and adaptive timer suggestions based on drop-off analysis.
- Kanban Task Manager: Drag-and-drop workflow tracking with custom tags, priority levels, and daily persistence.
- Clock In/Out Ecosystem: Comprehensive daily session tracking with rich, calendar-based activity logs.
- Deep Analytics: Interactive productivity heatmaps, focus trends, task completion rates, and gamified level progressions.
- Spotify Premium Controller: Manage your deep-work playlists and control playback directly from your dashboard without breaking focus.
- Secure Authentication: Robust JWT-based auth and integrated Google OAuth sign-in.
- Admin Panel: User role management (RBAC), system metrics, and audit logs.
| Domain | Technologies |
|---|---|
| Frontend | React 19, TypeScript, Tailwind CSS 4, Framer Motion, Zustand, Shadcn/ui, Vite |
| Backend | Node.js, Express 5, MongoDB (Mongoose), Google Generative AI (Gemini), Multer |
| DevOps & Testing | Vercel (CI/CD), Jest, Supertest, Vitest, Playwright (E2E) |
git clone https://github.com/codxbrexx/FocusMaster.git
cd FocusMasterCreate a .env file in the backend/ directory:
PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_super_secret_jwt_key
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
GEMINI_API_KEY=your_google_gemini_api_key
DEFAULT_LLM_MODEL=gemini-2.0-flashcd backend
npm install
npm run devCreate a .env file in the frontend/ directory:
VITE_API_URL=http://localhost:5000/api
VITE_GOOGLE_CLIENT_ID=your_google_client_idcd frontend
npm install
npm run devComprehensive architecture guides, API specifications, and development workflows can be found in the docs/ directory.
Designed & Developed by @codxbrexx
Productivity Workspace | MIT License
Productivity Workspace | MIT License