chore: Replace demo app with Docusaurus docs site (#243)

* chore: remove CircleCI config; CI lives in GitHub Action

* chore: simplify demo app

* chore: add docs website

* chore: add cloudflare preview workflow

* chore: update PR template

* chore: remove debug file

* chore: update gitignore

* chore: update preview url

* chore: update dev & prod dependencies

* chore: update vitest

Author: Lonli-Lokli

.circleci/config.yml

@@ -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

.claude/README.md

@@ -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/

.claude/settings.local.json

@@ -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:

.claudeignore

@@ -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/PULL_REQUEST_TEMPLATE.md

@@ -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/deployment.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 }} |

.github/workflows/pr-validation.yml

@@ -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

.github/workflows/preview-deploy.yml

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