Skip to main content
Using version control you can:
  • Track versions as Clark checkpoints
  • Preview a version before it goes live
  • Publish a version to production
  • Roll back by publishing an earlier version
  • Undeploy an app so end users cannot access it
  • Restore the editor and chat to an earlier checkpoint
  • Use Git for PR-based workflows when the app is connected to a repository

Track versions

After each Clark prompt completion, Superblocks saves a checkpoint. To see your app’s checkpoints, open Clark AI, then click the Version history icon in the Clark header. Version history in the Clark panel

Preview

From a checkpoint in chat or version history, click Preview. Superblocks builds a shareable preview of that version so you can QA without changing production.

Publish

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. Click View publish details from a previewed / published checkpoint card, or click any previewed / published version in history to watch build progress, review errors, and complete pre-publish security or database actions. Publish detail view

Roll back

To revert production to a previous version, publish the desired older checkpoint from Version history. End users of the app will now see the earlier version the next time they refresh or load the app.

Undeploy

You can Undeploy an application to make it temporarily unavailable to end users. To undeploy an application:
  1. Open Version history in Clark
  2. Open the menu on the Live version
  3. Click Undeploy and confirm
Undeploy an app Afer undeploying, the application is no longer accessible to end users. You can keep working in edit mode and publish again when ready.

Restore

You can Restore an application in order to discard later edit-mode work and reset Clark’s chat memory to an earlier point. To restore an application:
  1. Open the checkpoint in chat or find it in Version history
  2. Choose Restore
  3. Confirm in Restore to checkpoint

Git-connected apps

When an app is connected to Git:
  • Edits happen on superblocks/live
  • You commit and open pull requests in your repository
  • After merging to your default branch and the CI sync completes, publish from the Deploy tab in Clark version history (not from the History / superblocks/live list)
Publish main branch for git-enabled app For more on Git workflows, see Connect to Git.