wilderlinks_flutter_sdk 1.0.9

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.9

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.space 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:your-workspace.wilderlinks.space 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. The custom domain CNAME target is go.wilderlinks.space. After verification, use that custom 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() {
  WilderlinksSdk.init(const WilderlinksConfig(
    baseUrl: 'https://api.wilderlinks.space',
    domains: ['your-workspace.wilderlinks.space'],
  ));
  runApp(const MyApp());
}

Listen for incoming links

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

  @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 WilderlinksSdk.createShortLink(
  'https://wilderlinks.space/pricing',
);

Create a smart app link

Use this when your app should receive structured routing data.

final link = await WilderlinksSdk.createDeepLink(
  defaultUrl: 'https://wilderlinks.space/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 WilderlinksSdk.matchInstallAttributionToken(
  'https://api.wilderlinks.space',
  'wl_<token-from-provider>',
  provider: 'app-store-campaign-token',
);

Example URLs used in docs

• API base: https://api.wilderlinks.space
• Workspace default domain: https://your-workspace.wilderlinks.space
• Custom domain CNAME target: go.wilderlinks.space
• Product URL example: https://wilderlinks.space/features/flutter-sdk
• Registration/dashboard: https://wilderlinks.space
• Dashboard app setup: https://wilderlinks.space/settings
• Custom domain setup: https://wilderlinks.space/domains

Support

• Website: https://wilderlinks.space
• Dashboard: https://wilderlinks.space
• Contact: https://wilderlinks.space/contact