Quick Setup

Get ZipQuantum working with your app in minutes.

No SDKs · App-store compliant · Privacy-first

What You’ll Need

Before you start, make sure you have:

That’s it.

Each app uses its own dedicated subdomain. Each subdomain serves its own verification file to ensure correct native resolution.

ZipQuantum generates smart links under app-specific subdomains of zq.tn. No custom domain or DNS configuration is required.

What You Don’t Need

Quick Setup Steps

ZipQuantum provides a managed subdomain under zq.tn. No domain registration or DNS configuration is required.

Step 1 — iOS Setup (Universal Links)

Enable Universal Links so iOS can open your app directly from ZipQuantum links.

In Xcode:

Result

When the app is installed, the ZipQuantum link opens your app via Universal Links.

Step 2 — Android Setup (App Links)

Enable Android App Links so Android can open your app directly from ZipQuantum links.

In your manifest:

<intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data
          android:scheme="https"
          android:host="yourapp.zq.tn" />
  </intent-filter>

Expected result

When the app is installed, ZipQuantum links open your app via Android App Links.

Step 3 — Generate Your First Link

Once your app update is live:

Expected result

Links are active immediately after creation.

Optional — iOS Context Recovery (PasteButton)

If your app needs to restore optional setup data after installation, use a user-initiated recovery step.

This is fully compliant and does not access the clipboard in the background.

SwiftUI Example

  import SwiftUI

  // This is the native component you'll embed in Flutter
  struct NativePasteButtonView: View {
      var onPaste: (String) -> Void

      var body: some View {
          // The official iOS PasteButton (No "Allow Paste" popup!)
          PasteButton(payloadType: String.self) { strings in
              if let first = strings.first {
                  onPaste(first)
              }
          }
          .buttonBorderShape(.capsule)
          .labelStyle(.iconOnly) // Optional: Makes it look like a system icon
      }
  }
  
  import 'package:flutter/material.dart';
  import 'package:flutter/services.dart';
  import 'package:flutter/foundation.dart';

  class iOSPasteButton extends StatelessWidget {
    @override
    Widget build(BuildContext context) {
      // Use UiKitView to show the native SwiftUI PasteButton
      if (defaultTargetPlatform == TargetPlatform.iOS) {
        return SizedBox(
          width: 100,
          height: 40,
          child: UiKitView(
            viewType: 'swiftui-paste-button', // Registered in iOS AppDelegate
            layoutDirection: TextDirection.ltr,
            creationParams: {},
            creationParamsCodec: const StandardMessageCodec(),
          ),
        );
      }
      return ElevatedButton(onPressed: () {}, child: Text("Paste"));
    }
  }
  

Keep the restore step optional and provide a clear skip path.

FAQ

Common Questions

Requires a single app release.
No SDKs. No runtime interception.

No. Only platform configuration.

No. ZipQuantum relies exclusively on approved Universal Links and Android App Links mechanisms.

No. ZipQuantum routes intent. It does not identify devices or track users across installs.

Next Step

Generate a test link and validate the behavior on a real device.