Docs / CLI

Add Features

Add supported addons to existing Better Fullstack projects.

The add command updates an existing Better Fullstack project. It reads bts.jsonc, validates requested addons, writes supported files, and updates the project config.

npm create better-fullstack@latest add -- --addons mcp skills

What add does

Reads bts.jsonc from the current project, or from --project-dir.
Prompts for compatible addons when --addons is omitted.
Skips addons that are already installed.
Writes addon templates and dependency changes when a new addon is selected.
Prints an install command when dependency installation is skipped.

Flags

Flag	Values or behavior
`--addons`	`pwa` `tauri` `starlight` `biome` `lefthook` `husky` `ruler` `mcp` `skills` `turborepo` `fumadocs` `ultracite` `oxlint` `opentui` `wxt` `msw` `storybook` `swr` `tanstack-query` `tanstack-table` `tanstack-virtual` `tanstack-db` `tanstack-pacer` `backend-utils` `docker-compose` `none`
`--project-dir`	Path to the generated project. Defaults to the current directory.
`--install`	Install dependencies after adding files. Defaults to false for `add`.
`--package-manager`	`npm` `pnpm` `bun` `yarn`
`--web-deploy`	Records a web deployment target after addon processing.
`--server-deploy`	Records a server deployment target after addon processing.

Addon reference

Addon	Purpose
`mcp`	Generated-project MCP server configuration for coding agents.
`skills`	Curated coding-agent skill files.
`turborepo`	Monorepo orchestration.
`docker-compose`	Local service orchestration for supported stacks.
`biome` `oxlint` `ultracite` `lefthook` `husky` `ruler`	Code quality and hooks.
`starlight` `fumadocs`	Documentation sites when compatible with the stack.
`tauri` `pwa` `wxt`	Desktop, progressive web app, and browser extension support.
`msw` `storybook`	Testing and component development utilities.
`swr` `tanstack-query` `tanstack-table` `tanstack-virtual` `tanstack-db` `tanstack-pacer`	Data fetching and UI utilities.
`backend-utils`	asyncHandler, ApiResponse, and a global error handler for Hono, Express, Fastify, Elysia, feTS, or NestJS servers.
`opentui`	Terminal UI support.

Idempotency

bts.jsonc is the source of truth for installed addons. If every requested addon is already present, add reports that no new addons were selected and exits without applying unrelated changes.

Recommended workflow

Commit or stash current work.
Run add with explicit addon flags.
Review generated file changes.
Install dependencies if the command skipped install.
Run the project's test, lint, or typecheck command.