AdaQuiz

Master Programming Languages with Interactive Quizzes

🎯 Overview

AdaQuiz is a modern, production-ready Progressive Web App (PWA) for mastering programming languages through interactive quizzes. Built with Next.js 16 and React 19, it features adaptive learning using spaced repetition (SM-2 algorithm), AI-generated questions, and comprehensive analytics.

Live at: adaquiz.online

Key Highlights

• 🧠 Adaptive Learning - SM-2 spaced repetition algorithm optimizes review timing
• 🤖 AI-Generated Questions - Fresh content powered by OpenAI GPT-4
• 📊 Performance Analytics - Track progress, identify weaknesses, visualize trends
• 📱 PWA Support - Works offline, installable as native app
• 🔒 Enterprise Security - CSP headers, RLS policies, rate limiting
• ✅ 405 Tests - Comprehensive test coverage with Vitest

---

✨ Features

Core Functionality

• 6 Programming Languages: JavaScript, Python, Go, Rust, Java, C++
• 3 Difficulty Levels: Easy, Medium, Hard
• Quiz Management:
  • Auto-save progress (resume incomplete quizzes)
  • Keyboard shortcuts (1-5 for answers, Enter to submit, arrows to navigate)
  • Timer with remaining time display
  • Mark questions for review

Learning Features

• Spaced Repetition: SM-2 algorithm tracks individual question performance
• Smart Question Selection: Prioritizes due reviews → fresh questions → retry questions
• Detailed Explanations: Every question includes explanations for correct answers
• Question Reporting: Users can flag incorrect or unclear questions

User Tiers

Pro Features

• Performance Charts: Recharts visualizations of progress over time
• Weakness Detection: Identifies struggling topics
• Trend Analysis: Compares recent vs. historical performance
• Data Export: JSON/CSV export of quiz history

Technical Features

• PWA: Offline support, installable, background sync
• Security: CSP headers, Row-Level Security (RLS), rate limiting
• Analytics: Vercel Analytics & Speed Insights
• Accessibility: WCAG compliant, keyboard navigation, screen reader support
• Responsive: Mobile-first design with tablet/desktop optimization

---

🛠 Tech Stack

Frontend

• Framework: Next.js 16.1.4 (App Router, React Server Components)
• UI: React 19.2.3, TypeScript 5
• Styling: Tailwind CSS 4, shadcn/ui components
• State: React hooks, server actions
• Charts: Recharts (Pro analytics)

Backend

• Database: PostgreSQL via Supabase
• Auth: Supabase Auth (email, OAuth)
• Payments: DodoPayments (subscriptions)
• AI: OpenAI GPT-4 (question generation)
• Rate Limiting: Upstash Redis

DevOps

• Hosting: Vercel
• CI/CD: GitHub Actions
• Testing: Vitest, React Testing Library
• Monitoring: Vercel Analytics, Speed Insights

---

🙏 Acknowledgments

• shadcn/ui for beautiful components
• Supabase for auth and database
• DodoPayments for subscription handling
• OpenAI for AI-generated questions
• Vercel for hosting and analytics

---

Built with ❤️ by the AdaQuiz Team

Website · Privacy · Terms