# Migrate from @bsv/app

> @bsv/app is deprecated. Here's how every old template and flag maps to create-bsv-app, and what you gain by switching.

> Agents: search these docs with the `search_docs` tool on the MCP server at https://createbsvapp.vercel.app/mcp, or read everything at https://createbsvapp.vercel.app/llms-full.txt.

**Should you still use `npx @bsv/app`? No.** It's deprecated, and its last release (1.1.0) only prints a notice and forwards your arguments to `create-bsv-app`. Everything it offered now lives in create-bsv-app, plus generated starters, capabilities, add mode and a config-file mode.

## Already have an @bsv/app project?

Nothing breaks. `@bsv/app` cloned a template repository and got out of the way, so your project doesn't depend on it at runtime. Keep building. You only need this page the next time you start a project.

## Command mapping

| You used to run | Run this instead |
| --- | --- |
| `npx @bsv/app` | `npx create-bsv-app@latest` |
| `npx @bsv/app --yes` (cloned Meter as `bsv-app`) | `npx create-bsv-app@latest bsv-app --starter meter --yes` |
| `--skip-install` / `-s` | `--skip-install` |
| `--git-init` / `-g` | no flag. Run `git init` yourself afterwards |
| `--yes` / `-y` | `--yes` (now skips every prompt, using your flags) |
| author prompt | gone. Edit `package.json` |

## Template mapping

Every template from the old menu is a starter id now:

| Old menu entry | `--starter` |
| --- | --- |
| Frontend Template | `brc102-frontend` |
| Backend Template | `brc102-backend` |
| Full Stack Template | `full-stack` (generated), or `brc102-frontend` + `brc102-backend` |
| Pollr | `pollr` |
| Meter | `meter` |
| MetaMarket | `metamarket` |
| ToDo List | `todo` |
| MarsCast | `marscast` |
| Coinflip | `coinflip` |
| Postboard | `postboard` |
| Locksmith | `locksmith` |
| PeerPay | `peerpay` |
| AtFinder | `atfinder` |
| Convo | retired, no replacement |

::: note "Full Stack Template" used to clone the frontend template
In `@bsv/app` it pointed at the same repository as the Frontend Template. Today's `full-stack` is a real generated React + Express app with wallet connect, login and signed requests. If you want the overlay-based setup the old name hinted at, combine `brc102-frontend` and `brc102-backend`.
:::

## What's different

- **Two kinds of starter.** The old templates are all here as *complete examples*. They're cloned from their repos, now with the exact commit recorded in `bsv-scaffold.json`. The new *generated* starters are clean, minimal and composable with [capabilities](https://createbsvapp.vercel.app/docs/capabilities).
- **Add mode.** Bring wallet connect, login or signed requests into an app you already have. [Guide](https://createbsvapp.vercel.app/docs/add-to-existing).
- **Reproducible.** `--file config.json` describes a whole scaffold in one file. [Reference](https://createbsvapp.vercel.app/docs/config).
- **Agent-ready.** Generated projects ship an `AGENTS.md`, and these docs are available as [Markdown](https://createbsvapp.vercel.app/docs/agents#docs-built-for-context-windows).
- **History-free clones.** Complete examples arrive without the template's git history, so `git init` gives you a clean first commit.