// the find
mdo/code-guide
Standards for developing consistent, flexible, and sustainable HTML and CSS.
A style guide for HTML and CSS written by @mdo, the Bootstrap co-creator. It covers attribute ordering, naming conventions, whitespace, and similar low-level decisions. Aimed at teams that want a shared baseline rather than individuals looking for tooling.
The guidance is opinionated without being arbitrary — the reasoning behind each rule is stated plainly. Coming from the person who built Bootstrap gives the conventions real-world credibility at scale. The translated versions (20+ languages) show it resonated broadly enough to warrant that effort. It's short enough to actually read, which most style guides aren't.
Last meaningful update was mid-2024 and the content feels circa-2015 — there's nothing about CSS custom properties, container queries, or modern layout (Grid gets a passing mention at best). It doesn't cover any tooling integration (Stylelint, Prettier configs you can drop in), so teams still have to do that work themselves. The repo is essentially a static site with no linting rules you can import, which limits its practical value to 'read it and agree verbally' rather than enforced standards.