Squad Docs

1name: Squad Docs — Build & Deploy
2
3on:
4  workflow_dispatch:
5  push:
6    branches: [preview]
7    paths:
8      - 'docs/**'
9      - '.github/workflows/squad-docs.yml'
10
11permissions:
12  contents: read
13  pages: write
14  id-token: write
15
16concurrency:
17  group: pages
18  cancel-in-progress: true
19
20jobs:
21  build:
22    runs-on: ubuntu-latest
23    steps:
24      - uses: actions/checkout@v4
25
26      - uses: actions/setup-node@v4
27        with:
28          node-version: '22'
29
30      - name: Install build dependencies
31        run: npm install --no-save markdown-it markdown-it-anchor
32
33      - name: Build docs site
34        run: node docs/build.js --out _site --base /squad
35
36      - name: Upload Pages artifact
37        uses: actions/upload-pages-artifact@v3
38        with:
39          path: _site
40
41  deploy:
42    needs: build
43    runs-on: ubuntu-latest
44    environment:
45      name: github-pages
46      url: ${{ steps.deployment.outputs.page_url }}
47    steps:
48      - name: Deploy to GitHub Pages
49        id: deployment
50        uses: actions/deploy-pages@v4