Please Star License

Built with Lovable GitHub User TypeScript React Tailwind CSS

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)

1. Clone the repository:

git clone https://github.com/ossUser-Swift/study-progress-hub.git
cd study-progress-hub

2. Install dependencies:

npm install

3. Set up environment variables (automatically provided in Lovable)

4. Start the development server:

npm run dev

5. Open your browser and navigate to http://localhost:8080

1. Create an Account: Sign up with your email and password
2. Create Your First Task: Click the "Add Task" button
3. Explore Views: Try out different views (List, Kanban, Calendar, Timeline)
4. Set Up Notes: Navigate to the Notebook tab to create your first note
5. 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.