Preview environments

Get an isolated, throwaway deployment for every open pull request.

Preview environments give every pull request its own isolated, live deployment — so reviewers see the change running, not just the diff.

Turn on auto-create#

  1. 1

    Open Preview environments

    Go to Previews in the dashboard.

  2. 2

    Enable per service

    Under “Auto-create on pull requests”, flip the switch for each service that should spin up previews.

How it works#

When you open (or update) a pull request, Gheima builds a preview and comments the URL on the PR. The preview lives at its own subdomain, for example:

https://pr-42-myapp.gheima.ma
  • Pushing more commits to the PR redeploys the same preview.
  • A Postgres database can be branched automatically so the preview gets isolated data.
  • Previews expire after 72 hours of inactivity and are torn down when the PR closes.

✦ Each open PR has a shareable URL that always reflects its latest commit, with no manual setup per branch.