https://github.com/danielace1/quiz-app-for-college
⚡ A smart quiz platform built with React & Firebase - perfect for educators to create tests and students to take them with ease.
https://github.com/danielace1/quiz-app-for-college
firebase firebase-auth javascript quizapp react-router-dom reactjs tailwindcss zustand-state-management
Last synced: about 2 months ago
JSON representation
⚡ A smart quiz platform built with React & Firebase - perfect for educators to create tests and students to take them with ease.
- Host: GitHub
- URL: https://github.com/danielace1/quiz-app-for-college
- Owner: danielace1
- License: mit
- Created: 2024-09-12T18:42:54.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-23T19:49:58.000Z (7 months ago)
- Last Synced: 2025-12-25T14:56:18.788Z (5 months ago)
- Topics: firebase, firebase-auth, javascript, quizapp, react-router-dom, reactjs, tailwindcss, zustand-state-management
- Language: JavaScript
- Homepage: https://quiz-craze-pi.vercel.app
- Size: 3.92 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 Quiz Craze
**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.
### 🌍 [Live Link](https://quiz-craze-pi.vercel.app)
---
## ✨ Features
### 👨🏫 Admin (Educator)
- 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.
### 👩🎓 User (Student)
- 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
### 🌐 General
- Authentication with Firebase Auth
- Responsive UI with TailwindCSS
- Role-based routing (Admin / User)
- Zustand for global state management with persistence
- Form validation using `Zod` and `React Hook Form`
---
## 🛠️ Tech Stack
- **Frontend**: React, TailwindCSS, React Router
- **State Management**: Zustand
- **Form Validation**: Zod + React Hook Form
- **Backend**: Firebase Auth, Firestore
- **Icons**: Lucide Icons
---
## 📦 Installation
1. **Clone the Repository**
```bash
git clone https://github.com/danielace1/quiz-app-for-college.git
```
2. **Install dependencies**
```bash
npm install
```
3. **Setup Firebase**
- Create a Firebase project at [firebase.google.com](https://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.example` file
4. **Run the App**
```bash
npm run dev
```
5. **Open in Browser** and navigate to `http://localhost:5173`
## 🤝 Contributing
We welcome contributions to **Quiz Craze**! If you'd like to contribute, please follow these steps:
1. [Fork](https://github.com/danielace1/quiz-app-for-college/fork) the repository.
2. Create a new branch (`git checkout -b feature/YourFeature`).
3. Make your changes.
4. Commit your changes (`git commit -m 'Add some feature'`).
5. Push to the branch (`git push origin feature/YourFeature`).
6. Create a [Pull Request](https://github.com/danielace1/quiz-app-for-college/pulls).
## 🔑 License
[MIT](./License)
## 👨💻 Author
- [Sudharsan](https://www.facebook.com/sudharsandaniel01)