reusable_bottom_sheet 0.0.4

A reusable Flutter package to easily create customizable bottom sheets with options to display a title, subtitle, child widgets, and a drag handle. It supports features like custom height, background [...]

reusable_bottom_sheet

A Flutter package to create highly customizable, reusable bottom sheets with features like titles, subtitles, drag gestures (pill indicator), and option lists. Designed to help you create elegant and flexible modal bottom sheets faster.

---

Features

• Adaptive & customizable bottom sheets
• Title and subtitle support
• Optional pill gesture at the top
• Scrollable content support
• Flexible height control
• Built-in option list bottom sheet
• Reusable components: OptionEntity, OptionItem, OptionList, PillGesture

---

Getting Started

Add this to your pubspec.yaml:

reusable_bottom_sheet: <latest_version>

Import the package:

import 'package:reusable_bottom_sheet/reusable_bottom_sheet.dart';

---

Usage

Adaptive Bottom Sheet (Custom Content)

AdaptiveBottomSheet(
  context: context,
  title: 'Custom Sheet',
  supTitle: 'This is a subtitle',
  child: const Text('Your content here'),
).show();

Option List Bottom Sheet

final selected = await showOptionBottomSheet<OptionEntity>(
  context: context,
  title: 'Options',
  supTitle: 'Choose one',
  options: [
    const OptionEntity(title: 'Camera', icon: Icons.camera_alt),
    const OptionEntity(title: 'Gallery', icon: Icons.photo),
    const OptionEntity(title: 'Share', icon: Icons.share),
  ],
  onTap: (option) => Navigator.pop(context, option),
);

if (selected != null) {
  print("User picked: ${selected.title}");
}

---

Components

OptionEntity

Represents an option with an icon, title, and tap handler.

OptionItem

Widget for a single option item.

OptionList

Widget to display a list of OptionItems.

PillGesture

A draggable indicator usually shown at the top of the sheet.

---

Customization Options

• title, supTitle, and their text styles
• Background color (bgColor)
• Border radius (borderRadius)
• Custom child widget
• Optional pill gesture (hasPillGesture)
• Control the height with sheetHeightFraction

---

Example

---

License

This project is licensed under the MIT License.

---

Contributions

Contributions, issues, and feature requests are welcome! Feel free to submit a pull request or open an issue.

---

Maintainer

Made with ❤️ by Shohidul Islam