floe

An opinionated Next.js starter generator built on the latest official create-next-app.

Usage

pnpm create floe@latest my-app

Without an explicit version:

pnpm create floe my-app

Or execute the npm package directly:

pnpm dlx create-floe@latest my-app

Or install it globally:

pnpm add --global create-floe
floe my-app

The generated project uses Node.js 24, pnpm, strict TypeScript, the App Router, Tailwind CSS, Turbopack, typed routes, Oxlint, Oxfmt, Lefthook, Vitest, Testing Library, Knip, CSpell, T3 Env, Zod, shadcn, GitHub Actions, and Renovate.

Local development

Node.js 24 or newer and pnpm 11 or newer are required.

From this repository:

pnpm install
pnpm build
pnpm link --global

Then, from the directory where you want the test project:

floe test-app
cd test-app
pnpm check
pnpm build

Run the CLI repository tests with:

pnpm test

Publishing

pnpm release

This runs the test suite and rebuilds dist/ before publishing.