Skip to content
create-bsv-app

Guides

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.

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

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.
  • Add mode. Bring wallet connect, login or signed requests into an app you already have. Guide.
  • Reproducible. --file config.json describes a whole scaffold in one file. Reference.
  • Agent-ready. Generated projects ship an AGENTS.md, and these docs are available as Markdown.
  • History-free clones. Complete examples arrive without the template's git history, so git init gives you a clean first commit.