Skip to content

kritmanrao/react-quiz

Repository files navigation

Got it 👍 I’ll fill in all your real links and details into that README template so you can just copy-paste it.

Here’s your polished README.md:


# React Quiz App ⚛️

A dynamic and engaging quiz application built with **React** and **Vite** to test your knowledge.  
Answer multiple-choice questions, track your score in real-time, and challenge yourself to beat your personal best!

[![Netlify Status](https://api.netlify.com/api/v1/badges/87cf573f-4d93-4b1f-8fd8-XXXXXXXXXXXX/deploy-status)](https://app.netlify.com/sites/reactqze/deploys)

---

## 🚀 Live Demo

**Check out the live version of the app here:**  
👉 [React Quiz Live](https://reactqze.netlify.app/)

---

## 📸 Screenshot

*(Add a screenshot of your app here, e.g. `public/screenshot.png`)*  
```md
![Quiz Screenshot](public/screenshot.png)

📋 Table of Contents


✨ Features

  • ❓ Multiple-choice questions
  • 💯 Real-time scoring
  • 🏆 High score tracking with local storage
  • 📱 Fully responsive design
  • 🌍 Deployed on Netlify

🛠️ Tech Stack

  • Frontend: React.js + Vite
  • State Management: React Hooks (useState, useEffect, useReducer)
  • Styling: CSS (or Tailwind if you add later)
  • Deployment: Netlify

⚙️ Getting Started

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/kritmanrao/react-quiz.git
    cd react-quiz
  2. Install dependencies:

    npm install
  3. Start the development server:

    npm run dev

    Open http://localhost:5173 in your browser.

  4. Build for production:

    npm run build

🕹️ How to Use

  1. Click the "Start Quiz" button.
  2. Answer the multiple-choice questions.
  3. Your score updates in real-time.
  4. At the end, compare your result with your personal best.

🔮 Future Enhancements

  • Add different categories (JavaScript, CSS, React, etc.)
  • Implement difficulty levels (Easy/Medium/Hard)
  • Add a timer for each question
  • Save high scores to a backend database
  • Create a leaderboard

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


📧 Contact

Kritman Kumar Rao 📩 kritmanrao123@gmail.com 🔗 GitHub: kritmanrao 🔗 Live Demo: React Quiz App

About

Test your React knowledge with our fast-paced quiz! Answer 15 challenging questions against the clock. Track your score in real-time and see if you can beat your personal best. Can you achieve a perfect score?

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages