Deploy Micropage from GitHub Actions

With a deploy token (Pro+) you can publish your Micropage site whenever you push to main.

What you need

In the Micropage app (once, on your machine):

1. Open your project → Settings → Deploy tokens → create a token and copy it.
2. Note your project UUID (also visible in .micropage/project.json as projectUuid).

In GitHub (repository Settings → Secrets and variables → Actions):

Name	Type	Value
MICROPAGE_DEPLOY_TOKEN	Secret	The token from step 1
MICROPAGE_PROJECT_UUID	Variable	Your project UUID

Workflow

name: Deploy

on:
  push:
    branches: [main]

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

      - uses: actions/setup-node@v4
        with:
          node-version: '20'

      - run: npm install -g micropage

      - name: Deploy
        env:
          MICROPAGE_DEPLOY_TOKEN: ${{ secrets.MICROPAGE_DEPLOY_TOKEN }}
          MICROPAGE_PROJECT_UUID: ${{ vars.MICROPAGE_PROJECT_UUID }}
        run: |
          micropage projects "$MICROPAGE_PROJECT_UUID" deploy "$MICROPAGE_DEPLOY_TOKEN" --watch

The deploy command reads the .page files in the repo, creates a build, and publishes it.

Summary

• One secret (MICROPAGE_DEPLOY_TOKEN), one variable (MICROPAGE_PROJECT_UUID), one command.
• The CLI handles parse → build → publish.
• --watch streams deploy progress into the Actions log.

See CI/CD for more options.