Skip to main content

GitHub integration

Connecting your TatbiQ project to GitHub gives you version control and a backup of your code in your own GitHub account. Once connected, TatbiQ keeps your repository up to date as your app changes, and you stay in full control of your code.

The TatbiQ GitHub settings with options to connect a GitHub account and project repository
Connect your GitHub account, then link your project to a repository from the GitHub settings.

What you need​

  • A GitHub account. If you do not have one, create a free account at github.com.
  • A TatbiQ project.

Connecting to GitHub​

Connecting happens in two steps: first you authorize your GitHub account, then you connect your project to a repository.

Step 1: Connect your GitHub account​

Open your project and go to Settings, then select GitHub.

Select Connect GitHub Account.

A GitHub window opens where you authorize TatbiQ. If your browser blocks the pop-up, TatbiQ continues the sign-in in the same window and returns you to your project afterwards.

After you authorize, you are brought back to your project and your account shows as authenticated.

You can also start this from the Go Live wizard, which includes a GitHub step while you publish your app.

Step 2: Connect your project to a repository​

Still in Settings under GitHub, find the Project Repository section.

Select Connect Project.

TatbiQ creates a new private repository for your project, or links to an existing one if a matching repository is already in your account.

Your project is fully connected once both your GitHub account is authorized and a repository is linked.

If you belong to GitHub organizations, you can use Manage Accounts to choose which account or organization the repository should live in before you connect your project. Once a repository is linked, the account selection is locked for that project.

Keeping your code in sync​

TatbiQ syncs your code to GitHub using checkpoints, which are the snapshots TatbiQ saves as your app changes. See Checkpoints to learn how checkpoints work.

  • Automatic sync: when Automatic Sync is on, TatbiQ pushes each new checkpoint to your repository automatically. This is the default.
  • Manual sync: select Sync to GitHub at any time to push the latest changes yourself.

You can view the connected repository at any time with View on GitHub, and the Sync Status shows when your project was last synced.

Disconnecting​

To stop syncing, select Disconnect in the GitHub settings. This removes the link between your project and its repository but keeps your GitHub account authorized, so you can reconnect later. Your code already pushed to GitHub stays in your repository.

CheckpointsSee how TatbiQ snapshots your project as you build.Supabase integrationAdd a database, authentication, and backend to your app.Custom domainsConnect your own domain to your published app.