Skip to main content
With a stable URL, create and configure your manifest so users can save and discover your Mini App.

​
Generate account association via CLI

Terminal
npx create-onchain --manifest
Use your Farcaster custody wallet to sign. You can import it using your recovery phrase from Farcaster (Settings → Advanced).
After signing, the CLI updates local .env variables:
  • FARCASTER_HEADER
  • FARCASTER_PAYLOAD
  • FARCASTER_SIGNATURE
Update your deployment environment with these values.
While testing, set noindex: true in your manifest to avoid indexing.

​
Expose /.well-known/farcaster.json

In Next.js, add a route handler at app/.well-known/farcaster.json/route.ts that returns your accountAssociation and frame properties. Ensure all asset URLs are HTTPS and publicly accessible.
Open https://yourdomain.com/.well-known/farcaster.json in a browser to verify JSON output.

​
Add frame metadata for embeds

Define fc:frame metadata so your app renders a rich embed with a launch button when shared.
All image and API URLs must be publicly accessible via HTTPS.

Feature catalog: Manifest & Embeds

Implement minimal metadata and validation steps

Launch Guide — Manifest & Discovery

Why it matters and what “good” looks like