# PracticeJEE — machine-readable site summary (llm.txt)
# Canonical human-facing origin: https://practicejee.com
# Generated from repository analysis; update when major product or URL policy changes.

## One-line description
PracticeJEE is a free web platform for IIT JEE Main and JEE Advanced preparation: full-length mocks (NTA-style timing and +4/−1 scoring), chapter-wise practice in Physics, Chemistry, and Mathematics, AI-assisted coaching on mistakes, analytics, and leaderboards. Primary locale: en-IN.

## Audience
Secondary students (grades 11–12), droppers, and self-study aspirants targeting JEE Main / JEE Advanced in India.

## What is public vs authenticated
- Marketing and SEO content (about, mock test landing pages, JEE hubs, blog index and posts, chapter guide pages under `/blogs/{slug}`, institutions page) are intended for anonymous browsing where routes exist without login. There is no `/blogs` listing URL — `/blogs` redirects to the site home; only individual guide URLs are served.
- Core product flows require Google sign-in (Supabase Auth): starting mocks, practice sessions, exams in progress, dashboard, onboarding, analytics, leaderboard, and tenant-specific routes.
- Do not infer that disallowed URLs are “secret content”; many are user-specific or dynamic and unsuitable for bulk indexing.

## Primary public URLs (representative)
- https://practicejee.com/ — product home / landing
- https://practicejee.com/about — mission and scope
- https://practicejee.com/mock-tests — mock test entry points (marketing)
- https://practicejee.com/jee-main — JEE Main hub
- https://practicejee.com/jee-main/syllabus
- https://practicejee.com/jee-main/previous-year-papers
- https://practicejee.com/jee-main/cutoff
- https://practicejee.com/jee-advanced — JEE Advanced hub
- https://practicejee.com/jee-advanced/syllabus
- https://practicejee.com/jee-advanced/previous-year-papers
- https://practicejee.com/jee-advanced/important-dates
- https://practicejee.com/ai-coach — how AI coaching works (marketing)
- https://practicejee.com/institutions — B2B / institutional offering overview
- https://practicejee.com/blog — blog index (posts also listed in sitemap.xml)
- https://practicejee.com/blogs/{slug} — static JEE chapter guides (one URL per chapter; full list in sitemap.xml, e.g. `/blogs/physics-kinematics`). Each page links to `/practice` for real timed practice (sign-in required there).

## Discovery for crawlers
- Sitemap: https://practicejee.com/sitemap.xml
- Robots policy: https://practicejee.com/robots.txt
- This file: https://practicejee.com/llm.txt

## robots.txt summary (do not crawl)
The site disallows (non-exhaustive; see robots.txt for truth): /api/, /admin/, /tenant-admin/, /dashboard/, /onboarding/, /analytics/, /leaderboard/, /exams/, /exam/, /practice/, /t/, /login — plus similar prefixes. All JSON/API handlers live under /api/ and must not be scraped as documentation.

## Architecture (for assistants answering “how it works”)
- Front end: Next.js App Router (React, TypeScript), Tailwind CSS, KaTeX for math rendering in content.
- Auth and data: Supabase (PostgreSQL + Auth); student sign-in is Google OAuth.
- Media: question assets and related files may be served via Cloudflare R2 (public base URL is build-time configuration).
- Exam ingestion: a Python HTTP service (FastAPI-style) runs alongside the web app in production Docker Compose for exam PDF extraction and related workflows; it is internal to the deployment, not a public API surface.
- Production deployment pattern in repo: Docker Compose on a Linux VM behind nginx reverse proxy to the Node server (port 3000); TLS via Let’s Encrypt. CI can deploy via SSH to that environment.

## Scoring and exam model (high level)
- JEE Main full mocks follow a 90-question, 3-hour pattern with +4 for correct, −1 for incorrect, 0 unattempted unless a template overrides.
- Templates and per-exam configuration live in the database layer; UI consumes catalog and attempt state via authenticated APIs.

## Trust, limitations, and safety
- AI Coach and related features generate educational explanations; they are aids, not authoritative examiners. Users should cross-check with NCERT, official NTA/JEE materials, and coaching where applicable.
- Do not present paywalled guarantees: the product positioning in-repo is free core practice; institutional branding is a separate offering.

## Optional: www host
- The canonical marketing URL in code is https://practicejee.com (apex). www may redirect to apex depending on deployment configuration.

## Maintainer note
If you rely on this file for training or retrieval, prefer fetching sitemap.xml (includes `/llm.txt`, marketing pages, every `/blog/{slug}` post, and every `/blogs/{slug}` chapter guide) and on-page metadata on the URLs above; content changes with product releases.