Connect your website
Connecting a website lets your team change its words and photos right on the page, from Erre OS. Each publish is saved to the site’s code on GitHub, and your host puts it live the way it already does.
You need:
- An owner or admin role in the workspace.
- A site whose code is in a GitHub repository, and a host that builds it from a branch of that repository.
- Access to install a GitHub app on the GitHub account or organization that owns the repository.
Connect
Section titled “Connect”- Open Websites in the sidebar.
- Under Give Erre OS access on GitHub, click Connect GitHub.
- GitHub asks where to install the Erre OS app. Pick the account that owns your site, then choose Only select repositories and pick your site’s repository.
- GitHub sends you back to Erre OS. The first step now says Connected as and your GitHub account.
- Under Pick your website, fill in:
- Repository: your site’s repository.
- Branch: the branch your host puts live. Usually
main. - Web address: your site’s address, for example
example.com. Leave it empty if this branch only builds previews.
- Click Connect website.
The editor opens on your site’s home page. It lists the site’s other pages from its sitemap.
What Erre OS can reach
Section titled “What Erre OS can reach”The Erre OS app asks GitHub for three permissions on the repositories you chose: read and write the code, read deployments, and read the repository’s basic details. Erre OS uses them for one repository, the one you connected.
Erre OS only changes two kinds of files: the site’s text files under src/data/, and photos that already exist under public/ or src/assets/. Every publish is a normal commit on your branch, with a message naming who made the change. Nothing is force-pushed, so your developer’s own commits are never overwritten.
To let Erre OS reach a different repository, click Change which repositories under the first step.
Disconnect
Section titled “Disconnect”- In the Websites editor, open the menu next to View website. It shows Publishes to and the repository.
- Click Disconnect website, and confirm.
That removes the site and the GitHub connection from your workspace. The Erre OS app stays installed on GitHub until you uninstall it there, under your account’s Settings, then Applications.
Preparing a site
Section titled “Preparing a site”Your developer marks which words and photos can be changed, with a few attributes and one script. While Websites is in early access, the Erre OS team prepares your site with you.
Websites explains how editing and publishing work.