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 branches to develop changes. Each branch can have one or multiple threads.
• Let the agent detect, reason about, and resolve merge conflicts with git commands.
• Explicitly tag releases as the published version.
• Support for collaborative branches

Limitations

Some functionality is not currently supported:

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

Building environments

Transition between an external coding environment and Retool's app builder.