theme_debug_overlay 1.0.3 copy "theme_debug_overlay: ^1.0.3" to clipboard
theme_debug_overlay: ^1.0.3 copied to clipboard

A draggable, animated Flutter debug overlay for toggling ThemeMode at runtime. Renders only in debug builds — zero overhead in release.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.3 - 2026-04-04 #

Fixed #

  • Added missing changelog entries so CHANGELOG.md references the current published version (pub.dev analysis requirement).

1.0.2 - 2026-04-04 #

Changed #

  • Bumped package version after dependency and local tooling updates.

1.0.1 - 2026-04-04 #

Fixed #

  • Corrected homepage, repository, and issue_tracker URLs in pubspec.yaml to point to the correct GitHub repository (knatnaela/theme_debug_overlay).

1.0.0 - 2026-04-04 #

Added #

  • Initial release.
  • ThemeDebugOverlay — draggable, animated floating widget for toggling ThemeMode at runtime.
  • ThemeDebugOverlayScaffold — convenience wrapper that places the overlay inside a Stack automatically.
  • Position persistence via SharedPreferences with debounced writes.
  • AnimatedSize for smooth expand/collapse of the options panel.
  • AnimatedContainer for smooth selected-state transitions on buttons.
  • AnimatedRotation on the main button icon when the panel is open.
  • Tooltip on every button for screen-reader and hover support.
  • persistPosition flag to opt out of position persistence.
  • initialPosition and storageKey parameters for full customisation.
  • Zero-cost guard: returns SizedBox.shrink() outside kDebugMode.
  • Full test suite covering render, interaction, theme selection, and position-persistence paths.
  • Example app demonstrating integration with MaterialApp.
1
likes
160
points
98
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

A draggable, animated Flutter debug overlay for toggling ThemeMode at runtime. Renders only in debug builds — zero overhead in release.

Repository (GitHub)
View/report issues

License

MIT (license)

Dependencies

flutter, shared_preferences

More

Packages that depend on theme_debug_overlay