JIIT Personalized Time Table Creator

A powerful Next.js application that helps JIIT students create personalized class schedules. Features a modern glassmorphic UI, color-coded timetables, academic calendar integration, and multiple export options. This application leverages WebAssembly (Pyodide) to generate timetables directly in the browser, ensuring privacy and offline capability.

• Personalized Schedules: Generates timetables based on your specific batch and electives.
• Client-Side Processing: Uses Pyodide to run Python logic in the browser—no server round-trips for generation.
• Modern UI/UX: Built with Next.js 16, Tailwind CSS v4, and Shadcn UI for a premium feel.
• PWA Support: Installable as a native-like app with full offline functionality.
• Academic Calendar: View the academic calendar, filter holidays, and sync events to Google Calendar.
• Exam Schedule: Advanced exam schedule with subject search, year/session selectors, and “my exams” filter to quickly find your exam dates.
• Mess Menu: Check daily mess menus for Sector 62 and 128.
• Compare Timetables: Find common free slots and classes with friends.
• Timeline View: A calendar-like view of your schedule integrated with academic events.
• Export Options: Download as PDF/PNG or sync directly to Google Calendar.
• Shareable Timetable: Timetables can be recreated by simple URL sharing.
• Save Configs: Save and load multiple timetable configurations.
• Analytics: Integrated PostHog analytics for usage tracking.
• GenAI Integration: Backend tools use Google Gemini for summarizing PDF notices.

The mess menu data comes from life2harsh, who updates the menus for both JIIT Sector 62 and 128 every single week. The JSON this app serves is pulled straight from his repo:

Endpoint: https://raw.githubusercontent.com/life2harsh2/data/main/mess_menu.json

He also built Mess Scheduler, which automates the whole publishing workflow.

If his stuff has been useful to you, consider checking out his repos and leaving a star or two. Cool Stuff he makes show him some love…

Frontend (/website)#

• Framework: Next.js 16 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS v4, Shadcn UI, Framer Motion
• State Management: React Context, Nuqs (URL search params)
• Core Engine: Pyodide (Python in WebAssembly)
• Analytics: PostHog

Backend & Core Logic#

Parser Library (/parser)#

A modular Python package that handles the core logic for timetable generation and comparison.

• Multi-Campus Support: Custom logic for Sector 62, 128, and BCA with year-specific routing.
• Type Safety: Uses stdlib dataclasses for lightweight type validation without external dependencies.
• API: create_time_table(), compare_timetables(), create_and_compare_timetable().
• Usage: Compiled to a wheel and loaded by Pyodide in the frontend.

Creator Tools (/creator)#

Streamlit web app and CLI for converting raw academic documents into structured JSON formats.

• Web UI: Multi-page Streamlit interface for all data conversion tools.
• CLI: Typer-based command-line interface for batch processing.
• Tools: Timetable converter, AI-powered subject extractor, exam schedule parser (Gemini Vision), academic calendar processor.
• No Frontend Data Needed: Generates the JSON data files consumed by the website and parser library.

.
├── website/                 # Main Next.js Application
│   ├── app/                 # App Router pages and API routes
│   ├── components/          # React components (including Shadcn)
│   ├── public/              # Static assets and data
│   └── utils/               # Utilities (including Pyodide bridge)
│
├── parser/                  # Core Python Library (runs in browser via Pyodide)
│   ├── main.py              # Public API entry point (create_time_table, compare_timetables)
│   ├── models/              # Data models (Subject, ClassInfo, Enums)
│   ├── utils/               # Batch, subject, location, time utilities
│   └── modules/
│       ├── tt_parsers/      # Campus-specific timetable creators (Sector 62, 128, BCA)
│       └── compare_tt/      # Timetable comparison logic
│
├── creator/                 # Data Generation Tools (Web UI + CLI)
│   ├── main.py              # Entry point: web | cli
│   ├── app.py               # Streamlit multi-page app
│   ├── cli.py               # Typer CLI sub-commands
│   └── app/
│       ├── core/            # Settings, models, Gemini client
│       ├── services/        # Business logic (timetable, subjects, exam schedule, academic calendar)
│       └── ui/              # Streamlit page modules
│
└── README.md

1. User selects batch, year, campus, and electives.
2. Pyodide loads the parser library in the browser.
3. React sends raw data to the Python create_time_table function.
4. The function returns the structured schedule.
5. React renders the personalized, color-coded timetable.

Prerequisites#

• Node.js (or Bun)
• Python 3.9+ (for Creator tools)
• uv (recommended for Python dependency management)

Running the Website#

1. Navigate to the website directory:

   bash

   cd website
   

2. Install dependencies:

   bash

   bun install
   # or
   npm install
   

3. Run the development server:

   bash

   bun dev
   # or
   npm run dev
   

4. Open http://localhost:3000 (or the port shown in terminal).

1. Select Details: On the home page, choose your campus, batch, and electives.
2. View Timetable: The app generates your schedule instantly.
3. Customize: Add custom events or edit existing ones.
4. Export: Use the “Export” button to download or sync with Google Calendar.
5. Explore: Use the bottom navigation (mobile) or sidebar to access the Mess Menu, Academic Calendar, and Timeline.

The application provides a comprehensive REST API documented via Swagger UI.

• Documentation: api-doc
• OpenAPI Spec: api/doc

Available Endpoints#

• /api/academic-calendar: Fetch academic calendar data.
• /api/mess-menu: Get daily mess menus.
• /api/time-table: Access raw timetable data.

• Swipe Navigation: Swipe left/right to navigate between pages
• Responsive Navbar: Multi-line text support for better readability
• Touch Gestures: Optimized for mobile interaction
• PWA Support: Install as app and use offline

Common issues and solutions:

1. Loading Error: Clear cache and reload.
2. Export Failed: Check browser permissions or try a different browser.
3. Wrong Timetable: Verify you selected the correct batch and electives.
4. Mobile Issues: Ensure you’re using a modern browser with touch support.

• Handelled BCA TimeTable
• Handling 4th year BE TimeTable
• PWA Support for offline usage
• Reminders for classes
• Visualization of free and busy slots of 2 students
• Mobile-responsive navbar with multi-line text support
• Swipe navigation for mobile devices

Contributions are welcome!

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes.
4. Push to the branch.
5. Open a Pull Request.

GPL-3.0 License

• Tashif Ahmad Khan (tashifkhan) - [email protected]

• Issues: tashifkhan/JIIT-time-table-website
• Feature Requests: tashifkhan/JIIT-time-table-website
• Email: [email protected]