🎓 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 #

🎨 UI Architecture #

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

Designed for scalability and large edtech applications.

⚙️ Included Components #

⏱ 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 #

🧪 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/