ZipQuantum Support

ZipQuantum serves an Apple App Site Association response on an accepted redirect host when at least one full Apple application identifier is configured on the production server.

The supported URL is /.well-known/apple-app-site-association. ZipQuantum also accepts the root compatibility path /apple-app-site-association.

Required Values

• The exact production Smart Link host.
• The Apple Team ID.
• The application bundle identifier.
• The combined application identifier in the form TEAMID.bundle.identifier.
• The App Store URL used as the per-link iOS fallback.

Server Configuration

The ZipQuantum hosting administrator configures one or more full application identifiers in the production mobile-link settings. If no identifier is configured, the association endpoint intentionally returns 404.

The generated response authorizes the configured application identifiers for /* and the legacy /r/* route.

Xcode Configuration

1. Open the application target in Xcode.
2. Add the Associated Domains capability.
3. Add applinks:your-production-host using only the fully qualified host. Do not add a path, query string, scheme, or trailing slash.
4. Repeat the entitlement entry for every distinct production subdomain the app must handle.
5. Handle the incoming universal-link URL and map its path and approved query parameters to an in-app route.
6. Build and sign the app with the identity that matches the configured application identifier.

Configure the Smart Link

1. Open the link in Links.
2. Set iOS Store URL to the production App Store listing.
3. Set Fallback URL when a web fallback is required.
4. Save the link and copy its production URL.

Verification

1. Open the well-known association URL and confirm that it returns JSON for the expected application identifier.
2. Install a production-like build after the association file is available.
3. Tap the Smart Link from a message, email, or another domain.
4. Confirm that the installed app opens the intended route.
5. Remove the app and confirm that the configured App Store or web fallback opens.

Current Product Boundary

ZipQuantum does not ship an iOS SDK. The app uses Apple Universal Links and its own route handling. Consent-free fingerprint recovery is not a supported iOS path.

Troubleshooting

• The association URL returns 404: the Apple application identifiers are not configured on the server for this deployment.
• Safari opens instead of the app: verify the exact host, entitlement, Team ID, bundle identifier, signing identity, and AASA JSON.
• A subdomain fails: each distinct subdomain requires a matching entitlement entry and association response.
• A same-domain Safari link stays in Safari: test from a message or a different domain because iOS may preserve the user’s browser intent.