JIIT Personalized Time Table Creator

Overview

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.

Analytics

Key Features

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.
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.

Tech Stack

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.
Type Safety: Uses Pydantic models for validation.
Usage: Compiled to a wheel and loaded by Pyodide in the frontend.

Creator Tools (`/creator`)

Standalone utility scripts for generating the data files (JSONs) required by the website.

Academic Calendar Parser: Gemini-powered tool to extract events from PDFs.
Subject List Creator: AI-powered tool to clean and extract subject data.
Timetable Creators: Tools to convert raw Excel/PDF data into the JSON structure.

Project Structure

.
├── 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              # Unified API entry point
│   ├── common/              # Shared types and utils
│   ├── sector_62/           # Sector 62 logic
│   ├── sector_128/          # Sector 128 logic
│   └── BCA/                 # BCA logic
│
├── creator/                 # Data Generation Tools
│   ├── run.sh               # Helper script to launch tools
│   ├── ac_creator.py        # Academic Calendar Creator
│   ├── subjects_creator.py  # AI Subject List Creator
│   ├── timetable_creator.py # Timetable JSON Creator
│   └── json_creater.py      # Legacy/Manual Creator
│
└── README.md

Data Flow

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

Getting Started

Prerequisites

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

Running the Website

Navigate to the website directory:
```
cd website
```
Install dependencies:
```
bun install
# or
npm install
```
Run the development server:
```
bun dev
# or
npm run dev
```
Open http://localhost:3000 (or the port shown in terminal).

Running Creator Tools (Optional)

If you need to generate new JSON data files (e.g., for a new semester):

Navigate to the creator directory:
```
cd creator
```
Run the helper script:
```
./run.sh
```
Follow the interactive menu to launch the desired tool (Academic Calendar, Subjects, or Timetable creator).

Usage

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

API Reference

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

Documentation: https://jiit-timetable.tashif.codes/api-doc
OpenAPI Spec: https://jiit-timetable.tashif.codes/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.

Mobile Features

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

Troubleshooting

Common issues and solutions:

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

Future Scope

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

Contributing

Contributions are welcome!

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

License

GPL-3.0 License

Maintainers

Tashif Ahmad Khan (@tashifkhan) - admin@tashif.codes
Shaurya Rahlon (@ShauryaRahlon) - shauryarahlon.11@gmail.com

Contact

Issues: GitHub Issues
Feature Requests: GitHub Issues
Email: admin@tashif.codes