{title &&

{title}

}

{children}

; }; Superblocks Version Control makes it easy to track, manage, and deploy changes to your Superblocks applications. Using version control you can: * [**Compare changes**](#compare-changes) against your last commit * [**Commit changes**](#commit) to build a release preview * [**Preview each commit**](#commit-previews) to QA and get feedback from teammates * [**Deploy commits**](#deploy) to make changes available to end-users * [**Redeploy commits**](#redeploy) to easily rollback to previous deployed versions * [**Undeploy**](#undeploy) an app to make it inaccessible to end users * [**Reset editor**](#reset-editor) to quickly undo changes in edit mode ## Compare changes A list of committed changes is displayed in the Versions panel.

A list of committed changes is displayed in the Versions 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 navigation, 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](/building-with-clark/checkpoints) in the Clark 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](/building-with-clark/checkpoints) in the Clark 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.

## 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. Note: changes via **Reset editor** will only impact the application in edit mode. The deployed version of the application will be unaffected. If you need to change the deployed version, see [Redeploy](#redeploy)