Sharing Your Mini App

​

What you’ll learn

• Add share entry points in your Base Mini App and from the Base app directory
• Understand how embeds are generated when your app is shared
• Create both static and dynamic embeds that drive engagement
• Implement determined and truly dynamic metadata for personalised sharing
• Debug and test your embeds before launch
• Use MiniKit’s built-in metadata generation to save development time

​

How users share your mini app

​

From inside your mini app

​

From the Base app directory

​

How embeds work

<meta name="fc:frame" content='{
  "version":"next",
  "imageUrl":"https://your-app.com/embed-image",
  "button":{
    "title":"Play Now",
    "action":{
      "type":"launch_frame",
      "name":"Your App",
      "url":"https://your-app.com"
    }
  }
}' />

• Image – Main visual hook (3:2 aspect ratio recommended)
• Title + description – The quick pitch for your app
• CTA button – The direct action users can take

​

Static vs. dynamic embeds

​

Static embeds

​

Dynamic embeds

​

Types of dynamic metadata

​

Determined dynamic metadata

/generate/blossom
/generate/bubbles
/generate/buttercup

​

On-demand generated metadata

/generate/user/123

​

How dynamic metadata works

​

The flow

1. User shares link – e.g. https://my-mini-app.com/generate/blossom
2. Parent app fetches metadata – Sends request to your server
3. Your route processes params – /generate/:character detects “blossom”
4. Server generates OG data – Creates and returns SVG or image
5. Embed appears in feed – User sees personalised preview

​

Implementation tips

​

Using MiniKit for embeds

export async function generateMetadata(): Promise<Metadata> {
  const URL = process.env.NEXT_PUBLIC_URL;
  return {
    title: process.env.NEXT_PUBLIC_ONCHAINKIT_PROJECT_NAME,
    description: "Generated by `create-onchain --mini`, a Next.js template for MiniKit",
    other: {
      "fc:frame": JSON.stringify({
        version: "next",
        imageUrl: process.env.NEXT_PUBLIC_APP_HERO_IMAGE,
        button: {
          title: `Launch ${process.env.NEXT_PUBLIC_ONCHAINKIT_PROJECT_NAME}`,
          action: {
            type: "launch_frame",
            name: process.env.NEXT_PUBLIC_ONCHAINKIT_PROJECT_NAME,
            url: URL,
            splashImageUrl: process.env.NEXT_PUBLIC_SPLASH_IMAGE,
            splashBackgroundColor: process.env.NEXT_PUBLIC_SPLASH_BACKGROUND_COLOR,
          },
        },
      }),
    },
  };
}

​

Debugging embeds

​

Debug tools

• Use the Farcaster Frame Debugger
• Check OG tags with Meta Tags Inspector

​

Common issues

• Ensure server returns correct metadata for both static and dynamic routes
• Review caching headers — too aggressive can delay updates

​

Next steps

• Add fc:frame metadata to your shareable pages
• Decide between static, determined dynamic, or On-demand generated metadata dynamic embeds
• Test across platforms before launch
• Integrate sharing prompts into onboarding and achievement flows