Set up GitHub integration to edit your Base44 app locally and sync changes automatically.

Sync your app with GitHub

Connect your app to GitHub to write code in your local development environment or in Base44 and keep them in sync with each other.

To sync your app with GitHub:

1. Click Dashboard in your app editor.
2. Click the GitHub icon at the top-right and click Connect to GitHub.
3. Click Connect GitHub.
4. Click Authorize Base44 Builder.
5. Choose where to install the Base44 Builder:
   • Select the GitHub organization or account.
   • Choose which repositories to allow access.
6. Click Install.
7. Create a repository for your app:
   • Choose the GitHub organization or account.
   • Enter a name for the new repository.
   • Click Create Repository.

Set up your local development environment

After connecting to GitHub, set up your local repository to start editing code in your preferred development environment. To set up your local repository:

1. Clone the repository using the project’s Git URL.
2. Navigate to the project directory.
3. Install dependencies: npm install.
4. Create an .env.local file and set the environment variables: Example:

Run the app locally:

For details on the exported file structure, see Project Structure.

Sync local changes to Base44

To sync your local changes to Base44, merge the changes to the main git branch. This branch must be named main. Other default branch names, such as master, currently aren’t supported. The changes will then be visible on your Base44 app.

Invite collaborators

Invite teammates to work on your app’s GitHub repository. To invite collaborators:

1. Open your app’s Dashboard.
2. Click the GitHub icon in the top panel.
3. Click the Invite Collaborator tab.
4. Enter their GitHub username.
5. Click Invite.

Disconnect from GitHub

You can disconnect a specific app from its GitHub repository or disconnect your GitHub account from Base44 entirely.

Disconnect your repository

Disconnect your app from its GitHub repository if you no longer want to sync changes. To disconnect your repository:

1. Open the code tab.
2. Click GitHub.
3. Click the More Actions icon .
4. Click Disconnect.

The disconnect process takes approximately 30 seconds and is only available when the AI agent is not actively making changes to your app.

Disconnect your GitHub account

Disconnect your GitHub account if you no longer want to create new repository connections. This does not affect any repositories already connected to your apps and they will continue to sync normally. You can reconnect this account or connect a different GitHub account later. To disconnect your GitHub account:

1. Go to Account settings.
2. Find the GitHub account section.
3. Click the More Actions icon .
4. Click Disconnect.