A modern, lightning-fast React + TypeScript + Vite application designed to automatically generate conflict-free academic timetables across various university streams.
- Heuristic Scheduling Engine: Automatically schedules theory classes and groups lab sessions into contiguous blocks.
- Multi-Stream Support: Out-of-the-box data models for BCA, B.Tech, BBA, LLB, M.Tech, MCA, MBA, and BPT.
- Dynamic Constraints: Filter by stream, cap maximum daily theory classes, and automatically flag unplaceable subjects.
- Clean UI & Print-Ready: Built with Tailwind CSS, featuring a wizard-like interface that exports directly to beautifully formatted, official-looking PDFs.
- Custom Branding: Fully adjustable colors, logos, and letterheads to match institutional identity (Defaults to SRMU standards).
- Frontend Framework: React 18
- Build Tool: Vite
- Language: TypeScript
- Styling: Tailwind CSS + PostCSS
The core scheduling engine operates using a specialized heuristic algorithm that mimics real-world academic constraints:
- Theory Prioritization & Distribution: Standard theory subjects are randomly distributed across the available weekly slots (Monday to Friday) to ensure a balanced timetable without heavy clustering.
- Daily Theory Limits: A dynamic constraint ensures that the number of theory classes on any given day does not exceed a set maximum, preventing student burnout.
- Contiguous Lab Assignments: Practical Lab sessions (which require extended time) are strictly allocated to uninterrupted, consecutive 2-period blocks on the same day.
- Collision Avoidance: The generator natively guarantees that no single stream has overlapping classes in the same time slot.
This project is open-source and available for academic and administrative use.