reusable_editor

A flexible and modular file management and form handling package for Flutter, supporting both Firestore and REST API-based storage systems along with comprehensive form field management. This package includes file operations, form state management using Cubits, and a collection of reusable form field widgets.

Features

• Abstract interfaces for clean architecture
• Cubits for managing form states (e.g., image, switch, dropdown, text field, multi-select)
• Complete set of reusable form field widgets
• Extensions for asset loading as File and Uint8List
• Enum-based dropdown and multi-select checkbox groups with icon and label support

Getting Started

Installation

Add the following to your pubspec.yaml:

dependencies:
  reusable_editor: <latest_version>

Import

import 'package:reusable_editor/reusable_editor.dart';

📘 Documentation

Full usage guides available at: 👉 https://geniecodersrc.github.io/reusable_editor/

Available Form Widgets

• AppCheckbox - Checkbox with label and validation
• AppDatePicker - Date selection field
• AppDropdown - Custom dropdown field
• AppFilePicker - File selection widget
• AppRadioGroup - Radio button group
• AppRangeSlider - Range slider input
• AppSlider - Slider input
• AppSwitch - Toggle switch
• AppTimePicker - Time selection field
• AppTextField - Text input field
• EnumOptionDropDownMenuFormField - Dropdown for Enum values
• EnumMultiOptionCheckboxGroup - Multi-select checkbox group for Enums

State Management Cubits

• FieldCubit<T> - Generic form field management with validation
• ToggleCubit - Specialized cubit for boolean toggle fields
• DateTimeCubit - Manages date selection
• ImageFieldCubit - Handles image pick logic and validation
• EnumOptionCubit<T> - Dropdown selection with generic enum
• MultiEnumOptionCubit<T> - Multi-select enum field management
• SwitchCubit - Toggle logic
• TextFieldCubit - Text field validation

Usage

Form Field Management

// Text field
final textFieldCubit = TextFieldCubit(
  initialValue: 'Default',
  validator: RequiredValidator(),
);
AppTextField(cubit: textFieldCubit, label: 'Name');

// Toggle switch
final toggleCubit = ToggleCubit(initialValue: false);
AppSwitch(cubit: toggleCubit);

// Date picker
final dateCubit = FieldCubit<DateTime>(
  validator: RequiredFieldValidator().call,
);
AppDatePicker(cubit: dateCubit, labelText: 'Select Date', formatter: DateFormat('yyyy-MM-dd'));

// Time picker
final timeCubit = FieldCubit<TimeOfDay>(
  validator: RequiredFieldValidator().call,
);
AppTimePicker(cubit: timeCubit, labelText: 'Select Time');

// Slider
final sliderCubit = FieldCubit<double>(initialValue: 0.5);
AppSlider(cubit: sliderCubit, min: 0, max: 1, divisions: 10, labelText: 'Select Value', displayValue: (val) => val.toStringAsFixed(2));

// Range slider
final rangeSliderCubit = FieldCubit<RangeValues>(
  initialValue: const RangeValues(0, 50),
);
AppRangeSlider(cubit: rangeSliderCubit, min: 0, max: 100, divisions: 20, labelText: 'Range');

// Checkbox
final checkboxCubit = ToggleCubit(initialValue: false);
AppCheckbox(cubit: checkboxCubit, label: 'Accept Terms');

// Radio Group
final radioCubit = FieldCubit<String>(initialValue: 'Male');
AppRadioGroup<String>(
  cubit: radioCubit,
  label: 'Gender',
  values: const ['Male', 'Female', 'Other'],
  labels: const ['Male', 'Female', 'Other'],
);

// File picker
final imageCubit = ImageFieldCubit();
AppFilePicker(cubit: imageCubit, labelText: 'Pick Image');

Dropdown with Enum

enum FileSourceType { firebase, server }

final dropdownCubit = EnumOptionCubit<FileSourceType>();

final dropdown = EnumOptionDropDownMenuFormField<FileSourceType>(
  selectedValue: dropdownCubit.state.selectedOption,
  onChanged: dropdownCubit.selectOption,
  hint: 'Select file source',
  dropdownItems: [
    EnumOptionEntity(type: FileSourceType.firebase, icon: Icons.cloud, label: 'Firebase'),
    EnumOptionEntity(type: FileSourceType.server, icon: Icons.storage, label: 'Server'),
  ],
);

Multi Select Enum (MultiEnumOptionCubit)

enum ReactionType { like, love, laugh, wow, sad, angry }

final reactionsCubit = MultiEnumOptionCubit<ReactionType>();

// Use the widget
EnumMultiOptionCheckboxGroup<ReactionType>(
  cubit: reactionsCubit,
  options: [
    EnumOptionEntity(type: ReactionType.like, label: 'Like', icon: Icons.thumb_up),
    EnumOptionEntity(type: ReactionType.love, label: 'Love', icon: Icons.favorite),
    EnumOptionEntity(type: ReactionType.laugh, label: 'Laugh', icon: Icons.emoji_emotions),
    EnumOptionEntity(type: ReactionType.wow, label: 'Wow', icon: Icons.sentiment_very_satisfied),
    EnumOptionEntity(type: ReactionType.sad, label: 'Sad', icon: Icons.sentiment_dissatisfied),
    EnumOptionEntity(type: ReactionType.angry, label: 'Angry', icon: Icons.sentiment_very_dissatisfied),
  ],
);

// Toggle selection
reactionsCubit.toggleOption(ReactionType.like);

// Replace all selections
reactionsCubit.setSelected([ReactionType.love, ReactionType.wow]);

// Read selected values
final selectedReactions = reactionsCubit.selectedTypes;

Load Asset as File

final file = await 'assets/image.png'.loadAsFile();

Load Asset as Bytes

final bytes = await 'assets/image.png'.loadAssetImage();

Contributions

Feel free to open issues or pull requests.

License

© MIT License. Developed with ❤️ by Shohidul Islam