Nakshora output is static CSS — it deploys anywhere. Here is the exact GitHub Pages recipe.

Steps#

  • GitHub Actions builds docs-site/dist
  • Upload artifact and deploy to gh-pages
  • 404 handling: copy index pattern or add a 404.html

Cache headers#

text
assets/*.css  →  public, max-age=31536000, immutable
*.html        →  public, max-age=0, must-revalidate

Verify#

  • Lighthouse ≥ 95 performance with a JIT build
  • No console 404s for CSS
  • Brotli/gzip enabled
Note. This documentation platform itself runs on Cloudflare Pages — the same recipe, proven.