LifeOS AI Dashboard 🧠

A beautiful, high-performance personal productivity system that combines task management, journaling, habits, and AI coaching — powered by behavioral psychology principles.

---

✨ Features

• Task Management — Daily/Weekly/Long-term tasks with Top 3 priority focus, auto carry-forward
• Daily Journal — Track what you did, what you avoided, and energy levels (1–5)
• Habit Tracker — Max 5 habits with streak tracking and visual progress bars
• Focus Timer — Pomodoro timer with session logging and duration presets
• AI Coach — Groq-powered strict life coach for planning, productivity analysis, and improvement suggestions
• Analytics Dashboard — Weekly progress charts, completion stats, and streak indicators
• Dark UI — Glassmorphism design with smooth animations via Framer Motion

---

🛠 Tech Stack

Layer	Technology
Frontend	React 18 + Vite + Tailwind CSS
Backend	Node.js + Express
Database	MongoDB (Mongoose)
AI	Groq API (LLaMA 3.3 70B)
Auth	JWT
UI	Framer Motion, Lucide Icons, Recharts

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• MongoDB (local or MongoDB Atlas free tier)
• Groq API key (console.groq.com)

1. Clone the repo

git clone https://github.com/yourusername/LifeOS.git
cd LifeOS

2. Setup Backend

cd server
npm install

# Create .env file
cp ../.env.example .env
# Edit .env with your MongoDB URI, JWT secret, and Groq API key

npm run dev

3. Setup Frontend

cd client
npm install
npm run dev

4. Open in browser

Navigate to http://localhost:5173

---

📁 Project Structure

LifeOS/
├── client/                 # React + Vite frontend
│   ├── src/
│   │   ├── components/     # All UI components
│   │   ├── App.jsx         # Main app with auth context
│   │   ├── main.jsx        # Entry point
│   │   └── index.css       # Tailwind + glassmorphism styles
│   ├── tailwind.config.js
│   ├── vite.config.js
│   └── package.json
├── server/                 # Express backend
│   ├── models/             # Mongoose schemas
│   ├── routes/             # API routes
│   ├── middleware/          # JWT auth middleware
│   ├── server.js           # Express app
│   └── package.json
├── .env.example
├── .gitignore
└── README.md

---

🔌 API Endpoints

Method	Endpoint	Description
POST	/api/auth/register	Create account
POST	/api/auth/login	Login
GET	/api/auth/me	Get current user
GET/POST/PATCH/DELETE	/api/tasks	Task CRUD
GET	/api/tasks/top	Top 3 priority tasks
POST	/api/tasks/carry-forward	Carry forward incomplete tasks
GET/POST/DELETE	/api/journals	Journal CRUD
GET/POST/DELETE	/api/habits	Habit CRUD
POST	/api/habits/:id/complete	Complete habit for today
GET/POST	/api/focus	Focus session CRUD
GET	/api/stats/dashboard	Dashboard stats
GET	/api/stats/weekly	Weekly chart data
POST	/api/ai/plan-day	AI daily plan
POST	/api/ai/analyze-productivity	AI productivity analysis
POST	/api/ai/summarize-journal	AI journal summary
POST	/api/ai/suggest-improvements	AI improvement suggestions

---

🧠 Psychology Principles

• Top 3 Rule: Only 3 priority tasks shown prominently to reduce decision fatigue
• Habit Limit: Max 5 habits to prevent overwhelm
• Streak Tracking: Visual streak indicators for dopamine reinforcement
• Energy Tracking: Daily energy levels to identify patterns
• AI Coaching: Strict but helpful feedback to drive accountability
• Auto Carry-Forward: No task gets forgotten

---

🚢 Deployment

Service	Platform
Frontend	Vercel
Backend	Render / Railway
Database	MongoDB Atlas (free tier)

---

📄 License

MIT

🏗️ Architecture (SOLID)

This project has been refactored into a scalable, production-grade architecture.

Backend Structure (Layered)

• Routes: src/modules/*/ - Declarative HTTP routing
• Controllers: src/modules/*/ - HTTP request extraction and response wrapping
• Services: src/modules/*/ - Pure business logic
• Repositories: src/modules/*/ - Database abstraction layer
• Core: src/core/ - Centralized config, logger, and DB connection

Frontend Structure (Feature-Based)

• Features: src/features/ - Domain-specific views and logic (tasks, habits, etc.)
• Services: src/services/ - Clean API abstraction using Axios interceptors
• Context: src/context/ - Global state management