🐙 GitHub Integration

Connect your own GitHub repos so SaaSClaw can build and deploy them.

Overview

SaaSClaw connects to GitHub through a GitHub App. You install the app on your own GitHub account or organization, and SaaSClaw gets scoped access to only your repos.

💡 Your repos, your permissions. SaaSClaw can only access repos you explicitly grant. Other users on the same SaaSClaw instance can never see or use your GitHub installations.

How It Works

1. Admin configures the GitHub App (one-time setup) 2. You install the app on your GitHub account or org 3. GitHub notifies SaaSClaw → installation is linked to your account 4. Your repos appear in the project wizard 5. The wizard builds your app, commits, and pushes changes 6. SaaSClaw deploys using your installation token

Setting Up GitHub

Step 1: Install the App

Go to GitHub Setup from the app navigation, or visit the setup page directly.
Click the install link — this opens GitHub's installation flow.
Choose which account or organization to install on.
Select All repositories (recommended) or only specific repos.
Click Install.

Step 2: Verify

After installing, return to the GitHub Setup page. Your installations should appear within a few seconds. Each installation shows:

Account name — the GitHub org or user the app is installed on
Installation ID — internal identifier

⚠️ If installations don't appear: GitHub delivers the webhook asynchronously. Wait 30 seconds and refresh. If it still doesn't show, check with your SaaSClaw admin that the webhook URL is reachable.

Step 3: Use It in a Project

Create a new project (or open an existing one).
In the project settings, select GitHub as the repo provider.
Choose one of your installations and enter the repo name.
The wizard can now read, write, commit, and push to that repo.

FAQ

Can I use my own GitHub repos?

Yes — that's exactly how it works. You install the GitHub App on your account, and SaaSClaw gets access to your repos. Your repos stay in your GitHub account.

Can other users see my repos?

No. Installations are scoped per-user. Other users can only see and use their own GitHub installations, never yours.

What permissions does the app need?

Contents (read & write) — to clone, commit, and push. Metadata (read-only) — to identify installations. That's it.

Can I connect multiple repos or orgs?

Yes. Install the app on each org or account you want to use. Each installation appears separately on the GitHub Setup page, and you can pick which one to use per project.

What if I uninstall the app from GitHub?

GitHub fires an uninstall webhook and SaaSClaw automatically removes the installation and all associated repo records. Existing projects keep their code — they just won't be able to push new changes until you reconnect.

Does SaaSClaw store my GitHub credentials?

No personal access tokens or passwords are stored. SaaSClaw uses the GitHub App's installation tokens, which are short-lived and generated on-demand.