feat: add centralized Velt version management with CI/CD automation

- Add velt-versions.json for centralized version configuration
- Add scripts/update-velt-versions.js to propagate versions to all apps
- Add GitHub Actions workflow to auto-update versions on changes
- Update all package.json files to use latest Velt versions
- Add npm scripts: velt:update, velt:check, velt:dry-run

The workflow:
- Auto-triggers when velt-versions.json is modified on main
- Checks version sync on PRs that modify package.json files
- Can be manually triggered via workflow_dispatch

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: yoen-velt

.github/workflows/update-velt-versions.yml

@@ -0,0 +1,111 @@
+name: Update Velt Versions
+
+on:
+  # Trigger when velt-versions.json is modified
+  push:
+    branches: [main, master]
+    paths:
+      - 'velt-versions.json'
+
+  # Allow manual trigger
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: 'Run mode'
+        required: true
+        default: 'update'
+        type: choice
+        options:
+          - update
+          - check
+          - dry-run
+
+  # Run on PRs to check if versions are in sync
+  pull_request:
+    paths:
+      - 'velt-versions.json'
+      - '**/package.json'
+
+jobs:
+  update-versions:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Determine run mode
+        id: mode
+        run: |
+          if [ "${{ github.event_name }}" == "pull_request" ]; then
+            echo "mode=check" >> $GITHUB_OUTPUT
+          elif [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
+            echo "mode=${{ inputs.mode }}" >> $GITHUB_OUTPUT
+          else
+            echo "mode=update" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Run version check (PR)
+        if: steps.mode.outputs.mode == 'check'
+        run: node scripts/update-velt-versions.js --check
+
+      - name: Run version update (dry-run)
+        if: steps.mode.outputs.mode == 'dry-run'
+        run: node scripts/update-velt-versions.js --dry-run
+
+      - name: Run version update
+        if: steps.mode.outputs.mode == 'update'
+        run: |
+          node scripts/update-velt-versions.js
+
+          # Check if there are changes
+          if git diff --quiet; then
+            echo "No version changes needed"
+            exit 0
+          fi
+
+          # Install dependencies to update lockfile
+          pnpm install --no-frozen-lockfile
+
+      - name: Commit and push changes
+        if: steps.mode.outputs.mode == 'update' && github.event_name == 'push'
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add -A
+          if ! git diff --staged --quiet; then
+            git commit -m "chore: update Velt package versions [skip ci]"
+            git push
+          fi
+
+      - name: Create Pull Request (manual trigger)
+        if: steps.mode.outputs.mode == 'update' && github.event_name == 'workflow_dispatch'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: 'chore: update Velt package versions'
+          title: 'chore: Update Velt package versions'
+          body: |
+            This PR updates Velt package versions across all sample apps.
+
+            Changes were generated by the `update-velt-versions` workflow based on `velt-versions.json`.
+
+            Please review the changes and merge if everything looks correct.
+          branch: chore/update-velt-versions
+          delete-branch: true

apps/react/comments/text-editors/lexical/lexical-comments-demo/package.json

@@ -14,7 +14,7 @@
     "@lexical/rich-text": "^0.19.0",
     "@lexical/selection": "^0.19.0",
     "@lexical/utils": "^0.19.0",
-    "@veltdev/client": "^4.5.8-beta.8",
+    "@veltdev/client": "^4.6.10",
     "@veltdev/lexical-velt-comments": "4.5.2-beta.2",
     "@veltdev/react": "^4.6.10",
     "clsx": "^2.1.1",
@@ -36,4 +36,4 @@
     "tailwindcss": "^3.4.18",
     "typescript": "^5.9.3"
   }
-}
+}

apps/react/comments/text-editors/slatejs/slatejs-comments-demo/package.json

@@ -9,9 +9,9 @@
     "lint": "next lint"
   },
   "dependencies": {
-    "@veltdev/client": "^4.5.8-beta.8",
+    "@veltdev/client": "^4.6.10",
     "@veltdev/react": "^4.6.10",
-    "@veltdev/slate-velt-comments": "^1.0.3",
+    "@veltdev/slate-velt-comments": "^1.0.4",
     "clsx": "^2.1.1",
     "next": "^15.5.7",
     "react": "^19.2.0",
@@ -33,4 +33,4 @@
     "tailwindcss": "^3.4.18",
     "typescript": "^5.9.3"
   }
-}
+}

apps/react/crdt/canvas/reactflow/reactflow-demo/package.json

@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@veltdev/react": "^4.6.10",
-    "@veltdev/reactflow-crdt": "4.5.8-beta.1",
+    "@veltdev/reactflow-crdt": "4.5.8",
     "@xyflow/react": "^12.9.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.454.0",
@@ -33,4 +33,4 @@
     "tailwindcss": "~3.4.18",
     "typescript": "^5.9.3"
   }
-}
+}

apps/react/crdt/text-editors/tiptap/tiptap-crdt-demo/package.json

@@ -17,8 +17,8 @@
     "@tiptap/starter-kit": "^3.14.0",
     "@tiptap/y-tiptap": "^3.0.0",
     "@veltdev/react": "^4.6.10",
-    "@veltdev/tiptap-crdt": "^4.5.9-beta.2",
-    "@veltdev/tiptap-crdt-react": "^4.5.9-beta.2",
+    "@veltdev/tiptap-crdt": "^4.5.9-beta.4",
+    "@veltdev/tiptap-crdt-react": "^4.5.9-beta.4",
     "@veltdev/tiptap-velt-comments": "4.5.8-beta.1",
     "clsx": "^2",
     "next": "^15.5.7",
@@ -40,4 +40,4 @@
     "tailwindcss": "^3.4.0",
     "typescript": "^5"
   }
-}
+}

package.json

@@ -9,7 +9,10 @@
     "lint": "turbo run lint --continue",
     "lint:fix": "turbo run lint:fix --continue || turbo run lint --continue -- --fix || true",
     "list": "node scripts/list-apps.js",
-    "new:demo": "tsx scripts/new-demo.ts"
+    "new:demo": "tsx scripts/new-demo.ts",
+    "velt:update": "node scripts/update-velt-versions.js",
+    "velt:check": "node scripts/update-velt-versions.js --check",
+    "velt:dry-run": "node scripts/update-velt-versions.js --dry-run"
   },
   "repository": {
     "type": "git",
@@ -39,10 +42,10 @@
   "overrides": {
     "@veltdev/crdt": "4.5.8",
     "@veltdev/crdt-react": "4.5.8",
-    "@veltdev/tiptap-crdt-react": "^4.5.9-beta.2",
+    "@veltdev/tiptap-crdt-react": "^4.5.9-beta.4",
     "@veltdev/blocknote-crdt-react": "4.5.0-beta.3",
     "@veltdev/codemirror-crdt-react": "4.5.8",
     "@veltdev/reactflow-crdt": "4.5.8",
     "@veltdev/react": "^4.6.10"
   }
-}
+}