MAHE MIT Coursedata Portal for AY 25-26 https://courses.coolstuff.work
  • TypeScript 59.8%
  • JavaScript 25.2%
  • CSS 15%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-13 12:14:59 +00:00
.github/workflows fix: validate the pinned Bun toolchain in CI 2026-09-06 10:37:57 +05:30
branch-json Split IIE syllabus topics and recover indexed exam coverage 2026-11-13 12:14:59 +00:00
degree-json feat: Add degree search to command menu, refactor degree data loading for Edge compatibility, and enhance not found UI. 2025-12-19 12:22:29 +05:30
public Prevent Workers quota exhaustion from homepage requests and prefetching (#17) 2026-10-17 06:16:22 +05:30
scripts Remove unused course UI and repair data-check reporting (#16) 2026-10-03 20:37:11 +05:30
src Split IIE syllabus topics and recover indexed exam coverage 2026-11-13 12:14:59 +00:00
tools/oxlint/anti-slop chore: add anti-slop oxlint plugin 2026-08-18 08:12:19 +05:30
.gitignore init 2025-12-16 00:31:58 +05:30
.oxlintrc.json chore: upgrade dependencies and refresh security fixes (#18) 2026-10-29 21:17:14 +05:30
_routes.json Prevent Workers quota exhaustion from homepage requests and prefetching (#17) 2026-10-17 06:16:22 +05:30
bun.lock chore: upgrade dependencies and refresh security fixes (#18) 2026-10-29 21:17:14 +05:30
components.json init 2025-12-16 00:31:58 +05:30
contributing.md Updated README and Contributions guide 2025-12-17 18:35:30 +05:30
next.config.ts refactor: port course browser styling to StyleX with UI parity 2026-09-06 09:13:02 +05:30
package.json chore: upgrade dependencies and refresh security fixes (#18) 2026-10-29 21:17:14 +05:30
postcss.config.mjs refactor: port course browser styling to StyleX with UI parity 2026-09-06 09:13:02 +05:30
README.md Split IIE syllabus topics and recover indexed exam coverage 2026-11-13 12:14:59 +00:00
stylex.config.cjs refactor: port course browser styling to StyleX with UI parity 2026-09-06 09:13:02 +05:30
tsconfig.json chore: add anti-slop oxlint plugin 2026-08-18 08:12:19 +05:30
wrangler.jsonc chore: bump deps to latest and add oxfmt 2026-08-09 11:52:38 +05:30

Course Explorer

A modern course exploration platform built with Next.js, featuring an interactive network graph visualization of course relationships and a clean, responsive UI.

About the Project

Course Explorer is designed to help students and educators visualize and explore course relationships across different academic disciplines. The platform provides an intuitive way to understand course prerequisites, dependencies, and connections through an interactive network graph.

Features

  • Interactive Course Network Visualization: Explore course relationships through an interactive graph powered by vis-network
  • Advanced Search: Quickly find courses using the command menu with fuzzy search capabilities
  • Course Details: View comprehensive information about each course including prerequisites and descriptions
  • Dark/Light Mode: Toggle between themes for comfortable viewing
  • Responsive Design: Works seamlessly on desktop, tablet, and mobile devices
  • Modern UI: Built with Radix UI components and Tailwind CSS for a polished user experience

Live Demo

The application is live at: https://courses.coolstuff.work

Technology Stack

  • Framework: Next.js 16 with App Router
  • Language: TypeScript
  • UI Components: Radix UI, shadcn/ui
  • Styling: Tailwind CSS
  • Visualization: vis-network for course relationship graphs
  • Icons: Lucide React
  • State Management: React Context API
  • Deployment: Vercel

Project Structure

/
├── public/                  # Static assets
├── src/
│   ├── app/                 # Next.js app routes
│   ├── components/          # Reusable UI components
│   ├── lib/                 # Utility functions and types
│   └── styles/              # Global styles
├── branch-json/             # Course data in JSON format
└── ...

Key Components

Network Graph

The interactive network graph visualizes course relationships using force-directed layout. Courses are represented as nodes and relationships as edges, allowing users to explore dependencies and connections.

Command Menu

A powerful search interface that allows users to quickly find courses using fuzzy search. The command menu supports keyboard navigation and provides instant results.

Course Details

Detailed course information including title, code, description, prerequisites, and related courses. The interface is designed to be clean and easy to navigate.

Getting Started

Prerequisites

  • Node.js 18+ or Bun 1.0+
  • npm, yarn, pnpm, or bun package manager

Installation

# Clone the repository
git clone https://github.com/your-username/course-web.git
cd course-web

# Install dependencies
npm install
# or
yarn install
# or
pnpm install
# or
bun install

Running the Development Server

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

Building for Production

npm run build
# or
yarn build
# or
pnpm build
# or
bun run build

Running the Production Server

npm start
# or
yarn start
# or
pnpm start
# or
bun run start

Linting

npm run lint

Deployment

The project deploys to Cloudflare Pages using @cloudflare/next-on-pages:

bun run pages:deploy

The root _routes.json keeps /, /index.html, and /index.rsc outside Pages Functions so homepage requests do not consume the Workers daily request allowance. API routes and dynamic course pages still run through Functions.

On courses.coolstuff.work, a Cloudflare URL Rewrite Rule maps GET and HEAD requests for / with the RSC: 1 header to /index.rsc, preserving the query string. This preserves Next.js client navigation when the homepage is served statically. public/_headers supplies the RSC response's text/x-component content type. Configure the same rewrite when moving the production site to another custom domain.

Navigation links disable automatic prefetching. The deployed Next.js adapter repeatedly refetched visible links while a page was idle, consuming Function requests. Links still fetch their destination when clicked.

Data Structure

Course data is stored in JSON files in the branch-json/ directory. Each file represents a different academic branch and contains:

  • Course codes
  • Course titles
  • Prerequisites
  • Descriptions
  • Relationships to other courses

Inter-institute electives

branch-json/iie.json combines historical MIT curriculum records with recent public elective-allocation listings and official library archive labels. Every IIE record includes sources (title, URL, and scope) and notes that distinguish historical syllabi, recent allocation evidence, archive labels, and related MAHE certificate courses. Sources are also displayed on the course page and included in the course API response.

The official 2018–2022 Aeronautical course outline contains the historical inter-institute syllabi on PDF pages 26–28 (printed pages 285–287). Its credit structures describe that curriculum, not a guarantee of current credits or availability. Recent allocation evidence comes from the revision-pinned VI and VII semester datasets. Allocation listings establish course codes and titles, not syllabi or credits.

The archive_listing flag identifies public labels in the MIT Central Library question-paper catalogue. Those PDFs require SSO; catalogue labels do not verify internal PDF headings, exact examination dates, syllabi, or credits. Related curriculum with a placeholder code is not assigned to a numeric IIE code without an explicit mapping. Additional search-index excerpts (search_index_excerpt) and readable third-party examination previews (secondary_preview) are qualified individually in notes and sources. Examination coverage is not promoted to a formal syllabus; truncated or blurred material is not completed by inference.

Verified syllabi are stored as separate topic groups in the syllabus array rather than one paragraph per course. Group boundaries follow the subject matter; names, examples, and shared explanations stay together. Splitting topics preserves source wording and order rather than inventing additional units or teaching hours.

Unknown credits remain null, missing syllabi remain empty, and data-quality flags identify incomplete or historical records. A single offering semester is left unknown where the evidence is limited to dated allocation lists or varies by year. Related certificate-course descriptions belong in notes, not the MIT syllabus; related books are not listed as prescribed references without evidence. In particular, historical Yoga (IIE 4307) and recent Yoga (IIE 4324) remain separate until an official equivalence is established. These records do not automatically change any degree's elective pool.

Run bun test src/lib/courses.test.ts to check IIE catalogue and search integration. Run bun scripts/generate-data.ts if static JSON exports are needed; the application and API import the branch data directly.

Development Guidelines

Adding New Courses

  1. Create a new JSON file in the branch-json/ directory
  2. Follow the existing data structure format
  3. Update the course data loader in src/lib/courses.ts

Customizing the UI

  • Modify components in the src/components/ directory
  • Update styles in the src/styles/ StyleX modules and src/app/globals.css
  • Configure theme in src/components/theme-provider.tsx

Adding New Features

  1. Create a new branch for your feature
  2. Implement the feature following existing patterns
  3. Add appropriate tests
  4. Update documentation if needed
  5. Submit a pull request

Contributing

We welcome contributions! Please see our CONTRIBUTING.md file for detailed guidelines on how to contribute to this project.

License

This project is open source and available under the MIT License.

Contact

For questions or support, please open an issue on the GitHub repository.

Acknowledgements

Future Roadmap

  • Add user authentication
  • Implement course bookmarking
  • Add course reviews and ratings
  • Expand course database
  • Add academic planning tools