Stumate is a comprehensive web application built with React, designed to streamline and simplify the daily life of a student. It helps students organize classes, plan study, track money, and prepare for exams — all in one app.
Stumate is designed to tackle typical pain points students face: missed classes, disorganized study plans, unmanaged budgets, and lack of focused practice. The app brings scheduling, budgeting, exam prep, and an intelligent study planner together, synced to the cloud.
Stumate is packed with features to help you stay organized, focused, and on top of your academic life.
Your central hub for a complete overview of your academic life at a glance.
- Key Metrics: Instantly view your total expenses, completed tasks, and total focus time with visually engaging stat cards.
- Data Visualization: Interactive charts show your weekly study trends, expense breakdowns, and monthly spending patterns.
- Quick Access: See your upcoming tasks and recent transactions without navigating away from the dashboard.
- Motivational Boost: Get a daily dose of inspiration with a motivational quote card to keep you going.
Never miss a lecture or an important event again! The schedule tracker provides a clear, color-coded calendar to manage your entire academic life.
- Multiple Views: Seamlessly switch between month, week, and day views to see your schedule at any level of detail.
- Easy Management: Quickly add, edit, and delete class entries with an intuitive form.
- Color Coding: Assign unique colors to different subjects for at-a-glance clarity and better organization.
- Smart Notifications: A notification bell in the header provides an at-a-glance view of all your events scheduled in the next 7 days, complete with a countdown.
Take control of your finances with a simple yet powerful budget tracker designed for students.
- Track Transactions: Easily log your income (allowance, part-time job) and expenses (food, books, transport).
- Categorize Spending: Understand exactly where your money is going with custom categories.
- Visual Breakdown: An interactive radar chart visualizes your expenses, making it easy to see your spending habits from a new perspective.
- Pagination: A paginated transaction list ensures the interface remains clean and easy to navigate, no matter how many transactions you have.
Break down large study goals into small, manageable tasks with a flexible Kanban board.
- Organize Tasks: Create tasks for different subjects, set priority levels (low, medium, high), and add deadlines.
- Visual Progress: Intuitively drag and drop tasks between "To Do," "In Progress," and "Done" columns to track your progress.
- Flexible & Intuitive: The clean interface makes it easy to re-prioritize and manage your workload effectively.
Supercharge your study sessions with an AI-driven exam question generator. Instead of just tracking what to study, Stumate helps you actually study.
- Generate Custom Quizzes: Enter any topic, select a difficulty level (easy, medium, hard), and choose the number of questions.
- Get Instant Questions & Answers: Our AI, powered by Google's Gemini Pro, generates relevant multiple-choice questions and their corresponding answers in seconds.
- Interactive Quiz Interface: Take the generated quiz in a clean, timed interface and get instant results.
- Endless Practice: Prepare for any exam by creating unlimited practice tests on any subject imaginable.
What makes Stumate stand out? We've added creative, AI-powered, and user-centric features to provide a truly enhanced experience.
Improve your concentration and productivity with a built-in Pomodoro timer designed for a seamless study experience.
- Classic Pomodoro Technique: Work in focused 25-minute intervals, with short and long breaks to prevent burnout.
- Persistent Timer: The timer's state is saved in your browser. If you refresh the page or accidentally close the tab, your timer continues right where you left off, ensuring your focus is never truly broken.
- Audible Alerts: Get a clear audio notification when a session ends, so you know when to take a break or get back to work without constantly watching the clock.
Don't know where to start? The AI Study Path Generator turns your big goals into a manageable, day-by-day plan.
- Define Your Goal: Simply tell the AI what you want to learn—from "Master calculus in 2 weeks" to "Learn the basics of Python for data analysis."
- Get a Custom Roadmap: The AI generates a detailed, step-by-step study plan, broken down into daily tasks and milestones.
- Visual Timeline: The plan is presented in a beautiful, easy-to-follow timeline that visualizes your entire learning journey.
- Export Your Plan: Save your study path as a PDF or image to keep it handy or share it with others.
Reflect on your study sessions to better understand your learning process and improve your habits.
- Track Your Mood: Log how you felt during each study session—focused, motivated, distracted, or tired.
- Take Quick Notes: Jot down key takeaways, concepts you struggled with, or ideas for next time.
- Review Your History: Look back at past entries to identify patterns in your study effectiveness.
Stay motivated by unlocking badges and tracking your progress through a fun and engaging achievement system.
- Unlock Badges: Earn achievements for completing tasks, logging transactions, staying focused, and more.
- Track Your Progress: A dedicated achievements page shows all possible badges and your current unlocked status.
- Tiered System: Progress through bronze, silver, gold, and platinum tiers for each achievement category.
Facilitate collaborative study sessions with a friend, no matter where they are.
- Seamless Integration with Google Meet: Create a private study room powered by Google Meet without leaving the app.
- Simple Room Creation: Generate a new Google Meet link and paste it into the app to create a new room.
- Easy Sharing: The app generates a unique, short code for your room that you can easily share with a study partner.
- Branded Joining Page: Your friend will see a beautiful, branded page with your profile picture and a clear "Join Now" button, making the experience feel integrated and professional.
Connect with fellow students, ask questions, and share resources in a collaborative forum.
- Categorized Discussions: Participate in dedicated sections for general discussion, announcements, and resource sharing.
- Create & Comment: Start new threads and comment on existing posts to engage with the community.
- Admin Controls: Designated admin users can post in the announcements category, ensuring important information is easy to find.
Easily manage your personal information, profile photo, and password to keep your account up to date.
- Edit Personal Info: Update your name, university, department, and grade details.
- Profile Photo: Upload or change your profile picture anytime.
- Email Display: View your registered email address (non-editable for security).
- Password Management: Securely change your password whenever needed.
- Frontend: React, Tailwind CSS
- UI Components: shadcn/ui, Recharts, Motion
- State Management: TanStack Query (React Query)
- Backend: Node.js, Express.js
- Database: MongoDB
- Authentication: Firebase Authentication
- Generative AI: Google's Gemini Pro via Genkit
To get a local copy up and running, follow these simple steps.
- Node.js (v18 or higher)
- npm or yarn
- Clone the repo
git clone https://github.com/abnahid/Stumate.git
- Install NPM packages
npm install
- Set up your environment variables by creating a
.env.localfile and adding your Firebase and MongoDB credentials. - Run the development server
npm run dev
- Fork the repo.
- Create a feature branch:
git checkout -b feat/my-feature - Implement code & tests.
- Open a PR with description and screenshots.
Coding standards: follow ESLint config in repo; Tailwind for styling; prefer functional components and hooks.
- Blank app: ensure
.envkeys exist and your Firebase Project ID matches the one in your Firebase project. - Auth fails in production: add your domain to Firebase Auth Authorized domains.
- Charts empty: confirm date range and that budget entries exist.
- Calendar import/export (.ics)
- OCR for timetable image import
- Multi-user collaborative study groups
- More question types in Q&A (code, image-based)
MIT © Abdul Jabbar al Nahid