Skip to content

Latest commit

 

History

History
89 lines (64 loc) · 2.52 KB

README.md

File metadata and controls

89 lines (64 loc) · 2.52 KB
Raw

Quiz Application

An interactive quiz platform built with React, designed to provide an engaging learning experience through dynamic questions and instant feedback.

🌟 Features

  • Interactive Interface: Dynamic question rendering with real-time feedback
  • Score Tracking: Instant score calculation and progress monitoring
  • Responsive Design: Mobile-first approach for seamless experience across devices
  • API Integration: Dynamic data fetching using Axios
  • State Management: Efficient state handling with React hooks
  • Performance Optimized: Built with React 18's latest features

🛠 Technologies Used

Frontend

  • React (v18.2.0): Library for building user interfaces
  • React DOM (v18.2.0): Package for DOM manipulations
  • React Scripts (v5.0.1): Development and build tools

Data Management

  • Axios (v0.27.2): Promise-based HTTP client for API requests

Testing

  • Jest DOM (v5.16.5): DOM testing utilities
  • React Testing Library (v13.3.0): React component testing
  • User Event Testing (v13.5.0): User interaction simulation

Performance

  • Web Vitals (v2.1.4): Performance metrics tracking

🚀 Installation

Follow these steps to set up and run the application locally:

  1. Clone the Repository:

    git clone https://github.com/Eng1Mahmoud/Quiz.git
cd Quiz

  2. Install Dependencies:

    npm install

  3. Start Development Server:

    npm start

🔗 Live Demo

Experience the app live: Quiz App Demo

🤝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  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

📜 Available Scripts

  • npm start: Runs the development server
  • npm test: Executes test suite
  • npm run build: Creates production build
  • npm run eject: Ejects from create-react-app

🐛 Bug Reports

If you discover any bugs, please create an issue here including:

  1. Bug description
  2. Steps to reproduce
  3. Expected behavior
  4. Actual behavior
  5. Screenshots (if applicable)

👨‍💻 Author

Mahmoud Mohamed

If you found this project useful, please consider giving it a ⭐️