README.md

---

Quiz It! 🧠🎉

A fun and exciting quiz app where you can test your knowledge across various categories!

🚀 Live Demo

👉 Quiz It! Live

---

📌 Features

✅ Play quizzes without signing in
✅ Choose from multiple categories (General Knowledge, History, Science, Tech, etc.)
✅ Track your progress with a personalized scoreboard (requires login)
✅ Secure user authentication with Clerk
✅ Leaderboard to compare scores with others
✅ Responsive UI built with TailwindCSS

---

📷 Screenshots

HomePage	Leader Board
User Profile	Category Selection
Questions	Instructions

---

🛠 Tech Stack

Frontend:

• ⚡ Vite + React.js (Fast and optimized development)
• 🎨 TailwindCSS (For modern and responsive UI)
• 🔐 Clerk (User authentication & management)

Backend:

• 🛢 Supabase (Database & user data storage)
• 🚀 Express.js (Leaderboard API)

---

🏗 Setup & Installation

1️⃣ Clone the Repository

git clone https://github.com/Temmarie/Quiz-it.git
cd Quiz-it

2️⃣ Install Dependencies

npm install

3️⃣ Set Up Environment Variables

Create a .env file in the root directory and add the following variables:

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_KEY=your_supabase_key
VITE_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
VITE_BACKEND_URL=your_backend_api_url
VITE_CLERK_SECRET_KEY=clerk_secret_key

(Replace with actual keys from Supabase & Clerk)

4️⃣ Run the Development Server

npm run dev

The app will be available at http://localhost:5173/ 🚀

---

🔥 Backend Setup (Leaderboard API)

The backend is powered by Express.js. Follow these steps to set it up:

1️⃣ Clone the Repository

git clone https://github.com/Temmarie/Quiz_iT_Express.git

cd Quiz-iT_Express

2️⃣ Install Dependencies

npm install

2️⃣ Install Backend Dependencies

npm install

3️⃣ Set Up Environment Variables

Create a .env.server file in the root directory and add the following variables:

VITE_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
VITE_BACKEND_URL=your_backend_api_url
VITE_CLERK_SECRET_KEY=clerk_secret_key

3️⃣ Start the Server

node server.js

Your API should now be running at http://localhost:3000/

---

Author

👤 Grace Tamara Ekunola

• Github: @Temmarie
• Twitter: @TemmarieW
• Linkedin: Grace Tife Ekunola

🤝 Contributing

Feel free to fork the repo, create a new branch, and submit a pull request or check the issues page.

---

📜 License

This project is licensed under the MIT License.

---

🎉 Enjoy playing Quiz It! and test your knowledge! 🧠🚀