docs: require storybook coverage for visual slices

2026-09-08 21:52:48 -04:00
parent 9bb4a16e9e
commit 0d286f09a8
2 changed files with 33 additions and 1 deletions
@@ -27,7 +27,18 @@ Test:

 ## Component

-Test important Vue components and composables.
+Test important Vue components and composables. Every new or changed visual component must include a colocated Storybook story or an update to an existing story before its vertical slice is committed.
+
+For visual slices, run the complete Storybook gate from the repository root:
+
+```sh
+npm run test --workspace=@pokemon-inventory/web
+npm run build --workspace=@pokemon-inventory/web
+npm run build-storybook --workspace=@pokemon-inventory/web
+npm run test-storybook
+```
+
+Stories should use mock fixture data and cover the component states that users can encounter, including keyboard focus, selected, disabled, loading, empty, error, responsive, and light/dark theme behavior where applicable. Do not add production domain behavior just to make a story render.

 ## E2E

@@ -58,4 +69,6 @@ GitHub Actions should run:
 - accessibility checks
 - build validation

+The Storybook build and interaction/accessibility runner are part of the visual-slice commit gate. Backend-only slices may omit them when no visual component or UI contract changes.
+
 Do not weaken or skip tests to obtain a passing build.