zeba_academy_selection 🎯

A lightweight and reusable Flutter selection management package that provides powerful selection utilities including single selection, multi selection, toggle selection, select all, and clear selection.

Built with ❤️ for Flutter developers by Zeba Academy.

✨ Features

zeba_academy_selection provides simple and flexible selection handling for Flutter applications.

Available Features

✅ Single selection ✅ Multi selection ✅ Toggle selection ✅ Select all items ✅ Clear selections ✅ Remove selected items ✅ Generic type support ✅ Null safety support ✅ Lightweight and dependency free ✅ Controller-based architecture

🚀 Installation

Add the package to your pubspec.yaml file:

dependencies:
  zeba_academy_selection: ^1.0.0

Run:

flutter pub get

📖 Usage

Single Selection

Create a selection controller:

final controller = SelectionController<String>();

Use the single selection widget:

ZebaSingleSelection<String>(
  items: [
    "Flutter",
    "Dart",
    "Firebase",
  ],

  controller: controller,

  builder: (context, item, selected) {

    return ListTile(
      title: Text(item),

      trailing: selected
          ? const Icon(Icons.check)
          : null,
    );

  },
);

Multiple Selection

Create a multi-selection controller:

final controller = MultiSelectionController<String>();

Use:

ZebaMultiSelection<String>(

  items: [
    "Flutter",
    "Dart",
    "Firebase",
  ],

  controller: controller,

  builder: (context, item, selected) {

    return CheckboxListTile(

      title: Text(item),

      value: selected,

      onChanged: null,

    );

  },

);

🎯 Controller APIs

SelectionController

Used for handling single selection.

Select Item

controller.select("Flutter");

Check Selection

controller.isSelected("Flutter");

Toggle Selection

controller.toggle("Flutter");

Clear Selection

controller.clear();

MultiSelectionController

Used for handling multiple selections.

Add Selection

controller.select("Flutter");

Remove Selection

controller.remove("Flutter");

Toggle Selection

controller.toggle("Flutter");

Select All

controller.selectAll([
  "Flutter",
  "Dart",
  "Firebase",
]);

Clear All

controller.clear();

💡 Use Cases

This package is useful for:

  • Category selection
  • Filter chips
  • Tags selection
  • Multi-choice forms
  • Permission selection
  • Interest selection
  • Product filtering
  • Quiz options
  • Dashboard filters
  • Settings screens

📂 Package Structure

lib/
│
├── zeba_academy_selection.dart
│
└── src/
    │
    ├── selection_controller.dart
    ├── multi_selection.dart
    ├── single_selection.dart
    └── selection_group.dart

🧪 Testing

Run package tests:

flutter test

Analyze the package:

flutter analyze

Check publishing:

flutter pub publish --dry-run

🌟 Why Zeba Academy Packages?

Zeba Academy Flutter packages are created with:

  • Clean and simple APIs
  • Developer-friendly architecture
  • Production-ready code
  • Easy integration
  • Open-source learning approach

👨‍💻 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:

https://sufyanism.com/

or connect with me on LinkedIn:

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

🚀 Your all-in-one learning hub!

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

Explore courses, tutorials, and practical resources designed to help developers build real-world skills.

➡ Main website:

https://zeba.academy

➡ Coding courses and resources:

https://code.zeba.academy

➡ YouTube tutorials:

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

➡ Instagram:

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

📜 License

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

You are free to:

✅ Use this package ✅ Study the source code ✅ Modify the package ✅ Share improvements

Any distributed modified version must also be released under the same GPL-3.0 license.

Full license:

https://www.gnu.org/licenses/gpl-3.0.html

❤️ Support

If you find this package useful:

⭐ Star the project 📢 Share it with Flutter developers 🤝 Contribute improvements

Thank you for visiting!

Built with ❤️ by Zeba Academy

Libraries

zeba_academy_selection