Renderers

A Renderer is a UI component that takes a Branch's output and renders it as a formatted interface element in a Stackmint Surface. Rather than displaying raw JSON or unstructured text, Renderers transform execution outputs into tables, cards, forms, charts, or any other visual structure appropriate to the data.

How Renderers work

When a Branch execution completes, the execution output is passed to the Renderer assigned to that Capability in the Workspace. The Renderer receives the output object, validates it against its expected schema, and produces a rendered component that the Surface displays to the user.

Renderers are Surface-aware: the same Renderer may produce different output for the Chat Surface (a compact card) versus the Client Cockpit (a full-width table with sort/filter controls).

Renderer certification

Renderers published to the Stackmint marketplace go through a certification process before they are available for installation:

• Schema validation — The Renderer's expected input schema is validated against the Branch output schemas it claims to support.
• Security scan — Static analysis for XSS vulnerabilities, unsafe DOM manipulation, and external resource loading.
• LLM audit scoring — An automated review produces a quality and safety score that is displayed on the marketplace listing.

Only certified Renderers can be installed in production Workspaces. Enterprise Workspaces can request private certification for custom Renderers.

Renderer installation

Renderers are installed per Workspace from the marketplace. During installation:

• Compatibility is checked against the Workspace's installed Capabilities and their output schemas
• A compatibility score is displayed to help administrators choose the right Renderer
• License terms are accepted (usage tier, royalty structure)

An installed Renderer has an active or paused status. Paused Renderers fall back to the default plain-text output format.

Renderer royalties

Renderer authors earn royalties on each execution where their Renderer is used. Royalties are calculated per-render and tracked in the platform's ledger. Partners who publish Renderers can view their earnings in the Partner Cockpit.

Object type targeting

Each Renderer declares the output object types it can handle. A Renderer for contact_enrichment_result will only be offered during installation for Capabilities that produce that output type. This prevents mismatched Renderer/output pairings.

Custom Renderers

Enterprise Workspaces can build and use private Renderers without publishing them to the marketplace. Private Renderers still undergo the certification process but are only visible to the Workspace that owns them.