RepoPress documentation

Learn how RepoPress adds visual MDX authoring, reusable components, safe previews, and reviewable publishing to GitHub repositories.

RepoPress gives authors a visual Studio, structured frontmatter controls, reusable MDX components, and a reviewable publish workflow without moving published content out of Git.

Note: Your repository remains the source of truth for published content. RepoPress keeps drafts and workflow state in Convex until you publish a reviewed Git commit.

Start here

• Getting started — connect your first repository and open Studio.
• How RepoPress works — understand Git, draft, and publish authority.
• Connect a repository — choose a branch and content root safely.
• Use the Studio editor — edit frontmatter, Markdown, and MDX components.

Build on the platform

• Platform architecture — authority boundaries and the publish lifecycle.
• Component authoring — expose product components without coupling RepoPress to one framework.
• Preview security — compare Generic and Compatible preview fidelity.
• Build a component extension — add a production component, authoring contract, fixture, and safe preview mapping.

RepoPress is framework-neutral at its core. A Next.js, Astro, Blume, Fumadocs, or custom site keeps its own runtime implementation while sharing ordinary Markdown/MDX and declarative authoring metadata with Studio.