diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts index 3513c721d95d2..baa5678f56940 100644 --- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts +++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts @@ -2477,11 +2477,12 @@ export const deployment: NavMenuConstant = { url: undefined, items: [ { name: 'Overview', url: '/guides/deployment/branching' }, - { name: 'GitHub integration', url: '/guides/deployment/branching/github-integration' }, + { name: 'Branching via GitHub', url: '/guides/deployment/branching/github-integration' }, { - name: 'Branching 2.0 (Alpha)', - url: '/guides/deployment/branching/branching-2', + name: 'Branching via dashboard', + url: '/guides/deployment/branching/dashboard', }, + { name: 'Working with branches', url: '/guides/deployment/branching/working-with-branches', diff --git a/apps/docs/content/guides/deployment/branching.mdx b/apps/docs/content/guides/deployment/branching.mdx index dafdb4d0c3714..6749078bc03f0 100644 --- a/apps/docs/content/guides/deployment/branching.mdx +++ b/apps/docs/content/guides/deployment/branching.mdx @@ -12,5 +12,5 @@ Supabase branches create separate environments that spin off from your main proj - **Separate Environments**: Each branch is a separate environment with its own Supabase instance and API credentials. - **Preview Branches**: You can create multiple Preview Branches for testing. - **Persistent Branches**: Persistent branches are long-lived branches. They aren't automatically paused or deleted due to non-inactivity or merging. -- **GitHub integration and Branching 2.0**: You can use branching with the GitHub integration, or use Branching 2.0 to manage your branches without Git (in Feature Preview). +- **Managing Branches**: You can create, review, and merge branches either automatically via our [GitHub integration](/docs/guides/deployment/branching/github-integration) or directly [through the dashboard](/docs/guides/deployment/branching/dashboard) (currently in beta). All branches show up in the branches page in the dashboard, regardless of how they were created. - **Data-less**: New branches do not start with any data from your main project. This is meant to better protect your sensitive production data. To start your branches with data, you can use a [seed file](/docs/guides/deployment/branching/github-integration#seeding) if using the GitHub integration. diff --git a/apps/docs/content/guides/deployment/branching/branching-2.mdx b/apps/docs/content/guides/deployment/branching/dashboard.mdx similarity index 77% rename from apps/docs/content/guides/deployment/branching/branching-2.mdx rename to apps/docs/content/guides/deployment/branching/dashboard.mdx index 06ff6b67a8c35..2d938165736cd 100644 --- a/apps/docs/content/guides/deployment/branching/branching-2.mdx +++ b/apps/docs/content/guides/deployment/branching/dashboard.mdx @@ -1,36 +1,36 @@ --- -title: 'Branching 2.0 (Alpha)' -subtitle: 'Create and manage branches without using Git' +title: 'Branching via the dashboard' +subtitle: 'Create, manage, review, and merge branches directly in the dashboard' --- -Branching 2.0 allows you to create and manage Supabase branches without connecting to a Git repository. This is useful for quick testing, prototyping, or when you prefer to manage your database changes outside of Git. +You can create, manage, review, and merge Supabase branches directly via the dashboard. This is useful for quick testing, prototyping, or when you prefer to work in a no-code way. You can also connect a Supabase branch to a GitHub branch at a later time if needed. -Branching 2.0 is currently in public alpha. Features and functionality may change. +Branch management via the dashboard is currently in public alpha. Features and functionality may change. -## How Branching 2.0 works +## How Branching works -With Branching 2.0, you can do the following directly from the Supabase dashboard: +You can do the following directly from the Supabase dashboard: - Create preview branches - Make changes to your public schema or edge functions - Merge these changes back into production when ready - Pull in updates from production -## Enable Branching 2.0 +## Enable branch management via the dashboard -Branching 2.0 is available as a Feature Preview. To enable Branching 2.0 in the Supabase Dashboard: +This functionality is currently in beta and requires opting in. To opt in you must enable the feature preview: 1. Open the user menu by clicking on your user icon in the top right. -1. Select **Branching 2.0**. +1. Select **Branching via dashboard**. 1. Click **Enable feature**. ## Creating a branch -Once you've enabled Branching 2.0, you can create a new branch: +Once you've enabled the feature, you can create a new branch: 1. Click the arrows next to the branch name in the top menu bar. (The top menu bar has the format `YOUR_ORGANIZATION / YOUR_PROJECT / CURRENT_BRANCH_NAME`.) 2. Click `Create branch`. diff --git a/apps/studio/components/interfaces/App/FeaturePreview/Branching2Preview.tsx b/apps/studio/components/interfaces/App/FeaturePreview/Branching2Preview.tsx index 88911c2d4b027..6aba6698b34a2 100644 --- a/apps/studio/components/interfaces/App/FeaturePreview/Branching2Preview.tsx +++ b/apps/studio/components/interfaces/App/FeaturePreview/Branching2Preview.tsx @@ -14,9 +14,8 @@ export const Branching2Preview = () => { className="rounded border mb-4" />

- Branching 2.0 introduces a new workflow for managing database branches without having to use - Git. Create branches, review changes and merge back into production all through the - dashboard. Read the below limitations and our{' '} + Create branches, review changes, and merge back into production all through the dashboard. + Read the below limitations and our{' '} branching documentation {' '} @@ -52,11 +51,10 @@ export const Branching2Preview = () => {

Enabling this preview will:

diff --git a/apps/studio/components/interfaces/App/FeaturePreview/FeaturePreview.constants.tsx b/apps/studio/components/interfaces/App/FeaturePreview/FeaturePreview.constants.tsx index 4433c5b389546..067fa678f46ad 100644 --- a/apps/studio/components/interfaces/App/FeaturePreview/FeaturePreview.constants.tsx +++ b/apps/studio/components/interfaces/App/FeaturePreview/FeaturePreview.constants.tsx @@ -10,7 +10,7 @@ export const FEATURE_PREVIEWS = [ }, { key: LOCAL_STORAGE_KEYS.UI_PREVIEW_BRANCHING_2_0, - name: 'Branching 2.0', + name: 'Branching via dashboard', discussionsUrl: 'https://github.com/orgs/supabase/discussions/branching-2-0', isNew: true, isPlatformOnly: true, diff --git a/apps/www/lib/redirects.js b/apps/www/lib/redirects.js index 5955e6143068e..a75ed33b34ff8 100644 --- a/apps/www/lib/redirects.js +++ b/apps/www/lib/redirects.js @@ -2021,6 +2021,11 @@ module.exports = [ source: '/docs/guides/platform/database-usage', destination: '/docs/guides/platform/database-size', }, + { + permanent: true, + source: '/docs/guides/deployment/branching/branching-2', + destination: '/docs/guides/deployment/branching/dashboard', + }, { permanent: true, source: '/docs/guides/resources/postgres/dropping-all-tables-in-schema',