hanakassahun/smart-student-assistant
Smart Student Assistant is a productivity-focused academic management system built to simplify how students plan, track, and succeed in their studies
π Smart Student Assistant Web App
A full-stack MERN web app that helps students manage notes, reminders, and schedules β and chat with an AI study assistant.
π Overview
Smart Student Assistant is designed to centralize student productivity tools:
- π Create and organize notes
- β° Set reminders for tasks or deadlines
- π¬ Chat with an AI-powered assistant for study help
- π View schedules and progress on a clean dashboard
π§± Monorepo Layout
student-assistant/
βββ backend/ # Express, MongoDB, JWT auth
β βββ server.js
β βββ config/
β β βββ db.js
β βββ models/
β β βββ .gitkeep
β βββ routes/
β β βββ index.js
β βββ controllers/
β βββ .gitkeep
βββ frontend/ # React app
βββ src/
βββ App.js
βββ components/
β βββ .gitkeep
βββ pages/
β βββ .gitkeep
βββ context/
βββ .gitkeep
βοΈ Getting Started
π§© Prerequisites
π₯οΈ Backend Setup (Express)
cd backend
npm installRun the backend:
npm run dev
π» Frontend Setup (React + Vite)
cd frontend
npm install
npm run dev
app will start at http://localhost:5173
π§ Tech Stack
Frontend:
βοΈ React
β UI library for building interactive components
β‘ Vite
β Lightning-fast build tool and dev server
π¨ Tailwind CSS
β Utility-first CSS framework for styling
π React Router DOM
β Handles page navigation
π Recharts
β Data visualization for charts and graphs
Backend:
π’ Node.js
β JavaScript runtime for backend
π Express.js
β Minimalist web framework for APIs
ποΈ MongoDB
β NoSQL database for storing app data
π JWT
β JSON Web Tokens for authentication
βοΈ dotenv
β Environment variable management
Dev Tools:
π§© Nodemon
β Automatically restarts the server on changes
π» Postman
β For testing API routes
π§ OpenAI API
(optional) β For chatbot or AI features
π§Ύ Notes
The backend exposes a /health endpoint for quick checks.
Add models, controllers, and routes incrementally for:
users
notes
reminders
chat proxy
πͺͺ License
This project is licensed under the MIT License
.
β¨ Whatβs new / improved:
- Added Markdown styling (emojis, dividers, code blocks).
- Clearer overview and project purpose.
- Consistent setup instructions (with code blocks).
- A space for screenshots and license β optional but makes it feel βcomplete.β