diff --git a/README.md b/README.md
index fee9443..00d9708 100644
--- a/README.md
+++ b/README.md
@@ -15,14 +15,16 @@ validated dashboard model state inside the web app.
   persistence, Playwright e2e checks, and container build.
 - `packages/dashboard-model`: reusable dashboard schema, validation, and
   generic model fixtures shared by apps and tooling.
-- `packages/ui`: reusable dashboard React components, design tokens,
-  shadcn/radix primitives, generic fixtures, and Storybook. Component source is
-  grouped under `foundation`, `frames`, `operations`, and `telemetry` domains.
+- `packages/ui`: Git submodule for the reusable dashboard React components,
+  design tokens, shadcn/radix primitives, generic fixtures, and Storybook.
+  Component source is grouped under `foundation`, `frames`, `operations`, and
+  `telemetry` domains.
 - `docs/superpowers`: migration specs and execution plans used for this repo.
 
 ## Development
 
 ```sh
+git submodule update --init --recursive
 bun install
 bun run dev
 ```
@@ -127,6 +129,7 @@ The production build emits Vite client assets under `apps/web/dist/` and a Bun
 server entry at `apps/web/build/index.js`. A minimal deployment flow is:
 
 ```sh
+git submodule update --init --recursive
 bun install --frozen-lockfile
 bun run build
 cd apps/web
diff --git a/packages/ui b/packages/ui
index 000a3ac..a7a4720 160000
--- a/packages/ui
+++ b/packages/ui
@@ -1 +1 @@
-Subproject commit 000a3ac643f33328ad9fa84d9213d7f77ddcae6e
+Subproject commit a7a472083555152b8e1a2dc018d3be5b3b10d60b