Add TypeDoc API docs config, Storybook deploy workflow, and Getting Started MDX (P4.2/P4.3)

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

.github/workflows/storybook-deploy.yml

@@ -0,0 +1,71 @@
+name: Deploy Storybook
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/**'
+      - '.storybook/**'
+      - 'pnpm-lock.yaml'
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build Storybook
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Turbo Cache
+        uses: actions/cache@v5
+        with:
+          path: node_modules/.cache/turbo
+          key: turbo-${{ runner.os }}-${{ github.sha }}
+          restore-keys: |
+            turbo-${{ runner.os }}-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build packages
+        run: pnpm build
+
+      - name: Build Storybook
+        run: pnpm storybook:build
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: storybook-static
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package.json

@@ -35,6 +35,7 @@
     "cli": "node packages/cli/dist/cli.js",
     "objectui": "node packages/cli/dist/cli.js",
     "create-plugin": "node packages/create-plugin/dist/index.js",
+    "docs:api": "typedoc",
     "storybook": "storybook dev -p 6006",
     "storybook:build": "storybook build",
     "storybook:test": "test-storybook --testTimeout=90000",
@@ -120,6 +121,8 @@
     "tslib": "^2.6.0",
     "tsx": "^4.21.0",
     "turbo": "^2.8.3",
+    "typedoc": "^0.28.16",
+    "typedoc-plugin-markdown": "^4.10.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.53.1",
     "vite-plugin-compression2": "^2.4.0",

packages/components/src/stories-json/GettingStarted.mdx

@@ -0,0 +1,89 @@
+import { Meta } from '@storybook/blocks';
+
+<Meta title="Getting Started" />
+
+# ObjectUI Component Library
+
+ObjectUI is a **server-driven UI engine** that renders enterprise interfaces from JSON metadata.
+Built on **React**, **Tailwind CSS**, and **Shadcn UI (Radix)**, it bridges the speed of
+low-code with the design quality of hand-crafted components.
+
+## Installation
+
+```bash
+# Core packages
+pnpm add @object-ui/types @object-ui/core @object-ui/react
+
+# UI layer
+pnpm add @object-ui/components @object-ui/fields @object-ui/layout
+```
+
+Peer dependencies — make sure these are in your project:
+
+```bash
+pnpm add react react-dom tailwindcss
+```
+
+## Quick Usage
+
+```tsx
+import { ObjectRenderer } from '@object-ui/react';
+
+const schema = {
+  type: 'Card',
+  props: { title: 'Hello' },
+  children: [
+    {
+      type: 'Text',
+      props: { content: 'Rendered from JSON!' },
+    },
+  ],
+};
+
+export default function App() {
+  return <ObjectRenderer schema={schema} />;
+}
+```
+
+The `ObjectRenderer` resolves each node in the schema tree against the **Component Registry**,
+producing a fully interactive React tree.
+
+## Accessibility
+
+Every component in ObjectUI follows the **WAI-ARIA** authoring practices provided by
+[Radix UI](https://www.radix-ui.com/). This means:
+
+- Correct ARIA roles and attributes out of the box
+- Full keyboard navigation support
+- Focus management for overlays, dialogs, and menus
+- Screen-reader-friendly labels and live regions
+
+Run the Storybook accessibility addon (included) to audit any story for violations.
+
+## Theme Configuration
+
+ObjectUI uses Tailwind CSS for styling. Customise the design tokens through your
+`tailwind.config` and CSS variables:
+
+```css
+@layer base {
+  :root {
+    --background: 0 0% 100%;
+    --foreground: 222 84% 5%;
+    --primary: 222 47% 11%;
+    --primary-foreground: 210 40% 98%;
+    /* ...other tokens */
+  }
+}
+```
+
+All Shadcn-based components pick up these tokens automatically — no prop drilling required.
+
+## Explore
+
+Use the sidebar to browse every component. Each story shows:
+
+- **Live preview** — interact directly in the canvas
+- **Controls** — tweak props in real time
+- **Docs** — auto-generated API tables (when tagged with `autodocs`)
+- **Accessibility** — axe audit panel