https://github.com/anashany2193/react-quiz-app
https://github.com/anashany2193/react-quiz-app
Last synced: over 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/anashany2193/react-quiz-app
- Owner: AnasHany2193
- Created: 2024-08-22T19:50:26.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-25T17:17:09.000Z (almost 2 years ago)
- Last Synced: 2025-02-05T15:46:38.876Z (over 1 year ago)
- Language: JavaScript
- Size: 200 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📚 React Quiz App
Welcome to the **React Quiz App**! This app allows users to test their knowledge through a series of interactive quizzes.
## ✨ Features
- 🎯 **Interactive Quiz Experience**: Engage with multiple-choice questions.
- 🧠 **Context API Integration**: Efficient state management across the app.
- 🔍 **Real-Time Feedback**: Immediate responses after each question.
- 📊 **Score Tracking**: Keep track of your progress and see your results.
## 🌐 Live Demo
Check out the live demo of the React Quiz App here: [React Quiz App Demo](https://the-react-quiz-2193.netlify.app/)
## 🚀 Getting Started
To get a local copy up and running, follow these steps:
### Prerequisites
- 🖥️ **Node.js**: Ensure you have Node.js installed.
- 📦 **NPM**: Comes with Node.js. Ensure it is up-to-date.
### Installation
1. **Clone the repo**:
```bash
git clone https://github.com/AnasHany2193/React-Quiz-App.git
```
2. **Navigate to the project directory**:
```bash
cd React-Quiz-App
```
3. **Install NPM packages**:
```bash
npm install
```
## 🛠️ Usage
1. **Start the development server**:
```bash
npm start
```
2. Open [http://localhost:3000](http://localhost:3000) to view it in your browser.
## 🔄 Recent Changes
- ♻️ **Refactored** to use the Context API for improved state management.
- 🔄 **Renamed** duplicate `src` folder to `src-no-context`.
## 📂 Project Structure
- **`src-no-context/`**: Original codebase without Context API.
- **`src/`**: Updated codebase with Context API for state management.
## 🤝 Contributing
Contributions are what make the open-source community such an amazing place! Any contributions you make are **greatly appreciated**.
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**.
## 📧 Contact
Anas Hany - [LinkedIn](https://www.linkedin.com/in/anashany219/) - anashany219@gmail.com