Skip to main content
Superblocks Version Control makes it easy to track, manage, and deploy changes to your Superblocks applications. Using version control you can:

​
Compare changes

A list of committed changes is displayed in the Version Control Panel. Superblocks Edit mode is where you build and iterate on your application. Edits can be reviewed before committing, helping you understand what changes will be introduced in your next commit. To review what’s changed, click on the Versions icon in the left naviation, and find the Uncommitted changes section under the Commit tab.

​
Commit

Once you’ve made all the updates you want, commit your changes to create a named version of your application. You can create a commit from the Versions panel or directly from a checkpoint in the Clark chat.
Commit from versions panel
Commit from chat
Creating a commit will clear out any uncommitted changes and create a named commit that can be previewed and deployed. Committing often makes it easy to share and get feedback on changes as you iterate on tools you build in Superblocks.

​
Commit previews

Every commit in Superblocks triggers the build of a dedicated commit preview. Commit previews let you test and review changes using a live interactive environment without deploying and impacting your end-users. To open a commit preview:
  1. Click the Versions icon
  2. Scroll down to Committed changes
  3. Click the menu icon for the commit you want to view
  4. Click Preview
This will open that commit’s preview environment at a dedicated URL that you can share with your team to review and get sign-off before changes are deployed.

​
Deploy

Once you and your team are happy with your changes, make them live for all users by deploying. You can deploy from the Versions panel Committed changes section or directly from a checkpoint in the Clark chat.
Deploy from versions panel
Deploy from chat
To see the currently deployed commit, just look for the commit with the Live badge.

​
Redeploy

See history of deployments Deployed a bug and need to rollback? No problem, just redeploy your last commit.
  1. Click on the Versions icon in the left nav
  2. Go to the Deployments tab
  3. Open the menu on the second commit in the list
  4. Click Redeploy
This will rollback to the commit that was live just before your most recent deployment.

​
Undeploy

If you ever need to temporarily make an app unavailable to end users, you can undeploy the app.
  1. Click on the Versions icon in the left nav
  2. Go to the Deployments tab
  3. Open the menu on the first live commit in the list
  4. Click Undeploy
Upon confirmation, the app will no longer be accessible to end users, but you can still work on it in edit mode.
Undeploy an app
Confirm undeploy

​
Reset editor

If you ever find yourself in a situation where you want to completely discard changes you’ve made to your application, you can discard changes by resetting the editor. To reset your editor:
  1. Navigate to the Versions panel
  2. Find the commit you want to reset the editor to. This can be your last commit (this will discard all uncommitted changes) or an older commit
  3. Click Reset editor
The Superblocks editor will reload to the state of your application at that specific commit.