feat(docs): add bilingual package documentation site

2026-09-20 15:53:28 +08:00
parent 60f6f1fb1a
commit dc80bd8ae0
111 changed files with 6531 additions and 0 deletions
@@ -0,0 +1,24 @@
+---
+title: Overview
+description: Learn where the UI package fits and how its explicit entry points support composition.
+order: 1
+toc:
+  - id: package-role
+    title: Package role
+  - id: tutorial-map
+    title: Tutorial map
+  - id: ui-or-blocks
+    title: UI or Blocks
+---
+
+## Package role {#package-role}
+
+`@workspace/ui` contains reusable React primitives, composite controls, hooks, icons, styles, and locale catalogs. It is the visual foundation shared by applications and higher-level feature packages.
+
+## Tutorial map {#tutorial-map}
+
+This tutorial installs the styles, introduces component subpaths, builds a small form through composition, adds responsive behavior, and connects locale catalogs.
+
+## UI or Blocks {#ui-or-blocks}
+
+Use UI components when the application owns the workflow. Use `@workspace/blocks` when the interface also needs a complete feature contract such as navigation, media storage, search adapters, or notification queries.