Quiz Craze is a smart quiz platform built with React and Firebase. It empowers educators to create engaging tests and allows students to take them seamlessly. Ideal for classrooms, colleges, or any learning environment looking to assess knowledge effectively.
- Create, edit, and manage tests with multiple questions
- Monitor total users, tests, and activity
- View and manage student results
- Clear data with one click when needed
- Export results to CSV for offline analysis
- Generate and Save Quizzes – Admins can now generate quizzes using AI (
Groq), save them for later use, and access them anytime.
- Sign up with Register Number, Email, and Password
- Take timed quizzes with real-time answer saving
- Get instant results with correct answers
- Access previous test history (Recent Activity)
- Leaderboard to see top performers
- Authentication with Firebase Auth
- Responsive UI with TailwindCSS
- Role-based routing (Admin / User)
- Zustand for global state management with persistence
- Form validation using
ZodandReact Hook Form
- Frontend: React, TailwindCSS, React Router
- State Management: Zustand
- Form Validation: Zod + React Hook Form
- Backend: Firebase Auth, Firestore
- Icons: Lucide Icons
-
Clone the Repository
git clone https://github.com/danielace1/quiz-app-for-college.git
-
Install dependencies
npm install-
Setup Firebase
-
Create a Firebase project at firebase.google.com
-
Enable Authentication (Email/Password)
-
Enable Firestore Database
-
Add your Firebase config in
src/firebase/index.js -
Add environment variables as per the
.env.examplefile
-
-
Run the App
npm run dev
-
Open in Browser and navigate to
http://localhost:5173
We welcome contributions to Quiz Craze! If you'd like to contribute, please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature/YourFeature). - Make your changes.
- Commit your changes (
git commit -m 'Add some feature'). - Push to the branch (
git push origin feature/YourFeature). - Create a Pull Request.