local-development
Installation
SKILL.md
Develop a Site Locally
Every Replo site is a Next.js repository at https://git.replo.app/<siteId>.git.
A local checkout is a second writer of that repository: the Replo editor and the
Replo agent commit to the same main branch you push to.
How Replo treats your pushes
Read this before the first push. It explains how "I only pushed" can still end with a change going live.
| Question | Answer |
|---|---|
| Which branch does Replo use? | Only main. Replo saves, syncs, previews, and publishes main and never reads any other branch. |
| Is there a pull request or review step? | No. Replo repositories have no pull requests, branch previews, or approvals. The review happens before you push to main (see below). |
Does pushing to main publish? |
No. A push only updates the repository. Nothing goes live until someone publishes. |
| Can a pushed commit go live later? | Yes. Replo brings main into its own copy of the site when someone opens the project in Replo, when that copy restarts, and whenever Replo saves its own changes. The next publish — the Publish button, a Replo agent the user asked to publish, or publish_site — builds that copy. Treat a push to main as "ready to publish". |
Does publish_site publish my latest push? |
Not necessarily. It publishes Replo's copy of the site, which may not have picked up a recent push, and it does not take a commit. Verify afterwards (see Publishing). |