How to deep link directly into a Mini App | dTech Skip to content
dTech

How to deep link directly into a Mini App

This guide assumes you know what Farcaster Mini Apps are and have already built one. If you haven’t built a Mini App yet, check out our Quickstart Guide. Or you can use an existing Mini App url.

Deep linking to Farcaster Mini Apps

You can create links that open your Mini App directly in Farcaster clients like Warpcast. This is useful for:

  • Sharing your Mini App via regular links
  • Creating marketing campaigns that link directly to your Mini App
  • Building viral loops where users can easily share your Mini App

The deep link URL structure follows this format:

https://warpcast.com/~/mini-apps/launch?domain=dtech.vision

Where dtech.vision is the domain hosting your Mini App.

IMPORTANT: Do not include https:// in the domain parameter. For example, https://dtech.vision should be entered as dtech.vision

The Mini APp will be launched using the information in your Mini App manifest, specifically using the homeUrl defined in your .well-known/farcaster.json file. If you don’t know what that is read all about Farcaster Mini App Manifests here.

Deep links provide a way to directly launch your Mini App experience from anywhere - whether that’s a website, social media post, or another Mini App. Just remember to:

  1. Use the correct URL structure
  2. Omit https:// from the domain parameter
  3. Ensure your Mini App manifest is properly configured at .well-known/farcaster.json