← notes

One page, seven files, and the two that decide whether it deploys

Aug 15, 2026

A single page, no build step, no dependencies.

Seven files. index.html, support.js, a favicon, an Open Graph image, and three that are pure deployment: CNAME, .nojekyll, .gitignore. The two deployment files are the ones people get wrong. .nojekyll tells GitHub Pages to skip the Jekyll build, which is what makes anything starting with an underscore serve instead of silently vanishing. CNAME pins the custom domain and has to survive every deploy or the domain quietly detaches and the site answers on github.io instead. Both failures are invisible until someone tells you.

136KB of HTML means the markup is generated somewhere else, so this repo is the output rather than the source.