csswizardry/css-guidelines

This repository originally housed a set of opinionated guidelines for writing CSS that is manageable and maintainable in large projects. The guidelines were written by Harry Roberts, a front-end consultant known for work on CSS architecture, and the content has since moved to a dedicated website at cssguidelin.es. The repository itself now contains only a brief redirect notice pointing visitors there. CSS is the language used to control the visual appearance of web pages. In small projects it is straightforward to manage, but as a codebase grows and more developers contribute, styles tend to accumulate, rules start to conflict, and it becomes difficult to predict what changing one rule will affect elsewhere. The guidelines at the linked site address this by proposing consistent approaches to naming, formatting, organizing, and commenting stylesheets so that multiple developers can work on the same CSS without introducing unintended side effects. The guidance covers topics like selector naming conventions, specificity management, the use of comments to communicate intent, and how to structure large stylesheets in a way that remains readable over time. These are the kinds of practical decisions that teams often make inconsistently, leading to stylesheets that become harder to work with as they grow. Because the actual content now lives at an external URL rather than in this repository, the repo itself serves mainly as a redirect and a historical record. The guidelines at cssguidelin.es remain freely available and are widely cited in front-end development communities as a practical reference for teams introducing more structure to their CSS. If you are looking for the specific advice, visiting cssguidelin.es is the right place to start.