sms_composer_sheet 1.0.3
sms_composer_sheet: ^1.0.3 copied to clipboard
A Flutter plugin for native SMS composer with beautiful bottom sheet UI. Supports iOS and Android with haptic feedback and error handling.
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 - 2025-01-07 #
Added #
showWithPermission()- Recommended method with automatic Android permission handlingshowNative()- Always uses platform native SMS implementationshowCustom()- Custom UI with optional bottom sheet builder- Enhanced
show()withuseCustomBottomSheetandbottomSheetBuilderparameters
1.0.1 - 2025-11-05 #
Fixed #
- ๐ง Pub.dev compliance: Fixed package description length to meet pub.dev requirements (60-180 characters)
- ๐ง Documentation URL: Removed non-existent documentation URL until package is published
- ๐ง Code formatting: Applied
dart formatto all Dart files for consistent formatting - ๐ง Lint warnings: Addressed BuildContext async gap warnings with proper ignore comments
- ๐ง Package validation: Ensured all pub.dev validation requirements are met
Improved #
- ๐ฆ Package metadata: Added topics for better discoverability on pub.dev
- ๐ Code quality: Enhanced code formatting and documentation consistency
1.0.0 - 2025-11-05 #
Added #
- ๐ Initial release of SMS Composer Sheet plugin
- ๐ฑ Cross-platform SMS composer with unified API for iOS and Android
- ๐ iOS native implementation using
MFMessageComposeViewController - ๐ค Android in-app bottom sheet composer (when context provided)
- ๐ค Android fallback to system SMS app (when context not provided)
- โ Success notifications with automatic snackbar display
- โ Comprehensive error handling with detailed error messages
- ๐ Character counter with real-time updates and multi-SMS indicators
- ๐ณ Haptic feedback for success and error states
- ๐ Automatic permission handling with system dialog requests (Android)
- ๐ Permission status checking with detailed user guidance
- ๐ Manual permission request with user-friendly dialog prompts
- ๐ Multiple recipients support
- ๐ Pre-filled message body support
- ๐ SMS capability detection across platforms
- ๐ Long message support with automatic splitting (Android)
- ๐จ Material Design bottom sheet with iOS-like styling
- โก Loading states with progress indicators
- ๐ก๏ธ Input validation with meaningful error messages
Features #
SmsComposerSheet.show()- Display SMS composer with bottom sheet UISmsComposerSheet.showWithPermission()- Display SMS composer with automatic permission handlingSmsComposerSheet.canSendSms()- Check SMS capability on deviceSmsComposerSheet.checkPermissionStatus()- Get detailed permission status (Android)SmsComposerSheet.requestSmsPermission()- Request SMS permission with system dialog (Android)SmsComposerSheet.platformName- Get current platform nameSmsResultmodel with detailed operation feedbackSmsComposerWidget- Customizable Flutter SMS composer UI
Platform Support #
- โ iOS 12.0+ - Native MFMessageComposeViewController
- โ Android API 21+ - Custom bottom sheet + SmsManager integration
- โ Flutter 3.3.0+ - Modern Flutter SDK support
Dependencies #
flutter: ">=3.3.0"dart: ">=3.0.0"
Documentation #
- ๐ Comprehensive README with installation and usage examples
- ๐ง Developer documentation (CLAUDE.md) with architecture details
- ๐งช Example app with complete demonstration
- โ Unit tests and integration tests
- ๐ API documentation with detailed method descriptions
Semantic Versioning Guide #
This project follows Semantic Versioning:
- MAJOR version (X.0.0): Breaking changes that require code updates
- MINOR version (0.X.0): New features that are backward compatible
- PATCH version (0.0.X): Bug fixes and improvements that are backward compatible