Why this matters
GitHub Pages project sites live under a repository path. Links that work at the domain root can break when the base path is missing or malformed.
Setup
Set the Astro base path to the repository name and generate internal links from a helper that normalizes trailing slashes.
Implementation notes
Check built HTML for paths that accidentally concatenate strings, such as a base
path joined directly to blog/ without a slash.
Final checklist
- Base path matches repository
- Internal links include the base path
- Built HTML has no malformed routes