GitHunt
HA

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 install

Run 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.”

React
Node.js
MongoDB