A Farcaster Mini Apps quickstart npx script.
This is a NextJS + TypeScript + React app.
Check out this Neynar docs page for a simple guide on how to create a Farcaster Mini App in less than 60 seconds!
To create a new mini app project, run:
npx @neynar/create-farcaster-mini-app@latest
To run the project:
cd <PROJECT_NAME>
npm run dev
To invoke the CLI directly in JavaScript, add the npm package to your project and use the following import statement:
import { init } from '@neynar/create-farcaster-mini-app';
For projects that have made minimal changes to the quickstart template, deploy to vercel by running:
npm run deploy:vercel
To create a production build, run:
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.
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.
To iterate on the CLI and test changes in a generated app without publishing to npm:
-
In your installer/template repo (this repo), run:
npm link
This makes your local version globally available as a symlinked package.
-
Now, when you run:
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.
You can also run the script directly for quick iteration:
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.
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.