Skip to content

rharithra/Quiz-App

Repository files navigation

🎯 Quiz App

A modern, interactive quiz application built with React and TypeScript. Test your knowledge across multiple categories with a beautiful, responsive interface.

✨ Features

  • Multiple Categories: Choose from General Knowledge, Science & Technology, History, and Geography
  • Timer Functionality: 5-minute time limit for each quiz
  • Progress Tracking: Visual progress bar and question counter
  • Score Calculation: Real-time score updates and final results
  • Responsive Design: Works perfectly on desktop and mobile devices
  • Beautiful UI: Modern gradient design with smooth animations

🚀 Getting Started

Prerequisites

Make sure you have Node.js installed on your system. You can download it from nodejs.org.

Installation

  1. Clone or download this project
  2. Open your terminal/command prompt
  3. Navigate to the project directory
  4. Install dependencies:
npm install

Running the App

Start the development server:

npm start

The app will open in your browser at http://localhost:3000

Building for Production

To create a production build:

npm run build

🎮 How to Play

  1. Choose a Category: Select from the available quiz categories
  2. Answer Questions: Click on your chosen answer for each question
  3. Track Progress: Watch your score and time remaining
  4. View Results: See your final score and performance statistics
  5. Try Again: Take another quiz or try a different category

📊 Quiz Categories

  • General Knowledge: Test your knowledge about various topics
  • Science & Technology: Explore the world of science and technology
  • History: Journey through time with historical facts
  • Geography: Discover the world around us

🛠️ Built With

  • React 18: Modern React with hooks
  • TypeScript: Type-safe JavaScript
  • CSS3: Custom styling with gradients and animations
  • Create React App: Zero-configuration build tool

📱 Features

  • Timer: 5-minute countdown for each quiz
  • Progress Bar: Visual indication of quiz progress
  • Score Tracking: Real-time score updates
  • Responsive Design: Works on all device sizes
  • Category Selection: Choose from multiple quiz topics
  • Results Summary: Detailed performance statistics

🎨 Design

The app features a modern, gradient-based design with:

  • Smooth hover animations
  • Card-based layout
  • Color-coded feedback
  • Responsive grid system
  • Beautiful typography

📝 License

This project is open source and available under the MIT License.


Enjoy testing your knowledge! 🧠✨

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors