GitHub Sync

We’ve shipped first-class GitHub Sync, enabling seamless read/write parity between GitHub and Code Storage repositories.

When a repository is created with a baseRepo, Code Storage links it directly to GitHub and treats GitHub as the source of truth. All upstream changes are mirrored into Code Storage, and any writes performed through Code Storage are forwarded back to GitHub automatically.

This unlocks low-latency access to GitHub-backed repos while retaining full access to Code Storage features like diffs, commits, file access, and analytics.

const repo = await store.createRepo({
  baseRepo: {
    owner: 'your-github-org',
    name: 'repository-name',
    defaultBranch: 'main',
  },
});

When baseRepo is specified, the repository provider is automatically set to github.

• GitHub is treated as the source of truth
• Pushes to Code Storage are forwarded to GitHub
• GitHub changes are mirrored back into Code Storage
• Syncs can be triggered manually or automatically via webhooks

GitHub Sync supports webhook-driven updates. You can either:

• Let Code Storage manage webhooks for you, or
• Handle GitHub events yourself and trigger syncs via repo.pullUpstream()

This allows near-real-time propagation of changes without full fetches or polling.

See the docs →