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

0 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors