UCSC Notes

An independent course-compilation archive for Computer Science notes, organised by year and semester. Subject overviews and topics are curated in the app; PDF URLs are loaded live from Vercel Blob.

This project is not affiliated with the University of Colombo School of Computing (UCSC).

Extending the archive

Add a new semester or year in app/data/catalog.ts by appending a Compilation entry:

{
  id: "y1-sem02",
  year: 1,
  semester: 2,
  label: "Year 1 · Semester 02",
  shortLabel: "Y1 Sem 02",
  blobPrefix: "Compilations_Sem02/",
  subjects: [/* ... */],
}

Upload matching PDFs under that Blob prefix. The home page lists every compilation and merges files by basename.

Stack

• React Router 8 (SSR) + Vite
• Tailwind CSS v4
• @vercel/blob for listing PDFs
• Motion for UI animation
• Dark mode by default (toggle in footer)

Setup

bun install

Copy environment variables:

Variable	Purpose
NOTES_STORE_ID	Vercel Blob store id (reference / dashboard)
NOTES_READ_WRITE_TOKEN	Blob read-write token used by the server loader to list()

Example Blob layout:

Compilations_Sem01/
  Application_Lab.pdf
  Data_Structures_and_Program_Design_in_C.pdf
  Computer_Systems.pdf
  ...
Compilations_Sem02/   # add when ready
  ...

The local pdfs/ folder is reference only for topic extraction. The site does not serve those files directly.

Development

bun run dev

App: http://localhost:5173

Build

bun run build
bun run start

Typecheck:

bun run typecheck

Deploy (Vercel)

1. Set NOTES_READ_WRITE_TOKEN (and optionally NOTES_STORE_ID) in the project environment.
2. Keep SSR enabled for the React Router build.
3. Upload PDFs under each compilation’s Blob prefix.

Each “Open PDF” control links straight to the public Blob URL in a new tab.