Frostbyte Screenshot Action

Take automated website screenshots in your GitHub Actions workflow. No Puppeteer setup, no browser dependencies — just one API call.

Use Cases

• Deployment verification — screenshot your app after every deploy
• Visual regression testing — compare screenshots across PRs
• PR previews — auto-post screenshots of staging URLs on pull requests
• Documentation — generate up-to-date screenshots for docs
• Monitoring — periodic screenshots of production pages

Quick Start

- name: Take screenshot
  uses: OzorOwn/frostbyte-screenshot-action@v1
  with:
    url: 'https://your-app.vercel.app'

That's it. The screenshot is saved as an artifact you can download from the Actions tab.

Examples

Screenshot after deployment

name: Deploy & Screenshot
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Deploy to Vercel
        id: deploy
        run: echo "url=https://your-app.vercel.app" >> $GITHUB_OUTPUT

      - name: Screenshot deployment
        uses: OzorOwn/frostbyte-screenshot-action@v1
        with:
          url: ${{ steps.deploy.outputs.url }}
          viewport: desktop

Multi-viewport screenshots

- name: Desktop screenshot
  uses: OzorOwn/frostbyte-screenshot-action@v1
  with:
    url: 'https://example.com'
    viewport: desktop
    output-path: screenshots/desktop.png
    artifact-name: desktop-screenshot

- name: Mobile screenshot
  uses: OzorOwn/frostbyte-screenshot-action@v1
  with:
    url: 'https://example.com'
    viewport: mobile
    output-path: screenshots/mobile.png
    artifact-name: mobile-screenshot

Comment on Pull Request

name: PR Screenshot
on:
  pull_request:

jobs:
  screenshot:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - name: Screenshot staging
        uses: OzorOwn/frostbyte-screenshot-action@v1
        with:
          url: 'https://staging.your-app.com'
          comment-on-pr: 'true'
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Full page + dark mode

- name: Full page dark mode screenshot
  uses: OzorOwn/frostbyte-screenshot-action@v1
  with:
    url: 'https://example.com'
    full-page: 'true'
    dark-mode: 'true'
    format: jpeg
    quality: '90'
    output-path: screenshots/full-dark.jpeg

Inputs

Input	Description	Default	Required
url	URL to screenshot	—	Yes
viewport	desktop, tablet, mobile, 1080p, 4k	desktop	No
format	png or jpeg	png	No
full-page	Capture full scrollable page	false	No
dark-mode	Emulate dark color scheme	false	No
quality	JPEG quality (1-100)	80	No
output-path	File path for the screenshot	screenshot.png	No
api-key	Frostbyte API key (optional)	—	No
comment-on-pr	Post screenshot as PR comment	false	No
upload-artifact	Upload as GitHub Actions artifact	true	No
artifact-name	Name for the artifact	screenshot	No

Outputs

Output	Description
screenshot-path	Path to the saved screenshot file
screenshot-url	URL to view the artifact in Actions

Viewports

Preset	Resolution
desktop	1280 x 720
tablet	768 x 1024
mobile	375 x 812
1080p	1920 x 1080
4k	3840 x 2160

Rate Limits

Works without an API key — 50 free screenshots per IP. For higher limits:

1. Get a free API key: curl -X POST https://agent-gateway-kappa.vercel.app/api/keys/create
2. Add it as a repository secret (FROSTBYTE_API_KEY)
3. Pass it to the action:

- uses: OzorOwn/frostbyte-screenshot-action@v1
  with:
    url: 'https://example.com'
    api-key: ${{ secrets.FROSTBYTE_API_KEY }}

Free API keys include 200 credits. Each screenshot costs 1 credit.

Powered by Frostbyte

This action uses the Frostbyte Screenshot API — one of 40+ developer APIs available through a single gateway.

• API Catalog — Browse all APIs
• Get API Key — 200 free credits
• SDK (JavaScript + Python) — Client libraries

License

MIT