> ## Documentation Index
> Fetch the complete documentation index at: https://docs.budscollab.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Package validation

> Validate package artifacts before preview, review, or registry handoff.

Run:

```bash theme={null}
npx @budscollab/cli app validate budscollab.package.json
```

Validation checks surfaces, actions, permissions, provenance, renderer
boundary, and JSON-render samples.

The validator checks:

* manifest contract and reserved ids
* required widget, fullscreen, dock, overlay, and JSON-render surfaces
* tool count and write posture
* allowlisted JSON-render component types
* allowlisted JSON-render action ids
* renderer boundary
* permission boundary
* JSON-render sample surface coverage
* package-required action ids

Common failures should be fixed in the blueprint or package source, then
recompiled and revalidated. Do not bypass validation to make a showcase.