Preview environments

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

1. 01

   Pull request

   Opened or updated on the connected repository.

2. 02

   Preview build

   Gheima builds that commit on its own.

3. 03

   Own subdomain

   The preview gets a URL of its own.

4. 04

   Comment on the PR

   The URL is posted back to the pull request.

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.