This is a GitHub Action that automatically deploys all pull requests and branches as a static site using Surge.sh.

• Auto-deploy every PR and branch to its unique environment
• Unlimited free static site deployments, thanks to Surge.sh
• No search engine indexing for branch sites (robots.txt injection)
• Label and comment on PRs with the deployment and log URLs
• Update your staging GitHub environment status

The directory to deploy, for example dist or public

Prefix for deployment URL, e.g., example will translate to https://example-PR_NAME.surge.sh

Generate a robots.txt file to prevent search engines from indexing the deployment

Content for robots.txt file, defaults to:

User-agent: *
Disallow: /

Name of the deployment environment on GitHub, defaults to "Preview"

Skip adding the deployment details comment, defaults to false

Skip adding the labels to pull requests, defaults to false

Labels to add to pull requests as a comma-separated list, defaults to deployed

Set the status check to "failed" if a deployment error occurs, defaults to false

The GitHub token is required to add labels, comments, etc., on the PR: GITHUB_TOKEN: ${{ secrets.GH_PAT }}

Your Surge.sh email address, required to deploy site to Surge.sh

Your Surge.sh login token, required to deploy site to Surge.sh (get it by doing surge token)

name: Deploy CI
on:
  issue_comment:
    types: [created]
  push:
    branches-ignore:
      - master
  pull_request:
    types:
      - opened
      - edited
      - synchronize
jobs:
  release:
    name: Deploy website
    runs-on: ubuntu-18.04
    if: "!contains(github.event.head_commit.message, '[skip ci]') && (contains(github.event.comment.body, 'Deploy') || contains(github.event.comment.body, 'deploy') || github.event_name == 'push' || github.event_name == 'pull_request')"
    steps:
      - name: Checkout
        uses: actions/checkout@v1
      - name: Setup Node.js
        uses: actions/setup-node@v1
        with:
          node-version: 12
      - name: Install dependencies
        run: npm ci
      - name: Build static site
        run: npm run build # Build your website
      - name: Deploy
        uses: koj-co/[email protected]
        with:
          prefix: example # Prefix for deployment URL
          robotsTxtPath: dist/robots.txt # Add robots.txt file
          distDir: dist # Path to dist directory
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # GitHub token
          SURGE_LOGIN: ${{ secrets.SURGE_LOGIN }} # Surge.sh email
          SURGE_TOKEN: ${{ secrets.SURGE_TOKEN }} # Surge.sh token

• Code: MIT © Koj
• "GitHub" is a trademark of GitHub, Inc.

_{An open source project by Koj.
Furnish your home in style, for as low as CHF175/month →}