Preview (dry run)
A dashboard preview, or dry run, is a mode in which a proposed change is validated and its outcome returned, but nothing is saved, so the author can check the result before it reaches anyone else.
Previews matter most when the author is an agent. A person editing in a browser sees the result as they go; an agent writing JSON does not, unless the system shows it. A preview closes that gap by letting the agent see what its change would do before committing to it.
How it works in dvt
Every create and update in dvt, through the REST API or the MCP server, can run as a preview first. The preview validates the spec, computes the result, and returns it, including a summary of the resulting layout, without writing a revision. Only a second call persists the change.
This is the validate, preview, apply loop that dvt’s quickstart walks through: the agent writes the SQL and the spec, validates it, previews the render, and only then applies it. The same loop is available to people, so a human change and an agent change reach the live dashboard through identical checks. Once applied, the change becomes a new revision that can be diffed or rolled back.