A beautifully designed Flutter Quiz App powered by Riverpod and the Trivia API
Clean UI • Custom Quiz Builder • Dark Mode • Confetti Results
• API-based quiz (Easy / Medium / Hard) • Custom Admin-created quiz • 10 questions per quiz
• Create 4-option MCQ questions • Mark correct answers • Edit questions • Delete questions • Auto-limit to 10 questions • Completion dialog when quiz is ready
• ❤️ 3 Lives system • Skip question with score penalty • Back & Next navigation • Instant green/red answer feedback • Automatic score calculation
• Professional gradient theme • Dark & Light mode toggle • Smooth card animations • Clean Material 3 UI • Confetti celebration on results • Fully responsive layout
flowchart LR
A[User Opens App] --> B[Splash Screen]
B --> C[Welcome Screen]
C --> D{Select Mode}
D -->|API Quiz| E[Fetch Questions from Trivia API]
D -->|Custom Quiz| F[Load Admin Questions]
E --> G[Play Quiz Screen]
F --> G
G --> H[Answer Questions]
H --> I[Calculate Score]
I --> J[Result Screen]
J --> K[Confetti Celebration]
flowchart TD
A[Start Quiz] --> B[Load Questions]
B --> C[Display Question]
C --> D{User Answer}
D -->|Correct| E[Increase Score]
D -->|Wrong| F[Lose Life]
E --> G[Next Question]
F --> G
G --> H{Questions Left?}
H -->|Yes| C
H -->|No| I[Show Result Screen]
flowchart LR
A[UI Widgets] --> B[Riverpod Providers]
B --> C[Quiz State]
C --> D[Question Controller]
D --> E[API / Local Quiz Data]
E --> C
| Technology | Purpose |
|---|---|
| Flutter | UI Framework |
| Riverpod | State Management |
| GetX | Navigation + Theme |
| HTTP | API Requests |
| Lottie | Splash Animation |
| Confetti | Result Celebration |
Questions are fetched from:
https://the-trivia-api.com/api/questions?limit=10&difficulty=easy
Supported difficulty levels:
• easy • medium • hard
lib/
├── main.dart
├── splash_screen.dart
├── welcome_screen.dart
├── create_quiz_screen.dart
├── play_quiz_screen.dart
├── result_screen.dart
✔ Dual quiz system (API + Custom) ✔ Admin quiz builder ✔ Lives-based gameplay system ✔ Skip penalty feature ✔ Beautiful Flutter UI ✔ Dark mode support ✔ Confetti celebration ✔ Structured Flutter architecture
This is not a simple quiz app — It is a well-structured Flutter project demonstrating real-world app architecture.
Clone the repository
git clone https://github.com/akankshacore/TriviaX.git
Navigate to project folder
cd TriviaX
Install dependencies
flutter pub get
Run the app
flutter run
Akanksha