Skip to content

feat(postgres): add doc on branching, link migration gist#6347

Merged
Amogh-Bharadwaj merged 5 commits into
mainfrom
pg-branching
Jun 8, 2026
Merged

feat(postgres): add doc on branching, link migration gist#6347
Amogh-Bharadwaj merged 5 commits into
mainfrom
pg-branching

Conversation

@Amogh-Bharadwaj

@Amogh-Bharadwaj Amogh-Bharadwaj commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds doc on branching (PITR) for Managed Postgres and a link to migrating off of Supabase

Checklist


Note

Low Risk
Documentation-only changes (new page, sidebar entry, style exception, external link); no application or infrastructure code.

Overview
Adds Managed Postgres branching documentation and wires it into the docs site, plus a Supabase migration pointer on the migrations overview.

The new Branching guide explains PITR-based branches as independent PostgreSQL deployments (backup restore + WAL replay, not copy-on-write), with sections on use cases, separate branch sizing, expected creation time, guidance to prefer local dev over per-developer production branches, and a recommended workflow diagram linking to local development.

The Data migration overview gains a Migrating from Supabase section that links to an external step-by-step guide on GitHub. Navigation adds cloud/managed-postgres/branching after backup-and-restore, and Supabase is added to heading capitalization exceptions.

Reviewed by Cursor Bugbot for commit 193ea02. Bugbot is set up for automated code reviews on this repo. Configure here.

@Amogh-Bharadwaj Amogh-Bharadwaj requested a review from a team as a code owner June 4, 2026 20:19
@vercel

vercel Bot commented Jun 4, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jun 8, 2026 9:30am
clickhouse-docs-jp Building Building Preview, Comment Jun 8, 2026 9:30am
3 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-ko Ignored Ignored Preview Jun 8, 2026 9:30am
clickhouse-docs-ru Ignored Ignored Preview Jun 8, 2026 9:30am
clickhouse-docs-zh Ignored Ignored Preview Jun 8, 2026 9:30am

Request Review

@Amogh-Bharadwaj Amogh-Bharadwaj changed the title feat(postgres): add doc on branching feat(postgres): add doc on branching, link migration gist Jun 4, 2026

## Migrating from Supabase {#supabase}

If you're migrating from Supabase, see the [Supabase to Managed Postgres migration guide](https://github.com/iskakaushik/supa-auth-migrate/blob/main/MIGRATION.md) for a step-by-step walkthrough.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Amogh-Bharadwaj can I help bring this to our docs?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure @Blargian that would be great! Maybe in a separate PR then :)
I can take it up too

Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
Comment thread docs/cloud/managed-postgres/branching.md Outdated
@Amogh-Bharadwaj Amogh-Bharadwaj merged commit c030f0b into main Jun 8, 2026
18 checks passed
@mintlify

mintlify Bot commented Jun 8, 2026

Copy link
Copy Markdown

Docs PR opened: ClickHouse/mintlify-docs-dev#135

Added a Managed Postgres branching guide and a Supabase migration link to the migrations overview.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants