Skip to content

hanakassahun/smart-student-assistant

Repository files navigation

🎓 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

About

Smart Student Assistant is a productivity-focused academic management system built to simplify how students plan, track, and succeed in their studies

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages