Explanation

Understanding-oriented material — the how and why behind the library's design and conventions.

• Styleguide — the non-obvious conventions that have bitten us in production: CSS-module discipline (all visual rules in colocated .module.css, never inline in .tsx), the typography-token rules, theme/stylesheet import order, and the barrel-export gotchas. Read it before adding a component, bumping a dependency, or wiring the library into a new app. It lives at the repo root (STYLEGUIDE.md) because CLAUDE.md and several source comments reference it there by path.