Skip to main content
Build a BudsCollab app artifact in your own repo, validate it locally, and create the review evidence needed before the app can move toward registry review. The public SDK has one core loop:
  1. Scaffold an app repo.
  2. Compile budscollab.blueprint.json into budscollab.package.json.
  3. Validate the package.
  4. Generate review and plugin-package evidence.

​
Create an app

npm create budscollab-app my-app -- --name "My App"
cd my-app
pnpm run build:budscollab-artifact
pnpm run validate:budscollab-artifact
pnpm run verify:budscollab-plugin
After the commands finish, the repo should contain:
ArtifactPurpose
budscollab.blueprint.jsonEditable app source for surfaces, capabilities, and metadata.
budscollab.package.jsonStrict package artifact used by validation and review.
budscollab-app-review.jsonReview evidence and any remaining install blockers.
budscollab-showcase.json and SHOWCASE.mdPreview metadata for humans and agents.
.budscollab/plugin-package.jsonApp-local agent/package wrapper tied to the same SDK artifact.
verify:budscollab-plugin checks the app-local wrapper. It does not install the app and it does not make a marketplace claim.

​
Keep CI aligned

For CI, keep the generated .github/workflows/budscollab-sdk.yml and run: 
pnpm run ci:budscollab
That command runs the same artifact validation and plugin-package verification path that local developers, Eve sandbox jobs, and coding agents should use.

​
Choose a build lane

GoalStart here
Compact canvas object or chat outputCreate a widget
Multi-surface app with fullscreen and dockCreate a full app
Agent-friendly package with skills, docs, and optional MCPCreate a plugin package
Understand the underlying model firstSafely composable apps