rscss (“Reasonable System for CSS Stylesheet Structure”) is a naming and organization style guide aimed at keeping CSS maintainable as projects scale. It proposes a consistent vocabulary—components, elements, variants, and utilities—so teams can infer intent directly from class names. The approach is intentionally lightweight: it’s a set of conventions, not a framework, so it layers cleanly over any build system or preprocessor. By nudging you toward small, independent components with clear boundaries, rscss reduces selector specificity battles and cascade surprises. The guidelines cover folder structure, naming, and how to scope modifiers, which helps reduce churn when multiple contributors touch the same UI. Even if your team eventually adopts a utility framework or CSS-in-JS, rscss is a helpful reference for reasoning about class semantics and keeping styles tidy.
Features
- Clear conventions for components, elements, variants, and utilities
- Low-ceremony naming that’s easy to teach and code review
- Guidance on directory layout and file scoping for larger codebases
- Encourages low specificity and predictable overrides
- Compatible with preprocessors and build tools without lock-in
- Improves readability and intent disclosure in class names