Generate smart, AI-powered quizzes instantly using Google's Gemini AI
Built with React, Firebase, and Netlify — a next-gen learning experience!

🔗 Live Site: https://jinsu-quizify-ai.netlify.app

• ✨ Features
• 🛠️ Tech Stack
• 🏁 Getting Started
• ⚙️ Installation & Setup
• 🔥 Firebase Configuration
• ☁️ Google Cloud Configuration
• 🌍 Netlify & Environment Variables
• 🚀 Deployment
• 👨‍💻 Creator

• Uses Google Gemini AI to create context-aware quizzes.

• Generate quizzes from any topic.
• Upload text files (.txt, .csv) to auto-generate questions.

• Number of Questions: 1–100
• Choices per Question: 2–10
• Difficulty Levels: Easy, Moderate, Hard

• Time per question (seconds)
• Time for entire quiz (minutes)
• Option for no timer

• Email/Password signup & login
• Social Login via Google & GitHub
• Guest Mode (no login required)

• View quiz stats (total quizzes, average score)
• Upload custom profile picture

• Stores completed quizzes for logged-in users
• Review answers: correct vs selected

• Dedicated section recognizing the developer

• Installable Progressive Web App

• Dark theme using Tailwind CSS

Follow these steps to set up and run the project locally.

• Node.js (v18 or later)
• npm (comes with Node.js)
• Git
• Firebase Account
• Google Cloud Account (Gemini API Key with Billing Enabled)
• Netlify Account

git clone https://github.com/jinsu-2005/quizify.git
cd quizify

npm install

cd netlify/functions
npm install busboy node-fetch@2
cd ../..

1. Go to your Firebase project settings → Register a Web App.
2. Copy the firebaseConfig object.
3. Paste it into the firebaseConfig variable in src/App.jsx.
4. Enable these Firebase services:
   • Authentication (Email/Password, Google, GitHub, Anonymous)
   • Firestore Database

Authentication Settings:

• Add localhost under Authorized domains.
• Set User account linking → “Link accounts that use the same email”.

1. Link your Firebase project to Google Cloud.
2. Enable APIs:
   • Generative Language API
   • Cloud Firestore API
3. Link your project to a Billing Account.
4. Generate your Gemini API Key under
   APIs & Services → Credentials → Create API Key.
5. Configure OAuth consent screen → Add required scopes and publish.

Create a .env file in your root directory:

GEMINI_API_KEY=AIzaSy...YourSecretKey...

Run the app locally:

netlify dev

Then open 👉 http://localhost:8888

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/jinsu-2005/quizify.git
git push -u origin main

netlify init

• Build command: npm run build
• Publish directory: build
• Functions directory: netlify/functions

Go to
Netlify → Site configuration → Build & deploy → Environment variables
Add your GEMINI_API_KEY.

git add .
git commit -m "Deploy latest changes"
git push

Built with ❤️ by Jinsu J — Empowering Learning with AI 🚀