GitHub Actions

Nuxflare Pro comes with a basic GitHub Actions workflow for automated deployments using SST.

Deployment Workflow

# filepath: .github/workflows/deploy.yaml
name: "sst deploy"

on:
  workflow_dispatch: # Manual trigger only

The deployment workflow:

  • Uses workflow concurrency to prevent parallel deployments
  • Caches SST assets between runs
  • Sets up Bun runtime
  • Installs dependencies
  • Deploys using SST_STAGE set to the branch name

Required Secrets

You can use different tokens for different branches.

  • CLOUDFLARE_API_TOKEN - Cloudflare API token for deployments

Usage

  1. Set up required secrets in repository settings
  2. Trigger deployment manually from Actions tab
  3. SST will deploy to environment matching branch name

Notes

  • Deployment is manual trigger only (workflow_dispatch)
    • Add other events for setting up automatic preview deployments
  • Branch name determines SST stage
    • Use the production branch for production deploys.