voo_adaptive_overlay 0.1.0

Adaptive overlay system for Flutter that automatically shows modals, bottom sheets, or side sheets based on screen size. Supports Material, Cupertino, Glass, and custom styles.

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.

0.1.0 - 2026-05-17

Added

• VooOverlayTile — a list tile that opens an adaptive overlay on tap. Accepts either an overlayBuilder for custom content or overlayActions for a tappable action list. Replaces ad-hoc ListTile + showModalBottomSheet pairs across app code.
• VooAdaptiveOverlay.showAdaptiveActions — adaptive list-of-actions overlay that picks the right surface for the screen size (bottom sheet on mobile, modal on tablet, side sheet on desktop) and pops with the selected key.
• VooListAction entity for action-list rows (label, subtitle, icon, destructive/primary/disabled, autoPop).
• Header support for subtitle, leadingIcon (rendered inside an accent tile), accentColor, and badge on show/showBottomSheet/showModal/ showSideSheet/showFullscreen (and the matching context extensions).
• VooBottomSheet now supports draggable mode that uses DraggableScrollableSheet with the configured snap points, and accepts explicit snapSizes.
• contentPadding override on all overlay surfaces.

Changed

• VooBottomSheet now actually applies VooOverlayConstraints.maxHeight to the sheet, and animates padding for the on-screen keyboard.
• Modal/side sheet content padding tightened (20 → 16/20) for a more compact Material 3 look.

0.0.2 - 2025-11-27

Changed

• Updated package metadata for pub.dev publishing

0.0.1 - 2025-11-27

Added

• Initial release of voo_adaptive_overlay
• Adaptive overlay system that automatically selects the appropriate overlay type based on screen size:
  • Mobile (<600px): Bottom sheet
  • Tablet (600-1024px): Modal dialog
  • Desktop (>1024px): Side sheet or modal (configurable)
• Overlay types:
  • VooBottomSheet - Slides up from the bottom
  • VooModalDialog - Centered dialog
  • VooSideSheet - Slides in from the side
  • VooFullscreenOverlay - Covers the entire screen
  • VooDrawer - Slides in from left/right
  • VooActionSheet - iOS-style action list
  • VooSnackbar - Bottom notification with action
  • VooBanner - Top/bottom notification banner
  • VooPopup - Contextual popup menu
  • VooTooltip - Informational tooltip
  • VooAlert - Critical alert dialog
• Style presets:
  • material - Standard Material Design 3
  • cupertino - iOS-style with blur and rounded corners
  • glass - Glassmorphism with frosted glass effect
  • minimal - Clean, borderless design
  • outlined - Modern outlined style
  • elevated - Strong shadow elevation
  • soft - Soft pastel colors
  • dark - Dark mode optimized
  • gradient - Gradient background
  • neumorphic - Soft 3D shadows
  • custom - Full customization
• Configuration options:
  • VooOverlayConfig for customizing behavior and appearance
  • VooOverlayBreakpoints for customizing responsive breakpoints
  • VooOverlayBehavior for animation and interaction settings
  • VooOverlayConstraints for size constraints
  • VooOverlayStyleData for custom styling
• Extension methods for convenient overlay showing via context.showAdaptiveOverlay()
• Pre-built action buttons with VooOverlayAction factory methods
• Comprehensive example app demonstrating all features