🗑️ Deprecated #

• TButton: Moved to tappable_elements package as TeButton
  • Use package:tappable_elements for button components
  • Will be removed in version 1.0.0
• TCheckbox: Moved to tappable_elements package as TeCheckbox
  • Use package:tappable_elements for checkbox components
  • Will be removed in version 1.0.0
• TSwitch: Moved to tappable_elements package as TeSwitch
  • Use package:tappable_elements for switch components
  • Will be removed in version 1.0.0

📦 Package Restructuring #

• Core widgets remain: Tappable and TappableContainer are still part of this package
• UI elements extracted: Button, Checkbox, and Switch widgets moved to dedicated tappable_elements package
• Better separation: Core touch/tap functionality separated from UI components

📝 Migration Guide #

// Before (tappable 0.0.1)
import 'package:tappable/tappable.dart';

TButton(onPressed: () {}, child: Text('Click me'))

// After (tappable 0.2.0)
import 'package:tappable/tappable.dart';  // For Tappable and TappableContainer
import 'package:tappable_elements/tappable_elements.dart';  // For UI elements

TeButton(onPressed: () {}, child: Text('Click me'))

🎯 Rationale #

• Improves package modularity and maintainability
• Allows independent versioning of UI components
• Reduces dependencies for apps only needing core tap functionality
• Prepares for future expansion of UI element library

Added #

• Initial release of the tappable package
• Tappable widget with Material Design ink effects
  • Support for custom splash and highlight colors
  • Configurable border radius for ink effects
  • Optional padding and fill parent functionality
  • Support for custom splash factories
• TappableContainer widget combining Tappable with Container
  • Automatic border radius extraction from BoxDecoration
  • Full Container parameter support
  • Seamless integration of tap effects with container styling
• TCheckbox widget with customizable appearance
  • Stack-based architecture with background and thumb layers
  • Builder pattern support via buildBackground and buildThumb
  • Configurable size and border radius
  • Default Material Design-like styling
• TSwitch widget with smooth animations
  • Animated thumb position and background color
  • Customizable via builder pattern
  • Configurable animation duration
  • Default toggle switch appearance with shadow effects
• TButton widget for highly customizable buttons
  • Built on TappableContainer foundation
  • Support for disabled states with custom styling
  • Configurable disabled opacity
  • Full Container and Tappable parameter exposure
• Tree-shakable exports for optimal bundle size
  • Main export file for all widgets
  • Individual widget exports in widgets/ directory
• Comprehensive documentation in CLAUDE.md
  • Complete API reference for all widgets
  • Multiple examples from basic to advanced
  • Design philosophy and best practices
  • Advanced usage patterns
• MIT License
• README with package overview

Architecture Decisions #

• Chose Stack-based approach for checkbox and switch to maximize customization
• Separated tappable logic from container logic for better composition
• Used builder pattern for custom rendering to provide maximum flexibility
• Implemented tree-shakable exports to support minimal bundle sizes

[Unreleased] #

Planned #

• Haptic feedback support
• Accessibility improvements (focus, keyboard navigation, semantic labels)
• Additional widgets (TRadio, TSlider, TSegmentedControl)
• Theme support with InheritedWidget
• Example application
• Comprehensive test coverage