diff --git a/HOUSE_STYLE_PLAN.md b/HOUSE_STYLE_PLAN.md new file mode 100644 index 00000000..1240b7d2 --- /dev/null +++ b/HOUSE_STYLE_PLAN.md @@ -0,0 +1,679 @@ +# House style + dark mode reset + +Tracking doc for an in-progress, multi-session effort. Delete this file once +every collection has been migrated and there's nothing left to resume. + +## Status — paused here, resume by continuing Phase 2 + +Branch: `feature/house-style-dark-mode-reset`, merged up to date with `main`, +plus: + +- `854b51c5` — house-style dark-mode rules + single-flag schema/layout rewiring + `badges` pilot +- `54f55c4d` — explanatory note on the browser tool's pre-loaded rules +- `breadcrumbs` migrated through Phase 2 → Phase 3 (see below) +- `button-groups` migrated through Phase 2 → Phase 3 (see below) +- `checkboxes` migrated through Phase 2 → Phase 3 (see below) +- `details-list` migrated through Phase 2 → Phase 3 (see below) +- `dividers` migrated through Phase 2 → Phase 3 (see below) +- `dropdown` migrated through Phase 2 → Phase 3 (see below) +- `empty-states` migrated through Phase 2 → Phase 3 (see below) +- `file-uploaders` migrated through Phase 2 → Phase 3 (see below) +- `filters` migrated through Phase 2 → Phase 3 (see below) +- `inputs` migrated through Phase 2 → Phase 3 (see below) +- `loaders` migrated through Phase 2 → Phase 3 (see below) +- `modals` migrated through Phase 2 → Phase 3 (see below) +- `pagination` migrated through Phase 2 → Phase 3 (see below) + +Done: Phase 1, the schema/layout rewiring, and `badges`, `breadcrumbs`, +`button-groups`, `checkboxes`, `details-list`, `dividers`, `dropdown`, +`empty-states`, `file-uploaders`, `filters`, `inputs`, `loaders`, +`modals`, and `pagination` as fully-migrated collections (see sections +below for exactly what that entailed). + +`breadcrumbs` needed one Phase 2 fix: its grouped/bordered variant used +`border-gray-300` for the group wrapper, but grouped interactive elements +elsewhere (`button-groups`, `pagination`) use `border-gray-200` — changed to +match. Everything else already conformed. + +`button-groups` needed one Phase 2 fix: all five variants used +`focus:ring-blue-500`, a shade found nowhere else in the codebase (not the +Action color, not the documented non-action-control ring color) — changed +to `focus:ring-gray-900` per the house style table. + +Regenerating dark variants via `pnpm run generate:dark-variants` used to +also surface gaps in *other*, not-yet-migrated collections (it scanned +every category) — those drafts had to be discarded each run, not +committed. This is now fixed: pass `--category= --slug=` to +scope a run to just the collection being migrated, e.g. +`pnpm run generate:dark-variants --category=application --slug=dropdown`. +Use the scoped form for every collection from here on. + +**`charts` — skipped, needs a dedicated pass, do not run the normal Phase +2 → Phase 3 process on it.** Its dark variants pair Tailwind classes with +hand-picked hex colors inside inline Chart.js `