Waqas
@worqas
How does deep linking into mini apps work?
1 reply
0 recast
4 reactions
horsefacts
@horsefacts.eth
I'd start with what you want to do in your app and work from there. There are two kinds of mini app linking, one "deep," one not: 1) A "launcher" deep link that opens your mini app homeUrl. This is just as if someone clicked the icon in the app launcher. These look like: https:// warpcast[dot]com/~/frames/launch?domain=farville[dot]farm We are starting to render these as embeds in the feed so they look like other mini apps. You've probably seen them before as slim single line embeds too. These deep links are nice because if you share it outside Farcaster you get a nice embed that will take you to the App Store if Warpcast isn't installed. (Try pasting one into iMessage). But they only open your mini app homeUrl, at least for now. So if your goal is to share externally, use this. Example: https://warpcast.com/~/frames/launch?domain=farville.farm
1 reply
0 recast
6 reactions
horsefacts
@horsefacts.eth
mini app linking type 2) is a standard embed in the feed or DMs that can open any URL in your application. To do this, set the button.action.url to the page you want it to open, and serve the embed from some unique route in your app. So for example, https:// farville[dot]farm/requests/69070 opens to the "request' page for a specific user, which has the url in the JSON below. In this case the embed URL and the mini app URL it opens are the same (common pattern), but they don't have to be! You have a lot of flexibility here. So if your goal is "get someone already on Farcaster to open a page in my app," you might want to use this approach. You could send the embed in a DM or have the user share it in the feed. All depends on what you want to do. Example below. https://farville.farm/requests/69070
2 replies
0 recast
4 reactions
horsefacts
@horsefacts.eth
and actually now that I write this out, there's an option 3) too, which is linking from a notification. A mini app notification can open to any page in your mini app, but you can only send them to users who already have your app installed. If your goal is "get a user who already has my app" to open to a specific page, this is probably better than a DM in many cases. But it only applies to those who've already opened your mini app and opted in to notifications. But for event driven cases like "someone started a new game" this is a good option.
1 reply
0 recast
1 reaction
AzFlin
@azflin
We need bookmarks
1 reply
0 recast
1 reaction