Add required variables to your local and deployment environments.
These variables are essential for your MiniKit app to function:
​
NEXT_PUBLIC_ONCHAINKIT_PROJECT_NAME
string
required
The name of your Mini App as it appears to users
​
NEXT_PUBLIC_URL
string
required
The deployed URL of your application (must be HTTPS)
​
NEXT_PUBLIC_ONCHAINKIT_API_KEY
string
required
Your Coinbase Developer Platform API key
​
FARCASTER_HEADER
string
required
Generated during manifest creation for account association
​
FARCASTER_PAYLOAD
string
required
Generated during manifest creation for account association
​
FARCASTER_SIGNATURE
string
required
Generated during manifest creation for account association

​
Copy-paste .env example

Terminal
# Required
NEXT_PUBLIC_ONCHAINKIT_PROJECT_NAME=YourAppName
NEXT_PUBLIC_URL=https://your-app.vercel.app
NEXT_PUBLIC_ONCHAINKIT_API_KEY=your_cdp_client_api_key

# Generated by `npx create-onchain --manifest`
FARCASTER_HEADER=base64_header
FARCASTER_PAYLOAD=base64_payload
FARCASTER_SIGNATURE=hex_signature

# Optional (appearance and metadata)
NEXT_PUBLIC_APP_ICON=https://your-app.vercel.app/icon.png
NEXT_PUBLIC_APP_SUBTITLE=Short subtitle
NEXT_PUBLIC_APP_DESCRIPTION=Describe what your app does
NEXT_PUBLIC_APP_SPLASH_IMAGE=https://your-app.vercel.app/splash.png
NEXT_PUBLIC_SPLASH_BACKGROUND_COLOR=#000000
NEXT_PUBLIC_APP_PRIMARY_CATEGORY=social
NEXT_PUBLIC_APP_HERO_IMAGE=https://your-app.vercel.app/og.png
NEXT_PUBLIC_APP_TAGLINE=Play instantly
NEXT_PUBLIC_APP_OG_TITLE=Your App
NEXT_PUBLIC_APP_OG_DESCRIPTION=Fast, fun, social
NEXT_PUBLIC_APP_OG_IMAGE=https://your-app.vercel.app/og.png
Ensure all referenced assets are publicly accessible via HTTPS.