AI-powered habit-tracking platform
Theme: "Break the Loop, Create the Future" — Agentic AI Track "Deadlines messed up? We ZAP it." Deadlines messed up? We ZAP it.
- Features
- Tech Stack
- Installation
- Environment Setup
- Usage
- Project Structure
- Roadmap
- Team
- Contributing
- License
-
Student Profile Management - Track your school, major, and graduation
-
Smart Task Management - Organize tasks with priorities and deadlines
-
Zero-Clash Detection - Automatically detect conflicting deadlines
-
Streak Tracking - Build consistency with XP and level system
-
Beautiful UI - Clean, modern interface with Tailwind CSS
-
Collaboration - Group projects and shared workspaces
-
Focus Mode - Pomodoro timer and deep work sessions
-
AI Insights - Smart recommendations and study agents
| Category | Technology |
|---|---|
| Frontend | React 18, Vite |
| Styling | Tailwind CSS v4 |
| Backend | Firebase (Auth, Firestore) |
| State | React Context, Zustand |
| Routing | React Router v6 |
| UI | Framer Motion, Lucide Icons |
# Clone the repository
git clone https://github.com/aarushi2512/ZAP.git
cd ZAP
# Install dependencies
npm install
# Create environment file
cp .env.example .env
# Edit .env with your Firebase credentials
npm run dev
ZAP is a student-focused productivity enhancement layer, Smart Deadline Planner for Students. It adds academic planning, deadline management, zero-clash scheduling, it detects procrastination by students and has AI-powered study assistance.
## Project Structure
ZAP/
├── src/
│ ├── 📂 components/ # React components
│ │ ├── auth/ # Login, Register, Onboarding
│ │ ├── dashboard/ # Today, Progress, Insights, Agents
│ │ ├── layout/ # Sidebar, Layout, Header
│ │ └── tasks/ # TaskCard, TaskModal, TaskList
│ ├── 📂 hooks/ # Custom React hooks
│ ├── 📂 services/ # Firebase & API services
│ ├── 📂 store/ # State management (Zustand)
│ ├── 📂 types/ # Type definitions
│ ├── 📂 utils/ # Helper functions
│ ├── 📂 contexts/ # React contexts
│ └── pages/ # Page components
├── 📂 public/ # Static assets
├── firestore.rules # Firebase security rules
├── .env.example # Environment template
├── package.json
└── README.md
## Usage
```bash
# Development server
npm run dev
# Build for production
npm run build
# Preview production build
npm run preview- Student profile management (school, major, year, graduation)
- Extended registration with academic details
- Firestore security rules
- Feature flag system (ZAP_ENABLED)
- XP and level tracking
- Deadline tracking for tasks
- Automatic clash detection
- Priority management (critical, high, medium, low)
- Time estimation per task
- Urgency indicators
- Group project management
- Shared notes and resources
- Team task assignments
- Role-based permissions
- Collaborative workspaces
- Pomodoro timer integration
- Focus session tracking
- Distraction blocking
- Deep work scheduling
- Session analytics
- AI-powered study agents
- Predictive performance insights
- Personalized recommendations
- Smart rescheduling suggestions
- Learning pattern analysis
- Block 1: Foundation
- Block 2: Zero-Clash Engine
- Block 3: Collaboration
- Block 4: Focus Mode
- Block 5: AI & Insights
<<<<<<< HEAD
- Fork the repo
- Create your feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request =======
- Fork the repository
- Create your feature branch:
git checkout -b feature/your-feature - Commit your changes:
git commit -m 'Add feature' - Push to the branch:
git push origin feature/your-feature - Open a Pull Request
- Aarushi Arora - @aarushi2512
- Swayam Kandarkar
- Dhvani Mistry
- Prishita Mali
- Icons by Lucide React
- UI components with Framer Motion