Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
triangle

GitHub Action

Vercel Preview URL

v1.1.1

Vercel Preview URL

triangle

Vercel Preview URL

Receive the deployment preview URL from Vercel

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Vercel Preview URL

uses: zentered/[email protected]

Learn more about this action in zentered/vercel-preview-url

Choose a version

Vercel Preview URL

Test Release Semantic Release Conventional Commits

Retrieve the preview URL from the Vercel API, filtered by the repo and branch. The URL can then be used for further end-to-end tests, link checks and other PR integrations/actions.

The main difference to Capture Vercel Preview URL is that the action runs on push and pull_request, not on issue_comment. This enables 3rd party GitHub integrations to report directly on the Pull Request.

Table of Contents

Usage

Create a Vercel API Token

Vercel needs a little time to build the preview, you can check the average build time in your deployments and add the seconds plus a little to a sleep action, to wait until the deployment is READY.

Instead of an arbitrary time, the Await for Vercel deployment Action can be used.

- run: sleep 30
- name: vercel-preview-url
  uses: zentered/[email protected]
  id: vercel_preview_url
  env:
    VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
  with:
    vercel_team_id: 'opstrace'
    vercel_project_id: 'opstrace.com'
- name: Get URL
  run: echo "https://${{ steps.vercel_preview_url.outputs.preview_url }}"

Environment Variables / Secret

In the repository, go to "Settings", then "Secrets" and add "VERCEL_TOKEN", the value you can retrieve on your Vercel account.

Inputs

To see more information on inputs, see the Vercel Documentation.

Name Requirement Type Description
vercel_team_id required string Team id
vercel_app optional string Name of the deployment
vercel_from optional timestamp Deployment after this date
vercel_project_id optional string Vercel project id
vercel_since optional timestamp Deployment since this date
vercel_state optional string Filter on state
vercel_target optional string Deployment environment
vercel_to optional timestamp Deployment before this date
vercel_until optional timestamp Deployment before this date
vercel_users optional string Filter on created by user(s)

Outputs

Name Description
preview_url A string with the unique URL of the deployment. If it hasn't finished uploading (is incomplete), the value will be null
deployment_state A string with the current deployment state, it could be one of the following QUEUED, BUILDING, READY, or ERROR.

Contributing

See CONTRIBUTING.

License

See LICENSE.