chore: bump @hanzo/ui to v5.1.5

- Trigger on v* tags (matching @hanzo/ui version)
- Automatically check all 5 packages for new versions
- Only publish packages not yet on npm
- No need to track which packages need publishing
- Similar to python-sdk monorepo approach
- Creates GitHub release only when packages published
- Provides clear summary of published vs skipped packages

.claude/settings.local.json

@@ -0,0 +1,17 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(pnpm registry:build:*)",
+      "Bash(pnpm build:*)",
+      "Bash(pnpm add:*)",
+      "Bash(pnpm dev)",
+      "Bash(jq:*)",
+      "Bash(curl:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

.commitlintrc.json

@@ -1,3 +0,0 @@
-{
-  "extends": ["@commitlint/config-conventional"]
-}

.eslintignore

@@ -1,8 +0,0 @@
-node_modules/
-target/
-.next/
-build/
-dist/
-
-/templates/
-/fixtures/

.eslintrc.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/eslintrc",
-  "root": true,
-  "extends": [
-    "next/core-web-vitals",
-    "turbo",
-    "prettier",
-    "plugin:tailwindcss/recommended"
-  ],
-  "plugins": ["tailwindcss"],
-  "ignorePatterns": ["**/fixtures/**"],
-  "rules": {
-    "@next/next/no-html-link-for-pages": "off",
-    "tailwindcss/no-custom-classname": "off",
-    "tailwindcss/classnames-order": "error"
-  },
-  "settings": {
-    "tailwindcss": {
-      "callees": ["cn", "cva"],
-      "config": "tailwind.config.cjs"
-    },
-    "next": {
-      "rootDir": ["apps/*/"]
-    }
-  },
-  "overrides": [
-    {
-      "files": ["*.ts", "*.tsx"],
-      "parser": "@typescript-eslint/parser"
-    }
-  ]
-}

.github/DISCUSSION_TEMPLATE/blocks-request.yml

@@ -1,25 +0,0 @@
-title: "[blocks]: "
-labels: ["Blocks Request"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ### Thanks for taking the time to create a block request! Please search open/closed requests before submitting, as the block or a similar one may have already been requested.
-
-  - type: textarea
-    id: block-description
-    attributes:
-      label: Description
-      description: Tell us about your block request
-      placeholder: "A dashboard for an e-commerce website showing sales, orders, and customers..."
-    validations:
-      required: true
-
-  - type: input
-    id: block-example-url
-    attributes:
-      label: Example
-      description: Link to an example of the block
-      placeholder: ex. https://example.com
-    validations:
-      required: false

.github/FUNDING.yml

@@ -1,3 +0,0 @@
-# These are supported funding model platforms
-
-github: [shadcn]

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,85 +0,0 @@
-name: "Bug report"
-description: Report an issue
-title: '[bug]: '
-labels: ["bug"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ### Thanks for taking the time to create a bug report. Please search open/closed issues before submitting, as the issue may have already been reported/addressed.
- 
-  - type: markdown
-    attributes:
-      value: |
-        #### If you aren't sure this is a bug or not, please open a discussion instead:
-        - [Discussions](https://github.com/shadcn-ui/ui/discussions/new?category=general)
-
-  - type: textarea
-    id: bug-description
-    attributes:
-      label: Describe the bug
-      description: A clear and concise description of what the bug is. If you intend to submit a PR for this issue, tell us how in the description. Thanks!
-      placeholder: Bug description
-    validations:
-      required: true
-
-  - type: input
-    id: components-affected
-    attributes:
-      label: Affected component/components
-      description: Which shadcn/ui components are affected?
-      placeholder: ex. Button, Checkbox...
-    validations:
-      required: true
-
-  - type: textarea
-    id: reproduction
-    attributes:
-      label: How to reproduce
-      description:  A step-by-step description of how to reproduce the bug.
-      placeholder: |
-        1. Go to '...'
-        2. Click on '....'
-        3. See error
-    validations:
-      required: true
-
-  - type: input
-    id: codesandbox-stackblitz
-    attributes:
-      label: Codesandbox/StackBlitz link
-      description: | 
-        A link to a CodeSandbox or StackBlitz that includes a minimal reproduction of the problem. In rare cases when not applicable, you can link to a GitHub repository that we can easily run to recreate the issue. If a report is vague and does not have a reproduction, it will be closed without warning. 
-
-        > [!CAUTION]
-        > If you skip this step, this issue might be **labeled** with `please add a reproduction` and **closed**.
-    validations:
-      required: false
-
-  - type: textarea
-    id: logs
-    attributes:
-      label: Logs
-      description: "Please include browser console and server logs around the time this bug occurred. Optional if provided reproduction. Please try not to insert an image but copy paste the log text."
-      render: bash
-
-  - type: textarea
-    id: system-info
-    attributes:
-      label: System Info
-      description: Information about browsers, system or binaries that's relevant.
-      render: bash
-      placeholder: System, Binaries, Browsers
-    validations:
-      required: true
-
-  - type: checkboxes
-    id: terms
-    attributes:
-      label: Before submitting
-      description: By submitting this issue, you agree to follow our [Contributing Guidelines](https://github.com/shadcn-ui/ui/blob/main/CONTRIBUTING.md).
-      options:
-        - label: I've made research efforts and searched the documentation
-          required: true
-        - label: I've searched for existing issues
-          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +0,0 @@
-blank_issues_enabled: false
-contact_links:
-  - name: Get Help
-    url: https://github.com/shadcn-ui/ui/discussions/new?category=general
-    about: If you can't get something to work the way you expect, open a question in our discussion forums.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,55 +0,0 @@
-name: "Feature request"
-description: Create a feature request for shadcn/ui
-title: '[feat]: '
-labels: ['area: request']
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ### Thanks for taking the time to create a feature request! Please search open/closed issues before submitting, as the issue may have already been reported/addressed.
- 
-  - type: markdown
-    attributes:
-      value: |
-        #### If you aren't sure this is a bug or not, please open a discussion instead:
-        - [Discussions](https://github.com/shadcn-ui/ui/discussions/new?category=general)
-
-  - type: textarea
-    id: feature-description
-    attributes:
-      label: Feature description
-      description: Tell us about your feature request
-      placeholder: 'I think this feature would be great because...'
-      value: 'Describe your feature request...'
-    validations:
-      required: true
-
-  - type: input
-    id: components-affected
-    attributes:
-      label: Affected component/components
-      description: Is this feature request relevant to any of the already existing components?
-      placeholder: ex. Button, Checkbox...
-    validations:
-      required: false
-
-  - type: textarea
-    id: context
-    attributes:
-      label: Additional Context
-      description: Add any other context about the feature here.
-      placeholder: ex. screenshots, Stack Overflow links, forum links, etc.
-      value: 'Additional details here...'
-    validations:
-      required: false
-
-  - type: checkboxes
-    id: terms
-    attributes:
-      label: Before submitting
-      description: By submitting this issue, you agree to follow our [Contributing Guidelines](https://github.com/shadcn-ui/ui/blob/main/CONTRIBUTING.md).
-      options:
-        - label: I've made research efforts and searched the documentation
-          required: true
-        - label: I've searched for existing issues and PRs
-          required: true

.github/changeset-version.js

@@ -0,0 +1,12 @@
+// ORIGINALLY FROM CLOUDFLARE WRANGLER:
+// https://github.com/cloudflare/wrangler2/blob/main/.github/changeset-version.js
+
+import { exec } from "child_process"
+
+// This script is used by the `release.yml` workflow to update the version of the packages being released.
+// The standard step is only to run `changeset version` but this does not update the package-lock.json file.
+// So we also run `npm install`, which does this update.
+// This is a workaround until this is handled automatically by `changeset version`.
+// See https://github.com/changesets/changesets/issues/421.
+exec("npx changeset version")
+exec("npm install")

.github/dependabot.yml

@@ -1,46 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/astro-app"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/astro-monorepo"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/next-app"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/next-monorepo"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/react-router-app"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/react-router-monorepo"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/start-app"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/start-monorepo"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/vite-app"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "npm"
-    directory: "/templates/vite-monorepo"
-    schedule:
-      interval: "weekly"

.github/hero.svg

@@ -1,9 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="640" viewBox="0 0 1280 640" role="img" aria-label="ui">
-<rect width="1280" height="640" fill="#0A0A0A"/>
-<svg x="96" y="215" width="210" height="210" viewBox="0 0 67 67"><path d="M22.21 67V44.6369H0V67H22.21Z" fill="#fff"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z" fill="#fff"/><path d="M22.21 0H0V22.3184H22.21V0Z" fill="#fff"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z" fill="#fff"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z" fill="#fff"/></svg>
-<text x="378" y="276" font-family="Inter,system-ui,-apple-system,sans-serif" font-size="78" font-weight="800" letter-spacing="-2" fill="#ffffff">ui</text>
-<text x="378" y="322" font-family="Inter,system-ui,sans-serif" font-size="30" fill="#ffffff" opacity=".66">React component library for AI applications</text>
-<rect x="378" y="338" width="806" height="3" rx="1.5" fill="#ffffff" opacity=".9"/>
-<text x="378" y="390" font-family="Inter,system-ui,sans-serif" font-size="24" font-weight="600" fill="#ffffff" opacity=".5">github.com/hanzoai</text>
-<text x="1184" y="390" text-anchor="end" font-family="Inter,system-ui,sans-serif" font-size="24" font-weight="600" fill="#ffffff" opacity=".5">hanzo.ai</text>
-</svg>

.github/version-script-beta.js

@@ -4,7 +4,7 @@
 import { exec } from "child_process"
 import fs from "fs"
 
-const pkgJsonPath = "pkgs/shadcn/package.json"
+const pkgJsonPath = "pkg/cli/package.json"
 try {
   const pkg = JSON.parse(fs.readFileSync(pkgJsonPath))
   exec("git rev-parse --short HEAD", (err, stdout) => {

.github/version-script-next.js

@@ -4,7 +4,7 @@
 import { exec } from "child_process"
 import fs from "fs"
 
-const pkgJsonPath = "pkgs/shadcn/package.json"
+const pkgJsonPath = "pkg/cli/package.json"
 try {
   const pkg = JSON.parse(fs.readFileSync(pkgJsonPath))
   exec("git rev-parse --short HEAD", (err, stdout) => {

.github/workflows/ci.yml

@@ -0,0 +1,258 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+  pull_request:
+    branches:
+      - main
+      - develop
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run linting
+        run: pnpm run lint
+
+  typecheck:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run type checking
+        run: |
+          cd app && pnpm run typecheck
+          cd ../pkg/ui && pnpm run tc --noEmit
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build UI package
+        run: cd pkg/ui && pnpm run build:full
+
+      - name: Build app
+        run: cd app && pnpm run build
+        env:
+          NEXT_PUBLIC_APP_URL: https://ui.hanzo.ai
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-artifacts
+          path: |
+            app/.next
+            pkg/ui/dist
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run pkg/ui tests
+        run: cd pkg/ui && pnpm test -- --run
+
+      - name: Run app tests
+        run: |
+          if [ -f "app/package.json" ] && grep -q '"test"' app/package.json 2>/dev/null; then
+            cd app && pnpm test || echo "No tests configured"
+          else
+            echo "No test script found"
+          fi
+
+      - name: Upload coverage
+        if: always()
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./pkg/ui/coverage/lcov.info
+          flags: unit
+
+  deploy-preview:
+    name: Deploy Preview
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, build]
+    if: github.event_name == 'pull_request'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Install Vercel CLI
+        run: npm install --global vercel@latest
+
+      - name: Pull Vercel Environment Information
+        run: vercel pull --yes --environment=preview --token=${{ secrets.VERCEL_TOKEN }}
+        env:
+          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+
+      - name: Build Project Artifacts
+        run: vercel build --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Deploy Project Artifacts to Vercel
+        id: deploy
+        run: |
+          url=$(vercel deploy --prebuilt --token=${{ secrets.VERCEL_TOKEN }})
+          echo "preview_url=$url" >> $GITHUB_OUTPUT
+
+      - name: Comment PR with preview URL
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '🚀 Preview deployed to: ${{ steps.deploy.outputs.preview_url }}'
+            })
+
+  status:
+    name: CI Status
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, build, test]
+    if: always()
+    steps:
+      - name: Check status
+        run: |
+          if [ "${{ needs.lint.result }}" != "success" ] || \
+             [ "${{ needs.typecheck.result }}" != "success" ] || \
+             [ "${{ needs.build.result }}" != "success" ] || \
+             [ "${{ needs.test.result }}" != "success" ]; then
+            echo "CI checks failed"
+            exit 1
+          else
+            echo "All CI checks passed!"
+          fi

.github/workflows/code-check.yml

@@ -0,0 +1,116 @@
+name: Code check
+
+on:
+  pull_request:
+    branches: ["*"]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    name: pnpm lint
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18
+
+      - uses: pnpm/action-setup@v2.2.4
+        name: Install pnpm
+        id: pnpm-install
+        with:
+          version: 8.6.1
+          run_install: false
+
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        run: |
+          echo "pnpm_cache_dir=$(pnpm store path)" >> $GITHUB_OUTPUT
+      - uses: actions/cache@v3
+        name: Setup pnpm cache
+        with:
+          path: ${{ steps.pnpm-cache.outputs.pnpm_cache_dir }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+      - name: Install dependencies
+        run: pnpm install
+
+        #- run: pnpm lint
+
+  format:
+    runs-on: ubuntu-latest
+    name: pnpm format:check
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18
+
+      - uses: pnpm/action-setup@v2.2.4
+        name: Install pnpm
+        id: pnpm-install
+        with:
+          version: 8.6.1
+          run_install: false
+
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        run: |
+          echo "pnpm_cache_dir=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - uses: actions/cache@v3
+        name: Setup pnpm cache
+        with:
+          path: ${{ steps.pnpm-cache.outputs.pnpm_cache_dir }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - run: pnpm format:check
+
+  tsc:
+    runs-on: ubuntu-latest
+    name: pnpm typecheck
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18
+
+      - uses: pnpm/action-setup@v2.2.4
+        name: Install pnpm
+        id: pnpm-install
+        with:
+          version: 8.6.1
+          run_install: false
+
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        run: |
+          echo "pnpm_cache_dir=$(pnpm store path)" >> $GITHUB_OUTPUT
+      - uses: actions/cache@v3
+        name: Setup pnpm cache
+        with:
+          path: ${{ steps.pnpm-cache.outputs.pnpm_cache_dir }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+      - name: Install dependencies
+        run: pnpm install
+
+      - run: pnpm typecheck

.github/workflows/coverage.yml

@@ -0,0 +1,60 @@
+name: Test Coverage
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  coverage:
+    name: Test Coverage
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests with coverage
+        run: cd pkg/ui && pnpm test:coverage
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./pkg/ui/coverage/lcov.info
+          flags: unit
+          name: hanzo-ui-coverage
+
+      - name: Comment PR with coverage
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const coverage = JSON.parse(fs.readFileSync('./pkg/ui/coverage/coverage-summary.json', 'utf8'));
+            const total = coverage.total;
+            const comment = `## Test Coverage Report\n\n` +
+              `Lines: ${total.lines.pct}%\n` +
+              `Statements: ${total.statements.pct}%\n` +
+              `Functions: ${total.functions.pct}%\n` +
+              `Branches: ${total.branches.pct}%`;
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: comment
+            });

.github/workflows/deploy-gh-pages.yml

@@ -0,0 +1,78 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: |
+          pnpm install --frozen-lockfile
+
+      - name: Build documentation
+        working-directory: ./app
+        run: |
+          pnpm build
+          touch out/.nojekyll
+        env:
+          NODE_ENV: production
+          GITHUB_ACTIONS: true
+          NEXT_PUBLIC_APP_URL: https://ui.hanzo.ai
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./app/out
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/npm-publish.yml

@@ -0,0 +1,123 @@
+name: NPM Publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      package:
+        description: 'Package to publish'
+        required: true
+        type: choice
+        options:
+          - ui
+          - ui-mcp
+          - auth
+          - commerce
+          - brand
+          - react
+          - all
+      version_bump:
+        description: 'Version bump type'
+        required: true
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v3
+        with:
+          version: 8
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build packages
+        run: |
+          if [ "${{ github.event.inputs.package }}" = "all" ] || [ "${{ github.event.inputs.package }}" = "ui" ]; then
+            cd pkg/ui && pnpm build
+            cd ../..
+          fi
+          if [ "${{ github.event.inputs.package }}" = "all" ] || [ "${{ github.event.inputs.package }}" = "auth" ]; then
+            cd pkg/auth && pnpm build
+            cd ../..
+          fi
+          if [ "${{ github.event.inputs.package }}" = "all" ] || [ "${{ github.event.inputs.package }}" = "commerce" ]; then
+            cd pkg/commerce && pnpm build
+            cd ../..
+          fi
+          if [ "${{ github.event.inputs.package }}" = "all" ] || [ "${{ github.event.inputs.package }}" = "brand" ]; then
+            cd pkg/brand && pnpm build
+            cd ../..
+          fi
+          if [ "${{ github.event.inputs.package }}" = "all" ] || [ "${{ github.event.inputs.package }}" = "react" ]; then
+            cd pkg/react && pnpm build
+            cd ../..
+          fi
+
+      - name: Bump version and publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+        run: |
+          npm config set //registry.npmjs.org/:_authToken $NODE_AUTH_TOKEN
+          
+          publish_package() {
+            local pkg_dir=$1
+            cd $pkg_dir
+            npm version ${{ github.event.inputs.version_bump }}
+            npm publish --access public
+            cd -
+          }
+          
+          case "${{ github.event.inputs.package }}" in
+            ui)
+              publish_package "pkg/ui"
+              ;;
+            ui-mcp)
+              publish_package "pkg/ui-mcp"
+              ;;
+            auth)
+              publish_package "pkg/auth"
+              ;;
+            commerce)
+              publish_package "pkg/commerce"
+              ;;
+            brand)
+              publish_package "pkg/brand"
+              ;;
+            react)
+              publish_package "pkg/react"
+              ;;
+            all)
+              publish_package "pkg/ui"
+              publish_package "pkg/ui-mcp"
+              publish_package "pkg/auth"
+              publish_package "pkg/commerce"
+              publish_package "pkg/brand"
+              publish_package "pkg/react"
+              ;;
+          esac
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: 'chore: bump ${{ github.event.inputs.package }} version to ${{ github.event.inputs.version_bump }}'
+          title: 'chore: bump ${{ github.event.inputs.package }} version'
+          body: |
+            Automated version bump for ${{ github.event.inputs.package }} package(s).
+            
+            Version bump type: ${{ github.event.inputs.version_bump }}
+          branch: version-bump-${{ github.event.inputs.package }}-${{ github.run_number }}

.github/workflows/prerelease-comment.yml

@@ -0,0 +1,65 @@
+# Adapted from create-t3-app.
+name: Write Beta Release comment
+
+on:
+  workflow_run:
+    workflows: ["Release - Beta"]
+    types:
+      - completed
+
+jobs:
+  comment:
+    if: |
+      github.repository_owner == 'hanzoai-ui' &&
+      ${{ github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+    name: Write comment to the PR
+    steps:
+      - name: "Comment on PR"
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const allArtifacts = await github.rest.actions.listWorkflowRunArtifacts({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              run_id: context.payload.workflow_run.id,
+            });
+
+            for (const artifact of allArtifacts.data.artifacts) {
+              // Extract the PR number and package version from the artifact name
+              const match = /^npm-package-hanzoai-ui@(.*?)-pr-(\d+)/.exec(artifact.name);
+              
+              if (match) {
+                require("fs").appendFileSync(
+                  process.env.GITHUB_ENV,
+                  `\nBETA_PACKAGE_VERSION=${match[1]}` +
+                  `\nWORKFLOW_RUN_PR=${match[2]}` +
+                  `\nWORKFLOW_RUN_ID=${context.payload.workflow_run.id}`
+                );
+                break;
+              }
+            }
+
+      - name: "Comment on PR with Link"
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          number: ${{ env.WORKFLOW_RUN_PR }}
+          message: |
+            A new prerelease is available for testing:
+
+            ```sh
+            npx hanzoai-ui@${{ env.BETA_PACKAGE_VERSION }}
+            ```
+
+      - name: "Remove the autorelease label once published"
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            github.rest.issues.removeLabel({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: '${{ env.WORKFLOW_RUN_PR }}',
+              name: '🚀 autorelease',
+            });

.github/workflows/prerelease.yml

@@ -0,0 +1,60 @@
+# Adapted from create-t3-app.
+
+name: Release - Beta
+
+on:
+  pull_request:
+    types: [labeled]
+    branches:
+      - main
+jobs:
+  prerelease:
+    if: |
+      github.repository_owner == 'hanzoai' &&
+      contains(github.event.pull_request.labels.*.name, '🚀 autorelease')
+    name: Build & Publish a beta release to NPM
+    runs-on: ubuntu-latest
+    environment: Preview
+
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Use PNPM
+        uses: pnpm/action-setup@v2.2.4
+        with:
+          version: 8.6.1
+
+      - name: Use Node.js 18
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18
+          cache: "pnpm"
+
+      - name: Install NPM Dependencies
+        run: pnpm install
+
+      - name: Modify package.json version
+        run: node .github/version-script-beta.js
+
+      - name: Authenticate to NPM
+        run: echo "//registry.npmjs.org/:_authToken=$NPM_ACCESS_TOKEN" >> pkg/cli/.npmrc
+        env:
+          NPM_ACCESS_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
+
+      - name: Publish Beta to NPM
+        run: pnpm pub:beta
+
+      - name: get-npm-version
+        id: package-version
+        uses: martinbeentjes/npm-get-version-action@main
+        with:
+          path: pkg/cli
+
+      - name: Upload packaged artifact
+        uses: actions/upload-artifact@v2
+        with:
+          name: npm-package-hanzoai-ui@${{ steps.package-version.outputs.current-version }}-pr-${{ github.event.number }} # encode the PR number into the artifact name
+          path: pkg/cli/dist/index.js

.github/workflows/publish-on-tag.yml

@@ -0,0 +1,154 @@
+name: Publish on Tag
+
+on:
+  push:
+    tags:
+      - 'v*'  # Match @hanzo/ui version (e.g., v5.1.1)
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build packages
+        run: |
+          cd pkg/ui && pnpm build && cd ../..
+          cd pkg/auth && pnpm build && cd ../..
+          cd pkg/commerce && pnpm build && cd ../..
+          cd pkg/brand && pnpm build && cd ../..
+          cd pkg/react && pnpm build && cd ../..
+
+      - name: Run tests
+        run: |
+          cd pkg/ui && pnpm test
+          cd ../react && pnpm test
+          cd ../..
+
+  publish:
+    name: Publish to NPM
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v3
+        with:
+          version: 9
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build all packages
+        run: |
+          cd pkg/ui && pnpm build && cd ../..
+          cd pkg/auth && pnpm build && cd ../..
+          cd pkg/commerce && pnpm build && cd ../..
+          cd pkg/brand && pnpm build && cd ../..
+          cd pkg/react && pnpm build && cd ../..
+
+      - name: Configure npm authentication
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+        run: |
+          npm config set //registry.npmjs.org/:_authToken $NODE_AUTH_TOKEN
+          npm whoami
+
+      - name: Check and publish packages
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+        run: |
+          echo "Checking all packages for unpublished versions..."
+
+          PUBLISHED_COUNT=0
+          SKIPPED_COUNT=0
+          PUBLISHED_PACKAGES=""
+
+          for package in ui auth commerce brand react; do
+            cd "pkg/$package"
+
+            CURRENT_VERSION=$(node -p "require('./package.json').version")
+            PACKAGE_NAME=$(node -p "require('./package.json').name")
+
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo "📦 Checking $PACKAGE_NAME@$CURRENT_VERSION"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+            # Check if this version already exists on npm
+            if npm view "$PACKAGE_NAME@$CURRENT_VERSION" version 2>/dev/null; then
+              echo "⏭️  Already published - skipping"
+              SKIPPED_COUNT=$((SKIPPED_COUNT + 1))
+            else
+              echo "🚀 Publishing to npm..."
+              npm publish --access public
+              echo "✅ Successfully published $PACKAGE_NAME@$CURRENT_VERSION"
+              PUBLISHED_COUNT=$((PUBLISHED_COUNT + 1))
+              PUBLISHED_PACKAGES="$PUBLISHED_PACKAGES\n- $PACKAGE_NAME@$CURRENT_VERSION"
+            fi
+
+            cd ../..
+          done
+
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo "📊 Publishing Summary"
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo "✅ Published: $PUBLISHED_COUNT package(s)"
+          echo "⏭️  Skipped: $SKIPPED_COUNT package(s)"
+
+          if [ $PUBLISHED_COUNT -gt 0 ]; then
+            echo ""
+            echo -e "Published packages:$PUBLISHED_PACKAGES"
+          fi
+
+          # Save for GitHub release notes
+          echo "PUBLISHED_COUNT=$PUBLISHED_COUNT" >> $GITHUB_ENV
+          echo "PUBLISHED_PACKAGES<<EOF" >> $GITHUB_ENV
+          echo -e "$PUBLISHED_PACKAGES" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+      - name: Create GitHub Release
+        if: ${{ env.PUBLISHED_COUNT > 0 }}
+        uses: softprops/action-gh-release@v1
+        with:
+          generate_release_notes: true
+          body: |
+            ## 📦 NPM Packages Published
+
+            ${{ env.PUBLISHED_PACKAGES }}
+
+            ### Installation
+
+            ```bash
+            # Install latest versions
+            npm install @hanzo/ui @hanzo/auth @hanzo/commerce @hanzo/brand @hanzo/react
+            ```
+          files: |
+            CHANGELOG.md
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,53 @@
+# Adapted from create-t3-app.
+
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    if: ${{ github.repository_owner == 'hanzoai-ui' }}
+    name: Create a PR for release workflow
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Use PNPM
+        uses: pnpm/action-setup@v2.2.4
+        with:
+          version: 8.6.1
+
+      - name: Use Node.js 18
+        uses: actions/setup-node@v3
+        with:
+          version: 8.6.1
+          node-version: 18
+          cache: "pnpm"
+
+      - name: Install NPM Dependencies
+        run: pnpm install
+
+      # - name: Check for errors
+      #   run: pnpm check
+
+      - name: Build the package
+        run: pnpm build:cli
+
+      - name: Create Version PR or Publish to NPM
+        id: changesets
+        uses: changesets/action@v1.4.1
+        with:
+          commit: "chore(release): version packages"
+          title: "chore(release): version packages"
+          version: node .github/changeset-version.js
+          publish: npx changeset publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
+          NODE_ENV: "production"

.github/workflows/sync-forks.yml.disabled

@@ -0,0 +1,100 @@
+name: Sync Forks
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      fork:
+        description: 'Fork to sync (luxfi or zoo or all)'
+        required: false
+        default: 'all'
+
+jobs:
+  sync-luxfi:
+    if: github.event.inputs.fork == 'luxfi' || github.event.inputs.fork == 'all' || github.event_name == 'push'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Hanzo UI
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          
+      - name: Setup Git
+        run: |
+          git config --global user.name "Hanzo Bot"
+          git config --global user.email "bot@hanzo.ai"
+          
+      - name: Clone Luxfi Fork
+        run: |
+          git clone https://github.com/luxfi/ui.git luxfi-ui
+          cd luxfi-ui
+          git remote add upstream https://github.com/hanzoai/ui.git
+          git fetch upstream
+          
+      - name: Sync and Rebrand
+        run: |
+          cd luxfi-ui
+          # Merge upstream changes
+          git checkout main
+          git merge upstream/main --no-edit || true
+          
+          # Run rebrand script
+          cp ../scripts/rebrand.sh ./
+          chmod +x rebrand.sh
+          ./rebrand.sh luxfi
+          
+          # Commit changes
+          git add -A
+          git commit -m "sync: Update from hanzoai/ui and rebrand for Luxfi" || true
+          
+      - name: Push to Luxfi
+        env:
+          GITHUB_TOKEN: ${{ secrets.FORK_SYNC_TOKEN }}
+        run: |
+          cd luxfi-ui
+          git push https://$GITHUB_TOKEN@github.com/luxfi/ui.git main || true
+
+  sync-zoo:
+    if: github.event.inputs.fork == 'zoo' || github.event.inputs.fork == 'all' || github.event_name == 'push'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Hanzo UI
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          
+      - name: Setup Git
+        run: |
+          git config --global user.name "Hanzo Bot"
+          git config --global user.email "bot@hanzo.ai"
+          
+      - name: Clone Zoo Fork
+        run: |
+          git clone https://github.com/zooai/ui.git zoo-ui
+          cd zoo-ui
+          git remote add upstream https://github.com/hanzoai/ui.git
+          git fetch upstream
+          
+      - name: Sync and Rebrand
+        run: |
+          cd zoo-ui
+          # Merge upstream changes
+          git checkout main
+          git merge upstream/main --no-edit || true
+          
+          # Run rebrand script
+          cp ../scripts/rebrand.sh ./
+          chmod +x rebrand.sh
+          ./rebrand.sh zoo
+          
+          # Commit changes
+          git add -A
+          git commit -m "sync: Update from hanzoai/ui and rebrand for Zoo" || true
+          
+      - name: Push to Zoo
+        env:
+          GITHUB_TOKEN: ${{ secrets.FORK_SYNC_TOKEN }}
+        run: |
+          cd zoo-ui
+          git push https://$GITHUB_TOKEN@github.com/zooai/ui.git main || true

.github/workflows/test.yml

@@ -0,0 +1,58 @@
+name: E2E and Visual Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  schedule:
+    # Run tests daily at 2 AM UTC to catch breaking updates
+    - cron: '0 2 * * *'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 9.0.6
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Install Playwright browsers
+        run: pnpm exec playwright install --with-deps
+
+      - name: Build the project
+        run: pnpm build
+
+      - name: Run component health check
+        run: pnpm health-check
+        continue-on-error: true
+
+      - name: Run E2E tests
+        run: pnpm test:e2e
+
+      - name: Run visual regression tests
+        run: pnpm test:visual
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 30

.gitignore

@@ -56,28 +56,4 @@ QWEN.md
 
 .playwright-mcp
 app/out
-app/.source
 
-# test artifacts
-tests/reports/
-tests/artifacts/
-
-# Note: Block screenshots are pre-generated and committed
-# They cannot be generated in CI (requires display/browser)
-# app/public/r/styles/*/ -- REMOVED to allow committing screenshots
-
-
-# Test artifacts
-test-results/
-playwright-report/
-*BADGE_INSPECTION*.md
-*BADGE_INSPECTION*.txt
-
-# ide
-.idea
-.fleet
-
-.notes
-.claude/settings.local.json
-pkg/ui/dist-test/
-app/public/api/

.hanzo/workflows/cicd.yml

@@ -1,26 +0,0 @@
-# The whole caller. Every decision this pipeline makes — what to test, what to
-# build, where to roll it — is read from the root hanzo.yml, so this file only
-# ever names the triggers and the reusable.
-#
-# `.hanzo/workflows`, not `.github/workflows`, and that is not a style choice:
-# CI for this repo runs on git.hanzo.ai, which resolves ONLY `.hanzo/workflows`.
-# github.com has zero self-hosted runners registered for the `hanzo-build-*`
-# labels this pipeline asks for, so the same file under `.github/workflows`
-# would queue there forever and never report anything at all.
-name: CI/CD
-
-on:
-  push:
-    branches: [main]
-    tags: ['v*']
-  pull_request:
-  workflow_dispatch:
-
-concurrency:
-  group: cicd-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  cicd:
-    uses: hanzoai/ci/.hanzo/workflows/build.yml@v1
-    secrets: inherit

.hanzo/workflows/deploy.yml

@@ -1,70 +0,0 @@
-name: deploy
-
-# RETIRED as an automatic lane. The image is built by hanzo.yml's `images:` block
-# through hanzoai/ci (.hanzo/workflows/cicd.yml), and this job is kept only as a
-# manually-dispatched fallback.
-#
-# The reason is one capability, not tidiness. ui.hanzo.ai is a static export, so
-# its ingest key has to be BAKED IN at build; the key lives in KMS as
-# `deploy/PUBLISHABLE_KEY`, and hanzoai/ci is the only lane that reads it and
-# passes it as `--build-arg PUBLISHABLE_KEY=…`. The `docker build -t "$image" .`
-# below cannot — there is no KMS hop in it and nowhere to put the value — so any
-# image it produced would ship a client with no key at all, and cloud answers
-# `401 ingest_key_required` for an unattributed write. With the Dockerfile now
-# failing closed on an empty key, this job fails on every run instead of quietly
-# publishing an inert site.
-#
-# Left in place rather than deleted, and dispatch-only rather than on push:
-# deleting a repo's only build lane strands the host with no failing run to show
-# it, and two push-triggered builders for one image means one commit yields two
-# images under two tag schemes. Dispatching this publishes `<short-sha>` with an
-# EMPTY key and the Dockerfile will refuse it — so if you dispatch it, pass the
-# key yourself or expect the gate to fire.
-
-on:
-  workflow_dispatch:
-
-concurrency:
-  group: deploy-${{ github.ref }}
-  cancel-in-progress: false
-
-jobs:
-  image:
-    # hanzo-build-linux-amd64, not ubuntu-latest. This file lives in
-    # .hanzo/workflows, which GitHub never reads -- git.hanzo.ai is the only
-    # thing that can run it, and the fleet deliberately advertises no generic
-    # ubuntu-* label (~1400 mirrored forks all ask for it; one bad job was
-    # retried ~520 times across 10 runners). An unmatched label is not an
-    # error here, it is silence: the job queues until the 24h timeout, so this
-    # deploy has never produced an image and nothing ever said so.
-    runs-on: hanzo-build-linux-amd64
-    timeout-minutes: 60
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: build and push
-        # GHCR_TOKEN/GHCR_USER, which are the org secrets that actually exist.
-        # This job asked for REGISTRY_TOKEN, which was never defined anywhere —
-        # the org has exactly GHCR_TOKEN, GHCR_USER, GH_PAT, KMS_CLIENT_ID,
-        # KMS_CLIENT_SECRET, OCI_TOKEN, OCI_USER — so the guard below fired on
-        # every run and nothing was ever published. Every other image build in
-        # the org already uses the GHCR_* pair; this file and papers were the
-        # two that invented a name.
-        #
-        # The username comes from the secret too, rather than being hardcoded to
-        # hanzo-dev, so rotating the publishing identity is one org-level change.
-        env:
-          GHCR_TOKEN: ${{ secrets.GHCR_TOKEN }}
-          GHCR_USER: ${{ secrets.GHCR_USER }}
-        run: |
-          set -euo pipefail
-          if [ -z "${GHCR_TOKEN:-}" ] || [ -z "${GHCR_USER:-}" ]; then
-            echo "::error::GHCR_TOKEN/GHCR_USER are unset, so nothing was published."
-            exit 1
-          fi
-          tag="$(git rev-parse --short HEAD)"
-          image="ghcr.io/hanzoai/ui:${tag}"
-          echo "${GHCR_TOKEN}" | docker login ghcr.io -u "${GHCR_USER}" --password-stdin
-          docker build -t "${image}" .
-          docker push "${image}"
-          echo "published ${image} — set image.tag AND image.digest in universe charts/app/values/hanzo/ui.yaml"

.hanzo/workflows/publish.yml

@@ -1,343 +0,0 @@
-name: Publish Packages
-
-on:
-  push:
-    branches: [main]
-    paths:
-      # BOTH package roots, and the singular one is not a typo — `@hanzo/ui` and
-      # `@hanzo/data` live under pkg/, everything else under pkgs/.
-      #
-      # ⚠️ This list and the `for pkg_json in …` loop below are ONE FACT. The loop
-      # was already fixed to walk both roots, with a comment explaining that a
-      # `pkgs/*` glob made pkg/ packages invisible — but this gate was left
-      # matching `pkgs/*` only, so for a pkg/-only change the corrected job could
-      # never be REACHED. The fix was reasoned about in the body and not applied
-      # to the thing that decides whether the body runs.
-      #
-      # Cost: @hanzo/ui 8.0.29 sat unpublished while npmjs served 8.0.28, so
-      # every consumer resolving `^8.0.17` silently got a version without the
-      # `./chat` entrypoint — an import error in the dependent, nothing at all in
-      # this repo. Add a root here whenever one is added to the loop.
-      - 'pkg/*/package.json'
-      - 'pkgs/*/package.json'
-  # A publish that fails for an infrastructure reason — the runner missing a
-  # tool, npmjs answering slowly — could only be retried by pushing another
-  # commit that touches a package.json, i.e. by burning a version number to
-  # re-run a job that was never wrong about the code. detect-changes reads what
-  # npmjs SERVES, so a dispatch is idempotent by construction: it publishes
-  # exactly the packages that are ahead of the registry, and nothing when none
-  # are.
-  workflow_dispatch:
-
-jobs:
-  detect-changes:
-    runs-on: hanzo-build-linux-amd64
-    outputs:
-      packages: ${{ steps.changed.outputs.packages }}
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 2
-
-      - name: Detect changed packages
-        id: changed
-        run: |
-          CHANGED=()
-          # Both package roots. `@hanzo/ui` and `@hanzo/data` live under pkg/ (singular)
-          # and were invisible to a `pkgs/*` glob, so no version bump of either could
-          # ever reach npmjs from here.
-          for pkg_json in pkg/*/package.json pkgs/*/package.json; do
-            [ ! -f "$pkg_json" ] && continue
-            # Skip private packages
-            IS_PRIVATE=$(jq -r '.private // false' "$pkg_json")
-            [ "$IS_PRIVATE" = "true" ] && continue
-
-            # Only publish @hanzo/* packages
-            PKG_NAME=$(jq -r '.name' "$pkg_json")
-            case "$PKG_NAME" in
-              @hanzo/*) ;;
-              *) continue ;;
-            esac
-
-            # What npm SERVES, not what the previous commit said. HEAD~1 is the
-            # FIRST PARENT, so a merge whose first parent is the feature branch
-            # already carries the new version and the diff is empty — the publish
-            # is skipped and npm keeps serving the old release, silently. Asking
-            # the registry is independent of merge topology and of how many
-            # commits the runner fetched.
-            NEW=$(jq -r '.version' "$pkg_json")
-            OLD=$(curl -sf "https://registry.npmjs.org/${PKG_NAME}" \
-                    | jq -r '."dist-tags".latest // "0.0.0"' 2>/dev/null || echo "0.0.0")
-
-            # FORWARD ONLY. `!=` fires in both directions, and several packages
-            # sit BEHIND npm (a release cut elsewhere, a revert) — publishing
-            # those walks the registry backwards. Only a strictly greater local
-            # version is a release.
-            NEWEST=$(printf '%s\n%s\n' "$OLD" "$NEW" | sort -V | tail -1)
-            if [ "$OLD" != "$NEW" ] && [ "$NEWEST" = "$NEW" ]; then
-              echo "Version change: $PKG_NAME ($OLD -> $NEW)"
-              # The package NAME, because every downstream step spends this as a
-              # `pnpm --filter` argument and a directory basename matches nothing.
-              # An unmatched filter exits 0, so the build silently no-ops and the
-              # publish ships an unbuilt tarball — how 8.0.17 and 8.0.19 shipped broken.
-              CHANGED+=("$PKG_NAME")
-            fi
-          done
-
-          if [ ${#CHANGED[@]} -eq 0 ]; then
-            echo "packages=[]" >> $GITHUB_OUTPUT
-          else
-            JSON=$(printf '%s\n' "${CHANGED[@]}" | jq -R . | jq -s -c .)
-            echo "packages=$JSON" >> $GITHUB_OUTPUT
-          fi
-
-  publish:
-    needs: detect-changes
-    if: needs.detect-changes.outputs.packages != '[]'
-    runs-on: hanzo-build-linux-amd64
-    strategy:
-      # One package's broken build must not withhold every other package's
-      # release: the matrix legs are independent publishes, not one artifact.
-      fail-fast: false
-      matrix:
-        package: ${{ fromJson(needs.detect-changes.outputs.packages) }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: pnpm/action-setup@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: pnpm install
-
-      - name: Build package
-        # The trailing `...` is load-bearing: it builds the package's WORKSPACE
-        # DEPENDENCIES first, in topological order.
-        #
-        # Without it, `pnpm --filter @hanzo/ui build` runs alone against siblings
-        # that have no `dist/`. Those siblings type themselves through
-        # `"types": "dist/index.d.ts"`, so tsc reports them as missing modules and
-        # the errors do not name the real cause:
-        #   src/product/SiteNav.tsx: Cannot find module '@hanzo/products'
-        #   src/core/tokens.ts:      Cannot find module '@hanzo/tokens'
-        #   src/gitops.ts:           Cannot find module '@hanzo/cd'
-        # plus a wave of implicit-any errors in the files that imported them,
-        # which read like a source problem in @hanzo/ui and are not.
-        run: pnpm --filter ${{ matrix.package }}... build
-
-      - name: Provision bun (only for a package whose test script asks for it)
-        # @hanzo/canvas declares `bun test` and this runner has no bun, so its
-        # suite has been `spawn ENOENT` on every run — which fails the leg before
-        # the publish and is why canvas has sat at 0.2.2 here against 0.2.1 on
-        # npmjs. The step that exists to stop an untested release was itself the
-        # thing stopping the release.
-        #
-        # Read from the package's OWN manifest, not from a list here, so a
-        # package that adopts or drops bun needs no edit to this file. A package
-        # that does not ask for bun does not pay for it.
-        run: |
-          set -euo pipefail
-          PKG_DIR=$(pnpm --filter ${{ matrix.package }} exec pwd | tail -1)
-          if ! jq -r '.scripts.test // ""' "$PKG_DIR/package.json" | grep -qw bun; then
-            echo "::notice::${{ matrix.package }} does not run bun"
-            exit 0
-          fi
-          if command -v bun >/dev/null 2>&1; then
-            echo "bun already on PATH: $(bun --version)"
-            exit 0
-          fi
-          # From npmjs, not bun.sh/install: this job already reaches the npm
-          # registry (it is what the job exists to publish to) and setup-node
-          # already put the global bin on PATH, so this adds no new host to
-          # trust and no new failure mode. The shell installer would also want
-          # unzip, which a minimal runner image need not carry.
-          npm install -g bun
-          bun --version
-
-      - name: Test package
-        # A published version is IMMUTABLE, so this is the last point at which a
-        # defect costs nothing. Nothing else runs a package's own tests before it
-        # ships: ci.yml's test job runs `cd pkgs/ui && …` — that one directory —
-        # and this workflow went checkout → build → publish. So @hanzo/event's
-        # suite, which pins the version the client stamps on every event, ran in
-        # no workflow that gates a release, and the stale stamp it was written to
-        # catch could still have reached npmjs.
-        #
-        # `--if-present` so a package with no test script is skipped rather than
-        # failing the release: the set of testable packages is read from each
-        # package.json, not listed here, so a new package is covered the day it
-        # adds a `test` script.
-        #
-        # This step needs `test` to mean the same thing in every package — the
-        # package's own suite, no browser, no network. @hanzo/ui briefly chained
-        # its two CONSUMER suites onto it (pack a tarball, npm-install it into a
-        # throwaway app, drive it in chromium), which is a real gate and belongs
-        # exactly where hanzo.yml already runs it: on the push, in its own
-        # `ui-consumer` job, next to the `playwright install` that gives it a
-        # browser. Here there is no such step, so a chained `test` could only
-        # fail — the last gate before an immutable version would have been one
-        # that cannot pass, which is the failure mode this repo has already paid
-        # for twice.
-        run: pnpm --filter ${{ matrix.package }} run --if-present test
-
-      - name: Verify the tarball carries what package.json promises
-        # `types` is a PROMISE to every consumer, and tsup writes dist/*.mjs in a
-        # separate pass from dist/*.d.ts — so a declaration failure yields a
-        # package whose JS is fine and whose types are absent. That is invisible
-        # here and surfaces in dependents as "Could not find a declaration file".
-        #
-        # Asserted from the package's OWN manifest, so it holds for every package
-        # this workflow publishes and needs no per-package list.
-        run: |
-          set -euo pipefail
-          PKG_DIR=$(pnpm --filter ${{ matrix.package }} exec pwd | tail -1)
-          TYPES=$(jq -r '.types // .typings // empty' "$PKG_DIR/package.json")
-          if [ -z "$TYPES" ]; then
-            echo "::notice::${{ matrix.package }} declares no types entrypoint — nothing to verify"
-            exit 0
-          fi
-          if [ ! -f "$PKG_DIR/$TYPES" ]; then
-            echo "::error::${{ matrix.package }} declares types at $TYPES but the build produced no such file."
-            echo "::error::Publishing would ship a package that silently has no types. Fix the declaration build."
-            exit 1
-          fi
-          echo "types present: $TYPES"
-
-      - name: Fetch the npm token from KMS
-        id: npmtok
-        # publish.yml used secrets.NPM_TOKEN, which exists on NEITHER the hanzoai
-        # org nor this repo on git.hanzo.ai. An absent secret interpolates to the
-        # empty string rather than failing, so every publish reached npmjs
-        # unauthenticated and 401'd -- the reason @hanzo/ui has never shipped from
-        # CI and each release was a hand publish.
-        #
-        # KMS is where a secret lives, so the token is read at run time from the
-        # same org path and with the same machine identity every other workflow
-        # here already uses. Nothing new to rotate, and no npm credential is
-        # stored on the forge.
-        env:
-          KMS_CLIENT_ID: ${{ secrets.KMS_CLIENT_ID }}
-          KMS_CLIENT_SECRET: ${{ secrets.KMS_CLIENT_SECRET }}
-          KMS_ENDPOINT: ${{ vars.KMS_ENDPOINT || 'https://kms.hanzo.ai' }}
-          KMS_ORG: ${{ vars.KMS_ORG || 'hanzo' }}
-          KMS_SECRET_ENV: ${{ vars.KMS_SECRET_ENV || 'prod' }}
-          # Where the token actually lives, MEASURED: NPM_TOKEN sits at the org
-          # root, not under deploy/ (which holds CLOUDFLARE_*, GIT_TOKEN,
-          # KUBECONFIG, UNIVERSE_PIN_TOKEN). Empty means root; set the
-          # KMS_NPM_PATH variable to move it without editing this file.
-          KMS_NPM_PATH: ${{ vars.KMS_NPM_PATH || '' }}
-        run: |
-          token=$(curl -fsS "${KMS_ENDPOINT}/v1/kms/auth/login" \
-            -H 'Content-Type: application/json' \
-            -d "{\"clientId\":\"${KMS_CLIENT_ID}\",\"clientSecret\":\"${KMS_CLIENT_SECRET}\"}" \
-            | jq -r '.accessToken // empty')
-          if [ -z "${token}" ]; then
-            echo "::error::KMS login failed at ${KMS_ENDPOINT}/v1/kms/auth/login (check KMS_CLIENT_ID/KMS_CLIENT_SECRET)."
-            exit 1
-          fi
-          # The read is org-scoped by the TOKEN's owner claim, not by a path
-          # segment: the flat form is the contract cloud's embedded KMS serves,
-          # and it answers {name, env, value}. The older
-          # /v1/kms/orgs/<org>/secrets/... form with .secret.value 404s here.
-          secret_url="${KMS_ENDPOINT}/v1/kms/secrets/${KMS_NPM_PATH:+${KMS_NPM_PATH}/}NPM_TOKEN?env=${KMS_SECRET_ENV}"
-          # No -f: a 404 must report WHICH path was empty, not just exit 22.
-          npm_token=$(curl -sS "${secret_url}" -H "Authorization: Bearer ${token}" | jq -r '.value // empty')
-          if [ -z "${npm_token}" ]; then
-            echo "::error::No NPM_TOKEN at ${secret_url}."
-            echo "::error::Put it there, or set the KMS_NPM_PATH variable to the path that has it."
-            exit 1
-          fi
-          # Masked before it is ever an output, so it cannot surface in a log.
-          echo "::add-mask::${npm_token}"
-          echo "token=${npm_token}" >> "$GITHUB_OUTPUT"
-
-      - name: Publish package
-        # Idempotent on purpose: the desired state is "npmjs holds this version", and
-        # a version already there satisfies it. Versions are immutable, so a conflict
-        # means the release already happened (a re-run, or a hand publish) — that is
-        # success, not a failure. Every other error still fails the job.
-        env:
-          NODE_AUTH_TOKEN: ${{ steps.npmtok.outputs.token }}
-        run: |
-          set -o pipefail
-          OUT=$(pnpm --filter ${{ matrix.package }} publish \
-            --no-git-checks --access public 2>&1) || true
-          echo "$OUT"
-          case "$OUT" in
-            *EPUBLISHCONFLICT*|*"cannot publish over"*|*"previously published versions"*)
-              echo "::notice::${{ matrix.package }} is already on npmjs at this version — nothing to do" ;;
-            *)
-              # Not a conflict: confirm the version really landed, else fail loudly.
-              #
-              # RETRIED, because npmjs is read-after-write eventually consistent
-              # and this asked it exactly once, about two seconds after the
-              # write. On run 26906 both @hanzo/og@1.0.0 and @hanzo/shop@1.0.0
-              # failed here having printed npm's own `+ @hanzo/og@1.0.0` success
-              # line moments earlier, and both are on the registry now: the
-              # publishes worked and the check was simply too early.
-              #
-              # A false red here is worse than a slow green. It reports that a
-              # release did not happen when it did, so the next person bumps the
-              # version to "fix" it and burns a number over a replication lag —
-              # and the real signal, a publish that genuinely failed, becomes
-              # indistinguishable from the noise.
-              PKG_DIR=$(pnpm --filter ${{ matrix.package }} exec pwd | tail -1)
-              NAME=$(jq -r '.name' "$PKG_DIR/package.json")
-              WANT=$(jq -r '.version' "$PKG_DIR/package.json")
-              landed=
-              for attempt in 1 2 3 4 5 6; do
-                if npm view "$NAME@$WANT" version >/dev/null 2>&1; then landed=1; break; fi
-                echo "$NAME@$WANT not visible to npmjs yet (attempt $attempt/6); waiting 10s"
-                sleep 10
-              done
-              [ -n "$landed" ] \
-                || { echo "::error::$NAME@$WANT is not on npmjs 60s after publish"; exit 1; }
-              echo "published $NAME@$WANT" ;;
-          esac
-
-      - name: Publish to the Hanzo registry
-        # Second home for the same tarball: api.hanzo.ai/v1/packages/hanzo/npm, our
-        # own registry (hanzoai/git), so an install does not have to reach npmjs.
-        # Same artifact, same version — this republishes what the step above just
-        # built, it does not rebuild or re-version.
-        #
-        # BEST-EFFORT by construction. No token ⇒ skip with a notice, so this can
-        # land before the credential exists and starts working the moment it does.
-        # An already-published version is a success, not a failure: the registry
-        # holding it is the desired state either way. npmjs is authoritative and is
-        # never affected by anything here.
-        env:
-          # REGISTRY_TOKEN is the fleet-wide name (six other workflows use it and
-          # the hanzoai org carries it). This asked for HANZO_REGISTRY_TOKEN, which
-          # is defined nowhere, so it read as empty and the step below took its
-          # "not set" branch and exited 0 on every run -- the mirror to
-          # api.hanzo.ai has never happened, and said so only as a notice.
-          HANZO_REGISTRY_TOKEN: ${{ secrets.REGISTRY_TOKEN }}
-        run: |
-          set -uo pipefail
-          if [ -z "${HANZO_REGISTRY_TOKEN:-}" ]; then
-            echo "::notice::HANZO_REGISTRY_TOKEN not set — package published to npmjs only."
-            echo "::notice::Add it (a Hanzo Git token with package:write) to mirror to api.hanzo.ai."
-            exit 0
-          fi
-          REG=https://api.hanzo.ai/v1/packages/hanzo/npm/
-          NPMRC="$RUNNER_TEMP/.npmrc-hanzo"
-          {
-            echo "@hanzo:registry=${REG}"
-            echo "//api.hanzo.ai/v1/packages/hanzo/npm/:_authToken=${HANZO_REGISTRY_TOKEN}"
-          } > "$NPMRC"
-          out=$(npm_config_userconfig="$NPMRC" \
-                pnpm --filter ${{ matrix.package }} publish \
-                  --no-git-checks --access public --registry "$REG" 2>&1) || true
-          echo "$out"
-          case "$out" in
-            *EPUBLISHCONFLICT*|*"cannot publish over"*|*"already exists"*)
-              echo "::notice::already in the Hanzo registry at this version — nothing to do" ;;
-            *) echo "$out" | grep -qiE 'error|failed' \
-                 && echo "::warning::mirror to api.hanzo.ai failed (npmjs publish unaffected)" \
-                 || echo "mirrored to the Hanzo registry" ;;
-          esac

.hanzo/workflows/registries.yml

@@ -1,91 +0,0 @@
-name: Validate Registries
-
-on:
-  pull_request:
-    paths:
-      - "apps/v4/public/r/registries.json"
-      - "apps/v4/registry/directory.json"
-  push:
-    branches:
-      - main
-    paths:
-      - "apps/v4/public/r/registries.json"
-      - "apps/v4/registry/directory.json"
-
-jobs:
-  validate:
-    runs-on: hanzo-build-linux-amd64
-    name: pnpm validate:registries
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Install Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 20
-
-      - name: Block reserved registry namespaces
-        env:
-          RESERVED_NAMESPACES: "@shadcn,@ui,@blocks,@components,@block,@component,@util,@utils,@registry,@lib,@hook,@hooks,@theme,@themes,@chart,@charts"
-        run: |
-          node <<'EOF'
-          const fs = require("node:fs")
-
-          const files = [
-            "apps/v4/public/r/registries.json",
-            "apps/v4/registry/directory.json",
-          ]
-          const reservedNamespaces = new Set(
-            process.env.RESERVED_NAMESPACES.split(",").filter(Boolean)
-          )
-
-          function readNames(filePath) {
-            return JSON.parse(fs.readFileSync(filePath, "utf8")).map(
-              (entry) => entry.name
-            )
-          }
-
-          const violations = files.flatMap((filePath) => {
-            return readNames(filePath)
-              .filter((name) => reservedNamespaces.has(name))
-              .map((name) => `${filePath}: ${name}`)
-          })
-
-          if (violations.length > 0) {
-            console.error("Reserved registry namespaces are not allowed:")
-
-            for (const violation of violations) {
-              console.error(`- ${violation}`)
-            }
-
-            process.exit(1)
-          }
-          EOF
-
-      - uses: pnpm/action-setup@v4
-        name: Install pnpm
-        id: pnpm-install
-        with:
-          version: 9.0.6
-          run_install: false
-
-      - name: Get pnpm store directory
-        id: pnpm-cache
-        run: |
-          echo "pnpm_cache_dir=$(pnpm store path)" >> $GITHUB_OUTPUT
-      - uses: actions/cache@v3
-        name: Setup pnpm cache
-        with:
-          path: ${{ steps.pnpm-cache.outputs.pnpm_cache_dir }}
-          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
-          restore-keys: |
-            ${{ runner.os }}-pnpm-store-
-      - name: Install dependencies
-        run: pnpm install
-
-      - name: Validate registries
-        run: pnpm --filter=v4 validate:registries

.kodiak.toml

@@ -1,18 +0,0 @@
-# .kodiak.toml
-version = 1
-
-[merge]
-automerge_label = "automerge"
-require_automerge_label = true
-method = "squash"
-delete_branch_on_merge = true
-optimistic_updates = false
-prioritize_ready_to_merge = true
-notify_on_conflict = true
-
-[merge.message]
-title = "pull_request_title"
-body = "pull_request_body"
-include_pr_number = true
-body_type = "markdown"
-strip_html_comments = true

.npmrc

@@ -1,3 +0,0 @@
-auto-install-peers=true
-link-workspace-packages=true
-puppeteer_skip_download=true

.nvmrc

@@ -1 +0,0 @@
-v20.5.1

.prettierignore

@@ -1,14 +0,0 @@
-dist
-node_modules
-.next
-build
-.contentlayer
-**/fixtures
-deprecated
-apps/v4/registry/styles/**/*.css
-
-# Byte-coupled: hz.js carries the marked region of src/anon.js VERBATIM, and
-# pkgs/event/src/anon.test.ts compares them byte for byte. Reformatting either
-# one alone breaks the build; the same region is also vendored by hanzoai/cloud.
-pkgs/event/src/anon.js
-pkgs/event/hz.js

.vscode/settings.json

@@ -1,24 +1,5 @@
 {
   "typescript.tsdk": "node_modules/.pnpm/typescript@5.3.3/node_modules/typescript/lib",
   "editor.gotoLocation.multipleDefinitions": "goto",
-  "typescript.preferences.quoteStyle": "single",
-  "eslint.workingDirectories": [
-    { "pattern": "apps/*/" },
-    { "pattern": "pkgs/*/" },
-    { "pattern": "pkgs/*/" }
-  ],
-  "tailwindCSS.classFunctions": ["cva", "cn"],
-  "vitest.debugExclude": [
-    "<node_internals>/**",
-    "**/node_modules/**",
-    "**/fixtures/**"
-  ],
-  "files.exclude": {
-    "deprecated": true
-  },
-  "search.exclude": {
-    "apps/v4/registry/radix-*": true,
-    "apps/v4/public/r/*": true,
-    "pkgs/shadcn/test/fixtures/*": true
-  }
+  "typescript.preferences.quoteStyle": "single"
 }

CONSOLIDATION.md

@@ -1,190 +0,0 @@
-# Hanzo UI Consolidation — one library, all polish, no duplication
-
-**Goal.** RIP the fragmentation (`@hanzo/data` vs `@hanzo/ui` vs in-console duplicates) into ONE canonical, cross-platform, presentational, clean-room library: **`@hanzo/ui`, built on `@hanzo/gui`**. Preserve every polished component + token; zero loss; no fork.
-
-**Status.**
-- **Step 1 — Audit:** complete (this document; four source trees read file-by-file).
-- **Step 2 — Establish `@hanzo/ui` + migrate the stable foundation:** **DONE & GREEN** (`pkg/ui` is now a real package; `tsc --noEmit` = 0 errors, `vitest` = 12/12).
-- **Step 3 — Console re-point:** **STAGED, not merged.** Gate is split (backend live, app lanes in-flight) — see [Step 3](#step-3--console-re-point-staged).
-
-**One decision needs CTO sign-off before publish** — see [Naming / version](#naming--version--the-one-decision).
-
----
-
-## Architecture — three layers, decomplected
-
-```
-@hanzo/gui   (Tamagui/One)   cross-platform primitives: Text, XStack/YStack, Button, Input,
-   │                          Card, Popover, Select, Switch, Slider, Spinner, ScrollView …
-   ▼
-@hanzo/data  (pkg/data)      the metadata-driven RECORD layer: fields → records → views
-   │                          (RecordsView, DataTable, BoardView, RecordDetail, field editors)
-   ▼
-@hanzo/ui    (pkg/ui)  ◄──── THE ONE LIBRARY. Two orthogonal concerns, one package:
-                              • product/app layer  →  import { … } from '@hanzo/ui'
-                              • record layer        →  import { … } from '@hanzo/ui/data'  (re-exports @hanzo/data)
-```
-
-`@hanzo/data` stays the **source of truth** for the record layer; `@hanzo/ui` **composes** it (`export * from '@hanzo/data'` on the `./data` subpath) rather than copying — so the CMS/ERP/Help app lanes that consume `@hanzo/data` today keep working untouched, and there is exactly one home. This mirrors how the gui base wraps `hanzogui`.
-
-Both layers own a `DataTable` (product = generic typed `<T>` list; data = field-driven record grid). Keeping the record layer on the `./data` subpath keeps each name unambiguous — no rename, no collision.
-
----
-
-## The preserve-and-merge manifest
-
-Legend: **✅ migrated** (in `pkg/ui`, GREEN) · **↪ re-exported** (composed from `@hanzo/data`) · **⏳ staged** (Step 3, after app lanes land) · **🔧 pending prop-injection** (app-coupled; decouple before it can live in a presentational lib) · **🏠 stays in console** (app glue, not a UI component).
-
-### A. Record layer — `@hanzo/data` → `@hanzo/ui/data`  ↪
-
-Source: `pkg/data/src/*` (v1.2.0, clean-room, already published). Surfaced through `@hanzo/ui/data` and `@hanzo/ui/primitives/bases/data`. Nothing re-implemented.
-
-| Component / module | Source | New home |
-|---|---|---|
-| `RecordsView` (flagship: toolbar over table⇆board, filter/sort/search/group, saved views) | `view/RecordsView.tsx`, `view/Toolbar.tsx` | `@hanzo/ui/data` |
-| `DataTable` (field-driven record grid: sort headers, drag resize/reorder, row select, inline edit, pagination) | `table/DataTable.tsx` | `@hanzo/ui/data` |
-| `BoardView` (kanban, optimistic drag-move) · `RecordCard` | `board/BoardView.tsx`, `table/RecordCard.tsx` | `@hanzo/ui/data` |
-| `RecordDetail` / `RecordForm` | `record/RecordDetail.tsx` | `@hanzo/ui/data` |
-| Field model + registry (`FieldType` ×24, `FieldDefinition`, `registerField`, routers) | `field/{types,registry,registerDefaults,FieldDisplay,FieldInput}` | `@hanzo/ui/data` |
-| Field displays + **editors** (select/currency/date/relation/file/JSON/boolean/fullName/address…) | `field/{displays,inputs}.tsx` | `@hanzo/ui/data` |
-| Composable primitives: `Menu`, `CheckBox`, `Toggle`, `Calendar` | `primitives/*` | `@hanzo/ui/data` |
-| Pure logic: `applyView`, `sortRecords`, `filterRecords`, `searchRecords`, `paginate`, `boardColumns`, … | `{table,board,view}/logic.ts` | `@hanzo/ui/data` (+ `@hanzo/data/*/logic` subpaths for Node hosts) |
-| Tokens: `tokens`, `TAG_TONES`, `tagTone` | `theme.ts` | **also top-level `@hanzo/ui`** (token surface) |
-
-### B. Console `components/ui/*` product primitives → `@hanzo/ui/product`  ✅ / 🔧
-
-Source: `console2/src/components/ui/*`. The pure subset was ported **byte-identical** (verified by `diff`) — 100% of the polish preserved (Charts' hover tooltips/axis-ticks/honest-null, DataTable width/flex/hover-gating, Field's 6 variants, SlideOver's focus-trap + scroll-lock, ComboBox's ReDoS-safe filter).
-
-| Component | Source (`console2/src/components/ui/`) | New home | Status |
-|---|---|---|---|
-| `DataTable<T>` (generic typed list) + `Column` | `DataTable.tsx` | `@hanzo/ui` (`product/DataTable`) | ✅ |
-| `PageHeader` | `PageHeader.tsx` | `@hanzo/ui` | ✅ |
-| `Field*` (`FieldRow/Text/TextArea/Switch/Select/Slider`) | `Field.tsx` | `@hanzo/ui` | ✅ |
-| **Charts** (`Sparkline/LineChart/BarChart/Donut/BarRows`, `CHART_PALETTE`) | `Charts.tsx` | `@hanzo/ui` | ✅ |
-| `Donut` (standalone dependency-free ring) | `Donut.tsx` | `@hanzo/ui` as **`DonutRing`** (alias — Charts.Donut is canonical) | ✅ |
-| `StatusTag` (health verdict → pill) | `StatusTag.tsx` | `@hanzo/ui` | ✅ |
-| `EmptyState` (DO/Vercel-class first-run) | `EmptyState.tsx` | `@hanzo/ui` | ✅ (**decoupled** — see §I) |
-| `Metric*` (`MetricCard/MiniBars/UtilBar/LegendDot/Panel/HintButton`, `SERIES`) | `Metric.tsx` | `@hanzo/ui` (its `Sparkline` preserved as **`MetricSparkline`**) | ✅ |
-| `ComboBox` + pure `filterOptions`/`isKnownOption` | `ComboBox.tsx`, `combobox/filter.ts` | `@hanzo/ui` | ✅ (+ `filter.test.ts`) |
-| `PrimaryButton` · `HanzoMark` · `ProductIcon` · `ProviderLogo` | resp. files | `@hanzo/ui` | ✅ |
-| `SlideOver` (a11y drawer) · `SelectMenu` · `Toast` (`useToast`) | resp. files | `@hanzo/ui` | ✅ (SlideOver import decoupled `~/…/color`→`./color`) |
-| `Reorder<T>` (pointer DnD) · `FadeIn` · `ThemeToggle` · `color` (`asColor`/`IconLike`) | resp. files | `@hanzo/ui` | ✅ (+ `Reorder.test.ts`) |
-| `DetailPane` (right-side pane over SlideOver) | `components/DetailPane.tsx` | `@hanzo/ui` | ⏳ (liftable; lands with Step 3 — depends only on SlideOver) |
-| `ChunkGuard` (stale-deploy chunk-error reload) | `components/ChunkGuard.tsx` | `@hanzo/ui` | ⏳ (fully portable; lands with Step 3) |
-
-### C. Design tokens + motion → `@hanzo/ui`  ✅
-
-The brief's premise (`globals.css` `t_dark`/`t_light` token blocks) is **corrected**: `t_dark`/`t_light` are `@hanzo/gui` (Tamagui) theme **class names**; the calm values live in three real places, all preserved:
-
-| Polish | Source | New home |
-|---|---|---|
-| Calm dark-first tokens (surface, text, accent `#60a5fa`, tag tones) — raw hex, theme-config independent | `pkg/data/src/theme.ts` | `@hanzo/ui` (top-level `tokens`/`TAG_TONES`/`tagTone`) |
-| OKLCH shadcn-compatible palette (soft-charcoal `oklch(0.145 0 0)`, `--radius: 0.5rem`, indigo sidebar accent) | `pkgs/ui/style/hanzo-default-colors.css`, `@hanzo/tokens` | unchanged (legacy shadcn line); the gui line uses the hex tokens above |
-| **Motion vocabulary** — `fade-up` (FadeIn), `collapse`/`slide`/`fade` (shell/drawer), `drag`, `skeleton`/`pulse`/`row-in`; all `prefers-reduced-motion`-guarded | `console2/app/globals.css` (motion section) | **`@hanzo/ui/styles/motion.css`** (verbatim) — `import '@hanzo/ui/styles/motion.css'` once at app root |
-
-### D. Generic DocType renderer → `@hanzo/ui`  ⏳ (Step 3, FINAL — active lane)
-
-Source: `console2/src/components/doctype/*`. **Actively edited by the CMS/ERP/Help lanes (untracked).** Dependency-**injected** (`client: FrameworkClient` prop) — not `~/lib/api`-coupled — so the real move-blockers are `~/lib/framework/{types,fields}` + the `ui/*` primitives (now in `@hanzo/ui`) + `@hanzo/data` (now `@hanzo/ui/data`).
-
-| File | Class | Step-3 disposition |
-|---|---|---|
-| `MediaGrid.tsx` | presentational | → `@hanzo/ui` (cleanest lift; props-only DAM gallery) |
-| `DocTypeRecords.tsx` / `DocTypeDetail.tsx` | mixed (data-bound shell over `@hanzo/data` views) | shell **stays in console**; renders `@hanzo/ui/data` views (already true) |
-| `CollectionsBrowser.tsx` | mixed (card grid + install/create orchestration) | presentational card-grid → `@hanzo/ui`; orchestration stays |
-| `data.ts` | glue (relation loading) | stays in console |
-
-### E. LivingOverview → `@hanzo/ui`  ⏳ (Step 3 — active lane)
-
-Source: `console2/src/components/products/overview/living/*` (untracked/modified). Pure/presentational parts portable; app-glue concentrated in `registry.ts` (live API clients).
-
-| Part | Class | Step-3 disposition |
-|---|---|---|
-| `motion.ts`, `hooks.ts`, `logic.ts`, `config.ts` (types) | pure | → `@hanzo/ui` (unit-tested; count-up, poll clock, unit formatting) |
-| `tiles.tsx`, `LivingOverview.tsx` | presentational (reuse `ui/Charts` verbatim) | → `@hanzo/ui` (once `config.ts`'s one `~/lib/products/registry` `ProductIcon` type is swapped for `@hanzo/ui`'s `IconLike`) |
-| `adapters.ts`, `registry.ts` | glue (map REAL `/v1` sources → `OverviewData`) | **stay in console** |
-
-### F. Framework / Base-data libs → stay in console  🏠
-
-`src/lib/framework/*` (DocType wire contract + `FrameworkApi` client + pure `fields.ts` mapper to `@hanzo/data`) and `src/lib/base-data/*` (Base REST client + schema→field mapper) are **app data-access glue**, not UI. They stay in the console. Their pure mappers (`docTypeToFields`, `baseCollectionToFields`) could later publish as a small `@hanzo/base-data` adapter, but they are not UI components and are out of scope for `@hanzo/ui`.
-
-### G. App-coupled console components → 🔧 pending prop-injection (NOT yet in the lib)
-
-These import app `~/lib`/session/router/branding and must be made presentational (inject props) before they belong in a host-agnostic lib. Kept in console for now; the injection contract is specified so the eventual lift is mechanical.
-
-| Component | Coupling | Inject to lift |
-|---|---|---|
-| `BackendStateCard` (`BackendState.tsx`) | `~/lib/api` `ApiError` | accept a numeric `status` (or shared error shape) instead of `ApiError` |
-| `BrandLogo` | session + live IAM `organization()` + `~/config` + branding | `orgName`, `logoUrl` (or a `loadOrgLogo` loader), brand mark/name as props |
-| `Breadcrumbs` | `next/navigation` + catalog lookups | `crumbs[]` (or `pathname` + resolver) + `onNavigate` |
-| `Loader` / `BrandMark` | `~/config` + brand logo pkgs | `brand`/`brandName` + the animated-SVG getter |
-| `States` (`ErrorState`, `OperatorAccessRequired`) | `~/lib/api` + session + branding | the error, the account identity, brand strings |
-
----
-
-## What this pass built (Step 2)
-
-New in **`pkg/ui`** (was a bare `src/` staging dir — no package):
-
-- `package.json` — `@hanzo/ui` `8.0.0`, source-published (`files: ["src"]`, exports map to `.ts`), peers `@hanzo/gui >=7.2.2`, `@hanzo/data >=1.2.0`, `react >=19`; MIT (repo `LICENSE.md`). Exports: `.`, `./product`, `./data`, `./primitives/bases/data`, `./styles/motion.css`.
-- `src/index.ts` — top-level barrel (product layer + tokens).
-- `src/product/index.ts` — product barrel; **collision-free** (Charts `Sparkline`/`Donut` canonical; Metric's → `MetricSparkline`; standalone ring → `DonutRing`; `ComboOption` from the one filter module) — **zero loss**.
-- `src/data.ts` — `export * from '@hanzo/data'` (the record layer, one home).
-- `src/styles/hanzo-motion.css` — the motion vocabulary, verbatim.
-- `tsconfig.json`, `vitest.config.ts`, `gui.config.ts`, `gui.d.ts`, `.npmignore`, `README.md` — mirror the proven `pkg/data` setup.
-- **One decouple fix:** `product/EmptyState.tsx` no longer imports `~/lib/products/registry`; it uses the local `IconLike` type — the last host coupling in the product tree is gone.
-
-**Green:** `tsc --noEmit` = 0 errors (strict); `vitest run` = 12/12 (`combobox/filter`, `Reorder`). Every product component is host-agnostic (imports only `react`, `@hanzo/gui`, `@hanzogui/*`, `@hanzo/data`, relative).
-
-## Clean-room guarantee (preserved)
-
-`pkg/data` audited for GPL/Twenty contamination: **none.** No GPL, no copied license headers/SPDX, no Twenty entity/decorator architecture. The field/record model is an independent `FieldType` union + `FieldDefinition` + runtime `Map` registry (records are plain `Record<string, unknown>`). "Twenty" appears **only as benchmark prose** ("Airtable/Twenty-class polish, clean-room"). License: MIT (repo `LICENSE.md`). `@hanzo/ui` inherits the same posture.
-
----
-
-## Naming / version — DECIDED: `@hanzo/ui@8`, shadcn retired to `@hanzo/ui-shadcn`
-
-**Decision:** the gui-based unified library takes the `@hanzo/ui` name **forward at `8.0.0`** (aligning with the "Hanzo Cloud 8.x" umbrella; major = breaking re-platform). The legacy shadcn/Radix line (`pkgs/ui`, v5.7.0) is **retired by renaming** to `@hanzo/ui-shadcn` (never hard-deleted) — it stays fully alive under the new name, freeing `@hanzo/ui` for v8. Precedent: `pkg/data@1.2.0` already superseded `pkgs/data@1.1.0` under the same name.
-
-This is **DONE (repo-local):** `pkg/ui/package.json` is `@hanzo/ui@8.0.0`, GREEN. The rest is a coordinated, **sequenced** retire — because publishing `@hanzo/ui@8` (a different, gui-based API with no shadcn `Button/Card/Dialog`) under the name ~20 repos consume for shadcn primitives will BREAK any consumer that resolves to `@8`. So order matters:
-
-**Blast radius (measured across `~/work/hanzo`).** Declared deps on `@hanzo/ui` in ~20 repos. Most pin `^5.x` (semver-safe from an `@8` bump): paas, chat, platform, app, hanzo.ai, o11y, docs, mdx, hanzobot, ui-repo `pkgs/checkout` `^5.3`, `pkgs/agent-ui` `^5.0`. **Would break on `@8`:** `hanzoai/identity/app` (`"latest"`), ui-repo `pkgs/commerce` (`>=5.0.0`); `app/` uses `workspace:^`. The `ui.hanzo.ai` docs app + `pkgs/{commerce,checkout,agent-ui}` import the shadcn line internally.
-
-**Publish reality.** `.github/workflows/publish-on-tag.yml` publishes **`pkgs/ui`** (the shadcn line) as `@hanzo/ui` on a `v*` tag — it does not reference `pkg/ui`. So a tag push today publishes shadcn, not v8. Publishing v8 needs the workflow rewired to build/publish `pkg/ui`. `npm` is not authed locally (`npm whoami` empty) — per house rules, publish goes through **CI (self-hosted runners, canonical org `NPM_TOKEN`)**, not a local `npm publish`.
-
-**Safe sequence to fully land v8 (each step reversible until the tag push):**
-1. ✅ `pkg/ui` = `@hanzo/ui@8.0.0`, GREEN (done, committed to a branch).
-2. Rename `pkgs/ui` name → `@hanzo/ui-shadcn`; update the internal ui-repo consumers (`app/`, `pkgs/{commerce,checkout,agent-ui}`) + `check-no-hanzogui`/registry scripts that reference it.
-3. Migrate external consumers off `@hanzo/ui`→`@hanzo/ui-shadcn` (start with the break-risk ones: `identity` `latest`, `commerce` `>=5`; the `^5` pins are safe to migrate at leisure). ~20 repos — do as a tracked sweep or flag per-repo.
-4. Rewire `publish-on-tag.yml` (and `release.yml`) to build + publish `pkg/ui` as `@hanzo/ui@8`, and `pkgs/ui-shadcn` as `@hanzo/ui-shadcn`.
-5. `npm deprecate '@hanzo/ui@<8' 'moved to @hanzo/ui-shadcn; @hanzo/ui@8+ is the @hanzo/gui-based unified lib'`.
-6. Tag `v8.0.0` → CI publishes `@hanzo/ui@8.0.0`. Verify `npm view @hanzo/ui@8.0.0`.
-
-**Gated on the user's direct go-ahead** (irreversible / globally-visible / ecosystem-wide): steps 2–6 — the `pkgs/ui` rename, the ~20-repo consumer sweep, the CI rewire, `npm deprecate`, and the `v8.0.0` tag push that triggers publish. These were not executed autonomously.
-
----
-
-## Step 3 — console re-point (STAGED)
-
-**Gate (per the brief):** cloud `/v1/framework/modules` live **AND** console CMS/ERP/Help native.
-- ✅ Backend: `/v1/framework/modules[/:module[/install]]` is **implemented + wired** (`cloud/clients/framework/framework.go:71-73`, HIP-0106 order 129, bound in `subsystems.go:130`, real tests).
-- ⏳ Console: `CmsModule.tsx`, `ErpModule.tsx`, `HelpModule.tsx`, `components/doctype/` are **untracked/in-flight** on `feat/console-native-cms`.
-
-→ Gate is **split**, so the re-point is **staged, not applied.** I deliberately did **not** touch `console2`'s working tree (it holds the lanes' uncommitted work — editing it would collide and risk loss, the opposite of the goal).
-
-**Ready-to-apply re-point (mechanical, once the lanes land + merge):**
-1. `console2` deps: keep `@hanzo/gui`, `@hanzo/data`; add `@hanzo/ui` (`^6.0.0`). (`@hanzo/data` may stay as a direct dep or be dropped in favor of `@hanzo/ui/data` — both resolve to the same source.)
-2. Re-point imports (delete the now-duplicated in-console copies — extract, don't copy):
-   - `~/components/ui/{DataTable,PageHeader,Field,Charts,Donut,StatusTag,EmptyState,Metric,ComboBox,combobox/filter,PrimaryButton,HanzoMark,ProductIcon,ProviderLogo,SlideOver,SelectMenu,Toast,Reorder,FadeIn,ThemeToggle,color}` → **`@hanzo/ui`** (or `@hanzo/ui/product`). Two spot-renames: Metric's `Sparkline`→`MetricSparkline`, standalone `Donut`→`DonutRing`.
-   - `@hanzo/data` (in `doctype/*`, `base-data/*`, `products/*Module`) → **`@hanzo/ui/data`** (identical surface).
-   - `~/components/{DetailPane,ChunkGuard}` → **`@hanzo/ui`**.
-   - `app/globals.css` motion block → `import '@hanzo/ui/styles/motion.css'` (keep base resets local).
-   - Move the 5 app-coupled components (§G) into the lib only after applying their inject-props contract; until then they stay local.
-3. Verify **identical render**: `tsc --noEmit` + `vitest` + `next build` green, then headless-Playwright the live pages pixel-same (the polish is byte-identical, so parity is expected).
-
-**Report:** `@hanzo/ui` is the ONE unified library — product layer + record layer (`@hanzo/data`) + charts + calm tokens + motion, all on `@hanzo/gui`, presentational, cross-platform, clean-room, GREEN. Console re-point is **ready to apply once the CMS/ERP/Help lanes land**; it was not merged to avoid colliding with that in-flight work.
-
-## Follow-ups (semver-minor, with visual e2e)
-
-- Collapse the preserved Sparkline/Donut variants to one each (`MetricSparkline`→`Sparkline`, `DonutRing`→`Donut`) once call-sites are proven identical.
-- Lift §G's five components after applying their prop-injection contracts.
-- Consider publishing the pure `framework`/`base-data` mappers as a small `@hanzo/base-data` adapter (not UI).

CONTRIBUTING.md

@@ -1,10 +1,10 @@
 # Contributing
 
-Thanks for your interest in contributing to ui.shadcn.com. We're happy to have you here.
+Thanks for your interest in contributing to ui.hanzo.com. We're happy to have you here.
 
 Please take a moment to review this document before submitting your first pull request. We also strongly recommend that you check for open issues and pull requests to see if someone else is working on something similar.
 
-If you need any help, feel free to reach out to [@shadcn](https://twitter.com/shadcn).
+If you need any help, feel free to reach out to [@hanzo](https://x.com/hanzoai).
 
 ## About this repository
 
@@ -12,9 +12,7 @@ This repository is a monorepo.
 
 - We use [pnpm](https://pnpm.io) and [`workspaces`](https://pnpm.io/workspaces) for development.
 - We use [Turborepo](https://turbo.build/repo) as our build system.
-- Releases are semver-driven: bump a package's `version` in its `package.json` and
-  merge to `main`. CI (`.github/workflows/publish.yml`) detects the version change
-  and publishes that package to npm. One step, one source of truth.
+- We use [changesets](https://github.com/changesets/changesets) for managing releases.
 
 ## Structure
 
@@ -22,25 +20,28 @@ This repository is structured as follows:
 
 ```
 apps
-└── v4
+└── www
     ├── app
     ├── components
     ├── content
     └── registry
-        └── new-york-v4
+        ├── default
+        │   ├── example
+        │   └── ui
+        └── new-york
             ├── example
             └── ui
 packages
-└── shadcn
+└── cli
 ```
 
-| Path                 | Description                              |
-| -------------------- | ---------------------------------------- |
-| `apps/v4/app`        | The Next.js application for the website. |
-| `apps/v4/components` | The React components for the website.    |
-| `apps/v4/content`    | The content for the website.             |
-| `apps/v4/registry`   | The registry for the components.         |
-| `packages/shadcn`    | The `shadcn` package.                    |
+| Path                  | Description                              |
+| --------------------- | ---------------------------------------- |
+| `apps/www/app`        | The Next.js application for the website. |
+| `apps/www/components` | The React components for the website.    |
+| `apps/www/content`    | The content for the website.             |
+| `apps/www/registry`   | The registry for the components.         |
+| `packages/cli`        | The `hanzo-ui` package.                 |
 
 ## Development
 
@@ -78,61 +79,76 @@ You can use the `pnpm --filter=[WORKSPACE]` command to start the development pro
 
 #### Examples
 
-1. To run the `ui.shadcn.com` website:
+1. To run the `ui.hanzo.com` website:
 
 ```bash
-pnpm --filter=v4 dev
+pnpm --filter=www dev
 ```
 
-2. To run the `shadcn` package:
+2. To run the `hanzo-ui` package:
 
 ```bash
-pnpm --filter=shadcn dev
+pnpm --filter=hanzo-ui dev
 ```
 
 ## Running the CLI Locally
 
 To run the CLI locally, you can follow the workflow:
 
-1. Start by running the dev server:
+1. Start by running the registry (main site) to make sure the components are up to date:
 
    ```bash
-   pnpm dev
+   pnpm v4:dev
    ```
 
-2. In another terminal tab, test the CLI by running:
+2. Run the development script for the CLI:
 
    ```bash
-   pnpm shadcn
+   pnpm hanzo:dev
+   ```
+
+3. In another terminal tab, test the CLI by running:
+
+   ```bash
+   pnpm hanzo
    ```
 
    To test the CLI in a specific app, use a command like:
 
    ```bash
-   pnpm shadcn <init | add | ...> -c ~/Desktop/my-app
+   pnpm hanzo <init | add | ...> -c ~/Desktop/my-app
+   ```
+
+4. To run the tests for the CLI:
+
+   ```bash
+   pnpm --filter=hanzo test
    ```
 
 This workflow ensures that you are running the most recent version of the registry and testing the CLI properly in your local environment.
 
 ## Documentation
 
-The documentation for this project is located in the `v4` workspace. You can run the documentation locally by running the following command:
+The documentation for this project is located in the `www` workspace. You can run the documentation locally by running the following command:
 
 ```bash
-pnpm --filter=v4 dev
+pnpm --filter=www dev
 ```
 
-Documentation is written using [MDX](https://mdxjs.com). You can find the documentation files in the `apps/v4/content/docs` directory.
+Documentation is written using [MDX](https://mdxjs.com). You can find the documentation files in the `apps/www/content/docs` directory.
 
 ## Components
 
-We use a registry system for developing components. You can find the source code for the components under `apps/v4/registry`. The components are organized by styles.
+We use a registry system for developing components. You can find the source code for the components under `apps/www/registry`. The components are organized by styles.
 
 ```bash
 apps
-└── v4
+└── www
     └── registry
-        └── new-york-v4
+        ├── default
+        │   ├── example
+        │   └── ui
+        └── new-york
             ├── example
             └── ui
 ```
@@ -141,7 +157,7 @@ When adding or modifying components, please ensure that:
 
 1. You make the changes for every style.
 2. You update the documentation.
-3. You run `pnpm registry:build` to update the registry.
+3. You run `pnpm build:registry` to update the registry.
 
 ## Commit Convention
 
@@ -180,9 +196,9 @@ If you have a request for a new component, please open a discussion on GitHub. W
 
 ## CLI
 
-The `shadcn` package is a CLI for adding components to your project. You can find the documentation for the CLI [here](https://ui.shadcn.com/docs/cli).
+The `hanzo-ui` package is a CLI for adding components to your project. You can find the documentation for the CLI [here](https://ui.hanzo.com/docs/cli).
 
-Any changes to the CLI should be made in the `packages/shadcn` directory. If you can, it would be great if you could add tests for your changes.
+Any changes to the CLI should be made in the `packages/cli` directory. If you can, it would be great if you could add tests for your changes.
 
 ## Testing
 

DESIGN.md

@@ -1,106 +0,0 @@
-# Hanzo Design System — Canonical Tokens
-
-`@hanzo/ui` is the single source of truth for the shared Hanzo product look across
-the **Tailwind** apps (hanzo.chat, hanzo.app, hanzo console, commerce, hanzo-desktop).
-Change a value here; apps converge on it. This file is that source of truth for the
-three things that must read as **one product**: typography, the sidebar/panel system,
-and the dark-black palette.
-
-> One library: **`@hanzo/ui@8`** (`pkg/ui`, on **`@hanzo/gui`**) IS the component
-> library — the cross-platform product/record layer every surface consumes.
-> **`@hanzo/ui-shadcn`** (`pkgs/ui`) is the legacy shadcn/Tailwind/Radix kit, kept
-> only for existing v5 consumers (pin `@hanzo/ui-shadcn@^5`; no new adoptions).
-> This file stays the source of truth for the *token values* (fonts, dark palette,
-> the sidebar glyph) both render.
-
----
-
-## 1. Typography — Basel Grotesk + Geist Mono
-
-| Role | Family | Notes |
-|------|--------|-------|
-| UI / body / display / heading (`sans`) | **Basel Grotesk** | Self-hosted. Book = weight **400**, Medium = weight **500**. |
-| code / data / mono (`mono`) | **Geist Mono** | `next/font/google` (`Geist_Mono`) or the geist CDN. |
-| Arabic / Hebrew (`--font-ar` / `--font-he`) | unchanged | i18n only — keep. |
-
-**Dropped as defaults:** Geist Sans, DM Sans, Figtree, Inter, PT Sans, Roboto Mono.
-
-Basel is a **licensed, non-Google** face — **self-host** the woff2/woff, do NOT use
-`next/font/google` for it. Canonical files (mirror lux.exchange):
-`Basel-Grotesk-Book.woff2/.woff` (400), `Basel-Grotesk-Medium.woff2/.woff` (500).
-
-`@font-face` (weights 400/500, `font-display: swap`, `font-style: normal`):
-
-```css
-@font-face {
-  font-family: 'Basel';
-  font-style: normal;
-  font-weight: 400; /* Book; 500 = Medium */
-  font-display: swap;
-  src: url('.../Basel-Grotesk-Book.woff2') format('woff2'),
-       url('.../Basel-Grotesk-Book.woff') format('woff');
-}
-```
-
-Per-app adoption (converge the value, keep each app's own mechanism):
-- **@hanzo/ui / Next apps** → `next/font/local` for Basel (`--font-basel-sans`) +
-  `next/font/google` `Geist_Mono` (`--font-geist-mono`). See `app/lib/fonts.ts`;
-  tailwind `sans → var(--font-basel-sans)`, `mono → var(--font-geist-mono)`.
-- **Vite + Tailwind apps** (chat, launcher, desktop) → self-host Basel `@font-face`
-  + geist-mono CDN import; tailwind `fontFamily.sans = ['Basel', …]`,
-  `mono = ['Geist Mono', …]`.
-- **Tamagui (console)** → Basel `@font-face` in globals + override the Tamagui
-  `body`/`heading` font `family` to Basel; Geist Mono for `code`/`pre`.
-
----
-
-## 2. Sidebar toggle icon — lucide `PanelLeft`
-
-One glyph everywhere: lucide **`PanelLeft`** (the shadcn `SidebarTrigger` default).
-Where a directional open/close affordance is wanted, use the pair
-**`PanelLeftClose`** (expanded) / **`PanelLeft`** (collapsed). Never a hamburger,
-a magnifier, a directional arrow, or a bespoke panel SVG for the sidebar toggle.
-
-- Icon: stroke-2, ~16–20px, `currentColor`.
-- Button: ghost/outline, square (`size-7`/`h-6 w-6`), subtle hover.
-
----
-
-## 3. Sidebar + panels
-
-| Spec | Value |
-|------|-------|
-| Sidebar width (expanded) | **16rem / 256px** (`SIDEBAR_WIDTH`) |
-| Sidebar width (collapsed / icon rail) | **3rem / 48px** (apps vary 48–70px) |
-| Sidebar / panel surface | resting **#0a0a0a** over the true-black page |
-| Border / separation | `border-border` — subtle white-alpha ~10% in dark (`border-r` / `border-l`) |
-| Item hover | subtle `white/5` |
-| Item active | monochrome `white/10` — **no colored accent** (the house style is monochrome) |
-| Right panel rail | `border-l border-border`, same surface, collapsible |
-
-Prefer the `@hanzo/ui` `Sidebar` primitive (`pkgs/ui/primitives/sidebar.tsx`,
-`SidebarTrigger` → `PanelLeft`) where the app can consume it; otherwise match these
-classes/tokens.
-
----
-
-## 4. Dark-black palette (true-black OLED)
-
-The house dark theme is a **true-black** canvas (matches hanzo.ai marketing +
-hanzo.chat OLED), with a shallow surface-depth ladder for cards/panels and quiet
-hairline borders — never harsh pure-white on pure-black.
-
-| Token | Value | Use |
-|-------|-------|-----|
-| Page background | **#000000** (`oklch(0 0 0)`) | body / canvas |
-| Surface / sidebar / panel (resting) | **#0a0a0a** | sidebars, panels, cards |
-| Press | **#050505** | pressed surface |
-| Elevated / hover | **#171717** | hover, raised card |
-| Border / divider | **rgba(255,255,255,0.10)** (≈ `#171717` opaque on black) | hairlines |
-| Foreground (primary text) | near-white **#ededf1** (`oklch(0.985)`) — not pure `#fff` | body text |
-| Muted / secondary text | `white/70` (≈ `#a1a1aa`) | secondary |
-
-Keep each app's theme-token engine (CSS vars / Tailwind tokens / Tamagui `$color*`);
-converge the **values/usage** to the table above, don't rip the engine.
-
-Reference: `pkgs/ui/style/hanzo-default-colors.css` (`.dark` / `.hanzo-ui-dark-theme`).

Dockerfile

@@ -1,97 +0,0 @@
-# ui.hanzo.ai — the @hanzo/ui docs + component registry, served by the house
-# static server (ghcr.io/hanzoai/static, a Go binary), same as every other Hanzo
-# static site. Built on our own runners, never on a laptop and never by a
-# third-party builder.
-#
-# The app is a Next.js static export: `pnpm build` in app/ writes app/out, which
-# is the entire site — docs, the registry JSON the CLI reads, and the static
-# /api/registry/*.json index.
-FROM node:22 AS builder
-WORKDIR /src
-
-ENV NEXT_TELEMETRY_DISABLED=1
-
-# Publishable ingest key (pk-…), baked in at build because a static export has no
-# server to read config at runtime. Write-only and HMAC-verified to one org, so it
-# is safe in a public bundle; the deployment that builds decides which org the
-# site reports as.
-#
-# ONE name, end to end: KMS holds `deploy/PUBLISHABLE_KEY`, hanzo.yml declares it
-# as this image's build_secret, and the KMS name IS the build-arg name. NEXT_PUBLIC_
-# is added HERE because that prefix is what makes Next inline it — the app reads
-# process.env.NEXT_PUBLIC_PUBLISHABLE_KEY.
-#
-# Do NOT re-declare `ARG NEXT_PUBLIC_PUBLISHABLE_KEY` after the ENV below. A later
-# ARG of the same name shadows the ENV with its own (empty) default, and the build
-# stays green while the bundle ships blank — which is exactly how hanzo.chat 1.0.58
-# shipped a keyless site from a fully green run.
-#
-# Fail CLOSED, on BOTH ways this goes wrong.
-#
-#   empty   — builds, serves and looks correct while cloud answers
-#             `401 ingest_key_required` for every anonymous pageview. The previous
-#             `ARG …=""` default made that the normal outcome of an unattended
-#             build, which is why no automated lane could ever publish a working
-#             image.
-#   `pk_…`  — the OLDER key format. v5.7.6 shipped one, passed by hand on a local
-#             `docker build`, and it is now dead: api.hanzo.ai 401s it on both the
-#             fetch and beacon transports. A hand-passed key goes stale in silence,
-#             so requiring the current `pk-` shape refuses the stale one outright.
-#
-# Neither failure is visible from outside the artifact, so refuse the artifact.
-ARG PUBLISHABLE_KEY
-ENV NEXT_PUBLIC_PUBLISHABLE_KEY=$PUBLISHABLE_KEY
-RUN case "$PUBLISHABLE_KEY" in \
-      pk-*) : ;; \
-      '')   echo "PUBLISHABLE_KEY is empty - pass --build-arg PUBLISHABLE_KEY=<pk-...> (KMS deploy/PUBLISHABLE_KEY, env prod)" >&2; exit 1 ;; \
-      *)    echo "PUBLISHABLE_KEY is not a publishable key (expected a pk- prefix)" >&2; exit 1 ;; \
-    esac
-# 300+ prerendered pages; the default heap is not enough.
-ENV NODE_OPTIONS=--max-old-space-size=8192
-
-RUN corepack enable
-
-COPY . .
-
-# The lockfile is committed, so the build resolves exactly what was reviewed.
-RUN pnpm install --frozen-lockfile
-
-# Workspace packages the app imports must be built first: their package.json
-# exports point at dist/. Only @hanzo/event qualifies -- .npmrc sets
-# link-workspace-packages=true and the lockfile resolves it to link:../pkgs/event.
-#
-# There used to be a `cd pkgs/ui` line here. pkgs/ui was @hanzo/ui-shadcn, deleted
-# in 5dbdb2943 when shadcn was consolidated to one home, and that commit did not
-# touch this file -- so every build since has run `cd` into a directory that does
-# not exist and died with exit code 2 before compiling anything. The app takes
-# @hanzo/ui from the registry now (npm:@hanzo/ui-shadcn@^5), not the workspace.
-RUN cd pkgs/event && pnpm build
-
-# Builds the component registry, then the site (app/package.json build script).
-#
-# ...and then PROVES the key reached the client bundle. The gate above proves a
-# key was PASSED; only this proves it was INLINED. Those are different failures:
-# a rename on either side of `process.env.NEXT_PUBLIC_PUBLISHABLE_KEY` leaves the
-# build-arg intact and the bundle keyless, and a static export cannot report that
-# at runtime because there is no runtime.
-#
-# `&&`, never `;` — a `;` chain returns the LAST command's status, so a failed
-# build followed by a passing grep exits 0 and the image is published.
-RUN cd app && pnpm build && \
-    if [ -z "${NEXT_PUBLIC_PUBLISHABLE_KEY}" ]; then \
-      echo "ERROR: NEXT_PUBLIC_PUBLISHABLE_KEY is empty after a successful build." >&2; exit 1; \
-    elif grep -rqF "${NEXT_PUBLIC_PUBLISHABLE_KEY}" out; then \
-      echo "Build OK - ingest key inlined into app/out, verified"; \
-    else \
-      echo "ERROR: key supplied but NOT present in app/out - ui would ship unattributed" >&2; exit 1; \
-    fi
-
-# 0.5.1 serves a directory's index.html in place. On 0.4.1 every page 301'd to
-# an explicit /index.html, which leaks that filename into the address bar and
-# into the URLs Next builds for its route prefetches.
-FROM ghcr.io/hanzoai/static:0.5.2-amd64
-COPY --from=builder /src/app/out /public
-EXPOSE 3000
-# No -spa: the export writes a real index.html per route (trailingSlash), so a
-# missing path must 404 rather than silently render the home page.
-ENTRYPOINT ["/static", "-port", "3000", "-root", "/public"]

IMPROVEMENTS_IMPLEMENTED.md

@@ -1,458 +0,0 @@
-# UI/UX Improvements - Implementation Summary
-**Date**: 2025-11-13
-**Status**: Phase 1 Complete ✅
-
-## 🎯 Overview
-
-Following a comprehensive UI/UX review using Playwright automated testing, we've identified and begun implementing **12 high-impact improvements** to elevate Hanzo UI to world-class standards. This document tracks what's been completed and what remains.
-
----
-
-## ✅ Completed Implementations
-
-### 1. Skip Links for Accessibility (CRITICAL) ✅
-**File**: `app/components/skip-links.tsx`
-
-**What it does**:
-- Provides keyboard navigation shortcuts for screen reader users
-- Meets WCAG Level A compliance requirements
-- Hidden by default, visible when focused (Tab key)
-
-**Implementation**:
-```tsx
-<SkipLinks />
-// Renders:
-// - Skip to main content
-// - Skip to navigation
-```
-
-**Impact**:
-- ✅ WCAG Level A compliant
-- ✅ Screen reader accessible
-- ✅ Keyboard navigation improved
-- ✅ Zero visual impact (only shows on focus)
-
-**Integrated in**: `app/layout.tsx` - Active globally across all pages
-
----
-
-### 2. Skeleton Loading Components ✅
-**File**: `app/components/skeleton-card.tsx`
-
-**What it provides**:
-- `<SkeletonCard />` - Single card skeleton
-- `<SkeletonCardGrid />` - Grid of skeleton cards
-- `<SkeletonList />` - List view skeleton
-- `<SkeletonTable />` - Table skeleton
-
-**Usage Example**:
-```tsx
-import { Suspense } from 'react'
-import { SkeletonCardGrid } from '@/components/skeleton-card'
-
-<Suspense fallback={<SkeletonCardGrid count={6} />}>
-  <ComponentGallery />
-</Suspense>
-```
-
-**Impact**:
-- ⏩ Reduces perceived load time
-- 🎨 Professional loading states
-- ♿ Better accessibility (users know content is loading)
-- 📱 Works on all devices
-
-**Next Step**: Integrate into:
-- `/blocks` page (for block gallery)
-- `/docs/components` page (for component list)
-- `/builder` page (for block library panel)
-
----
-
-### 3. Enhanced Global Layout ✅
-**File**: `app/app/layout.tsx`
-
-**Changes**:
-- ✅ Skip links added at the top of the component tree
-- ✅ Proper import order maintained
-- ✅ Zero breaking changes to existing functionality
-
-**Before/After**:
-```tsx
-// Before
-<ActiveThemeProvider>
-  <div vaul-drawer-wrapper="">
-    {children}
-  </div>
-</ActiveThemeProvider>
-
-// After
-<ActiveThemeProvider>
-  <SkipLinks />
-  <div vaul-drawer-wrapper="">
-    {children}
-  </div>
-</ActiveThemeProvider>
-```
-
----
-
-## 📋 Ready to Integrate (Created, Not Yet Used)
-
-### Components Available for Use
-
-1. **Skeleton Components** (`app/components/skeleton-card.tsx`)
-   - Ready to wrap async content
-   - Just import and use in Suspense boundaries
-
-2. **Skip Links** (`app/components/skip-links.tsx`)
-   - Already active globally
-   - Need to add `id="main-content"` to main content areas
-
----
-
-## 🚧 Next Phase - Ready for Implementation
-
-### High Priority (Week 1-2)
-
-#### 1. Add ID Attributes for Skip Links
-**Files to modify**:
-- `app/(app)/layout.tsx` - Add `id="main-content"` to main
-- `app/components/site-header.tsx` - Add `id="navigation"` to nav
-
-```tsx
-// In layout
-<main id="main-content" className="flex-1">
-  {children}
-</main>
-
-// In header
-<nav id="navigation">
-  <MainNav />
-</nav>
-```
-
-**Effort**: 5 minutes
-**Impact**: High - Completes skip links functionality
-
----
-
-#### 2. Integrate Skeleton Loaders
-**Target Pages**:
-
-**A. Blocks Page** (`app/(app)/blocks/page.tsx`)
-```tsx
-import { Suspense } from 'react'
-import { SkeletonCardGrid } from '@/components/skeleton-card'
-
-export default function BlocksPage() {
-  return (
-    <Suspense fallback={<SkeletonCardGrid count={9} />}>
-      <BlockGallery />
-    </Suspense>
-  )
-}
-```
-
-**B. Components Page** (`app/(app)/docs/components/page.tsx`)
-```tsx
-<Suspense fallback={<SkeletonList count={10} />}>
-  <ComponentList />
-</Suspense>
-```
-
-**C. Builder Page** (`app/(app)/builder/page.tsx`)
-```tsx
-// In the component library panel
-<Suspense fallback={<SkeletonCardGrid count={6} />}>
-  <BlockLibrary />
-</Suspense>
-```
-
-**Effort**: 30 minutes
-**Impact**: High - Dramatically improves perceived performance
-
----
-
-#### 3. Performance Optimizations (CRITICAL)
-**Current**: 14.7s load time
-**Target**: <3s load time
-
-**Action Items**:
-a. **Image Optimization**
-```bash
-# Convert images to WebP
-pnpm add sharp
-# Add next.config.js optimization
-images: {
-  formats: ['image/webp', 'image/avif'],
-}
-```
-
-b. **Code Splitting**
-```tsx
-// Dynamic imports for heavy components
-const HeavyComponent = dynamic(() => import('./heavy-component'), {
-  loading: () => <SkeletonCard />,
-})
-```
-
-c. **Lazy Loading**
-```tsx
-// Below-the-fold content
-import { lazy } from 'react'
-const Footer = lazy(() => import('./footer'))
-```
-
-**Effort**: 4-6 hours
-**Impact**: CRITICAL - 79% faster page loads
-
----
-
-### Medium Priority (Week 2-3)
-
-#### 4. Toast Notification System
-**Package**: Already installed (`sonner`)
-**File**: `app/registry/default/ui/sonner.tsx` (already exists!)
-
-**Usage**:
-```tsx
-import { toast } from 'sonner'
-
-// Success
-toast.success('Component copied!')
-
-// Error
-toast.error('Failed to load', {
-  action: {
-    label: 'Retry',
-    onClick: () => retry(),
-  },
-})
-```
-
-**Effort**: 1 hour (just replace alert() calls)
-**Impact**: Medium - Better UX for notifications
-
----
-
-#### 5. Command Palette (⌘K)
-**Component**: Use existing `app/components/command-menu.tsx`
-
-**Enhancement**: Add keyboard shortcut hint
-```tsx
-<div className="flex items-center gap-2">
-  <Search className="h-4 w-4" />
-  <span>Search</span>
-  <kbd className="ml-auto">⌘K</kbd>
-</div>
-```
-
-**Effort**: 2 hours
-**Impact**: Medium - Power user feature
-
----
-
-#### 6. Enhanced Hero Section
-**File**: `app/(app)/page.tsx`
-
-**Improvements**:
-- ✨ Animated gradient background
-- 🎯 More prominent CTAs
-- 💫 Subtle animations (fade-in-up)
-- 🏆 Trust indicators
-
-**Code Available**: See `docs/UX_ENHANCEMENT_PLAN.md` Section 4
-
-**Effort**: 3-4 hours
-**Impact**: High - First impression matters
-
----
-
-### Lower Priority (Week 4+)
-
-7. **Builder Undo/Redo** (8 hours)
-8. **Keyboard Shortcuts Panel** (4 hours)
-9. **Empty State Components** (3 hours)
-10. **Micro-interactions** (4 hours)
-11. **Component Card Enhancements** (6 hours)
-12. **Drag Indicators** (4 hours)
-
----
-
-## 📊 Impact Metrics
-
-### Current Status
-| Metric | Before | After Phase 1 | Target | Progress |
-|--------|--------|---------------|--------|----------|
-| Accessibility | Good | WCAG A ✅ | WCAG AAA | 33% |
-| Loading UX | None | Skeletons ✅ | Complete | 50% |
-| Performance | 14.7s | TBD | <3s | 0% |
-| Mobile UX | Good | Good ✅ | Excellent | 80% |
-
-### After Full Implementation
-| Metric | Target | Improvement |
-|--------|--------|-------------|
-| Page Load | <3s | -11.7s (79% faster) |
-| Accessibility | WCAG AAA | +2 levels |
-| User Engagement | +50% | Better UX |
-| Bounce Rate | -20% | Faster loads |
-
----
-
-## 🧪 Testing
-
-### Automated Tests Available
-Run comprehensive UX review anytime:
-```bash
-pnpm exec playwright test tests/ux-review.spec.ts --headed
-```
-
-**What it tests**:
-- ✅ Skip links presence (now passing!)
-- ✅ Mobile navigation
-- ✅ Dark/light mode
-- ✅ Accessibility features
-- ⏱️ Performance metrics
-- 📸 Visual regression (screenshots)
-
-### Manual Testing Checklist
-- [ ] Tab through page - skip links should appear
-- [ ] Press Tab on any page → "Skip to main content" appears
-- [ ] Click skip link → jumps to main content
-- [ ] Skeleton loaders appear while content loads
-- [ ] No layout shift when content replaces skeletons
-
----
-
-## 📚 Documentation Created
-
-1. **UX Enhancement Plan**: `docs/UX_ENHANCEMENT_PLAN.md`
-   - Complete roadmap with code examples
-   - 12 improvements prioritized
-   - Success metrics defined
-
-2. **UX Review Summary**: `tests/reports/UX_REVIEW_SUMMARY.md`
-   - Detailed findings from Playwright tests
-   - Current vs target performance
-   - Visual analysis results
-
-3. **Test Suite**: `tests/ux-review.spec.ts`
-   - 13 comprehensive tests
-   - Reusable for ongoing monitoring
-   - Screenshots for visual tracking
-
-4. **This Document**: `IMPROVEMENTS_IMPLEMENTED.md`
-   - Track implementation progress
-   - Integration guides
-   - Priority roadmap
-
----
-
-## 🚀 Quick Wins (Do These First!)
-
-### 5-Minute Tasks
-1. ✅ Skip links - **DONE**
-2. Add ID attributes (`id="main-content"`, `id="navigation"`)
-3. Import skeletons where needed
-
-### 30-Minute Tasks
-4. Wrap async content in Suspense with skeleton fallbacks
-5. Replace alert() with toast notifications
-6. Add ⌘K hint to search
-
-### 1-Hour Tasks
-7. Hero section CTA improvements
-8. Add loading="lazy" to below-fold images
-
----
-
-## 💡 Tips for Implementation
-
-### Using Skeleton Loaders
-```tsx
-// Pattern 1: Simple async component
-<Suspense fallback={<SkeletonCard />}>
-  <AsyncComponent />
-</Suspense>
-
-// Pattern 2: Grid of items
-<Suspense fallback={<SkeletonCardGrid count={6} />}>
-  <ItemGrid />
-</Suspense>
-
-// Pattern 3: With error boundary
-<ErrorBoundary fallback={<ErrorState />}>
-  <Suspense fallback={<SkeletonList />}>
-    <DataList />
-  </Suspense>
-</ErrorBoundary>
-```
-
-### Performance Best Practices
-```tsx
-// 1. Dynamic imports for heavy components
-const Chart = dynamic(() => import('./chart'), {
-  ssr: false,
-  loading: () => <SkeletonCard />,
-})
-
-// 2. Image optimization
-import Image from 'next/image'
-<Image
-  src="/image.jpg"
-  alt="Description"
-  width={800}
-  height={600}
-  loading="lazy"
-  placeholder="blur"
-/>
-
-// 3. Code splitting
-const ModalContent = lazy(() => import('./modal-content'))
-```
-
----
-
-## 🎯 Next Steps
-
-**Immediate (This Week)**:
-1. Add ID attributes to complete skip links
-2. Integrate skeletons on blocks page
-3. Test accessibility with screen reader
-
-**Short-term (Next 2 Weeks)**:
-4. Performance optimization sprint
-5. Hero section redesign
-6. Toast notifications integration
-
-**Long-term (Month 2)**:
-7. Builder enhancements (undo/redo, drag indicators)
-8. Keyboard shortcuts
-9. Polish and micro-interactions
-
----
-
-## 📞 Support
-
-**Questions?** See the detailed plans:
-- `docs/UX_ENHANCEMENT_PLAN.md` - Full implementation guide
-- `tests/reports/UX_REVIEW_SUMMARY.md` - Test findings
-- `tests/ux-review.spec.ts` - Test suite source
-
-**Running Tests**:
-```bash
-# Full UX review
-pnpm test:e2e tests/ux-review.spec.ts
-
-# Just accessibility tests
-pnpm test:e2e tests/ux-review.spec.ts -g "Accessibility"
-
-# With UI (see what's happening)
-pnpm test:e2e tests/ux-review.spec.ts --headed
-```
-
----
-
-*Last updated: 2025-11-13*
-*Phase: 1 of 4 Complete*
-*Next review: After Week 1 integrations*

NOTICE

@@ -1,6 +0,0 @@
-ui
-Copyright (c) 2023 Hanzo AI, Inc.
-
-This product includes software from shadcn/ui (https://github.com/shadcn-ui/ui), licensed under MIT:
-
-    Copyright (c) 2023 shadcn

PUBLISH_GUIDE.md

@@ -1,39 +1,174 @@
-# Publishing
+# NPM Publishing Guide - React 19 Packages
 
-Two lanes, one trigger each. No changesets, no version-PR bot.
+## Current Package Versions
 
-## 1. `pkgs/*` — auto-publish on version bump (`publish.yml`)
+All packages updated to support **React 19.2.0**:
 
-Bump a package's `version` in `pkgs/<name>/package.json` and merge to `main`.
-`.github/workflows/publish.yml` detects the changed public `@hanzo/*` package,
-builds it, and publishes to npm (repo secret `NPM_TOKEN`). Patch bumps only
-(`x.y.z` → `x.y.z+1`).
+- `@hanzo/ui` - v5.1.1
+- `@hanzo/auth` - Latest
+- `@hanzo/commerce` - Latest
+- `@hanzo/brand` - Latest
+- `@hanzo/react` - v1.0.0
 
-## 2. `pkg/ui` — `@hanzo/ui@8`, the v8 lane (maintainer flow)
+## Publishing Methods
 
-`pkg/ui` (with `pkg/data`) is the modern cross-platform library on `@hanzo/gui`.
-It publishes from the package directory (`prepack` builds the `types/`):
+### 1. Automatic Publishing (Tag-based)
+
+When you push a git tag starting with `v` (typically matching @hanzo/ui version), the workflow automatically checks all packages and publishes any with new versions:
 
 ```bash
+# Tag with @hanzo/ui version (workflow checks all packages)
+git tag v5.1.1
+git push origin v5.1.1
+```
+
+**What happens:**
+1. Tests run (pkg/ui and pkg/react)
+2. All 5 packages build
+3. **Automatic version detection:**
+   - Checks each package's current version in package.json
+   - Queries npm to see if that version already exists
+   - Only publishes packages with new versions not on npm
+4. GitHub release created (only if packages were published)
+
+**Example workflow output:**
+```
+📦 Checking @hanzo/ui@5.1.1
+⏭️  Already published - skipping
+
+📦 Checking @hanzo/auth@2.5.5
+🚀 Publishing to npm...
+✅ Successfully published @hanzo/auth@2.5.5
+
+📊 Publishing Summary
+✅ Published: 1 package(s)
+⏭️  Skipped: 4 package(s)
+```
+
+This approach means you:
+- Only need to tag once (with @hanzo/ui version)
+- Don't need to track which packages need publishing
+- Can bump any package version and it auto-publishes on next tag
+- Similar to python-sdk monorepo publishing
+
+**Workflow:** `.github/workflows/publish-on-tag.yml`
+
+### 2. Manual Publishing (Workflow Dispatch)
+
+Use GitHub Actions UI to manually publish specific packages:
+
+1. Go to **Actions** → **NPM Publish**
+2. Click **Run workflow**
+3. Select package: `ui`, `auth`, `commerce`, `brand`, `react`, or `all`
+4. Select version bump: `patch`, `minor`, or `major`
+5. Click **Run workflow**
+
+**What happens:**
+- Selected package(s) build
+- Version bumped automatically
+- Package(s) published to npm
+- PR created with version bump
+
+**Workflow:** `.github/workflows/npm-publish.yml`
+
+### 3. Local Publishing (Manual)
+
+For quick patches or testing:
+
+```bash
+# Build and test
 cd pkg/ui
-pnpm typecheck && pnpm test && pnpm build
-# bump "version" in package.json (patch), commit to main, then:
+pnpm build
+pnpm test
+
+# Bump version
+npm version patch  # or minor/major
+
+# Publish
 npm publish --access public
 ```
 
-`@hanzo/ui-shadcn` (`pkgs/ui`) is the legacy v5 kit — existing consumers pin
-`@hanzo/ui-shadcn@^5`; it rides lane 1 like any other `pkgs/*` package.
-
-> The old tag-driven flow (`publish-on-tag.yml`, `npm-publish.yml`, the
-> `pkg/commerce|brand|react` paths) is gone — do not tag to publish here.
-
 ## Prerequisites
 
-- `NPM_TOKEN` repo secret (lane 1) / npm auth as a maintainer (lane 2)
-- Every package carries `"publishConfig": { "access": "public" }`
+### NPM Authentication Token
 
-## Checklist
+The GitHub secret `NPM_AUTH_TOKEN` must be set:
 
-- [ ] `pnpm typecheck` + `pnpm test` green in the package
-- [ ] Patch version bump (check the last published patch first)
-- [ ] Commit to `main`; lane 1 publishes on merge, lane 2 via `npm publish`
+1. Generate token at https://www.npmjs.com/settings/tokens
+2. Add to GitHub: Settings → Secrets → Actions → `NPM_AUTH_TOKEN`
+
+### Package Publish Configuration
+
+All packages already configured with:
+```json
+{
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}
+```
+
+## React 19 Compatibility
+
+### Key Updates Made
+
+1. **Type Declarations**: Added `hanzo-ui.d.ts` files for React 19 compatibility
+2. **Peer Dependencies**: Force React 19.2.0 via pnpm overrides
+3. **Test Environment**: Switched to happy-dom for better React 19 support
+4. **Build Configuration**: All packages build successfully with React 19
+
+### Test Status
+
+- **pkg/ui**: 206/207 tests passing (99.5%)
+- **pkg/react**: 10/10 tests passing (100%)
+
+## Publishing Checklist
+
+Before publishing:
+
+- [ ] All packages build successfully: `pnpm build`
+- [ ] Tests pass: `pnpm test`
+- [ ] Types check: `cd app && pnpm typecheck`
+- [ ] Lint passes: `cd app && pnpm lint`
+- [ ] Update CHANGELOG.md
+- [ ] Update version in package.json (if manual)
+- [ ] Commit changes
+
+## Troubleshooting
+
+### Build Failures
+
+```bash
+# Clean install
+rm -rf node_modules pnpm-lock.yaml
+pnpm install
+
+# Rebuild
+pnpm build
+```
+
+### Test Failures
+
+```bash
+# Run specific package tests
+cd pkg/ui && pnpm test
+cd pkg/react && pnpm test
+```
+
+### Publish Failures
+
+- Check NPM_AUTH_TOKEN is valid
+- Ensure version is unique (not already published)
+- Verify package builds: `cd pkg/<name> && pnpm build`
+
+## Package URLs
+
+- npm: https://www.npmjs.com/org/hanzo
+- GitHub: https://github.com/hanzoai/ui
+- Docs: https://ui.hanzo.ai
+
+---
+
+**Last Updated:** 2025-10-05
+**React Version:** 19.2.0

README.md

@@ -1,42 +1,35 @@
-<p align="center"><img src=".github/hero.svg" alt="@hanzo/ui" width="880"></p>
-
 # @hanzo/ui
 
-**The React component library for AI applications.** Accessible, customizable primitives for React, Vue, Svelte, and React Native — built on shadcn/ui, extended with AI, 3D, animation, and commerce components, and a single typed import surface.
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@hanzo/ui"><img src="https://img.shields.io/npm/v/@hanzo/ui?color=black&label=%40hanzo%2Fui" alt="npm"></a>
-  <a href="./LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-black" alt="MIT"></a>
-  <a href="https://ui.hanzo.ai"><img src="https://img.shields.io/badge/docs-ui.hanzo.ai-black" alt="docs"></a>
-</p>
+Accessible and customizable components for React, Vue, Svelte, and React Native. **Built on shadcn/ui with multi-framework support, 3D components, AI components, and advanced features.**
 
 ![hero](app/public/og.jpg)
 
 ## Features
 
-- **161+ components** — 3x the surface of upstream shadcn/ui
-- **Multi-framework** — React, Vue, Svelte, React Native
-- **Two themes** — Default & New York variants
-- **AI components** — chat, assistants, agent UI, playground
-- **3D components** — interactive 3D elements
-- **Animations** — advanced motion components
-- **Page builder** — visual drag-and-drop assembly, export to TSX
-- **Blocks** — 24+ production-ready full-page templates
-- **White-label** — fork and rebrand by domain (Zoo, Lux, …)
-- **Accessible** — built on Radix UI primitives
-- **Customizable** — Tailwind CSS 4 (OKLCH), fully typed TypeScript
+- 🎯 **161+ Components** - 3x more than shadcn/ui
+- 🌐 **Multi-Framework** - React, Vue, Svelte, React Native
+- 🎨 **Two Themes** - Default & New York variants
+- 🤖 **AI Components** - Chat, assistants, playground
+- 🎮 **3D Components** - Interactive 3D elements
+- ✨ **Animations** - Advanced motion components
+- 🎛️ **Page Builder** - Visual drag-drop interface
+- 🏷️ **White-Label** - Fork and rebrand easily
+- 📦 **Blocks** - 24+ production-ready templates
+- ♿ **Accessible** - Built with Radix UI primitives
+- 🎭 **Customizable** - Tailwind CSS powered
+- 📘 **TypeScript** - Fully typed
 
-## Quick start
+## Quick Start
 
-### Install
+### Installation
 
 ```bash
-pnpm add @hanzo/ui
-# or
 npm install @hanzo/ui
+# or
+pnpm add @hanzo/ui
 ```
 
-### Use
+### Usage
 
 ```tsx
 import { Button, Card, Input } from '@hanzo/ui'
@@ -58,99 +51,110 @@ export function App() {
 }
 ```
 
-## One import surface (v8)
+## Multi-Framework Support
 
-`@hanzo/ui@8` is the single entry point for the whole kit. Each capability is a
-thin subpath that re-exports its home package — code lives once, and each home is
-an optional peer, pulled only when you use its subpath.
+```tsx
+// React (default)
+import { Button } from '@hanzo/ui'
 
-| Import | What you get |
-|---|---|
-| `@hanzo/ui` · `/product` | charts, metrics, PageHeader, StatusTag, EmptyState, ComboBox, SlideOver, Toast |
-| `@hanzo/ui/data` | RecordsView, DataTable, typed field editors |
-| `@hanzo/ui/canvas` | ProjectCanvas, ServiceNode, DeployTimeline, EnvSwitcher |
-| `@hanzo/ui/dashboard` | landing + deploy-pipeline + overview kit |
-| `@hanzo/ui/usage` | UsageMeter, UsageProviderCard, UsageDashboard |
-| `@hanzo/ui/gitops` | GitopsAppList, tree, diff, sync/rollback, HealthBadge |
+// Vue
+import { Button } from '@hanzo/ui/vue'
 
-Also available as granular imports:
+// Svelte
+import { Button } from '@hanzo/ui/svelte'
 
-```ts
-import { Button, Card } from '@hanzo/ui/components'
-import * as Dialog from '@hanzo/ui/primitives/dialog'
-import { cn } from '@hanzo/ui/lib/utils'
+// React Native
+import { Button } from '@hanzo/ui/react-native'
 ```
 
+## Documentation
+
+📚 Visit **[ui.hanzo.ai](https://ui.hanzo.ai)** for:
+
+- [Component Documentation](https://ui.hanzo.ai/docs/components)
+- [Framework Guides](https://ui.hanzo.ai/docs/frameworks)
+- [Installation Guide](https://ui.hanzo.ai/docs/installation)
+- [Examples](https://ui.hanzo.ai/examples)
+- [Page Builder](https://ui.hanzo.ai/builder)
+- [Theme Generator](https://ui.hanzo.ai/theme-generator)
+
 ## CLI
 
-Add components straight into your project — the CLI copies source you own:
+Install components individually:
 
 ```bash
 npx @hanzo/ui add button
 npx @hanzo/ui add card dialog
 ```
 
-Install from 35+ external registries too:
+## What's Different from shadcn/ui?
 
-```bash
-npx @hanzo/ui add @aceternity/spotlight
-```
+| Feature | shadcn/ui | @hanzo/ui |
+|---------|-----------|-----------|
+| Components | 58 | **161** |
+| Frameworks | React only | React, Vue, Svelte, React Native |
+| 3D Components | ❌ | ✅ (9 components) |
+| AI Components | ❌ | ✅ (12 components) |
+| Page Builder | ❌ | ✅ |
+| White-Label | ❌ | ✅ |
+| Blocks | Limited | **24+ templates** |
 
 ## Packages
 
-The workspace publishes a family of scoped packages under `@hanzo/*`:
+- `@hanzo/ui` - Main UI library (161 components)
+- `@hanzo/auth` - Authentication components
+- `@hanzo/commerce` - E-commerce components
+- `@hanzo/brand` - Branding system
 
-| Package | Purpose |
-|---|---|
-| `@hanzo/ui` | Core library + the v8 import surface (161+ components) |
-| `@hanzo/react` | React primitives |
-| `@hanzo/data` | Records, data tables, typed field editors |
-| `@hanzo/canvas` | Service/deploy canvas components |
-| `@hanzo/dashboard` | Dashboard + deploy-pipeline kit |
-| `@hanzo/commerce` · `@hanzo/checkout` · `@hanzo/shop` | Commerce components |
-| `@hanzo/agent-ui` | AI agent UI components |
-| `@hanzo/brand` · `@hanzo/tokens` | Branding system & design tokens |
-| `@hanzo/event` | Telemetry client (`POST /v1/event`) |
+## Examples
+
+```tsx
+// 3D Components
+import { ThreeDButton, ThreeDCard } from '@hanzo/ui'
+
+// AI Components
+import { AIChat, AIAssistant } from '@hanzo/ui'
+
+// Animations
+import { AnimatedBeam, AnimatedText } from '@hanzo/ui'
+```
 
 ## Development
 
 ```bash
+# Clone repository
 git clone https://github.com/hanzoai/ui.git
 cd ui
+
+# Install dependencies
 pnpm install
 
-pnpm build:registry   # generate the component registry FIRST
-pnpm dev              # docs site + registry (http://localhost:3003)
+# Start dev server
+pnpm dev
+
+# Build packages
+pnpm build
+
+# Run tests
+pnpm test
 ```
 
-> The registry generates the JSON the CLI reads, so `build:registry` must run
-> before `build`. Keep the Default and New York themes in sync when adding
-> components. Use pnpm — not npm or yarn.
-
-```bash
-pnpm build            # build the docs app
-pnpm lint             # lint all workspaces
-pnpm typecheck        # type check
-pnpm test             # unit tests
-pnpm test:e2e         # Playwright E2E
-```
-
-## Documentation
-
-Full docs, live previews, and the component catalog: **[ui.hanzo.ai](https://ui.hanzo.ai)**.
-
 ## Contributing
 
-See the [contributing guide](/CONTRIBUTING.md).
+We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md).
 
 ## License
 
-MIT — see [LICENSE.md](./LICENSE.md).
+MIT - See [LICENSE.md](./LICENSE.md) for details.
+
+## Links
+
+- [Documentation](https://ui.hanzo.ai)
+- [GitHub](https://github.com/hanzoai/ui)
+- [npm](https://www.npmjs.com/package/@hanzo/ui)
+- [Discord](https://discord.gg/hanzo)
+- [Twitter](https://twitter.com/hanzoai)
 
 ---
 
-## Hanzo — the Open AI Cloud
-
-Open source · every language · on-chain settlement. [hanzo.ai](https://hanzo.ai) · [docs.hanzo.ai](https://docs.hanzo.ai)
-
-**SDKs in every language** — [Python](https://github.com/hanzoai/python-sdk) (flagship) · [TypeScript](https://github.com/hanzo-js/sdk) · [Go](https://github.com/hanzo-go/sdk) · [Rust](https://github.com/hanzo-rs/sdk) · [C++](https://github.com/hanzo-cpp/sdk) · [Swift](https://github.com/hanzo-swift/sdk) · [Kotlin](https://github.com/hanzo-kt/sdk) · [umbrella](https://github.com/hanzoai/sdk)
+Built with ❤️ by [Hanzo](https://hanzo.ai)

SECURITY.md

@@ -6,4 +6,4 @@ We will investigate all legitimate reports and do our best to quickly fix the pr
 
 Our preference is that you make use of GitHub's private vulnerability reporting feature to disclose potential security vulnerabilities in our Open Source Software. 
 
-To do this, please visit the security tab of the repository and click the [Report a vulnerability](https://github.com/shadcn-ui/ui/security/advisories/new) button.
+To do this, please visit the security tab of the repository and click the "Report a vulnerability" button.

__tests__/grid-pattern.test.tsx

@@ -1,6 +1,6 @@
 import React from "react"
 import { render, screen } from "@testing-library/react"
-import { GridPattern, GridPatternPresets } from "@hanzo/ui/pattern/grid"
+import { GridPattern, GridPatternPresets } from "../app/registry/default/ui/grid-pattern"
 
 describe("GridPattern", () => {
   it("renders without crashing", () => {

app/.docs/browser.ts

@@ -1,434 +0,0 @@
-// @ts-nocheck
-import { browser } from "@hanzo/docs-mdx/runtime/browser"
-
-import type * as Config from "../source.config"
-
-const create = browser<
-  typeof Config,
-  import("@hanzo/docs-mdx/runtime/types").InternalTypeConfig & {
-    DocData: {}
-  }
->()
-const browserCollections = {
-  docs: create.doc("docs", {
-    "about.mdx": () => import("../content/docs/about.mdx?collection=docs"),
-    "changelog.mdx": () =>
-      import("../content/docs/changelog.mdx?collection=docs"),
-    "cli.mdx": () => import("../content/docs/cli.mdx?collection=docs"),
-    "components-json.mdx": () =>
-      import("../content/docs/components-json.mdx?collection=docs"),
-    "components.mdx": () =>
-      import("../content/docs/components.mdx?collection=docs"),
-    "figma.mdx": () => import("../content/docs/figma.mdx?collection=docs"),
-    "index.mdx": () => import("../content/docs/index.mdx?collection=docs"),
-    "mcp.mdx": () => import("../content/docs/mcp.mdx?collection=docs"),
-    "theming.mdx": () => import("../content/docs/theming.mdx?collection=docs"),
-    "ai/actions.mdx": () =>
-      import("../content/docs/ai/actions.mdx?collection=docs"),
-    "ai/agents.mdx": () =>
-      import("../content/docs/ai/agents.mdx?collection=docs"),
-    "ai/assistant.mdx": () =>
-      import("../content/docs/ai/assistant.mdx?collection=docs"),
-    "ai/chat.mdx": () => import("../content/docs/ai/chat.mdx?collection=docs"),
-    "ai/code.mdx": () => import("../content/docs/ai/code.mdx?collection=docs"),
-    "ai/index.mdx": () =>
-      import("../content/docs/ai/index.mdx?collection=docs"),
-    "ai/models.mdx": () =>
-      import("../content/docs/ai/models.mdx?collection=docs"),
-    "ai/playground.mdx": () =>
-      import("../content/docs/ai/playground.mdx?collection=docs"),
-    "ai/tools.mdx": () =>
-      import("../content/docs/ai/tools.mdx?collection=docs"),
-    "ai/vision.mdx": () =>
-      import("../content/docs/ai/vision.mdx?collection=docs"),
-    "ai/voice-settings.mdx": () =>
-      import("../content/docs/ai/voice-settings.mdx?collection=docs"),
-    "ai/voice.mdx": () =>
-      import("../content/docs/ai/voice.mdx?collection=docs"),
-    "block-examples/billing.mdx": () =>
-      import("../content/docs/block-examples/billing.mdx?collection=docs"),
-    "block-examples/compose-spec.mdx": () =>
-      import("../content/docs/block-examples/compose-spec.mdx?collection=docs"),
-    "block-examples/newsletter.mdx": () =>
-      import("../content/docs/block-examples/newsletter.mdx?collection=docs"),
-    "block-examples/pricing.mdx": () =>
-      import("../content/docs/block-examples/pricing.mdx?collection=docs"),
-    "frameworks/index.mdx": () =>
-      import("../content/docs/frameworks/index.mdx?collection=docs"),
-    "frameworks/react.mdx": () =>
-      import("../content/docs/frameworks/react.mdx?collection=docs"),
-    "frameworks/vue.mdx": () =>
-      import("../content/docs/frameworks/vue.mdx?collection=docs"),
-    "dark-mode/astro.mdx": () =>
-      import("../content/docs/dark-mode/astro.mdx?collection=docs"),
-    "dark-mode/index.mdx": () =>
-      import("../content/docs/dark-mode/index.mdx?collection=docs"),
-    "dark-mode/next.mdx": () =>
-      import("../content/docs/dark-mode/next.mdx?collection=docs"),
-    "dark-mode/remix.mdx": () =>
-      import("../content/docs/dark-mode/remix.mdx?collection=docs"),
-    "dark-mode/vite.mdx": () =>
-      import("../content/docs/dark-mode/vite.mdx?collection=docs"),
-    "guides/page-builder.mdx": () =>
-      import("../content/docs/guides/page-builder.mdx?collection=docs"),
-    "guides/visual-workflows.mdx": () =>
-      import("../content/docs/guides/visual-workflows.mdx?collection=docs"),
-    "hanzo-react/getting-started.mdx": () =>
-      import("../content/docs/hanzo-react/getting-started.mdx?collection=docs"),
-    "hanzo-react/hooks.mdx": () =>
-      import("../content/docs/hanzo-react/hooks.mdx?collection=docs"),
-    "installation/astro.mdx": () =>
-      import("../content/docs/installation/astro.mdx?collection=docs"),
-    "installation/gatsby.mdx": () =>
-      import("../content/docs/installation/gatsby.mdx?collection=docs"),
-    "installation/index.mdx": () =>
-      import("../content/docs/installation/index.mdx?collection=docs"),
-    "installation/laravel.mdx": () =>
-      import("../content/docs/installation/laravel.mdx?collection=docs"),
-    "installation/manual.mdx": () =>
-      import("../content/docs/installation/manual.mdx?collection=docs"),
-    "installation/next.mdx": () =>
-      import("../content/docs/installation/next.mdx?collection=docs"),
-    "installation/remix.mdx": () =>
-      import("../content/docs/installation/remix.mdx?collection=docs"),
-    "installation/vite.mdx": () =>
-      import("../content/docs/installation/vite.mdx?collection=docs"),
-    "packages/index.mdx": () =>
-      import("../content/docs/packages/index.mdx?collection=docs"),
-    "components/3d-card.mdx": () =>
-      import("../content/docs/components/3d-card.mdx?collection=docs"),
-    "components/3d-marquee.mdx": () =>
-      import("../content/docs/components/3d-marquee.mdx?collection=docs"),
-    "components/3d-pin.mdx": () =>
-      import("../content/docs/components/3d-pin.mdx?collection=docs"),
-    "components/accordion.mdx": () =>
-      import("../content/docs/components/accordion.mdx?collection=docs"),
-    "components/advanced-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/advanced-navigation-bar.mdx?collection=docs"
-      ),
-    "components/ai-model-selector-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/ai-model-selector-navigation-bar.mdx?collection=docs"
-      ),
-    "components/alert-dialog.mdx": () =>
-      import("../content/docs/components/alert-dialog.mdx?collection=docs"),
-    "components/alert.mdx": () =>
-      import("../content/docs/components/alert.mdx?collection=docs"),
-    "components/android.mdx": () =>
-      import("../content/docs/components/android.mdx?collection=docs"),
-    "components/animated-beam.mdx": () =>
-      import("../content/docs/components/animated-beam.mdx?collection=docs"),
-    "components/animated-cursor.mdx": () =>
-      import("../content/docs/components/animated-cursor.mdx?collection=docs"),
-    "components/animated-testimonials.mdx": () =>
-      import(
-        "../content/docs/components/animated-testimonials.mdx?collection=docs"
-      ),
-    "components/animated-tooltip.mdx": () =>
-      import("../content/docs/components/animated-tooltip.mdx?collection=docs"),
-    "components/animation-components.mdx": () =>
-      import(
-        "../content/docs/components/animation-components.mdx?collection=docs"
-      ),
-    "components/announcement.mdx": () =>
-      import("../content/docs/components/announcement.mdx?collection=docs"),
-    "components/app-switcher-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/app-switcher-navigation-bar.mdx?collection=docs"
-      ),
-    "components/apple-cards-carousel.mdx": () =>
-      import(
-        "../content/docs/components/apple-cards-carousel.mdx?collection=docs"
-      ),
-    "components/apple-hello-effect.mdx": () =>
-      import(
-        "../content/docs/components/apple-hello-effect.mdx?collection=docs"
-      ),
-    "components/aspect-ratio.mdx": () =>
-      import("../content/docs/components/aspect-ratio.mdx?collection=docs"),
-    "components/avatar-group.mdx": () =>
-      import("../content/docs/components/avatar-group.mdx?collection=docs"),
-    "components/avatar.mdx": () =>
-      import("../content/docs/components/avatar.mdx?collection=docs"),
-    "components/badge.mdx": () =>
-      import("../content/docs/components/badge.mdx?collection=docs"),
-    "components/banner.mdx": () =>
-      import("../content/docs/components/banner.mdx?collection=docs"),
-    "components/breadcrumb-and-filters-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/breadcrumb-and-filters-navigation-bar.mdx?collection=docs"
-      ),
-    "components/breadcrumb-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/breadcrumb-navigation-bar.mdx?collection=docs"
-      ),
-    "components/breadcrumb.mdx": () =>
-      import("../content/docs/components/breadcrumb.mdx?collection=docs"),
-    "components/button-group.mdx": () =>
-      import("../content/docs/components/button-group.mdx?collection=docs"),
-    "components/button.mdx": () =>
-      import("../content/docs/components/button.mdx?collection=docs"),
-    "components/calendar.mdx": () =>
-      import("../content/docs/components/calendar.mdx?collection=docs"),
-    "components/card.mdx": () =>
-      import("../content/docs/components/card.mdx?collection=docs"),
-    "components/carousel.mdx": () =>
-      import("../content/docs/components/carousel.mdx?collection=docs"),
-    "components/centered-logo-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/centered-logo-navigation-bar.mdx?collection=docs"
-      ),
-    "components/checkbox.mdx": () =>
-      import("../content/docs/components/checkbox.mdx?collection=docs"),
-    "components/choicebox.mdx": () =>
-      import("../content/docs/components/choicebox.mdx?collection=docs"),
-    "components/code-block.mdx": () =>
-      import("../content/docs/components/code-block.mdx?collection=docs"),
-    "components/code-editor.mdx": () =>
-      import("../content/docs/components/code-editor.mdx?collection=docs"),
-    "components/code-tabs.mdx": () =>
-      import("../content/docs/components/code-tabs.mdx?collection=docs"),
-    "components/collaboration-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/collaboration-navigation-bar.mdx?collection=docs"
-      ),
-    "components/collapsible.mdx": () =>
-      import("../content/docs/components/collapsible.mdx?collection=docs"),
-    "components/color-picker.mdx": () =>
-      import("../content/docs/components/color-picker.mdx?collection=docs"),
-    "components/combobox.mdx": () =>
-      import("../content/docs/components/combobox.mdx?collection=docs"),
-    "components/command.mdx": () =>
-      import("../content/docs/components/command.mdx?collection=docs"),
-    "components/communication-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/communication-navigation-bar.mdx?collection=docs"
-      ),
-    "components/comparison.mdx": () =>
-      import("../content/docs/components/comparison.mdx?collection=docs"),
-    "components/context-menu.mdx": () =>
-      import("../content/docs/components/context-menu.mdx?collection=docs"),
-    "components/context-switcher-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/context-switcher-navigation-bar.mdx?collection=docs"
-      ),
-    "components/credit-card.mdx": () =>
-      import("../content/docs/components/credit-card.mdx?collection=docs"),
-    "components/cursor.mdx": () =>
-      import("../content/docs/components/cursor.mdx?collection=docs"),
-    "components/dashboard-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/dashboard-navigation-bar.mdx?collection=docs"
-      ),
-    "components/data-table.mdx": () =>
-      import("../content/docs/components/data-table.mdx?collection=docs"),
-    "components/date-picker.mdx": () =>
-      import("../content/docs/components/date-picker.mdx?collection=docs"),
-    "components/desktop-hooks.mdx": () =>
-      import("../content/docs/components/desktop-hooks.mdx?collection=docs"),
-    "components/desktop-spotlight.mdx": () =>
-      import(
-        "../content/docs/components/desktop-spotlight.mdx?collection=docs"
-      ),
-    "components/desktop-window.mdx": () =>
-      import("../content/docs/components/desktop-window.mdx?collection=docs"),
-    "components/desktop.mdx": () =>
-      import("../content/docs/components/desktop.mdx?collection=docs"),
-    "components/dialog-stack.mdx": () =>
-      import("../content/docs/components/dialog-stack.mdx?collection=docs"),
-    "components/dialog.mdx": () =>
-      import("../content/docs/components/dialog.mdx?collection=docs"),
-    "components/dock.mdx": () =>
-      import("../content/docs/components/dock.mdx?collection=docs"),
-    "components/drawer.mdx": () =>
-      import("../content/docs/components/drawer.mdx?collection=docs"),
-    "components/dropdown-menu.mdx": () =>
-      import("../content/docs/components/dropdown-menu.mdx?collection=docs"),
-    "components/dropzone.mdx": () =>
-      import("../content/docs/components/dropzone.mdx?collection=docs"),
-    "components/e-commerce-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/e-commerce-navigation-bar.mdx?collection=docs"
-      ),
-    "components/editor.mdx": () =>
-      import("../content/docs/components/editor.mdx?collection=docs"),
-    "components/empty.mdx": () =>
-      import("../content/docs/components/empty.mdx?collection=docs"),
-    "components/field.mdx": () =>
-      import("../content/docs/components/field.mdx?collection=docs"),
-    "components/form.mdx": () =>
-      import("../content/docs/components/form.mdx?collection=docs"),
-    "components/gantt.mdx": () =>
-      import("../content/docs/components/gantt.mdx?collection=docs"),
-    "components/glimpse.mdx": () =>
-      import("../content/docs/components/glimpse.mdx?collection=docs"),
-    "components/grid-pattern.mdx": () =>
-      import("../content/docs/components/grid-pattern.mdx?collection=docs"),
-    "components/hover-card.mdx": () =>
-      import("../content/docs/components/hover-card.mdx?collection=docs"),
-    "components/icon-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/icon-navigation-bar.mdx?collection=docs"
-      ),
-    "components/image-crop.mdx": () =>
-      import("../content/docs/components/image-crop.mdx?collection=docs"),
-    "components/image-zoom.mdx": () =>
-      import("../content/docs/components/image-zoom.mdx?collection=docs"),
-    "components/index.mdx": () =>
-      import("../content/docs/components/index.mdx?collection=docs"),
-    "components/input-group.mdx": () =>
-      import("../content/docs/components/input-group.mdx?collection=docs"),
-    "components/input-otp.mdx": () =>
-      import("../content/docs/components/input-otp.mdx?collection=docs"),
-    "components/input.mdx": () =>
-      import("../content/docs/components/input.mdx?collection=docs"),
-    "components/interactive-grid-pattern.mdx": () =>
-      import(
-        "../content/docs/components/interactive-grid-pattern.mdx?collection=docs"
-      ),
-    "components/iphone-15-pro.mdx": () =>
-      import("../content/docs/components/iphone-15-pro.mdx?collection=docs"),
-    "components/item.mdx": () =>
-      import("../content/docs/components/item.mdx?collection=docs"),
-    "components/kanban.mdx": () =>
-      import("../content/docs/components/kanban.mdx?collection=docs"),
-    "components/kbd.mdx": () =>
-      import("../content/docs/components/kbd.mdx?collection=docs"),
-    "components/label.mdx": () =>
-      import("../content/docs/components/label.mdx?collection=docs"),
-    "components/limelight-nav.mdx": () =>
-      import("../content/docs/components/limelight-nav.mdx?collection=docs"),
-    "components/list.mdx": () =>
-      import("../content/docs/components/list.mdx?collection=docs"),
-    "components/macos-dock.mdx": () =>
-      import("../content/docs/components/macos-dock.mdx?collection=docs"),
-    "components/magnetic.mdx": () =>
-      import("../content/docs/components/magnetic.mdx?collection=docs"),
-    "components/marquee.mdx": () =>
-      import("../content/docs/components/marquee.mdx?collection=docs"),
-    "components/menu-dock.mdx": () =>
-      import("../content/docs/components/menu-dock.mdx?collection=docs"),
-    "components/menubar.mdx": () =>
-      import("../content/docs/components/menubar.mdx?collection=docs"),
-    "components/message-dock.mdx": () =>
-      import("../content/docs/components/message-dock.mdx?collection=docs"),
-    "components/mini-calendar.mdx": () =>
-      import("../content/docs/components/mini-calendar.mdx?collection=docs"),
-    "components/minimal-tiptap.mdx": () =>
-      import("../content/docs/components/minimal-tiptap.mdx?collection=docs"),
-    "components/motion-highlight.mdx": () =>
-      import("../content/docs/components/motion-highlight.mdx?collection=docs"),
-    "components/navigation-menu.mdx": () =>
-      import("../content/docs/components/navigation-menu.mdx?collection=docs"),
-    "components/pagination.mdx": () =>
-      import("../content/docs/components/pagination.mdx?collection=docs"),
-    "components/particles-background.mdx": () =>
-      import(
-        "../content/docs/components/particles-background.mdx?collection=docs"
-      ),
-    "components/particles.mdx": () =>
-      import("../content/docs/components/particles.mdx?collection=docs"),
-    "components/pill.mdx": () =>
-      import("../content/docs/components/pill.mdx?collection=docs"),
-    "components/pin-list.mdx": () =>
-      import("../content/docs/components/pin-list.mdx?collection=docs"),
-    "components/pixel-image.mdx": () =>
-      import("../content/docs/components/pixel-image.mdx?collection=docs"),
-    "components/popover.mdx": () =>
-      import("../content/docs/components/popover.mdx?collection=docs"),
-    "components/progress.mdx": () =>
-      import("../content/docs/components/progress.mdx?collection=docs"),
-    "components/qr-code.mdx": () =>
-      import("../content/docs/components/qr-code.mdx?collection=docs"),
-    "components/radio-group.mdx": () =>
-      import("../content/docs/components/radio-group.mdx?collection=docs"),
-    "components/relative-time.mdx": () =>
-      import("../content/docs/components/relative-time.mdx?collection=docs"),
-    "components/resizable.mdx": () =>
-      import("../content/docs/components/resizable.mdx?collection=docs"),
-    "components/safari.mdx": () =>
-      import("../content/docs/components/safari.mdx?collection=docs"),
-    "components/sandbox.mdx": () =>
-      import("../content/docs/components/sandbox.mdx?collection=docs"),
-    "components/scroll-area.mdx": () =>
-      import("../content/docs/components/scroll-area.mdx?collection=docs"),
-    "components/search-and-toggle-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/search-and-toggle-navigation-bar.mdx?collection=docs"
-      ),
-    "components/select.mdx": () =>
-      import("../content/docs/components/select.mdx?collection=docs"),
-    "components/separator.mdx": () =>
-      import("../content/docs/components/separator.mdx?collection=docs"),
-    "components/sheet.mdx": () =>
-      import("../content/docs/components/sheet.mdx?collection=docs"),
-    "components/simple-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/simple-navigation-bar.mdx?collection=docs"
-      ),
-    "components/skeleton.mdx": () =>
-      import("../content/docs/components/skeleton.mdx?collection=docs"),
-    "components/slider.mdx": () =>
-      import("../content/docs/components/slider.mdx?collection=docs"),
-    "components/snippet.mdx": () =>
-      import("../content/docs/components/snippet.mdx?collection=docs"),
-    "components/sonner.mdx": () =>
-      import("../content/docs/components/sonner.mdx?collection=docs"),
-    "components/spinner.mdx": () =>
-      import("../content/docs/components/spinner.mdx?collection=docs"),
-    "components/stars-scrolling-wheel.mdx": () =>
-      import(
-        "../content/docs/components/stars-scrolling-wheel.mdx?collection=docs"
-      ),
-    "components/status-dashboard-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/status-dashboard-navigation-bar.mdx?collection=docs"
-      ),
-    "components/status.mdx": () =>
-      import("../content/docs/components/status.mdx?collection=docs"),
-    "components/switch.mdx": () =>
-      import("../content/docs/components/switch.mdx?collection=docs"),
-    "components/table.mdx": () =>
-      import("../content/docs/components/table.mdx?collection=docs"),
-    "components/tabs.mdx": () =>
-      import("../content/docs/components/tabs.mdx?collection=docs"),
-    "components/tags.mdx": () =>
-      import("../content/docs/components/tags.mdx?collection=docs"),
-    "components/team-switcher-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/team-switcher-navigation-bar.mdx?collection=docs"
-      ),
-    "components/terminal.mdx": () =>
-      import("../content/docs/components/terminal.mdx?collection=docs"),
-    "components/textarea.mdx": () =>
-      import("../content/docs/components/textarea.mdx?collection=docs"),
-    "components/timeline.mdx": () =>
-      import("../content/docs/components/timeline.mdx?collection=docs"),
-    "components/toast.mdx": () =>
-      import("../content/docs/components/toast.mdx?collection=docs"),
-    "components/toggle-group.mdx": () =>
-      import("../content/docs/components/toggle-group.mdx?collection=docs"),
-    "components/toggle.mdx": () =>
-      import("../content/docs/components/toggle.mdx?collection=docs"),
-    "components/tooltip.mdx": () =>
-      import("../content/docs/components/tooltip.mdx?collection=docs"),
-    "components/two-tier-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/two-tier-navigation-bar.mdx?collection=docs"
-      ),
-    "components/typography.mdx": () =>
-      import("../content/docs/components/typography.mdx?collection=docs"),
-    "components/underline-navigation-bar.mdx": () =>
-      import(
-        "../content/docs/components/underline-navigation-bar.mdx?collection=docs"
-      ),
-    "components/video-player.mdx": () =>
-      import("../content/docs/components/video-player.mdx?collection=docs"),
-    "white-label/index.mdx": () =>
-      import("../content/docs/white-label/index.mdx?collection=docs"),
-    "testing/index.mdx": () =>
-      import("../content/docs/testing/index.mdx?collection=docs"),
-  }),
-}
-export default browserCollections

app/.docs/dynamic.ts

@@ -1,15 +0,0 @@
-// @ts-nocheck
-import { dynamic } from "@hanzo/docs-mdx/runtime/dynamic"
-
-import * as Config from "../source.config"
-
-const create = await dynamic<
-  typeof Config,
-  import("@hanzo/docs-mdx/runtime/types").InternalTypeConfig & {
-    DocData: {}
-  }
->(
-  Config,
-  { configPath: "source.config.ts", environment: "next", outDir: ".docs" },
-  { doc: { passthroughs: ["extractedReferences"] } }
-)

app/.docs/server.ts

@@ -1,393 +0,0 @@
-// @ts-nocheck
-import { server } from "@hanzo/docs-mdx/runtime/server"
-
-import * as __fd_glob_0 from "../content/docs/about.mdx?collection=docs"
-import * as __fd_glob_9 from "../content/docs/ai/actions.mdx?collection=docs"
-import * as __fd_glob_10 from "../content/docs/ai/agents.mdx?collection=docs"
-import * as __fd_glob_11 from "../content/docs/ai/assistant.mdx?collection=docs"
-import * as __fd_glob_12 from "../content/docs/ai/chat.mdx?collection=docs"
-import * as __fd_glob_13 from "../content/docs/ai/code.mdx?collection=docs"
-import * as __fd_glob_14 from "../content/docs/ai/index.mdx?collection=docs"
-import * as __fd_glob_15 from "../content/docs/ai/models.mdx?collection=docs"
-import * as __fd_glob_16 from "../content/docs/ai/playground.mdx?collection=docs"
-import * as __fd_glob_17 from "../content/docs/ai/tools.mdx?collection=docs"
-import * as __fd_glob_18 from "../content/docs/ai/vision.mdx?collection=docs"
-import * as __fd_glob_19 from "../content/docs/ai/voice-settings.mdx?collection=docs"
-import * as __fd_glob_20 from "../content/docs/ai/voice.mdx?collection=docs"
-import * as __fd_glob_21 from "../content/docs/block-examples/billing.mdx?collection=docs"
-import * as __fd_glob_22 from "../content/docs/block-examples/compose-spec.mdx?collection=docs"
-import * as __fd_glob_23 from "../content/docs/block-examples/newsletter.mdx?collection=docs"
-import * as __fd_glob_24 from "../content/docs/block-examples/pricing.mdx?collection=docs"
-import * as __fd_glob_1 from "../content/docs/changelog.mdx?collection=docs"
-import * as __fd_glob_2 from "../content/docs/cli.mdx?collection=docs"
-import * as __fd_glob_3 from "../content/docs/components-json.mdx?collection=docs"
-import * as __fd_glob_4 from "../content/docs/components.mdx?collection=docs"
-import * as __fd_glob_46 from "../content/docs/components/3d-card.mdx?collection=docs"
-import * as __fd_glob_47 from "../content/docs/components/3d-marquee.mdx?collection=docs"
-import * as __fd_glob_48 from "../content/docs/components/3d-pin.mdx?collection=docs"
-import * as __fd_glob_49 from "../content/docs/components/accordion.mdx?collection=docs"
-import * as __fd_glob_50 from "../content/docs/components/advanced-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_51 from "../content/docs/components/ai-model-selector-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_52 from "../content/docs/components/alert-dialog.mdx?collection=docs"
-import * as __fd_glob_53 from "../content/docs/components/alert.mdx?collection=docs"
-import * as __fd_glob_54 from "../content/docs/components/android.mdx?collection=docs"
-import * as __fd_glob_55 from "../content/docs/components/animated-beam.mdx?collection=docs"
-import * as __fd_glob_56 from "../content/docs/components/animated-cursor.mdx?collection=docs"
-import * as __fd_glob_57 from "../content/docs/components/animated-testimonials.mdx?collection=docs"
-import * as __fd_glob_58 from "../content/docs/components/animated-tooltip.mdx?collection=docs"
-import * as __fd_glob_59 from "../content/docs/components/animation-components.mdx?collection=docs"
-import * as __fd_glob_60 from "../content/docs/components/announcement.mdx?collection=docs"
-import * as __fd_glob_61 from "../content/docs/components/app-switcher-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_62 from "../content/docs/components/apple-cards-carousel.mdx?collection=docs"
-import * as __fd_glob_63 from "../content/docs/components/apple-hello-effect.mdx?collection=docs"
-import * as __fd_glob_64 from "../content/docs/components/aspect-ratio.mdx?collection=docs"
-import * as __fd_glob_65 from "../content/docs/components/avatar-group.mdx?collection=docs"
-import * as __fd_glob_66 from "../content/docs/components/avatar.mdx?collection=docs"
-import * as __fd_glob_67 from "../content/docs/components/badge.mdx?collection=docs"
-import * as __fd_glob_68 from "../content/docs/components/banner.mdx?collection=docs"
-import * as __fd_glob_69 from "../content/docs/components/breadcrumb-and-filters-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_70 from "../content/docs/components/breadcrumb-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_71 from "../content/docs/components/breadcrumb.mdx?collection=docs"
-import * as __fd_glob_72 from "../content/docs/components/button-group.mdx?collection=docs"
-import * as __fd_glob_73 from "../content/docs/components/button.mdx?collection=docs"
-import * as __fd_glob_74 from "../content/docs/components/calendar.mdx?collection=docs"
-import * as __fd_glob_75 from "../content/docs/components/card.mdx?collection=docs"
-import * as __fd_glob_76 from "../content/docs/components/carousel.mdx?collection=docs"
-import * as __fd_glob_77 from "../content/docs/components/centered-logo-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_78 from "../content/docs/components/checkbox.mdx?collection=docs"
-import * as __fd_glob_79 from "../content/docs/components/choicebox.mdx?collection=docs"
-import * as __fd_glob_80 from "../content/docs/components/code-block.mdx?collection=docs"
-import * as __fd_glob_81 from "../content/docs/components/code-editor.mdx?collection=docs"
-import * as __fd_glob_82 from "../content/docs/components/code-tabs.mdx?collection=docs"
-import * as __fd_glob_83 from "../content/docs/components/collaboration-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_84 from "../content/docs/components/collapsible.mdx?collection=docs"
-import * as __fd_glob_85 from "../content/docs/components/color-picker.mdx?collection=docs"
-import * as __fd_glob_86 from "../content/docs/components/combobox.mdx?collection=docs"
-import * as __fd_glob_87 from "../content/docs/components/command.mdx?collection=docs"
-import * as __fd_glob_88 from "../content/docs/components/communication-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_89 from "../content/docs/components/comparison.mdx?collection=docs"
-import * as __fd_glob_90 from "../content/docs/components/context-menu.mdx?collection=docs"
-import * as __fd_glob_91 from "../content/docs/components/context-switcher-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_92 from "../content/docs/components/credit-card.mdx?collection=docs"
-import * as __fd_glob_93 from "../content/docs/components/cursor.mdx?collection=docs"
-import * as __fd_glob_94 from "../content/docs/components/dashboard-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_95 from "../content/docs/components/data-table.mdx?collection=docs"
-import * as __fd_glob_96 from "../content/docs/components/date-picker.mdx?collection=docs"
-import * as __fd_glob_97 from "../content/docs/components/desktop-hooks.mdx?collection=docs"
-import * as __fd_glob_98 from "../content/docs/components/desktop-spotlight.mdx?collection=docs"
-import * as __fd_glob_99 from "../content/docs/components/desktop-window.mdx?collection=docs"
-import * as __fd_glob_100 from "../content/docs/components/desktop.mdx?collection=docs"
-import * as __fd_glob_101 from "../content/docs/components/dialog-stack.mdx?collection=docs"
-import * as __fd_glob_102 from "../content/docs/components/dialog.mdx?collection=docs"
-import * as __fd_glob_103 from "../content/docs/components/dock.mdx?collection=docs"
-import * as __fd_glob_104 from "../content/docs/components/drawer.mdx?collection=docs"
-import * as __fd_glob_105 from "../content/docs/components/dropdown-menu.mdx?collection=docs"
-import * as __fd_glob_106 from "../content/docs/components/dropzone.mdx?collection=docs"
-import * as __fd_glob_107 from "../content/docs/components/e-commerce-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_108 from "../content/docs/components/editor.mdx?collection=docs"
-import * as __fd_glob_109 from "../content/docs/components/empty.mdx?collection=docs"
-import * as __fd_glob_110 from "../content/docs/components/field.mdx?collection=docs"
-import * as __fd_glob_111 from "../content/docs/components/form.mdx?collection=docs"
-import * as __fd_glob_112 from "../content/docs/components/gantt.mdx?collection=docs"
-import * as __fd_glob_113 from "../content/docs/components/glimpse.mdx?collection=docs"
-import * as __fd_glob_114 from "../content/docs/components/grid-pattern.mdx?collection=docs"
-import * as __fd_glob_115 from "../content/docs/components/hover-card.mdx?collection=docs"
-import * as __fd_glob_116 from "../content/docs/components/icon-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_117 from "../content/docs/components/image-crop.mdx?collection=docs"
-import * as __fd_glob_118 from "../content/docs/components/image-zoom.mdx?collection=docs"
-import * as __fd_glob_119 from "../content/docs/components/index.mdx?collection=docs"
-import * as __fd_glob_120 from "../content/docs/components/input-group.mdx?collection=docs"
-import * as __fd_glob_121 from "../content/docs/components/input-otp.mdx?collection=docs"
-import * as __fd_glob_122 from "../content/docs/components/input.mdx?collection=docs"
-import * as __fd_glob_123 from "../content/docs/components/interactive-grid-pattern.mdx?collection=docs"
-import * as __fd_glob_124 from "../content/docs/components/iphone-15-pro.mdx?collection=docs"
-import * as __fd_glob_125 from "../content/docs/components/item.mdx?collection=docs"
-import * as __fd_glob_126 from "../content/docs/components/kanban.mdx?collection=docs"
-import * as __fd_glob_127 from "../content/docs/components/kbd.mdx?collection=docs"
-import * as __fd_glob_128 from "../content/docs/components/label.mdx?collection=docs"
-import * as __fd_glob_129 from "../content/docs/components/limelight-nav.mdx?collection=docs"
-import * as __fd_glob_130 from "../content/docs/components/list.mdx?collection=docs"
-import * as __fd_glob_131 from "../content/docs/components/macos-dock.mdx?collection=docs"
-import * as __fd_glob_132 from "../content/docs/components/magnetic.mdx?collection=docs"
-import * as __fd_glob_133 from "../content/docs/components/marquee.mdx?collection=docs"
-import * as __fd_glob_134 from "../content/docs/components/menu-dock.mdx?collection=docs"
-import * as __fd_glob_135 from "../content/docs/components/menubar.mdx?collection=docs"
-import * as __fd_glob_136 from "../content/docs/components/message-dock.mdx?collection=docs"
-import * as __fd_glob_137 from "../content/docs/components/mini-calendar.mdx?collection=docs"
-import * as __fd_glob_138 from "../content/docs/components/minimal-tiptap.mdx?collection=docs"
-import * as __fd_glob_139 from "../content/docs/components/motion-highlight.mdx?collection=docs"
-import * as __fd_glob_140 from "../content/docs/components/navigation-menu.mdx?collection=docs"
-import * as __fd_glob_141 from "../content/docs/components/pagination.mdx?collection=docs"
-import * as __fd_glob_142 from "../content/docs/components/particles-background.mdx?collection=docs"
-import * as __fd_glob_143 from "../content/docs/components/particles.mdx?collection=docs"
-import * as __fd_glob_144 from "../content/docs/components/pill.mdx?collection=docs"
-import * as __fd_glob_145 from "../content/docs/components/pin-list.mdx?collection=docs"
-import * as __fd_glob_146 from "../content/docs/components/pixel-image.mdx?collection=docs"
-import * as __fd_glob_147 from "../content/docs/components/popover.mdx?collection=docs"
-import * as __fd_glob_148 from "../content/docs/components/progress.mdx?collection=docs"
-import * as __fd_glob_149 from "../content/docs/components/qr-code.mdx?collection=docs"
-import * as __fd_glob_150 from "../content/docs/components/radio-group.mdx?collection=docs"
-import * as __fd_glob_151 from "../content/docs/components/relative-time.mdx?collection=docs"
-import * as __fd_glob_152 from "../content/docs/components/resizable.mdx?collection=docs"
-import * as __fd_glob_153 from "../content/docs/components/safari.mdx?collection=docs"
-import * as __fd_glob_154 from "../content/docs/components/sandbox.mdx?collection=docs"
-import * as __fd_glob_155 from "../content/docs/components/scroll-area.mdx?collection=docs"
-import * as __fd_glob_156 from "../content/docs/components/search-and-toggle-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_157 from "../content/docs/components/select.mdx?collection=docs"
-import * as __fd_glob_158 from "../content/docs/components/separator.mdx?collection=docs"
-import * as __fd_glob_159 from "../content/docs/components/sheet.mdx?collection=docs"
-import * as __fd_glob_160 from "../content/docs/components/simple-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_161 from "../content/docs/components/skeleton.mdx?collection=docs"
-import * as __fd_glob_162 from "../content/docs/components/slider.mdx?collection=docs"
-import * as __fd_glob_163 from "../content/docs/components/snippet.mdx?collection=docs"
-import * as __fd_glob_164 from "../content/docs/components/sonner.mdx?collection=docs"
-import * as __fd_glob_165 from "../content/docs/components/spinner.mdx?collection=docs"
-import * as __fd_glob_166 from "../content/docs/components/stars-scrolling-wheel.mdx?collection=docs"
-import * as __fd_glob_167 from "../content/docs/components/status-dashboard-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_168 from "../content/docs/components/status.mdx?collection=docs"
-import * as __fd_glob_169 from "../content/docs/components/switch.mdx?collection=docs"
-import * as __fd_glob_170 from "../content/docs/components/table.mdx?collection=docs"
-import * as __fd_glob_171 from "../content/docs/components/tabs.mdx?collection=docs"
-import * as __fd_glob_172 from "../content/docs/components/tags.mdx?collection=docs"
-import * as __fd_glob_173 from "../content/docs/components/team-switcher-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_174 from "../content/docs/components/terminal.mdx?collection=docs"
-import * as __fd_glob_175 from "../content/docs/components/textarea.mdx?collection=docs"
-import * as __fd_glob_176 from "../content/docs/components/timeline.mdx?collection=docs"
-import * as __fd_glob_177 from "../content/docs/components/toast.mdx?collection=docs"
-import * as __fd_glob_178 from "../content/docs/components/toggle-group.mdx?collection=docs"
-import * as __fd_glob_179 from "../content/docs/components/toggle.mdx?collection=docs"
-import * as __fd_glob_180 from "../content/docs/components/tooltip.mdx?collection=docs"
-import * as __fd_glob_181 from "../content/docs/components/two-tier-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_182 from "../content/docs/components/typography.mdx?collection=docs"
-import * as __fd_glob_183 from "../content/docs/components/underline-navigation-bar.mdx?collection=docs"
-import * as __fd_glob_184 from "../content/docs/components/video-player.mdx?collection=docs"
-import * as __fd_glob_28 from "../content/docs/dark-mode/astro.mdx?collection=docs"
-import * as __fd_glob_29 from "../content/docs/dark-mode/index.mdx?collection=docs"
-import * as __fd_glob_30 from "../content/docs/dark-mode/next.mdx?collection=docs"
-import * as __fd_glob_31 from "../content/docs/dark-mode/remix.mdx?collection=docs"
-import * as __fd_glob_32 from "../content/docs/dark-mode/vite.mdx?collection=docs"
-import * as __fd_glob_5 from "../content/docs/figma.mdx?collection=docs"
-import * as __fd_glob_25 from "../content/docs/frameworks/index.mdx?collection=docs"
-import * as __fd_glob_26 from "../content/docs/frameworks/react.mdx?collection=docs"
-import * as __fd_glob_27 from "../content/docs/frameworks/vue.mdx?collection=docs"
-import * as __fd_glob_33 from "../content/docs/guides/page-builder.mdx?collection=docs"
-import * as __fd_glob_34 from "../content/docs/guides/visual-workflows.mdx?collection=docs"
-import * as __fd_glob_35 from "../content/docs/hanzo-react/getting-started.mdx?collection=docs"
-import * as __fd_glob_36 from "../content/docs/hanzo-react/hooks.mdx?collection=docs"
-import * as __fd_glob_6 from "../content/docs/index.mdx?collection=docs"
-import * as __fd_glob_37 from "../content/docs/installation/astro.mdx?collection=docs"
-import * as __fd_glob_38 from "../content/docs/installation/gatsby.mdx?collection=docs"
-import * as __fd_glob_39 from "../content/docs/installation/index.mdx?collection=docs"
-import * as __fd_glob_40 from "../content/docs/installation/laravel.mdx?collection=docs"
-import * as __fd_glob_41 from "../content/docs/installation/manual.mdx?collection=docs"
-import * as __fd_glob_42 from "../content/docs/installation/next.mdx?collection=docs"
-import * as __fd_glob_43 from "../content/docs/installation/remix.mdx?collection=docs"
-import * as __fd_glob_44 from "../content/docs/installation/vite.mdx?collection=docs"
-import * as __fd_glob_7 from "../content/docs/mcp.mdx?collection=docs"
-import * as __fd_glob_45 from "../content/docs/packages/index.mdx?collection=docs"
-import * as __fd_glob_186 from "../content/docs/testing/index.mdx?collection=docs"
-import * as __fd_glob_8 from "../content/docs/theming.mdx?collection=docs"
-import * as __fd_glob_185 from "../content/docs/white-label/index.mdx?collection=docs"
-import type * as Config from "../source.config"
-
-const create = server<
-  typeof Config,
-  import("@hanzo/docs-mdx/runtime/types").InternalTypeConfig & {
-    DocData: {}
-  }
->({ doc: { passthroughs: ["extractedReferences"] } })
-
-export const docs = await create.docs(
-  "docs",
-  "content/docs",
-  {},
-  {
-    "about.mdx": __fd_glob_0,
-    "changelog.mdx": __fd_glob_1,
-    "cli.mdx": __fd_glob_2,
-    "components-json.mdx": __fd_glob_3,
-    "components.mdx": __fd_glob_4,
-    "figma.mdx": __fd_glob_5,
-    "index.mdx": __fd_glob_6,
-    "mcp.mdx": __fd_glob_7,
-    "theming.mdx": __fd_glob_8,
-    "ai/actions.mdx": __fd_glob_9,
-    "ai/agents.mdx": __fd_glob_10,
-    "ai/assistant.mdx": __fd_glob_11,
-    "ai/chat.mdx": __fd_glob_12,
-    "ai/code.mdx": __fd_glob_13,
-    "ai/index.mdx": __fd_glob_14,
-    "ai/models.mdx": __fd_glob_15,
-    "ai/playground.mdx": __fd_glob_16,
-    "ai/tools.mdx": __fd_glob_17,
-    "ai/vision.mdx": __fd_glob_18,
-    "ai/voice-settings.mdx": __fd_glob_19,
-    "ai/voice.mdx": __fd_glob_20,
-    "block-examples/billing.mdx": __fd_glob_21,
-    "block-examples/compose-spec.mdx": __fd_glob_22,
-    "block-examples/newsletter.mdx": __fd_glob_23,
-    "block-examples/pricing.mdx": __fd_glob_24,
-    "frameworks/index.mdx": __fd_glob_25,
-    "frameworks/react.mdx": __fd_glob_26,
-    "frameworks/vue.mdx": __fd_glob_27,
-    "dark-mode/astro.mdx": __fd_glob_28,
-    "dark-mode/index.mdx": __fd_glob_29,
-    "dark-mode/next.mdx": __fd_glob_30,
-    "dark-mode/remix.mdx": __fd_glob_31,
-    "dark-mode/vite.mdx": __fd_glob_32,
-    "guides/page-builder.mdx": __fd_glob_33,
-    "guides/visual-workflows.mdx": __fd_glob_34,
-    "hanzo-react/getting-started.mdx": __fd_glob_35,
-    "hanzo-react/hooks.mdx": __fd_glob_36,
-    "installation/astro.mdx": __fd_glob_37,
-    "installation/gatsby.mdx": __fd_glob_38,
-    "installation/index.mdx": __fd_glob_39,
-    "installation/laravel.mdx": __fd_glob_40,
-    "installation/manual.mdx": __fd_glob_41,
-    "installation/next.mdx": __fd_glob_42,
-    "installation/remix.mdx": __fd_glob_43,
-    "installation/vite.mdx": __fd_glob_44,
-    "packages/index.mdx": __fd_glob_45,
-    "components/3d-card.mdx": __fd_glob_46,
-    "components/3d-marquee.mdx": __fd_glob_47,
-    "components/3d-pin.mdx": __fd_glob_48,
-    "components/accordion.mdx": __fd_glob_49,
-    "components/advanced-navigation-bar.mdx": __fd_glob_50,
-    "components/ai-model-selector-navigation-bar.mdx": __fd_glob_51,
-    "components/alert-dialog.mdx": __fd_glob_52,
-    "components/alert.mdx": __fd_glob_53,
-    "components/android.mdx": __fd_glob_54,
-    "components/animated-beam.mdx": __fd_glob_55,
-    "components/animated-cursor.mdx": __fd_glob_56,
-    "components/animated-testimonials.mdx": __fd_glob_57,
-    "components/animated-tooltip.mdx": __fd_glob_58,
-    "components/animation-components.mdx": __fd_glob_59,
-    "components/announcement.mdx": __fd_glob_60,
-    "components/app-switcher-navigation-bar.mdx": __fd_glob_61,
-    "components/apple-cards-carousel.mdx": __fd_glob_62,
-    "components/apple-hello-effect.mdx": __fd_glob_63,
-    "components/aspect-ratio.mdx": __fd_glob_64,
-    "components/avatar-group.mdx": __fd_glob_65,
-    "components/avatar.mdx": __fd_glob_66,
-    "components/badge.mdx": __fd_glob_67,
-    "components/banner.mdx": __fd_glob_68,
-    "components/breadcrumb-and-filters-navigation-bar.mdx": __fd_glob_69,
-    "components/breadcrumb-navigation-bar.mdx": __fd_glob_70,
-    "components/breadcrumb.mdx": __fd_glob_71,
-    "components/button-group.mdx": __fd_glob_72,
-    "components/button.mdx": __fd_glob_73,
-    "components/calendar.mdx": __fd_glob_74,
-    "components/card.mdx": __fd_glob_75,
-    "components/carousel.mdx": __fd_glob_76,
-    "components/centered-logo-navigation-bar.mdx": __fd_glob_77,
-    "components/checkbox.mdx": __fd_glob_78,
-    "components/choicebox.mdx": __fd_glob_79,
-    "components/code-block.mdx": __fd_glob_80,
-    "components/code-editor.mdx": __fd_glob_81,
-    "components/code-tabs.mdx": __fd_glob_82,
-    "components/collaboration-navigation-bar.mdx": __fd_glob_83,
-    "components/collapsible.mdx": __fd_glob_84,
-    "components/color-picker.mdx": __fd_glob_85,
-    "components/combobox.mdx": __fd_glob_86,
-    "components/command.mdx": __fd_glob_87,
-    "components/communication-navigation-bar.mdx": __fd_glob_88,
-    "components/comparison.mdx": __fd_glob_89,
-    "components/context-menu.mdx": __fd_glob_90,
-    "components/context-switcher-navigation-bar.mdx": __fd_glob_91,
-    "components/credit-card.mdx": __fd_glob_92,
-    "components/cursor.mdx": __fd_glob_93,
-    "components/dashboard-navigation-bar.mdx": __fd_glob_94,
-    "components/data-table.mdx": __fd_glob_95,
-    "components/date-picker.mdx": __fd_glob_96,
-    "components/desktop-hooks.mdx": __fd_glob_97,
-    "components/desktop-spotlight.mdx": __fd_glob_98,
-    "components/desktop-window.mdx": __fd_glob_99,
-    "components/desktop.mdx": __fd_glob_100,
-    "components/dialog-stack.mdx": __fd_glob_101,
-    "components/dialog.mdx": __fd_glob_102,
-    "components/dock.mdx": __fd_glob_103,
-    "components/drawer.mdx": __fd_glob_104,
-    "components/dropdown-menu.mdx": __fd_glob_105,
-    "components/dropzone.mdx": __fd_glob_106,
-    "components/e-commerce-navigation-bar.mdx": __fd_glob_107,
-    "components/editor.mdx": __fd_glob_108,
-    "components/empty.mdx": __fd_glob_109,
-    "components/field.mdx": __fd_glob_110,
-    "components/form.mdx": __fd_glob_111,
-    "components/gantt.mdx": __fd_glob_112,
-    "components/glimpse.mdx": __fd_glob_113,
-    "components/grid-pattern.mdx": __fd_glob_114,
-    "components/hover-card.mdx": __fd_glob_115,
-    "components/icon-navigation-bar.mdx": __fd_glob_116,
-    "components/image-crop.mdx": __fd_glob_117,
-    "components/image-zoom.mdx": __fd_glob_118,
-    "components/index.mdx": __fd_glob_119,
-    "components/input-group.mdx": __fd_glob_120,
-    "components/input-otp.mdx": __fd_glob_121,
-    "components/input.mdx": __fd_glob_122,
-    "components/interactive-grid-pattern.mdx": __fd_glob_123,
-    "components/iphone-15-pro.mdx": __fd_glob_124,
-    "components/item.mdx": __fd_glob_125,
-    "components/kanban.mdx": __fd_glob_126,
-    "components/kbd.mdx": __fd_glob_127,
-    "components/label.mdx": __fd_glob_128,
-    "components/limelight-nav.mdx": __fd_glob_129,
-    "components/list.mdx": __fd_glob_130,
-    "components/macos-dock.mdx": __fd_glob_131,
-    "components/magnetic.mdx": __fd_glob_132,
-    "components/marquee.mdx": __fd_glob_133,
-    "components/menu-dock.mdx": __fd_glob_134,
-    "components/menubar.mdx": __fd_glob_135,
-    "components/message-dock.mdx": __fd_glob_136,
-    "components/mini-calendar.mdx": __fd_glob_137,
-    "components/minimal-tiptap.mdx": __fd_glob_138,
-    "components/motion-highlight.mdx": __fd_glob_139,
-    "components/navigation-menu.mdx": __fd_glob_140,
-    "components/pagination.mdx": __fd_glob_141,
-    "components/particles-background.mdx": __fd_glob_142,
-    "components/particles.mdx": __fd_glob_143,
-    "components/pill.mdx": __fd_glob_144,
-    "components/pin-list.mdx": __fd_glob_145,
-    "components/pixel-image.mdx": __fd_glob_146,
-    "components/popover.mdx": __fd_glob_147,
-    "components/progress.mdx": __fd_glob_148,
-    "components/qr-code.mdx": __fd_glob_149,
-    "components/radio-group.mdx": __fd_glob_150,
-    "components/relative-time.mdx": __fd_glob_151,
-    "components/resizable.mdx": __fd_glob_152,
-    "components/safari.mdx": __fd_glob_153,
-    "components/sandbox.mdx": __fd_glob_154,
-    "components/scroll-area.mdx": __fd_glob_155,
-    "components/search-and-toggle-navigation-bar.mdx": __fd_glob_156,
-    "components/select.mdx": __fd_glob_157,
-    "components/separator.mdx": __fd_glob_158,
-    "components/sheet.mdx": __fd_glob_159,
-    "components/simple-navigation-bar.mdx": __fd_glob_160,
-    "components/skeleton.mdx": __fd_glob_161,
-    "components/slider.mdx": __fd_glob_162,
-    "components/snippet.mdx": __fd_glob_163,
-    "components/sonner.mdx": __fd_glob_164,
-    "components/spinner.mdx": __fd_glob_165,
-    "components/stars-scrolling-wheel.mdx": __fd_glob_166,
-    "components/status-dashboard-navigation-bar.mdx": __fd_glob_167,
-    "components/status.mdx": __fd_glob_168,
-    "components/switch.mdx": __fd_glob_169,
-    "components/table.mdx": __fd_glob_170,
-    "components/tabs.mdx": __fd_glob_171,
-    "components/tags.mdx": __fd_glob_172,
-    "components/team-switcher-navigation-bar.mdx": __fd_glob_173,
-    "components/terminal.mdx": __fd_glob_174,
-    "components/textarea.mdx": __fd_glob_175,
-    "components/timeline.mdx": __fd_glob_176,
-    "components/toast.mdx": __fd_glob_177,
-    "components/toggle-group.mdx": __fd_glob_178,
-    "components/toggle.mdx": __fd_glob_179,
-    "components/tooltip.mdx": __fd_glob_180,
-    "components/two-tier-navigation-bar.mdx": __fd_glob_181,
-    "components/typography.mdx": __fd_glob_182,
-    "components/underline-navigation-bar.mdx": __fd_glob_183,
-    "components/video-player.mdx": __fd_glob_184,
-    "white-label/index.mdx": __fd_glob_185,
-    "testing/index.mdx": __fd_glob_186,
-  }
-)

app/.docs/source.config.mjs

@@ -1,40 +0,0 @@
-// source.config.ts
-import {
-  defineConfig,
-  defineDocs,
-  frontmatterSchema
-} from "@hanzo/docs-mdx/config";
-import rehypePrettyCode from "rehype-pretty-code";
-import { z } from "zod";
-var source_config_default = defineConfig({
-  mdxOptions: {
-    rehypePlugins: [
-      [
-        rehypePrettyCode,
-        {
-          theme: {
-            dark: "github-dark",
-            light: "github-light-default"
-          },
-          keepBackground: false
-        }
-      ]
-    ]
-  }
-});
-var docs = defineDocs({
-  dir: "content/docs",
-  docs: {
-    schema: frontmatterSchema.extend({
-      links: z.object({
-        doc: z.string().optional(),
-        api: z.string().optional()
-      }).optional(),
-      toc: z.boolean().optional()
-    })
-  }
-});
-export {
-  source_config_default as default,
-  docs
-};

app/.eslintignore

@@ -0,0 +1,12 @@
+node_modules/
+.next/
+out/
+build/
+dist/
+next-env.d.ts
+__registry__/
+.source/
+*.config.js
+*.config.mjs
+.turbo/
+coverage/

app/.prettierignore

@@ -4,5 +4,3 @@ node_modules
 build
 .contentlayer
 apps/web/pages/api/registry.json
-**/fixtures
-deprecated

app/CLAUDE.md

@@ -0,0 +1,361 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Overview
+
+This is the **Hanzo UI App** - the documentation and showcase site for the @hanzo/ui component library. It's built with Next.js 15.3.1, React 19, and Fumadocs for documentation. The site serves as both documentation and a living demo of 149+ components.
+
+**Key URLs:**
+- Production: https://ui.hanzo.ai
+- Local Dev: http://localhost:3003
+- Repo: github.com/hanzoai/ui (monorepo root is parent directory)
+
+## Essential Commands
+
+### Development
+```bash
+# Start dev server (port 3003)
+pnpm dev
+
+# Build site (includes registry build + Next.js build)
+pnpm build
+
+# Build registry only (generates JSON files for CLI)
+pnpm registry:build
+
+# Start production server (port 3001)
+pnpm start
+```
+
+### Code Quality
+```bash
+# Lint
+pnpm lint
+pnpm lint:fix
+
+# Type check
+pnpm typecheck
+
+# Format
+pnpm format:write
+pnpm format:check
+```
+
+### Registry Management
+```bash
+# Validate external registries
+pnpm validate:registries
+
+# Capture screenshots (for component previews)
+pnpm registry:capture
+```
+
+## Architecture Overview
+
+### Three-Layer System
+
+**1. Components** (`/registry/{default,new-york}/ui/`)
+- Single UI elements (Button, Input, Card, Dialog)
+- Reusable primitives that compose into larger UIs
+- Two theme variants: default and new-york
+- 149 components total (115 implemented, 34 stubs)
+
+**2. Examples** (`/registry/{default,new-york}/example/`)
+- Usage demonstrations for each component
+- Shows component in isolation with typical props
+- Used in documentation via `<ComponentPreview name="..." />`
+
+**3. Blocks** (`/registry/{default,new-york}/blocks/`)
+- Viewport-sized sections (Dashboard, Hero, Login, Pricing)
+- Compose multiple components into full-page layouts
+- Production-ready templates users can copy
+- 24+ blocks including dashboard-01, sidebar-07, login-03
+
+### Registry Build System
+
+The registry is the **core of the component distribution system**:
+
+1. **Source Files**: Components in `/registry/{style}/ui/`
+2. **Build Script**: `scripts/build-registry.mts` reads components and generates:
+   - JSON metadata files in `/public/registry/styles/{style}/{name}.json`
+   - Includes dependencies, files, type info
+3. **CLI Consumption**: The `@hanzo/ui` CLI reads these JSON files to install components
+4. **Documentation**: MDX files in `/content/docs/components/` reference the registry
+
+**CRITICAL**: Always run `pnpm registry:build` before building the app if you modify components.
+
+### Documentation System
+
+- **Framework**: Fumadocs (replaced Contentlayer in v4 migration)
+- **MDX Files**: `/content/docs/` contains all documentation
+- **Components in MDX**: Special components available in MDX via `mdx-components.tsx`:
+  - `<ComponentPreview name="..." />` - Live component demo
+  - `<ComponentSource name="..." />` - Component source code
+  - `<CodeTabs>` - Installation method tabs (CLI/Manual)
+  - `<Steps>` - Step-by-step instructions
+- **Navigation**: Configured in `/config/docs.ts`
+
+### Page Builder (`/builder`)
+
+New drag-drop visual builder for assembling pages from blocks:
+- **Left Sidebar**: Filterable block library
+- **Canvas**: Drag-drop assembly area with reordering
+- **Export**: Generates React TSX code
+- **Tech**: @dnd-kit for drag-drop, SortableContext for reordering
+
+Access at `/builder` route.
+
+## Key File Locations
+
+### Component Development
+```
+registry/default/ui/{component}.tsx          # Component implementation
+registry/default/example/{component}-demo.tsx # Usage example
+content/docs/components/{component}.mdx       # Documentation
+```
+
+### Configuration
+```
+config/site.ts        # Site metadata, links
+config/docs.ts        # Documentation navigation structure
+tailwind.config.cjs   # Tailwind configuration
+components.json       # hanzo CLI configuration
+```
+
+### Build & Scripts
+```
+scripts/build-registry.mts      # Registry JSON generator
+scripts/validate-registries.mts # External registry validator
+__registry__/index.tsx          # Auto-generated registry index
+```
+
+## Component Creation Workflow
+
+### 1. Create Component Files
+```bash
+# Create in both variants
+touch registry/default/ui/my-component.tsx
+touch registry/new-york/ui/my-component.tsx
+
+# Create demo
+touch registry/default/example/my-component-demo.tsx
+```
+
+### 2. Implement Component
+Follow the standard pattern:
+```tsx
+"use client"
+
+import * as React from "react"
+import { cn } from "@/lib/utils"
+
+interface MyComponentProps extends React.HTMLAttributes<HTMLDivElement> {
+  variant?: "default" | "outline"
+}
+
+const MyComponent = React.forwardRef<HTMLDivElement, MyComponentProps>(
+  ({ className, variant = "default", ...props }, ref) => {
+    return (
+      <div
+        ref={ref}
+        className={cn("base-classes", className)}
+        {...props}
+      />
+    )
+  }
+)
+MyComponent.displayName = "MyComponent"
+
+export { MyComponent }
+```
+
+### 3. Create Documentation
+```bash
+# Create MDX file
+touch content/docs/components/my-component.mdx
+```
+
+Include:
+- `<ComponentPreview name="my-component-demo" />`
+- Installation instructions with `<CodeTabs>`
+- Usage examples
+- API table with props
+
+### 4. Add to Navigation
+Edit `config/docs.ts` to add component to sidebar navigation.
+
+### 5. Build Registry
+```bash
+pnpm registry:build
+```
+
+### 6. Test
+```bash
+pnpm dev
+# Visit http://localhost:3003/docs/components/my-component
+```
+
+## Registry Architecture
+
+The registry system enables the `npx hanzo-ui@latest add {component}` CLI workflow:
+
+**Registry Entry Structure:**
+```json
+{
+  "name": "button",
+  "type": "components:ui",
+  "files": ["registry/default/ui/button.tsx"],
+  "dependencies": ["class-variance-authority"],
+  "registryDependencies": ["utils"]
+}
+```
+
+**External Registries** (`registries.json`):
+- 35+ external component sources
+- Examples: @aceternity, @magicui, @hanzo-editor
+- Validated via `pnpm validate:registries`
+
+## Theme System
+
+**CSS Variables** (`/styles/globals.css`):
+- Base theme colors defined in HSL
+- Primary color: `210 100% 50%` (electric blue)
+- Dark mode via `.dark` class
+- All components use `hsl(var(--primary))` pattern
+
+**Two Visual Styles:**
+- **default**: More rounded, softer shadows
+- **new-york**: Flatter, sharper, minimal
+
+Both styles share the same component API, only visual styling differs.
+
+## Build System
+
+### Production Build Process
+1. `pnpm registry:build` - Generate registry JSON files
+2. `next build` - Build Next.js app
+3. Static export to `/out` directory for GitHub Pages
+
+### Local Development
+- Uses Turbopack for fast HMR
+- Port 3003 (configurable)
+- MDX hot reload via Fumadocs
+
+## Component vs Block Distinction
+
+**Components** (149 total):
+- Single-purpose UI elements
+- Examples: Button, Input, Card, Dialog, Dropdown
+- Used as building blocks
+- Installed individually via CLI
+
+**Blocks** (24+ available):
+- Full viewport sections
+- Examples: dashboard-01 (admin layout), login-03 (auth page), sidebar-07
+- Compose multiple components
+- Ready-to-use page sections
+- Users copy entire blocks, not install via CLI
+
+## Import Patterns
+
+Components can be imported three ways:
+
+**1. Package Import** (if using @hanzo/ui package):
+```tsx
+import { Button, Card } from "@hanzo/ui"
+```
+
+**2. Registry Import** (in documentation/examples):
+```tsx
+import { Button } from "@/registry/default/ui/button"
+```
+
+**3. Local Import** (after installing via CLI):
+```tsx
+import { Button } from "@/components/ui/button"
+```
+
+The registry uses `@/registry/{style}/` which gets rewritten to `@/components/` during installation.
+
+## MDX Component System
+
+Components available in all MDX files:
+
+- `<ComponentPreview name="button-demo" />` - Live demo
+- `<ComponentSource name="button" />` - Source code display
+- `<ComponentExample>` - Example wrapper
+- `<CodeTabs>` - Installation tabs (requires useConfig hook)
+- `<Steps>` / `<Step>` - Step-by-step instructions
+- `<Tabs>` / `<TabsList>` / `<TabsTrigger>` / `<TabsContent>` - Content tabs
+- `<Callout>` - Info/warning callouts
+
+## Testing
+
+No formal test suite currently. Testing is done via:
+1. Local dev server visual testing
+2. Build process catches type errors
+3. Registry validation ensures component metadata is correct
+
+## Deployment
+
+**GitHub Pages** (automatic):
+- Workflow: `.github/workflows/deploy-gh-pages.yml`
+- Triggers on push to main
+- Builds app + pkg/ui package
+- Deploys to ui.hanzo.ai
+- Requires: npm-run-all, del-cli for dependency builds
+
+**Important**: The GitHub Actions workflow builds the `pkg/ui` package first, then the app, to ensure registry has latest component code.
+
+## Common Patterns
+
+### Stub Components
+Components marked for future implementation:
+```tsx
+export default function Component() {
+  return (
+    <div className="flex items-center justify-center p-8">
+      <p className="text-muted-foreground">Component coming soon</p>
+    </div>
+  )
+}
+```
+
+Currently 34 stubs remaining (documented but not implemented).
+
+### Component Dependencies
+- Radix UI primitives for accessible base components
+- `cn()` utility from `@/lib/utils` for className merging
+- `cva` (class-variance-authority) for variant management
+- Lucide React for icons
+- Framer Motion for animations (some components)
+
+### Registry Dependencies
+Components can depend on other registry components:
+```json
+{
+  "registryDependencies": ["button", "dialog", "utils"]
+}
+```
+
+These are auto-installed when user adds the component.
+
+## Recent Architectural Changes (2025-10-05)
+
+1. **Migrated from Contentlayer to Fumadocs** for MDX processing
+2. **Upgraded to Next.js 15.3.1** with Turbopack
+3. **React 19** with new JSX transform
+4. **Added @dnd-kit** for page builder drag-drop
+5. **Synced with hanzo/ui v3.4.0** (7 new components: button-group, empty, field, input-group, item, kbd, spinner)
+6. **Electric blue primary color** (210 100% 50%)
+7. **Page builder feature** at `/builder` route
+
+## Notes for AI Assistants
+
+- **Registry must rebuild** after component changes: `pnpm registry:build`
+- **Two theme variants** must be kept in sync: default and new-york
+- **Import paths** in components use `@/registry/{style}/` which becomes `@/components/` after CLI install
+- **MDX components** are defined in `mdx-components.tsx`, not auto-imported
+- **Blocks are different** from components - they're full-page sections, not installable via CLI
+- **GitHub Pages deployment** requires building pkg/ui package first (workflow handles this)

app/IDENTITY_README.md

@@ -1,254 +0,0 @@
-# Hanzo Identity Registration System
-
-A decentralized identity registration system for Hanzo, Lux, and Zoo networks.
-
-## Overview
-
-The identity system allows users to claim unique identities across multiple blockchain networks with a tiered pricing structure based on name length.
-
-## Features
-
-- **Multi-Network Support**: Register identities on Hanzo, Lux, and Zoo (mainnet and testnet)
-- **Tiered Pricing**: 
-  - Single character (1): 100,000 AI
-  - Two characters (2): 10,000 AI
-  - Three characters (3): 1,000 AI
-  - Four characters (4): 100 AI
-  - Five or more (5+): 10 AI
-- **Referral System**: 50% discount with valid referrer
-- **Web3 Wallet Integration**: RainbowKit for seamless wallet connection
-- **Real-time Validation**: Check name availability and format validation
-- **Responsive UI**: Modern, accessible interface built with Radix UI
-
-## Project Structure
-
-```
-/Users/z/work/hanzo/ui/app/
-├── app/(app)/identity/page.tsx      # Identity registration page
-├── components/web3-provider.tsx      # Web3/Wagmi provider wrapper
-├── lib/
-│   ├── wagmi.ts                      # Wagmi config with custom networks
-│   └── contracts.ts                  # Contract ABIs and addresses
-└── .env.example                      # Environment variable template
-```
-
-## Smart Contracts
-
-Located in `/Users/z/work/lux/standard/src/`:
-
-- **HanzoRegistry.sol**: Core identity registration contract
-  - Manages identity claims
-  - Handles staking requirements
-  - Supports delegation and referrals
-  - Implements reward distribution
-
-- **AIToken.sol**: ERC20 governance token
-  - Staking and vesting functionality
-  - Voting power for governance
-  - Deflationary burn mechanism
-
-- **AIFaucet.sol**: Token distribution faucet
-  - 100 AI tokens per authenticated user
-  - 24-hour cooldown period
-  - Daily limits and rate limiting
-
-## Setup
-
-### 1. Install Dependencies
-
-```bash
-cd /Users/z/work/hanzo/ui/app
-pnpm install
-```
-
-### 2. Configure Environment
-
-Copy `.env.example` to `.env.local`:
-
-```bash
-cp .env.example .env.local
-```
-
-Get a WalletConnect Project ID from https://cloud.walletconnect.com/ and update:
-
-```
-NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id_here
-```
-
-### 3. Deploy Contracts
-
-Deploy the smart contracts to your target networks:
-
-```bash
-cd /Users/z/work/lux/standard
-
-# For Hanzo Mainnet
-forge script script/DeployIdentitySystem.s.sol:DeployIdentitySystem \
-  --rpc-url https://rpc.hanzo.ai \
-  --broadcast
-
-# For Hanzo Testnet
-forge script script/DeployIdentitySystem.s.sol:DeployIdentitySystem \
-  --rpc-url https://testnet-rpc.hanzo.ai \
-  --broadcast
-
-# For Lux Mainnet
-forge script script/DeployIdentitySystem.s.sol:DeployIdentitySystem \
-  --rpc-url https://api.lux.network/v1/bc/C/rpc \
-  --broadcast
-
-# For Zoo Mainnet
-forge script script/DeployIdentitySystem.s.sol:DeployIdentitySystem \
-  --rpc-url https://rpc.zoo.network \
-  --broadcast
-```
-
-### 4. Update Contract Addresses
-
-After deployment, update the contract addresses in `lib/contracts.ts`:
-
-```typescript
-export const CONTRACT_ADDRESSES: Record<number, { registry: `0x${string}`; token: `0x${string}` }> = {
-  36963: { // Hanzo Mainnet
-    registry: '0xYourRegistryAddress',
-    token: '0xYourTokenAddress',
-  },
-  // ... update other networks
-}
-```
-
-### 5. Run Development Server
-
-```bash
-pnpm dev
-```
-
-Visit `http://localhost:3333/identity` to access the identity registration page.
-
-## Networks
-
-| Network | Chain ID | RPC URL | Explorer |
-|---------|----------|---------|----------|
-| Hanzo Mainnet | 36963 | https://rpc.hanzo.ai | https://explorer.hanzo.ai |
-| Hanzo Testnet | 36962 | https://testnet-rpc.hanzo.ai | https://testnet-explorer.hanzo.ai |
-| Lux Mainnet | 96369 | https://api.lux.network/v1/bc/C/rpc | https://explorer.lux.network |
-| Lux Testnet | 96368 | https://testnet-api.lux.network/v1/bc/C/rpc | https://testnet-explorer.lux.network |
-| Zoo Mainnet | 200200 | https://rpc.zoo.network | https://explorer.zoo.network |
-| Zoo Testnet | 200201 | https://testnet-rpc.zoo.network | https://testnet-explorer.zoo.network |
-
-## Identity Format
-
-Identities follow the format: `@username.network/profile/type/name`
-
-- **Username**: Letters, numbers, dots, and underscores
-- **Network**: Automatically determined by connected chain
-  - `.hanzo` or `.ai` for Hanzo mainnet
-  - `.hanzo-testnet` for Hanzo testnet
-  - `.lux` for Lux mainnet
-  - `.lux-testnet` for Lux testnet
-  - `.zoo` for Zoo mainnet
-  - `.zoo-testnet` for Zoo testnet
-- **Profile**: Optional profile path (default: `/profile`)
-
-## Faucet Integration
-
-Users can get AI tokens from the faucet to register identities:
-
-- **Location**: `/faucet` page
-- **Amount**: 100 AI tokens per authenticated user
-- **Cooldown**: 24 hours between drips
-- **Networks**: Hanzo mainnet and testnet only
-
-Configuration in `/Users/z/work/hanzo/faucet/config.json`
-
-## Tech Stack
-
-- **Framework**: Next.js 16 (App Router)
-- **Styling**: Tailwind CSS 4
-- **UI Components**: Radix UI primitives
-- **Web3**: Wagmi, Viem, RainbowKit
-- **State Management**: TanStack Query
-- **Smart Contracts**: Solidity, Foundry
-- **Networks**: Hanzo, Lux, Zoo (mainnet + testnet)
-
-## Development
-
-### Testing Locally
-
-1. Use a testnet for development (Hanzo Testnet recommended)
-2. Connect your wallet to the testnet
-3. Get test AI tokens from the faucet
-4. Test identity registration flow
-
-### Building for Production
-
-```bash
-pnpm build
-```
-
-### Type Checking
-
-```bash
-pnpm typecheck
-```
-
-### Linting
-
-```bash
-pnpm lint
-pnpm lint:fix
-```
-
-## Contract Deployment Scripts
-
-Located in `/Users/z/work/lux/standard/script/`:
-
-- `DeployIdentitySystem.s.sol`: Deploys complete identity system
-  - Deploys AIToken with treasury allocation
-  - Deploys HanzoNft for identity binding
-  - Deploys HanzoRegistry with UUPS proxy
-  - Deploys AIFaucet with 100 AI drip amount
-  - Configures initial permissions and transfers
-
-## Security Considerations
-
-- All contracts use OpenZeppelin's upgradeable patterns
-- Registry uses UUPS proxy for upgradeability
-- Access control with Ownable2Step for safe ownership transfer
-- Pausable functionality for emergency stops
-- Rate limiting on faucet to prevent abuse
-- Input validation for identity names
-- Proper allowance checks before token transfers
-
-## Troubleshooting
-
-### "Insufficient balance" error
-- Get AI tokens from the faucet at `/faucet`
-- Ensure you're connected to the correct network
-
-### "Name already taken" error
-- Try a different identity name
-- Check if the name is available on your current network
-
-### "Invalid format" error
-- Use only letters, numbers, dots, and underscores
-- No spaces or special characters allowed
-
-### Contract not deployed
-- Ensure contracts are deployed to your connected network
-- Update contract addresses in `lib/contracts.ts`
-- Check RPC URL is correct for your network
-
-## Contributing
-
-When adding new features:
-
-1. Update contracts in `/Users/z/work/lux/standard/src/`
-2. Update ABIs in `lib/contracts.ts`
-3. Update UI in `app/(app)/identity/page.tsx`
-4. Add tests for new functionality
-5. Update this README with new features
-
-## License
-
-MIT

app/LLM.md

@@ -1,551 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Repository Overview
-
-This is the **Hanzo UI App** - the documentation and showcase site for the @hanzo/ui component library. It's built with Next.js 15.3.1, React 19, and Fumadocs for documentation. The site serves as both documentation and a living demo of 149+ components.
-
-**Key URLs:**
-- Production: https://ui.hanzo.ai
-- Local Dev: http://localhost:3003
-- Repo: github.com/hanzoai/ui (monorepo root is parent directory)
-
-## Essential Commands
-
-### Development
-```bash
-# Start dev server (port 3003)
-pnpm dev
-
-# Build site (includes registry build + Next.js build)
-pnpm build
-
-# Build registry only (generates JSON files for CLI)
-pnpm registry:build
-
-# Start production server (port 3001)
-pnpm start
-```
-
-### Code Quality
-```bash
-# Lint
-pnpm lint
-pnpm lint:fix
-
-# Type check
-pnpm typecheck
-
-# Format
-pnpm format:write
-pnpm format:check
-```
-
-### Registry Management
-```bash
-# Validate external registries
-pnpm validate:registries
-
-# Capture screenshots (for component previews)
-pnpm registry:capture
-```
-
-## Architecture Overview
-
-### Three-Layer System
-
-**1. Components** (`/registry/{default,new-york}/ui/`)
-- Single UI elements (Button, Input, Card, Dialog)
-- Reusable primitives that compose into larger UIs
-- Two theme variants: default and new-york
-- 149 components total (115 implemented, 34 stubs)
-
-**2. Examples** (`/registry/{default,new-york}/example/`)
-- Usage demonstrations for each component
-- Shows component in isolation with typical props
-- Used in documentation via `<ComponentPreview name="..." />`
-
-**3. Blocks** (`/registry/{default,new-york}/blocks/`)
-- Viewport-sized sections (Dashboard, Hero, Login, Pricing)
-- Compose multiple components into full-page layouts
-- Production-ready templates users can copy
-- 24+ blocks including dashboard-01, sidebar-07, login-03
-
-### Registry Build System
-
-The registry is the **core of the component distribution system**:
-
-1. **Source Files**: Components in `/registry/{style}/ui/`
-2. **Build Script**: `scripts/build-registry.mts` reads components and generates:
-   - JSON metadata files in `/public/registry/styles/{style}/{name}.json`
-   - Includes dependencies, files, type info
-3. **CLI Consumption**: The `@hanzo/ui` CLI reads these JSON files to install components
-4. **Documentation**: MDX files in `/content/docs/components/` reference the registry
-
-**CRITICAL**: Always run `pnpm registry:build` before building the app if you modify components.
-
-### Documentation System
-
-- **Framework**: Fumadocs (replaced Contentlayer in v4 migration)
-- **MDX Files**: `/content/docs/` contains all documentation
-- **Components in MDX**: Special components available in MDX via `mdx-components.tsx`:
-  - `<ComponentPreview name="..." />` - Live component demo
-  - `<ComponentSource name="..." />` - Component source code
-  - `<CodeTabs>` - Installation method tabs (CLI/Manual)
-  - `<Steps>` - Step-by-step instructions
-- **Navigation**: Configured in `/config/docs.ts`
-
-### Page Builder (`/builder`)
-
-New drag-drop visual builder for assembling pages from blocks:
-- **Left Sidebar**: Filterable block library
-- **Canvas**: Drag-drop assembly area with reordering
-- **Export**: Generates React TSX code
-- **Tech**: @dnd-kit for drag-drop, SortableContext for reordering
-
-Access at `/builder` route.
-
-## Key File Locations
-
-### Component Development
-```
-registry/default/ui/{component}.tsx          # Component implementation
-registry/default/example/{component}-demo.tsx # Usage example
-content/docs/components/{component}.mdx       # Documentation
-```
-
-### Configuration
-```
-config/site.ts        # Site metadata, links
-config/docs.ts        # Documentation navigation structure
-tailwind.config.cjs   # Tailwind configuration
-components.json       # hanzo CLI configuration
-```
-
-### Build & Scripts
-```
-scripts/build-registry.mts      # Registry JSON generator
-scripts/validate-registries.mts # External registry validator
-__registry__/index.tsx          # Auto-generated registry index
-```
-
-## Component Creation Workflow
-
-### 1. Create Component Files
-```bash
-# Create in both variants
-touch registry/default/ui/my-component.tsx
-touch registry/new-york/ui/my-component.tsx
-
-# Create demo
-touch registry/default/example/my-component-demo.tsx
-```
-
-### 2. Implement Component
-Follow the standard pattern:
-```tsx
-"use client"
-
-import * as React from "react"
-import { cn } from "@/lib/utils"
-
-interface MyComponentProps extends React.HTMLAttributes<HTMLDivElement> {
-  variant?: "default" | "outline"
-}
-
-const MyComponent = React.forwardRef<HTMLDivElement, MyComponentProps>(
-  ({ className, variant = "default", ...props }, ref) => {
-    return (
-      <div
-        ref={ref}
-        className={cn("base-classes", className)}
-        {...props}
-      />
-    )
-  }
-)
-MyComponent.displayName = "MyComponent"
-
-export { MyComponent }
-```
-
-### 3. Create Documentation
-```bash
-# Create MDX file
-touch content/docs/components/my-component.mdx
-```
-
-Include:
-- `<ComponentPreview name="my-component-demo" />`
-- Installation instructions with `<CodeTabs>`
-- Usage examples
-- API table with props
-
-### 4. Add to Navigation
-Edit `config/docs.ts` to add component to sidebar navigation.
-
-### 5. Build Registry
-```bash
-pnpm registry:build
-```
-
-### 6. Test
-```bash
-pnpm dev
-# Visit http://localhost:3003/docs/components/my-component
-```
-
-## Registry Architecture
-
-The registry system enables the `npx hanzo-ui@latest add {component}` CLI workflow:
-
-**Registry Entry Structure:**
-```json
-{
-  "name": "button",
-  "type": "components:ui",
-  "files": ["registry/default/ui/button.tsx"],
-  "dependencies": ["class-variance-authority"],
-  "registryDependencies": ["utils"]
-}
-```
-
-**External Registries** (`registries.json`):
-- 35+ external component sources
-- Examples: @aceternity, @magicui, @hanzo-editor
-- Validated via `pnpm validate:registries`
-
-## Theme System
-
-**CSS Variables** (`/styles/globals.css`):
-- Base theme colors defined in HSL
-- Primary color: `210 100% 50%` (electric blue)
-- Dark mode via `.dark` class
-- All components use `hsl(var(--primary))` pattern
-
-**Two Visual Styles:**
-- **default**: More rounded, softer shadows
-- **new-york**: Flatter, sharper, minimal
-
-Both styles share the same component API, only visual styling differs.
-
-## Build System
-
-### Production Build Process
-1. `pnpm registry:build` - Generate registry JSON files
-2. `next build` - Build Next.js app
-3. Static export to `/out` directory for GitHub Pages
-
-### Local Development
-- Uses Turbopack for fast HMR
-- Port 3003 (configurable)
-- MDX hot reload via Fumadocs
-
-## Component vs Block Distinction
-
-**Components** (149 total):
-- Single-purpose UI elements
-- Examples: Button, Input, Card, Dialog, Dropdown
-- Used as building blocks
-- Installed individually via CLI
-
-**Blocks** (24+ available):
-- Full viewport sections
-- Examples: dashboard-01 (admin layout), login-03 (auth page), sidebar-07
-- Compose multiple components
-- Ready-to-use page sections
-- Users copy entire blocks, not install via CLI
-
-## Import Patterns
-
-Components can be imported three ways:
-
-**1. Package Import** (if using @hanzo/ui package):
-```tsx
-import { Button, Card } from "@hanzo/ui"
-```
-
-**2. Registry Import** (in documentation/examples):
-```tsx
-import { Button } from "@/registry/default/ui/button"
-```
-
-**3. Local Import** (after installing via CLI):
-```tsx
-import { Button } from "@/components/ui/button"
-```
-
-The registry uses `@/registry/{style}/` which gets rewritten to `@/components/` during installation.
-
-## MDX Component System
-
-Components available in all MDX files:
-
-- `<ComponentPreview name="button-demo" />` - Live demo
-- `<ComponentSource name="button" />` - Source code display
-- `<ComponentExample>` - Example wrapper
-- `<CodeTabs>` - Installation tabs (requires useConfig hook)
-- `<Steps>` / `<Step>` - Step-by-step instructions
-- `<Tabs>` / `<TabsList>` / `<TabsTrigger>` / `<TabsContent>` - Content tabs
-- `<Callout>` - Info/warning callouts
-
-## Testing
-
-No formal test suite currently. Testing is done via:
-1. Local dev server visual testing
-2. Build process catches type errors
-3. Registry validation ensures component metadata is correct
-
-## Deployment
-
-**GitHub Pages** (automatic):
-- Workflow: `.github/workflows/deploy-gh-pages.yml`
-- Triggers on push to main
-- Builds app + pkg/ui package
-- Deploys to ui.hanzo.ai
-- Requires: npm-run-all, del-cli for dependency builds
-
-**Important**: The GitHub Actions workflow builds the `pkg/ui` package first, then the app, to ensure registry has latest component code.
-
-## Common Patterns
-
-### Stub Components
-Components marked for future implementation:
-```tsx
-export default function Component() {
-  return (
-    <div className="flex items-center justify-center p-8">
-      <p className="text-muted-foreground">Component coming soon</p>
-    </div>
-  )
-}
-```
-
-Currently 34 stubs remaining (documented but not implemented).
-
-### Component Dependencies
-- Radix UI primitives for accessible base components
-- `cn()` utility from `@/lib/utils` for className merging
-- `cva` (class-variance-authority) for variant management
-- Lucide React for icons
-- Framer Motion for animations (some components)
-
-### Registry Dependencies
-Components can depend on other registry components:
-```json
-{
-  "registryDependencies": ["button", "dialog", "utils"]
-}
-```
-
-These are auto-installed when user adds the component.
-
-## Recent Architectural Changes (2025-10-05)
-
-1. **Migrated from Contentlayer to Fumadocs** for MDX processing
-2. **Upgraded to Next.js 15.3.1** with Turbopack
-3. **React 19** with new JSX transform
-4. **Added @dnd-kit** for page builder drag-drop
-5. **Synced with hanzo/ui v3.4.0** (7 new components: button-group, empty, field, input-group, item, kbd, spinner)
-6. **Electric blue primary color** (210 100% 50%)
-7. **Page builder feature** at `/builder` route
-
-## Notes for AI Assistants
-
-- **Registry must rebuild** after component changes: `pnpm registry:build`
-- **Two theme variants** must be kept in sync: default and new-york
-- **Import paths** in components use `@/registry/{style}/` which becomes `@/components/` after CLI install
-- **MDX components** are defined in `mdx-components.tsx`, not auto-imported
-- **Blocks are different** from components - they're full-page sections, not installable via CLI
-- **GitHub Pages deployment** requires building pkg/ui package first (workflow handles this)
-
-## LLM API Route (Added 2025-11-05)
-
-The `/llm` API route serves MDX documentation optimized for LLM consumption by replacing `<ComponentPreview>` tags with actual component source code.
-
-### Files Created
-
-**`/lib/llm.ts`**:
-- `processMdxForLLMs(content, style)` - Transforms MDX for LLMs
-- Finds `<ComponentPreview name="..." />` tags in MDX
-- Replaces with actual component source code in markdown code blocks
-- Rewrites import paths from `@/registry/${style}/` to `@/components/`
-- Removes `export default` in favor of named exports
-
-**`/app/(app)/llm/[[...slug]]/route.ts`**:
-- API route handler using Next.js catch-all routing
-- `GET` handler that processes MDX files via `processMdxForLLMs()`
-- Returns Content-Type: `text/markdown; charset=utf-8`
-- Supports static generation via `generateStaticParams()`
-- Uses `revalidate = false` for static export
-
-### Key Adaptations from shadcn/ui
-
-1. **Dynamic Style Support**: Changed from hardcoded `@/registry/new-york-v4/` to dynamic `@/registry/${style}/`
-2. **Multi-Style System**: Works with both "default" and "new-york" themes
-3. **Active Style Detection**: Uses `getActiveStyle()` to determine current theme
-
-### Usage
-
-Access documentation via:
-```bash
-# Get LLM-optimized docs for a component
-curl http://localhost:3003/llm/docs/components/button
-
-# Returns MDX with inline source code instead of component previews
-```
-
-## Deviation Report: shadcn/ui v4 vs Hanzo UI
-
-### Directory Structure Comparison
-
-**Copied from shadcn/ui v4**:
-- ✅ `/blocks` - Block showcase page with filtering and search
-- ✅ `/charts` - Chart component demonstrations  
-- ✅ `/colors` - Tailwind color palette reference
-- ✅ `/docs` - Component documentation
-- ✅ `/examples` - Component usage examples
-- ✅ `/llm` - LLM-optimized API endpoint
-- ✅ `/themes` - Theme customization page
-
-**Hanzo-Specific Features** (not in shadcn):
-- 🆕 `/ai` - AI assistant integration page
-- 🆕 `/builder` - Visual page builder with drag-drop
-- 🆕 `/components` - Component category pages
-- 🆕 `/compose` - Composition editor
-- 🆕 `/health` - System health check
-- 🆕 `/mcp` - Model Context Protocol integration
-- 🆕 `/sink` - Kitchen sink / testing page
-- 🆕 `/theme-generator` - Interactive theme generator
-
-### Key Implementation Differences
-
-#### 1. Path Handling
-- **shadcn**: Hardcoded `@/registry/new-york-v4/` paths
-- **Hanzo**: Dynamic `@/registry/${style}/` supporting multiple themes
-
-#### 2. Style System
-- **shadcn**: Primary style is "new-york-v4"
-- **Hanzo**: Primary style is "default", with "new-york" as alternative
-- **Impact**: All copied files had paths adapted: `new-york-v4` → `default`
-
-#### 3. Branding
-- **shadcn**: GitHub logo, shadcn branding
-- **Hanzo**: Hanzo logo (OpenInHButton), Hanzo branding
-- **Files Modified**: 
-  - `components/open-in-hanzo-button.tsx` → `components/open-in-h-button.tsx`
-  - Hanzo logo (H icon) replaces GitHub logo
-
-#### 4. Registry Structure
-- **shadcn**: `Index[name]` - flat structure
-- **Hanzo**: `Index[style][name]` - nested by style
-- **Impact**: Required updates to registry accessor functions
-
-#### 5. Component Count
-- **shadcn v4**: ~58 core components
-- **Hanzo**: 149 components (115 implemented, 34 stubs)
-- **Unique to Hanzo**: 3D components, AI components, animation components, specialized navigation
-
-### Files Requiring Ongoing Sync
-
-When shadcn/ui v4 updates these, Hanzo should review for updates:
-
-1. **Layout Files**:
-   - `app/(app)/blocks/layout.tsx`
-   - `app/(app)/colors/layout.tsx`
-   - `app/(app)/themes/layout.tsx`
-
-2. **Page Files**:
-   - `app/(app)/blocks/page.tsx`
-   - `app/(app)/colors/page.tsx`  
-   - `app/(app)/themes/page.tsx`
-   - `app/(app)/llm/[[...slug]]/route.ts`
-
-3. **Supporting Components**:
-   - `components/blocks-nav.tsx`
-   - `components/colors-nav.tsx`
-   - `components/theme-customizer.tsx`
-   - `lib/llm.ts`
-
-4. **Registry Functions**:
-   - `lib/registry.ts` - Any changes to registry access patterns
-   - `lib/blocks.ts` - Block metadata handling
-
-### Known Issues Requiring Fixes
-
-Per user feedback: "don't suppress errors just do shit right or cover up things"
-
-**1. getActiveStyle Export Error** ✅ FIXED (2025-11-05):
-- **Was**: Server logs showed "Export getActiveStyle doesn't exist in target module"
-- **Root Cause**: Turbopack had issues with `async function getActiveStyle()` in `force-static` pages. The async nature conflicted with Turbopack's static analysis in force-static mode.
-- **Fix**: Made `getActiveStyle()` synchronous by removing `async` keyword
-  - Updated `registry/styles.ts` line 14: removed `async` from function declaration
-  - Updated `app/(app)/blocks/page.tsx`: removed `async` from function and `await` from call
-  - Updated `app/(app)/llm/[[...slug]]/route.ts`: split Promise.all, called getActiveStyle() synchronously
-- **Result**: ✅ NO MORE EXPORT ERRORS - Pages load cleanly with HTTP 200, no server errors
-- **Note**: Function doesn't actually need to be async since it just returns styles[0]
-
-**2. Client Component Boundary Warnings** ⚠️ LOW PRIORITY:
-- **Symptom**: "Functions cannot be passed directly to Client Components unless you explicitly expose it by marking it with 'use server'"
-- **Locations**: Multiple components in blocks, themes, colors pages (7 warnings with digest `638247047`)
-- **Status**: WARNINGS ONLY - Not breaking, pages render correctly with HTTP 200
-- **Impact**: No user-facing issues, functionality fully intact
-- **Note**: These warnings also appear in shadcn/ui v4, suggesting they may be framework-level issues
-- **Action**: Can investigate if desired, but not critical since pages work perfectly
-
-**3. Tabs Hydration Issues** ✅ FIXED:
-- **Was**: Tabs component had hydration errors due to SSR/client mismatch
-- **Fix**: Updated `registry/default/ui/tabs.tsx` with proper refs and display names
-- **Status**: ✅ RESOLVED
-
-**4. macOS Dock Demo SSR Error** ✅ FIXED (2025-11-06):
-- **Was**: Build error "Event handlers cannot be passed to Client Component props" on `/view/new-york/macos-dock-demo`
-- **Root Cause**: `macos-dock-demo` component has onClick event handlers on DockItem components. During static prerendering with `force-static`, Next.js tries to serialize props but can't serialize functions.
-- **Fix**: Added component to skip list in `generateStaticParams()` in `app/(view)/view/[name]/page.tsx`
-  - Components with event handlers that can't be serialized are excluded from static generation
-  - They can still be accessed dynamically at runtime
-- **Result**: ✅ Build completes successfully, no SSR errors
-- **Note**: Component works perfectly in dev mode and at runtime, just skips static prerendering
-
-### Testing Coverage
-
-**Pages Tested**:
-- ✅ `/blocks` - All 5 featured blocks display correctly
-- ✅ `/colors` - Full Tailwind palette with copy functionality
-- ✅ `/themes` - Theme customizer with live preview
-- ✅ `/llm` - API endpoint compiles and serves MDX
-
-**Components Tested**:
-- ✅ `<BlockDisplay>` - Renders blocks correctly
-- ✅ `<BlocksNav>` - Navigation with search/filter
-- ✅ `<ColorsNav>` - Color palette navigation
-- ✅ `<OpenInHButton>` - Hanzo-branded button with logo
-- ✅ `<Tabs>` - No hydration errors
-
-### Maintenance Strategy
-
-**When to Sync with shadcn/ui v4**:
-1. Major version updates (v4.x → v4.y)
-2. New features in /blocks, /themes, /colors pages
-3. Security patches or bug fixes
-4. New component additions to showcase pages
-
-**How to Sync**:
-1. Compare shadcn v4 file with Hanzo version
-2. Identify changes in logic (not just branding)
-3. Apply logic changes while preserving:
-   - Hanzo branding (OpenInHButton, logos)
-   - Path adaptations (new-york-v4 → default)
-   - Registry structure differences (Index[style][name])
-4. Test thoroughly before deploying
-5. Document changes in CLAUDE.md
-
-### Future Work
-
-**Improvements Needed**:
-1. Fix getActiveStyle export error properly (not suppress)
-2. Resolve Client Component boundary warnings  
-3. Add comprehensive test suite for copied pages
-4. Set up automated diff checking against shadcn v4
-5. Document all customizations in component headers

app/__registry__/.autogenerated

@@ -0,0 +1 @@
+// The content of this directory is autogenerated by the registry server.

app/__registry__/README.md

@@ -0,0 +1 @@
+> Files inside this directory is autogenerated by `./scripts/build-registry.ts`. **Do not edit them manually.** - hanzo

app/__registry__/default/block/authentication-04.tsx

@@ -63,11 +63,10 @@ export default function Dashboard() {
       <div className="hidden bg-muted lg:block">
         <Image
           src="/placeholder.svg"
-          alt="Authentication page cover image"
+          alt="Image"
           width="1920"
           height="1080"
           className="h-full w-full object-cover dark:brightness-[0.2] dark:grayscale"
-          loading="lazy"
         />
       </div>
     </div>

app/__registry__/default/block/dashboard-05.tsx

@@ -267,7 +267,6 @@ export default function Dashboard() {
                   height={36}
                   alt="Avatar"
                   className="overflow-hidden rounded-full"
-                  loading="lazy"
                 />
               </Button>
             </DropdownMenuTrigger>

app/__registry__/default/block/dashboard-06.tsx

@@ -256,7 +256,6 @@ export default function Dashboard() {
                   height={36}
                   alt="Avatar"
                   className="overflow-hidden rounded-full"
-                  loading="lazy"
                 />
               </Button>
             </DropdownMenuTrigger>
@@ -357,7 +356,6 @@ export default function Dashboard() {
                             height="64"
                             src="/placeholder.svg"
                             width="64"
-                            loading="lazy"
                           />
                         </TableCell>
                         <TableCell className="font-medium">
@@ -403,7 +401,6 @@ export default function Dashboard() {
                             height="64"
                             src="/placeholder.svg"
                             width="64"
-                            loading="lazy"
                           />
                         </TableCell>
                         <TableCell className="font-medium">
@@ -449,7 +446,6 @@ export default function Dashboard() {
                             height="64"
                             src="/placeholder.svg"
                             width="64"
-                            loading="lazy"
                           />
                         </TableCell>
                         <TableCell className="font-medium">
@@ -495,7 +491,6 @@ export default function Dashboard() {
                             height="64"
                             src="/placeholder.svg"
                             width="64"
-                            loading="lazy"
                           />
                         </TableCell>
                         <TableCell className="font-medium">
@@ -541,7 +536,6 @@ export default function Dashboard() {
                             height="64"
                             src="/placeholder.svg"
                             width="64"
-                            loading="lazy"
                           />
                         </TableCell>
                         <TableCell className="font-medium">
@@ -587,7 +581,6 @@ export default function Dashboard() {
                             height="64"
                             src="/placeholder.svg"
                             width="64"
-                            loading="lazy"
                           />
                         </TableCell>
                         <TableCell className="font-medium">

app/__registry__/default/block/dashboard-07.tsx

@@ -259,7 +259,6 @@ export default function Dashboard() {
                   src="/placeholder-user.jpg"
                   width={36}
                   height={36}
-                  loading="lazy"
                   alt="Avatar"
                   className="overflow-hidden rounded-full"
                 />
@@ -552,27 +551,24 @@ export default function Dashboard() {
                         height="300"
                         src="/placeholder.svg"
                         width="300"
-                        loading="lazy"
                       />
                       <div className="grid grid-cols-3 gap-2">
                         <button>
                           <Image
-                            alt="Product thumbnail image"
+                            alt="Product image"
                             className="aspect-square w-full rounded-md object-cover"
                             height="84"
                             src="/placeholder.svg"
                             width="84"
-                            loading="lazy"
                           />
                         </button>
                         <button>
                           <Image
-                            alt="Product thumbnail image"
+                            alt="Product image"
                             className="aspect-square w-full rounded-md object-cover"
                             height="84"
                             src="/placeholder.svg"
                             width="84"
-                            loading="lazy"
                           />
                         </button>
                         <button className="flex aspect-square w-full items-center justify-center rounded-md border border-dashed">

app/__registry__/default/block/invoice-manager-01.tsx

@@ -0,0 +1,18 @@
+"use client"
+
+import { InvoiceManager } from "@hanzo/ui/billing"
+
+export const description =
+  "A complete invoice management interface with list/card views, filtering, sorting, pagination, and PDF download functionality. Features responsive design with mobile-optimized layouts."
+
+export const iframeHeight = "900px"
+
+export const containerClassName = "w-full"
+
+export default function InvoiceManagerDemo() {
+  return (
+    <div className="container mx-auto py-8">
+      <InvoiceManager defaultView="table" pageSize={10} />
+    </div>
+  )
+}

app/__registry__/default/block/login-01.tsx

@@ -1,16 +1,16 @@
 "use client"
 
 import { cn } from "@/lib/utils"
-import { Button } from "@/registry/default/ui/button"
+import { Button } from "@/registry/new-york/ui/button"
 import {
   Card,
   CardContent,
   CardDescription,
   CardHeader,
   CardTitle,
-} from "@/registry/default/ui/card"
-import { Input } from "@/registry/default/ui/input"
-import { Label } from "@/registry/default/ui/label"
+} from "@/registry/new-york/ui/card"
+import { Input } from "@/registry/new-york/ui/input"
+import { Label } from "@/registry/new-york/ui/label"
 
 export default function Page() {
   return (

app/__registry__/default/block/login-02.tsx

@@ -1,16 +1,16 @@
 "use client"
 
 import { cn } from "@/lib/utils"
-import { Button } from "@/registry/default/ui/button"
+import { Button } from "@/registry/new-york/ui/button"
 import {
   Card,
   CardContent,
   CardDescription,
   CardHeader,
   CardTitle,
-} from "@/registry/default/ui/card"
-import { Input } from "@/registry/default/ui/input"
-import { Label } from "@/registry/default/ui/label"
+} from "@/registry/new-york/ui/card"
+import { Input } from "@/registry/new-york/ui/input"
+import { Label } from "@/registry/new-york/ui/label"
 
 export default function Page() {
   return (

app/__registry__/default/block/login-03.tsx

@@ -1,16 +1,16 @@
 "use client"
 
 import { cn } from "@/lib/utils"
-import { Button } from "@/registry/default/ui/button"
+import { Button } from "@/registry/new-york/ui/button"
 import {
   Card,
   CardContent,
   CardDescription,
   CardHeader,
   CardTitle,
-} from "@/registry/default/ui/card"
-import { Input } from "@/registry/default/ui/input"
-import { Label } from "@/registry/default/ui/label"
+} from "@/registry/new-york/ui/card"
+import { Input } from "@/registry/new-york/ui/input"
+import { Label } from "@/registry/new-york/ui/label"
 
 export default function Page() {
   return (

app/__registry__/default/block/login-04.tsx

@@ -1,16 +1,16 @@
 "use client"
 
 import { cn } from "@/lib/utils"
-import { Button } from "@/registry/default/ui/button"
+import { Button } from "@/registry/new-york/ui/button"
 import {
   Card,
   CardContent,
   CardDescription,
   CardHeader,
   CardTitle,
-} from "@/registry/default/ui/card"
-import { Input } from "@/registry/default/ui/input"
-import { Label } from "@/registry/default/ui/label"
+} from "@/registry/new-york/ui/card"
+import { Input } from "@/registry/new-york/ui/input"
+import { Label } from "@/registry/new-york/ui/label"
 
 export default function Page() {
   return (

app/__registry__/default/block/login-05.tsx

@@ -1,16 +1,16 @@
 "use client"
 
 import { cn } from "@/lib/utils"
-import { Button } from "@/registry/default/ui/button"
+import { Button } from "@/registry/new-york/ui/button"
 import {
   Card,
   CardContent,
   CardDescription,
   CardHeader,
   CardTitle,
-} from "@/registry/default/ui/card"
-import { Input } from "@/registry/default/ui/input"
-import { Label } from "@/registry/default/ui/label"
+} from "@/registry/new-york/ui/card"
+import { Input } from "@/registry/new-york/ui/input"
+import { Label } from "@/registry/new-york/ui/label"
 
 export default function Page() {
   return (

app/__registry__/default/block/payment-settings-01.tsx

@@ -0,0 +1,83 @@
+"use client"
+
+import { PaymentMethodManager, type PaymentMethod } from "@hanzo/ui/billing"
+
+export const description =
+  "Payment method management interface for adding, removing, and setting default payment methods."
+
+export const iframeHeight = "800px"
+
+export const containerClassName = "w-full"
+
+// Demo payment methods for showcase
+const demoPaymentMethods: PaymentMethod[] = [
+  {
+    id: "pm_1",
+    type: "card",
+    is_default: true,
+    created_at: "2024-01-15T10:30:00Z",
+    card: {
+      brand: "visa",
+      last4: "4242",
+      exp_month: 12,
+      exp_year: 2025,
+      funding: "credit",
+    },
+    billing_details: {
+      name: "John Doe",
+      address: {
+        line1: "123 Main St",
+        city: "San Francisco",
+        state: "CA",
+        postal_code: "94102",
+        country: "US",
+      },
+    },
+  },
+  {
+    id: "pm_2",
+    type: "card",
+    is_default: false,
+    created_at: "2024-02-20T14:15:00Z",
+    card: {
+      brand: "mastercard",
+      last4: "5555",
+      exp_month: 8,
+      exp_year: 2026,
+      funding: "debit",
+    },
+    billing_details: {
+      name: "John Doe",
+    },
+  },
+  {
+    id: "pm_3",
+    type: "paypal",
+    is_default: false,
+    created_at: "2024-03-10T09:00:00Z",
+    paypal: {
+      email: "john.doe@example.com",
+    },
+  },
+]
+
+export default function PaymentSettings01() {
+  return (
+    <div className="mx-auto max-w-4xl p-6">
+      <PaymentMethodManager
+        // Use demo mode (no API endpoint)
+        initialMethods={demoPaymentMethods}
+        // Callbacks for demo
+        onMethodAdded={(method) => {
+          console.log("Payment method added:", method)
+        }}
+        onMethodRemoved={(id) => {
+          console.log("Payment method removed:", id)
+        }}
+        onDefaultChanged={(id) => {
+          console.log("Default payment method changed to:", id)
+        }}
+      />
+    </div>
+  )
+}

app/__registry__/default/block/signup-02.tsx

@@ -13,10 +13,7 @@ import {
 } from "@/registry/default/ui/field"
 import { Input } from "@/registry/default/ui/input"
 
-function SignupForm({
-  className,
-  ...props
-}: React.ComponentPropsWithoutRef<"form">) {
+function SignupForm({ className, ...props }: React.ComponentProps<"form">) {
   const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
     e.preventDefault()
     const formData = new FormData(e.currentTarget)

app/__registry__/default/block/signup-03.tsx

@@ -38,7 +38,7 @@ export default function SignupPage() {
 export function SignupForm({
   className,
   ...props
-}: React.ComponentPropsWithoutRef<"div">) {
+}: React.ComponentProps<"div">) {
   const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
     e.preventDefault()
     const formData = new FormData(e.currentTarget)

app/__registry__/default/block/signup-04.tsx

@@ -25,7 +25,7 @@ export default function SignupPage() {
 export function SignupForm({
   className,
   ...props
-}: React.ComponentPropsWithoutRef<"div">) {
+}: React.ComponentProps<"div">) {
   const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
     e.preventDefault()
     const formData = new FormData(e.currentTarget)

app/__registry__/default/block/signup-05.tsx

@@ -26,7 +26,7 @@ export default function SignupPage() {
 export function SignupForm({
   className,
   ...props
-}: React.ComponentPropsWithoutRef<"div">) {
+}: React.ComponentProps<"div">) {
   const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
     e.preventDefault()
     const formData = new FormData(e.currentTarget)

app/__registry__/default/block/subscription-portal-01.tsx

@@ -0,0 +1,212 @@
+"use client"
+
+import {
+  SubscriptionPortal,
+  type RetentionOffer,
+  type Subscription,
+  type SubscriptionHistory,
+  type SubscriptionPlan,
+} from "@hanzo/ui/billing"
+
+export const description =
+  "A comprehensive subscription management portal with plan upgrades, usage tracking, and subscription history."
+
+export const iframeHeight = "1000px"
+
+export const containerClassName = "w-full"
+
+// Demo subscription plans
+const demoPlans: SubscriptionPlan[] = [
+  {
+    id: "free",
+    name: "Free",
+    description: "Perfect for getting started",
+    price: 0,
+    billingPeriod: "monthly",
+    features: [
+      "Up to 3 projects",
+      "Basic analytics",
+      "Community support",
+      "5 team members",
+    ],
+    limits: {
+      projects: 3,
+      storage: 1, // GB
+      apiCalls: 1000,
+    },
+  },
+  {
+    id: "pro",
+    name: "Pro",
+    description: "For professional developers",
+    price: 29,
+    billingPeriod: "monthly",
+    features: [
+      "Unlimited projects",
+      "Advanced analytics",
+      "Priority support",
+      "Unlimited team members",
+      "Custom integrations",
+      "Advanced security",
+    ],
+    limits: {
+      projects: "unlimited",
+      storage: 100, // GB
+      apiCalls: "unlimited",
+    },
+    highlighted: true,
+    badge: "Popular",
+  },
+  {
+    id: "enterprise",
+    name: "Enterprise",
+    description: "For large teams and organizations",
+    price: 99,
+    billingPeriod: "monthly",
+    features: [
+      "Everything in Pro",
+      "Dedicated support",
+      "SLA guarantee",
+      "Custom integrations",
+      "On-premise deployment",
+      "Training & onboarding",
+      "Advanced compliance",
+    ],
+    limits: {
+      projects: "unlimited",
+      storage: "unlimited",
+      apiCalls: "unlimited",
+    },
+  },
+]
+
+// Demo current subscription
+const demoSubscription: Subscription = {
+  id: "sub_1",
+  customerId: "cus_1",
+  planId: "pro",
+  plan: demoPlans[1], // Pro plan
+  status: "active",
+  currentPeriodStart: new Date("2024-10-01"),
+  currentPeriodEnd: new Date("2024-11-01"),
+  cancelAtPeriodEnd: false,
+  usage: [
+    {
+      name: "Projects",
+      current: 12,
+      limit: "unlimited",
+    },
+    {
+      name: "Storage",
+      current: 45,
+      limit: 100,
+      unit: "GB",
+    },
+    {
+      name: "API Calls",
+      current: 45000,
+      limit: "unlimited",
+      unit: "calls",
+    },
+  ],
+  upcomingInvoice: {
+    amount: 29,
+    date: new Date("2024-11-01"),
+  },
+}
+
+// Demo retention offers
+const demoRetentionOffers: RetentionOffer[] = [
+  {
+    id: "offer_1",
+    title: "3 Months at 50% Off",
+    description: "Stay with us and get 50% off for the next 3 months",
+    discount: 50,
+    features: [
+      "Keep all Pro features",
+      "No contract required",
+      "Cancel anytime",
+    ],
+  },
+  {
+    id: "offer_2",
+    title: "Free Extra Storage",
+    description: "Get an additional 50GB storage for free for 6 months",
+    features: [
+      "150GB total storage",
+      "All Pro features included",
+      "Priority support",
+    ],
+  },
+]
+
+// Demo subscription history
+const demoHistory: SubscriptionHistory[] = [
+  {
+    id: "hist_1",
+    subscriptionId: "sub_1",
+    event: "upgraded",
+    fromPlan: "Free",
+    toPlan: "Pro",
+    timestamp: new Date("2024-10-01"),
+    amount: 29,
+  },
+  {
+    id: "hist_2",
+    subscriptionId: "sub_1",
+    event: "created",
+    toPlan: "Free",
+    timestamp: new Date("2024-09-15"),
+    amount: 0,
+  },
+]
+
+export default function SubscriptionPortal01() {
+  // Demo handlers
+  const handleUpgrade = async (planId: string) => {
+    console.log("Upgrading to plan:", planId)
+    // Simulate API call
+    await new Promise((resolve) => setTimeout(resolve, 1000))
+  }
+
+  const handleDowngrade = async (planId: string) => {
+    console.log("Downgrading to plan:", planId)
+    await new Promise((resolve) => setTimeout(resolve, 1000))
+  }
+
+  const handleCancel = async (reason: string, feedback?: string) => {
+    console.log("Canceling subscription:", { reason, feedback })
+    await new Promise((resolve) => setTimeout(resolve, 1000))
+  }
+
+  const handleAcceptOffer = async (offerId: string) => {
+    console.log("Accepting retention offer:", offerId)
+    await new Promise((resolve) => setTimeout(resolve, 1000))
+  }
+
+  return (
+    <div className="mx-auto max-w-7xl p-6">
+      <div className="mb-8">
+        <h1 className="text-3xl font-bold tracking-tight">
+          Subscription Management
+        </h1>
+        <p className="text-muted-foreground mt-2">
+          Manage your subscription, view usage, and explore available plans
+        </p>
+      </div>
+
+      <SubscriptionPortal
+        subscription={demoSubscription}
+        availablePlans={demoPlans}
+        retentionOffers={demoRetentionOffers}
+        subscriptionHistory={demoHistory}
+        onUpgrade={handleUpgrade}
+        onDowngrade={handleDowngrade}
+        onCancel={handleCancel}
+        onAcceptOffer={handleAcceptOffer}
+        showHistory={true}
+        defaultView="overview"
+      />
+    </div>
+  )
+}

app/__registry__/default/example/accordion-demo.tsx

@@ -0,0 +1,33 @@
+import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+} from "@/registry/default/ui/accordion"
+
+export default function AccordionDemo() {
+  return (
+    <Accordion type="single" collapsible className="w-full">
+      <AccordionItem value="item-1">
+        <AccordionTrigger>Is it accessible?</AccordionTrigger>
+        <AccordionContent>
+          Yes. It adheres to the WAI-ARIA design pattern.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-2">
+        <AccordionTrigger>Is it styled?</AccordionTrigger>
+        <AccordionContent>
+          Yes. It comes with default styles that matches the other
+          components&apos; aesthetic.
+        </AccordionContent>
+      </AccordionItem>
+      <AccordionItem value="item-3">
+        <AccordionTrigger>Is it animated?</AccordionTrigger>
+        <AccordionContent>
+          Yes. It&apos;s animated by default, but you can disable it if you
+          prefer.
+        </AccordionContent>
+      </AccordionItem>
+    </Accordion>
+  )
+}

app/__registry__/default/example/alert-demo.tsx

@@ -0,0 +1,19 @@
+import { Terminal } from "lucide-react"
+
+import {
+  Alert,
+  AlertDescription,
+  AlertTitle,
+} from "@/registry/default/ui/alert"
+
+export default function AlertDemo() {
+  return (
+    <Alert>
+      <Terminal className="h-4 w-4" />
+      <AlertTitle>Heads up!</AlertTitle>
+      <AlertDescription>
+        You can add components to your app using the cli.
+      </AlertDescription>
+    </Alert>
+  )
+}

app/__registry__/default/example/alert-destructive.tsx

@@ -0,0 +1,19 @@
+import { AlertCircle } from "lucide-react"
+
+import {
+  Alert,
+  AlertDescription,
+  AlertTitle,
+} from "@/registry/default/ui/alert"
+
+export default function AlertDestructive() {
+  return (
+    <Alert variant="destructive">
+      <AlertCircle className="h-4 w-4" />
+      <AlertTitle>Error</AlertTitle>
+      <AlertDescription>
+        Your session has expired. Please log in again.
+      </AlertDescription>
+    </Alert>
+  )
+}

app/__registry__/default/example/alert-dialog-demo.tsx

@@ -0,0 +1,35 @@
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+  AlertDialogTrigger,
+} from "@/registry/default/ui/alert-dialog"
+import { Button } from "@/registry/default/ui/button"
+
+export default function AlertDialogDemo() {
+  return (
+    <AlertDialog>
+      <AlertDialogTrigger asChild>
+        <Button variant="outline">Show Dialog</Button>
+      </AlertDialogTrigger>
+      <AlertDialogContent>
+        <AlertDialogHeader>
+          <AlertDialogTitle>Are you absolutely sure?</AlertDialogTitle>
+          <AlertDialogDescription>
+            This action cannot be undone. This will permanently delete your
+            account and remove your data from our servers.
+          </AlertDialogDescription>
+        </AlertDialogHeader>
+        <AlertDialogFooter>
+          <AlertDialogCancel>Cancel</AlertDialogCancel>
+          <AlertDialogAction>Continue</AlertDialogAction>
+        </AlertDialogFooter>
+      </AlertDialogContent>
+    </AlertDialog>
+  )
+}

app/__registry__/default/example/aspect-ratio-demo.tsx

@@ -0,0 +1,16 @@
+import Image from "next/image"
+
+import { AspectRatio } from "@/registry/default/ui/aspect-ratio"
+
+export default function AspectRatioDemo() {
+  return (
+    <AspectRatio ratio={16 / 9} className="bg-muted">
+      <Image
+        src="https://images.unsplash.com/photo-1588345921523-c2dcdb7f1dcd?w=800&dpr=2&q=80"
+        alt="Photo by Drew Beamer"
+        fill
+        className="rounded-md object-cover"
+      />
+    </AspectRatio>
+  )
+}

app/__registry__/default/example/avatar-demo.tsx

@@ -0,0 +1,14 @@
+import {
+  Avatar,
+  AvatarFallback,
+  AvatarImage,
+} from "@/registry/default/ui/avatar"
+
+export default function AvatarDemo() {
+  return (
+    <Avatar>
+      <AvatarImage src="https://github.com/hanzoai.png" alt="@hanzoai" />
+      <AvatarFallback>CN</AvatarFallback>
+    </Avatar>
+  )
+}

app/__registry__/default/example/badge-demo.tsx

@@ -0,0 +1,5 @@
+import { Badge } from "@/registry/default/ui/badge"
+
+export default function BadgeDemo() {
+  return <Badge>Badge</Badge>
+}

app/__registry__/default/example/badge-destructive.tsx

@@ -0,0 +1,5 @@
+import { Badge } from "@/registry/default/ui/badge"
+
+export default function BadgeDestructive() {
+  return <Badge variant="destructive">Destructive</Badge>
+}

app/__registry__/default/example/badge-outline.tsx

@@ -0,0 +1,5 @@
+import { Badge } from "@/registry/default/ui/badge"
+
+export default function BadgeOutline() {
+  return <Badge variant="outline">Outline</Badge>
+}

app/__registry__/default/example/badge-secondary.tsx

@@ -0,0 +1,5 @@
+import { Badge } from "@/registry/default/ui/badge"
+
+export default function BadgeSecondary() {
+  return <Badge variant="secondary">Secondary</Badge>
+}

app/__registry__/default/example/breadcrumb-demo.tsx

@@ -0,0 +1,49 @@
+import {
+  Breadcrumb,
+  BreadcrumbEllipsis,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbList,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+} from "@/registry/default/ui/breadcrumb"
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "@/registry/default/ui/dropdown-menu"
+
+export default function BreadcrumbDemo() {
+  return (
+    <Breadcrumb>
+      <BreadcrumbList>
+        <BreadcrumbItem>
+          <BreadcrumbLink href="/">Home</BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        <BreadcrumbItem>
+          <DropdownMenu>
+            <DropdownMenuTrigger className="flex items-center gap-1">
+              <BreadcrumbEllipsis className="h-4 w-4" />
+              <span className="sr-only">Toggle menu</span>
+            </DropdownMenuTrigger>
+            <DropdownMenuContent align="start">
+              <DropdownMenuItem>Documentation</DropdownMenuItem>
+              <DropdownMenuItem>Themes</DropdownMenuItem>
+              <DropdownMenuItem>GitHub</DropdownMenuItem>
+            </DropdownMenuContent>
+          </DropdownMenu>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        <BreadcrumbItem>
+          <BreadcrumbLink href="/docs/components">Components</BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        <BreadcrumbItem>
+          <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
+        </BreadcrumbItem>
+      </BreadcrumbList>
+    </Breadcrumb>
+  )
+}

app/__registry__/default/example/breadcrumb-dropdown.tsx

@@ -0,0 +1,50 @@
+import { ChevronDown, Slash } from "lucide-react"
+
+import {
+  Breadcrumb,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbList,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+} from "@/registry/default/ui/breadcrumb"
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "@/registry/default/ui/dropdown-menu"
+
+export default function BreadcrumbWithDropdown() {
+  return (
+    <Breadcrumb>
+      <BreadcrumbList>
+        <BreadcrumbItem>
+          <BreadcrumbLink href="/">Home</BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator>
+          <Slash />
+        </BreadcrumbSeparator>
+        <BreadcrumbItem>
+          <DropdownMenu>
+            <DropdownMenuTrigger className="flex items-center gap-1">
+              Components
+              <ChevronDown className="h-4 w-4" />
+            </DropdownMenuTrigger>
+            <DropdownMenuContent align="start">
+              <DropdownMenuItem>Documentation</DropdownMenuItem>
+              <DropdownMenuItem>Themes</DropdownMenuItem>
+              <DropdownMenuItem>GitHub</DropdownMenuItem>
+            </DropdownMenuContent>
+          </DropdownMenu>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator>
+          <Slash />
+        </BreadcrumbSeparator>
+        <BreadcrumbItem>
+          <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
+        </BreadcrumbItem>
+      </BreadcrumbList>
+    </Breadcrumb>
+  )
+}

app/__registry__/default/example/breadcrumb-ellipsis.tsx

@@ -0,0 +1,39 @@
+import Link from "next/link"
+
+import {
+  Breadcrumb,
+  BreadcrumbEllipsis,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbList,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+} from "@/registry/default/ui/breadcrumb"
+
+export default function BreadcrumbCollapsed() {
+  return (
+    <Breadcrumb>
+      <BreadcrumbList>
+        <BreadcrumbItem>
+          <BreadcrumbLink asChild>
+            <Link href="/">Home</Link>
+          </BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        <BreadcrumbItem>
+          <BreadcrumbEllipsis />
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        <BreadcrumbItem>
+          <BreadcrumbLink asChild>
+            <Link href="/docs/components">Components</Link>
+          </BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        <BreadcrumbItem>
+          <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
+        </BreadcrumbItem>
+      </BreadcrumbList>
+    </Breadcrumb>
+  )
+}

app/__registry__/default/example/breadcrumb-link.tsx

@@ -0,0 +1,34 @@
+import Link from "next/link"
+
+import {
+  Breadcrumb,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbList,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+} from "@/registry/default/ui/breadcrumb"
+
+export default function BreadcrumbWithCustomSeparator() {
+  return (
+    <Breadcrumb>
+      <BreadcrumbList>
+        <BreadcrumbItem>
+          <BreadcrumbLink>
+            <Link href="/">Home</Link>
+          </BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        <BreadcrumbItem>
+          <BreadcrumbLink>
+            <Link href="/components">Components</Link>
+          </BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        <BreadcrumbItem>
+          <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
+        </BreadcrumbItem>
+      </BreadcrumbList>
+    </Breadcrumb>
+  )
+}

app/__registry__/default/example/breadcrumb-responsive.tsx

@@ -0,0 +1,133 @@
+"use client"
+
+import * as React from "react"
+import Link from "next/link"
+
+import { useMediaQuery } from "@/hooks/use-media-query"
+import {
+  Breadcrumb,
+  BreadcrumbEllipsis,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbList,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+} from "@/registry/default/ui/breadcrumb"
+import { Button } from "@/registry/default/ui/button"
+import {
+  Drawer,
+  DrawerClose,
+  DrawerContent,
+  DrawerDescription,
+  DrawerFooter,
+  DrawerHeader,
+  DrawerTitle,
+  DrawerTrigger,
+} from "@/registry/default/ui/drawer"
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from "@/registry/default/ui/dropdown-menu"
+
+const items = [
+  { href: "#", label: "Home" },
+  { href: "#", label: "Documentation" },
+  { href: "#", label: "Building Your Application" },
+  { href: "#", label: "Data Fetching" },
+  { label: "Caching and Revalidating" },
+]
+
+const ITEMS_TO_DISPLAY = 3
+
+export default function BreadcrumbResponsive() {
+  const [open, setOpen] = React.useState(false)
+  const isDesktop = useMediaQuery("(min-width: 768px)")
+
+  return (
+    <Breadcrumb>
+      <BreadcrumbList>
+        <BreadcrumbItem>
+          <BreadcrumbLink href={items[0].href}>{items[0].label}</BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator />
+        {items.length > ITEMS_TO_DISPLAY ? (
+          <>
+            <BreadcrumbItem>
+              {isDesktop ? (
+                <DropdownMenu open={open} onOpenChange={setOpen}>
+                  <DropdownMenuTrigger
+                    className="flex items-center gap-1"
+                    aria-label="Toggle menu"
+                  >
+                    <BreadcrumbEllipsis className="h-4 w-4" />
+                  </DropdownMenuTrigger>
+                  <DropdownMenuContent align="start">
+                    {items.slice(1, -2).map((item, index) => (
+                      <DropdownMenuItem key={index}>
+                        <Link href={item.href ? item.href : "#"}>
+                          {item.label}
+                        </Link>
+                      </DropdownMenuItem>
+                    ))}
+                  </DropdownMenuContent>
+                </DropdownMenu>
+              ) : (
+                <Drawer open={open} onOpenChange={setOpen}>
+                  <DrawerTrigger aria-label="Toggle Menu">
+                    <BreadcrumbEllipsis className="h-4 w-4" />
+                  </DrawerTrigger>
+                  <DrawerContent>
+                    <DrawerHeader className="text-left">
+                      <DrawerTitle>Navigate to</DrawerTitle>
+                      <DrawerDescription>
+                        Select a page to navigate to.
+                      </DrawerDescription>
+                    </DrawerHeader>
+                    <div className="grid gap-1 px-4">
+                      {items.slice(1, -2).map((item, index) => (
+                        <Link
+                          key={index}
+                          href={item.href ? item.href : "#"}
+                          className="py-1 text-sm"
+                        >
+                          {item.label}
+                        </Link>
+                      ))}
+                    </div>
+                    <DrawerFooter className="pt-4">
+                      <DrawerClose asChild>
+                        <Button variant="outline">Close</Button>
+                      </DrawerClose>
+                    </DrawerFooter>
+                  </DrawerContent>
+                </Drawer>
+              )}
+            </BreadcrumbItem>
+            <BreadcrumbSeparator />
+          </>
+        ) : null}
+        {items.slice(-ITEMS_TO_DISPLAY + 1).map((item, index) => (
+          <BreadcrumbItem key={index}>
+            {item.href ? (
+              <>
+                <BreadcrumbLink
+                  asChild
+                  className="max-w-20 truncate md:max-w-none"
+                >
+                  <Link href={item.href}>{item.label}</Link>
+                </BreadcrumbLink>
+                <BreadcrumbSeparator />
+              </>
+            ) : (
+              <BreadcrumbPage className="max-w-20 truncate md:max-w-none">
+                {item.label}
+              </BreadcrumbPage>
+            )}
+          </BreadcrumbItem>
+        ))}
+      </BreadcrumbList>
+    </Breadcrumb>
+  )
+}

app/__registry__/default/example/breadcrumb-separator.tsx

@@ -0,0 +1,34 @@
+import { Slash } from "lucide-react"
+
+import {
+  Breadcrumb,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbList,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+} from "@/registry/default/ui/breadcrumb"
+
+export default function BreadcrumbWithCustomSeparator() {
+  return (
+    <Breadcrumb>
+      <BreadcrumbList>
+        <BreadcrumbItem>
+          <BreadcrumbLink href="/">Home</BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator>
+          <Slash />
+        </BreadcrumbSeparator>
+        <BreadcrumbItem>
+          <BreadcrumbLink href="/components">Components</BreadcrumbLink>
+        </BreadcrumbItem>
+        <BreadcrumbSeparator>
+          <Slash />
+        </BreadcrumbSeparator>
+        <BreadcrumbItem>
+          <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
+        </BreadcrumbItem>
+      </BreadcrumbList>
+    </Breadcrumb>
+  )
+}

app/__registry__/default/example/button-as-child.tsx

@@ -0,0 +1,11 @@
+import Link from "next/link"
+
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonAsChild() {
+  return (
+    <Button asChild>
+      <Link href="/login">Login</Link>
+    </Button>
+  )
+}

app/__registry__/default/example/button-demo.tsx

@@ -0,0 +1,5 @@
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonDemo() {
+  return <Button>Button</Button>
+}

app/__registry__/default/example/button-destructive.tsx

@@ -0,0 +1,5 @@
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonDestructive() {
+  return <Button variant="destructive">Destructive</Button>
+}

app/__registry__/default/example/button-ghost.tsx

@@ -0,0 +1,5 @@
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonGhost() {
+  return <Button variant="ghost">Ghost</Button>
+}

app/__registry__/default/example/button-icon.tsx

@@ -0,0 +1,11 @@
+import { ChevronRight } from "lucide-react"
+
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonIcon() {
+  return (
+    <Button variant="outline" size="icon">
+      <ChevronRight className="h-4 w-4" />
+    </Button>
+  )
+}

app/__registry__/default/example/button-link.tsx

@@ -0,0 +1,5 @@
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonLink() {
+  return <Button variant="link">Link</Button>
+}

app/__registry__/default/example/button-loading.tsx

@@ -0,0 +1,12 @@
+import { Loader2 } from "lucide-react"
+
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonLoading() {
+  return (
+    <Button disabled>
+      <Loader2 className="mr-2 h-4 w-4 animate-spin" />
+      Please wait
+    </Button>
+  )
+}

app/__registry__/default/example/button-outline.tsx

@@ -0,0 +1,5 @@
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonOutline() {
+  return <Button variant="outline">Outline</Button>
+}

app/__registry__/default/example/button-secondary.tsx

@@ -0,0 +1,5 @@
+import { Button } from "@/registry/default/ui/button"
+
+export default function ButtonSecondary() {
+  return <Button variant="secondary">Secondary</Button>
+}