GitHub Workflows

Active Workflows

main.yml

• Runs on: Push to master & PRs to master
• Steps:
  1. Checkout code
  2. Setup Node.js 20
  3. Install dependencies (npm install --legacy-peer-deps)
  4. Build frontend (CI=false GENERATE_SOURCEMAP=false npm run build)
  5. Upload build artifacts (7 days retention)
  6. Deploy to GitHub Pages

pages.yml

• Runs on: Push to master (docs/ changes)
• Steps:
  1. Checkout code
  2. Configure Pages
  3. Upload docs/ as artifact
  4. Deploy to GitHub Pages

validate.yml

• Runs on: Pull requests to master
• Steps:
  1. Validate repo structure
  2. Build and test
  3. Verify build output

Debugging

To see workflow logs:

1. Go to GitHub repo
2. Click "Actions" tab
3. Select workflow
4. Click latest run
5. View detailed logs

Common Issues

Build fails

• Check Node.js version (need 20)
• Check npm install works locally
• Check environment variables

Pages not deploying

• Check docs/ directory exists
• Check GitHub Pages settings enabled
• Check workflow permissions