Skip to content

Repository files navigation

🎯 Centuriz's Quiz - The Quiz App

Poornima's Quiz is a modern quiz application built with Next.js, featuring both MCQ (Multiple Choice Questions) and Open-ended questions.
It is designed for interactive learning, AI-powered quiz generation, and a clean, responsive UI.

🌐 Live Demo: Poornima's Quiz on Vercel
📂 Repository: GitHub Repo


🚀 Features

  • ✅ Create and take quizzes with MCQs and Open-ended questions.
  • ✅ Beautiful UI with smooth animations.
  • ✅ AI-powered quiz generation from custom inputs (YouTube, documents, etc. planned).
  • ✅ Real-time quiz tracking with counters and score display.
  • ✅ Deployed with Vercel for instant availability.

🛠️ Tech Stack

Frameworks & Languages

  • Next.js 14 (React framework)
  • React
  • TypeScript

Styling & UI

  • Tailwind CSS (utility-first CSS)
  • shadcn/ui (component library)
  • Radix UI Primitives (Accordion, Dialog, Checkbox, Avatar, Dropdown, Tabs, Tooltip, and more)
  • Lucide React (icon library)
  • Embla Carousel (carousel/slider)

Forms & Validation

  • React Hook Form
  • Zod (schema validation)
  • @hookform/resolvers

State Management & Data

  • React Query (TanStack Query)
  • tRPC (API & RPC, client/server)
  • Prisma (ORM, planned)
  • Inngest (workflows, planned)

AI & Utilities

  • @google/generative-ai (AI integration)
  • better-auth (authentication)
  • cmdk (command menu)
  • class-variance-authority / clsx (conditional class handling)
  • client-only
  • d3-cloud (word cloud visualizations)
  • date-fns (date utilities)
  • fastest-levenshtein (string similarity)
  • input-otp (OTP input)

Developer Experience

  • Vercel (deployment)
  • ESLint (linting, via next lint script)

⚡ Getting Started

Follow these steps to run the project locally:

# 1. Clone the repository
git clone https://github.com/Centurykoshi/quzify.git
cd quzify

# 2. Install dependencies
npm install

# 3. Start the development server
npm run dev

📦 More

See the full list of dependencies and scripts in package.json.
Some features (like advanced AI quiz generation and backend workflows) are in development and coming soon!


🙏 Credits

Releases

Packages

Contributors

Languages