Deploy

Get a stable HTTPS URL for testing your Mini App in Farcaster

To test as a Mini App, you need a live HTTPS URL.

Deploy to Vercel (recommended)

1. Install Vercel CLI

   npm install -g vercel
   

2. Deploy

   vercel
   

3. Set environment variables

   Use vercel env add or the dashboard to add:

   • NEXT_PUBLIC_CDP_CLIENT_API_KEY
   • NEXT_PUBLIC_URL (deployed app URL)
   • NEXT_PUBLIC_IMAGE_URL (optional)
   • NEXT_PUBLIC_SPLASH_IMAGE_URL (optional)
   • NEXT_PUBLIC_SPLASH_BACKGROUND_COLOR (optional)

Then verify your URL works in a browser and proceed to manifest creation.

Alternative: ngrok (for local testing)

Using ngrok

The paid plan is recommended. The free approval screen and rotating URLs can break the manifest.

1. Start your dev server:

Terminal

npm run dev

2. Create a tunnel:

Terminal

npm install -g ngrok
ngrok http 3000

3. Copy the HTTPS URL (e.g. https://your-tunnel.ngrok.io)
4. Use that URL during manifest creation

Create your manifest

Generate account association and set frame metadata