Skip to main content

Hosting on GitHub Pages

This documentation site is a Docusaurus app in docs/ deployed to GitHub Pages at https://docs.superdurable.io.

Repo setup

  1. Workflow: .github/workflows/deploy-docs.yml builds docs/ and deploys with GitHub Pages actions
  2. docs/static/CNAME contains docs.superdurable.io
  3. GitHub → Settings → Pages → Source: GitHub Actions
  4. After the first deploy, set Custom domain to docs.superdurable.io and enable Enforce HTTPS

GoDaddy DNS

For apex domain superdurable.io at GoDaddy:

  1. DNS management for superdurable.io
  2. Add CNAME:
    • Host: docs
    • Value: superdurable.github.io
    • TTL: 1 hour (or default)
  3. Do not create an A record for docs
  4. Verify: dig docs.superdurable.io CNAMEsuperdurable.github.io