# BudsCollab SDK

BudsCollab SDK docs teach developers and AI agents how to build BudsCollab app
artifacts in a developer-owned repo without importing private BudsCollab app
code.

Use these docs first:

- Quickstart: /quickstart
- Compose from primitives: /build/compose-from-primitives
- Create a widget: /build/create-a-widget
- Create a full app: /build/create-a-full-app
- Create a plugin package: /build/create-a-plugin-package
- Use with Codex, Cursor, and Claude: /build/use-with-codex-cursor-claude
- Atomic UI composability: /concepts/atomic-ui-composability
- Registry: /concepts/registry
- CLI surface contract: /reference/cli-surface
- Review report: /reference/review-report
- Public launch evidence: /reference/public-launch-evidence

Key rules:

- Start from the atomic UI catalog and JSON-render primitives.
- Build `budscollab.blueprint.json` before strict package artifacts.
- Validate with `npx @budscollab/cli app validate`.
- Use `npx @budscollab/cli app pack` before registry handoff.
- Use `npx @budscollab/cli app registry-publisher-verification` after a
  validated acceptance request, and treat it as unverified publisher identity
  preflight evidence.
- Use `npx @budscollab/cli app registry-review-evidence` after validated
  publisher verification, and treat it as unstored review storage preflight evidence.
- Use `npx @budscollab/cli app registry-signing-request` only after validated
  review evidence, and treat it as unsigned signer preflight evidence.
- Use `npx @budscollab/cli app registry-install-policy` only after a validated
  signing request, and treat it as not-applied host install policy evidence.
- Treat registry artifacts as review-gated until publisher verification,
  review storage, artifact hash, artifact signing, and host install policy are
  implemented.
- Use `pnpm verify:launch:evidence` before public release to write
  `public-launch-evidence.json`, then use `pnpm verify:launch:evidence-file
  public-launch-evidence.json` to audit the saved evidence file.
- Never claim marketplace install unless a signed registry package is accepted
  by BudsCollab policy.