SmartQuest AI 🚀

The "Pro Max" AI-Powered Question Bank & Exam Platform

---

📖 Mission

SmartQuest AI is a modern, responsive, and AI-native web application designed to revolutionize how students and educators manage learning materials. By leveraging Next.js 15, Supabase, and LLMs (GPT-4o / Gemini), it transforms static PDF documents into interactive, auto-graded exam simulations.

Our philosophy: "Clean, Distraction-Free, Academic Focus".

✨ Key Features

🧠 Module A: The Ingestion Engine

• PDF to JSON: Drag & drop PDFs to automatically extract text, questions, and options using AI.
• Smart OCR: Handles complex layouts, math formulas (LaTeX), and images.
• Review Dashboard: Split-screen interface to verify and correct AI extractions before adding to the bank.

📚 Module B: The Question Bank

• Organized Library: Filter by tags, difficulty, type, and source.
• AI Operations: Auto-tagging, content translation, and context-aware explanations.
• Rich Text Support: Full Markdown and LaTeX support for math and scientific content.

⚔️ Module C: Exam Arena (Zen Mode)

• Distraction-Free UI: Immersive full-screen mode for taking exams.
• Simulation Tools: Built-in timer, question palette, and progress tracking.
• Mobile First: Optimized touch controls for studying on the go.

🤖 Module D: AI Grading

• Instant Feedback: Auto-grading for objective questions.
• AI Grader: Subjective answers (text or handwritten images) are graded by AI with detailed feedback and scoring.

🛠️ Tech Stack

• Framework: Next.js 15 (App Router, Server Actions)
• Language: TypeScript (Strict Mode)
• Styling: Tailwind CSS v4 + Shadcn/UI + Framer Motion
• Database: PostgreSQL (via Supabase)
• Auth: Supabase Auth (OAuth support)
• AI: Vercel AI SDK + LangChain.js
• State: Zustand + Nuqs

🚀 Getting Started

Prerequisites

• Node.js 18+
• pnpm (recommended) or npm

Installation

1. Clone the repository

   git clone https://github.com/your-username/smart-quest-ai.git
   cd smart-quest-ai

2. Install dependencies

   npm install
   # or
   pnpm install

3. Environment Setup Create a .env.local file in the root directory and add your credentials:

   # Supabase
   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
   
   # AI Keys
   OPENAI_API_KEY=your_openai_key
   # or
   GOOGLE_GENERATIVE_AI_API_KEY=your_gemini_key
   
   # Database
   DATABASE_URL=your_prisma_connection_string

4. Run the development server

   npm run dev

   Open http://localhost:3000 with your browser to see the result.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.