Skip to main content
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.
GitHub connection prompt showing permanent sync setup.
Important:
  • GitHub 2 way sync requires the Builder plan or higher.
  • Only app owners can perform the initial connection to a repository.
  • To reconnect in case of a connection issue, you must be either an app owner or the user who originally connected the repository.
  • If you previously connected to GitHub using the legacy Export to GitHub 1-way integration, click Looking for the old setup? in the GitHub panel to disconnect it and reconnect using 2-way sync.
  • When you connect your app to GitHub, your changes are synced to the connected repository automatically. There’s no option to manually push updates from your Base44 app to GitHub.
  • GitHub sync is permanent. You can’t disconnect or transfer the project back to Base44.
  • After you connect GitHub to your app, you cannot use Version History to revert to versions from before the GitHub integration. Those older versions are not stored in your GitHub repository, so trying to revert to them results in an error. Only versions that exist in the connected GitHub repo are available to restore.
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.
After connecting, click the GitHub icon in the top panel, then click Go to Repository.
GitHub showing Connected status and a Go to Repository button.

​
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: 
    VITE_BASE44_APP_ID=your_app_id
VITE_BASE44_APP_BASE_URL=your_backend_url
    Example: 
    VITE_BASE44_APP_ID=cbef744a8545c389ef439ea6
VITE_BASE44_APP_BASE_URL=https://my-to-do-list-81bfaad7.base44.app
Run the app locally: 
npm run dev
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.
After syncing, click Publish in the top right corner of your Base44 app to make the changes live for users.

​
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.
Invite collaborators to your GitHub repository

​
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.
After disconnecting, you cannot reconnect to the same repository. If you want to reconnect to GitHub later, you’ll need to use a different repository name.

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