A comprehensive, AI-powered task management system designed specifically for students to organize homework, track progress, manage study time, and boost productivity.
Try it Live | 📖 Documentation | 🐛 Report Bug | 💡 Request Feature
- Create & Organize Tasks: Categorize by homework, revision, projects, or other
- Priority Levels: Set low, medium, or high priority for better focus
- Progress Tracking: Track completion percentage with visual sliders
- Subtask Management: Break down large tasks into manageable subtasks
- Task Dependencies: Link related tasks to maintain proper workflow
- Recurring Tasks: Set up daily, weekly, or monthly recurring assignments
- Full Markdown Support: Rich text formatting in task descriptions and notes
- List View: Traditional task list with detailed information
- Kanban Board: Drag-and-drop cards across Todo, In Progress, and Done columns
- Calendar View: See all tasks on a monthly calendar with due dates
- Timeline View: Visualize task schedules and dependencies on a timeline
- Smart Task Analysis: AI analyzes task complexity and suggests time estimates
- Study Tips: Get personalized tips based on task category and difficulty
- Priority Recommendations: AI suggests optimal priority levels
- Weekly Summaries: Automatic AI-generated weekly performance reports
- Subtask Generation: AI breaks down complex tasks into subtasks
- Built-in Timer: Track study time for each task with start/stop timer
- Session History: View all time tracking sessions
- Total Time Spent: See cumulative time across all tasks
- Completion Analytics: Compare estimated vs actual time spent
- Rich Text Notes: Create notes with full markdown support
- Folder Organization: Organize notes in custom folders
- Tag System: Tag notes for easy filtering and search
- Task Linking: Associate notes with specific tasks
- Markdown Toolbar: Quick formatting buttons for markdown syntax
- Progress Charts: Visual graphs showing task completion over time
- Category Breakdown: See time distribution across different categories
- Completion Statistics: Track tasks completed, in progress, and pending
- Study Patterns: Identify your most productive days and categories
- Profile Customization: Set display name and preferences
- Notification Controls: Toggle email notifications and task reminders
- View Preferences: Choose your default view (list, kanban, calendar, timeline)
- Theme Selection: Light, dark, or system-based theme
- Timezone & Language: Regional settings for accurate due dates
- Data Export: Export all your tasks and notes to JSON
- User Authentication: Secure email/password authentication
- Row-Level Security: Database-level isolation between users
- Encrypted Storage: All data encrypted at rest
- Session Management: Automatic token refresh and secure logout
- Node.js 18+ and npm
- Modern web browser (Chrome, Firefox, Safari, Edge)
- Clone the repository:
git clone https://github.com/ossUser-Swift/study-progress-hub.git
cd study-progress-hub- Install dependencies:
npm install-
Set up environment variables (automatically provided in Lovable)
-
Start the development server:
npm run dev- Open your browser and navigate to
http://localhost:8080
- Create an Account: Sign up with your email and password
- Create Your First Task: Click the "Add Task" button
- Explore Views: Try out different views (List, Kanban, Calendar, Timeline)
- Set Up Notes: Navigate to the Notebook tab to create your first note
- Adjust Settings: Click the Settings icon to customize your experience
- React 18: Modern UI framework
- TypeScript: Type-safe development
- Vite: Fast build tool and dev server
- Tailwind CSS: Utility-first styling
- Shadcn UI: High-quality component library
- React Router: Client-side routing
- React Hook Form: Form management
- Zod: Schema validation
- Date-fns: Date manipulation
- Recharts: Data visualization
- React Markdown: Full markdown support with KaTeX math
- PostgreSQL: Relational database with full ACID compliance
- Row-Level Security (RLS): User data isolation at database level
- Edge Functions: Serverless functions for AI integration
- Authentication: JWT-based authentication with automatic refresh
- Lovable AI Gateway: Multi-model AI access
- Gemini 2.5 Flash: Fast AI analysis and summaries
- Streaming Responses: Real-time AI output
homework-tracker/
├── src/
│ ├── components/ # Reusable UI components
│ │ ├── ui/ # Shadcn UI components
│ │ ├── TaskCard.tsx
│ │ ├── KanbanView.tsx
│ │ ├── CalendarView.tsx
│ │ ├── NotebookView.tsx
│ │ ├── MarkdownRenderer.tsx
│ │ └── ...
│ ├── pages/ # Route pages
│ │ ├── Index.tsx # Main dashboard
│ │ ├── Auth.tsx # Login/signup
│ │ └── Settings.tsx # User settings
│ ├── hooks/ # Custom React hooks
│ │ ├── useTasks.ts # Task management hook
│ │ └── useLocalStorage.ts
│ ├── types/ # TypeScript type definitions
│ │ └── task.ts
│ ├── lib/ # Utility functions
│ │ └── utils.ts
│ └── integrations/ # External integrations
│ └── supabase/
├── supabase/
│ ├── functions/ # Edge functions
│ │ ├── analyze-task/
│ │ └── generate-weekly-summary/
│ └── migrations/ # Database migrations
├── public/ # Static assets
└── package.json
- Authentication Required: All features require user login
- User Data Isolation: Users can only access their own data via RLS policies
- Secure Edge Functions: JWT verification on all API endpoints
- Input Validation: Comprehensive validation on all user inputs
- XSS Protection: Markdown sanitization to prevent script injection
- SQL Injection Prevention: Parameterized queries and RLS policies
- Session Security: Automatic token refresh and secure logout
The app supports light and dark themes with automatic system detection. Customize colors in src/index.css.
Modify task categories in src/types/task.ts:
export type TaskCategory = 'homework' | 'revision' | 'projects' | 'other';- tasks: Core task data with progress tracking and markdown support
- subtasks: Task breakdowns
- notes: Rich text notes with markdown rendering
- tags: Custom tags for organization
- task_tags: Many-to-many relationship
- task_time_sessions: Time tracking records
- ai_analysis: AI-generated insights
- weekly_summaries: AI-generated weekly reports
- user_settings: User preferences and settings
All tables have proper RLS policies ensuring user data isolation.
Contributions are welcome! Please read our Contributing Guidelines before submitting a Pull Request.
This project is licensed under the MIT License - see the LICENSE.md file for details.
- Built with Lovable - AI-powered development platform
- UI components from Shadcn UI
- Icons from Lucide
- Backend by Lovable Cloud (powered by Supabase)
- AI powered by Lovable AI Gateway (Gemini models)
For support, open an issue on GitHub or visit our live demo.
- Mobile app (React Native)
- Collaborative study groups
- Pomodoro timer integration
- Study habit analytics dashboard
- Integration with external calendars
- PDF annotation tools
- Flashcard system
- Grade tracking
- Course schedule management
- Voice notes and dictation
Made with ❤️ for students everywhere.