lockin.

A JEE Main + Advanced 2027 tracker (installable PWA) built with Next.js 16 (App Router). Syllabus, weightage and resources come from research/ and ship inside the app; Supabase stores accounts, progress and focus sessions.

Run it

npm install
npm run dev        # http://localhost:3000
npm run build      # production build
npm start          # serve the production build (offline support works here, not in dev)

Without Supabase keys the app runs in local-only mode (no accounts, progress saved on the device).

Pages

Path	What
/	Landing page
/login, /signup	Accounts (email + password)
/today	Dashboard: countdown, what to study now, syllabus progress, streak, pace
/s/[subject], /c/[chapter]	Subjects and chapters with topic checklists
/focus	Pomodoro / stopwatch focus timer; sessions are logged
/plan	Planner: revisions scheduled on days, "plan my week", drag to move
/quizrr, /quizrr/[series], /quizrr/[series]/[no]	Quizrr (MathonGo's test platform): overview, one page per series (QRT, QPT) in the order he takes them, and one page per test (syllabus, score logging). Full tests "coming soon". Linked from Today
/me	Profile, exam scope, sign out, backup
/admin	Admin panel: every student's progress, study time, MathonGo and Quizrr scores; log/fix results; set Quizrr dates; one-time Excel import (admins only)

src/proxy.ts sends signed-out visitors to /login and keeps non-admins out of /admin.

Supabase setup

1. .env (see .env.example):
   • NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY: Project Settings → API.
   • SUPABASE_SECRET_KEY: server-only, used by the admin panel. Never prefix it with NEXT_PUBLIC_.
   • ADMIN_EMAILS: comma-separated emails allowed into /admin.
2. Apply supabase/migrations/*.sql in order: npx supabase db push, or paste each file into the SQL Editor (safe to re-run).
3. Authentication → URL Configuration: Site URL http://localhost:3000 (your real domain once deployed), and add http://localhost:3000/auth/callback to Redirect URLs.
4. Optional: Authentication → Sign In / Providers → Email → turn off "Confirm email" so sign-up logs in instantly.

Data

• research/*.json: source research. node research/tools.mjs validate checks it.
• scripts/build-data.mjs: packs it into src/data/jee.json (runs before dev/build).
• research/tests/*.json: Quizrr exports. quizrr-map.json maps Quizrr chapter names to app chapter ids (the build fails on an unmapped name) and quizrr-schedule.json holds the suggested dates; the build packs them into src/data/quizrr.json. Dates set in the admin panel (quizrr_schedule, read-only for students) override the suggestions; scores sync through quizrr_attempts and count in the weekly college score.
• research/colleges-*.json: JoSAA 2025 final-round closing ranks (IITs, NITs, IIITs) and BITSAT 2025 cutoffs. The build packs them into src/data/colleges.json, the ladder for the daily/weekly college game (src/lib/college.ts).

Planner reminders (push notifications)

1. Run supabase/migrations/20261006000000_plan_reminders.sql (SQL Editor, or npm run db:push once the CLI is linked).
2. Add NEXT_PUBLIC_VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY, VAPID_SUBJECT and CRON_SECRET to the host's environment (they're in your local .env).
3. After deploying, in Supabase enable the pg_cron and pg_net extensions and schedule the job (every 15 minutes) with the SQL at the bottom of that migration, filling in your site URL and CRON_SECRET.
4. In the app: Me → reminders → turn on, pick the times, "send a test". On iPhone, add the app to the home screen first.