Welcome to Quizolia, the ultimate quiz experience designed to make learning fun, engaging, and interactive! Quizolia is a Flask-based web application that fetches quiz questions across various categories and difficulties, providing an enjoyable way to test and expand your knowledge.
- Dynamic Quiz Generation: Get quiz questions in real-time.
- Customizable Difficulty: Choose from easy, medium, or hard questions.
- Wide Range of Categories: Explore quizzes in categories such as Science, History, Entertainment, and more.
- Instant Feedback: Receive immediate feedback on your answers to track your progress.
- Responsive Design: Enjoy a seamless experience on both desktop and mobile devices.
Check out the live version of Quizolia: Quizolia on Render
- Access the App: Visit the deployed link at Quizolia.
- Select a Category: Pick a category that interests you from the dropdown menu.
- Choose Difficulty: Select the difficulty level of your quiz.
- Start the Quiz: Click on the "Start Quiz" button to begin.
- Answer Questions: Provide answers to the questions presented and receive instant feedback.
- View Results: After completing the quiz, see your score and review your answers.
If you’d like to run Quizolia locally, follow these steps:
- Python 3.8+
- pip (Python package installer)
-
Clone the Repository:
git clone https://github.com/yourusername/quizolia.git cd quizolia
-
Set Up a Virtual Environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install Dependencies:
pip install -r requirements.txt
-
Run the Application:
flask run
-
Access the App: Open your browser and navigate to
http://127.0.0.1:5000
.
Quizolia fetches quiz questions dynamically using an external quiz API. For developers, this makes it easy to integrate or extend the app with additional features or APIs.
We welcome contributions to improve Quizolia! To contribute:
- Fork the repository.
- Create a new branch for your feature or bug fix:
git checkout -b feature-name
- Commit your changes:
git commit -m "Describe your changes"
- Push to your branch:
git push origin feature-name
- Open a Pull Request.
- Add a leaderboard to track top performers.
- Implement user authentication for personalized experiences.
- Expand question categories and languages.
- Integrate timer functionality for timed quizzes.
This project is licensed under the MIT License. See the LICENSE file for details.
- Flask: For powering the backend.
- Open Trivia API: For providing a rich database of quiz questions.
- Render: For hosting the live application.
Enjoy the fun and challenge of Quizolia! Whether you're a trivia enthusiast or just looking to learn something new, Quizolia has something for everyone. Start your quiz adventure today!
Built with 💖 by Daniel Dohou and Precious Ese