first commit

2026-07-18 21:10:39 +08:00
commit 1b90e552a5
91 changed files with 9056 additions and 0 deletions
@@ -0,0 +1,18 @@
+# Repository Instructions
+
+## UI changes
+
+Before changing UI, themes, layout, spacing, colors, or components:
+
+1. Read `docs/ui-design.md`.
+2. Reuse its global design tokens; do not introduce page-specific radii, spacing, or semantic colors.
+3. Update or add a failing test before changing behavior or visual rules.
+4. Run:
+
+   ```bash
+   pnpm test -- --run tests/unit/design/consistency.test.ts
+   pnpm test -- --run tests/unit/design/contrast.test.ts
+   pnpm check
+   ```
+
+Switches, circular progress, avatars, and other function-defined shapes are exempt from the shared radius rule.