🎓 zeba_academy_exam_simulator

A professional Flutter exam simulation engine that replicates real CBT (Computer Based Test) environments used in competitive exams.

Built for edtech apps, mock test platforms, and learning systems — with clean architecture, responsive UI, and reusable components.

✨ Features

✅ Real Exam Navigation Palette ✅ Mark for Review option ✅ Auto submit when timer ends ✅ Negative marking system ✅ Question status tracking ✅ Exam progress indicator ✅ Responsive mobile + tablet UI ✅ Material 3 design ✅ Fully reusable package architecture

📸 Screenshots

📱 Exam Screen

Exam Screen

🎯 Question Navigation Palette

Question Palette

🏆 Result Screen

Result Screen

🚀 Installation

Add dependency:

dependencies:
  zeba_academy_exam_simulator: ^1.0.0

Or use local path during development:

zeba_academy_exam_simulator:
  path: ../

Then run:

flutter pub get

🧱 Basic Usage

1️⃣ Import Package

import 'package:zeba_academy_exam_simulator/zeba_academy_exam_simulator.dart';

2️⃣ Create Questions

final questions = [
  ExamQuestion(
    id: "1",
    question: "Capital of India?",
    options: ["Delhi", "Mumbai", "Chennai", "Kolkata"],
    correctIndex: 0,
  ),
];

3️⃣ Configure Exam

final controller = ExamController(
  config: ExamConfig(
    examDuration: Duration(minutes: 30),
    positiveMarks: 4,
    negativeMarks: -1,
  ),
  questions: questions,
);

4️⃣ Launch Exam Screen

MaterialApp(
  theme: ExamTheme.light(),
  home: ExamScreen(controller: controller),
);

🧠 Question Status Logic

Status Meaning
⬜ Not Visited Question not opened
🟩 Answered Option selected
🟧 Marked Review Needs review
🟪 Answered + Review Answered but flagged

🎨 UI Architecture

lib/
 ├── src/
 │   ├── core/
 │   │   ├── models/
 │   │   ├── controller/
 │   │   └── engine/
 │   ├── ui/
 │   │   ├── screens/
 │   │   ├── widgets/
 │   │   └── theme/
 │   └── utils/

Designed for scalability and large edtech applications.

⚙️ Included Components

Component Purpose
ExamController Exam state engine
ExamScreen Main exam UI
QuestionCard Question renderer
QuestionPalette Navigation grid
ExamHeader Timer + progress
ExamTheme Material 3 theme

⏱ Timer Behaviour

  • Countdown starts automatically
  • Updates UI every second
  • Auto-submits exam when time ends

🧮 Scoring System

Correct Answer   → +positiveMarks
Wrong Answer     → negativeMarks
Unanswered       → 0

Fully configurable.

📱 Responsive Layout

Device Layout
Mobile Palette at bottom
Tablet Side palette
Desktop CBT-style interface

🧪 Running Example

cd example
flutter run

📦 Publishing Checklist

flutter analyze
flutter test
flutter pub publish --dry-run

🗺 Roadmap

  • Section-wise exams
  • Resume exam support
  • Result analytics charts
  • Dark mode theme
  • Offline persistence
  • AI difficulty adaptation

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

📄 License

GNU General Public License v3.0 (GPL-3.0)

❤️ Zeba Academy

Built with Flutter for modern education platforms.

Website: https://zeba.academy/flutter/

Libraries

zeba_academy_exam_simulator