Use Source Control with apps

Manage apps with source control, including Git integration and version history.

Source Control lets organizations manage changes using remote SCM providers GitHub, GitLab, AWS CodeCommit, Bitbucket, and Azure Repos. Using this distributed approach, your users can:

• Prevent unwanted changes to apps.
• Work collaboratively and methodically through reviews.
• Edit React code from your preferred development environment.

Capabilities and limitations

The following tabs show a summary of the current capabilities of the app builder. Limitations describe functionality that isn't yet supported in apps but may exist in classic apps.

Capabilities

• Protect an app by connecting it to a source control manager.
• Use threads to develop changes on dedicated branches.
• Let the agent detect, reason about, and resolve merge conflicts with git commands.
• Explicitly tag releases as the published version.

Limitations

Some functionality is not currently supported:

• Multiple builders editing the same branch simultaneously.
• Multi-instance releases.
• Branches created outside of Retool, such as in a local development environment.
• Org-level theme syncing to external source control repositories.
• Source Control instance management through the Retool API.

Get started

To get started, first configure protection for your app, then learn how to edit and publish your app.

Protect apps

Learn how to protect apps with Source Control.

Edit and publish protected apps

Publish apps, create new releases, and restore previous versions with Source Control.