Algo UPSC — algorithmic learning for UPSC Prelims

Algo UPSC is a Recallio (Spaced Loop) course for the UPSC Civil Services Preliminary Examination. The app decides what the learner studies: one small card at a time, at set study times, and the learner's own rating decides when each card comes back. The plan works backwards from the exam date (Prelims 2027: 23 May 2027) and switches to cram mode in the last two days.

• Web app: https://upsc.calecutech.com (Next.js on Vercel)
• Android app: com.calecutech.upsc_prelims (Flutter, app/, second phase)
• Backend: the shared Recallio Supabase project (USS), schema upsc
• Languages: English and Hindi
• Price: first 200 cards free; full course ₹10,000, introductory offer ₹3,000 (Razorpay, GST invoice)

What is in this repo

Path
web/	The Next.js web app: landing page, sign-in, onboarding, Daily Feed, payments, invoices
web/src/engine/	The learning engine: FSRS scheduler, daily planner, sitting builder, minimum-time rules
content/	Course content packs (JSON, schema 1.0) and the upload script output
supabase/migrations/	The upsc schema: content, learner tables, payments, invoices, RLS
supabase/functions/	Edge Functions: Razorpay order and webhook, AI tutor, study alerts, weekly report
scripts/validate_pack.py	Checks a content pack before upload
app/	Flutter Android app (phase two)
docs/	Architecture, tech stack and learning engine notes

Run the web app

cd web
cp .env.example .env.local   # fill in the Supabase URL and publishable key
pnpm install
pnpm dev
pnpm test                    # engine unit tests

Content

python3 scripts/validate_pack.py content/upsc_prelims.json
node scripts/pack-to-sql.mjs content/upsc_prelims.json > /tmp/pack.sql   # upsert into Supabase

Cards teach facts from the official UPSC syllabus and the NCERT books it rests on. Past papers only rank topics and supply test questions; they never appear as lesson cards.