Skip to content
/ Development

Documentation

Development

Build, test and extend Bonesmith itself.

Work on Bonesmith in the repository.

bash
npm ci
npm run build           # src/ -> dist/
npm run typecheck
npm run lint
npm test                # unit, render snapshots, template lint
npm run lint:templates  # every combination rendered in memory
npm run test:matrix     # real scaffold + install + build + lint + test (slow)
npm run check:pack      # check the npm tarball file list

To try the CLI locally, run npm run build, then node /path/to/bonesmith/dist/index.js my-app from an empty directory.

Adding an option

Every option is a folder under templates/<axis>/<option>/, containing a layer.json, files and Kiro content. Adding an option means adding a folder; the core code does not change. Version pins and their reasons are listed in templates/PINS.md.

Releasing

Releases are published from CI only. Push a v<version> tag that matches package.json. The release workflow runs the full matrix for that commit, checks the tarball and runs npm publish --provenance.