Draftbase AcademySearch

Shipping Static Sites

GitHub Pages, base paths and the underscore problem

7 min

Project sites serve from /<repo>, so every absolute link needs a prefix. Frameworks expose this as base or basePath; set it once and use the framework's link helper everywhere.

The underscore problem

Jekyll ignores directories starting with an underscore, which is exactly what Next names its asset folder. Deploying through GitHub Actions skips Jekyll entirely, and a .nojekyll file covers the older path.