Automate branching with GitHub Actions
Create and delete branches with GitHub Actions
Neon provides the following GitHub Actions for working with Neon branches, which you can add to your CI workflows:
Create branch action
This GitHub Action creates a new branch in your Neon project.
info
The source code for this action is available on GitHub.
Prerequisites
- Using the action requires a Neon API key. For information about obtaining an API key, see Create an API key.
- Add your Neon API key to your GitHub Secrets:
- In your GitHub repository, go to Project settings and locate Secrets at the bottom of the left sidebar.
- Click Actions > New Repository Secret.
- Name the secret
NEON_API_KEY
and paste your API key in the Secret field - Click Add Secret.
Example
The following example creates a branch based on the specified parent branch:
Input variables
Outputs
Delete branch action
This GitHub Action deletes a branch from your Neon project.
info
The source code for this action is available on GitHub.
Prerequisites
- Using the action requires a Neon API key. For information about obtaining an API key, see Create an API key.
- Add your Neon API key to your GitHub Secrets:
- In your GitHub repository, go to Project settings and locate Secrets at the bottom of the left sidebar.
- Click Actions > New Repository Secret.
- Name the secret
NEON_API_KEY
and paste your API key in the Secret field - Click Add Secret.
Example
The following example deletes a branch with the br-long-forest-224191
branch ID from a Neon project with the project ID rapid-haze-373089
when a pull request is merged.
Input variables
Outputs
This Action has no outputs.
Reset from parent action
This GitHub Action resets a child branch with the latest data from its parent branch.
Info The source code for this action is available on GitHub.
Prerequisites
- Using this action requires a Neon API key. For information about obtaining an API key, see Create an API key.
- Add your Neon API key to your GitHub Secrets:
- In your GitHub repository, go to Project settings and locate Secrets at the bottom of the left sidebar.
- Click Actions > New Repository Secret.
- Name the secret
NEON_API_KEY
and paste your API key in the Secret field. - Click Add Secret.
Example
The following example demonstrates how to reset a branch in your Neon project:
Input variables
Outputs
Example applications
The following example applications use GitHub Actions workflows to create and delete branches in Neon.
Preview branches with Vercel
Demonstrates using GitHub Actions workflows to create a Neon branch for every Vercel preview deployment
Preview branches with Fly.io
Demonstrates using GitHub Actions workflows to create a Neon branch for every Fly.io preview deployment
Neon Twitter app
Demonstrates using GitHub Actions workflows to create a Neon branch for schema validation and perform migrations
Need help?
Join our Discord Server to ask questions or see what others are doing with Neon. Users on paid plans can open a support ticket from the console. For more detail, see Getting Support.
Last updated on