create-bsv-app

create-bsv-app is the supported CLI and starter catalogue for new BSV applications. It generates React, Express, and full-stack projects, copies governed complete examples, and can add wallet capabilities to an existing project.

Run

npx create-bsv-app new my-app --starter full-stack --yes
cd my-app
npm run dev

The CLI can also create react, express, or catalogue starters and supports interactive, flag, JSON configuration, and local browser-UI inputs. Generated projects record the resolved starter and layout in bsv-scaffold.json. Select TerraTestNet with --network ttn or the browser configurator; the choice is preserved in generated configuration and bsv-scaffold.json.

Use --skip-install when CI or another tool owns dependency installation. Review generated authentication and nonce-store configuration before production; multi-process services need a shared atomic replay store.

The package publishes an installed create-bsv-app executable for Node.js 22 or newer. Package checks validate the packed CLI in a clean consumer with lifecycle scripts disabled. See the package README for the starter catalogue, modes, flags, merge rules, and security boundaries.

License

Open BSV License Version 6. See the package license.