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:
- A mobile app (iOS, Android, or both)
- Control over your app’s domain configuration
- Access to your app’s source code (minimal changes required)
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
- No SDK integration
- No attribution libraries
- No fingerprinting
- No device identification
- No background services
- No tracking logic
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:
- Enable Associated Domains
-
Add :
applinks:*.zq.tn - Build and publish an app update (required by Apple)
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:
-
Add an intent filter for the
yourapp.zq.tndomain and enable App Links verification. Replaceyourappwith the subdomain used in your ZipQuantum links.
<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>
- Build and publish an app update
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:
- Paste your destination URL
- Generate your ZipQuantum link
- Copy the link
- Test it on a device
Expected result
- Installed → app opens
- Not installed → store → app opens
- No app → fallback web destination
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.