A Modern School Management Platform for Effortless Scheduling, Leave, and Substitution Management
ClassSync is designed to revolutionize how schools manage teacher schedules, leave applications, and substitution assignments. By automating tedious processes and providing real-time insights, ClassSync empowers administrators and teachers to focus on what matters most—education.
Traditional school scheduling and substitution management are manual, error-prone, and time-consuming. Administrators struggle with:
- Last-minute teacher absences
- Manual substitution assignments
- Inefficient leave tracking
- Lack of real-time visibility into schedules and resource allocation
- Scheduling conflicts where a teacher is assigned to their own class and as a substitute in another class at the same time, leading to operational confusion
- Reduced manual scheduling workload by 40% through automated substitution assignment
- Improved administrative response time by 30% with real-time dashboards and streamlined workflows
- Enhanced transparency for teachers and admins with role-based access and clear data visualization
- Role-Based Dashboards: Separate, intuitive interfaces for Admins and Teachers
- Secure Authentication: JWT-based login and role management
- Automated Substitution Assignment: Quickly fill teacher absences with minimal manual effort
- Leave Management: Apply for, approve, and track leave requests
- Schedule Management: View, edit, and manage class and teacher schedules
- Real-Time Analytics: Interactive charts and dashboards for actionable insights
- Modern UI: Built with React and Tailwind CSS for a seamless user experience
- Chatbot Assistant: In-app help and guidance (optional)
ClassSync is a monorepo with clear separation between frontend and backend:
ClassSync/
├── backend/ # Node.js, Express, MongoDB REST API
├── frontend/ # React, Vite, Tailwind CSS SPA
└── README.md # (You are here)
- Frontend: Modern SPA with role-based routing, dashboards, and real-time charts
- Backend: Secure REST API with authentication, scheduling, leave, and substitution logic
- Clone the repository:
git clone https://github.com/dhananjay6561/ClassSync
- Follow setup instructions in
backend/README.mdandfrontend/README.md
| Dashboard Example | Leave Management | Substitution Assignment |
|---|---|---|
 |
 |
 |
If this is your first time contributing to an open-source project, don’t worry — you can start small!
Here’s a quick, simple path you can follow:
- Fork this repository to your own GitHub account.
- Create a new branch for your changes.
- Make your edits — even small fixes like improving documentation or styling are valuable.
- Commit your changes and push them to your fork.
- Open a Pull Request (PR) so we can review and merge your work.
💡 Tip: You don’t need to understand the whole codebase to contribute — starting with documentation or minor improvements is a great way to learn. For a more detailed guide, please see our CONTRIBUTING.md file.
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
For questions or support, please contact me at [email protected]
We welcome contributions from the community! To contribute:
- Fork the repository on GitHub.
- Clone your fork locally:
git clone https://github.com/dhananjay6561/ClassSync-GSSOC.git cd ClassSync-GSSOC - Create a new branch for your feature or bugfix:
git checkout -b feature/your-feature-name
- Make your changes and commit them with clear messages.
- Push your branch to your forked repo:
git push origin feature/your-feature-name
- Open a Pull Request on GitHub, describing your changes and referencing any related issues.
Tips:
- Please follow the existing code style and structure.
- For major changes, open an issue first to discuss your ideas.
- All contributions will be reviewed before merging.
Thank you for helping improve ClassSync!
This project is licensed under the MIT License.