deeplink_x 0.1.3

Lightweight Flutter plugin for type-safe external deeplink launching with built-in smart fallback feature.

DeeplinkX

A lightweight Flutter plugin for type-safe handling of external deeplinks with built-in support for popular apps. Features smart fallback to app stores and web URLs across all major platforms.

Naming Note: 'X' in DeeplinkX stands for external.

Features

• Type-safe API for external deeplinks
• Multi-platform support
• Smart fallback system
• No native platform code, everything is handled by url_launcher package.

Usage

import 'package:deeplink_x/deeplink_x.dart';

void main() {
  final deeplinkX = DeeplinkX();

  // Open Instagram app with store fallback
  deeplinkX.launchAction(Instagram.open(fallBackToStore: true));

  // Open Telegram profile
  deeplinkX.launchAction(Telegram.openProfile('username'));

  // Open iOS App Store app
  deeplinkX.launchAction(IOSAppStore.open());
  
  // Check if Instagram app can be opened
  final canOpenInstagram = await deeplinkX.canLaunch(Instagram.open());
  
  // Check if native Instagram URI can be launched and app is installed
  final canLaunchNative = await deeplinkX.canLaunchNativeDeeplink(
    Instagram.openProfile('username')
  );
}

Supported Apps And Actions

Category	App	Supported Actions
Stores	iOS App Store	• Open app • Open app page • Open review page • Open iMessage extension
Stores	Mac App Store	• Open app • Open app page • Open review page
Stores	Microsoft Store	• Open app • Open app page • Open review page
Stores	Google Play Store	• Open app • Open app page • Open review page
Stores	Huawei AppGallery Store	• Open app page
Stores	Cafe Bazaar Store	• Open app • Open app page
Stores	Myket Store	• Open app • Open app page • Rate app
Social Apps	Telegram	• Open app • Open profile by username/phone • Send message
Social Apps	Instagram	• Open app • Open profile by username
Social Apps	WhatsApp	• Open app • Chat with phone number • Share text content
Business	LinkedIn	• Open profile • Open company page

Documentation

Detailed documentation available in doc/apps:

• iOS App Store
• Mac App Store
• Microsoft Store
• Play Store
• Huawei AppGalley Store
• Cafe Bazaar Store
• Myket Store
• Instagram
• Telegram
• WhatsApp
• LinkedIn

URL Scheme Handling

DeeplinkX uses a three-tier approach for maximum compatibility:

1. Native App Deep Links: Direct app launch when installed
2. Store Fallback: Redirects to app stores when apps aren't installed (with fallBackToStore: true)
3. Web Fallback: Redirects to web URLs when neither app nor store is available

Example:

// Enable store fallback
await deeplinkX.launchAction(Instagram.open(fallBackToStore: true));

For URL schemes and web fallbacks, see each app's documentation.

Platform-Specific Configuration

See respective app documentation for platform-specific configuration.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Issues and Feature Requests

Have a bug or feature request? Please open a new issue after checking existing ones.