[][github-action-url] [![david deps][david-image]][david-url] [![david devDeps][david-dev-image]][david-dev-url]
A GitHub action that preview website in surge.sh for your pull requests.
Compare to Netlify/Vercel?
- It is free.
- It supports multiple preview jobs.
Add a workflow (.github/workflows/preview.yml
):
name: ๐ Surge PR Preview
on: [pull_request]
jobs:
preview:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Get branch name (pull request)
run: echo "BRANCH_NAME=$(echo ${GITHUB_HEAD_REF})" >> $GITHUB_ENV
- uses: lxfu1/surge-preview@v1
id: preview_step
with:
surge_token: ${{ secrets.SURGE_TOKEN }}
github_token: ${{ secrets.GITHUB_TOKEN }}
project_branch: ${{ env.BRANCH_NAME }}
build: |
npm install
- name: Get the preview_url
run: echo "url => ${{ steps.preview_step.outputs.preview_url }}"
The preview website url will be https://{{repository.owner}}-{{repository.name}}-{{job.name}}-pr-{{pr.number}}.surge.sh
.
When a pull request is closed and teardown is set to 'true', then the surge instance will be destroyed.
name: ๐ Surge PR Preview
on:
pull_request:
# when using teardown: 'true', add default event types + closed event type
types: [opened, synchronize, reopened, closed]
push:
jobs:
preview:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Get branch name (pull request)
run: echo "BRANCH_NAME=$(echo ${GITHUB_HEAD_REF})" >> $GITHUB_ENV
- uses: lxfu1/surge-preview@v1
with:
surge_token: ${{ secrets.SURGE_TOKEN }}
github_token: ${{ secrets.GITHUB_TOKEN }}
project_branch: ${{ env.BRANCH_NAME }}
teardown: 'true'
build: |
npm install
surge_token
: Getting your Surge token.github_token
:secrets.GITHUB_TOKEN
.failOnError
: Setfailed
if a deployment throws error, defaults tofalse
.teardown
: Determines if the preview instance will be torn down on PR close, defaults tofalse
.
preview_url
: The url for the related PR preview