Zeba Academy Revision Engine

A powerful Flutter package for building intelligent learning revision systems with spaced repetition, revision queues, weak topic detection, review scheduling, and difficulty tracking.

🚀 Features

✨ Spaced Repetition

  • Intelligent review scheduling
  • Automatic next revision calculation
  • Mastery progression tracking

📚 Revision Queue

  • Get daily revision tasks
  • Automatically filters due topics
  • Manage learning workflow

🧠 Weak Topic Detection

  • Identify topics needing improvement
  • Analyze mastery levels
  • Focus learning where it matters

📅 Review Calendar

  • Generate revision schedules
  • Organize reviews by date
  • Plan learning sessions

🎯 Difficulty Tracking

  • Easy / Medium / Hard difficulty levels
  • Difficulty-based learning adjustment
  • Adaptive revision intervals

📦 Installation

Add this package to your pubspec.yaml:

dependencies:
  zeba_academy_revision_engine: ^1.0.0

Run:

flutter pub get

🛠 Usage

Import the package:

import 'package:zeba_academy_revision_engine/zeba_academy_revision_engine.dart';

Create Revision Item

final item = RevisionItem(
  id: "flutter-001",
  topic: "Flutter",
  content: "State Management",
  difficulty: Difficulty.medium,
);

Use Spaced Repetition

final engine = SpacedRepetitionEngine();

engine.review(item);

print(item.nextReview);
print(item.mastery);

Output:

Next Review: 2026-06-18
Mastery: 0.1

📚 Revision Queue

Create a revision queue:

final queue = RevisionQueue(
  [
    item
  ]
);


final today =
queue.getTodayQueue();


for(final revision in today){

  print(revision.topic);

}

🧠 Detect Weak Topics

final detector =
WeakTopicDetector();


final weakTopics =
detector.detect(
[
 item
]
);


print(
weakTopics
);

📅 Review Calendar

Generate learning calendar:

final calendar =
ReviewCalendar();


final schedule =
calendar.generate(
[
 item
]
);


print(schedule);

🎯 Difficulty System

Available difficulty levels:

Difficulty.easy

Difficulty.medium

Difficulty.hard

Difficulty affects revision intervals:

Difficulty Learning Speed
Easy Faster progress
Medium Normal progress
Hard More frequent revision

🧪 Testing

Run package tests:

flutter test

Analyze code:

flutter analyze

🏗 Project Structure

lib/

├── models/
│   ├── revision_item.dart
│   ├── review_record.dart
│   └── difficulty.dart

├── engines/
│   ├── spaced_repetition_engine.dart
│   ├── revision_queue.dart
│   └── weak_topic_detector.dart

├── calendar/
│   └── review_calendar.dart

└── zeba_academy_revision_engine.dart

🛣 Roadmap

Future improvements:

  • JSON serialization
  • Local database support
  • Hive integration
  • SQLite support
  • FSRS algorithm
  • SM-2 algorithm
  • Learning analytics
  • Progress dashboard widgets
  • Cloud synchronization

👨‍💻 About Me

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

Learn more:

🌐 Website: https://sufyanism.com/

💼 LinkedIn: https://www.linkedin.com/in/sufyanism

🎓 Zeba Academy

Your all-in-one learning hub!

🚀 Explore courses and resources in coding, technology, and development.

Build practical skills through:

  • Curated tutorials
  • Real-world projects
  • Hands-on learning

Visit:

🌐 Main Website
https://zeba.academy

💻 Coding Resources
https://code.zeba.academy

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

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

🤝 Contributing

Contributions are welcome!

Steps:

  1. Fork the repository
  2. Create a feature branch
git checkout -b feature/new-feature
  1. Commit changes
git commit -m "Add new feature"
  1. Push changes
git push origin feature/new-feature
  1. Open a Pull Request

📄 License

This project is licensed under the GNU General Public License v3.0.

You are free to use, modify, and distribute this software under the terms of the GPL-3.0 license.

See the LICENSE file for details.

Copyright (C) 2026
Sufyan bin Uzayr

Libraries

zeba_academy_revision_engine