AppURL requires you to declare a custom URL scheme that your app can handle on all platforms.
A URL scheme is the part of the URL before the first colon. Some common schemes are
AppURL recommends not using schemes like
spotify. These schemes may look nice, but there's no system for avoiding naming conflicts with them.
Instead, AppURL recommends you use your website's (sub)domain as your scheme.
For example, we picked
grid6.us as the URL scheme for our Grid6 example app, because that's where its website lives.
Don't worry about putting periods in your scheme. The URL scheme explicitly allows this:
Scheme names consist of a sequence of characters beginning with a lower case letter and followed by any combination of lower case letters, digits, plus ("+"), period ("."), or hyphen ("-").
After you've picked a URL scheme, the next step is to make your apps handle URLs beginning with that scheme.
For example, our Grid6 example app handles URLs like
Read more about URL handling on your platform:
After you've programmed your apps to handle URLs, the last step is to host an
appurl.json file on your website that tells AppURL clients:
httpURLs on your website should get transformed into custom-scheme URLs that open in your apps
See the appurl.json overview.
AppURL.org maintains a list of AppURL-enabled apps. We hope to provide:
After you follow the three steps above, you can add your app.
If you need help linking to AppURL-enabled apps or AppURL-enabling your app, or just have feedback or questions, send us an email and we'll try to respond within 24 hours. Email us at firstname.lastname@example.org.