🦎 Komodo Trivia

Komodo Trivia is a feature-rich quiz application built with Flutter. It leverages the Open Trivia DB API to provide a wide range of questions across various categories. With a sleek UI, theme support, and score tracking, it offers an engaging trivia experience.

---

✨ Features

• 🎨 Dynamic Quiz Categories: Choose from multiple categories like Sports, History, Science, and more.
• ❓ Multiple Question Types: Supports both Multiple Choice Questions (MCQ) and True/False questions.
• 🌓 Theme Selection: Toggle between Light and Dark modes for a comfortable viewing experience.
• 🏆 Score Tracking: Keep track of your score and view your performance at the end of each quiz.
• 📱 Responsive Design: Optimized for various screen sizes.

🛠️ Tech Stack

• Framework: Flutter
• Language: Dart
• State Management: Provider
• Networking: Dio
• Local Storage: Shared Preferences
• UI Components: Shimmer, Custom Widgets

📂 Folder Structure

lib
├── 📂 generated
│   └── assets.dart
├── 📄 main.dart
├── 📂 models
│   └── question_model.dart
├── 📂 providers
│   ├── question_provider.dart
│   └── score_provider.dart
├── 📂 services
│   └── quiz_api_service.dart
├── 📂 ui
│   ├── 📂 commons
│   │   └── internet_error.dart
│   └── 📂 screens
│       ├── 📂 home
│       │   ├── home_screen.dart
│       │   └── quiz_category_card.dart
│       └── 📂 quiz
│           ├── mcq_question.dart
│           ├── option_card.dart
│           ├── question_card.dart
│           ├── question_screen.dart
│           └── quiz_end_screen.dart
└── 📂 utils
    ├── 📂 configs
    │   ├── app_config.dart
    │   └── size_config.dart
    ├── 📂 constants
    │   ├── api_constants.dart
    │   ├── colors_constants.dart
    │   ├── layout_constants.dart
    │   ├── strings_constants.dart
    │   └── textstyle_constants.dart
    ├── 📂 extensions
    ├── 📄 routes.dart
    ├── 📂 styles
    │   └── simple_shadow.dart
    ├── 📄 theme.dart
    └── 📂 validations

🚀 Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Flutter SDK installed.
• An IDE (VS Code, Android Studio, or IntelliJ) with Flutter and Dart plugins.

Installation

1. Clone the Repository

   git clone https://github.com/s4nk37/komodotrivia.git
   cd komodotrivia

2. Install Dependencies

   flutter pub get

3. Run the App

   Connect your device or start an emulator, then run:

   flutter run

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on our code of conduct, and the process for submitting pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.