Files
BMAD-METHOD/.github/workflows/docs.yaml
T
Alex Verkhovsky 8f2c13dd0e feat(tools): add dogfood.py, move the docs output to docs-site/dist, prune .gitignore (#3035)
- tools/dogfood.py sets up BMad in a fresh checkout or worktree with no
  inference: it installs a subset of skills with npx skills (from the
  checkout itself by default), builds _bmad with the bmad skill's
  setup.py, and copies core.output_folder from the main checkout's local
  config. Options: --source, --skills, --agents, --custom-from, --reset,
  and an optional dogfood.toml. It exits non-zero when setup reports
  problems or unmet requirements.
- The docs site builds to Astro's default docs-site/dist instead of the
  repo-root build/site, so it no longer shares a name with docs/build/.
  The Pages upload path, build script, validators, test, and README
  follow.
- .gitignore drops rules for things nothing creates any more, makes
  .agents and .ai match as directories, restores .gemini, adds .idea/
  and /dogfood.toml, and folds the rest into two sections.
2026-10-04 12:52:59 -06:00

64 lines
1.5 KiB
YAML

name: Deploy Documentation
on:
push:
branches: [dev]
paths: [docs/**, docs-site/**, .github/workflows/docs.yaml]
workflow_dispatch:
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: pages
# No big win in setting this to true — risk of cancelling a deploy mid-flight.
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-latest
defaults:
run:
working-directory: docs-site
steps:
- name: Checkout repository
uses: actions/checkout@v5
with:
# Full history needed for Starlight's lastUpdated timestamps (git log)
fetch-depth: 0
- name: Setup Node.js
uses: actions/setup-node@v5
with:
node-version-file: docs-site/.nvmrc
cache: npm
cache-dependency-path: docs-site/package-lock.json
- name: Install dependencies
run: npm ci
- name: Build documentation
env:
# Override site URL from GitHub repo variable if set
# Otherwise, astro.config.mjs will compute from GITHUB_REPOSITORY
SITE_URL: ${{ vars.SITE_URL }}
run: npm run build
- name: Upload artifact
uses: actions/upload-pages-artifact@v5
with:
path: docs-site/dist
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
needs: build
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v5