🚀 LearnQuest: AI-Powered Gamified Learning Platform

LearnQuest is an intelligent, gamified learning platform prototype that replaces static curriculums with dynamically generated, incredibly personalized educational modules.

With an immersive, neon-punk glassmorphic UI (The "Aetheris Protocol") and a floating interactive AI tutor named ARIA, LearnQuest turns deep technical subjects into a rich, exploratory game.

✨ Features

• ⚡ Dynamic Curriculum Engine: Click on any node in the Learning Roadmap, and the backend instantly pings Groq to generate a custom-tailored curriculum on the fly, including summaries, key concepts, flashcards, and Python Manim script mockups.
• 🤖 ARIA (Floating AI Tutor): A context-aware chatbot sitting in the corner of your screen that remembers your conversation history and explains complex topics using gamified analogies in real-time.
• 🌌 Immersive Authentication Cosmos: A custom Framer Motion-powered "Level Up" dimension upon the sign-in screen, featuring floating achievement cards, simulated user queues, and physics-based particle systems.
• 🎨 Aetheris Protocol Design System: Deep dark mode, vibrant cyan & violet neon lighting, high-contrast typography, and smooth glassmorphic UI panels.
• 🔒 Supabase Auth Integration: Seamless and secure user registration, session management, and progression tracking (XP, Badges).

🛠 Tech Stack

• Frontend Core: Next.js 14 & React 18
• Styling: Vanilla CSS (Tailored Aetheris Protocol tokens)
• Animations: Framer Motion
• Backend/Database: Supabase (Auth, PostgreSQL)
• AI Brain: Google Gemini 1.5 Flash (Primary — High-performance free tier) & Groq API (Fallback support for llama-3.3-70b-versatile)

🏎️ Running Locally

1. Clone the repository and navigate into the project directory:

   cd learnquest

2. Install the dependencies:

   npm install

3. Set up your environment variables: Create a .env.local file in the root of the learnquest directory and add your keys:

   # Recommended: Google Gemini API (Truly Free Tier, No Credit Card)
   # Get at: https://aistudio.google.com/app/apikey
   GEMINI_API_KEY=your_gemini_api_key_here
   
   # Optional Fallback: Groq API 
   GROQ_API_KEY=gsk_your_groq_api_key_here
   
   # Supabase Authentication
   NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Start the development server:

   npm run dev

5. Open the App: Navigate to http://localhost:3000 in your browser. Register an account, jump into the Roadmap, and click on a node to watch the AI engine generate your personalized module!

🧪 What's Next?

• Implement 3D visual data generation inside the video component.
• Hook up the dynamic Quiz Questions generated by Groq to validate the user's XP gain.
• Deploying live to Vercel and showcasing on the portfolio!

---

Initialize Protocol // Build your legacy. 💎