Does Novence work with GitHub Actions?

What does the GitHub Actions integration sync?

• ·Upload the built static directory (or one HTML file)
• ·Run Lighthouse/axe/link checks on verified plans
• ·Print the live URL; failures exit non-zero so the job fails

How do I set up GitHub Actions with Novence?

1. Step 01 · Build first

   Novence does not run next build. Export static HTML in the workflow, then deploy the output folder.

2. Step 02 · Store the key

   Add NOVENCE_API_KEY as a GitHub Actions secret. Never commit it.

3. Step 03 · Deploy

   npx novence deploy ./dist --json --no-input. Node 18+ on the runner.

Example GitHub Actions workflow

name: Deploy static site
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 ci && npm run build
      - run: npx novence deploy ./dist --json --no-input
        env:
          NOVENCE_API_KEY: ${{ secrets.NOVENCE_API_KEY }}

Is this on the Free plan?

Yes after the account is email-verified. The key is an nv_ key from bootstrap or claim.

GitHub Actions FAQ