A Farcaster Mini Apps quickstart template. This template repo can be installed with an interactive script, just run the npx command below.

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:

1. In your installer/template repo (this repo), run:

   npm link

   This makes your local version globally available as a symlinked package.

2. 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.