# @farm.js/create-app

Create a new FARMJS application

See [Stability and Support](https://farmjs.dev/docs/stability) for what this package guarantees.

```bash
pnpm create @farm.js/app my-app --template basic
cd my-app
pnpm dev
```

The scaffolder installs FARMJS, React by default, TypeScript, and the other starter dependencies
automatically. Every starter also registers the official
[`@farm.js/devtools`](https://farmjs.dev/docs/plugins/devtools) workspace, available at
`/__farm/devtools` (or `Command/Ctrl + Shift + .`) during `pnpm dev`. The command explicitly selects the minimal Basic starter. Use `pnpm create`, not
`pnpm add`; pnpm resolves this initializer command to the published `@farm.js/create-app` package.
Pass `--skip-install` when you only want to generate the project files.

Right after a release, pnpm can still start the previous initializer: its `create` cache lasts a
day, and pnpm 11's default release-age policy holds back packages published in the last day. Set
both for the shell, then run the command again:

```bash
export PNPM_CONFIG_DLX_CACHE_MAX_AGE=0
export PNPM_CONFIG_MINIMUM_RELEASE_AGE_EXCLUDE='["@farm.js/*"]'
pnpm create @farm.js/app my-app --template basic
```

In PowerShell:

```powershell
$env:PNPM_CONFIG_DLX_CACHE_MAX_AGE = "0"
$env:PNPM_CONFIG_MINIMUM_RELEASE_AGE_EXCLUDE = '["@farm.js/*"]'
pnpm create @farm.js/app my-app --template basic
```

Choose React, Preact, Solid, Vue, or Svelte for the Basic and Better Auth starters:

```bash
pnpm create @farm.js/app my-app --template better-auth --renderer solid
```

React remains the default when `--renderer` is omitted. The interactive Basic and Better Auth
flows also offer a renderer chooser.

List every starter:

```bash
pnpm create @farm.js/app --list-templates
```

Available templates:

- Core: `basic`, `auth`, `better-auth`
- Auth: `auth0`, `authjs`, `clerk`, `supabase`, `workos`
- Billing: `autumn`, `polar`, `stripe`
- Product integrations: `ai`, `jobs-inngest`, `jobs-trigger`, `resend`, `unkey`

Integration templates include provider wiring, a local UI feature, `.env.example`, a minimal dark
home page, and setup documentation. Better Auth has renderer-native UI for all five renderers;
other integration templates currently use React. For example:

```bash
pnpm create @farm.js/app stripe-app --template stripe
```

See the [FARMJS repository](https://github.com/farming-labs/farm.js) for documentation, examples, and support.