GitHub Action for ShipStatic — deploy static websites, landing pages, and prototypes instantly from CI.

name: Deploy
on: push

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      - uses: shipstatic/action@v1
        with:
          path: ./dist

Your site is live instantly on *.shipstatic.com. No API key, no sign-up, no configuration.

Deployments without an API key are public and expire in 3 days. The claim output contains a URL to keep the site permanently.

For permanent deployments and full control over your sites and domains, get a free API key from my.shipstatic.com/api-key:

1. Get a free key at my.shipstatic.com/api-key
2. Add it as a repository secret named SHIP_API_KEY (Settings > Secrets and variables > Actions)

name: Deploy
on:
  push:
    branches: [main]
  pull_request:

permissions:
  contents: read
  deployments: write
  pull-requests: write

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      - uses: shipstatic/action@v1
        with:
          api-key: ${{ secrets.SHIP_API_KEY }}
          path: ./dist
          domain: www.example.com
          github-token: ${{ secrets.GITHUB_TOKEN }}

The github-token input enables two features:

• PR comments — posts the deployment URL as a comment on pull requests
• GitHub Deployments — creates deployment objects visible in the repo sidebar

Use the automatic ${{ secrets.GITHUB_TOKEN }} — no extra secrets needed. Your workflow needs these permissions:

permissions:
  contents: read
  deployments: write
  pull-requests: write

See action-example for a complete working example with React + Vite, including production deploys with custom domains and PR preview comments.

MIT