Skip to main content

About the project

๐ŸŽ“ College Ess

Everything a student juggles โ€” in one place.

Your wardrobe, your routine, your deadlines, your clubs, your exams.
Synced everywhere. Works offline. Installs like an app.







Architecture ยท Modules ยท Stack ยท Roadmap ยท Developer docs



๐Ÿ’ก The problem

A studentโ€™s life is scattered across eight apps that donโ€™t talk to each other.

Your exam timetable is a PDF. Your clubโ€™s meeting is in a WhatsApp group. Your laundry
is a mental note you forgot. The fest you wanted to attend clashed with a lab you didnโ€™t
check. Nothing knows about anything else.

College Ess is one app where all of it lives together โ€” and where each piece actually
knows about the others.


      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
      โ”‚  9:41                       โ–โ–„โ–† โ–ฎโ–ฎ   โ”‚
      โ”‚                                      โ”‚
      โ”‚  Good morning, Harshit               โ”‚
      โ”‚  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€       โ”‚
      โ”‚                                      โ”‚
      โ”‚  โ–ธ TODAY ยท Class day                 โ”‚
      โ”‚                                      โ”‚
      โ”‚   08:30  โ”ƒ Physics โ€” LH3             โ”‚
      โ”‚   10:15  โ”ƒ DSA Lab โ€” CL2             โ”‚
      โ”‚   14:00  โ”ƒ ๐ŸŽญ Drama club meet        โ”‚
      โ”‚                                      โ”‚
      โ”‚  โ–ธ WEARING                           โ”‚
      โ”‚   โ”Œโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”                      โ”‚
      โ”‚   โ”‚ ๐Ÿ‘• โ”‚ โ”‚ ๐Ÿ‘– โ”‚  2 wears left        โ”‚
      โ”‚   โ””โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”˜                      โ”‚
      โ”‚                                      โ”‚
      โ”‚  โ–ธ UP NEXT                           โ”‚
      โ”‚   โš  Midsem in 6 days                 โ”‚
      โ”‚   โ—‹ Buy notebooks                    โ”‚
      โ”‚                                      โ”‚
      โ”‚  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€     โ”‚
      โ”‚   ๐Ÿ      ๐Ÿ“‹     ๐Ÿ‘•     ๐Ÿ“…     โš™      โ”‚
      โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜


โœจ Twelve modules, one app

๐Ÿ“‹ Loop

Tasks that sort themselves

Type โ€œPhysics exam 15thโ€ โ€” it becomes an exam, on the right date, in the right module.

๐Ÿ• Rhythm

A routine that knows the day

Class day, exam day, holiday, study day โ€” each has its own shape. It switches on its own.

๐Ÿ”ฅ Groove

Habits that stick

Start small and build a streak. A holiday or exam day doesnโ€™t break it, and todayโ€™s habits sit in your to-do list.

๐Ÿ‘• Drip

Your wardrobe, tracked

Photograph your clothes, pair tops with bottoms, set wear limits, know when laundry is due.

๐Ÿ“š Crunch

Exams you canโ€™t miss

Seat numbers, halls, dates. Reminders you canโ€™t switch off โ€” because you shouldnโ€™t.

๐ŸŒด Breather

Every long weekend, early

Three months ahead. Public holidays, college breaks, and the Fridays worth taking off.

๐Ÿ›’ Pantry

Groceries before they expire

Quantities, expiry dates, and a shopping list that writes itself.

๐ŸŽญ Circles

Your clubs, organised

Meetings, roles, tasks. Coordinators get management powers automatically.

๐ŸŽช Buzz

Fests, hackathons, everything

Every campus event โ€” with outfit planning and prep tasks attached.

๐Ÿงญ Compass

The guide, always current

Every feature and setting explained. Readable offline. Admins will edit it right in the app, no deploy.

๐Ÿ›๏ธ Quad

Campus social

Posts, stories, and the feed โ€” scoped to your college.

๐Ÿช„ Sage

AI that knows your context

Bring your own key. It reads your schedule and helps you plan around it.

๐Ÿ’ฌ Chat

Encrypted, and not ours

Messaging is delegated to a dedicated E2EE chat app. We share by reference, never by content.



๐Ÿงฉ One idea holds the whole thing together

Six of these modules are structurally identical. A todo deadline, an exam, an event,
a holiday, a class block, a club meeting โ€” they differ by label, not by shape.

So they arenโ€™t six apps. Theyโ€™re six views over one table.

flowchart TD
    L["๐Ÿ“‹ Loop"]:::mod
    R["๐Ÿ• Rhythm"]:::mod
    C["๐Ÿ“š Crunch"]:::mod
    B["๐ŸŒด Breather"]:::mod
    K["๐ŸŽญ Circles"]:::mod
    Z["๐ŸŽช Buzz"]:::mod

    L -->|kind=todo| I
    R -->|kind=class_block| I
    C -->|kind=exam| I
    B -->|kind=holiday| I
    K -->|kind=club_meeting| I
    Z -->|kind=event| I

    I[("๐Ÿ—‚๏ธ item<br/><i>one unified record</i>")]:::core
    I --> D["๐Ÿ“Ž *_detail tables<br/><i>kind-specific fields</i>"]:::sub

    classDef mod fill:#1e293b,stroke:#475569,color:#e2e8f0
    classDef core fill:#2563eb,stroke:#1d4ed8,color:#ffffff
    classDef sub fill:#334155,stroke:#475569,color:#e2e8f0

Why it matters: reclassifying a todo as an exam is a single field update โ€” not a
migration across two tables. And โ€œwhatโ€™s happening next week?โ€ is one query across
every module, for free.


๐Ÿ”— Modules that actually talk to each other

Cross-module connections are rows in an edge table, not schema changes. Adding a new
one costs nothing.

flowchart LR
    O["๐Ÿ‘• Outfit"]:::a -->|wears_at| E["๐ŸŽช Fest"]:::b
    T["๐Ÿ“‹ Buy fabric"]:::a -->|prepares_for| E
    S["๐Ÿ“š Midsem"]:::b -->|blocks| RT["๐Ÿ• Routine"]:::c
    H["๐ŸŒด Long weekend"]:::c -->|derived_from| RT
    TK["๐Ÿ“‹ Design poster"]:::a -->|belongs_to| CL["๐ŸŽญ Drama Club"]:::b

    classDef a fill:#0f766e,stroke:#14b8a6,color:#fff
    classDef b fill:#7c3aed,stroke:#a78bfa,color:#fff
    classDef c fill:#b45309,stroke:#f59e0b,color:#fff

Pick an outfit for a fest โ†’ it appears on your timeline that morning.
Exams approach โ†’ your routine switches to study mode.
A long weekend appears โ†’ tasks you saved for free time surface.



๐Ÿ“ก Offline is not an afterthought

Campus wifi is bad. The app is built for that.

flowchart LR
    U["๐Ÿ“ฑ You"] -->|write| OB["๐Ÿ“ฅ Outbox<br/><i>IndexedDB</i>"]
    U -->|read| QC["โšก Local cache<br/><i>instant</i>"]
    OB -.->|"on reconnect"| API["โ˜๏ธ API"]
    API --> DB[("๐Ÿ˜ Postgres")]
    DB -.->|"changes since"| QC

    classDef x fill:#1e293b,stroke:#475569,color:#e2e8f0
    class U,OB,QC,API,DB x

Write a todo in a dead zone. It saves instantly, queues, and lands when youโ€™re back.
The guide is cached in full โ€” because you need help most when the network is worst.



๐Ÿ—๏ธ Built to run on nothing

Every piece was chosen to fit inside a free tier โ€” $0 to roughly 800 users.

flowchart TB
    subgraph edge [" "]
        direction LR
        P["๐Ÿ“ฑ PWA<br/><i>installable</i>"]:::u
    end

    P -->|HTTPS| V["โ–ฒ Vercel<br/><i>Next.js + API</i>"]:::v
    P -->|"presigned upload"| B2["๐Ÿชฃ Backblaze B2<br/><i>10GB free ยท no card</i>"]:::bz
    V --> NE[("๐Ÿ˜ Neon Postgres<br/><i>no idle pause</i>")]:::db
    CW["โฐ CF Worker<br/><i>cron ยท every minute</i>"]:::cf -->|tick| V
    V -->|"Web Push"| P

    classDef u fill:#2563eb,stroke:#1d4ed8,color:#fff
    classDef v fill:#000000,stroke:#333,color:#fff
    classDef cf fill:#F38020,stroke:#c2410c,color:#fff
    classDef bz fill:#E21E29,stroke:#b91c1c,color:#fff
    classDef db fill:#166534,stroke:#22c55e,color:#fff
Choice Why this one
๐Ÿชฃ Backblaze B2 for files 10 GB free with no card needed; downloads free up to 3ร— whatโ€™s stored, so images are cached on the device
โฐ Cloudflare cron Vercelโ€™s free tier caps cron at once per day; reminders need minutes
๐Ÿ˜ Neon Free Postgres that doesnโ€™t pause on idle
๐Ÿ” Better Auth Self-hosted, TOTP built in, unlimited users, $0 forever
๐Ÿ”” Web Push Native, no Firebase, no third party


๐Ÿ”’ Privacy, by design

๐Ÿซ Your data stays in your college
Every record is scoped to your institution. Cross-college access is structurally
prevented, not merely discouraged.

๐Ÿค– AI never sees a training tier
Model providers that train on inputs never receive student data. Sage is bring-your-own-key.

๐Ÿ’ฌ Chat stays encrypted
Messaging is end-to-end encrypted in a separate app. Content is shared by reference โ€”
the recipient fetches it with their own permissions.

๐Ÿ“ You choose what leaves your device
Task auto-classification runs on-device first. The optional model fallback is off by
default, and the guide says so plainly.



๐Ÿš€ Try it locally

pnpm install
cp .env.example apps/web/.env.local
# in apps/web/.env.local, set DATABASE_URL=pglite://memory
pnpm dev

Open http://localhost:3000. No database setup needed โ€” pglite://memory runs an
in-process Postgres. Every other value in the file must be present too: the server
refuses to start without them, and says which are missing.

๐Ÿ› ๏ธ Building on this? README-dev.md has the architecture in
depth, the conventions that are load-bearing, an honest assessment of the current
state, and what to be careful about. Read it before your first commit.



๐Ÿค Contributing

Foundation work is active, so the shape of things is still moving. A few conventions are
load-bearing and worth knowing before you open a PR:

  • Anything that accumulates is append-only โ€” derive totals, never store a mutable counter
  • Help text lives in the database, not in components
  • Fail closed โ€” no fallback secrets, ever
  • Code with no caller isnโ€™t done

The reasoning behind each is in README-dev.md.

Deploying, every environment variable, the architecture and how the tests work: the
docs set.



Built for students, by a student.

License not yet specified.

Built with

gemmagemini

AI tools

Coded withClaude CodeAntigravityGemini 3.8 FlashClaude Opus 5.5

Prize Categories Entered

  • Deepmind Google

    Best Use of Gemma 4

    Submitted
  • DigitalOcean

    Best Open-Source AI Project

    Submitted