Examforge (pdf2cbt) 🚀

Build With Bharat 2.0 Hackathon Project

Turn any test paper PDF into an authentic, production-grade 1:1 NTA / TCS iON Computer-Based Test (CBT) with Gemini AI Multimodal Vision, KaTeX equation typesetting, client-side diagram cropping, and in-depth performance analytics.

---

✨ Features

• 3 Ingestion Modes:
  1. Single PDF: Question paper with answer key embedded inside.
  2. Dual PDFs: Question paper PDF + separate Answer Key PDF.
  3. AI Automated Solver: Upload a question paper only; Gemini 2.5 Flash mathematically solves each question, identifies the correct answer, and writes a step-by-step KaTeX explanation.
• Preloaded Grand Mocks: Instant 1-click launch for JEE Main (Physics, Chemistry, Math) and NEET (Biology, Chemistry, Physics) practice tests.
• 1:1 Authentic NTA / TCS iON Exam UI:
  • Section switcher (Physics, Chemistry, Mathematics).
  • Countdown clock with low-time pulsation warnings (<5 mins) and auto-submit.
  • All 5 official action controls: Save & Next, Save & Mark for Review, Clear Response, Mark for Review & Next, and Previous/Next.
  • Authentic 5-state question palette:
    • ⚪ Not Visited (Grey shape)
    • 🔴 Not Answered (Red cut-corner polygon)
    • 🟢 Answered (Green cut-corner polygon)
    • 🟣 Marked for Review (Violet circle)
    • 🟣🟢 Answered & Marked for Review (Evaluated in NTA)
• Deep Post-Exam Analytics:
  • Scorecard: Net Score, Max Marks, Percentage.
  • Positive Marks (+4 for correct answers) & Negative Deductions (-1 for incorrect answers).
  • Accuracy % and attempt rate.
  • Time pacing: Total time taken, average pace per question, and pacing speed.
  • Section-by-section breakdown table.
  • Filterable review with step-by-step mathematical solutions.
  • Export performance report as JSON.
• Aesthetics & Theming:
  • Pure CSS design system with zero external CSS framework quirks.
  • Dark Mode & Light Mode toggle.
  • Interactive pipeline flowchart and live simulator preview.

---

🛠️ Tech Stack

• Frontend: React 19, Vite
• AI Engine: Google Gemini 2.5 Flash / 1.5 Flash Multimodal Vision API
• Mathematical Typesetting: KaTeX
• PDF & Diagram Processing: PDF.js (pdfjs-dist) with client-side canvas cropping
• Icons & Effects: Lucide Icons, Canvas Confetti
• Styling: Modern Pure Vanilla CSS Design System

---

🚀 Getting Started

1. Install Dependencies

npm install

2. Run Development Server

npm run dev

Open http://127.0.0.1:5175/ in your browser.

3. Build for Production

npm run build

---

📄 License

MIT License. Built for Build With Bharat 2.0 Hackathon.