Skip to main content

GitHub Pages Deployment

The Docusaurus site lives in website/ and is configured as a GitHub Pages project site:

SettingValue
URLhttps://turbra.github.io
Base URL/stakkr/
Output directorywebsite/build
Pages sourceGitHub Actions

The workflow in .github/workflows/pages.yml builds the site on pushes to main, uploads website/build, and deploys the uploaded artifact with GitHub Pages.

Local Build

Install dependencies and build the production site:

cd website
npm ci
npm run build

Serve the production build locally:

cd website
npm run serve

Base URL Check

After npm run build, check for root-relative internal links that would break under /stakkr/:

rg --pcre2 -n 'href="/(?!stakkr)|src="/(?!stakkr)' website/build/**/*.html website/build/index.html

No matches should appear for internal docs routes or static assets. External absolute URLs are fine.