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):

NameTypeValue
MICROPAGE_DEPLOY_TOKENSecretThe token from step 1
MICROPAGE_PROJECT_UUIDVariableYour 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.