Farcaster Mini Apps (formerly Frames v2) Quickstart by Neynar 🪐

A Farcaster Mini Apps quickstart npx script.

This is a NextJS + TypeScript + React app.

Guide

Check out this Neynar docs page for a simple guide on how to create a Farcaster Mini App in less than 60 seconds!

Getting Started

To create a new mini app project, run:
``{bash}
npx @neynar/create-farcaster-mini-app@latest
`

To run the project:
`{bash}
cd
npm run dev
`

$3


To invoke the CLI directly in JavaScript, add the npm package to your project and use the following import statement:
`{javascript}
import { init } from '@neynar/create-farcaster-mini-app';
`

Deploying to Vercel

For projects that have made minimal changes to the quickstart template, deploy to vercel by running:
`{bash}
npm run deploy:vercel
`

Building for Production

To create a production build, run:
`{bash}
npm run build
`

The above command will generate a .env file based on the .env.local file and user input. Be sure to configure those environment variables on your hosting platform.

Developing Script Locally

This section is only for working on the script and template. If you simply want to create a mini app and _use_ the template, this section is not for you.

$3

To iterate on the CLI and test changes in a generated app without publishing to npm:

1. In your installer/template repo (this repo), run:
`bash
npm link
`
This makes your local version globally available as a symlinked package.


1. Now, when you run:
`bash
npx @neynar/create-farcaster-mini-app
`
...it will use your local changes (including any edits to init.js or other files) instead of the published npm version.

$3

You can also run the script directly for quick iteration:

`bash
node ./bin/index.js
`

However, this does not fully replicate the npx install flow and may not catch all issues that would occur in a real user environment.

$3

If you update environment variable handling, remember to replicate any changes in the dev, build, and deploy scripts as needed. The build and deploy` scripts may need further updates and are less critical for most development workflows.