Skip to content
ContractSpec
Start here
AI index

Troubleshooting

Common issues and fixes when installing or generating with ContractSpec.

Command not found

  • Reinstall the CLI and ensure it is in your PATH.

  • Confirm Node.js 20+ or Bun 1.0+ is installed.

Specs not discovered

  • Runcontractspec list to see discovered specs.

  • Verify your spec path conventions in .contractsrc.json.

Build or validate fails

  • Runcontractspec validate to surface schema errors.

  • Check that generated files were not manually edited.

Diagnostics

bash
contractspec --version
contractspec list
contractspec validate src/contracts/mySpec.ts

Still blocked?

  • Confirm compatibility requirements for runtime and framework.

  • Re-run builds on a clean branch to isolate changes.

  • Use a new spec and minimal adapter to validate setup.