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

# Surfaces

> Where BudsCollab apps can appear.

Surfaces are declared in the blueprint so the host can validate how an app
renders before it is saved, shared, or submitted for review.

The public surface primitives are:

* `widget`: compact canvas object.
* `fullscreen`: focused app view.
* `dock`: launcher entry that opens a fullscreen app.
* `overlay`: ambient floating surface.
* `chatPanel`: deterministic Bud chat panel.

Dock requires fullscreen. Widget, fullscreen, overlay, and chat panel can be
rendered with JSON-render primitives.