AI-powered student productivity assistant
EduFlow AI is a full-stack student assistant SaaS that brings study planning, notes, productivity tracking, mood support, and AI learning tools into one clean dashboard. It helps students stay organized, build consistent daily study streaks, and study collaboratively in real-time.
Students often use too many separate tools for planning, notes, doubts, focus tracking, and motivation. EduFlow AI was built to solve that problem by combining the most useful student workflows in one place.
With EduFlow AI, students can manage study tasks, create and organize notes, ask AI-powered academic questions, track productivity, monitor mood, build daily study streaks, collaborate in real-time study rooms, manage weekly timetables, and view weekly progress — all from a single dashboard.
The goal is simple: help students stay organized, consistent, and supported while studying.
- Study Planner with full CRUD support
- Task completion tracking with priority levels (High, Medium, Low)
- Notifications and reminders for due tasks
- Daily streak tracking with animations and badges
- Weekly Progress Graph for completed study tasks
- Floating Task Checklist widget for quick task access
- Notes CRUD with organized note management
- AI Notes Generator for prompt-based study notes
- Export notes as PDF
- Shareable notes links
- Generates a personalized 7-day study timetable based on subjects, deadlines, and priorities.
- Combines rule-based logic (urgent deadlines first) with AI for smarter recommendations.
- Lets users add weak subjects and paste syllabus text for more tailored plans.
- Automatically retries if the AI service is briefly down, with a backup model as a safety net.
- AI Doubt Solver with clear academic explanations
- AI-generated study notes from topics or learning goals
- AI Recommendations ("Smart Study Actions") for personalized study strategies
- Multi-agent AI architecture with specialized agents
- LLM-powered academic assistance
- Productivity Tracker with session logging and subject-wise focus tracking
- Mood Tracker with daily mood logging and notes
- Mood-based suggestions for study breaks and wellness
- Dashboard overview cards
- Real-time study rooms joinable via room ID
- Synchronized focus timer shared across members
- Collaborative shared notes pad
- Interactive room chat
- Active member directory
- Structured class timetable with Grid and List views
- AI Schedule Parser to auto-populate timetable from plain text
- Color-coded subject slots with teacher and location info
- Supabase sync with local storage fallback
- Theme support with premium dark UI
- Responsive design across desktop, tablet, and mobile
- Contact form with email integration via Resend
EduFlow AI uses AI APIs through Google Gemini / LLM providers to make studying more interactive and helpful.
Students can ask academic questions and receive clear, AI-generated explanations. This helps reduce friction when they get stuck while studying.
Students can generate structured study notes from prompts, topics, or learning goals. This makes it easier to start studying without staring at a blank page.
The recommendation engine analyzes study patterns, mood data, and task completion to suggest personalized study strategies such as break suggestions, streak protection alerts, and optimal study times.
The project includes a multi-agent AI approach, allowing different AI workflows to support different parts of the app:
tutor-agent— Academic doubt solving and concept explanationsnotes-agent— Structured study notes generationplanner-agent— Task and deadline adjustmentsmood-agent— Mood-aware study suggestionsproductivity-agent— Focus and session insightstimetable-agent— Natural language schedule parsingrecommendation-agent— Personalized study action alerts
- Next.js
- TypeScript
- Tailwind CSS
- React
- Supabase Auth
- Supabase Database
- Row Level Security policies
- Google Gemini API
- AI-powered notes generation
- AI-powered doubt solving
- PDF export
- Notifications and reminders
- Responsive dashboard UI
git clone https://github.com/prabhakarshukla/EduFlow-AI.git
cd EduFlow-AInpm installCreate a .env & .env.local file in the root directory:
.env{
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
}
env.local{
AI_PROVIDER=gemini
GEMINI_API_KEY=
GEMINI_MODEL=gemini-2.5-flash-lite
RESEND_API_KEY=
CONTACT_TO_EMAIL=
RESEND_FROM_EMAIL=
}Add your Supabase project URL, Supabase anon key, and AI API key. EduFlow AI uses Gemini when AI_PROVIDER=gemini, and can fall back to the OpenRouter/OpenAI-compatible key
npm run devOpen the app in your browser:
(https://eduflow-ai-olive.vercel.app/)
npm run buildEduFlow AI separates its environment variables into core required variables (needed for the database and authentication) and optional variables (needed for AI features or email notifications).
| Variable | File | Status | Description | Default / Example |
|---|---|---|---|---|
NEXT_PUBLIC_SUPABASE_URL |
.env |
Required | The API endpoint URL for your Supabase project. Required for database connection and user authentication. | https://your-project.supabase.co |
NEXT_PUBLIC_SUPABASE_ANON_KEY |
.env |
Required | The anonymous client key for your Supabase project. Used for authenticating requests. | eyJhbGciOiJIUzI1NiIsInR5c... |
AI_PROVIDER |
.env.local |
Optional | The LLM provider to use for AI features. | gemini |
GEMINI_API_KEY |
.env.local |
Optional | API key for Google Gemini. Required for AI Doubt Solver, AI Notes Generator, and Study Room AI suggestions. If missing, AI features will be greyed out. | AIzaSy... |
GEMINI_MODEL |
.env.local |
Optional | The specific Gemini model identifier to use. | gemini-2.5-flash-lite |
RESEND_API_KEY |
.env.local |
Optional | API key for Resend email service. Required for sending contact form submissions. | re_123456789... |
CONTACT_TO_EMAIL |
.env.local |
Optional | Destination email address to receive contact form submissions. | support@eduflow.ai |
RESEND_FROM_EMAIL |
.env.local |
Optional | The verified sender email address in Resend for sending messages. | onboarding@resend.dev |
Note
Contributors who do not wish to work on AI or email features can skip setting GEMINI_API_KEY and RESEND_API_KEY. The core study planner, notes CRUD, productivity tracker, and timetable features will remain fully functional, and the inactive features will be gracefully disabled in the UI.
EduFlow AI tracks daily study consistency based on completed study tasks. The dashboard includes animated streak UI, milestone badges, longest streak tracking, and last active date display.
The dashboard shows a clean 7-day bar chart based on completed study tasks. This helps students quickly understand their study momentum across the week.
AI tools are built directly into the study workflow, so students can generate notes, solve doubts, and get help without leaving the app.
Building EduFlow AI involved several real-world challenges:
- Handling async state across multiple dashboard widgets in Next.js
- Keeping the dashboard responsive while showing a lot of useful data
- Fixing TypeScript and production build issues while adding new features
- Integrating AI APIs in a reliable and user-friendly way
- Understanding and configuring Supabase Auth, database queries, and RLS policies
- Managing many features together without breaking existing workflows
- Designing a clean UI that feels premium but still practical for daily student use
- Heatmap calendar for long-term study consistency
- Advanced AI study insights
- Personalized study recommendations
- Mobile app version
- Better analytics for productivity and mood trends
- More export and sharing options
Contributions are welcome.
If you would like to improve EduFlow AI:
- Fork the repository
- Create a new feature branch
- Make your changes
- Submit a pull request
Please keep changes clean, focused, and easy to review.
Thanks to all the amazing people who contribute to EduFlow-AI 🚀
This project is licensed under the MIT License.
Thanks to the tools and platforms that make this project possible:
- Next.js
- Supabase
- Tailwind CSS
- OpenRouter
- LLM providers
- Vercel ecosystem
- GitHub: https://github.com/prabhakarshukla
- LinkedIn: www.linkedin.com/in/prabhakar-shukla-90334b399
- Instagram: https://www.instagram.com/prabhakar_.shukla
- Gmail: prabhakarshukla669@gmail.com