Automate Deploys

If you use GitHub Actions or another CI/CD tool, you can deploy to Puls automatically every time you push a new build.

Set Up Your API Key#

Add your Puls API key as a secret in your CI environment. In GitHub, go to Settings → Secrets → Actions and create a secret called PULS_TOKEN.

GitHub Actions Example#

Create a workflow file at .github/workflows/deploy.yml:

name: Deploy to Puls

on:
  push:
    branches: [main]

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

      - name: Build game
        run: npm run build

      - name: Install Puls CLI
        run: curl -sSL https://get.puls.games/cli | sh

      - name: Deploy
        env:
          PULS_TOKEN: ${{ secrets.PULS_TOKEN }}
        run: puls deploy my-game --dir ./build --prune

Tips#

Use --prune in CI to automatically clean up old versions and avoid hitting the release limit
Name your versions after git tags or commit hashes for easy identification:
```
puls deploy my-game --version $GITHUB_SHA
```
Use --dry-run in pull request checks to validate builds without deploying

Next: Age Ratings