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
- Run:
looky list visualizations looky list dashboards - Open
https://my.looky.studioand verify dashboard titles and cards render. - Open at least one visualization detail and confirm data appears as expected.
- 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.