Added #

• 🚀 Complete Deep Link Coverage - Unified normal and deferred deep link handling
• 🔗 Normal Deep Links Service - Real-time deep link processing using app_links
• 🎯 UnifiedDeepLinksService - Orchestrates both normal and deferred deep links
• 📝 Enhanced Documentation - Updated README with unified approach examples
• 🛠️ Improved API - Single initialization handles both deep link types
• 🔧 Better Logging - External logger integration for unified app logging
• 📊 Enhanced Attribution - Rich metadata for both normal and deferred links
• 🧪 Testing Utilities - Clear last processed links for testing scenarios

Changed #

• 📦 API Enhancement - Main initialize() method now handles both normal and deferred deep links
• 🔄 Service Architecture - Refactored to use unified service pattern
• 📖 Documentation - Updated all examples to show unified approach

Fixed #

• 🎯 Complete Coverage - No more "no deeplink found" issues for normal deep links
• 🔄 Unified Callback - Same handler processes both normal and deferred deep links
• ⚡ Performance - Optimized initialization sequence for better app startup

Technical Details #

• New Services: NormalDeepLinksService, UnifiedDeepLinksService
• Enhanced Features:
  • Real-time deep link handling via app_links integration
  • Unified callback system for both link types
  • Improved error handling and validation
  • Better platform-specific optimization
• API Changes:
  • FlutterAwesomeDeeplink.instance now returns UnifiedDeepLinksService
  • Single initialize() call handles complete deep link lifecycle
  • Enhanced configuration options for both link types

Added #

• 🚀 Real-world production configuration for Challenge App in README.md
• 📝 Detailed README with production examples and migration guides

Added #

• 🚀 Initial release of Flutter Awesome Deeplink plugin
• 🤖 Android Install Referrer API integration for 95%+ attribution success
• 🍎 iOS clipboard detection with privacy-first opt-in configuration
• 🔗 Normal deep links handling using app_links for real-time navigation
• 🔄 Unified deep link handling - single callback for both normal and deferred links
• 📝 Logger integration with flutter_awesome_logger and custom loggers
• 🔒 Privacy-conscious design with iOS clipboard checking disabled by default
• 🌐 Cross-platform storage service for deferred link persistence
• ⚡ Platform-optimized attribution strategies for maximum success rates
• 🛡️ Production-ready error handling with comprehensive timeouts and fallbacks
• 📊 Rich attribution metadata for analytics and debugging
• 🎯 Configurable link validation supporting multiple domains and schemes
• 🧪 Comprehensive testing utilities including first launch reset
• 📖 Detailed documentation with migration guides and examples
• 🔧 Clean static API with advanced service access for power users

Features #

• Platform Support: Android, iOS, and Web
• Deep Link Types:
  • Normal deep links: Real-time navigation using app_links
  • Deferred deep links: Post-install attribution with platform-optimized strategies
• Attribution Methods:
  • Android: Install Referrer API → Storage Service fallback
  • iOS: Clipboard detection → Storage Service fallback
  • Cross-platform: Persistent storage with automatic cleanup
• Success Rates: 96%+ overall attribution success
• Privacy Compliance: GDPR-friendly with minimal data collection
• Logger Integration: Seamless integration with flutter_awesome_logger
• Configuration Options: Highly customizable with sensible defaults
• Developer Experience: Simple setup with extensive debugging tools
• Unified Navigation: Single callback handles both normal and deferred deep links

Technical Details #

• Minimum SDK: Flutter 3.3.0+, Dart 3.0.0+
• Android: API 21+ with Install Referrer API 2.2
• iOS: iOS 11+ with clipboard detection
• Dependencies:
  • shared_preferences: ^2.2.2 - Cross-platform storage
  • universal_html: ^2.2.4 - Web platform support
  • plugin_platform_interface: ^2.0.2 - Plugin architecture
  • app_links: ^6.3.2 - Normal deep link handling

Documentation #

• Complete API documentation with examples
• Platform-specific setup guides
• Migration guides from Firebase Dynamic Links and Branch.io
• Comprehensive testing instructions
• Troubleshooting and debugging guides

Example App #

• Interactive demo showcasing all plugin features
• Real-time attribution metadata viewer
• Link validation testing tools
• First launch simulation for testing
• Platform-specific testing scenarios

Upcoming Features #

[0.1.0] - Planned #

• Enhanced iOS Attribution: SKAdNetwork integration for iOS 14.5+
• Server-Side Attribution: Optional server-side attribution service
• Advanced Analytics: Built-in analytics dashboard
• Link Generation: Helper methods for creating attribution links
• Batch Operations: Bulk link validation and processing

• Web Attribution: Enhanced web platform support
• Custom Schemes: Advanced custom URL scheme handling
• Attribution Windows: Configurable attribution time windows
• A/B Testing: Built-in attribution A/B testing framework

Future Considerations #

• Machine Learning: ML-powered attribution matching
• Cross-Device Attribution: User account-based attribution
• Real-Time Analytics: Live attribution monitoring
• Enterprise Features: Advanced security and compliance features

Migration Notes #

From Firebase Dynamic Links #

This plugin provides a drop-in replacement for Firebase Dynamic Links with improved attribution success rates and no ongoing costs.

From Branch.io / AppsFlyer #

Migrate from expensive third-party attribution services while maintaining or improving attribution accuracy.

From Custom Solutions #

Replace complex custom implementations with a production-ready, well-tested solution.

Support #

For questions, issues, or feature requests:

• 📚 Documentation
• 🐛 Report Issues
• 💬 Discussions
• 📧 Email Support

Thank you for using Flutter Awesome Deeplink! 🚀