feat: migrate visual fixtures to storybook

README.md

@@ -83,6 +83,16 @@ This command starts healthy PostgreSQL and Redis containers, applies migrations,
 
 The command does not provision an administrator automatically. Run `npm run provision:admin` once after setting the initial administrator variables in `.env` when admin access is needed. Stop the application processes with `Ctrl+C`; stop the containers separately with `npm run db:down` when they are no longer needed.
 
+## Visual Development
+
+Run Storybook to inspect the authoritative design tokens and mock visual fixtures without requiring API data:
+
+```sh
+npm run storybook
+```
+
+Open `http://localhost:6006/`. Use the Storybook theme toolbar to switch between light and dark themes. The accessibility addon is enabled for component review. The fixture showcase is intentionally mock-only and is not part of the production router.
+
 ## Initial Administrator
 
 After the development database is migrated, set `INITIAL_ADMIN_EMAIL`, `INITIAL_ADMIN_PASSWORD`, and `INITIAL_SELLER_NAME` in your local `.env`, then run `npm run provision:admin` once. The command creates the only initial administrator and linked Seller; it refuses to run after any User exists.