Deeplinks, or custom app protocols, offer a streamlined way to interact with the Supernotes application, whether on mobile or desktop platforms. These protocols allow direct access to views (and some functions) within the app via specific URLs.
In general, you should be able to link to a location within a Supernotes application by replacing the https://my.supernotes.app/ at the beginning of a web app URL with the supernotes:/ scheme instead.
For example, if you'd like to open a card in preview, you can take the web URL:
https://my.supernotes.app/?preview=ab2fadfc-bdb4-448f-a548-734220add4e1
And turn it into a deeplink like so:
supernotes:/?preview=ab2fadfc-bdb4-448f-a548-734220add4e1
This should open the desktop apps on macOS, Linux, or Windows, and the mobile apps on iOS or Android.
Here are some other examples of deeplinks you might want to use in your own workflows:
supernotes:/– just open the Supernotes app without changing the viewsupernotes:/new– open Supernotes with a new card ready and waitingsupernotes:/?preview=CARD_ID_HERE– open a card in Previewsupernotes:/v/collection/thoughts– open the Thoughts collectionsupernotes:/v/card/CARD_ID_HERE– open a card in the Noteboardsupernotes:/v/daily/2024-06-29– view cards from a certain day
Deeplinks offer a great way to open certain Supernotes views or help you perform very simple actions like creating new cards. If you need to perform more complex tasks such as card creation or modification, we encourage the use of our API, which provides comprehensive methods that allow for full automation of Supernotes workflows. To learn more about the Supernotes' API, you can visit the Supernotes Developer Portal.