Skip to main content

Version Control

Superblocks Version Control makes it easy to track, manage, and deploy changes to your Superblocks Applications, Workflows, and Scheduled Jobs from one place.

Using Version Control you can:

  • Commit changes so they’re saved and can be reviewed
  • Deploy commits, making them available to end-users
  • Rollback to previously deployed commits

Commit​

After you’ve made changes in Superblocks, you can create a commit.

Commits are like named snapshots of your Application, Workflow, or Scheduled Job. Creating commits often as you complete small units of work makes it easy to track what’s been done and what will be deployed when you’re ready to release.

Create a new commit

To create a commit:

  1. Navigate to your Application, Workflow, or Scheduled Job
  2. Click on the Version Control panel icon
  3. Enter a commit message into the text box
  4. Click Create new commit

This will create a snapshot of your Application, Workflow, or Scheduled Job at this point in time.

If your changes are ready to be deployed, you can continue to Deploy your commit, or continue making additional changes before you deploy.

Deploy​

Once you’re happy with your changes and ready to make them live for all of your end-users, deploy your changes.

Deploy a commit

To deploy your changes:

  1. Navigate to your Application, Workflow, or Scheduled Job
  2. Click the Version Control panel icon
  3. Choose the commit that represents the version of your Application, Workflow, or Scheduled Job you want to deploy
  4. Click Deploy to make the commit live

You can always see which commit is currently deployed. It’ll be highlighted and marked with a Live badge.

If you want to quickly push your changes directly to Deploy mode without committing first, just click the Deploy button on the upper right of the screen. You’ll be prompted to provide a commit message. Your changes will be automatically deployed and made available to end-users.

Commit and deploy changes simultaneously

Rollback​

Deployed a bug and need to rollback? To rollback, simply redeploy your last commit.

  1. Navigate to the Version Control panel
  2. Find the previous commit you want to make live again
  3. Click Redeploy to make the commit live again for your end-users

Reset Editor​

If you ever find yourself in a situation where you want to completely discard changes you’ve made to your Application, Workflow, or Scheduled Job, you can discard changes by resetting the editor.

To reset your editor:

  1. Navigate to the Version Control 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, Workflow, or Scheduled Job at that specific commit.

info

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 Rollback.