wilderlinks_flutter_sdk 1.0.8

Flutter SDK for the WilderLinks smart link platform - Universal Link / App Link resolution and deferred deep link matching for apps built with Flutter.

WilderLinks Flutter SDK

The Flutter SDK helps your app handle the two main WilderLinks flows:

1. A user taps a smart link and your app is already installed.
2. A user taps a smart link, installs the app, and opens it for the first time.

It also supports app-specific path prefixes when multiple apps share one branded domain.

Install

Add the package:

dependencies:
  wilderlinks_flutter_sdk: ^1.0.6

Then run:

flutter pub get

What you still need to configure natively

This SDK does not replace iOS Associated Domains or Android App Links setup.

• Register/configure app profiles: sign in at https://wilderlinks.wilderbots.com and create or select your workspace. Add each mobile app profile there before testing production links.
• Android: in the WilderLinks dashboard, add the Android package name and SHA-256 signing certificate fingerprint for your Flutter app. In Flutter, add an intent-filter with android:autoVerify="true" for your WilderLinks domain in android/app/src/main/AndroidManifest.xml.
• iOS: in the WilderLinks dashboard, add the iOS bundle ID, Apple Team ID, and App Store URL. In Xcode, enable Associated Domains and add applinks:go.wilderbots.com or your own verified WilderLinks domain.
• Custom domain: optional, but recommended for branded production links. Add it in the WilderLinks dashboard and follow the generated CNAME/TXT DNS records. After verification, use that host in domains.

Those native settings are what allow the OS to hand the link into your app.

Initialize once

import 'package:wilderlinks_flutter_sdk/wilderlinks_flutter_sdk.dart';

void main() {
  WildlinksSdk.init(const WildlinksConfig(
    baseUrl: 'https://apilink.wilderbots.com',
    domains: ['go.wilderbots.com'],
  ));
  runApp(const MyApp());
}

Listen for incoming links

class _MyAppState extends State<MyApp> {
  final _listener = WildlinksListener();

  @override
  void initState() {
    super.initState();
    _listener.stream.listen((resolved) {
      if (!resolved.matched) return;

      print('Destination: ${resolved.destinationUrl}');
      print('Open ID: ${resolved.openId}');

      final payload = resolved.deepLinkPayload;
      if (payload != null) {
        Navigator.of(context).pushNamed(
          payload['screen'] as String,
          arguments: payload,
        );
      }
    });
    _listener.start();
  }

  @override
  void dispose() {
    _listener.dispose();
    super.dispose();
  }
}

Create a short link

Use this when you only need a short URL that redirects to a long destination.

final shortUrl = await WildlinksSdk.createShortLink(
  'https://wildlinks.wilderbots.com/pricing',
);

Create a smart app link

Use this when your app should receive structured routing data.

final link = await WildlinksSdk.createDeepLink(
  defaultUrl: 'https://wildlinks.wilderbots.com/features/flutter-sdk',
  title: 'Flutter SDK',
  pathPrefix: 'x4I9',
  deepLinkPayload: {
    'screen': 'sdk',
    'sdk': 'flutter',
  },
);

print(link.shortUrl);

Match App Store attribution

If your iOS install attribution flow returns a wl_<token> value, exchange it:

final result = await WildlinksSdk.matchInstallAttributionToken(
  'https://apilink.wilderbots.com',
  'wl_<token-from-provider>',
  provider: 'app-store-campaign-token',
);

Example URLs used in docs

• API base: https://apilink.wilderbots.com
• Branded domain: https://go.wilderbots.com
• Product URL example: https://wildlinks.wilderbots.com/features/flutter-sdk
• Registration/dashboard: https://wilderlinks.wilderbots.com
• Dashboard app setup: https://wilderlinks.wilderbots.com/settings
• Custom domain setup: https://wilderlinks.wilderbots.com/domains

Support

• Website: https://wildlinks.wilderbots.com
• Dashboard: https://wilderlinks.wilderbots.com
• Contact: https://wildlinks.wilderbots.com/contact