FAQ
Frequently asked questions
Quick answers about running Bonesmith, the options it offers and how it fits into your workflow.
The basics
What is Bonesmith?
Bonesmith is an open-source CLI, run with npm create bonesmith, that scaffolds a ready-to-build React 19 repo: either a client-side app or a publishable component library with Storybook. It also writes a .kiro setup that matches the stack you picked.
Read the introductionIs Bonesmith free?
Yes. Bonesmith is MIT licensed. You can use it for personal and commercial projects.
What do I need installed?
Node.js 24.11 or newer, and git. The package manager you choose (pnpm, npm, yarn or bun) must also be available.
Quick startWhat does it do after generating files?
It runs git init, installs dependencies at exactly pinned versions, makes an initial commit, then runs build, lint and test once to check the result.
Options
What can I choose?
Project type (app or library), toolchain (Vite+ or Vite), routing (React Router or TanStack Router), state (none, Redux Toolkit or Zustand), UI library (none, shadcn, MUI or Mantine), styling (Tailwind, CSS Modules or styled-components) and package manager.
Options referenceWhy was my combination rejected?
Some pairs do not work together: shadcn requires Tailwind, MUI cannot be used with Tailwind or styled-components, and Mantine cannot be used with Tailwind. The CLI exits and names the flag that fixes it.
Can I run it without prompts?
Yes. Pass --yes to use the defaults for every choice you did not give as a flag. Nothing is prompted, so it works in CI and scripts.
Are routing and state available for libraries?
No. They apply to apps only, and passing --routing or --state with --type library is an error.
Library modeKiro and the project
What is in the .kiro folder?
Steering files, agents and MCP server settings generated for your exact stack. Options you did not choose add nothing.
Kiro setupWhat happens if a step fails?
The CLI prints the exact command to re-run and keeps the project on disk, so you can fix the problem and continue.
TroubleshootingHow can I report a bug or contribute?
Open an issue or pull request on GitHub. Bug reports, new template options and documentation improvements are welcome.
ContributingStill have a question?
Check the documentation, or ask on GitHub and we will help.