fix: fix cannot find matching keyid: {signatures:[...],keys:[...]} on CI

Version Packages

.github/workflows/build-examples.yaml

@@ -27,15 +27,24 @@ jobs:
       with:
         submodules: true
 
-    - name: Enable corepack
-      run: corepack enable
-
     - name: Install Node.js
       uses: actions/setup-node@v3
       with:
         node-version-file: '.node-version'
         cache: 'pnpm'
 
+    steps:
+    - name: Use Latest Corepack
+      run: |
+        echo "Before: corepack version => $(corepack --version || echo 'not installed')"
+        npm install -g corepack@latest
+        echo "After : corepack version => $(corepack --version)"
+        corepack enable
+        pnpm --version
+
+    - name: Enable corepack
+      run: corepack enable
+
     - name: Get pnpm store directory
       shell: bash
       run: |

.github/workflows/build-starters.yaml

@@ -18,15 +18,23 @@ jobs:
       with:
         submodules: true
 
-    - name: Enable corepack
-      run: corepack enable
-
     - name: Install Node.js
       uses: actions/setup-node@v3
       with:
         node-version-file: '.node-version'
         cache: 'pnpm'
 
+    - name: Use Latest Corepack
+      run: |
+        echo "Before: corepack version => $(corepack --version || echo 'not installed')"
+        npm install -g corepack@latest
+        echo "After : corepack version => $(corepack --version)"
+        corepack enable
+        pnpm --version
+
+    - name: Enable corepack
+      run: corepack enable
+
     - name: Get pnpm store directory
       shell: bash
       run: |

.github/workflows/jazz-run.yml

@@ -16,15 +16,23 @@ jobs:
         with:
           submodules: true
 
-      - name: Enable corepack
-        run: corepack enable
-
       - name: Install Node.js
         uses: actions/setup-node@v3
         with:
           node-version-file: '.node-version'
           cache: 'pnpm'
 
+      - name: Use Latest Corepack
+        run: |
+          echo "Before: corepack version => $(corepack --version || echo 'not installed')"
+          npm install -g corepack@latest
+          echo "After : corepack version => $(corepack --version)"
+          corepack enable
+          pnpm --version
+
+      - name: Enable corepack
+        run: corepack enable
+
       - name: Get pnpm store directory
         shell: bash
         run: |

.github/workflows/playwright.yml

@@ -20,15 +20,23 @@ jobs:
         with:
           submodules: true
 
-      - name: Enable corepack
-        run: corepack enable
-
       - name: Install Node.js
         uses: actions/setup-node@v3
         with:
           node-version-file: '.node-version'
           cache: 'pnpm'
 
+      - name: Use Latest Corepack
+        run: |
+          echo "Before: corepack version => $(corepack --version || echo 'not installed')"
+          npm install -g corepack@latest
+          echo "After : corepack version => $(corepack --version)"
+          corepack enable
+          pnpm --version
+
+      - name: Enable corepack
+        run: corepack enable
+
       - name: Get pnpm store directory
         shell: bash
         run: |

.github/workflows/release.yml

@@ -22,15 +22,23 @@ jobs:
       - name: Checkout Repo
         uses: actions/checkout@v3
 
-      - name: Enable corepack
-        run: corepack enable
-
       - name: Install Node.js
         uses: actions/setup-node@v3
         with:
           node-version-file: '.node-version'
           cache: 'pnpm'
 
+      - name: Use Latest Corepack
+        run: |
+          echo "Before: corepack version => $(corepack --version || echo 'not installed')"
+          npm install -g corepack@latest
+          echo "After : corepack version => $(corepack --version)"
+          corepack enable
+          pnpm --version
+
+      - name: Enable corepack
+        run: corepack enable
+
       - name: Get pnpm store directory
         shell: bash
         run: |

.github/workflows/unit-test.yml

@@ -15,15 +15,23 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Enable corepack
-        run: corepack enable
-
       - name: Install Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v3
         with:
           node-version-file: '.node-version'
           cache: 'pnpm'
 
+      - name: Use Latest Corepack
+        run: |
+          echo "Before: corepack version => $(corepack --version || echo 'not installed')"
+          npm install -g corepack@latest
+          echo "After : corepack version => $(corepack --version)"
+          corepack enable
+          pnpm --version
+
+      - name: Enable corepack
+        run: corepack enable
+
       - name: Get pnpm store directory
         shell: bash
         run: |

biome.json

@@ -42,6 +42,15 @@
     }
   },
   "overrides": [
+    {
+      "include": ["**/package.json"],
+      "linter": {
+        "enabled": false
+      },
+      "formatter": {
+        "enabled": false
+      }
+    },
     {
       "include": ["packages/**/src/**"],
       "linter": {

examples/chat-rn-clerk/CHANGELOG.md

@@ -1,5 +1,61 @@
 # chat-rn-clerk
 
+## 1.0.63
+
+### Patch Changes
+
+- jazz-react-native@0.9.22
+- jazz-react-native-auth-clerk@0.9.22
+
+## 1.0.62
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react-native@0.9.21
+  - jazz-react-native-auth-clerk@0.9.21
+  - jazz-react-native-media-images@0.9.21
+
+## 1.0.61
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react-native@0.9.20
+  - jazz-react-native-auth-clerk@0.9.20
+  - jazz-react-native-media-images@0.9.20
+
+## 1.0.60
+
+### Patch Changes
+
+- jazz-react-native@0.9.19
+- jazz-react-native-auth-clerk@0.9.19
+- jazz-tools@0.9.19
+- jazz-react-native-media-images@0.9.19
+
+## 1.0.59
+
+### Patch Changes
+
+- jazz-react-native@0.9.18
+- jazz-react-native-auth-clerk@0.9.18
+- jazz-tools@0.9.18
+- jazz-react-native-media-images@0.9.18
+
+## 1.0.58
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react-native@0.9.17
+  - jazz-react-native-auth-clerk@0.9.17
+  - jazz-react-native-media-images@0.9.17
+
 ## 1.0.57
 
 ### Patch Changes

examples/chat-rn-clerk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chat-rn-clerk",
   "main": "index.js",
-  "version": "1.0.57",
+  "version": "1.0.63",
   "scripts": {
     "build": "expo export -p ios",
     "start": "expo start",

examples/chat-rn/CHANGELOG.md

@@ -1,5 +1,50 @@
 # chat-rn
 
+## 1.0.60
+
+### Patch Changes
+
+- jazz-react-native@0.9.22
+
+## 1.0.59
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react-native@0.9.21
+
+## 1.0.58
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react-native@0.9.20
+
+## 1.0.57
+
+### Patch Changes
+
+- jazz-react-native@0.9.19
+- jazz-tools@0.9.19
+
+## 1.0.56
+
+### Patch Changes
+
+- jazz-react-native@0.9.18
+- jazz-tools@0.9.18
+
+## 1.0.55
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react-native@0.9.17
+
 ## 1.0.54
 
 ### Patch Changes

examples/chat-rn/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-rn",
-  "version": "1.0.54",
+  "version": "1.0.60",
   "main": "index.js",
   "scripts": {
     "build": "expo export -p ios",

examples/chat-vue/CHANGELOG.md

@@ -1,5 +1,56 @@
 # chat-vue
 
+## 0.0.47
+
+### Patch Changes
+
+- jazz-browser@0.9.22
+- jazz-vue@0.9.22
+
+## 0.0.46
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-browser@0.9.21
+  - jazz-vue@0.9.21
+
+## 0.0.45
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-browser@0.9.20
+  - jazz-vue@0.9.20
+
+## 0.0.44
+
+### Patch Changes
+
+- jazz-browser@0.9.19
+- jazz-tools@0.9.19
+- jazz-vue@0.9.19
+
+## 0.0.43
+
+### Patch Changes
+
+- jazz-browser@0.9.18
+- jazz-tools@0.9.18
+- jazz-vue@0.9.18
+
+## 0.0.42
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-browser@0.9.17
+  - jazz-vue@0.9.17
+
 ## 0.0.41
 
 ### Patch Changes

examples/chat-vue/README.md

@@ -11,10 +11,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example chat-vue --project-name chat-vue
-```
-or
-```bash
 npx create-jazz-app@latest --example chat-vue --project-name chat-vue
 ```
 

examples/chat-vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-vue",
-  "version": "0.0.41",
+  "version": "0.0.47",
   "private": true,
   "type": "module",
   "scripts": {

examples/chat/CHANGELOG.md

@@ -1,5 +1,56 @@
 # jazz-example-chat
 
+## 0.0.143
+
+### Patch Changes
+
+- jazz-browser-media-images@0.9.22
+- jazz-react@0.9.22
+
+## 0.0.142
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-browser-media-images@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.141
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-browser-media-images@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.140
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+- jazz-browser-media-images@0.9.19
+
+## 0.0.139
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+- jazz-browser-media-images@0.9.18
+
+## 0.0.138
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-browser-media-images@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.137
 
 ### Patch Changes

examples/chat/README.md

@@ -13,10 +13,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example chat --project-name chat
-```
-or
-```bash
 npx create-jazz-app@latest --example chat --project-name chat
 ```
 

examples/chat/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-chat",
   "private": true,
-  "version": "0.0.137",
+  "version": "0.0.143",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/clerk/CHANGELOG.md

@@ -1,5 +1,56 @@
 # minimal-auth-clerk
 
+## 0.0.42
+
+### Patch Changes
+
+- jazz-react@0.9.22
+- jazz-react-auth-clerk@0.9.22
+
+## 0.0.41
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react@0.9.21
+  - jazz-react-auth-clerk@0.9.21
+
+## 0.0.40
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react@0.9.20
+  - jazz-react-auth-clerk@0.9.20
+
+## 0.0.39
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-react-auth-clerk@0.9.19
+- jazz-tools@0.9.19
+
+## 0.0.38
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-react-auth-clerk@0.9.18
+- jazz-tools@0.9.18
+
+## 0.0.37
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react@0.9.17
+  - jazz-react-auth-clerk@0.9.17
+
 ## 0.0.36
 
 ### Patch Changes

examples/clerk/README.md

@@ -15,10 +15,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example clerk --project-name clerk
-```
-or
-```bash
 npx create-jazz-app@latest --example clerk --project-name clerk
 ```
 

examples/clerk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clerk",
   "private": true,
-  "version": "0.0.36",
+  "version": "0.0.42",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -13,7 +13,7 @@
   "dependencies": {
     "@clerk/clerk-react": "^5.4.1",
     "jazz-react": "workspace:*",
-    "jazz-react-auth-clerk": "workspace:0.9.16",
+    "jazz-react-auth-clerk": "workspace:0.9.22",
     "jazz-tools": "workspace:*",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"

examples/file-share-svelte/CHANGELOG.md

@@ -1,5 +1,50 @@
 # file-share-svelte
 
+## 0.0.27
+
+### Patch Changes
+
+- jazz-svelte@0.9.22
+
+## 0.0.26
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-svelte@0.9.21
+
+## 0.0.25
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-svelte@0.9.20
+
+## 0.0.24
+
+### Patch Changes
+
+- jazz-svelte@0.9.19
+- jazz-tools@0.9.19
+
+## 0.0.23
+
+### Patch Changes
+
+- jazz-svelte@0.9.18
+- jazz-tools@0.9.18
+
+## 0.0.22
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-svelte@0.9.17
+
 ## 0.0.21
 
 ### Patch Changes

examples/file-share-svelte/package.json

@@ -1,6 +1,6 @@
 {
   "name": "file-share-svelte",
-  "version": "0.0.21",
+  "version": "0.0.27",
   "private": true,
   "type": "module",
   "scripts": {

examples/form/CHANGELOG.md

@@ -1,5 +1,56 @@
 # form
 
+## 0.0.38
+
+### Patch Changes
+
+- jazz-browser-media-images@0.9.22
+- jazz-react@0.9.22
+
+## 0.0.37
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-browser-media-images@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.36
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-browser-media-images@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.35
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+- jazz-browser-media-images@0.9.19
+
+## 0.0.34
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+- jazz-browser-media-images@0.9.18
+
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-browser-media-images@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.32
 
 ### Patch Changes

examples/form/README.md

@@ -28,10 +28,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example form --project-name form
-```
-or
-```bash
 npx create-jazz-app@latest --example form --project-name form
 ```
 

examples/form/package.json

@@ -1,7 +1,7 @@
 {
   "name": "form",
   "private": true,
-  "version": "0.0.32",
+  "version": "0.0.38",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/image-upload/CHANGELOG.md

@@ -1,5 +1,56 @@
 # image-upload
 
+## 0.0.40
+
+### Patch Changes
+
+- jazz-browser-media-images@0.9.22
+- jazz-react@0.9.22
+
+## 0.0.39
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-browser-media-images@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.38
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-browser-media-images@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.37
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+- jazz-browser-media-images@0.9.19
+
+## 0.0.36
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+- jazz-browser-media-images@0.9.18
+
+## 0.0.35
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-browser-media-images@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.34
 
 ### Patch Changes

examples/image-upload/README.md

@@ -15,10 +15,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example image-upload --project-name image-upload
-```
-or
-```bash
 npx create-jazz-app@latest --example image-upload --project-name image-upload
 ```
 

examples/image-upload/package.json

@@ -1,7 +1,7 @@
 {
   "name": "image-upload",
   "private": true,
-  "version": "0.0.34",
+  "version": "0.0.40",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/inspector/CHANGELOG.md

@@ -1,5 +1,28 @@
 # jazz-example-inspector
 
+## 0.0.101
+
+### Patch Changes
+
+- Updated dependencies [14b6149]
+  - cojson-transport-ws@0.9.22
+
+## 0.0.100
+
+### Patch Changes
+
+- Updated dependencies [6ad0a9f]
+  - cojson@0.9.19
+  - cojson-transport-ws@0.9.19
+
+## 0.0.99
+
+### Patch Changes
+
+- Updated dependencies [8898b10]
+  - cojson@0.9.18
+  - cojson-transport-ws@0.9.18
+
 ## 0.0.98
 
 ### Patch Changes

examples/inspector/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-inspector-app",
   "private": true,
-  "version": "0.0.98",
+  "version": "0.0.101",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -16,8 +16,8 @@
     "@radix-ui/react-toast": "^1.1.4",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",
-    "cojson": "workspace:0.9.13",
-    "cojson-transport-ws": "workspace:0.9.13",
+    "cojson": "workspace:0.9.19",
+    "cojson-transport-ws": "workspace:0.9.22",
     "hash-slash": "workspace:0.2.1",
     "lucide-react": "^0.274.0",
     "qrcode": "^1.5.3",

examples/music-player/CHANGELOG.md

@@ -1,5 +1,62 @@
 # jazz-example-musicplayer
 
+## 0.0.64
+
+### Patch Changes
+
+- jazz-react@0.9.22
+
+## 0.0.63
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-inspector@0.9.22
+  - jazz-react@0.9.21
+
+## 0.0.62
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-inspector@0.9.21
+  - jazz-react@0.9.20
+
+## 0.0.61
+
+### Patch Changes
+
+- jazz-inspector@0.9.20
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+
+## 0.0.60
+
+### Patch Changes
+
+- Updated dependencies [2faf22f]
+  - jazz-inspector@0.9.19
+
+## 0.0.59
+
+### Patch Changes
+
+- jazz-inspector@0.9.18
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+
+## 0.0.58
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-inspector@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.57
 
 ### Patch Changes

examples/music-player/README.md

@@ -13,10 +13,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example music-player --project-name music-player
-```
-or
-```bash
 npx create-jazz-app@latest --example music-player --project-name music-player
 ```
 

examples/music-player/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-music-player",
   "private": true,
-  "version": "0.0.57",
+  "version": "0.0.64",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -18,8 +18,8 @@
     "@radix-ui/react-toast": "^1.1.4",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",
-    "jazz-react": "workspace:0.9.16",
-    "jazz-tools": "workspace:0.9.16",
+    "jazz-react": "workspace:0.9.22",
+    "jazz-tools": "workspace:0.9.21",
     "jazz-inspector": "workspace:*",
     "lucide-react": "^0.274.0",
     "react": "^18.3.1",

examples/onboarding/CHANGELOG.md

@@ -1,5 +1,56 @@
 # jazz-example-onboarding
 
+## 0.0.44
+
+### Patch Changes
+
+- jazz-browser-media-images@0.9.22
+- jazz-react@0.9.22
+
+## 0.0.43
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-browser-media-images@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.42
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-browser-media-images@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.41
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+- jazz-browser-media-images@0.9.19
+
+## 0.0.40
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+- jazz-browser-media-images@0.9.18
+
+## 0.0.39
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-browser-media-images@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.38
 
 ### Patch Changes

examples/onboarding/README.md

@@ -11,10 +11,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example onboarding --project-name onboarding
-```
-or
-```bash
 npx create-jazz-app@latest --example onboarding --project-name onboarding
 ```
 

examples/onboarding/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-onboarding",
   "private": true,
-  "version": "0.0.38",
+  "version": "0.0.44",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/organization/CHANGELOG.md

@@ -1,5 +1,50 @@
 # organization
 
+## 0.0.36
+
+### Patch Changes
+
+- jazz-react@0.9.22
+
+## 0.0.35
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.33
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+
+## 0.0.32
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+
+## 0.0.31
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.30
 
 ### Patch Changes

examples/organization/README.md

@@ -16,10 +16,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example organization --project-name organization
-```
-or
-```bash
 npx create-jazz-app@latest --example organization --project-name organization
 ```
 

examples/organization/package.json

@@ -1,7 +1,7 @@
 {
   "name": "organization",
   "private": true,
-  "version": "0.0.30",
+  "version": "0.0.36",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/passkey-svelte/CHANGELOG.md

@@ -1,5 +1,41 @@
 # passkey-svelte
 
+## 0.0.31
+
+### Patch Changes
+
+- jazz-svelte@0.9.22
+
+## 0.0.30
+
+### Patch Changes
+
+- jazz-svelte@0.9.21
+
+## 0.0.29
+
+### Patch Changes
+
+- jazz-svelte@0.9.20
+
+## 0.0.28
+
+### Patch Changes
+
+- jazz-svelte@0.9.19
+
+## 0.0.27
+
+### Patch Changes
+
+- jazz-svelte@0.9.18
+
+## 0.0.26
+
+### Patch Changes
+
+- jazz-svelte@0.9.17
+
 ## 0.0.25
 
 ### Patch Changes

examples/passkey-svelte/README.md

@@ -21,10 +21,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example passkey-svelte --project-name passkey-svelte
-```
-or
-```bash
 npx create-jazz-app@latest --example passkey-svelte --project-name passkey-svelte
 ```
 

examples/passkey-svelte/package.json

@@ -1,6 +1,6 @@
 {
   "name": "passkey-svelte",
-  "version": "0.0.25",
+  "version": "0.0.31",
   "type": "module",
   "private": true,
   "scripts": {

examples/passkey/CHANGELOG.md

@@ -1,5 +1,50 @@
 # minimal-auth-passkey
 
+## 0.0.41
+
+### Patch Changes
+
+- jazz-react@0.9.22
+
+## 0.0.40
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.39
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.38
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+
+## 0.0.37
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+
+## 0.0.36
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.35
 
 ### Patch Changes

examples/passkey/README.md

@@ -15,10 +15,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example passkey --project-name passkey
-```
-or
-```bash
 npx create-jazz-app@latest --example passkey --project-name passkey
 ```
 

examples/passkey/package.json

@@ -1,7 +1,7 @@
 {
   "name": "passkey",
   "private": true,
-  "version": "0.0.35",
+  "version": "0.0.41",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/password-manager/CHANGELOG.md

@@ -1,5 +1,50 @@
 # jazz-password-manager
 
+## 0.0.62
+
+### Patch Changes
+
+- jazz-react@0.9.22
+
+## 0.0.61
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.60
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.59
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+
+## 0.0.58
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+
+## 0.0.57
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.56
 
 ### Patch Changes

examples/password-manager/README.md

@@ -15,10 +15,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example password-manager --project-name password-manager
-```
-or
-```bash
 npx create-jazz-app@latest --example password-manager --project-name password-manager
 ```
 

examples/password-manager/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-password-manager",
   "private": true,
-  "version": "0.0.56",
+  "version": "0.0.62",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -12,8 +12,8 @@
     "clean-install": "rm -rf node_modules pnpm-lock.yaml && pnpm install"
   },
   "dependencies": {
-    "jazz-react": "workspace:0.9.16",
-    "jazz-tools": "workspace:0.9.16",
+    "jazz-react": "workspace:0.9.22",
+    "jazz-tools": "workspace:0.9.21",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-hook-form": "^7.41.5",

examples/pets/CHANGELOG.md

@@ -1,5 +1,56 @@
 # jazz-example-pets
 
+## 0.0.160
+
+### Patch Changes
+
+- jazz-browser-media-images@0.9.22
+- jazz-react@0.9.22
+
+## 0.0.159
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-browser-media-images@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.158
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-browser-media-images@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.157
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+- jazz-browser-media-images@0.9.19
+
+## 0.0.156
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+- jazz-browser-media-images@0.9.18
+
+## 0.0.155
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-browser-media-images@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.154
 
 ### Patch Changes

examples/pets/README.md

@@ -13,10 +13,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example pets --project-name pets
-```
-or
-```bash
 npx create-jazz-app@latest --example pets --project-name pets
 ```
 

examples/pets/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-pets",
   "private": true,
-  "version": "0.0.154",
+  "version": "0.0.160",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -19,9 +19,9 @@
     "@radix-ui/react-toast": "^1.1.4",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",
-    "jazz-browser-media-images": "workspace:0.9.16",
-    "jazz-react": "workspace:0.9.16",
-    "jazz-tools": "workspace:0.9.16",
+    "jazz-browser-media-images": "workspace:0.9.22",
+    "jazz-react": "workspace:0.9.22",
+    "jazz-tools": "workspace:0.9.21",
     "lucide-react": "^0.274.0",
     "qrcode": "^1.5.3",
     "react": "^18.3.1",
@@ -41,7 +41,7 @@
     "@vitejs/plugin-react-swc": "^3.3.2",
     "autoprefixer": "^10.4.20",
     "is-ci": "^3.0.1",
-    "jazz-run": "workspace:0.9.16",
+    "jazz-run": "workspace:0.9.22",
     "postcss": "^8.4.27",
     "tailwindcss": "^3.4.15",
     "typescript": "~5.6.2",

examples/reactions/CHANGELOG.md

@@ -1,5 +1,56 @@
 # reactions
 
+## 0.0.40
+
+### Patch Changes
+
+- jazz-browser-media-images@0.9.22
+- jazz-react@0.9.22
+
+## 0.0.39
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-browser-media-images@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.38
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-browser-media-images@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.37
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+- jazz-browser-media-images@0.9.19
+
+## 0.0.36
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+- jazz-browser-media-images@0.9.18
+
+## 0.0.35
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-browser-media-images@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.34
 
 ### Patch Changes

examples/reactions/README.md

@@ -13,10 +13,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example reactions --project-name reactions
-```
-or
-```bash
 npx create-jazz-app@latest --example reactions --project-name reactions
 ```
 

examples/reactions/package.json

@@ -1,7 +1,7 @@
 {
   "name": "reactions",
   "private": true,
-  "version": "0.0.34",
+  "version": "0.0.40",
   "type": "module",
   "scripts": {
     "dev": "vite",

examples/todo-vue/CHANGELOG.md

@@ -1,5 +1,56 @@
 # todo-vue
 
+## 0.0.45
+
+### Patch Changes
+
+- jazz-browser@0.9.22
+- jazz-vue@0.9.22
+
+## 0.0.44
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-browser@0.9.21
+  - jazz-vue@0.9.21
+
+## 0.0.43
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-browser@0.9.20
+  - jazz-vue@0.9.20
+
+## 0.0.42
+
+### Patch Changes
+
+- jazz-browser@0.9.19
+- jazz-tools@0.9.19
+- jazz-vue@0.9.19
+
+## 0.0.41
+
+### Patch Changes
+
+- jazz-browser@0.9.18
+- jazz-tools@0.9.18
+- jazz-vue@0.9.18
+
+## 0.0.40
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-browser@0.9.17
+  - jazz-vue@0.9.17
+
 ## 0.0.39
 
 ### Patch Changes

examples/todo-vue/README.md

@@ -11,10 +11,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example todo-vue --project-name todo-vue
-```
-or
-```bash
 npx create-jazz-app@latest --example todo-vue --project-name todo-vue
 ```
 

examples/todo-vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "todo-vue",
-  "version": "0.0.39",
+  "version": "0.0.45",
   "private": true,
   "type": "module",
   "scripts": {

examples/todo/CHANGELOG.md

@@ -1,5 +1,50 @@
 # jazz-example-todo
 
+## 0.0.159
+
+### Patch Changes
+
+- jazz-react@0.9.22
+
+## 0.0.158
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.157
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.156
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+
+## 0.0.155
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+
+## 0.0.154
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.153
 
 ### Patch Changes

examples/todo/README.md

@@ -13,10 +13,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example todo --project-name todo
-```
-or
-```bash
 npx create-jazz-app@latest --example todo --project-name todo
 ```
 

examples/todo/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-todo",
   "private": true,
-  "version": "0.0.153",
+  "version": "0.0.159",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -16,8 +16,8 @@
     "@radix-ui/react-toast": "^1.1.4",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",
-    "jazz-react": "workspace:0.9.16",
-    "jazz-tools": "workspace:0.9.16",
+    "jazz-react": "workspace:0.9.22",
+    "jazz-tools": "workspace:0.9.21",
     "lucide-react": "^0.274.0",
     "qrcode": "^1.5.3",
     "react": "^18.3.1",

examples/version-history/CHANGELOG.md

@@ -1,5 +1,50 @@
 # version-history
 
+## 0.0.37
+
+### Patch Changes
+
+- jazz-react@0.9.22
+
+## 0.0.36
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react@0.9.21
+
+## 0.0.35
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react@0.9.20
+
+## 0.0.34
+
+### Patch Changes
+
+- jazz-react@0.9.19
+- jazz-tools@0.9.19
+
+## 0.0.33
+
+### Patch Changes
+
+- jazz-react@0.9.18
+- jazz-tools@0.9.18
+
+## 0.0.32
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react@0.9.17
+
 ## 0.0.31
 
 ### Patch Changes

examples/version-history/README.md

@@ -13,10 +13,6 @@ You can either
 
 Create a new Jazz project, and use this example as a template.
 ```bash
-npm create jazz-app@latest --example version-history --project-name version-history
-```
-or
-```bash
 npx create-jazz-app@latest --example version-history --project-name version-history
 ```
 

examples/version-history/package.json

@@ -1,7 +1,7 @@
 {
   "name": "version-history",
   "private": true,
-  "version": "0.0.31",
+  "version": "0.0.37",
   "type": "module",
   "scripts": {
     "dev": "vite",

flake.lock

@@ -5,11 +5,11 @@
         "systems": "systems"
       },
       "locked": {
-        "lastModified": 1726560853,
-        "narHash": "sha256-X6rJYSESBVr3hBoH0WbKE5KvhPU5bloyZ2L4K60/fPQ=",
+        "lastModified": 1731533236,
+        "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
         "owner": "numtide",
         "repo": "flake-utils",
-        "rev": "c1dfcf08411b08f6b8615f7d8971a2bfa81d5e8a",
+        "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
         "type": "github"
       },
       "original": {
@@ -20,11 +20,11 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1730785428,
-        "narHash": "sha256-Zwl8YgTVJTEum+L+0zVAWvXAGbWAuXHax3KzuejaDyo=",
+        "lastModified": 1737885589,
+        "narHash": "sha256-Zf0hSrtzaM1DEz8//+Xs51k/wdSajticVrATqDrfQjg=",
         "owner": "nixos",
         "repo": "nixpkgs",
-        "rev": "4aa36568d413aca0ea84a1684d2d46f55dbabad7",
+        "rev": "852ff1d9e153d8875a83602e03fdef8a63f0ecf8",
         "type": "github"
       },
       "original": {

flake.nix

@@ -18,12 +18,15 @@
           buildInputs = with pkgs; [
             nodejs_22
             nodePackages.pnpm
+            git
           ];
 
           shellHook = ''
+            echo ""
             echo "Welcome to the Jazz development environment!"
             echo "Run 'pnpm install' to install the dependencies."
+            echo ""
           '';
         };
       });
-}
+}

homepage/design-system/src/app/components/atoms/Button.tsx

@@ -1,11 +1,11 @@
 import { clsx } from "clsx";
 import Link from "next/link";
 import { forwardRef } from "react";
-import { Icon } from "../atoms/Icon";
+import { Icon } from "./Icon";
 import { Spinner } from "./Spinner";
 
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
-  variant?: "primary" | "secondary" | "tertiary";
+  variant?: "primary" | "secondary" | "tertiary" | "destructive" | "plain";
   size?: "sm" | "md" | "lg";
   href?: string;
   newTab?: boolean;
@@ -42,6 +42,7 @@ export const Button = forwardRef<HTMLButtonElement, ButtonProps>(
       loading,
       loadingText,
       icon,
+      type = "button",
       ...buttonProps
     },
     ref,
@@ -58,16 +59,21 @@ export const Button = forwardRef<HTMLButtonElement, ButtonProps>(
       secondary:
         "text-stone-900 border font-medium hover:border-stone-300 hover:dark:border-stone-700 dark:text-white",
       tertiary: "text-blue underline underline-offset-4",
+      destructive:
+        "bg-red-600 border-red-600 text-white font-medium hover:bg-red-700 hover:border-red-700",
     };
 
-    const classNames = clsx(
-      className,
-      "inline-flex items-center justify-center gap-2 rounded-lg text-center transition-colors",
-      "disabled:pointer-events-none disabled:opacity-70",
-      sizeClasses[size],
-      variantClasses[variant],
-      disabled && "opacity-50 cursor-not-allowed pointer-events-none",
-    );
+    const classNames =
+      variant === "plain"
+        ? className
+        : clsx(
+            className,
+            "inline-flex items-center justify-center gap-2 rounded-lg text-center transition-colors",
+            "disabled:pointer-events-none disabled:opacity-70",
+            sizeClasses[size],
+            variantClasses[variant],
+            disabled && "opacity-50 cursor-not-allowed pointer-events-none",
+          );
 
     if (href) {
       return (
@@ -95,6 +101,7 @@ export const Button = forwardRef<HTMLButtonElement, ButtonProps>(
         {...buttonProps}
         disabled={disabled || loading}
         className={classNames}
+        type={type}
       >
         <ButtonIcon icon={icon} loading={loading} />
 

homepage/design-system/src/app/components/atoms/Heading.tsx

@@ -0,0 +1,48 @@
+import clsx from "clsx";
+
+type HeadingProps = {
+  level?: 1 | 2 | 3 | 4 | 5 | 6;
+  size?: 1 | 2 | 3 | 4 | 5 | 6;
+} & React.ComponentPropsWithoutRef<"h1" | "h2" | "h3" | "h4" | "h5" | "h6">;
+
+const classes = {
+  1: [
+    "font-display",
+    "text-stone-950 dark:text-white",
+    "text-5xl lg:text-6xl",
+    "mb-3",
+    "font-medium",
+    "tracking-tighter",
+  ],
+  2: [
+    "font-display",
+    "text-stone-950 dark:text-white",
+    "text-2xl md:text-4xl",
+    "mb-2",
+    "font-semibold",
+    "tracking-tight",
+  ],
+  3: [
+    "font-display",
+    "text-stone-950 dark:text-white",
+    "text-xl md:text-2xl",
+    "mb-2",
+    "font-semibold",
+    "tracking-tight",
+  ],
+  4: ["text-bold"],
+  5: [],
+  6: [],
+};
+
+export function Heading({
+  className,
+  level = 1,
+  size: customSize,
+  ...props
+}: HeadingProps) {
+  let Element: `h${typeof level}` = `h${level}`;
+  const size = customSize || level;
+
+  return <Element {...props} className={clsx(classes[size])} />;
+}

homepage/design-system/src/app/components/atoms/Headings.tsx

@@ -1,85 +1,38 @@
 import clsx from "clsx";
+import { Heading } from "./Heading";
 
-interface HeadingProps {
-  children: React.ReactNode;
-  className?: string;
-  id?: string;
+export function H1(
+  props: React.ComponentPropsWithoutRef<"h1"> & React.PropsWithChildren,
+) {
+  return <Heading level={1} {...props} />;
 }
 
-export function H1({ children, className, id }: HeadingProps) {
-  return (
-    <h1
-      id={id}
-      className={clsx(
-        className,
-        "font-display",
-        "text-stone-950 dark:text-white",
-        "text-5xl lg:text-6xl",
-        "mb-3",
-        "font-medium",
-        "tracking-tighter",
-      )}
-    >
-      {children}
-    </h1>
-  );
+export function H2(
+  props: React.ComponentPropsWithoutRef<"h2"> & React.PropsWithChildren,
+) {
+  return <Heading level={2} {...props} />;
 }
 
-export function H2({ children, className, id }: HeadingProps) {
-  return (
-    <h2
-      id={id}
-      className={clsx(
-        className,
-        "font-display",
-        "text-stone-950 dark:text-white",
-        "text-2xl md:text-4xl",
-        "mb-2",
-        "font-semibold",
-        "tracking-tight",
-      )}
-    >
-      {children}
-    </h2>
-  );
+export function H3(
+  props: React.ComponentPropsWithoutRef<"h3"> & React.PropsWithChildren,
+) {
+  return <Heading level={3} {...props} />;
 }
 
-export function H3({ children, className, id }: HeadingProps) {
-  return (
-    <h3
-      id={id}
-      className={clsx(
-        className,
-        "font-display",
-        "text-stone-950 dark:text-white",
-        "text-xl md:text-2xl",
-        "mb-2",
-        "font-semibold",
-        "tracking-tight",
-      )}
-    >
-      {children}
-    </h3>
-  );
+export function H4(
+  props: React.ComponentPropsWithoutRef<"h4"> & React.PropsWithChildren,
+) {
+  return <Heading level={4} {...props} />;
 }
 
-export function H4({ children, className, id }: HeadingProps) {
-  return (
-    <h4 id={id} className={clsx(className, "text-bold")}>
-      {children}
-    </h4>
-  );
+export function H5(
+  props: React.ComponentPropsWithoutRef<"h5"> & React.PropsWithChildren,
+) {
+  return <Heading level={5} {...props} />;
 }
 
-export function Kicker({ children, className }: HeadingProps) {
-  return (
-    <p
-      className={clsx(
-        className,
-        "uppercase text-blue tracking-widest text-sm font-medium dark:text-stone-400",
-      )}
-    >
-      {children}
-    </p>
-  );
+export function H6(
+  props: React.ComponentPropsWithoutRef<"h6"> & React.PropsWithChildren,
+) {
+  return <Heading level={6} {...props} />;
 }

homepage/design-system/src/app/components/atoms/Kicker.tsx

@@ -0,0 +1,21 @@
+import clsx from "clsx";
+
+export function Kicker({
+  children,
+  className,
+  as,
+}: React.ComponentPropsWithoutRef<"p"> & {
+  as?: React.ElementType;
+}) {
+  const Element = as ?? "p";
+  return (
+    <Element
+      className={clsx(
+        className,
+        "uppercase text-blue tracking-widest text-sm font-medium dark:text-stone-400",
+      )}
+    >
+      {children}
+    </Element>
+  );
+}

homepage/design-system/src/app/components/molecules/Input.tsx

@@ -1,32 +1,33 @@
 import { clsx } from "clsx";
-import { useId } from "react";
+import { forwardRef, useId } from "react";
 
-interface Props extends React.InputHTMLAttributes<HTMLInputElement> {
-  // label is required for a11y, but you can hide it with a "label:sr-only" className
+interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
+  // label can be hidden with a "label:sr-only" className
   label: string;
-  type?: "text" | "email" | "number";
+  className?: string;
+  id?: string;
 }
+export const Input = forwardRef<HTMLInputElement, InputProps>(
+  ({ label, className, id: customId, ...inputProps }, ref) => {
+    const generatedId = useId();
+    const id = customId || generatedId;
 
-export function Input(props: Props) {
-  const { label, id: customId, className, type = "text" } = props;
-  const generatedId = useId();
-  const id = customId || generatedId;
+    const inputClassName = clsx(
+      "w-full rounded-md border px-3.5 py-2 shadow-sm",
+      "font-medium text-stone-900",
+      "dark:text-white dark:bg-stone-925",
+    );
 
-  const inputClassName = clsx(
-    "w-full rounded-md border px-3.5 py-2 shadow-sm",
-    "font-medium text-stone-900",
-    "dark:text-white",
-  );
+    const containerClassName = clsx("grid gap-1", className);
 
-  const containerClassName = clsx("grid gap-1", className);
+    return (
+      <div className={containerClassName}>
+        <label htmlFor={id} className="text-stone-600 dark:text-stone-300">
+          {label}
+        </label>
 
-  return (
-    <div className={containerClassName}>
-      <label htmlFor={id} className="text-stone-600 dark:text-stone-300">
-        {label}
-      </label>
-
-      <input {...props} type={type} id={id} className={inputClassName} />
-    </div>
-  );
-}
+        <input ref={ref} {...inputProps} id={id} className={inputClassName} />
+      </div>
+    );
+  },
+);

homepage/design-system/src/app/components/molecules/SectionHeader.tsx

@@ -1,6 +1,7 @@
 import clsx from "clsx";
 import { ReactNode } from "react";
-import { H2, Kicker } from "../atoms/Headings";
+import { H2 } from "../atoms/Headings";
+import { Kicker } from "../atoms/Kicker";
 import { Prose } from "./Prose";
 
 function H2Sub({ children }: { children: React.ReactNode }) {

homepage/design-system/src/app/components/molecules/Select.tsx

@@ -14,10 +14,9 @@ export function Select(
   const containerClassName = clsx("grid gap-1", className);
 
   const selectClassName = clsx(
-    "g-select",
     "w-full rounded-md border shadow-sm px-2 py-1.5 text-sm",
     "font-medium text-stone-900",
-    "dark:text-white",
+    "dark:text-white dark:bg-stone-925",
     "appearance-none",
   );
 

homepage/homepage/.gitignore

@@ -40,3 +40,6 @@ codeSamples
 .turbo
 
 .env
+
+# LLM docs
+public/llms*.txt

homepage/homepage/app/docs/[framework]/[...slug]/page.tsx

@@ -1,7 +1,7 @@
 import DocsLayout from "@/app/docs/[framework]/(others)/layout";
 import { TableOfContents } from "@/components/docs/TableOfContents";
 import ComingSoonPage from "@/components/docs/coming-soon.mdx";
-import { docNavigationItems } from "@/lib/docNavigationItems";
+import { docNavigationItems } from "@/lib/docNavigationItems.js";
 import { Framework, frameworks } from "@/lib/framework";
 import type { Toc } from "@stefanprobst/rehype-extract-toc";
 import { Prose } from "gcmp-design-system/src/app/components/molecules/Prose";

homepage/homepage/components/docs/docs-intro.mdx

@@ -8,14 +8,6 @@ The Jazz docs are currently heavily work in progress, sorry about that!
 
 Run the following command to create a new Jazz project from one of our example apps:
 
-<CodeGroup>
-```sh
-npm create jazz-app@latest
-```
-</CodeGroup>
-
-or
-
 <CodeGroup>
 ```sh
 npx create-jazz-app@latest
@@ -47,7 +39,20 @@ Sync and persist your data by setting up a [sync and storage infrastructure](/do
 
 Learn how to structure your data using [collaborative values](/docs/schemas/covalues).
 
+## API Reference
+
+Many of the packages provided are documented in the [API Reference](/api-reference).
+
+## LLM Docs
+
+We support the [llms.txt](https://llmstxt.org/) convention for making documentation available to large language models and the applications that make use of them.
+
+We currently have: 
+
+- [/llms.txt](/llms.txt) - A overview listing of the available packages and their documentation
+- [/llms-full.txt](/llms-full.txt) - Full documentation for our packages
+
 ## Get support
 
 If you have any questions or need assistance, please don't hesitate to reach out to us on [Discord](https://discord.gg/utDMjHYg42).
-We would love to help you get started.
+We would love to help you get started.

homepage/homepage/components/docs/nav.tsx

@@ -3,7 +3,7 @@
 import { SideNav } from "@/components/SideNav";
 import { SideNavHeader } from "@/components/SideNavHeader";
 import { FrameworkSelect } from "@/components/docs/FrameworkSelect";
-import { docNavigationItems } from "@/lib/docNavigationItems";
+import { docNavigationItems } from "@/lib/docNavigationItems.js";
 import { useFramework } from "@/lib/use-framework";
 import { clsx } from "clsx";
 

homepage/homepage/components/docs/tags.tsx

@@ -156,8 +156,14 @@ export function FnDecl({
   doc: ReactNode;
   example: ReactNode;
 }) {
+  // Extract the method name from the signature (everything before the first parenthesis or type parameter)
+  const methodName = signature.match(/^[^(<]+/)?.[0];
+
   return (
-    <div className="text-sm flex flex-col gap-3 my-2 p-3 rounded bg-stone-50 dark:bg-stone-925">
+    <div
+      id={methodName}
+      className="text-sm flex flex-col gap-3 my-2 p-3 rounded bg-stone-50 dark:bg-stone-925"
+    >
       <div className="flex flex-col gap-2">
         <div>
           {<Highlight>{signature + ":"}</Highlight>}{" "}

homepage/homepage/components/home/HeroSection.tsx

@@ -1,3 +1,4 @@
+import { H1 } from "gcmp-design-system/src/app/components/atoms/Headings";
 import { Icon } from "gcmp-design-system/src/app/components/atoms/Icon";
 import { Prose } from "gcmp-design-system/src/app/components/molecules/Prose";
 import Link from "next/link";
@@ -44,10 +45,10 @@ export function HeroSection() {
         <p className="uppercase text-blue tracking-widest text-sm font-medium dark:text-stone-400">
           Local-first development toolkit
         </p>
-        <h1 className="font-display text-stone-950 dark:text-white text-4xl md:text-5xl lg:text-6xl font-medium tracking-tighter">
+        <H1>
           <span className="inline-block">Ship top-tier apps</span>{" "}
           <span className="inline-block">at high tempo.</span>
-        </h1>
+        </H1>
 
         <Prose size="lg" className="text-pretty max-w-2xl dark:text-stone-200">
           <p>

homepage/homepage/generate-docs/llms-full.mjs

@@ -0,0 +1,511 @@
+import { promises as fs } from "fs";
+import path from "path";
+import { Deserializer, ReflectionKind } from "typedoc";
+import { DOC_SECTIONS, PACKAGES } from "./utils/config.mjs";
+import {
+  getPackageDescription,
+  loadTypedocFiles,
+  writeDocsFile,
+} from "./utils/index.mjs";
+
+function formatType(type) {
+  if (!type) return "unknown";
+
+  // Handle type aliases and references
+  if (type.type === "reference") {
+    const name = type.package ? `${type.package}.${type.name}` : type.name;
+    return (
+      name +
+      (type.typeArguments
+        ? `<${type.typeArguments.map(formatType).join(", ")}>`
+        : "")
+    );
+  }
+
+  // Handle union types
+  if (type.type === "union") {
+    return type.types.map(formatType).join(" | ");
+  }
+
+  // Handle array types
+  if (type.type === "array") {
+    return `${formatType(type.elementType)}[]`;
+  }
+
+  // Handle basic types
+  if (type.type === "intrinsic" || type.type === "literal") {
+    return typeof type.value !== "undefined"
+      ? JSON.stringify(type.value)
+      : type.name;
+  }
+
+  // Handle tuple types
+  if (type.type === "tuple") {
+    return `[${type.elements.map(formatType).join(", ")}]`;
+  }
+
+  // Handle intersection types
+  if (type.type === "intersection") {
+    return type.types.map(formatType).join(" & ");
+  }
+
+  // Handle template literal types
+  if (type.type === "template-literal") {
+    return `\`${type.head}${type.tail.map((t) => `\${${formatType(t[0])}}${t[1]}`).join("")}\``;
+  }
+
+  // Handle reflection types (object types and function types)
+  if (type.type === "reflection") {
+    if (type.declaration.signatures) {
+      const sig = type.declaration.signatures[0];
+      const params =
+        sig.parameters
+          ?.map(
+            (p) =>
+              `${p.name}${p.flags?.isOptional ? "?" : ""}: ${formatType(p.type)}`,
+          )
+          .join(", ") || "";
+      return `(${params}) => ${formatType(sig.type)}`;
+    }
+
+    if (type.declaration.children) {
+      return (
+        "{ " +
+        type.declaration.children
+          .map((child) => {
+            const optional = child.flags?.isOptional ? "?" : "";
+            return `${child.name}${optional}: ${formatType(child.type)}`;
+          })
+          .join("; ") +
+        " }"
+      );
+    }
+  }
+
+  // Handle query types
+  if (type.type === "query") {
+    return `typeof ${formatType(type.queryType)}`;
+  }
+
+  // Handle conditional types
+  if (type.type === "conditional") {
+    return `${formatType(type.checkType)} extends ${formatType(type.extendsType)} ? ${formatType(type.trueType)} : ${formatType(type.falseType)}`;
+  }
+
+  // Handle index access types
+  if (type.type === "indexedAccess") {
+    return `${formatType(type.objectType)}[${formatType(type.indexType)}]`;
+  }
+
+  // Handle mapped types
+  if (type.type === "mapped") {
+    const readonly = type.readonlyModifier === "+" ? "readonly " : "";
+    const optional = type.optionalModifier === "+" ? "?" : "";
+    return `{ ${readonly}[${type.parameter} in ${formatType(type.parameterType)}]${optional}: ${formatType(type.templateType)} }`;
+  }
+
+  // Handle type operators
+  if (type.type === "typeOperator") {
+    return `${type.operator} ${formatType(type.target)}`;
+  }
+
+  // Handle predicate types
+  if (type.type === "predicate") {
+    return `${type.name} is ${formatType(type.targetType)}`;
+  }
+
+  // Handle inferred types
+  if (type.type === "inferred") {
+    return `infer ${type.name}`;
+  }
+
+  // Handle rest types
+  if (type.type === "rest") {
+    return `...${formatType(type.elementType)}`;
+  }
+
+  // Handle unknown types with more detail
+  if (type.toString) {
+    return type.toString();
+  }
+
+  return "unknown";
+}
+
+function formatComment(comment) {
+  if (!comment) return "";
+
+  let text =
+    comment.summary
+      ?.map((part) => part.text)
+      .join("")
+      .trim() || "";
+
+  // Add parameter descriptions if available
+  if (comment.blockTags) {
+    const params = comment.blockTags
+      .filter((tag) => tag.tag === "@param")
+      .map((tag) => {
+        const paramName = tag.param;
+        let description = "";
+        let codeExample = "";
+
+        tag.content.forEach((part) => {
+          if (part.kind === "code") {
+            // Don't wrap in code blocks since examples are already wrapped
+            codeExample += "\n" + part.text + "\n";
+          } else {
+            description += part.text;
+          }
+        });
+
+        return `- ${paramName}: ${description.trim()}${codeExample}`;
+      });
+
+    if (params.length > 0) {
+      text += "\n\nParameters:\n" + params.join("\n");
+    }
+
+    // Add remarks if available
+    const remarks = comment.blockTags
+      .filter((tag) => tag.tag === "@remarks")
+      .map((tag) =>
+        tag.content
+          .map((part) => part.text)
+          .join("")
+          .trim(),
+      );
+
+    if (remarks.length > 0) {
+      text += "\n\nRemarks:\n" + remarks.join("\n");
+    }
+
+    // Add examples
+    const examples = comment.blockTags
+      .filter((tag) => tag.tag === "@example")
+      .map((tag) =>
+        tag.content
+          .map((part) => {
+            if (part.kind === "code") {
+              // Don't wrap in code blocks since examples are already wrapped
+              return "\n" + part.text + "\n";
+            }
+            return part.text;
+          })
+          .join("")
+          .trim(),
+      );
+
+    if (examples.length > 0) {
+      text += "\n\nExamples:\n" + examples.join("\n");
+    }
+  }
+
+  return text;
+}
+
+async function readMdxContent(url) {
+  try {
+    // Special case for the introduction
+    if (url === "/docs") {
+      const introPath = path.join(
+        process.cwd(),
+        "components/docs/docs-intro.mdx",
+      );
+      try {
+        const content = await fs.readFile(introPath, "utf8");
+        // Remove imports and exports
+        return content
+          .replace(/^import[^\n]*\n/gm, "")
+          .replace(/export const metadata[^;]*;/, "")
+          .trim();
+      } catch (err) {
+        if (err.code !== "ENOENT") throw err;
+      }
+    }
+
+    // Convert URL to file path
+    // Remove leading slash and 'docs' from URL
+    const relativePath = url.replace(/^\/docs\/?/, "");
+
+    // Base directory for docs
+    const baseDir = path.join(process.cwd(), "app/docs/[framework]/[...slug]");
+
+    // If it's a directory, try to read all framework variants
+    const fullPath = path.join(baseDir, relativePath);
+    try {
+      const stats = await fs.stat(fullPath);
+      if (stats.isDirectory()) {
+        // Read all MDX files in the directory
+        const files = await fs.readdir(fullPath);
+        const mdxFiles = files.filter((f) => f.endsWith(".mdx"));
+
+        if (mdxFiles.length === 0) return null;
+
+        // Combine content from all framework variants
+        const contents = await Promise.all(
+          mdxFiles.map(async (file) => {
+            const content = await fs.readFile(
+              path.join(fullPath, file),
+              "utf8",
+            );
+            // Remove imports and exports
+            const cleanContent = content
+              .replace(/^import[^\n]*\n/gm, "")
+              .replace(/export const metadata[^;]*;/, "")
+              .trim();
+            return `### ${path.basename(file, ".mdx")} Implementation\n\n${cleanContent}`;
+          }),
+        );
+
+        return contents.join("\n\n---\n\n");
+      }
+    } catch (err) {
+      if (err.code !== "ENOENT") throw err;
+    }
+
+    // Try as a single MDX file
+    const mdxPath = fullPath + ".mdx";
+    try {
+      const content = await fs.readFile(mdxPath, "utf8");
+      // Remove imports and exports
+      return content
+        .replace(/^import[^\n]*\n/gm, "")
+        .replace(/export const metadata[^;]*;/, "")
+        .trim();
+    } catch (err) {
+      if (err.code !== "ENOENT") throw err;
+    }
+
+    console.warn(`Could not find MDX content for ${url} at ${fullPath}`);
+    return null;
+  } catch (error) {
+    console.warn(`Error reading MDX content for ${url}:`, error);
+    return null;
+  }
+}
+
+async function generateDetailedDocs(docs) {
+  const output = [];
+  const deserializer = new Deserializer();
+
+  // Project title
+  output.push("# Jazz\n");
+
+  // Documentation sections with full content
+  output.push("## Documentation\n");
+  for (const section of DOC_SECTIONS) {
+    output.push(`### ${section.title}\n`);
+
+    for (const page of section.pages) {
+      output.push(`#### ${page.title}\n`);
+      const content = await readMdxContent(page.url);
+      console.log(content);
+      if (content) {
+        // If the content contains framework-specific implementations, they're already properly formatted
+        // Otherwise, just add the content directly
+        output.push(content + "\n");
+      }
+      output.push("\n");
+    }
+  }
+
+  // API Reference by package
+  output.push("## API Reference\n\n");
+  // for (const [packageName, packageDocs] of Object.entries(docs)) {
+  //   const project = deserializer.reviveProject(packageDocs, packageName);
+
+  //   // Add package heading with description
+  //   output.push(`### ${packageName}\n`);
+  //   output.push(`${getPackageDescription(packageName)}\n\n`);
+  //   output.push(
+  //     `[API Reference](https://jazz.tools/api-reference/${packageName})\n\n`,
+  //   );
+
+  //   // Process each category
+  //   project.categories?.forEach((category) => {
+  //     output.push(`#### ${category.title}\n`);
+
+  //     category.children.forEach((child) => {
+  //       // Add name, kind, and API reference link
+  //       const apiLink = `[API Reference](https://jazz.tools/api-reference/${packageName}#${child.name})`;
+  //       output.push(
+  //         `##### ${child.name} (${ReflectionKind[child.kind]}) ${apiLink}\n`,
+  //       );
+
+  //       // Add description if available
+  //       const description = formatComment(child.comment);
+  //       if (description) {
+  //         output.push(`${description}\n`);
+  //       }
+
+  //       output.push("\n");
+
+  //       // Add properties for classes/interfaces
+  //       if (child.children) {
+  //         output.push("Properties:\n");
+
+  //         // Group overloaded methods by name
+  //         const methodGroups = new Map();
+  //         child.children.forEach((prop) => {
+  //           if (prop.signatures?.length > 0) {
+  //             const existing = methodGroups.get(prop.name) || [];
+  //             methodGroups.set(prop.name, [...existing, prop]);
+  //           }
+  //         });
+
+  //         child.children.forEach((prop) => {
+  //           // Skip if this is an overloaded method that we'll handle later
+  //           if (
+  //             prop.signatures?.length > 0 &&
+  //             methodGroups.get(prop.name)?.length > 1
+  //           ) {
+  //             return;
+  //           }
+
+  //           const type = formatType(prop.type);
+  //           const description = formatComment(prop.comment);
+
+  //           // Output the property name and type, but skip the type for methods since we'll show signatures
+  //           if (prop.signatures?.length > 0) {
+  //             output.push(
+  //               `- ${prop.name}${description ? ` - ${description}` : ""}\n`,
+  //             );
+  //           } else {
+  //             output.push(
+  //               `- ${prop.name}: ${type}${description ? ` - ${description}` : ""}\n`,
+  //             );
+  //           }
+
+  //           // Handle method signatures with proper indentation
+  //           if (prop.signatures) {
+  //             prop.signatures.forEach((sig) => {
+  //               const params = sig.parameters
+  //                 ?.map((p) => {
+  //                   const paramType = formatType(p.type);
+  //                   return `${p.name}: ${paramType}`;
+  //                 })
+  //                 .join(", ");
+
+  //               output.push(
+  //                 `    Method signature: \`(${params || ""}) => ${formatType(sig.type)}\`\n`,
+  //               );
+
+  //               // Add API reference URL for the method
+  //               output.push(
+  //                 `    [API Reference](https://jazz.tools/api-reference/${packageName}#${child.name}.${prop.name})\n`,
+  //               );
+
+  //               const methodDesc = formatComment(sig.comment);
+  //               if (methodDesc) {
+  //                 // Indent each line of the description
+  //                 const indentedDesc = methodDesc
+  //                   .split("\n")
+  //                   .map((line) => `    ${line}`)
+  //                   .join("\n");
+  //                 output.push(`${indentedDesc}\n`);
+  //               }
+  //             });
+  //           }
+  //         });
+
+  //         // Handle overloaded methods
+  //         methodGroups.forEach((props, name) => {
+  //           if (props.length <= 1) return;
+
+  //           const firstProp = props[0];
+  //           const description = formatComment(firstProp.comment);
+
+  //           output.push(`- ${name}${description ? ` - ${description}` : ""}\n`);
+
+  //           // Combine all signatures with proper indentation
+  //           const allSignatures = props.flatMap((p) => p.signatures || []);
+  //           allSignatures.forEach((sig) => {
+  //             const params = sig.parameters
+  //               ?.map((p) => {
+  //                 const paramType = formatType(p.type);
+  //                 return `${p.name}: ${paramType}`;
+  //               })
+  //               .join(", ");
+
+  //             output.push(
+  //               `    Method signature: \`(${params || ""}) => ${formatType(sig.type)}\`\n`,
+  //             );
+
+  //             // Add API reference URL for the overloaded method
+  //             output.push(
+  //               `    [API Reference](https://jazz.tools/api-reference/${packageName}#${child.name}.${name})\n`,
+  //             );
+
+  //             const methodDesc = formatComment(sig.comment);
+  //             if (methodDesc) {
+  //               // Indent each line of the description
+  //               const indentedDesc = methodDesc
+  //                 .split("\n")
+  //                 .map((line) => `    ${line}`)
+  //                 .join("\n");
+  //               output.push(`${indentedDesc}\n`);
+  //             }
+  //           });
+  //         });
+  //       }
+
+  //       // Add signatures for functions/methods
+  //       if (child.signatures) {
+  //         child.signatures.forEach((sig) => {
+  //           const params = sig.parameters
+  //             ?.map((p) => {
+  //               const type = formatType(p.type);
+  //               const desc = formatComment(p.comment);
+  //               return `${p.name}: ${type}${desc ? ` - ${desc}` : ""}`;
+  //             })
+  //             .join(", ");
+
+  //           output.push(`Signature: ${child.name}(${params || ""})`);
+
+  //           if (sig.type) {
+  //             output.push(`Returns: ${formatType(sig.type)}`);
+  //             if (sig.comment?.returns) {
+  //               output.push(
+  //                 `Return description: ${sig.comment.returns
+  //                   .map((part) => part.text)
+  //                   .join("")
+  //                   .trim()}`,
+  //               );
+  //             }
+  //           }
+
+  //           const sigComment = formatComment(sig.comment);
+  //           if (sigComment) {
+  //             output.push(`\n${sigComment}`);
+  //           }
+
+  //           output.push("\n");
+  //         });
+  //       }
+
+  //       output.push("\n");
+  //     });
+  //   });
+  // }
+
+  // Optional section for additional resources
+  output.push("## Resources\n\n");
+  output.push(
+    "- [Documentation](https://jazz.tools/docs): Detailed documentation about Jazz\n",
+  );
+  output.push(
+    "- [Examples](https://jazz.tools/examples): Code examples and tutorials\n",
+  );
+
+  await writeDocsFile("llms-full.txt", output.join("\n"));
+}
+
+// Main execution
+async function main() {
+  console.log("Generating detailed LLM docs...");
+  const docs = await loadTypedocFiles();
+  await generateDetailedDocs(docs);
+}
+
+main().catch(console.error);

homepage/homepage/generate-docs/llms.mjs

@@ -0,0 +1,80 @@
+import { Deserializer } from "typedoc";
+import { DOC_SECTIONS, PACKAGES } from "./utils/config.mjs";
+import {
+  cleanDescription,
+  loadTypedocFiles,
+  writeDocsFile,
+} from "./utils/index.mjs";
+
+async function generateConciseDocs(docs) {
+  const output = [];
+  const deserializer = new Deserializer();
+
+  // Project title
+  output.push("# Jazz\n");
+
+  // Documentation sections
+  output.push("## Documentation\n");
+  DOC_SECTIONS.forEach((section) => {
+    output.push(`### ${section.title}\n`);
+    section.pages.forEach((page) => {
+      output.push(`- [${page.title}](https://jazz.tools${page.url})\n`);
+    });
+    output.push("\n");
+  });
+
+  // API Reference by package
+  for (const [packageName, packageDocs] of Object.entries(docs)) {
+    const project = deserializer.reviveProject(packageDocs, packageName);
+
+    // Add package heading
+    output.push(`## ${packageName}\n`);
+
+    // Process each category and its exports with direct links
+    if (project.categories) {
+      const seen = new Set(); // Track seen names to avoid duplicates
+      project.categories.forEach((category) => {
+        category.children.forEach((child) => {
+          if (seen.has(child.name)) return;
+          seen.add(child.name);
+
+          // Get and clean up description
+          let description = child.comment?.summary
+            ? cleanDescription(child.comment.summary)
+            : "";
+
+          // Truncate description if it's too long
+          if (description && description.length > 150) {
+            description = description.substring(0, 147) + "...";
+          }
+
+          // Create the line without wrapping
+          output.push(
+            `- [${child.name}](https://jazz.tools/api-reference/${packageName}#${child.name})${description ? `: ${description}` : ""}\n`,
+          );
+        });
+      });
+      output.push("\n");
+    }
+  }
+
+  // Optional section for additional resources
+  output.push("## Optional\n");
+  output.push(
+    "- [Documentation](https://jazz.tools/docs): Detailed documentation about Jazz\n",
+  );
+  output.push(
+    "- [Examples](https://jazz.tools/examples): Code examples and tutorials\n",
+  );
+
+  await writeDocsFile("llms.txt", output.join(""));
+}
+
+// Main execution
+async function main() {
+  console.log("Generating concise LLM docs...");
+  const docs = await loadTypedocFiles();
+  await generateConciseDocs(docs);
+}
+
+main().catch(console.error);

homepage/homepage/generate-docs/typedocs.mjs

@@ -1,21 +1,7 @@
 import { Application } from "typedoc";
+import { PACKAGES } from "./utils/config.mjs";
 
-for (const { packageName, entryPoint, tsconfig, typedocOptions } of [
-  {
-    packageName: "jazz-tools",
-    entryPoint: "exports.ts",
-  },
-  {
-    packageName: "jazz-react",
-    entryPoint: "index.ts",
-    typedocOptions: {
-      skipErrorChecking: true, // TODO: remove this. Temporary workaround
-    },
-  },
-  { packageName: "jazz-browser" },
-  { packageName: "jazz-browser-media-images" },
-  { packageName: "jazz-nodejs" },
-]) {
+for (const { packageName, entryPoint, tsconfig, typedocOptions } of PACKAGES) {
   const app = await Application.bootstrapWithPlugins({
     entryPoints: [
       `../../packages/${packageName}/src/${entryPoint || "index.ts"}`,

homepage/homepage/generate-docs/utils/config.mjs

@@ -0,0 +1,47 @@
+import { docNavigationItems } from "../../lib/docNavigationItems.js";
+
+// Transform docNavigationItems into the format we need
+function transformNavItems() {
+  return docNavigationItems
+    .map((section) => ({
+      title: section.name,
+      pages: section.items
+        .filter((item) => item.done !== 0) // Skip not-yet-written docs
+        .map((item) => ({
+          title: item.name,
+          url: item.href,
+        })),
+    }))
+    .filter((section) => section.pages.length > 0); // Only include sections with pages
+}
+
+export const DOC_SECTIONS = transformNavItems();
+
+export const PACKAGES = [
+  {
+    packageName: "jazz-tools",
+    entryPoint: "exports.ts",
+    description:
+      "The base implementation for Jazz, a framework for distributed state. Provides a high-level API around the CoJSON protocol.",
+  },
+  {
+    packageName: "jazz-react",
+    entryPoint: "index.ts",
+    description: "React bindings for Jazz, a framework for distributed state.",
+    typedocOptions: {
+      skipErrorChecking: true, // TODO: remove this. Temporary workaround
+    },
+  },
+  {
+    packageName: "jazz-browser",
+    description: "Browser (Vanilla JavaScript) bindings for Jazz",
+  },
+  {
+    packageName: "jazz-browser-media-images",
+    description: "Image handling utilities for Jazz in the browser",
+  },
+  {
+    packageName: "jazz-nodejs",
+    description: "NodeJS/Bun server worker bindings for Jazz",
+  },
+];

homepage/homepage/generate-docs/utils/index.mjs

@@ -0,0 +1,58 @@
+import path from "path";
+import fs from "fs/promises";
+import { PACKAGES } from "./config.mjs";
+
+// Common configuration
+export const PACKAGE_DESCRIPTIONS = {
+  "jazz-tools":
+    "The base implementation for Jazz, a framework for distributed state. Provides a high-level API around the CoJSON protocol.",
+  "jazz-react": "React bindings for Jazz, a framework for distributed state.",
+  "jazz-browser": "Browser (Vanilla JavaScript) bindings for Jazz",
+  "jazz-browser-media-images":
+    "Image handling utilities for Jazz in the browser",
+  "jazz-nodejs": "NodeJS/Bun server worker bindings for Jazz",
+};
+
+// Helper functions
+export async function loadTypedocFiles() {
+  const docs = {};
+  for (const { packageName } of PACKAGES) {
+    docs[packageName] = JSON.parse(
+      await fs.readFile(
+        path.join(process.cwd(), "typedoc", packageName + ".json"),
+        "utf-8",
+      ),
+    );
+  }
+  return docs;
+}
+
+export function getPackageDescription(packageName) {
+  const pkg = PACKAGES.find((p) => p.packageName === packageName);
+  return pkg?.description || "";
+}
+
+export function cleanDescription(description) {
+  if (!description) return "";
+  return (
+    description
+      .map((part) => part.text)
+      .join(" ")
+      .trim()
+      // Remove code blocks
+      .replace(/```[\s\S]*?```/g, "")
+      // Remove line breaks and extra spaces
+      .replace(/\s+/g, " ")
+      // Clean up backticks
+      .replace(/\`/g, "'")
+  );
+}
+
+export async function writeDocsFile(filename, content) {
+  await fs.writeFile(
+    path.join(process.cwd(), "public", filename),
+    content,
+    "utf8",
+  );
+  console.log(`Documentation generated at 'public/${filename}'`);
+}

homepage/homepage/package.json

@@ -5,11 +5,15 @@
   "type": "module",
   "scripts": {
     "dev": "NODE_OPTIONS=--max-old-space-size=8192 next dev",
-    "build:generate-docs": "node genDocs.mjs --build",
+    "build:generate-docs": "pnpm run generate:docs && pnpm run generate:llm-docs:all",
     "build": "next build",
     "start": "next start",
     "format-and-lint": "biome check .",
-    "format-and-lint:fix": "biome check . --write"
+    "format-and-lint:fix": "biome check . --write",
+    "generate:docs": "node generate-docs/typedocs.mjs --build",
+    "generate:llm-docs:all": "pnpm run generate:llm-docs:concise && pnpm run generate:llm-docs:full",
+    "generate:llm-docs:concise": "node generate-docs/llms.mjs",
+    "generate:llm-docs:full": "node generate-docs/llms-full.mjs"
   },
   "packageManager": "pnpm@9.14.0",
   "dependencies": {

homepage/homepage/tsconfig.json

@@ -27,7 +27,8 @@
     "**/*.ts",
     "**/*.tsx",
     ".next/types/**/*.ts",
-    "mdx.d.ts"
+    "mdx.d.ts",
+    "lib/docNavigationItems.js"
   ],
   "exclude": ["node_modules"]
 }

packages/cojson-storage-indexeddb/CHANGELOG.md

@@ -1,5 +1,21 @@
 # cojson-storage-indexeddb
 
+## 0.9.19
+
+### Patch Changes
+
+- Updated dependencies [6ad0a9f]
+  - cojson@0.9.19
+  - cojson-storage@0.9.19
+
+## 0.9.18
+
+### Patch Changes
+
+- Updated dependencies [8898b10]
+  - cojson@0.9.18
+  - cojson-storage@0.9.18
+
 ## 0.9.13
 
 ### Patch Changes

packages/cojson-storage-indexeddb/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cojson-storage-indexeddb",
-  "version": "0.9.13",
+  "version": "0.9.19",
   "main": "dist/index.js",
   "type": "module",
   "types": "src/index.ts",

packages/cojson-storage-rn-sqlite/CHANGELOG.md

@@ -1,5 +1,21 @@
 # cojson-storage-sqlite
 
+## 0.8.58
+
+### Patch Changes
+
+- Updated dependencies [6ad0a9f]
+  - cojson@0.9.19
+  - cojson-storage@0.9.19
+
+## 0.8.57
+
+### Patch Changes
+
+- Updated dependencies [8898b10]
+  - cojson@0.9.18
+  - cojson-storage@0.9.18
+
 ## 0.8.56
 
 ### Patch Changes

packages/cojson-storage-rn-sqlite/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cojson-storage-rn-sqlite",
   "type": "module",
-  "version": "0.8.56",
+  "version": "0.8.58",
   "main": "dist/index.js",
   "types": "src/index.ts",
   "license": "MIT",

packages/cojson-storage-sqlite/CHANGELOG.md

@@ -1,5 +1,21 @@
 # cojson-storage-sqlite
 
+## 0.9.19
+
+### Patch Changes
+
+- Updated dependencies [6ad0a9f]
+  - cojson@0.9.19
+  - cojson-storage@0.9.19
+
+## 0.9.18
+
+### Patch Changes
+
+- Updated dependencies [8898b10]
+  - cojson@0.9.18
+  - cojson-storage@0.9.18
+
 ## 0.9.13
 
 ### Patch Changes

packages/cojson-storage-sqlite/package.json

@@ -1,13 +1,13 @@
 {
   "name": "cojson-storage-sqlite",
   "type": "module",
-  "version": "0.9.13",
+  "version": "0.9.19",
   "main": "dist/index.js",
   "types": "src/index.ts",
   "license": "MIT",
   "dependencies": {
     "better-sqlite3": "^11.7.0",
-    "cojson": "workspace:0.9.13",
+    "cojson": "workspace:0.9.19",
     "cojson-storage": "workspace:*"
   },
   "devDependencies": {

packages/cojson-storage/CHANGELOG.md

@@ -1,5 +1,19 @@
 # cojson-storage
 
+## 0.9.19
+
+### Patch Changes
+
+- Updated dependencies [6ad0a9f]
+  - cojson@0.9.19
+
+## 0.9.18
+
+### Patch Changes
+
+- Updated dependencies [8898b10]
+  - cojson@0.9.18
+
 ## 0.9.13
 
 ### Patch Changes

packages/cojson-storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cojson-storage",
-  "version": "0.9.13",
+  "version": "0.9.19",
   "main": "dist/index.js",
   "type": "module",
   "types": "src/index.ts",

packages/cojson-transport-ws/CHANGELOG.md

@@ -1,5 +1,25 @@
 # cojson-transport-nodejs-ws
 
+## 0.9.22
+
+### Patch Changes
+
+- 14b6149: Handle websocket errors and add an onSuccess callback
+
+## 0.9.19
+
+### Patch Changes
+
+- Updated dependencies [6ad0a9f]
+  - cojson@0.9.19
+
+## 0.9.18
+
+### Patch Changes
+
+- Updated dependencies [8898b10]
+  - cojson@0.9.18
+
 ## 0.9.13
 
 ### Patch Changes

packages/cojson-transport-ws/package.json

@@ -1,12 +1,12 @@
 {
   "name": "cojson-transport-ws",
   "type": "module",
-  "version": "0.9.13",
+  "version": "0.9.22",
   "main": "dist/index.js",
   "types": "src/index.ts",
   "license": "MIT",
   "dependencies": {
-    "cojson": "workspace:0.9.13",
+    "cojson": "workspace:*",
     "typescript": "~5.6.2"
   },
   "scripts": {
@@ -19,6 +19,7 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@types/ws": "8.5.10"
+    "@types/ws": "8.5.10",
+    "ws": "^8.14.2"
   }
 }

packages/cojson-transport-ws/src/index.ts

@@ -21,6 +21,7 @@ export type CreateWebSocketPeerOpts = {
   batchingByDefault?: boolean;
   deletePeerStateOnClose?: boolean;
   onClose?: () => void;
+  onSuccess?: () => void;
 };
 
 function createPingTimeoutListener(enabled: boolean, callback: () => void) {
@@ -127,6 +128,7 @@ export function createWebSocketPeer({
   expectPings = true,
   batchingByDefault = true,
   deletePeerStateOnClose = false,
+  onSuccess,
   onClose,
 }: CreateWebSocketPeerOpts): Peer {
   const incoming = new cojsonInternals.Channel<
@@ -142,6 +144,13 @@ export function createWebSocketPeer({
   }
 
   websocket.addEventListener("close", handleClose);
+  websocket.addEventListener("error" as any, (err) => {
+    logger.warn(err.message);
+
+    if (err.message.includes("ECONNREFUSED")) {
+      websocket.close();
+    }
+  });
 
   const pingTimeout = createPingTimeoutListener(expectPings, () => {
     incoming
@@ -154,6 +163,7 @@ export function createWebSocketPeer({
     websocket,
     batchingByDefault,
   );
+  let isFirstMessage = true;
 
   function handleIncomingMsg(event: { data: unknown }) {
     if (event.data === "") {
@@ -169,6 +179,13 @@ export function createWebSocketPeer({
       return;
     }
 
+    if (isFirstMessage) {
+      // The only way to know that the connection has been correctly established with our sync server
+      // is to track that we got a message from the server.
+      onSuccess?.();
+      isFirstMessage = false;
+    }
+
     const { messages } = result;
 
     if (messages.length > 1) {

packages/cojson-transport-ws/src/tests/createWebSocketPeer.test.ts

@@ -170,6 +170,31 @@ describe("createWebSocketPeer", () => {
     );
   });
 
+  test("should call onSuccess handler after receiving first message", () => {
+    const onSuccess = vi.fn();
+    const { listeners } = setup({ onSuccess });
+
+    const messageHandler = listeners.get("message");
+    const message: SyncMessage = {
+      action: "known",
+      id: "co_ztest",
+      header: false,
+      sessions: {},
+    };
+
+    // First message should trigger onSuccess
+    messageHandler?.(
+      new MessageEvent("message", { data: JSON.stringify(message) }),
+    );
+    expect(onSuccess).toHaveBeenCalledTimes(1);
+
+    // Subsequent messages should not trigger onSuccess again
+    messageHandler?.(
+      new MessageEvent("message", { data: JSON.stringify(message) }),
+    );
+    expect(onSuccess).toHaveBeenCalledTimes(1);
+  });
+
   describe("batchingByDefault = true", () => {
     test("should batch outgoing messages", async () => {
       const { peer, mockWebSocket } = setup();

packages/cojson-transport-ws/src/tests/integration.test.ts

@@ -0,0 +1,132 @@
+import { ControlledAgent, LocalNode, WasmCrypto } from "cojson";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
+import { WebSocket } from "ws";
+import { createWebSocketPeer } from "../index";
+import { startSyncServer } from "./syncServer";
+
+describe("WebSocket Peer Integration", () => {
+  let server: any;
+  let syncServerUrl: string;
+  let crypto: WasmCrypto;
+
+  beforeEach(async () => {
+    crypto = await WasmCrypto.create();
+    const result = await startSyncServer();
+    server = result;
+    syncServerUrl = result.syncServer;
+  });
+
+  afterEach(() => {
+    server.close();
+  });
+
+  test("should establish connection between client and server nodes", async () => {
+    // Create client node
+    const clientAgent = crypto.newRandomAgentSecret();
+    const clientNode = new LocalNode(
+      new ControlledAgent(clientAgent, crypto),
+      crypto.newRandomSessionID(crypto.getAgentID(clientAgent)),
+      crypto,
+    );
+
+    // Create WebSocket connection
+    const ws = new WebSocket(syncServerUrl);
+
+    // Track connection success
+    let connectionEstablished = false;
+
+    // Create peer and add to client node
+    const peer = createWebSocketPeer({
+      id: "test-client",
+      websocket: ws,
+      role: "server",
+      onSuccess: () => {
+        connectionEstablished = true;
+      },
+    });
+
+    clientNode.syncManager.addPeer(peer);
+
+    // Wait for connection to establish
+    await new Promise<void>((resolve) => {
+      const checkConnection = setInterval(() => {
+        if (connectionEstablished) {
+          clearInterval(checkConnection);
+          resolve();
+        }
+      }, 100);
+    });
+
+    expect(connectionEstablished).toBe(true);
+    expect(clientNode.syncManager.getPeers()).toHaveLength(1);
+  });
+
+  test("should sync data between nodes through WebSocket connection", async () => {
+    const clientAgent = crypto.newRandomAgentSecret();
+    const clientNode = new LocalNode(
+      new ControlledAgent(clientAgent, crypto),
+      crypto.newRandomSessionID(crypto.getAgentID(clientAgent)),
+      crypto,
+    );
+
+    const ws = new WebSocket(syncServerUrl);
+
+    const peer = createWebSocketPeer({
+      id: "test-client",
+      websocket: ws,
+      role: "server",
+    });
+
+    clientNode.syncManager.addPeer(peer);
+
+    // Create a test group
+    const group = clientNode.createGroup();
+    const map = group.createMap();
+    map.set("testKey", "testValue", "trusting");
+
+    // Wait for sync
+    await map.core.waitForSync();
+    console.log("synced");
+
+    // Verify data reached the server
+    const serverNode = server.localNode;
+    const serverMap = await serverNode.load(map.id);
+
+    expect(serverMap.get("testKey")).toBe("testValue");
+  });
+
+  test("should handle disconnection and cleanup", async () => {
+    const clientAgent = crypto.newRandomAgentSecret();
+    const clientNode = new LocalNode(
+      new ControlledAgent(clientAgent, crypto),
+      crypto.newRandomSessionID(crypto.getAgentID(clientAgent)),
+      crypto,
+    );
+
+    const ws = new WebSocket(syncServerUrl);
+    let disconnectCalled = false;
+
+    const peer = createWebSocketPeer({
+      id: "test-client",
+      websocket: ws,
+      role: "server",
+      onClose: () => {
+        disconnectCalled = true;
+      },
+    });
+
+    clientNode.syncManager.addPeer(peer);
+
+    // Wait for connection to establish
+    await new Promise((resolve) => setTimeout(resolve, 200));
+
+    // Close the server
+    server.close();
+
+    // Wait for disconnect handling
+    await new Promise((resolve) => setTimeout(resolve, 200));
+
+    expect(disconnectCalled).toBe(true);
+    expect(ws.readyState).toBe(WebSocket.CLOSED);
+  });
+});

packages/cojson-transport-ws/src/tests/syncServer.ts

@@ -0,0 +1,89 @@
+import { createServer } from "http";
+import { ControlledAgent, LocalNode, WasmCrypto } from "cojson";
+import { WebSocket, WebSocketServer } from "ws";
+import { createWebSocketPeer } from "../index";
+
+export const startSyncServer = async (port?: number) => {
+  const crypto = await WasmCrypto.create();
+
+  const server = createServer((req, res) => {
+    if (req.url === "/health") {
+      res.writeHead(200);
+      res.end("ok");
+    }
+  });
+  const wss = new WebSocketServer({ noServer: true });
+
+  const agentSecret = crypto.newRandomAgentSecret();
+  const agentID = crypto.getAgentID(agentSecret);
+
+  const localNode = new LocalNode(
+    new ControlledAgent(agentSecret, crypto),
+    crypto.newRandomSessionID(agentID),
+    crypto,
+  );
+
+  const connections = new Set<WebSocket>();
+
+  wss.on("connection", function connection(ws, req) {
+    connections.add(ws);
+
+    const sendPing = () => {
+      ws.send(
+        JSON.stringify({
+          type: "ping",
+          time: Date.now(),
+          dc: "unknown",
+        }),
+      );
+    };
+
+    // ping/pong for the connection liveness
+    const pinging = setInterval(sendPing, 100);
+
+    sendPing(); // Immediately send a ping to the client to signal that the connection is established
+
+    ws.on("close", () => {
+      clearInterval(pinging);
+      connections.delete(ws);
+    });
+
+    const clientId = new Date().toISOString();
+
+    localNode.syncManager.addPeer(
+      createWebSocketPeer({
+        id: clientId,
+        role: "client",
+        websocket: ws,
+        expectPings: false,
+        batchingByDefault: false,
+        deletePeerStateOnClose: true,
+      }),
+    );
+
+    ws.on("error", (e) => console.error(`Error on connection ${clientId}:`, e));
+  });
+
+  server.on("upgrade", function upgrade(req, socket, head) {
+    if (req.url !== "/health") {
+      wss.handleUpgrade(req, socket, head, function done(ws) {
+        wss.emit("connection", ws, req);
+      });
+    }
+  });
+
+  server.listen(port ?? 0);
+
+  port = (server.address() as { port: number }).port;
+  const syncServer = `ws://localhost:${port}`;
+
+  return {
+    close: () => {
+      connections.forEach((ws) => ws.close());
+      server.close();
+    },
+    syncServer,
+    port,
+    localNode,
+  };
+};