classspacer

Classspacer is a lightweight software utility designed to manage whitespace and class attribute organization in HTML and frontend templates. It functions as both a command-line tool and a reusable library, enabling teams to enforce consistent class naming, ordering, and formatting across a codebase. The project emphasizes deterministic output and non-destructive operation on source files.

Core features include normalization of whitespace within class attributes, deduplication of identical tokens, optional reordering of classes according to a configured priority, and preservation of non-class fragments such as template expressions. It supports custom order rules, case sensitivity options, and pluggable sorters to align with project conventions such as BEM or tailwind-like token sets.

Implementation and usage: classspacer is commonly implemented for JavaScript/TypeScript environments and is usable as a CLI and as a library. It can be integrated into build tools, editors, and pre-commit hooks. Typical usage patterns include running a fix command on HTML templates or using the library API to normalize class strings during runtime rendering.

Limitations and considerations: dynamic class expressions generated at runtime may require conservative handling to avoid altering meaning. In templating languages, the tool may skip or annotate parts that are not statically known. A simple example shows: input class="btn btn-primary active" becomes class="btn btn-primary active".

See also: tools for code formatting and CSS class management.