Docs / Build Workflow

Publish

Pre-publish gate (always run from workspace root)

Never push blind. Run this sequence exactly:

looky status
looky validate
looky diff
looky push

If validate reports errors, stop. Fix before pushing.

What each command protects

looky status

Confirms linked root, instance URL, billing account, and workspace identity.

looky validate

Checks workspace content contracts and catches structural issues before deployment.

looky diff

Shows precise server-facing changes so you can catch accidental edits.

looky push

Publishes workspace content to the target instance.

Post-publish verification checklist

  1. Run:
    looky list visualizations
    looky list dashboards
  2. Open https://my.looky.studio and verify dashboard titles and cards render.
  3. Open at least one visualization detail and confirm data appears as expected.
  4. If local runtime is used, compare behavior in http://localhost:8000.

Failure recovery playbook

looky status
looky diff
looky validate
looky push

If results still differ from expectation after a clean push, inspect runtime sources first, then model query references, then visualization mappings.

Successful push is transport success, not product success. Product success is correct rendering in the target UI.