ExamForge 🎓

AI-powered mock exam coach — any certification, any exam.

Works entirely in your browser. No server. No install. Just open index.html.

🎬 Demo

---

🚀 Quick Start

Option A — Download & run locally:

1. Download ZIP → Unzip
2. Open index.html in Chrome or Edge — done!

Option B — Clone:

git clone https://github.com/krishnaramadas/ExamForge.git
cd ExamForge
# Open index.html in your browser

Option C — Open online (no download): 🌐 krishnaramadas.github.io/ExamForge

---

🤖 AI Provider Setup (First-time)

The 4-step onboarding wizard will guide you through everything:

Step	What happens
1️⃣ Connect AI	Pick OpenAI or Google Gemini and paste your API key
2️⃣ Choose Exam	Select from AWS, GCP, SnowPro, Azure, PMP, CFA, UPSC and more
3️⃣ Study Material	Upload notes (PDF/DOCX/TXT) or skip to use AI knowledge
4️⃣ Exam Config	Set questions per session, time limit, difficulty

Get an API key:

• OpenAI → platform.openai.com/api-keys
• Google Gemini (free tier!) → aistudio.google.com/app/apikey

Your API key is stored only in your browser's local storage. Never sent anywhere except directly to the AI provider.

---

✨ Features

• 🎯 Any exam — AWS, GCP, SnowPro, PMP, CFA, Kubernetes, UPSC…
• 📂 Upload study notes — PDF, DOCX, TXT → AI extracts MCQs
• ✨ AI Discovery — Generate questions from AI's exam knowledge (no notes needed)
• ⏱️ Timed mock exams — Custom question count, time limit, difficulty
• 🧭 Question palette — Jump between questions, track answered/unanswered
• 🔍 Practice mode — Instant feedback + explanations after each answer
• 📊 Results & analytics — Score history, topic breakdown, full answer review
• 💾 Export/import — Save your question bank as JSON and share it
• 🤖 OpenAI + Gemini — Switch providers any time in Settings

---

🗂 Project Files

File	Purpose
index.html	App structure + onboarding
app.js	All logic — AI calls, exam engine, storage
style.css	Full design system

---

🌐 Host for Free (GitHub Pages)

1. Fork this repo
2. Go to Settings → Pages
3. Source: Deploy from branch → main → / (root) → Save
4. App is live at https://YOUR_USERNAME.github.io/ExamForge in ~60 seconds

---

🔒 Privacy

All data — questions, history, API key — lives in your browser only (localStorage). No account, no backend, no tracking.