zeba_academy_exam_ui #

A comprehensive Flutter UI package for building modern exam, quiz, assessment, mock test, and educational applications.

zeba_academy_exam_ui provides beautiful, reusable, and customizable widgets for creating exam interfaces, question cards, timers, result screens, score analytics, and assessment dashboards without requiring any backend integration.

Features #

✨ Question Cards

✨ Multiple Choice Question (MCQ) Layouts

✨ Interactive Option Selection

✨ Exam Countdown Timers

✨ Quiz Navigation Components

✨ Result Screens

✨ Score Cards

✨ Correct & Wrong Answer Summaries

✨ Percentage Analytics Widgets

✨ Material 3 Design Support

✨ Responsive Layouts

✨ Null Safety Support

✨ Lightweight & Dependency-Free

Screenshots #

Add package screenshots here.

Installation #

Add the dependency to your pubspec.yaml:

dependencies:
  zeba_academy_exam_ui: ^1.0.0

Install packages:

flutter pub get

Import #

import 'package:zeba_academy_exam_ui/zeba_academy_exam_ui.dart';

Components #

QuestionModel #

const QuestionModel(
  question: 'Flutter is developed by?',
  options: [
    'Google',
    'Microsoft',
    'Apple',
    'Meta',
  ],
  correctIndex: 0,
);

QuestionCard #

Displays a question along with selectable answer options.

QuestionCard(
  question: question,
  selectedIndex: selectedIndex,
  onSelected: (index) {
    setState(() {
      selectedIndex = index;
    });
  },
)

ExamTimer #

Countdown timer widget for examinations and quizzes.

ExamTimer(
  duration: const Duration(minutes: 10),
  onFinished: () {
    print('Exam Finished');
  },
)

QuizLayout #

Ready-to-use quiz navigation layout.

QuizLayout(
  questions: questions,
)

ScoreCard #

Displays obtained score and total marks.

ScoreCard(
  score: 8,
  total: 10,
)

AnalyticsCard #

Shows percentage analytics.

AnalyticsCard(
  percentage: 80,
)

ResultSummary #

Displays correct and incorrect answer statistics.

ResultSummary(
  correct: 8,
  wrong: 2,
)

ResultScreen #

Complete result page.

ResultScreen(
  result: ResultModel(
    totalQuestions: 10,
    correctAnswers: 8,
    wrongAnswers: 2,
  ),
)

Complete Example #

import 'package:flutter/material.dart';
import 'package:zeba_academy_exam_ui/zeba_academy_exam_ui.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Exam Demo'),
        ),
        body: QuizLayout(
          questions: const [
            QuestionModel(
              question: 'Flutter is developed by?',
              options: [
                'Google',
                'Microsoft',
                'Apple',
                'Meta',
              ],
              correctIndex: 0,
            ),
          ],
        ),
      ),
    );
  }
}

Package Structure #

lib/
├── models/
│   ├── question_model.dart
│   └── result_model.dart
│
├── widgets/
│   ├── analytics_card.dart
│   ├── exam_timer.dart
│   ├── option_tile.dart
│   ├── question_card.dart
│   ├── result_summary.dart
│   └── score_card.dart
│
├── screens/
│   ├── quiz_layout.dart
│   └── result_screen.dart
│
└── zeba_academy_exam_ui.dart

Roadmap #

v1.1.0 #

• Question Palette Widget
• Negative Marking Support
• Review Answers Screen
• Subject-wise Analytics
• Exam Instruction Screen
• Rank Card Widget
• Progress Tracking Widgets
• Pie Chart Analytics
• Dark Theme Optimizations

v1.2.0 #

• OMR Sheet UI
• Leaderboard Widgets
• Animated Result Screens
• Adaptive Tablet Layouts
• Accessibility Enhancements

License #

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

Copyright (C) 2026 Zeba Academy

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

See the LICENSE file for the full license text.

About Me #

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

You can learn more about me and my work at https://sufyanism.com or connect with me on LinkedIn: https://www.linkedin.com/in/sufyanism

Your All-in-One Learning Hub! #

🚀 Explore courses and resources in coding, technology, and development at Zeba Academy.

Empower yourself with practical skills through curated tutorials, real-world projects, and hands-on experience.

Level up your tech journey today.

Zeba Academy is a learning platform dedicated to coding, technology, and development.

➡ Visit our main site: https://zeba.academy

➡ Explore hands-on courses and resources: https://code.zeba.academy

➡ YouTube: https://www.youtube.com/@zeba.academy

➡ Instagram: https://www.instagram.com/zeba.academy/

Thank you for visiting and supporting open-source software.