{"id":20619384,"url":"https://github.com/danielace1/quiz-app-for-college","last_synced_at":"2026-04-14T03:31:21.663Z","repository":{"id":256974911,"uuid":"856539246","full_name":"danielace1/quiz-app-for-college","owner":"danielace1","description":"⚡ A smart quiz platform built with React \u0026 Firebase - perfect for educators to create tests and students to take them with ease.","archived":false,"fork":false,"pushed_at":"2025-10-23T19:49:58.000Z","size":4112,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-25T14:56:18.788Z","etag":null,"topics":["firebase","firebase-auth","javascript","quizapp","react-router-dom","reactjs","tailwindcss","zustand-state-management"],"latest_commit_sha":null,"homepage":"https://quiz-craze-pi.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danielace1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-12T18:42:54.000Z","updated_at":"2025-12-02T05:50:32.000Z","dependencies_parsed_at":"2024-09-14T06:25:57.728Z","dependency_job_id":"8ac2b3f1-2fd5-40e7-8e38-3ccfa2427564","html_url":"https://github.com/danielace1/quiz-app-for-college","commit_stats":null,"previous_names":["danielace1/quiz-app-for-college"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/danielace1/quiz-app-for-college","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielace1%2Fquiz-app-for-college","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielace1%2Fquiz-app-for-college/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielace1%2Fquiz-app-for-college/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielace1%2Fquiz-app-for-college/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielace1","download_url":"https://codeload.github.com/danielace1/quiz-app-for-college/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielace1%2Fquiz-app-for-college/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31781292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["firebase","firebase-auth","javascript","quizapp","react-router-dom","reactjs","tailwindcss","zustand-state-management"],"created_at":"2024-11-16T12:11:31.685Z","updated_at":"2026-04-14T03:31:21.657Z","avatar_url":"https://github.com/danielace1.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Quiz Craze\n\n**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.\n\n![Quiz Craze Preview](https://quiz-craze-pi.vercel.app/preview-image.jpg)\n\n### 🌍 [Live Link](https://quiz-craze-pi.vercel.app)\n\n---\n\n## ✨ Features\n\n### 👨‍🏫 Admin (Educator)\n\n- Create, edit, and manage tests with multiple questions\n- Monitor total users, tests, and activity\n- View and manage student results\n- Clear data with one click when needed\n- Export results to CSV for offline analysis\n- Generate and Save Quizzes – Admins can now generate quizzes using AI (`Groq`), save them for later use, and access them anytime.\n\n### 👩‍🎓 User (Student)\n\n- Sign up with Register Number, Email, and Password\n- Take timed quizzes with real-time answer saving\n- Get instant results with correct answers\n- Access previous test history (Recent Activity)\n- Leaderboard to see top performers\n\n### 🌐 General\n\n- Authentication with Firebase Auth\n- Responsive UI with TailwindCSS\n- Role-based routing (Admin / User)\n- Zustand for global state management with persistence\n- Form validation using `Zod` and `React Hook Form`\n\n---\n\n## 🛠️ Tech Stack\n\n- **Frontend**: React, TailwindCSS, React Router\n- **State Management**: Zustand\n- **Form Validation**: Zod + React Hook Form\n- **Backend**: Firebase Auth, Firestore\n- **Icons**: Lucide Icons\n\n---\n\n## 📦 Installation\n\n1. **Clone the Repository**\n\n   ```bash\n   git clone https://github.com/danielace1/quiz-app-for-college.git\n   ```\n\n2. **Install dependencies**\n\n```bash\nnpm install\n```\n\n3. **Setup Firebase**\n\n   - Create a Firebase project at [firebase.google.com](https://firebase.google.com)\n\n   - Enable Authentication (Email/Password)\n\n   - Enable Firestore Database\n\n   - Add your Firebase config in `src/firebase/index.js`\n\n   - Add environment variables as per the `.env.example` file\n\n4. **Run the App**\n\n   ```bash\n   npm run dev\n   ```\n\n5. **Open in Browser** and navigate to `http://localhost:5173`\n\n## 🤝 Contributing\n\nWe welcome contributions to **Quiz Craze**! If you'd like to contribute, please follow these steps:\n\n1. [Fork](https://github.com/danielace1/quiz-app-for-college/fork) the repository.\n2. Create a new branch (`git checkout -b feature/YourFeature`).\n3. Make your changes.\n4. Commit your changes (`git commit -m 'Add some feature'`).\n5. Push to the branch (`git push origin feature/YourFeature`).\n6. Create a [Pull Request](https://github.com/danielace1/quiz-app-for-college/pulls).\n\n## 🔑 License\n\n[MIT](./License)\n\n## 👨‍💻 Author\n\n- [Sudharsan](https://www.facebook.com/sudharsandaniel01)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielace1%2Fquiz-app-for-college","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielace1%2Fquiz-app-for-college","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielace1%2Fquiz-app-for-college/lists"}