How Acrosite uses GitHub access
Acrosite connects through a scoped GitHub App, commits only to the repositories and paths you choose, and keeps installation tokens server-side — never in your browser.
Acrosite publishes by committing to your GitHub repository, so it needs repository access. It is designed to keep that access scoped, server-side, and revocable. This page explains how Acrosite uses GitHub access and what it does not do.
Who this is for
Workspace Owners and Developers who want to understand Acrosite's GitHub access before connecting a repository.
A scoped GitHub App, not a token
Acrosite connects through the Acrosite GitHub App, not a personal access token. When you install it, you choose exactly which repositories it can access. The connection is managed from your GitHub installation settings, where you can change or remove it at any time. See Connect GitHub.
What the access is used for
The GitHub access lets Acrosite:
- Read your repository list and verify the repository and branch you choose.
- Read the Markdown and MDX files in your content folders when you import existing content. Importing never writes to your repository, and it stops before it would use up the GitHub requests that publishing needs.
- Read the build status your host and other checks report to GitHub for the commits Acrosite published, using the App's read-only Checks and Commit statuses permissions. Acrosite keeps the reported status names, states and host links, and writes nothing to GitHub or your host.
- Commit content and media to the managed paths when you publish.
- Remove the one file Acrosite manages for an item, the file it published or the file you imported and linked, when you unpublish it or when its published address changes, and only if that file is unchanged since Acrosite recorded it.
It writes only to the managed content paths — it does not install a CMS runtime, package, or app folder into your repository.
Tokens stay server-side
You can revoke access
Because access is a GitHub App installation, you stay in control: open your GitHub installation settings to adjust which repositories Acrosite can reach, or remove the installation entirely.