mirror of
https://github.com/supabase/supabase.git
synced 2026-10-13 13:19:09 +03:00
8c672ab6d7
* docs: add instructions for hosting Apple App Site Association file for universal links Add documentation for Universal Links on iOS/Apple platforms, including: - Instructions for configuring Associated Domains in Xcode - Requirements for hosting the AASA file on customer infrastructure - Note that Supabase does not currently support hosting the AASA file - Example AASA file format and reference to Apple's documentation This addresses the need for customers to understand how to host the apple-app-site-association file for Universal Links, which provides a better user experience than custom URL schemes. * Apply suggestions from code review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * refactor: extract Universal Links section to partial for code reuse Extract the duplicated Universal Links section into a reusable partial following CONTRIBUTING.md guidelines. This ensures the content is maintained in a single location and automatically updates in both the Flutter iOS and Swift sections of the deep linking guide. * Prettier * Update apps/docs/content/_partials/universal_links_apple.mdx * Update apps/docs/content/_partials/universal_links_apple.mdx * Update apps/docs/content/_partials/universal_links_apple.mdx Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update apps/docs/content/_partials/universal_links_apple.mdx Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Prettier again --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
45 lines
1.6 KiB
Plaintext
45 lines
1.6 KiB
Plaintext
### Universal links
|
|
|
|
For a better user experience, you can use **Universal Links** instead of custom URL schemes. Universal Links allow your app to open directly from web links without showing a browser redirect prompt.
|
|
|
|
To enable Universal Links, you need to:
|
|
|
|
1. **Configure Associated Domains** in your Xcode project:
|
|
|
|
- Add your domain to the Associated Domains capability
|
|
- Format: `applinks:yourdomain.com`
|
|
|
|
2. **Host the Apple App Site Association (AASA) file** on your own infrastructure:
|
|
- The file must be accessible at `https://yourdomain.com/.well-known/apple-app-site-association` or `https://yourdomain.com/apple-app-site-association`
|
|
- The file must be served with `Content-Type: application/json` (or `text/json`)
|
|
- The file must be accessible over HTTPS without redirects
|
|
- The file should not have a file extension
|
|
|
|
<Admonition type="caution">
|
|
|
|
Supabase does not currently support hosting the AASA file. You must host this file on your own
|
|
infrastructure following [Apple's best
|
|
practices](https://developer.apple.com/documentation/xcode/supporting-associated-domains).
|
|
|
|
</Admonition>
|
|
|
|
The AASA file format should look like this:
|
|
|
|
```json
|
|
{
|
|
"applinks": {
|
|
"apps": [],
|
|
"details": [
|
|
{
|
|
"appID": "TEAM_ID.BUNDLE_ID",
|
|
"paths": ["*"]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
Replace `TEAM_ID` with your Apple Developer Team ID and `BUNDLE_ID` with your app's bundle identifier.
|
|
|
|
For detailed setup instructions, see [Apple's documentation on supporting associated domains](https://developer.apple.com/documentation/xcode/supporting-associated-domains).
|