zeba_academy_history #

A lightweight, dependency-free Flutter history management package that provides undo, redo, history stacks, checkpoints, snapshots, and history clearing with a simple and flexible API.

Perfect for Flutter applications that require state history management such as:

• Text editors
• Drawing applications
• Form builders
• Design tools
• Note applications
• Configuration editors
• Data modification workflows

Features 🚀 #

✅ Undo functionality ✅ Redo functionality ✅ History stack management ✅ Configurable history limit ✅ Create checkpoints ✅ Restore checkpoints ✅ Save snapshots ✅ Retrieve snapshots ✅ Remove checkpoints ✅ Clear history ✅ Clear all stored data ✅ Generic type support ✅ Null safety ✅ No external dependencies

Installation #

Add this package to your pubspec.yaml:

dependencies:
  zeba_academy_history: ^1.0.0

Then run:

flutter pub get

Import #

import 'package:zeba_academy_history/zeba_academy_history.dart';

Basic Usage #

Create a history manager:

final history = HistoryManager<String>();

Add History States #

Store application states:

history.add("Initial");

history.add("Updated");

history.add("Final");

Undo #

Move back to the previous state:

final previous = history.undo();

print(previous);

Output:

Updated

Redo #

Restore the undone state:

final next = history.redo();

print(next);

Output:

Final

Checkpoints #

Create named restore points:

history.createCheckpoint(
  "before_edit",
  "Before Editing",
  "Original Content",
);

Restore checkpoint:

final value =
    history.restoreCheckpoint(
      "before_edit",
    );

print(value);

Snapshots #

Save temporary states:

history.saveSnapshot(
  "draft",
  "Draft Content",
);

Retrieve snapshot:

final snapshot =
    history.getSnapshot("draft");

print(snapshot);

History Information #

Check undo availability:

if(history.canUndo){
  print("Undo available");
}

Check redo availability:

if(history.canRedo){
  print("Redo available");
}

Get history count:

print(history.historyLength);

Clear History #

Remove undo and redo states:

history.clearHistory();

Clear Everything #

Remove history and checkpoints:

history.clearAll();

Custom History Limit #

Control stored history size:

final history =
    HistoryManager<int>(
      maxHistory: 100,
    );

Example #

final manager =
    HistoryManager<int>();


manager.add(10);

manager.add(20);

manager.add(30);


print(
  manager.undo(),
);


print(
  manager.redo(),
);

Why Use zeba_academy_history? #

Flutter applications often need reliable state tracking.

Instead of manually creating undo and redo logic, this package provides:

• Clean API
• Reusable architecture
• Generic state handling
• Simple integration
• Lightweight implementation

Supported Flutter Versions #

Package Structure #

lib/
│
├── zeba_academy_history.dart
│
└── src/
    ├── history_manager.dart
    ├── history_entry.dart
    └── history_checkpoint.dart

License #

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

You are free to:

✅ Use ✅ Modify ✅ Share ✅ Distribute

under the conditions of the GPL-3.0 license.

See the LICENSE file for complete details.

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:

sufyanism.com

or connect with me on:

LinkedIn

Zeba Academy 🚀 #

Your all-in-one learning hub! #

Explore courses and resources in coding, technology, and development at:

• zeba.academy
• code.zeba.academy

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

Learn through:

• Practical tutorials
• Real-world projects
• Hands-on coding experience
• Developer-focused resources

Connect With Zeba Academy #

🌐 Website: https://zeba.academy

💻 Learning Platform: https://code.zeba.academy

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

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

Thank you for visiting! ⭐

Happy Coding with zeba_academy_history 🚀