Quiz App

You can:

• Browse and choose a quiz
• Filter quiz by categories
• Select quiz based on difficulty level and language
• Play quiz and see progress

Live version: click here

Technologies

• Frontend: React, Bootstrap
• Backend: Python, Flask, Sqlite

Run locally

Clone the repo

First of all you need Git on your system to be able to clone the repository.

The following instructions assume that Git
is installed:

• Open your terminal
• navigate to the folder where you want to clone the repository
• clone the repository to your local machine by running:

git clone https://github.com/Romulad/quiz-app.git

• then navigate to the newly created directory to follow the next instructions:

  cd quiz-app

By setting up the dev environment

To run this app locally make sure you have the following prerequisites on your system:

• Node.js, this include npm (Node Package Manager) will be used to run the React app (Front-end).
• Python intepreter, will be used to run the Flask app (API).

Install dependencies and run the Flask app

In a terminal :

• Navigate to the back-end subdirectory under the project root directory:

  cd back-end

• Create a virtual environment:

  python -m venv venv

• Activate the virtual environment:

1. On windows

  .\venv\Scripts\activate

2. On macOS/Linux:

  source venv/bin/activate/

• Install the required packages:

  pip install -r requirements.txt

• once the installation is completed start the app with:

  flask --app app.server run

Next step to see the full app.

Install dependencies and run the front-end :

In a new terminal :

• Navigate to the front-end directory by running:

  cd front-end

• install the necessary packages by running this command:

  npm install

• once the installation is completed start the app with:

  npm start

And you're done! Visit localhost:3000 to view the app.