easeCHAOS is a modern, user-friendly timetable viewer designed specifically for UMaT students. Born out of the frustration of dealing with complex Excel spreadsheets and hard-to-read class schedules, this project aims to make viewing your class schedule as simple as possible.
- Simplified View: No more squinting at Excel sheets or searching through merged cells
- Class-Specific: View only your class's schedule, filtered and clean
- Modern Interface: Intuitive weekly and daily views
- Mobile Friendly: Access your schedule on any device
- Download Options: Download your schedule in pdf and image.
The application currently features:
- ✅ Weekly view with all classes
- ✅ Daily detailed view
- ✅ Class filtering system
- ✅ Responsive design with Light and Dark Theme
- ✅ Calendar download (PDF & Image)
- ✅ Accessible as Progressive Web App (PWA). You can basically save for offline use once your schedule is loaded up
- Node.js 18+
- Python 3.9+
- Redis
- Docker (Optional, although preferred for local developement)
- React.js
- TailwindCSS
- TypeScript
- Vite
- FastAPI (Python)
- Redis
- Docker
- Clone the repository
- Ensure you have
makeinstalled (available on most linux flavored systems) - Copy and rename
.env.sampleto.env - Run
make localto start the application on local. However, before that, note that you would need aredisinstance. You could create one on upstash.com and just place the details in the.envfile.
- Clone the repository
- Copy and rename
.env.sampleto.env - Run
make upto start the application on docker.
NB: This project is still under development. You might encounter bugs with the processed data. However, issues stem from the drafts, and has nothing to do with the extractor in most cases. Refer to the IT department and respective class reps to resolve clashes and unfamiliar conventions.
- Mr. Edem Y. Broni
- Mr. Abdul-Aziz
- @Kelvin Amoaba