serve the site from php-debugger.dev

[carlos-granados]

Prepares the repo for serving the site at php-debugger.dev as a GitHub Pages custom domain.

static/CNAME — holds the domain so Docusaurus copies it into build/ on every build. This has to live in the repo rather than being set only through the Pages UI: the deploy workflow uses JamesIves/github-pages-deploy-action with clean-exclude: pr-preview, so each deploy replaces everything else on gh-pages. A UI-created CNAME would be deleted on the next merge and the custom domain would silently unset itself.

url — https://php-debugger.github.io → https://php-debugger.dev, so canonical tags, Open Graph URLs and the sitemap point at the real home. baseUrl is unchanged, and organizationName/projectName stay as they are since they identify the repo for deployment rather than the served URL.

Verified in the built output: build/CNAME present, canonical and og:url on the new domain, sitemap entries updated, and no php-debugger.github.io left in the built HTML.

Safe to merge before any DNS change — the file has no effect until GitHub's custom domain setting matches it. It should be merged before setting the custom domain in the Pages UI, for the reason above.

Remaining steps, outside this repo:

• Cloudflare DNS: four A records (185.199.108–111.153) and four AAAA (2606:50c0:8000–8003::153) at the apex, plus CNAME www → php-debugger.github.io
• leave those records DNS only, not proxied, until GitHub has issued the certificate — the orange cloud intercepts the HTTP validation and the certificate never issues
• GitHub Settings → Pages → Custom domain → php-debugger.dev, then Enforce HTTPS once the certificate appears

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-09-24 18:58 UTC