Quizee is a full-stack interactive quiz platform that allows users to create, manage, attempt, and analyze quizzes. It provides authentication, quiz creation, quiz attempts, analytics, user profiles, scorecards, and more.
- 🔐 User Authentication - Secure account management with Clerk
- 📝 Quiz Creation - Create custom quizzes with multiple questions
- ✏️ Quiz Editing - Update and manage existing quizzes
- 🎯 Quiz Attempts - Take quizzes and test your knowledge
- 🏆 Scorecards - View quiz scores and results
- 📊 Quiz Analytics - Analyze quiz performance and statistics
- 📚 Quiz History - Keep track of previous quiz attempts
- 👤 User Profiles - View and manage user profiles
- 🌐 Public Quizzes - Explore quizzes created by other users
- 📁 File Uploads - Upload files using UploadThing
- 📱 Responsive UI - Optimized for different screen sizes
- 🎨 Modern Interface - Clean and interactive user experience
- ✨ Animations - Smooth UI animations with Framer Motion
| Technology | Purpose |
|---|---|
| ⚡ Next.js 16 | Full-stack React framework |
| ⚛️ React 19 | Frontend UI |
| 🔷 TypeScript | Type-safe development |
| 🍃 MongoDB | Database |
| 🗄️ Mongoose | MongoDB ODM |
| 🔑 Clerk | Authentication & user management |
| 🎨 Tailwind CSS | Styling |
| 🧩 Radix UI | Accessible UI components |
| 📋 React Hook Form | Form management |
| ✅ Zod | Schema validation |
| 📤 UploadThing | File uploads |
| 🎬 Framer Motion | Animations |
| 💡 Lucide React | Icons |
Make sure you have the following installed:
- 🟢 Node.js 24.x
- 📦 npm
- 🍃 MongoDB database
- 🔑 Clerk account
- 📤 UploadThing account
git clone https://github.com/MuhammadBinYasir/Quizee.git
cd Quizeenpm installCreate a .env.local file in the root directory:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
MONGODB_URI=
UPLOADTHING_TOKEN=
UPLOADTHING_APP_ID=Fill these values with the credentials from your respective services.
npm run devThen open:
http://localhost:3000
npm run devStarts the Next.js development server.
npm run buildCreates an optimized production build.
npm run startStarts the application in production mode.
npm run lintRuns the project's linting command.
Quizee/
├── app/
│ ├── api/
│ ├── ...
│ └── layout.tsx
├── components/
├── lib/
├── models/
├── public/
├── types/
├── middleware.ts
├── package.json
├── tailwind.config.ts
├── tsconfig.json
└── README.md
📌 The project structure may evolve as development continues.
Quizee uses Clerk for authentication and user management.
Authentication is used for features such as:
- 👤 User registration
- 🔑 Login
- 🛡️ Protected application features
- 📝 User-specific quiz management
- 👤 User profiles
MongoDB is used as the primary database, with Mongoose providing schema modeling and database interaction.
Configure the database connection using:
MONGODB_URI=UploadThing is used for handling file uploads.
Required configuration is provided through environment variables.
The project uses multiple branches for development and releases:
🌱 Feature Branch
↓
🛠️ dev
↓
🧪 beta
↓
🚀 main
- 🛠️ dev - Latest development changes
- 🧪 beta - Pre-release/testing branch
- 🚀 main - Production branch
Contributions and improvements are welcome.
git checkout dev
git checkout -b feature/your-featuregit add .
git commit -m "feat: describe your change"git push origin feature/your-featureThen create a pull request for review.
🚧 Quizee is currently under active development.
Features, UI components, APIs, and project architecture may continue to evolve as the project grows.
Muhammad Bin Yasir
🔗 GitHub: MuhammadBinYasir
License information will be added when a license is defined for the project.
⭐ If you find Quizee interesting, consider giving the repository a star!