|
| 1 | +# Quiz App |
| 2 | + |
| 3 | + |
| 4 | + |
| 5 | +This is a simple, interactive quiz application built with React and styled using TailwindCSS. The app allows users to go through a series of questions, provides feedback on their answers, and displays a final score upon completion. |
| 6 | + |
| 7 | +## Screenshots |
| 8 | +<table> |
| 9 | + <tr> |
| 10 | + <td> |
| 11 | + <h3>Welcome Screen</h3> |
| 12 | + <img src="https://github.com/Temmarie/Web-dev-mini-projects/blob/quiz-app/quiz-app/src/assets/images/welcome.png" alt="Welcome Screen" width="100%"/> |
| 13 | + </td> |
| 14 | + <td> |
| 15 | + <h3>Instructions Screen</h3> |
| 16 | + <img src="https://github.com/Temmarie/Web-dev-mini-projects/blob/quiz-app/quiz-app/src/assets/images/instructions.png" alt="Instructions Screen" width="100%"/> |
| 17 | + </td> |
| 18 | + </tr> |
| 19 | + <tr> |
| 20 | + <td> |
| 21 | + <h3>Quiz Screen</h3> |
| 22 | + <img src="https://github.com/Temmarie/Web-dev-mini-projects/blob/quiz-app/quiz-app/src/assets/images/quiz.png" alt="Quiz Screen" width="100%"/> |
| 23 | + </td> |
| 24 | + <td> |
| 25 | + <h3>Score Screen</h3> |
| 26 | + <img src="https://github.com/Temmarie/Web-dev-mini-projects/blob/quiz-app/quiz-app/src/assets/images/score.png" alt="Completion Screen" width="100%"/> |
| 27 | + </td> |
| 28 | + </tr> |
| 29 | +</table> |
| 30 | + |
| 31 | +## Table of Contents |
| 32 | + |
| 33 | +- [Features](#features) |
| 34 | +- [Technologies Used](#technologies-used) |
| 35 | +- [Getting Started](#getting-started) |
| 36 | + |
| 37 | + |
| 38 | +## Features |
| 39 | + |
| 40 | +- **Welcome Screen**: Users are greeted with a welcome screen where they can choose to start the quiz or view instructions. |
| 41 | +- **Instructions**: An optional instructions screen explaining how to navigate and answer the quiz. |
| 42 | +- **Question Display**: Each question is displayed one at a time with multiple answer choices. |
| 43 | +- **Feedback**: Users receive instant feedback after answering each question. |
| 44 | +- **Progress Indicator**: The app tracks the user's progress, indicating how many questions they have answered and how many are left. |
| 45 | +- **Score Tracking**: The app calculates the final score and displays it upon quiz completion. |
| 46 | +- **Responsive Design**: Fully responsive and mobile-friendly UI using TailwindCSS. |
| 47 | + |
| 48 | +## Built With |
| 49 | + |
| 50 | +- **React** |
| 51 | +- **TailwindCSS** |
| 52 | +- **Vite** |
| 53 | + |
| 54 | +## Getting Started |
| 55 | + |
| 56 | +To get a local copy up and running follow these simple example steps. |
| 57 | + |
| 58 | +### Prerequisites |
| 59 | + |
| 60 | +- **Node.js** (v14 or above) |
| 61 | +- **npm** or **yarn** |
| 62 | + |
| 63 | +### Setup |
| 64 | + |
| 65 | +1. Clone the repository: |
| 66 | + |
| 67 | + ` |
| 68 | + git clone https://github.com/temmarie/quiz-app.git |
| 69 | + cd quiz-app |
| 70 | + ``` |
| 71 | +
|
| 72 | +2. Install dependencies: |
| 73 | +
|
| 74 | + ``` |
| 75 | + npm install |
| 76 | + ``` |
| 77 | +
|
| 78 | +3. Start the development server: |
| 79 | +
|
| 80 | + ``` |
| 81 | + npm run dev |
| 82 | + ``` |
| 83 | +
|
| 84 | +4. Open your browser and navigate to: |
| 85 | +
|
| 86 | + ``` |
| 87 | + http://localhost:5173 |
| 88 | + ``` |
0 commit comments