SWIRLS_
Interfaces

Interfaces

The surface people use. Declare an app over your deployment and Swirls generates the interface from the primitives it exposes.

What it is. The primitives that put a face on your system. Every other category declares what the system is; interfaces declare who it is for.

Use it when the people who need your system are not the people who wrote it. A support team needs the triage agent and the ticket table, not the dashboard that operates them.

  • App: a generated application surface over your deployment. Declare what the app is for and which agents, workflows, views, and databases it exposes. Swirls composes the interface at deploy time and renders it with live data.

A deployment already describes a complete system: agents that reason, workflows that run, views over the data they produce. An app block turns that description into a product surface. Add a view block to your files, push, and the app grows a page. The interface stays in sync with the system because it is generated from it.