Troubleshooting

Stay on the happy path from Quick Start. Use this page only when something breaks.

pnpm create cellas fails

1. Confirm Node.js ^22.13.0 || >=24.0.0.
2. Confirm pnpm 9 / npm / bun is on PATH.
3. Retry non-interactively:

pnpm create cellas my-docs --yes --no-install
cd my-docs
pnpm install

pnpm install cannot find @cellas/conformance-cli

1. Check registry reachability: npm view @cellas/conformance-cli version
2. Clear a bad cache if needed: pnpm store prune
3. Confirm package.json uses a semver range (not workspace:*)

verify fails

pnpm exec cellas verify --input examples/execution-record.json --type execution

• --input must be a JSON file, not a directory.
• Do not point at immutable monorepo samples/ from a generated project unless you copied those files.

certify is not PASS

pnpm exec cellas certify --target examples/target.json --profile reference

• Profile id must exist under conformance/profiles/ (starters ship reference).
• Read the CLI findings in the output; fix the named check, then re-run.

Wrong package manager commands

create-cellas prints the matching next steps for the detected manager.

Still stuck

1. Re-read the generated project README.md (always lists the next command).
2. Open FAQ.
3. Ask in GitHub Discussions (preferred for Public Beta help).
4. File a bug with Node/pnpm versions, full command, and output.