GitHub Pages

Evidence

The workspace contains shevky.github.io, a consumer project using Shevky build scripts deployed to GitHub Pages. The static dist/ output model matches GitHub Pages hosting.

Basic Flow

  1. Build the site:
npm run build
  1. Publish the dist/ directory to a Pages-served branch or repository.

Example: GitHub Actions Workflow

Inferred - This workflow is an example pattern, not a built-in Shevky integration.

name: deploy-pages
on:
  push:
    branches: [main]
permissions:
  pages: write
  id-token: write
jobs:
  deploy:
    environment:
      name: github-pages
      url: $
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npm run build
      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: dist
      - name: Deploy
        id: deployment
        uses: actions/deploy-pages@v4

Tips

  • Set identity.url in site.json to your GitHub Pages URL before building.
  • If using a custom domain, place a CNAME file in src/assets/ so it gets copied to dist/.

Related