2.0.0 • Public • Published

Netlify Preview Database Plugin

Create an isolated preview database for each preview deployment in Netlify

you branch?

Quickstart   •   Website   •   Docs   •   Discord   •   Twitter

This plugin gives you a new and isolated database for your preview deployments in Netlify. When a pull-request is created, a new database is created and seeded with a Snaplet snapshot. Giving you a database (with data) to test your branch without side-effects.


1. Install the plugin

2. Configure settings in your project repo

# netlify.toml

 package = "@snaplet/netlify-preview-database-plugin"

Note: We check the deploy context associated with the build. You can configure your settings by deploy context.


- name: databaseCreateCommand
  required: false
  description: Command used to create the preview database
  default: "snaplet db create --git --latest"

- name: databaseDeleteCommand
  required: false
  description: Command used to delete the preview database
  default: "snaplet db delete --git"

- name: databaseUrlCommand
  required: false
  description: Command used to get the preview database url
  default: "snaplet db url --git"

- name: databaseUrlEnvKey
  required: false
  description: Preview database environment variable key
  default: "DATABASE_URL"

- name: reset
  required: false
  description: Reset the preview database state on each commit
  default: false

3. Set environment variables

  • In the Dashboard. Navigate to your site then Site settings > Environment Variables. Select Specific scopes and pick the Build option.

Note: To enable deploy contexts for environment variables in the Netlify Dashboard. Navigate to Netlify Labs > Scopes and Deploy Contexts for Environment Variables and click the enable button.

# netlify.toml

# ...


Required Environment variables

# Personal Access Token with "repo" scope, found in GitHub user settings
# API Access token found in Netlify user settings
# CLI Access token found in Snaplet UI
# Project ID found in Snaplet project settings

How it works

How it works

Netlify + Snaplet Preview Database + Snaplet Snapshots = Love.

Combining preview databases with Snaplet snapshots and Netlify preview deployments gives your team a consistent experience to evaluate your deployment's Environment Variables.

Each commit triggers a build in Netlify. Before the build starts, the plugin will create an preview database using your latest snapshot. Once the create command is done, we will inject the URL returned, into the environment variable, linked to your database (By default this variable is DATABASE_URL).

Once the pre-build step is executed successfully, your build will continue and a site will be deployed with the preview database.

Additional resources



npm i @snaplet/netlify-preview-database-plugin

DownloadsWeekly Downloads






Unpacked Size

1.56 MB

Total Files


Last publish


  • jgoux
  • justinvdm
  • peter.pistorius