Connecting a Repository

RepoPress connects to your GitHub repositories to read and write content. This guide covers everything from initial authentication to advanced configuration.

What we ask for when you sign in

When you sign in with GitHub, RepoPress requests permission to:

  • Read access to your repositories - to fetch file trees and content.
  • Write access to your repositories - to commit published changes back to Git.
  • User profile - to display your name and avatar in the dashboard.

RepoPress never stores your GitHub password. We use short-lived access tokens that you can revoke at any time from your GitHub Settings.

Selecting a Repository

After signing in, navigate to the dashboard. You’ll see a list of all repositories accessible to your GitHub account - both personal and organization repositories. Click on any repository to begin setting up a project.

Choosing a content folder

The content folder tells RepoPress where your editable files live. Common locations include:

  • content/ - Hugo, Gatsby, and many static site generators
  • src/content/ - Astro content collections
  • app/ - Next.js co-located MDX pages
  • posts/ or blog/ - Custom blog directories

You can change the content folder at any time from project settings. Only files inside this folder appear in the Studio editor.

Automatic framework detection

RepoPress looks at your repository to identify which site framework you use. Currently supported:

  • Next.js - Detected via next.config.js or next.config.mjs
  • Astro - Detected via astro.config.mjs
  • Hugo - Detected via hugo.toml or config.toml
  • Gatsby - Detected via gatsby-config.js

If your framework is not detected automatically, you can set the content folder and file types manually during project setup.

Multiple projects from one repository

You can create multiple RepoPress projects from the same GitHub repository. This is useful when you have different content areas - for example, a blog/ directory and a docs/ directory that you want to manage separately. Each project can have its own content root, collaborators, and publishing settings.

Private repositories

RepoPress works with private repositories. If your GitHub account has access to the repository, you can connect it the same way you would a public one. Content is fetched through authenticated requests and is not stored on our servers beyond your current editing session.

Now that your repository is connected, learn how to use the Studio Editor →