Files
85bd0d4f9b feat(docs): new branching docs (#36890)
* feat(docs): new branching docs

Reorganize branching docs and add Gitless branching page

* style: fix lint and formatting issues

* chore: document email notification for failures

* docs(branching): fix review comments

* branch merge updates

---------

Co-authored-by: Qiao Han <qiao@supabase.io>
Co-authored-by: Saxon Fletcher <saxonafletcher@gmail.com>
2025-07-16 09:45:19 -04:00

31 lines
1.7 KiB
Plaintext

---
title: 'Integrations'
description: 'Use Supabase branching with hosting providers and other tools.'
subtitle: 'Use Supabase branching with hosting providers and other tools'
---
Branching works with hosting providers that support preview deployments. Learn how to integrate Supabase branching with various platforms and tools.
## Hosting providers
With the Supabase branching integration, you can sync the Git branch used by the hosting provider with the corresponding Supabase preview branch. This means that the preview deployment built by your hosting provider is matched to the correct database schema, edge functions, and other Supabase configurations.
### Vercel
Install the Vercel integration:
- From the [Vercel marketplace](https://vercel.com/integrations/supabase) or
- By clicking the blue `Deploy` button in a Supabase example app's `README` file
<Admonition type="note" label="Vercel GitHub integration also required.">
For branching to work with Vercel, you also need the [Vercel GitHub integration](https://vercel.com/docs/deployments/git/vercel-for-github).
</Admonition>
And make sure you have [connected](/dashboard/org/_/integrations) your Supabase project to your Vercel project.
Supabase automatically updates your Vercel project with the correct environment variables for the corresponding preview branches. The synchronization happens at the time of Pull Request being opened, not at the time of branch creation.
As branching integration is tied to the Preview Deployments feature in Vercel, there are possible race conditions between Supabase setting correct variables, and Vercel running a deployment process. Because of that, Supabase is always automatically re-deploying the most recent deployment of the given pull request.