A web-based timetable management system that allows schools/colleges to easily create, manage, and view timetables for teachers, classes, subjects, and rooms.
- 🔐 User Authentication (Register/Login)
- 📅 Create & Save Timetables
- 👨🏫 Teacher-wise, Day-wise, Subject-wise, and Room-wise Views
⚠️ Conflict Detection (detects teacher/room clashes)- 💾 Auto-save & Load Last Saved Timetable
- 🖨️ Print-friendly Layout (for PDF export)
- 🌐 Built with React, Node.js, Express, MongoDB
Frontend: React, TailwindCSS, Axios
Backend: Node.js, Express
Database: MongoDB (Mongoose)
smart-timetable/ │── backend/ # Node.js + Express server │── frontend/ # React application │── README.md │── CONTRIBUTING.md │── CODE_OF_CONDUCT.md │── LICENSE
git clone https://github.com/<your-username>/smart-timetable.git
cd smart-timetable- Setup Backend
cd backend
npm install
npm run dev- Setup Frontend
Open another terminal:
cd frontend
npm install
npm run devFrontend will run at http://localhost:5173
Backend will run at http://localhost:5000
💡 Usage
Register/Login as a user.
Create a timetable by assigning teachers, subjects, and rooms.
Save timetable → Data is stored in MongoDB.
Reload → Last saved timetable is auto-loaded.
Switch to Teacher/Day/Subject/Room views for quick access.
We welcome contributions! Please see our Contributing Guide.
Thanks to these wonderful people who have contributed to this project:
This project follows the all-contributors specification. Contributions of any kind are welcome!
After your PR is merged, comment on your PR:
@all-contributors please add @your-username for code, doc, design
- code - 💻 Code
- doc - 📖 Documentation
- design - 🎨 Design
- ideas - 🤔 Ideas & Planning
- bug - 🐛 Bug Reports
- test - 🧪 Tests
- review - 👀 Reviewed PRs
- infra - 🚇 Infrastructure
- question - 💬 Answering Questions
See CONTRIBUTORS_GUIDE.md for detailed instructions.
This project follows a Code of Conduct.
This project is licensed under the MIT License.