GitHub Integration
This document explains how to deploy an app by integrating Squadbase with GitHub.
Squadbase integrates with GitHub to automate CI/CD for your apps.
There’s no need to build complex infrastructure or set up CI/CD pipelines yourself—simply deploy safely from the dashboard and deliver your app to the team.
How to connect
Connecting Squadbase to GitHub takes just a few simple steps.
Set up the GitHub connection
From the dashboard, connect your GitHub account and install the Squadbase app in your Organization.
Create squadbase.yml
Add squadbase.yml to the target repository.
Select repository and branch
In the dashboard, choose the repository and branch you want to deploy, then start the deployment.
If your Organization or repository does not appear, see Troubleshooting.
Access your app
Once the deployment is complete, you can open the app from the dashboard.
After you connect GitHub once, every push to the linked branch is deployed automatically.
Changing the root directory or the path to squadbase.yml
In Advanced Settings, you can change the Root directory path and Setting file path to point to a different project root or a different squadbase.yml.
The project root is the directory where your application is built.
- Root directory path: path from the repository root
- Setting file path: path relative to Root directory path
Deploying multiple apps from a single repository
If a single repository contains multiple apps as shown below, you can deploy each one by specifying its root directory and the path to its squadbase.yml.
Example deployment settings
| App name | Root directory path | Setting file path |
|---|---|---|
| User analytics dashboard | analytics_dashboard | squadbase-user-analytics.yml |
| Product analytics dashboard | analytics_dashboard | squadbase-product-analytics.yml |
| Chat app | chat_app | squadbase.yml |
Changing settings
You can update the GitHub connection or the app’s sub-domain from Settings in the dashboard.
When you change a setting, a new deployment will be triggered so that the changes take effect.
Tips: GitHub integration troubleshooting
Here are some fixes for common issues when integrating with GitHub.
Repository not showing up
If the repository you are looking for is missing from the list, make sure access to that repository is allowed in Repository access settings.
Organization not showing up
If your Organization does not appear in the list, check the following:
- Go to the Organization’s page on GitHub
- Open Settings
- Select Third-party Access → GitHub Apps
- Verify that Squadbase is listed under Installed GitHub Apps
