Docs / CLI

Create Command

Scaffold a new Better Fullstack project with prompts, defaults, or explicit flags.

The create command writes a new project from a typed stack configuration. Use it interactively for exploration, or pass flags when you need the same project shape every time.

npm create better-fullstack@latest [project-name] -- [flags]

For npm, Better Fullstack flags go after --. Generated npm commands may use npx create-better-fullstack@latest; that runs the same package entrypoint in a non-interactive form.

Command modes

Mode	Command shape	Use it when
Wizard	`[launcher] my-app`	You want prompts and defaults.
Defaults	`[launcher] my-app [flags] --yes`	You want the default stack without prompts.
Scripted	`[launcher] my-app [flags]`	You want repeatable output.
Dry run	`[launcher] my-app [flags] --dry-run`	You want to inspect files before writing.

Prompt behavior

Explicit flags skip only the categories they cover.
--yes accepts defaults and conflicts with core stack flags such as --frontend, --backend, --database, --orm, --auth, and --api.
Use none to disable optional categories, including --ai-docs none.
Use --no-install and --no-git when you want to inspect generated files before side effects.
--verify runs generated checks after scaffolding without starting dev servers.

Common flags

The tables below are generated from the same shared schemas the CLI, Stack Builder, and MCP server use, so accepted values and defaults stay in sync with the generator. See the Options Reference for per-ecosystem option details.

Flag	Accepted values	Default
`--ecosystem` Language/runtime ecosystem to scaffold.	`typescript` `react-native` `rust` `python` `go` `java` `elixir` `dotnet`	`typescript`
`--template` Start from a curated stack preset instead of individual flags.	`mern` `pern` `t3` `saas` `uniwind` `none`	—
`--part` Add a multi-ecosystem stack part. Repeat once per part.	role:ecosystem:tool (e.g. frontend:typescript:next)	—
`--addons`multiple Repo tooling and platform addons.	`pwa` `tauri` `electron` `capacitor` `wxt` `opentui` `turborepo` `nx` `mcp` `skills` `msw` `storybook` `swr` `tanstack-query` `tanstack-table` `tanstack-virtual` `tanstack-db` `tanstack-pacer` `backend-utils` `devcontainer` `docker-compose` `github-actions` `axios` `firebase` `graphql-codegen` `openapi-typescript` `apollo-client` `biome` `eslint` `prettier` `oxlint` `ultracite` `lefthook` `husky` `ruler` `starlight` `fumadocs` `none`	`turborepo`
`--examples`multiple Optional example features to include.	`ai` `chat-sdk` `none`	`none`
`--ai-docs`multiple Agent instruction files to generate.	`claude-md` `agents-md` `cursorrules` `none`	`claude-md agents-md`
`--package-manager` Package manager for the generated workspace.	`npm` `pnpm` `bun` `yarn`	`bun`
`--workspace-shape` Monorepo or single-app workspace layout.	`monorepo` `single-app`	`monorepo`
`--version-channel` Dependency version channel.	`stable` `latest` `beta`	`stable`
`--web-deploy` Deployment target config for the web app.	`cloudflare` `fly` `railway` `render` `netlify` `docker` `sst` `vercel` `none`	`none`
`--server-deploy` Deployment target config for the server.	`cloudflare` `fly` `railway` `render` `netlify` `docker` `sst` `vercel` `none`	`none`
`--directory-conflict` Strategy when the target directory already exists.	`merge` `overwrite` `increment` `error`	—
`--install` Install dependencies after scaffolding.	--install / --no-install	`--install`
`--git` Initialize a Git repository.	--git / --no-git	`--git`
`--dry-run` Preview generated files without writing them.	boolean flag	—
`--verify` Run generated checks after scaffolding where supported.	boolean flag	—
`--yes` Accept defaults. Conflicts with core stack flags.	boolean flag	—
`--yolo` Skip safety confirmations where supported.	boolean flag	—
`--verbose` Print detailed scaffold output.	boolean flag	—
`--disable-analytics` Opt out of anonymous CLI analytics.	boolean flag	—

TypeScript flags

Use these with --ecosystem typescript.

Flag	Accepted values	Default
`--frontend`multiple Web frontend framework(s).	`tanstack-router` `react-router` `react-vite` `vanilla-vite` `vue` `tanstack-start` `next` `vinext` `nuxt` `svelte` `solid` `solid-start` `astro` `qwik` `angular` `redwood` `fresh` `none`	`tanstack-router`
`--backend` Backend framework. `self` pairs with fullstack frontends.	`hono` `express` `fastify` `elysia` `fets` `effect` `nestjs` `adonisjs` `nitro` `encore` `convex` `self` `none`	`hono`
`--runtime` Server runtime.	`bun` `node` `workers` `none`	`bun`
`--database` Database engine.	`none` `sqlite` `postgres` `mysql` `mongodb` `edgedb` `redis`	`sqlite`
`--orm` ORM / query layer.	`drizzle` `prisma` `mongoose` `typeorm` `kysely` `mikroorm` `sequelize` `none`	`drizzle`
`--db-setup` Hosted database provider setup.	`turso` `neon` `prisma-postgres` `planetscale` `mongodb-atlas` `supabase` `upstash` `d1` `docker` `none`	`none`
`--auth` Authentication provider.	`better-auth` `better-auth-organizations` `go-better-auth` `clerk` `nextauth` `stack-auth` `supabase-auth` `auth0` `workos` `kinde` `passport` `none`	`better-auth`
`--api` API layer. tRPC is React-oriented.	`trpc` `orpc` `ts-rest` `garph` `graphql-yoga` `apollo-server` `openapi` `none`	`trpc`
`--astro-integration` Astro UI framework integration (Astro frontends).	`react` `vue` `svelte` `solid` `none`	`none`
`--manual-db` Skip provider-specific database setup prompts.	boolean flag	—

Services

Flag	Accepted values	Default
`--ai` AI SDK / agent framework.	`vercel-ai` `mastra` `voltagent` `langgraph` `openai-agents` `openai-sdk` `anthropic-sdk` `google-adk` `modelfusion` `langchain` `llamaindex` `tanstack-ai` `ai-cli` `none`	`none`
`--payments` Payments provider.	`revenuecat` `polar` `stripe` `lemon-squeezy` `paddle` `paypal` `dodo` `creem` `autumn` `commet` `none`	`none`
`--email` Email provider.	`react-email` `resend` `nodemailer` `postmark` `sendgrid` `aws-ses` `mailgun` `plunk` `none`	`none`
`--realtime` Realtime transport.	`socket-io` `ws` `partykit` `ably` `pusher` `liveblocks` `yjs` `none`	`none`
`--job-queue` Background job / queue system.	`bullmq` `trigger-dev` `inngest` `temporal` `none`	`none`
`--cms` Content management system.	`payload` `sanity` `strapi` `tinacms` `directus` `keystatic` `contentful` `none`	`none`
`--caching` Cache layer.	`upstash-redis` `redis` `none`	`none`
`--search` Search engine.	`meilisearch` `typesense` `elasticsearch` `opensearch` `algolia` `bleve` `none`	`none`
`--file-storage` Object storage provider.	`s3` `r2` `cloudinary` `supabase-storage` `none`	`none`
`--file-upload` File upload helper.	`uploadthing` `filepond` `uppy` `none`	`none`
`--analytics` Web analytics provider.	`plausible` `umami` `posthog` `ga4` `none`	`none`
`--feature-flags` Feature flag platform.	`growthbook` `posthog` `launchdarkly` `flagsmith` `unleash` `none`	`none`
`--vector-db` Vector database.	`pgvector` `qdrant` `chroma` `pinecone` `none`	`none`
`--rate-limit` Rate limiting helper.	`arcjet` `upstash-ratelimit` `none`	`none`
`--i18n` Internationalization library.	`paraglide` `i18next` `next-intl` `intlayer` `none`	`none`
`--effect` Effect capability level.	`effect` `effect-full` `none`	`none`
`--logging` Logging library.	`pino` `winston` `evlog` `none`	`none`
`--observability` Observability provider.	`opentelemetry` `sentry` `grafana` `datadog` `axiom` `betterstack` `none`	`none`

UI and app behavior

Flag	Accepted values	Default
`--css-framework` CSS framework.	`tailwind` `scss` `less` `postcss-only` `styled-components` `none`	`tailwind`
`--ui-library` Component library.	`shadcn-ui` `shadcn-svelte` `daisyui` `radix-ui` `headless-ui` `park-ui` `chakra-ui` `nextui` `mantine` `mui` `antd` `base-ui` `ark-ui` `react-aria` `none`	`shadcn-ui`
`--state-management` Client state manager.	`zustand` `jotai` `nanostores` `redux-toolkit` `mobx` `xstate` `valtio` `tanstack-store` `legend-state` `none`	`none`
`--forms` Form library.	`tanstack-form` `react-hook-form` `formik` `final-form` `conform` `modular-forms` `none`	`react-hook-form`
`--validation` Schema validation library.	`zod` `valibot` `arktype` `typebox` `typia` `runtypes` `effect-schema` `none`	`zod`
`--testing` Testing setup.	`vitest` `playwright` `vitest-playwright` `jest` `mocha` `cypress` `none`	`vitest`
`--animation` Animation library.	`framer-motion` `gsap` `react-spring` `auto-animate` `lottie` `none`	`none`

shadcn/ui flags

Flag	Accepted values	Default
`--shadcn-base` shadcn primitive base.	`radix` `base`	`radix`
`--shadcn-style` shadcn style preset.	`vega` `nova` `maia` `lyra` `mira` `luma` `sera`	`nova`
`--shadcn-icon-library` Icon library.	`lucide` `tabler` `hugeicons` `phosphor` `remixicon` `heroicons` `react-icons`	`lucide`
`--shadcn-color-theme` Color theme.	`neutral` `stone` `zinc` `gray` `amber` `blue` `cyan` `emerald` `fuchsia` `green` `indigo` `lime` `orange` `pink` `purple` `red` `rose` `sky` `teal` `violet` `yellow`	`neutral`
`--shadcn-base-color` Base neutral color.	`neutral` `stone` `zinc` `gray`	`neutral`
`--shadcn-font` Default font.	`inter` `geist` `noto-sans` `nunito-sans` `figtree` `roboto` `raleway` `dm-sans` `public-sans` `outfit` `jetbrains-mono` `geist-mono`	`inter`
`--shadcn-radius` Corner radius scale.	`default` `none` `small` `medium` `large`	`default`

React Native flags

Use these with --ecosystem react-native.

Flag	Accepted values	Default
`--frontend`multiple Expo native frontend styling.	`native-bare` `native-uniwind` `native-unistyles` `none`	`native-bare`
`--mobile-navigation` Navigation library.	`expo-router` `react-navigation` `none`	`none`
`--mobile-ui` Mobile UI kit.	`tamagui` `gluestack-ui` `uniwind` `unistyles` `none`	`none`
`--mobile-storage` On-device storage.	`mmkv` `none`	`none`
`--mobile-testing` Mobile testing setup.	`maestro` `react-native-testing-library` `maestro-react-native-testing-library` `none`	`none`
`--mobile-push` Push notifications.	`expo-notifications` `none`	`none`
`--mobile-ota` Over-the-air updates.	`expo-updates` `none`	`none`
`--mobile-deep-linking` Deep linking.	`expo-linking` `none`	`none`
`--mobile-libraries`multiple Optional Expo modules.	`expo-sqlite` `expo-camera` `expo-image-picker` `expo-location` `expo-sensors` `expo-file-system` `expo-image` `expo-audio` `expo-video` `expo-contacts` `expo-calendar` `expo-local-authentication` `expo-sharing` `expo-clipboard` `expo-task-manager` `expo-background-task` `expo-maps` `expo-brightness` `expo-battery` `expo-screen-capture` `none`	`none`

Language ecosystem flags

Rust

Flag	Accepted values	Default
`--rust-web-framework` Rust web framework.	`axum` `actix-web` `rocket` `poem` `loco` `warp` `salvo` `none`	`none`
`--rust-frontend` WASM frontend.	`leptos` `dioxus` `yew` `none`	`none`
`--rust-orm` Rust ORM / database.	`sea-orm` `sqlx` `diesel` `mongodb` `rusqlite` `tokio-postgres` `none`	`none`
`--rust-api` Rust API layer.	`tonic` `async-graphql` `jsonrpsee` `none`	`none`
`--rust-cli` Rust CLI tooling.	`clap` `ratatui` `none`	`none`
`--rust-libraries`multiple Rust core libraries.	`serde` `uuid` `chrono` `reqwest` `config` `dashmap` `parking-lot` `secrecy` `tokio-util` `utoipa` `validator` `jsonwebtoken` `argon2` `tokio-test` `mockall` `proptest` `insta` `rand` `regex` `rayon` `itertools` `rstest` `cargo-nextest` `cargo-audit` `none`	`none`
`--rust-logging` Rust logging.	`tracing` `env-logger` `none`	`tracing`
`--rust-error-handling` Rust error handling.	`anyhow-thiserror` `eyre` `none`	`anyhow-thiserror`
`--rust-caching` Rust caching.	`moka` `redis` `none`	`none`
`--rust-auth` Rust auth.	`oauth2` `torii` `openidconnect` `tower-sessions` `none`	`none`
`--rust-realtime` Rust realtime.	`tokio-tungstenite` `none`	`none`
`--rust-message-queue` Rust message queue.	`lapin` `rdkafka` `async-nats` `none`	`none`
`--rust-observability` Rust observability.	`opentelemetry` `metrics` `none`	`none`
`--rust-templating` Rust templating.	`askama` `tera` `minijinja` `none`	`none`

Python

Flag	Accepted values	Default
`--python-web-framework` Python web framework.	`fastapi` `django` `flask` `litestar` `starlette` `aiohttp` `streamlit` `none`	`fastapi`
`--python-orm` Python ORM / database.	`sqlalchemy` `sqlmodel` `tortoise-orm` `peewee` `pymongo` `none`	`sqlalchemy`
`--python-validation` Validation library.	`pydantic` `none`	`pydantic`
`--python-ai`multiple Python AI / ML libraries.	`langchain` `llamaindex` `openai-sdk` `anthropic-sdk` `langgraph` `crewai` `haystack` `pydantic-ai` `google-adk` `smolagents` `pytorch` `transformers` `scikit-learn` `tensorflow` `mcp` `none`	`none`
`--python-auth` Python auth.	`authlib` `jwt` `pyjwt` `fastapi-users` `none`	`none`
`--python-api` Python API framework.	`django-rest-framework` `django-ninja` `none`	`none`
`--python-task-queue` Python task queue.	`celery` `rq` `dramatiq` `huey` `taskiq` `none`	`none`
`--python-graphql` Python GraphQL.	`strawberry` `ariadne` `none`	`none`
`--python-quality` Python code quality tool.	`ruff` `mypy` `pyright` `none`	`ruff`
`--python-testing`multiple Python testing libraries.	`pytest` `hypothesis` `pytest-cov` `none`	`none`
`--python-caching` Python caching.	`redis` `aiocache` `none`	`none`
`--python-realtime` Python realtime.	`python-socketio` `websockets` `none`	`none`
`--python-observability` Python observability.	`opentelemetry` `prometheus-client` `none`	`none`
`--python-cli`multiple Python CLI tooling.	`typer` `click` `rich` `none`	`none`
`--python-cloud-sdk` Python cloud SDK.	`boto3` `none`	`none`
`--python-http-client` Python HTTP client.	`requests` `none`	`none`
`--python-data`multiple Python data and scientific libraries.	`numpy` `pandas` `scipy` `none`	`none`
`--python-media` Python media library.	`pillow` `none`	`none`
`--python-server` Python production server.	`gunicorn` `none`	`none`
`--python-package-manager` Python package manager.	`uv` `poetry` `none`	`uv`
`--python-message-queue` Python message queue client.	`confluent-kafka` `none`	`none`

Go

Flag	Accepted values	Default
`--go-web-framework` Go web framework.	`gin` `echo` `fiber` `chi` `stdlib` `go-zero` `kratos` `httprouter` `none`	`gin`
`--go-orm` Go ORM / database.	`gorm` `sqlc` `ent` `bun` `sqlx` `none`	`gorm`
`--go-api` Go API layer.	`grpc-go` `gqlgen` `grpc-gateway` `connect-go` `oapi-codegen` `none`	`none`
`--go-cli` Go CLI tooling.	`cobra` `bubbletea` `urfave-cli` `none`	`none`
`--go-logging` Go logging.	`zap` `zerolog` `slog` `logrus` `none`	`zap`
`--go-auth` Go-native auth helpers.	`casbin` `jwt` `goth` `oauth2` `none`	`none`
`--go-testing`multiple Go testing libraries.	`testify` `gomock` `testcontainers` `ginkgo-gomega` `mockery` `none`	`none`
`--go-realtime` Go realtime.	`gorilla-websocket` `centrifuge` `none`	`none`
`--go-message-queue` Go message queue.	`nats` `watermill` `kafka-go` `asynq` `none`	`none`
`--go-caching` Go caching.	`redis` `ristretto` `none`	`none`
`--go-config` Go config loader.	`viper` `koanf` `none`	`none`
`--go-observability` Go observability.	`opentelemetry` `prometheus` `none`	`none`
`--go-validation` Go validation.	`validator` `none`	`none`
`--go-quality` Go code quality.	`golangci-lint` `none`	`none`
`--go-migrations` Go database migrations.	`golang-migrate` `none`	`none`
`--go-templating` Go templating.	`templ` `none`	`none`
`--go-proto-tooling` Go protobuf tooling.	`buf` `none`	`none`
`--go-di` Go dependency injection.	`fx` `none`	`none`

GoBetterAuth is selected with the global --auth go-better-auth value. Go-native helpers use --go-auth.

Java

Flag	Accepted values	Default
`--java-web-framework` Java web framework.	`spring-boot` `quarkus` `micronaut` `none`	`spring-boot`
`--java-language` JVM language (java or kotlin).	`java` `kotlin`	—
`--java-build-tool` Build tool.	`maven` `gradle` `none`	`maven`
`--java-orm` Java ORM / database.	`spring-data-jpa` `jooq` `mybatis` `none`	`none`
`--java-auth` Java auth.	`spring-security` `keycloak` `none`	`none`
`--java-api` Java API layer.	`spring-graphql` `openapi-generator` `grpc` `none`	`none`
`--java-logging` Java logging.	`logback` `log4j2` `none`	`none`
`--java-libraries`multiple Java libraries.	`spring-actuator` `spring-validation` `flyway` `liquibase` `springdoc-openapi` `lombok` `mapstruct` `caffeine` `resilience4j` `spring-webflux` `spring-batch` `spring-kafka` `spring-mail` `spring-devtools` `micrometer-prometheus` `thymeleaf` `spring-amqp` `opentelemetry-java` `spring-data-redis` `spring-data-mongodb` `spring-data-elasticsearch` `spring-data-neo4j` `spring-data-cassandra` `spring-data-couchbase` `spring-data-jdbc` `spring-data-rest` `spring-quartz` `spring-pulsar` `spring-integration` `spring-websocket` `spring-rsocket` `spring-hateoas` `spring-session-redis` `spring-session-jdbc` `spring-ldap` `spring-oauth2-client` `spring-saml2` `spring-restclient` `none`	`none`
`--java-testing-libraries`multiple Java testing libraries.	`junit5` `mockito` `testcontainers` `assertj` `rest-assured` `wiremock` `awaitility` `archunit` `jqwik` `none`	`junit5`

.NET

Flag	Accepted values	Default
`--dotnet-web-framework` .NET web framework.	`aspnet-minimal` `aspnet-mvc` `aspnet-blazor` `none`	`aspnet-minimal`
`--dotnet-orm` .NET data access.	`ef-core` `dapper` `linq2db` `none`	`ef-core`
`--dotnet-auth` .NET auth.	`aspnet-identity` `duende-identityserver` `auth0-aspnet` `none`	`aspnet-identity`
`--dotnet-api` .NET API style.	`minimal-api` `graphql-hotchocolate` `grpc-dotnet` `none`	`minimal-api`
`--dotnet-testing`multiple .NET testing libraries.	`xunit` `nunit` `moq` `testcontainers-dotnet` `none`	`xunit`
`--dotnet-job-queue` .NET background jobs.	`hangfire` `quartz-net` `hosted-services` `none`	`none`
`--dotnet-realtime` .NET realtime.	`signalr` `none`	`signalr`
`--dotnet-observability`multiple .NET observability.	`opentelemetry-dotnet` `serilog` `nlog` `health-checks` `none`	`serilog`
`--dotnet-validation` .NET validation.	`fluentvalidation` `data-annotations` `none`	`none`
`--dotnet-caching` .NET caching.	`redis` `memory-cache` `none`	`none`
`--dotnet-deploy` .NET deploy target.	`docker` `azure` `aws` `none`	`docker`
`--dotnet-libraries`multiple Optional .NET libraries.	`automapper` `mediatr` `fastendpoints` `api-versioning` `scalar` `polly` `masstransit` `rebus` `coravel` `magic-onion` `prometheus-net` `seq` `application-insights` `sentry` `mongodb-driver` `nhibernate` `mapster` `scrutor` `refit` `fluent-email` `none`	`none`

Elixir

Flag	Accepted values	Default
`--elixir-web-framework` Elixir web framework.	`phoenix` `phoenix-live-view` `none`	`phoenix`
`--elixir-orm` Elixir ORM / database.	`ecto` `ecto-sql` `myxql` `ecto_sqlite3` `none`	`ecto-sql`
`--elixir-auth` Elixir auth.	`phx-gen-auth` `ueberauth` `guardian` `pow` `none`	`none`
`--elixir-api` Elixir API layer.	`rest` `absinthe` `grpc` `open_api_spex` `none`	`rest`
`--elixir-realtime` Elixir realtime.	`channels` `presence` `pubsub` `live-view-streams` `none`	`channels`
`--elixir-jobs` Elixir jobs.	`oban` `quantum` `none`	`none`
`--elixir-validation` Elixir validation.	`ecto-changesets` `nimble-options` `none`	`ecto-changesets`
`--elixir-http` Elixir HTTP client.	`req` `finch` `tesla` `none`	`req`
`--elixir-json` Elixir JSON library.	`jason` `none`	`jason`
`--elixir-email` Elixir email.	`swoosh` `bamboo` `none`	`none`
`--elixir-caching` Elixir caching.	`cachex` `nebulex` `redix` `none`	`none`
`--elixir-observability` Elixir observability.	`telemetry` `opentelemetry` `prom_ex` `sentry` `none`	`telemetry`
`--elixir-testing` Elixir testing.	`ex_unit` `mox` `bypass` `wallaby` `stream_data` `ex_machina` `none`	`ex_unit`
`--elixir-quality` Elixir code quality.	`credo` `dialyxir` `sobelow` `excoveralls` `mix_audit` `none`	`credo`
`--elixir-i18n` Elixir internationalization.	`gettext` `none`	`none`
`--elixir-http-server` Elixir HTTP server.	`bandit` `cowboy` `none`	`cowboy`
`--elixir-application-framework` Elixir application framework.	`ash` `none`	`none`
`--elixir-documentation` Elixir documentation.	`ex_doc` `none`	`none`
`--elixir-clustering` Elixir clustering.	`libcluster` `none`	`none`
`--elixir-deploy` Elixir deploy target.	`docker` `fly` `gigalixir` `mix-release` `none`	`none`
`--elixir-libraries`multiple Elixir libraries.	`broadway` `nx` `ex_aws` `floki` `rustler` `none`	`none`

Examples

Create a TypeScript app with explicit flags:

npm create better-fullstack@latest my-app -- \  --ecosystem typescript \  --frontend tanstack-router \  --backend hono \  --runtime node \  --database postgres \  --orm drizzle \  --db-setup none \  --api orpc \  --auth better-auth \  --css-framework tailwind \  --ui-library shadcn-ui \  --ai none \  --payments none \  --email none \  --examples none \  --addons none \  --ai-docs none \  --version-channel stable \  --no-install \  --no-git

Create a multi-ecosystem project:

npm create better-fullstack@latest my-mixed-app -- \  --part frontend:typescript:next \  --part backend:go:gin \  --part backend.orm:go:gorm \  --part backend.auth:go:jwt \  --part database:universal:postgres \  --part mobile:react-native:native-bare \  --addons turborepo docker-compose

Compatibility

The CLI validates stack compatibility before generation.
TypeScript backend self is for fullstack frontends and pairs with runtime none.
tRPC is React-oriented.
Workers runtime support depends on the frontend/backend combination.
UI libraries, deployment targets, providers, and addons are stack-sensitive.
For a visual check, use the Compatibility Matrix or the Stack Builder.