diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts index 3513c721d95..baa5678f569 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 dafdb4d0c37..6749078bc03 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 06ff6b67a8c..2d938165736 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 88911c2d4b0..6aba6698b34 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 4433c5b3895..067fa678f46 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 5955e614306..a75ed33b34f 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',