Generate a valid apple-app-site-association file using Apple's modern iOS 13+ Universal Links standard. Configure your App ID and map which URLs should (or shouldn't) open your native app.
apple-app-site-association (do not add a .json extension!)./.well-known/ directory.Content-Type: application/json. An AASA file is a secure JSON file hosted on your website that proves to Apple you own both the website domain and the iOS app. When a user taps a link to your website, iOS checks this file. If the link matches the routing rules in the AASA file, iOS instantly routes the user directly into your native app instead of opening Safari.
The file must be hosted at https://yourdomain.com/.well-known/apple-app-site-association. It is critical that the file does not have a .json extension. Even though the contents are formatted as JSON, the filename itself must be extensionless. Furthermore, your web server must serve the file over a secure HTTPS connection.
In iOS 13, Apple introduced the components array to replace the older paths array. By default, adding /* will open all website links in your app. If you have web-only pages (like a privacy policy, login page, or API routes), you can add a path rule (e.g., /api/*) and mark it as Excluded. iOS evaluates rules sequentially, so order matters if paths overlap.
Progressier automatically converts your web app into a robust, installable PWA with iOS Push Notifications, without writing any Service Worker code.
Generate PWA See plans