Skip to content
Primio Docs

GitHub

GitHub integration connects a Primio project to a GitHub repository so you can keep a version-controlled copy of the app’s generated source code outside Primio.

This is separate from signing in with GitHub. Using GitHub as a login method only authenticates your Primio account; it does not connect any project to a repository. Repository sync is configured per project from the workspace.

What GitHub integration does

Section titled “What GitHub integration does”

When you connect a project, Primio asks GitHub for permission to use the Primio GitHub App. After authorization, Primio can create or link a private repository for that project and push the current project source code.

After the first connection, you can push again whenever your Primio project changes. Each push sends the current generated source snapshot to the connected repository, creating a new commit when there are changes.

Connect a project to GitHub

Section titled “Connect a project to GitHub”

  1. Open the project you want to connect.

  2. In the workspace, open GitHub from the workspace menu. You may also see a GitHub button in the top bar.

  3. Click Connect GitHub.

  4. A GitHub popup opens. Sign in if needed, authorize GitHub access, and install or select the Primio GitHub App for the account or organization that should own the repository.

  5. Return to Primio after the popup closes. Primio refreshes the GitHub status and shows the connected account, repository, and branch when setup succeeds.

During setup, Primio either creates a new private repository for your project or connects to an existing repository that matches the generated project repository name. If a new repository is created, Primio also pushes the current code as part of the setup.

Push code to GitHub

Section titled “Push code to GitHub”

Once connected, the GitHub button changes from GitHub to Push in the top bar. You can also open the GitHub workspace page and click Push code to GitHub.

Primio compares the current project source with the repository before pushing:

  • If the project has changed, Primio creates a commit and pushes it to the main branch.
  • If there are no changes, Primio tells you that GitHub is already up to date.

You can also ask the Primio agent to push or sync the project to GitHub. When the project is connected, the agent can trigger the same push flow for the current project revision.

Disconnect GitHub

Section titled “Disconnect GitHub”

Open the GitHub workspace page and click Disconnect to remove the connection between Primio and the repository.

Disconnecting stops Primio from pushing future changes to that repository. It does not delete the GitHub repository, remove previous commits, or uninstall the Primio GitHub App from GitHub.

Limitations

Section titled “Limitations”
  • Paid plan required - connecting a repository and pushing code require an active paid subscription. Disconnecting an existing GitHub connection is available on every plan, including Free.
  • No import from GitHub - GitHub integration pushes Primio-generated code to GitHub. It does not pull code changes from GitHub into Primio or create a Primio project from an existing repository.
  • One connected repository per project - each Primio project syncs to its own connected repository on the main branch.
  • Fixed main branch - Primio always pushes to the main branch. You cannot choose or change the target branch from Primio.
  • Disconnected repositories stay in GitHub - use GitHub directly if you want to delete the repository or change GitHub App installation settings.
  • Suspended GitHub App installations block pushes - if GitHub shows the Primio App as suspended, re-enable it in GitHub before pushing again.

Troubleshooting

Section titled “Troubleshooting”

The GitHub popup did not open. Allow popups for Primio in your browser, then click Connect GitHub again.

The connection did not finish after authorization. Refresh the GitHub status in Primio. If it still shows as not connected, start the connection again and make sure the Primio GitHub App is installed for the correct personal account or organization.

Push says GitHub is already up to date. Nothing needs to be done. Primio checked the current source code and found no changes to commit.

Primio says a subscription is required. Connecting or pushing to GitHub requires the Build or Scale plan. Upgrade to an active paid subscription, then retry the same GitHub action. You can still disconnect an existing repository on the Free plan.

Push fails after a previously working connection. Open the GitHub page in the workspace and refresh the status. Check whether the repository still exists, the Primio GitHub App is still installed, and the app installation has not been suspended in GitHub.

Section titled “Related”