chore: Replace demo app with Docusaurus docs site

.claude/README.md

@@ -58,7 +58,7 @@ react-mosaic/
 │       ├── types.ts                  # Type definitions
 │       ├── contextTypes.ts           # Context types
 │       └── util/                     # Utility functions
-├── apps/demo-app/                    # Demo application
+├── apps/website/                     # Docusaurus docs + demo
 ├── claude.md                         # LLM integration guide
 ├── CONTRIBUTING_AI.md                # AI contribution guidelines
 ├── QUICKREF.md                       # Quick reference
@@ -189,6 +189,6 @@ For issues or questions:
 
 ## Version
 
-This integration is designed for React Mosaic v0.20.0.
+This integration is designed for React Mosaic v7.
 
-Last updated: 2025-12-04
+Last updated: 2026-04-15

.claudeignore

@@ -62,9 +62,9 @@ pnpm-lock.yaml
 *.js.map
 *.css.map
 
-# Demo app specific
-apps/demo-app/dist/
-apps/demo-app/.vite/
+# Website build output
+apps/website/build/
+apps/website/.docusaurus/
 
 # Git files
 .git/

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,3 +1,7 @@
+<!-- PR title must follow Conventional Commits: type: Description -->
+<!-- Allowed types: feat | fix | docs | style | refactor | perf | test | build | ci | chore | revert -->
+<!-- Example: feat: Add tab drag-and-drop support -->
+
 #### Fixes #0000
 
 #### Changes proposed in this pull request:

.github/workflows/deployment.yml

@@ -35,17 +35,22 @@ jobs:
       - name: Npm install
         run: npm ci
 
-      - name: Build
-        run: npm run build:app
+      # The website imports the library from its built ESM bundle (see the
+      # webpack alias in apps/website/docusaurus.config.ts), so the library
+      # must be built before Docusaurus.
+      - name: Build library
+        run: npm run build:lib
+
+      - name: Build website
+        run: npx nx run website:build
 
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v4
         with:
-          # Upload apps dist folder
-          path: './dist/apps/demo-app'
+          path: './apps/website/build'
 
       - name: Deploy to GitHub Pages
         id: deployment

.github/workflows/pr-validation.yml

@@ -34,6 +34,6 @@ jobs:
 
       - name: Build library
         run: npm run build:lib
-        
-      - name: Build app
-        run: npm run build:app
+
+      - name: Build website
+        run: npm run build:site

.github/workflows/preview-deploy.yml

@@ -0,0 +1,55 @@
+name: Preview Deploy
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  deploy-preview:
+    name: Deploy Preview
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      deployments: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: '.node-version'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build library
+        run: npm run build:lib
+
+      - name: Build website
+        run: npx nx run website:build
+        env:
+          SITE_BASE_URL: /
+
+      - name: Deploy to Cloudflare Pages
+        id: deploy
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy apps/website/build --project-name=react-mosaic --branch=pr-${{ github.event.pull_request.number }}
+
+      - name: Update PR comment
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          header: preview-deploy
+          message: |
+            ## Preview Deployment
+
+            | | |
+            |---|---|
+            | **Status** | Deployed |
+            | **URL** | ${{ steps.deploy.outputs.deployment-url }} |
+            | **Commit** | ${{ github.sha }} |

.gitignore

@@ -18,4 +18,13 @@ vite.config.*.timestamp*
 vitest.config.*.timestamp*
 .parcel-cache
 .tsup
-/dist
+/dist
+
+# Staged at Docusaurus config load — see apps/website/docusaurus.config.ts.
+# Blueprint CSS is copied here so it can be served as plain static files and
+# attached via the `stylesheets` config, instead of being bundled into the
+# site-wide stylesheet (which would leak Blueprint's unscoped body rules).
+apps/website/static/css/
+.claude/settings.local.json
+
+.claude/worktrees

.npmignore

@@ -2,7 +2,6 @@
 .editorconfig
 .gitignore
 .npmignore
-.circleci/
 tsconfig*.json
 demo/
 docs/

.prettierignore

@@ -3,7 +3,6 @@
 /coverage
 /.nx/cache
 /.nx/workspace-data
-/.circleci
 /.github
 /.idea
 /.parcel-cache

CONTRIBUTING_AI.md

@@ -101,7 +101,7 @@ When adding/modifying code:
 
 1. **Unit tests** - Add tests for new utilities in `*.spec.ts` files
 2. **Type tests** - Ensure TypeScript compilation passes
-3. **Visual tests** - Test in demo app for component changes
+3. **Visual tests** - Test in the website playground (`npm start`) for component changes
 4. **Edge cases** - Test with empty trees, single nodes, deeply nested trees
 
 ### Code Style Checklist
@@ -393,13 +393,13 @@ When unsure about implementation:
 - **User docs**: `README.md`
 - **Type reference**: `libs/react-mosaic-component/src/lib/types.ts`
 - **Utility reference**: `libs/react-mosaic-component/src/lib/util/`
-- **Demo examples**: `apps/demo-app/src/`
+- **Demo examples**: `apps/website/src/components/Playground/`
 
 ## Helpful Commands
 
 ```bash
 # Development
-npm start                  # Start demo app
+npm start                  # Start Docusaurus site (with live playground)
 npm test                   # Run tests
 npm run test:watch        # Watch mode
 npm run build:lib         # Build library

QUICKREF.md

@@ -21,9 +21,8 @@ A quick reference guide for developers and AI assistants working with React Mosa
 |------|---------|
 | Start dev server | `npm start` |
 | Run tests | `npm test` |
-| Watch tests | `npm run test:watch` |
 | Build library | `npm run build:lib` |
-| Build demo | `npm run build:app` |
+| Build docs site | `npm run build:site` |
 | Lint | `npm run lint` |
 | Format | `npm run format` |
 | Type check | `npm run build-lib:check` |
@@ -450,15 +449,15 @@ npm run test:watch
 ## Migration (Legacy to Modern)
 
 ```typescript
-// OLD (v0.19)
+// OLD (v6)
 {
   direction: 'row',
   first: 'left',
   second: 'right',
   splitPercentage: 40
 }
 
-// NEW (v1.0+)
+// NEW (v7+)
 {
   type: 'split',
   direction: 'row',