# Apple App Site Association (AASA) File Generator

> Generate a valid apple-app-site-association file for iOS Universal Links from your Team ID, bundle ID, and paths. Copy-paste ready — free, no signup.

- Canonical: https://redirectly.app/tools/aasa-generator
- Site: [Redirectly](https://redirectly.app) — deferred deep linking for Flutter & React Native

Build a correct apple-app-site-association file from your Team ID, bundle ID, and paths. Copy it, host it at `/.well-known/`, and validate it — all free, no signup.

## Generate Your AASA File

This is an interactive tool: enter your Team ID, bundle ID, and path patterns at [https://redirectly.app/tools/aasa-generator](https://redirectly.app/tools/aasa-generator) and copy the generated JSON. Optional toggles add `webcredentials` (password autofill) and `appclips` sections.

The generated file looks like this:

```json
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "ABCD123456.com.example.myapp",
        "paths": ["/*"]
      }
    ]
  }
}
```

- **appID** — your 10-character Team ID (Apple Developer portal → Membership) + bundle ID.
- **paths** — patterns your app handles: `/*` for everything, `/product/*` to narrow, `NOT /admin/*` to exclude. First match wins.

## Hosting Checklist

1. **Name it exactly right** — the file is `apple-app-site-association`, no .json extension.
2. **Place it at the well-known path** — `https://yourdomain.com/.well-known/apple-app-site-association`, reachable without redirects.
3. **Serve the right header** — `Content-Type: application/json` over valid HTTPS.
4. **Add Associated Domains in Xcode** — Signing & Capabilities → + Capability → Associated Domains → `applinks:yourdomain.com`.
5. **Validate it** — run the [AASA Validator](https://redirectly.app/aasa-validator.md) against your domain; it checks DNS, HTTPS, headers, JSON, and your app ID.

## Frequently Asked Questions

### Does the apple-app-site-association file need a .json extension?

No. The file must be named exactly apple-app-site-association with no extension, placed at /.well-known/apple-app-site-association, and served with Content-Type: application/json.

### Where do I find my Team ID and bundle ID?

Your Team ID is the 10-character identifier under Membership in the Apple Developer portal. Your bundle ID is set in Xcode under your app target (e.g. com.example.myapp). Together they form the appID: TEAMID.bundleid.

### What paths should I include?

Start with `/*` to route every link on the domain to your app, then narrow with patterns like `/product/*` or exclusions like `NOT /admin/*`. Paths are matched in order — the first match wins.

## Related Tools

- [AASA Validator](https://redirectly.app/aasa-validator.md) — Check your live apple-app-site-association file with the same checks Apple runs, plus fixes.
- [assetlinks.json Generator](https://redirectly.app/tools/assetlinks-generator.md) — The Android counterpart for Digital Asset Links files.

---

Full site index for AI agents: https://redirectly.app/llms.txt