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:

🧪 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

3. Commit changes

git commit -m "Add new feature"

4. Push changes

git push origin feature/new-feature

5. 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