Skip to content

Hayelalfaisali/quiz-app

Repository files navigation

Quiz App

A modern, interactive quiz application built with React and Vite. Test your knowledge with engaging questions and get instant feedback on your answers.

Features

  • 📱 Responsive design that works on desktop and mobile
  • ⚡ Fast and smooth user experience with React
  • 🎯 Instant feedback on quiz answers
  • 🎨 Modern UI with Bootstrap styling
  • 📊 Score tracking and results summary

Tech Stack

  • React 18
  • Vite
  • Bootstrap 5
  • React Bootstrap

Getting Started

Prerequisites

  • Node.js (Latest LTS version recommended)
  • npm or yarn

Installation

  1. Clone the repository
git clone [your-repo-url]
cd quiz-app
  1. Install dependencies
npm install
  1. Start the development server
npm run dev

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

Building for Production

To create a production build:

npm run build

The built files will be in the dist directory.

Project Structure

quiz-app/
├── public/          # Static assets
├── src/             # Source files
├── index.html       # Entry HTML file
└── vite.config.js   # Vite configuration

Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run preview - Preview production build
  • npm run lint - Run ESLint

Contributing

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

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