Skip to content

Temmarie/Quiz-it

Repository files navigation


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

Welcome

Leader Board

leader board

User Profile

Profile

Category Selection

Categories

Questions

questions

Instructions

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! 🧠🚀

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published