GitHub
Sync a project to a real repository, push branches, and review PRs.
Every Contrast project starts in Contrast. GitHub sync is an optional bridge. It pushes your project branches to a repo as pull requests and imports PRs back as review sessions. It does not import an arbitrary repo into a project, and it is separate from rnx PR previews, which live in rnx.
Connect a repo
Open Project Settings → GitHub. The status line tells you where you are. It moves from No repo linked to Repo linked, waiting for app install to App installed on owner/repo.
- Link the repo. Enter it as
owner/repo, an HTTPS URL, or an SSH URL, then press Link. - Install the Contrast app. Press Install Contrast app and approve it on the repo. Installing from the GitHub Marketplace alone won’t attach the repo to a project. Link it here first so the install carries your project.
- Test the connection. Testing confirms push access and shows the repo’s default branch.
Push branches and open PRs
Once connected, your sessions map to Git branches:
- The main session tracks the repo’s default branch. Push main branch pushes it straight to the base branch. It does not open a PR.
- Every other session pushes to
contrast/session-<name>and opens or updates a pull request titled<session name> (Contrast).
From a branch’s review dialog the primary action adapts to the branch state:
| State | Action |
|---|---|
| Clean or ahead | Push branch (ahead branches also offer Merge into main) |
| Behind | Pull branch |
| Diverged | Update from main |
| Conflicted | None: resolve the files first |
A conflicted branch has no one-press action. The review dialog lists the conflicted files and you author the resolved version yourself; Contrast never writes conflict markers into your files or guesses a resolution.
Merging defaults to a squash, then pulls the base branch back into your main session so the workspace reflects post-merge truth.
Import a PR for review
Open PRs on the linked repo show up in Project Settings with Import branch. Importing turns a PR into a Contrast review session with the same editor, preview, and agent tools as any branch, so you can review and iterate on it in the workspace. New PRs can also be imported automatically.
Contrast stays the workspace of record. GitHub is where the review and merge happen.