Merge pull request #1321 from garden-co/changeset-release/main

Version Packages

.github/workflows/build-examples.yaml

@@ -27,8 +27,13 @@ jobs:
       with:
         submodules: true
 
-    - name: Enable corepack
-      run: corepack enable
+    - name: Enable latestcorepack
+      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: Install Node.js
       uses: actions/setup-node@v3

.github/workflows/build-starters.yaml

@@ -18,8 +18,13 @@ jobs:
       with:
         submodules: true
 
-    - name: Enable corepack
-      run: corepack enable
+    - name: Enable latestcorepack
+      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: Install Node.js
       uses: actions/setup-node@v3

.github/workflows/jazz-run.yml

@@ -16,8 +16,13 @@ jobs:
         with:
           submodules: true
 
-      - name: Enable corepack
-        run: corepack enable
+      - name: Enable latestcorepack
+        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: Install Node.js
         uses: actions/setup-node@v3

.github/workflows/playwright.yml

@@ -20,8 +20,13 @@ jobs:
         with:
           submodules: true
 
-      - name: Enable corepack
-        run: corepack enable
+      - name: Enable latestcorepack
+        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: Install Node.js
         uses: actions/setup-node@v3

.github/workflows/release.yml

@@ -22,8 +22,13 @@ jobs:
       - name: Checkout Repo
         uses: actions/checkout@v3
 
-      - name: Enable corepack
-        run: corepack enable
+      - name: Enable latestcorepack
+        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: Install Node.js
         uses: actions/setup-node@v3

.github/workflows/unit-test.yml

@@ -15,8 +15,13 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Enable corepack
-        run: corepack enable
+      - name: Enable latestcorepack
+        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: Install Node.js
         uses: actions/setup-node@v4

LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright 2024, Garden Computing, Inc.
+Copyright 2025, Garden Computing, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -16,4 +16,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

README.md

@@ -17,4 +17,4 @@ For community and support, please join our [Discord](https://discord.gg/utDMjHYg
 - Community & support: [Discord](https://discord.gg/utDMjHYg42)
 - Updates: [X](https://x.com/jazz_tools) & [Email](https://garden.co/news)
 
-Copyright 2024 — Garden Computing, Inc.
+Copyright 2025 — Garden Computing, Inc.

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,149 @@
 # chat-rn-clerk
 
+## 1.0.64
+
+### Patch Changes
+
+- jazz-react-native@0.9.23
+- jazz-react-native-auth-clerk@0.9.23
+- jazz-tools@0.9.23
+- jazz-react-native-media-images@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-react-native-auth-clerk@0.9.16
+  - jazz-tools@0.9.16
+  - jazz-react-native@0.9.16
+  - jazz-react-native-media-images@0.9.16
+
+## 1.0.56
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react-native@0.9.15
+  - jazz-react-native-auth-clerk@0.9.15
+  - jazz-react-native-media-images@0.9.15
+
+## 1.0.55
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react-native@0.9.14
+  - jazz-react-native-auth-clerk@0.9.14
+  - jazz-react-native-media-images@0.9.14
+
+## 1.0.54
+
+### Patch Changes
+
+- jazz-react-native@0.9.13
+- jazz-react-native-auth-clerk@0.9.13
+- jazz-tools@0.9.13
+- jazz-react-native-media-images@0.9.13
+
+## 1.0.53
+
+### Patch Changes
+
+- jazz-react-native@0.9.12
+- jazz-react-native-auth-clerk@0.9.12
+- jazz-tools@0.9.12
+- jazz-react-native-media-images@0.9.12
+
+## 1.0.52
+
+### Patch Changes
+
+- jazz-react-native@0.9.11
+- jazz-react-native-auth-clerk@0.9.11
+- jazz-tools@0.9.11
+- jazz-react-native-media-images@0.9.11
+
+## 1.0.51
+
+### Patch Changes
+
+- f76274c: Fix image handling in react-native
+- Updated dependencies [f76274c]
+- Updated dependencies [5e83864]
+  - jazz-react-native@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-react-native-auth-clerk@0.9.10
+  - jazz-react-native-media-images@0.9.10
+
+## 1.0.50
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react-native@0.9.9
+  - jazz-react-native-auth-clerk@0.9.9
+  - jazz-react-native-media-images@0.9.9
+
 ## 1.0.49
 
 ### Patch Changes

examples/chat-rn-clerk/app.json

@@ -37,7 +37,13 @@
       ],
       "expo-secure-store",
       "expo-font",
-      "expo-router"
+      "expo-router",
+      [
+        "expo-image-picker",
+        {
+          "photosPermission": "The app accesses your photos to let you share them with your friends."
+        }
+      ]
     ],
     "extra": {
       "eas": {

examples/chat-rn-clerk/app/chat/[chatId].tsx

@@ -2,8 +2,11 @@ import { Chat, Message } from "@/src/schema";
 import { useNavigation } from "@react-navigation/native";
 import clsx from "clsx";
 import * as Clipboard from "expo-clipboard";
+import * as ImagePicker from "expo-image-picker";
 import { useLocalSearchParams } from "expo-router";
 import { useAccount, useCoState } from "jazz-react-native";
+import { ProgressiveImg } from "jazz-react-native";
+import { createImage } from "jazz-react-native-media-images";
 import { Group, ID } from "jazz-tools";
 import { useEffect, useLayoutEffect, useState } from "react";
 import React, {
@@ -16,6 +19,8 @@ import React, {
   KeyboardAvoidingView,
   TextInput,
   Button,
+  Image,
+  ActivityIndicator,
 } from "react-native";
 
 export default function Conversation() {
@@ -25,6 +30,7 @@ export default function Conversation() {
   const [message, setMessage] = useState("");
   const loadedChat = useCoState(Chat, chat?.id, [{}]);
   const navigation = useNavigation();
+  const [isUploading, setIsUploading] = useState(false);
 
   useEffect(() => {
     if (chat) return;
@@ -81,6 +87,32 @@ export default function Conversation() {
     }
   };
 
+  const handleImageUpload = async () => {
+    try {
+      const result = await ImagePicker.launchImageLibraryAsync({
+        mediaTypes: ImagePicker.MediaTypeOptions.Images,
+        base64: true,
+        quality: 0.7,
+      });
+
+      if (!result.canceled && result.assets[0].base64 && chat) {
+        setIsUploading(true);
+        const base64Uri = `data:image/jpeg;base64,${result.assets[0].base64}`;
+
+        const image = await createImage(base64Uri, {
+          owner: chat._owner,
+          maxSize: 2048,
+        });
+
+        chat.push(Message.create({ text: "", image }, { owner: chat._owner }));
+      }
+    } catch (error) {
+      Alert.alert("Error", "Failed to upload image");
+    } finally {
+      setIsUploading(false);
+    }
+  };
+
   const renderMessageItem = ({ item }: { item: Message }) => {
     const isMe = item._edits.text.by?.isMe;
     return (
@@ -106,14 +138,27 @@ export default function Conversation() {
             isMe ? "flex-row" : "flex-row",
           )}
         >
-          <Text
-            className={clsx(
-              !isMe ? "text-black" : "text-gray-200",
-              `text-md max-w-[85%]`,
-            )}
-          >
-            {item.text}
-          </Text>
+          {item.image && (
+            <ProgressiveImg image={item.image} maxWidth={1024}>
+              {({ src, res, originalSize }) => (
+                <Image
+                  source={{ uri: src }}
+                  className="w-48 h-48 rounded-lg mb-2"
+                  resizeMode="cover"
+                />
+              )}
+            </ProgressiveImg>
+          )}
+          {item.text && (
+            <Text
+              className={clsx(
+                !isMe ? "text-black" : "text-gray-200",
+                `text-md max-w-[85%]`,
+              )}
+            >
+              {item.text}
+            </Text>
+          )}
           <Text
             className={clsx(
               "text-[10px] text-right ml-2",
@@ -147,6 +192,17 @@ export default function Conversation() {
         className="p-3 bg-white border-t border-gray-300"
       >
         <SafeAreaView className="flex-row items-center gap-2">
+          <TouchableOpacity
+            onPress={handleImageUpload}
+            disabled={isUploading}
+            className="h-10 w-10 items-center justify-center"
+          >
+            {isUploading ? (
+              <ActivityIndicator size="small" color="#0000ff" />
+            ) : (
+              <Text className="text-2xl">🖼️</Text>
+            )}
+          </TouchableOpacity>
           <TextInput
             className="flex-1 rounded-full h-10 px-4 bg-gray-100 border border-gray-300 focus:border-blue-500 focus:bg-white"
             value={message}

examples/chat-rn-clerk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chat-rn-clerk",
   "main": "index.js",
-  "version": "1.0.49",
+  "version": "1.0.64",
   "scripts": {
     "build": "expo export -p ios",
     "start": "expo start",
@@ -35,6 +35,7 @@
     "expo-dev-client": "~5.0.5",
     "expo-file-system": "^18.0.4",
     "expo-font": "~13.0.1",
+    "expo-image-picker": "~16.0.4",
     "expo-linking": "~7.0.3",
     "expo-router": "~4.0.11",
     "expo-secure-store": "~14.0.0",

examples/chat-rn-clerk/src/auth-context.tsx

@@ -1,13 +1,7 @@
 import { useClerk, useUser } from "@clerk/clerk-expo";
 import { JazzProvider, setupKvStore } from "jazz-react-native";
 import { useJazzClerkAuth } from "jazz-react-native-auth-clerk";
-import React, {
-  createContext,
-  PropsWithChildren,
-  useContext,
-  useEffect,
-  useState,
-} from "react";
+import React, { createContext, PropsWithChildren, useContext } from "react";
 import { Text, View } from "react-native";
 const AuthContext = createContext<{
   isAuthenticated: boolean;
@@ -27,15 +21,7 @@ export function JazzAndAuth({ children }: PropsWithChildren) {
   const { isSignedIn, isLoaded: isClerkLoaded } = useUser();
   const clerk = useClerk();
   const [auth, state] = useJazzClerkAuth(clerk, kvStore);
-  const [isAuthenticated, setIsAuthenticated] = useState(false);
-
-  useEffect(() => {
-    if (isSignedIn && isClerkLoaded && auth) {
-      setIsAuthenticated(true);
-    } else {
-      setIsAuthenticated(false);
-    }
-  }, [isSignedIn, isClerkLoaded, auth]);
+  const isAuthenticated = Boolean(isSignedIn && isClerkLoaded && auth);
 
   return (
     <AuthContext.Provider

examples/chat-rn-clerk/src/schema.ts

@@ -1,7 +1,8 @@
-import { CoList, CoMap, co } from "jazz-tools";
+import { CoList, CoMap, ImageDefinition, co } from "jazz-tools";
 
 export class Message extends CoMap {
   text = co.string;
+  image = co.optional.ref(ImageDefinition);
 }
 
 export class Chat extends CoList.Of(co.ref(Message)) {}

examples/chat-rn/CHANGELOG.md

@@ -1,5 +1,119 @@
 # chat-rn
 
+## 1.0.61
+
+### Patch Changes
+
+- jazz-react-native@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-react-native@0.9.16
+
+## 1.0.53
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react-native@0.9.15
+
+## 1.0.52
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react-native@0.9.14
+
+## 1.0.51
+
+### Patch Changes
+
+- jazz-react-native@0.9.13
+- jazz-tools@0.9.13
+
+## 1.0.50
+
+### Patch Changes
+
+- jazz-react-native@0.9.12
+- jazz-tools@0.9.12
+
+## 1.0.49
+
+### Patch Changes
+
+- jazz-react-native@0.9.11
+- jazz-tools@0.9.11
+
+## 1.0.48
+
+### Patch Changes
+
+- Updated dependencies [f76274c]
+- Updated dependencies [5e83864]
+  - jazz-react-native@0.9.10
+  - jazz-tools@0.9.10
+
+## 1.0.47
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react-native@0.9.9
+
 ## 1.0.46
 
 ### Patch Changes

examples/chat-rn/package.json

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

examples/chat-vue/CHANGELOG.md

@@ -1,5 +1,133 @@
 # chat-vue
 
+## 0.0.48
+
+### Patch Changes
+
+- jazz-browser@0.9.23
+- jazz-tools@0.9.23
+- jazz-vue@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-browser@0.9.16
+  - jazz-vue@0.9.16
+
+## 0.0.40
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-browser@0.9.15
+  - jazz-vue@0.9.15
+
+## 0.0.39
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-browser@0.9.14
+  - jazz-vue@0.9.14
+
+## 0.0.38
+
+### Patch Changes
+
+- jazz-browser@0.9.13
+- jazz-tools@0.9.13
+- jazz-vue@0.9.13
+
+## 0.0.37
+
+### Patch Changes
+
+- jazz-browser@0.9.12
+- jazz-tools@0.9.12
+- jazz-vue@0.9.12
+
+## 0.0.36
+
+### Patch Changes
+
+- jazz-browser@0.9.11
+- jazz-tools@0.9.11
+- jazz-vue@0.9.11
+
+## 0.0.35
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-tools@0.9.10
+  - jazz-browser@0.9.10
+  - jazz-vue@0.9.10
+
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser@0.9.9
+  - jazz-vue@0.9.9
+
 ## 0.0.33
 
 ### Patch Changes

examples/chat-vue/README.md

@@ -1,29 +1,55 @@
 # Chat example with Jazz and Vue
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example chat-vue --project-name chat-vue
 ```
 
-Go to the todo-vue example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/chat-vue
+cd chat-vue
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/chat-vue/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/chat-vue/package.json

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

examples/chat/CHANGELOG.md

@@ -1,5 +1,134 @@
 # jazz-example-chat
 
+## 0.0.144
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+- jazz-browser-media-images@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-browser-media-images@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.136
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-browser-media-images@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.135
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-browser-media-images@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.134
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+- jazz-browser-media-images@0.9.13
+
+## 0.0.133
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+- jazz-browser-media-images@0.9.12
+
+## 0.0.132
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+- jazz-browser-media-images@0.9.11
+
+## 0.0.131
+
+### Patch Changes
+
+- f76274c: Fix image handling in react-native
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.130
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.129
 
 ### Patch Changes

examples/chat/README.md

@@ -2,30 +2,56 @@
 
 Live version: [https://chat.jazz.tools](https://chat.jazz.tools)
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example chat --project-name chat
 ```
 
-Go to the chat example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/chat
+cd chat
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/chat/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/chat/package.json

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

examples/chat/src/chatScreen.tsx

@@ -35,7 +35,7 @@ export function ChatScreen(props: { chatID: ID<Chat> }) {
       return;
     }
 
-    createImage(file).then((image) => {
+    createImage(file, { owner: chat._owner }).then((image) => {
       chat.push(Message.create({ text: file.name, image: image }, chat._owner));
     });
   };

examples/clerk/CHANGELOG.md

@@ -1,5 +1,133 @@
 # minimal-auth-clerk
 
+## 0.0.43
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-react-auth-clerk@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-react-auth-clerk@0.9.16
+  - jazz-tools@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.35
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react@0.9.15
+  - jazz-react-auth-clerk@0.9.15
+
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react@0.9.14
+  - jazz-react-auth-clerk@0.9.14
+
+## 0.0.33
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-react-auth-clerk@0.9.13
+- jazz-tools@0.9.13
+
+## 0.0.32
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-react-auth-clerk@0.9.12
+- jazz-tools@0.9.12
+
+## 0.0.31
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-react-auth-clerk@0.9.11
+- jazz-tools@0.9.11
+
+## 0.0.30
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-react-auth-clerk@0.9.10
+
+## 0.0.29
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+  - jazz-react-auth-clerk@0.9.9
+
 ## 0.0.28
 
 ### Patch Changes

examples/clerk/README.md

@@ -4,30 +4,56 @@ This is an example of how to use clerk authentication with Jazz.
 
 Live version: https://clerk-demo.jazz.tools
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example clerk --project-name clerk
 ```
 
-Go to the clerk example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/clerk
+cd clerk
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/clerk/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/clerk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clerk",
   "private": true,
-  "version": "0.0.28",
+  "version": "0.0.43",
   "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.8",
+    "jazz-react-auth-clerk": "workspace:0.9.23",
     "jazz-tools": "workspace:*",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"

examples/file-share-svelte/CHANGELOG.md

@@ -1,5 +1,118 @@
 # file-share-svelte
 
+## 0.0.28
+
+### Patch Changes
+
+- jazz-svelte@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-svelte@0.9.16
+
+## 0.0.20
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-svelte@0.9.15
+
+## 0.0.19
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-svelte@0.9.14
+
+## 0.0.18
+
+### Patch Changes
+
+- jazz-svelte@0.9.13
+- jazz-tools@0.9.13
+
+## 0.0.17
+
+### Patch Changes
+
+- jazz-svelte@0.9.12
+- jazz-tools@0.9.12
+
+## 0.0.16
+
+### Patch Changes
+
+- jazz-svelte@0.9.11
+- jazz-tools@0.9.11
+
+## 0.0.15
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-tools@0.9.10
+  - jazz-svelte@0.9.10
+
+## 0.0.14
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-svelte@0.9.9
+
 ## 0.0.13
 
 ### Patch Changes

examples/file-share-svelte/package.json

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

examples/form/CHANGELOG.md

@@ -1,5 +1,133 @@
 # form
 
+## 0.0.39
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+- jazz-browser-media-images@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-browser-media-images@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.31
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-browser-media-images@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.30
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-browser-media-images@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.29
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+- jazz-browser-media-images@0.9.13
+
+## 0.0.28
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+- jazz-browser-media-images@0.9.12
+
+## 0.0.27
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+- jazz-browser-media-images@0.9.11
+
+## 0.0.26
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.25
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.24
 
 ### Patch Changes

examples/form/README.md

@@ -17,30 +17,56 @@ converting it into a `BubbleTeaOrder`.
 
 [See the full guide here.](https://jazz.tools/docs/react/design-patterns/form)
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example form --project-name form
 ```
 
-Go to the form example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/form
+cd form
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/form/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/form/package.json

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

examples/image-upload/CHANGELOG.md

@@ -1,5 +1,133 @@
 # image-upload
 
+## 0.0.41
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+- jazz-browser-media-images@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-browser-media-images@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-browser-media-images@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.32
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-browser-media-images@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.31
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+- jazz-browser-media-images@0.9.13
+
+## 0.0.30
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+- jazz-browser-media-images@0.9.12
+
+## 0.0.29
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+- jazz-browser-media-images@0.9.11
+
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.27
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.26
 
 ### Patch Changes

examples/image-upload/README.md

@@ -4,30 +4,56 @@ This is an example of how to upload and render images with Jazz.
 
 Live version: https://image-upload-demo.jazz.tools
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example image-upload --project-name image-upload
 ```
 
-Go to the image-upload example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/image-upload
+cd image-upload
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/image-upload/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/image-upload/package.json

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

examples/inspector/CHANGELOG.md

@@ -1,5 +1,77 @@
 # jazz-example-inspector
 
+## 0.0.102
+
+### Patch Changes
+
+- Updated dependencies [70c9a5d]
+  - cojson@0.9.23
+  - cojson-transport-ws@0.9.23
+
+## 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
+
+- Updated dependencies [8d29e50]
+  - cojson-transport-ws@0.9.13
+  - cojson@0.9.13
+
+## 0.0.97
+
+### Patch Changes
+
+- Updated dependencies [15d4b2a]
+  - cojson-transport-ws@0.9.12
+  - cojson@0.9.12
+
+## 0.0.96
+
+### Patch Changes
+
+- Updated dependencies [efbf3d8]
+- Updated dependencies [5863bad]
+  - cojson@0.9.11
+  - cojson-transport-ws@0.9.11
+
+## 0.0.95
+
+### Patch Changes
+
+- Updated dependencies [4aa377d]
+  - cojson@0.9.10
+  - cojson-transport-ws@0.9.10
+
+## 0.0.94
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - cojson@0.9.9
+  - cojson-transport-ws@0.9.9
+
 ## 0.0.93
 
 ### Patch Changes

examples/inspector/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "jazz-inspector",
+  "name": "jazz-inspector-app",
   "private": true,
-  "version": "0.0.93",
+  "version": "0.0.102",
   "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.0",
-    "cojson-transport-ws": "workspace:0.9.0",
+    "cojson": "workspace:0.9.23",
+    "cojson-transport-ws": "workspace:0.9.23",
     "hash-slash": "workspace:0.2.1",
     "lucide-react": "^0.274.0",
     "qrcode": "^1.5.3",

examples/music-player/CHANGELOG.md

@@ -1,5 +1,137 @@
 # jazz-example-musicplayer
 
+## 0.0.65
+
+### Patch Changes
+
+- jazz-inspector@0.9.23
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-inspector@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.56
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-inspector@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.55
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-inspector@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.54
+
+### Patch Changes
+
+- jazz-inspector@0.9.13
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+
+## 0.0.53
+
+### Patch Changes
+
+- jazz-inspector@0.9.12
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+
+## 0.0.52
+
+### Patch Changes
+
+- jazz-inspector@0.9.11
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+
+## 0.0.51
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+
+## 0.0.50
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.49
 
 ### Patch Changes

examples/music-player/README.md

@@ -2,30 +2,56 @@
 
 Live version: https://music-demo.jazz.tools
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example music-player --project-name music-player
 ```
 
-Go to the music-player example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/music-player
+cd music-player
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/music-player/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/music-player/package.json

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

examples/music-player/src/2_main.tsx

@@ -1,4 +1,5 @@
 import { Toaster } from "@/components/ui/toaster";
+import { JazzInspector } from "jazz-inspector";
 /* eslint-disable react-refresh/only-export-components */
 import React from "react";
 import ReactDOM from "react-dom/client";
@@ -71,6 +72,7 @@ function JazzAndAuth({ children }: { children: React.ReactNode }) {
         AccountSchema={MusicaAccount}
       >
         {children}
+        <JazzInspector />
       </JazzProvider>
       <DemoAuthBasicUI appName="Jazz Music Player" state={state} />
     </>

examples/onboarding/CHANGELOG.md

@@ -1,5 +1,133 @@
 # jazz-example-onboarding
 
+## 0.0.45
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+- jazz-browser-media-images@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-browser-media-images@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.37
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-browser-media-images@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.36
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-browser-media-images@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.35
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+- jazz-browser-media-images@0.9.13
+
+## 0.0.34
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+- jazz-browser-media-images@0.9.12
+
+## 0.0.33
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+- jazz-browser-media-images@0.9.11
+
+## 0.0.32
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.31
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.30
 
 ### Patch Changes

examples/onboarding/README.md

@@ -1,29 +1,54 @@
 # Onboarding example with Jazz and React
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example onboarding --project-name onboarding
 ```
 
-Go to the onboarding example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/onboarding
+cd onboarding
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/onboarding/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/onboarding/package.json

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

examples/organization/CHANGELOG.md

@@ -1,5 +1,118 @@
 # organization
 
+## 0.0.37
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.29
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.27
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+
+## 0.0.26
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+
+## 0.0.25
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+
+## 0.0.24
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+
+## 0.0.23
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.22
 
 ### Patch Changes

examples/organization/README.md

@@ -5,30 +5,56 @@ Different apps have different names for this concept, such as "teams" or "worksp
 
 Refer to the [documentation](https://jazz.tools/docs/react/design-patterns/organization)  for more information.
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example organization --project-name organization
 ```
 
-Go to the organization example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/organization
+cd organization
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/organization/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/organization/package.json

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

examples/passkey-svelte/CHANGELOG.md

@@ -1,5 +1,95 @@
 # passkey-svelte
 
+## 0.0.32
+
+### Patch Changes
+
+- jazz-svelte@0.9.23
+
+## 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
+
+- jazz-svelte@0.9.16
+
+## 0.0.24
+
+### Patch Changes
+
+- jazz-svelte@0.9.15
+
+## 0.0.23
+
+### Patch Changes
+
+- jazz-svelte@0.9.14
+
+## 0.0.22
+
+### Patch Changes
+
+- jazz-svelte@0.9.13
+
+## 0.0.21
+
+### Patch Changes
+
+- jazz-svelte@0.9.12
+
+## 0.0.20
+
+### Patch Changes
+
+- jazz-svelte@0.9.11
+
+## 0.0.19
+
+### Patch Changes
+
+- jazz-svelte@0.9.10
+
+## 0.0.18
+
+### Patch Changes
+
+- jazz-svelte@0.9.9
+
 ## 0.0.17
 
 ### Patch Changes

examples/passkey-svelte/README.md

@@ -10,34 +10,55 @@ This example showcases how to:
 - Manage authentication state
 - Implement secure login/logout flows
 
-## Getting Started
+## Getting started
 
-1. Clone the repository:
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-```sh
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
+```bash
+npx create-jazz-app@latest --example passkey-svelte --project-name passkey-svelte
+```
+
+Go to the new project directory.
+```bash
+cd passkey-svelte
+```
+
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
 git clone https://github.com/garden-co/jazz.git
 ```
 
-2. Navigate to the example directory:
-
-```sh
-cd examples/passkey-svelte
+Install and build dependencies.
+```bash
+pnpm i && npx turbo build
 ```
 
-3. Install dependencies:
-
-```sh
-pnpm install
+Go to the example directory.
+```bash
+cd jazz/examples/passkey-svelte/
 ```
 
-4. Start the development server:
-
-```sh
+Start the dev server.
+```bash
 pnpm dev
 ```
 
-5. Open your browser and visit [http://localhost:5173](http://localhost:5173)
-
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
 
 ## Learn More
 

examples/passkey-svelte/package.json

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

examples/passkey/CHANGELOG.md

@@ -1,5 +1,118 @@
 # minimal-auth-passkey
 
+## 0.0.42
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.32
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+
+## 0.0.31
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+
+## 0.0.30
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+
+## 0.0.29
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.27
 
 ### Patch Changes

examples/passkey/README.md

@@ -4,30 +4,55 @@ This is an example of how to use passkey authentication with Jazz.
 
 Live version: https://passkey-demo.jazz.tools
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example passkey --project-name passkey
 ```
 
-Go to the passkey example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/passkey
+cd passkey
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/passkey/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/passkey/package.json

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

examples/password-manager/CHANGELOG.md

@@ -1,5 +1,118 @@
 # jazz-password-manager
 
+## 0.0.63
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.55
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.54
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.53
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+
+## 0.0.52
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+
+## 0.0.51
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+
+## 0.0.50
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+
+## 0.0.49
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.48
 
 ### Patch Changes

examples/password-manager/README.md

@@ -4,30 +4,56 @@ Live version: https://passwords-demo.jazz.tools
 
 ![Password Manager Screenshot](demo.png "Screenshot")
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example password-manager --project-name password-manager
 ```
 
-Go to the password-manager example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/password-manager
+cd password-manager
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/password-manager/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Structure
 
 - [`src/components`](./src/components/): UI components

examples/password-manager/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-password-manager",
   "private": true,
-  "version": "0.0.48",
+  "version": "0.0.63",
   "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.8",
-    "jazz-tools": "workspace:0.9.8",
+    "jazz-react": "workspace:0.9.23",
+    "jazz-tools": "workspace:0.9.23",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-hook-form": "^7.41.5",

examples/pets/CHANGELOG.md

@@ -1,5 +1,133 @@
 # jazz-example-pets
 
+## 0.0.161
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+- jazz-browser-media-images@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-browser-media-images@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.153
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-browser-media-images@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.152
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-browser-media-images@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.151
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+- jazz-browser-media-images@0.9.13
+
+## 0.0.150
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+- jazz-browser-media-images@0.9.12
+
+## 0.0.149
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+- jazz-browser-media-images@0.9.11
+
+## 0.0.148
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.147
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.146
 
 ### Patch Changes

examples/pets/README.md

@@ -2,30 +2,55 @@
 
 Live version: https://pets-demo.jazz.tools/
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example pets --project-name pets
 ```
 
-Go to the pets example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/pets
+cd pets
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/pets/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
 
 ## Questions / problems / feedback
 

examples/pets/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-pets",
   "private": true,
-  "version": "0.0.146",
+  "version": "0.0.161",
   "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.8",
-    "jazz-react": "workspace:0.9.8",
-    "jazz-tools": "workspace:0.9.8",
+    "jazz-browser-media-images": "workspace:0.9.23",
+    "jazz-react": "workspace:0.9.23",
+    "jazz-tools": "workspace:0.9.23",
     "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.8",
+    "jazz-run": "workspace:0.9.23",
     "postcss": "^8.4.27",
     "tailwindcss": "^3.4.15",
     "typescript": "~5.6.2",

examples/reactions/CHANGELOG.md

@@ -1,5 +1,133 @@
 # reactions
 
+## 0.0.41
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+- jazz-browser-media-images@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-browser-media-images@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-browser-media-images@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.32
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-browser-media-images@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.31
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+- jazz-browser-media-images@0.9.13
+
+## 0.0.30
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+- jazz-browser-media-images@0.9.12
+
+## 0.0.29
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+- jazz-browser-media-images@0.9.11
+
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.27
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.26
 
 ### Patch Changes

examples/reactions/README.md

@@ -2,30 +2,56 @@
 
 Live version: [https://reactions-demo.jazz.tools](https://reactions-demo.jazz.tools)
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example reactions --project-name reactions
 ```
 
-Go to the reactions example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/reactions
+cd reactions
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/reactions/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/reactions/package.json

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

examples/todo-vue/CHANGELOG.md

@@ -1,5 +1,133 @@
 # todo-vue
 
+## 0.0.46
+
+### Patch Changes
+
+- jazz-browser@0.9.23
+- jazz-tools@0.9.23
+- jazz-vue@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-browser@0.9.16
+  - jazz-vue@0.9.16
+
+## 0.0.38
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-browser@0.9.15
+  - jazz-vue@0.9.15
+
+## 0.0.37
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-browser@0.9.14
+  - jazz-vue@0.9.14
+
+## 0.0.36
+
+### Patch Changes
+
+- jazz-browser@0.9.13
+- jazz-tools@0.9.13
+- jazz-vue@0.9.13
+
+## 0.0.35
+
+### Patch Changes
+
+- jazz-browser@0.9.12
+- jazz-tools@0.9.12
+- jazz-vue@0.9.12
+
+## 0.0.34
+
+### Patch Changes
+
+- jazz-browser@0.9.11
+- jazz-tools@0.9.11
+- jazz-vue@0.9.11
+
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-tools@0.9.10
+  - jazz-browser@0.9.10
+  - jazz-vue@0.9.10
+
+## 0.0.32
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser@0.9.9
+  - jazz-vue@0.9.9
+
 ## 0.0.31
 
 ### Patch Changes

examples/todo-vue/README.md

@@ -1,29 +1,55 @@
 # Todo list example with Jazz and Vue
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example todo-vue --project-name todo-vue
 ```
 
-Go to the todo-vue example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/todo-vue
+cd todo-vue
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/todo-vue/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/todo-vue/package.json

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

examples/todo/CHANGELOG.md

@@ -1,5 +1,118 @@
 # jazz-example-todo
 
+## 0.0.160
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.152
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.151
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.150
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+
+## 0.0.149
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+
+## 0.0.148
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+
+## 0.0.147
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+
+## 0.0.146
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.145
 
 ### Patch Changes

examples/todo/README.md

@@ -2,30 +2,56 @@
 
 Live version: https://todo-demo.jazz.tools/
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example todo --project-name todo
 ```
 
-Go to the todo example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/todo
+cd todo
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/todo/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Structure
 
 -   [`src/basicComponents`](./src/basicComponents): simple components to build the UI, unrelated to Jazz (uses [shadcn/ui](https://ui.shadcn.com))

examples/todo/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-todo",
   "private": true,
-  "version": "0.0.145",
+  "version": "0.0.160",
   "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.8",
-    "jazz-tools": "workspace:0.9.8",
+    "jazz-react": "workspace:0.9.23",
+    "jazz-tools": "workspace:0.9.23",
     "lucide-react": "^0.274.0",
     "qrcode": "^1.5.3",
     "react": "^18.3.1",

examples/version-history/CHANGELOG.md

@@ -1,5 +1,118 @@
 # version-history
 
+## 0.0.38
+
+### Patch Changes
+
+- jazz-react@0.9.23
+- jazz-tools@0.9.23
+
+## 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
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-react@0.9.16
+
+## 0.0.30
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react@0.9.15
+
+## 0.0.29
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react@0.9.14
+
+## 0.0.28
+
+### Patch Changes
+
+- jazz-react@0.9.13
+- jazz-tools@0.9.13
+
+## 0.0.27
+
+### Patch Changes
+
+- jazz-react@0.9.12
+- jazz-tools@0.9.12
+
+## 0.0.26
+
+### Patch Changes
+
+- jazz-react@0.9.11
+- jazz-tools@0.9.11
+
+## 0.0.25
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+
+## 0.0.24
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+
 ## 0.0.23
 
 ### Patch Changes

examples/version-history/README.md

@@ -2,30 +2,56 @@
 
 A minimal example showing how to use Jazz's built-in version history to show and restore changes.
 
-## Installing & running the example locally
+## Getting started
 
-(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+You can either
+1. Clone the jazz repository, and run the app within the monorepo.
+2. Or create a new Jazz project using this example as a template.
 
-Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
 ```bash
-npx degit gardencmp/jazz jazz
+npx create-jazz-app@latest --example version-history --project-name version-history
 ```
 
-Go to the version-history example directory:
+Go to the new project directory.
 ```bash
-cd jazz/examples/version-history
+cd version-history
 ```
 
-Install and build dependencies:
+Run the dev server.
+```bash
+npm run dev
+```
+
+### Using the monorepo
+
+This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
+
+Clone the jazz repository.
+```bash
+git clone https://github.com/garden-co/jazz.git
+```
+
+Install and build dependencies.
 ```bash
 pnpm i && npx turbo build
 ```
 
-Start the dev server:
+Go to the example directory.
+```bash
+cd jazz/examples/version-history/
+```
+
+Start the dev server.
 ```bash
 pnpm dev
 ```
 
+Open [http://localhost:5173](http://localhost:5173) with your browser to see the result.
+
 ## Questions / problems / feedback
 
 If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.

examples/version-history/package.json

@@ -1,7 +1,7 @@
 {
   "name": "version-history",
   "private": true,
-  "version": "0.0.23",
+  "version": "0.0.38",
   "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/Copyright.tsx

@@ -0,0 +1,13 @@
+export function Copyright({
+  className,
+  companyName = "Garden Computing, Inc.",
+}: {
+  companyName?: string;
+  className?: string;
+}) {
+  return (
+    <p className={className}>
+      © {new Date().getFullYear()} {companyName}
+    </p>
+  );
+}

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/design-system/src/app/components/organisms/Footer.tsx

@@ -4,6 +4,7 @@ import clsx from "clsx";
 import Link from "next/link";
 import { usePathname } from "next/navigation";
 import { ComponentType, ReactNode } from "react";
+import { Copyright } from "../atoms/Copyright";
 import { NewsletterForm } from "./NewsletterForm";
 import { SocialLinks, SocialLinksProps } from "./SocialLinks";
 
@@ -18,29 +19,13 @@ type FooterSection = {
 
 type FooterProps = {
   logo: ReactNode;
-  companyName: string;
   sections: FooterSection[];
   socials: SocialLinksProps;
   themeToggle: ComponentType<{ className?: string }>;
 };
 
-function Copyright({
-  className,
-  companyName,
-}: {
-  companyName: string;
-  className?: string;
-}) {
-  return (
-    <p className={clsx(className, "text-sm")}>
-      © {new Date().getFullYear()} {companyName}
-    </p>
-  );
-}
-
 export function Footer({
   logo,
-  companyName,
   sections,
   socials,
   themeToggle: ThemeToggle,
@@ -82,10 +67,7 @@ export function Footer({
             </div>
           ))}
 
-          <Copyright
-            className="order-last col-span-full self-center md:col-span-10 md:order-none"
-            companyName={companyName}
-          />
+          <Copyright className="text-sm order-last col-span-full self-center md:col-span-10 md:order-none" />
 
           <div className="col-span-full flex items-center justify-between gap-6 md:col-span-2">
             <SocialLinks {...socials}></SocialLinks>

homepage/gcmp/app/layout.tsx

@@ -9,6 +9,7 @@ import { GcmpNav } from "@/components/Nav";
 import { ThemeToggle } from "@/components/ThemeToggle";
 import { Analytics } from "@vercel/analytics/react";
 import { SpeedInsights } from "@vercel/speed-insights/next";
+import { Copyright } from "gcmp-design-system/src/app/components/atoms/Copyright";
 
 // If loading a variable font, you don't need to specify the font weight
 const manrope = Manrope({
@@ -98,7 +99,7 @@ export default function RootLayout({
           <GcmpNav />
           <main className="flex-1 w-full">{children}</main>
           <footer className="py-8 text-sm flex justify-between gap-3 w-full container mt-12 md:mt-20">
-            <p>©2024 Garden Computing, Inc.</p>
+            <Copyright />
 
             <ThemeToggle className="hidden md:block" />
           </footer>

homepage/gcmp/app/team/page.tsx

@@ -61,14 +61,6 @@ const team: Array<TeamMember> = [
     location: "Portsmouth, UK ",
     github: "bensleveritt",
   },
-  {
-    name: "Marina Orlova",
-    titles: ["Full-Stack Dev"],
-    location: "Tarragona, Spain ",
-    linkedin: "marina-orlova-52a34394",
-    github: "marinoska",
-    image: "marina.jpeg",
-  },
   {
     name: "Giordano Ricci",
     titles: ["Full-Stack Dev", "DevOps"],

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/app/docs/[framework]/[...slug]/project-setup/react-native.mdx

@@ -240,24 +240,77 @@ In the demos, you'll find details on:
 
 ### Working with Images
 
-To work with images in Jazz, import the `createImage` function from [`jazz-react-native-media-images`](https://github.com/garden-co/jazz/tree/main/packages/jazz-react-native-media-images).
+Jazz provides a complete solution for handling images in React Native, including uploading, processing, and displaying them. Here's how to work with images:
+
+#### Uploading Images
+
+To upload images, use the `createImage` function from `jazz-react-native-media-images`. This function handles image processing and creates an `ImageDefinition` that can be stored in your Jazz covalues:
 
 <CodeGroup>
   ```tsx
   import { createImage } from "jazz-react-native-media-images";
+  import * as ImagePicker from 'expo-image-picker';
 
-  const base64ImageDataURI = "data:image/png;base64,...";
+  // Example: Image upload from device library
+  const handleImageUpload = async () => {
+    try {
+      const result = await ImagePicker.launchImageLibraryAsync({
+        mediaTypes: ImagePicker.MediaTypeOptions.Images,
+        base64: true,  // Important: We need base64 data
+        quality: 0.7,
+      });
 
-  const image = await createImage(base64ImageDataURI, {
-    owner: newPetPost._owner,
-    maxSize: 2048, // optional: specify maximum image size
-  });
+      if (!result.canceled && result.assets[0].base64) {
+        const base64Uri = `data:image/jpeg;base64,${result.assets[0].base64}`;
 
-  someCovalue.image = image;
+        const image = await createImage(base64Uri, {
+          owner: someCovalue._owner,  // Set appropriate owner
+          maxSize: 2048,  // Optional: limit maximum image size
+        });
+
+        // Store the image in your covalue
+        someCovalue.image = image;
+      }
+    } catch (error) {
+      console.error('Failed to upload image:', error);
+    }
+  };
   ```
 </CodeGroup>
 
-For a complete implementation, please refer to [this](https://github.com/garden-co/jazz/blob/main/examples/pets/src/3_NewPetPostForm.tsx) demo.
+#### Displaying Images
+
+To display images, use the `ProgressiveImg` component from `jazz-react-native`. This component handles both images uploaded from React Native and desktop browsers:
+
+<CodeGroup>
+  ```tsx
+  import { ProgressiveImg } from "jazz-react-native";
+  import { Image } from "react-native";
+
+  // Inside your render function:
+  <ProgressiveImg image={someCovalue.image} maxWidth={1024}>
+    {({ src, res, originalSize }) => (
+      <Image
+        source={{ uri: src }}
+        style={{
+          width: 300,  // Adjust size as needed
+          height: 300,
+          borderRadius: 8,
+        }}
+        resizeMode="cover"
+      />
+    )}
+  </ProgressiveImg>
+  ```
+</CodeGroup>
+
+The `ProgressiveImg` component:
+- Automatically handles different image formats
+- Provides progressive loading with placeholder images
+- Supports different resolutions based on the `maxWidth` prop
+- Works seamlessly with React Native's `Image` component
+
+For a complete implementation example, see the [Chat Example](https://github.com/garden-co/jazz/blob/main/examples/chat-rn-clerk/app/chat/[chatId].tsx).
 
 ### Running your app
 

homepage/homepage/app/docs/[framework]/[...slug]/schemas/accounts-and-migrations.mdx

@@ -132,7 +132,7 @@ As you develop your app, you'll likely want to
 - initialise data in a user's `root` and `profile`
 - add more data to your `root` and `profile` schemas
 
-You can achieve both by overriding the static `migrate()` method on your `Account` schema class.
+You can achieve both by overriding the `migrate()` method on your `Account` schema class.
 
 ### When migrations run
 

homepage/homepage/app/docs/[framework]/[...slug]/upgrade/0-9-8.mdx

@@ -0,0 +1,74 @@
+import { ContentByFramework, CodeGroup } from '@/components/forMdx'
+
+export const metadata = { title: "Upgrade to Jazz 0.9.0" };
+
+# Jazz 0.9.8 - Without me!
+
+<h2 className="not-prose text-sm text-stone-600 dark:text-stone-400 mb-5 pb-2 border-b">
+  14 January 2025
+</h2>
+
+<div>
+  We have simplified the API to make the "me" value always optional!
+
+  This removes the need of using `useAccount` like the 90% of the time!
+</div>
+
+<CodeGroup>
+    {/* prettier-ignore */}
+    ```ts
+    import { useState } from "react"; 
+    import { Issue } from "./schema"; 
+    import { IssueComponent } from "./components/Issue.tsx"; 
+    function App() {
+        const [issue, setIssue] = useState<Issue>(); 
+        
+        const createIssue = () => {
+            setIssue(Issue.create(
+                {
+                    title: "Buy terrarium",
+                    description: "Make sure it's big enough for 10 snails.",
+                    estimate: 5,
+                    status: "backlog",
+                }, // The owner defaults now to a group managed by the current user!
+            ));
+        };
+        
+        if (issue) {
+            return <IssueComponent issue={issue} />; 
+        } else { 
+            return <button onClick={createIssue}>Create Issue</button>;
+        } 
+    } 
+    ```
+</CodeGroup>
+
+<div>
+  This also applies to the load API:
+</div>
+
+<CodeGroup>
+  {/* prettier-ignore */}
+  ```ts
+  const issue = Issue.load(issueId, {})
+  ```
+</CodeGroup>
+
+<div>
+  And `Group.create`:
+</div>
+
+<CodeGroup>
+    {/* prettier-ignore */}
+    ```tsx
+    const group = Group.create()
+    const sharedIssue = Issue.create(payload, group)
+    group.addMember('everyone', 'reader')
+    ```
+</CodeGroup>
+
+<div>
+Everything is backward compatible, so no upgrade steps are required.
+
+With this Jazz API becomes way more lean and more is coming!
+</div>

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

@@ -7,9 +7,10 @@ The Jazz docs are currently heavily work in progress, sorry about that!
 ## Quickstart
 
 Run the following command to create a new Jazz project from one of our example apps:
+
 <CodeGroup>
 ```sh
-npx create-jazz-app
+npx create-jazz-app@latest
 ```
 </CodeGroup>
 
@@ -38,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";
 
@@ -13,7 +13,9 @@ export function DocNav({ className }: { className?: string }) {
     return {
       ...headerItem,
       items: headerItem.items
-        .filter((item) => !item.framework || item.framework === framework)
+        .filter(
+          (item) => !("framework" in item) || item.framework === framework,
+        )
         .map((item) => {
           if (!item.href?.startsWith("/docs")) return item;
 

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/footer.tsx

@@ -7,7 +7,6 @@ export function JazzFooter() {
   return (
     <Footer
       logo={<GcmpLogo monochrome className="w-36" />}
-      companyName="Garden Computing, Inc."
       socials={socials}
       themeToggle={ThemeToggle}
       sections={[

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,22 +1,7 @@
 import { Application } from "typedoc";
+import { PACKAGES } from "./utils/config.mjs";
 
-for (const { packageName, entryPoint, tsconfig, typedocOptions } of [
-  {
-    packageName: "jazz-tools",
-    entryPoint: "index.web.ts",
-    tsconfig: "tsconfig.web.json",
-  },
-  {
-    packageName: "jazz-react",
-    entryPoint: "index.tsx",
-    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/lib/docNavigationItems.js

@@ -50,16 +50,27 @@ export const docNavigationItems = [
         href: "/docs/project-setup/server-side",
         done: 80,
       },
+    ],
+  },
+  {
+    name: "Updates",
+    items: [
       {
         // upgrade guides
-        name: "Enable local persistence",
+        name: "Jazz 0.9.8 - Without me!",
+        href: "/docs/upgrade/0-9-8",
+        done: 100,
+      },
+      {
+        // upgrade guides
+        name: "Jazz 0.9.2 - Local persistence on React Native",
         href: "/docs/upgrade/react-native-local-persistence",
         done: 100,
         framework: "react-native",
       },
       {
         // upgrade guides
-        name: "Upgrade to Jazz 0.9.0",
+        name: "Jazz 0.9.0 - Upgrade guide",
         href: "/docs/upgrade/0-9-0",
         done: 100,
       },