Skip to main content
After every prompt completion, Clark automatically creates a checkpoint — a version of your app you can preview, publish, or restore. Checkpoint in Clark chat with Preview and Publish

​
Version history in Clark

Version history lives in the Clark AI panel. To navigate to version history:
  1. Open Clark in the editor
  2. In the Clark header, click the Version history icon (next to Chat)
The list shows every checkpoint for the app, where each checkpoint may display details like a Live badge for the current production version, build status, and a menu for Preview, Publish, and related actions. Version history in the Clark panel

​
Preview from a checkpoint

From a checkpoint in chat or version history, click Preview to build a preview of that version. When the build is ready, open the preview from the notification (Your checkpoint preview is ready. Open preview) or from the Publish detail view when available.

​
Publish from a checkpoint

From a checkpoint in chat or version history, click Publish to promote that version to production. Superblocks builds, runs pre-publish checks, and deploys in one flow.

​
Publish detail view

To open the publish details tab, click View publish details from a previewed / published checkpoint card, or click any previewed / published version in history. The Publish tab shows:
  • Progress through the pipeline (build, pre-publish policies, database steps when applicable, publish status)
  • Errors and retries when a step fails
  • Pre-publish security and policy findings (fix with Clark, acknowledge advisory findings, or Publish anyway when allowed)
  • Database actions such as provisioning, schema migrations, and acknowledgement of destructive migrations before they run in production
Publish detail view with pipeline and pre-publish checks

​
Git-connected apps

For apps connected to Git, publish using the Deploy tab (default branch, e.g. main). Publishing is disabled on the History tab which displays checkpoints for the superblocks/live branch. Publish main branch for git-enabled app For more on Git workflows, see Connect to Git.

​
Restore a checkpoint

Restoring resets the app edit state and Clark’s chat memory to that checkpoint. Messages and checkpoints after the restore point are permanently archived. To restore a checkpoint:
  1. Open the checkpoint in chat or find it in Version history
  2. Choose Restore
  3. Confirm in Restore to checkpoint
If the app uses a managed database, restoring the app does not change schema or data. If later migrations were breaking, the app may fail until the schema is made compatible again.