Skip to main content
Connect your Base44 app to GitHub for version control and local development. Which you use depends on your workspace:
  • Sync: For personal workspaces. Edit code locally and keep changes in sync with Base44 in both directions.
  • Export: For shared workspaces. Push your code to GitHub for backups, version history, or external deployment. One-way only.

​
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 2-way sync is only available for personal workspaces.
GitHub connection prompt showing permanent sync setup.
Important:
  • GitHub 2 way sync requires the Builder plan or higher.
  • GitHub 2-way sync is supported in personal workspaces only.
  • 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. 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.

​
Export your app to GitHub

Export your Base44 app to GitHub to manage code versions, collaborate with others, and deploy your app externally. This creates a repository in GitHub with your app’s code and you can push updates from Base44 Builder.
Note: Exporting to GitHub requires the Starter plan or higher.
Export your app to GitHub from the dashboard
To export your app to GitHub:
  1. Open your app’s Dashboard.
  2. Click the GitHub icon in the top panel.
  3. Click Export to GitHub.
  4. Click Invite Yourself as Collaborator.
  5. Enter your GitHub username and click Invite.
  6. Open the invite email from GitHub and accept it to access your app’s repository.

​
Update your app repository

Once your app is exported, GitHub doesn’t sync automatically. When you make updates in Base44, push your latest changes to GitHub using Update Repository. You can also invite collaborators to work in GitHub. To update your GitHub repository:
  1. Open your app’s Dashboard.
  2. Click the GitHub icon in the top panel.
  3. Click Update Repository.
Update your GitHub repository from the dashboard

​
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