> ## 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.

# Showcase previews

> Preview BudsCollab app artifacts without making install claims.

Showcase previews are public-safe metadata. They help a developer, reviewer, or
agent explain what an app artifact is before any marketplace install path
exists.

Generate JSON metadata:

```bash theme={null}
npx @budscollab/cli app showcase budscollab.blueprint.json --out budscollab-showcase.json
```

Generate a Markdown preview:

```bash theme={null}
npx @budscollab/cli app showcase budscollab.blueprint.json --format markdown --out SHOWCASE.md
```

A showcase can include:

* app id, name, description, publisher, category, and distribution target
* surfaces and capabilities
* safety badges
* tool permission mode
* warnings
* review stage, install status, next gate, and blockers

A showcase does not:

* execute external app code
* register a collection entry
* prove publisher identity
* store review evidence
* sign the artifact
* make the package installable

Use the phrase `preview-only` when a showcase or sandbox preview exists but
install is not allowed. Use `review-gated` after validation when signing,
publisher verification, or stored review evidence is still missing.