Skip to main content

sileo_toast 0.1.2 copy "sileo_toast: ^0.1.2" to clipboard
sileo_toast: ^0.1.2 copied to clipboard

Physics-based gooey toast for Flutter, a port of Sileo. Depends on the Flutter SDK only.

sileo_toast #

pub package CI MIT license

sileo_toast demo: morphing toasts, large size with image and two buttons

Physics-based gooey toast for Flutter, a port of Sileo by Aaryan Sharma. Depends on the Flutter SDK only (widgets, physics, rendering, scheduler), so it works with material_ui, cupertino_ui or plain widgets.

Install #

flutter pub add sileo_toast

Requires Dart ^3.7.0 and Flutter >=3.29.0.

Usage #

Host the toaster above the Navigator, for example in MaterialApp.builder, and pass the app's text style:

MaterialApp(
  builder: (context, child) => SileoToaster(
    theme: SileoThemeMode.system,
    textStyle: Theme.of(context).textTheme.bodyMedium,
    child: child!,
  ),
);

// anywhere below:
Sileo.of(context).success(SileoOptions(title: 'Saved', description: const Text('Done.')));

Pass your own SileoController to show toasts without a BuildContext; the toaster then never disposes it.

API #

Sileo sileo_toast
<Toaster position offset options theme /> SileoToaster(child, controller, position, offset, options, theme, textStyle, persistWhenAccessibleNavigation, maxPause)
sileo.show / success / error / warning / info / action SileoController.show / success / error / warning / info / action(SileoOptions), each returns the id
sileo.promise(promise, { loading, success, error, action }) controller.promise(future, SileoPromiseOptions(loading, success, error, action)), returns the future
sileo.dismiss(id) / sileo.clear(position?) controller.dismiss(id) / controller.clear([position])
options title, description, type, position, duration, icon, styles, fill, roundness, autopilot, button, id SileoOptions with the same fields; description is a Widget (SileoOptions.text('...') wraps a string)
duration: null persistent: true (a duration of zero or less also means persistent)
autopilot: false | { expand, collapse } SileoAutopilot.off / SileoAutopilot(expand:, collapse:)
styles.{title, description, badge, button} SileoStyles(title, description, badgeBackground, badgeForeground, buttonForeground, buttonBackground, buttonPressedBackground)
button: { title, onClick } SileoButton(title:, onPressed:)
positions top-left ... bottom-right SileoPosition.topLeft ... bottomRight (physical, no RTL flip)
theme: light | dark | system SileoThemeMode.light / dark / system (light gives a dark toast, as in Sileo)

Same-id toasts morph into each other; distinct ids stack (top newest first, bottom newest last).

Large size #

SileoOptions(size: SileoSize.large) (or a toaster default through options) gives a full-width card capped at 520 dp: title row, description, an optional trailing thumbnail (sized and clipped to 64 dp by the package; pass a ResizeImaged widget, the package never decodes images) and up to two buttons. secondaryButton sits left of button in equal cells; long button labels wrap and grow the button. trailing is hidden from screen readers unless it is a Semantics widget (give it a label). Compact ignores trailing and secondaryButton.

Differences from Sileo #

  • Touch has no hover: tapping a toast toggles expand and pauses/resumes the timers. Mouse hover works as in Sileo.
  • persistent: true replaces duration: null.
  • The gooey shape is one analytic path (pill, body and concave fillets), not an SVG blur + threshold filter. No saveLayer.
  • Only the fallback title (the state name) is capitalized; a given title is shown as is (CSS capitalize breaks Turkish i).
  • Accessibility additions: a live-region semantics node with a dismiss action, 48 dp tap targets, no auto-dismiss under accessible navigation (persistWhenAccessibleNavigation), reduce motion jumps animations to their end, text scale up to 2.0 without clipping. At a scaled-up text size the title wraps to a second line (then ellipsizes) instead of being cut off; at the default size it stays one ellipsized line, as in Sileo.
  • Swipe up or down past 30 dp dismisses; the package has no strings of its own.

Hosting above the Navigator #

SileoToaster is a plain Stack, not an Overlay, and sits above the Navigator. There is no Material or Overlay there, so InkWell, Tooltip and other Material widgets inside a description will not work. Pass textStyle from the app theme: without it the toast uses a neutral style, and text would otherwise inherit MaterialApp's error style. Decorations are always removed.

Example #

example/ is a playground app with a control for every option: cd example && fvm flutter run. See its README.

License #

MIT. Original Sileo design and code by Aaryan Sharma; Flutter port by Mert Akif Korkmaz. See LICENSE.

7
likes
160
points
1.01k
downloads
screenshot

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Physics-based gooey toast for Flutter, a port of Sileo. Depends on the Flutter SDK only.

Repository (GitHub)
View/report issues

Topics

#toast #animation #notification #snackbar #ui

License

MIT (license)

Dependencies

flutter

More

Packages that depend on sileo_toast