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

Version Packages

.github/workflows/build-examples.yaml

@@ -10,15 +10,9 @@ jobs:
     strategy:
       matrix:
         example: [
-          "chat",
+          "passkey-svelte",
-          "clerk",
+          "chat-svelte",
-          "passkey",
+          "file-share-svelte",
-          "inspector",
-          "music-player",
-          "password-manager",
-          "pets",
-          "reactions",
-          "todo",
         ]
 
     steps:

.github/workflows/build-starters.yaml

@@ -1,26 +0,0 @@
-name: Build Starters
-
-on:
-  push:
-    branches: ["main"]
-
-jobs:
-  build-starters:
-    runs-on: blacksmith-4vcpu-ubuntu-2204
-    strategy:
-      matrix:
-        starter: ["react-passkey-auth"]
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: true
-
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
-
-      - name: Pnpm Build
-        run: |
-          pnpm install
-          pnpm turbo build;
-        working-directory: ./starters/${{ matrix.starter }}

.github/workflows/playwright-homepage.yml

@@ -22,6 +22,9 @@ jobs:
       - name: Setup Source Code
         uses: ./.github/actions/source-code/
 
+      - name: Install root dependencies
+        run: pnpm install && pnpm turbo build
+
       - name: Install project dependencies
         run: pnpm install
         working-directory: ./${{ matrix.project }}

.github/workflows/playwright.yml

@@ -13,7 +13,21 @@ jobs:
     continue-on-error: true
     strategy:
       matrix:
-        project: ["tests/e2e", "examples/chat",  "examples/clerk", "examples/betterauth", "examples/file-share-svelte", "examples/form", "examples/music-player", "examples/organization", "examples/pets", "starters/react-passkey-auth"]
+        project: [
+          "tests/e2e",
+          "examples/chat",
+          "examples/clerk",
+          "examples/betterauth",
+          "examples/file-share-svelte",
+          "examples/form",
+          "examples/inspector",
+          "examples/music-player",
+          "examples/organization",
+          "examples/pets",
+          "starters/react-passkey-auth",
+          "starters/svelte-passkey-auth",
+          "packages/jazz-svelte"
+        ]
 
     steps:
       - uses: actions/checkout@v4
@@ -24,7 +38,11 @@ jobs:
         uses: ./.github/actions/source-code/
 
       - name: Pnpm Build
-        run: pnpm turbo build
+        run: |
+          if [ -f .env.test ]; then
+            cp .env.test .env
+          fi
+          pnpm turbo build
         working-directory: ./${{ matrix.project }}
 
       - name: Install Playwright Browsers

biome.json

@@ -13,6 +13,7 @@
       "**/android/**",
       "packages/jazz-svelte/**",
       "examples/*svelte*/**",
+      "starters/*svelte*/**",
       "examples/jazz-paper-scissors/src/routeTree.gen.ts",
       "homepage/homepage/**",
       "**/package.json"

examples/betterauth/.gitignore

@@ -36,8 +36,10 @@ yarn-error.log*
 .pnpm-debug.log*
 
 # env files (can opt-in for committing if needed)
-.env*
+.env
-!.env
+.env.*
+!.env.example
+!.env.test
 
 # vercel
 .vercel

examples/betterauth/README.md

@@ -5,10 +5,12 @@ This example demonstrates how to integrate [Better Auth](https://www.better-auth
 ## Getting started
 
 To run this example, you may either:
-* Clone the Jazz monorepo and run this example from within.
+
-* Create a new Jazz project using this example as a template, and run that new project.
+- Clone the Jazz monorepo and run this example from within.
+- Create a new Jazz project using this example as a template, and run that new project.
 
 ### Setting environment variables
+
 - `NEXT_PUBLIC_AUTH_BASE_URL`: A URL to a Better Auth server. If undefined, the example will self-host a Better Auth server.
 - `BETTER_AUTH_SECRET`: The encryption secret used by the self-hosted Better Auth server (required only if `NEXT_PUBLIC_AUTH_BASE_URL` is undefined)
 - `GITHUB_CLIENT_ID`: The client ID for the GitHub OAuth provider used by the self-hosted Better Auth server (required only if `NEXT_PUBLIC_AUTH_BASE_URL` is undefined)
@@ -17,36 +19,62 @@ To run this example, you may either:
 ### Using this example as a template
 
 1. Create a new Jazz project, and use this example as a template.
+
 ```sh
 npx create-jazz-app@latest betterauth-app --example betterauth
 ```
-2. Navigate to the new project and start the development server.
+
+2. Navigate to the new project and install dependencies.
+
 ```sh
 cd betterauth-app
 pnpm install
+```
+
+3. Create a .env file (don't forget to set your [BETTER_AUTH_SECRET](https://www.better-auth.com/docs/installation#set-environment-variables)!)
+
+```sh
+mv .env.example .env
+```
+
+4. Start the development server
+
+```sh
 pnpm dev
 ```
 
+https://www.better-auth.com/docs/installation#set-environment-variables
+
 ### 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
 ```
 
 Go to the example directory.
+
 ```bash
 cd jazz/examples/betterauth/
 ```
 
+Create a .env file (don't forget to set your [BETTER_AUTH_SECRET](https://www.better-auth.com/docs/installation#set-environment-variables)!)
+
+```sh
+mv .env.example .env
+```
+
 Start the dev server.
+
 ```bash
 pnpm dev
 ```

examples/betterauth/package.json

@@ -1,6 +1,5 @@
 {
 	"name": "betterauth",
-	"version": "0.1.25",
 	"private": true,
 	"type": "module",
 	"scripts": {

examples/chat-rn-expo-clerk/.env

@@ -1 +0,0 @@
-EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_ZXZpZGVudC1kYW5lLTg5LmNsZXJrLmFjY291bnRzLmRldiQ

examples/chat-rn-expo-clerk/.env.example

@@ -0,0 +1 @@
+EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY=

examples/chat-rn-expo-clerk/.gitignore

@@ -15,3 +15,9 @@ web-build/
 
 ios
 android
+
+# Env
+.env
+.env.*
+!.env.example
+!.env.test

examples/chat-rn-expo-clerk/README.md

@@ -8,9 +8,12 @@ First, install dependencies and build the project:
 
 ```bash
 pnpm i
+mv .env.example .env
 pnpm run build
 ```
 
+Don't forget to update `VITE_CLERK_PUBLISHABLE_KEY` in `.env` with your [Publishable Key](https://clerk.com/docs/deployments/clerk-environment-variables#clerk-publishable-and-secret-keys) from Clerk.
+
 ### 2. Inside the `examples/chat-rn-expo-clerk` Directory
 
 Next, navigate to the specific example project and run the following commands:

examples/chat-rn-expo-clerk/package.json

@@ -1,7 +1,6 @@
 {
   "name": "chat-rn-expo-clerk",
   "main": "index.js",
-  "version": "1.0.145",
   "scripts": {
     "build": "expo export -p ios",
     "start": "expo start",
@@ -17,7 +16,6 @@
     "@bacons/text-decoder": "0.0.0",
     "@bam.tech/react-native-image-resizer": "^3.0.11",
     "@clerk/clerk-expo": "^2.2.21",
-    "@craftzdog/react-native-buffer": "6.0.5",
     "@expo/vector-icons": "^14.1.0",
     "@react-native-community/netinfo": "11.4.1",
     "@react-navigation/native": "7.0.19",

examples/chat-rn-expo-clerk/polyfills.js

@@ -3,9 +3,6 @@
 // @ts-expect-error - @types/react-native doesn't cover this file
 import { polyfillGlobal } from "react-native/Libraries/Utilities/PolyfillFunctions";
 
-import { Buffer } from "@craftzdog/react-native-buffer";
-polyfillGlobal("Buffer", () => Buffer);
-
 // @ts-expect-error - @types/readable-stream doesn't have ReadableStream type
 import { ReadableStream } from "readable-stream";
 polyfillGlobal("ReadableStream", () => ReadableStream);

examples/chat-rn-expo/.gitignore

@@ -37,3 +37,8 @@ yarn-error.*
 *.tsbuildinfo
 android/
 ios/
+# env files
+.env
+.env.*
+!.env.example
+!.env.test

examples/chat-rn-expo/package.json

@@ -1,6 +1,5 @@
 {
   "name": "chat-rn-expo",
-  "version": "1.0.13",
   "main": "index.ts",
   "scripts": {
     "build": "expo prebuild",
@@ -12,7 +11,7 @@
   "dependencies": {
     "@azure/core-asynciterator-polyfill": "^1.0.2",
     "@bacons/text-decoder": "^0.0.0",
-    "@craftzdog/react-native-buffer": "^6.0.5",
+    "@bam.tech/react-native-image-resizer": "^3.0.11",
     "@react-native-community/netinfo": "11.4.1",
     "expo": "~53.0.9",
     "expo-clipboard": "^7.1.4",

examples/chat-rn-expo/polyfills.ts

@@ -3,9 +3,6 @@
 // @ts-expect-error - @types/react-native doesn't cover this file
 import { polyfillGlobal } from "react-native/Libraries/Utilities/PolyfillFunctions";
 
-import { Buffer } from "@craftzdog/react-native-buffer";
-polyfillGlobal("Buffer", () => Buffer);
-
 // @ts-expect-error - @types/readable-stream doesn't have ReadableStream type
 import { ReadableStream } from "readable-stream";
 polyfillGlobal("ReadableStream", () => ReadableStream);

examples/chat-rn-expo/src/chat.tsx

@@ -128,7 +128,11 @@ export default function ChatScreen() {
             }}
             testID="chat-id-input"
           />
-          <TouchableOpacity onPress={joinChat} style={styles.joinChatButton}>
+          <TouchableOpacity
+            testID="join-chat-button"
+            onPress={joinChat}
+            style={styles.joinChatButton}
+          >
             <Text style={styles.newChatButtonText}>Join chat</Text>
           </TouchableOpacity>
         </View>

examples/chat-rn-expo/test/e2e/flow.yml

@@ -41,12 +41,17 @@ appId: tools.jazz.chatrnexpo
 # logout
 - tapOn: "Logout"
 - assertVisible: "Username"
-- assertVisible: "Anonymous user"
 
+- extendedWaitUntil:
+    visible: "Anonymous user"
+    timeout: 10000
 # join chat 
+
+## Commented because it fails on CI
 # - tapOn:
 #     id: "chat-id-input"
 # - inputText: "co_zFs6KFyhxPw4xtw83tcEMzeHUNv" # Use a static id because maestro doesn't have access to the system clipboard
-# - tapOn: "Join chat"
+# - tapOn:
+#     id: "join-chat-button"
 # - assertVisible: "boorad"
 # - assertVisible: "bro, low key, it do be like that tho"

examples/chat-rn-expo/test/e2e/runLocal.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+# This script is necessary, because unlike ios, the android emulator action
+# accepts a script, runs it as your tests, then terminates.
+
+set -e
+
+# run the e2e tests
+export PATH="$PATH":"$HOME/.maestro/bin"
+export MAESTRO_DRIVER_STARTUP_TIMEOUT=300000 # setting to 5 mins 👀
+export MAESTRO_CLI_NO_ANALYTICS=1
+export MAESTRO_CLI_ANALYSIS_NOTIFICATION_DISABLED=true
+maestro test test/e2e/flow.yml

examples/chat-rn/.gitignore

@@ -73,3 +73,9 @@ yarn-error.log
 !.yarn/releases
 !.yarn/sdks
 !.yarn/versions
+
+# env files
+.env
+.env.*
+!.env.example
+!.env.test

examples/chat-rn/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-rn",
-  "version": "1.0.140",
+  "private": true,
   "main": "index.js",
   "scripts": {
     "android": "react-native run-android",
@@ -12,7 +12,6 @@
   "dependencies": {
     "@azure/core-asynciterator-polyfill": "^1.0.2",
     "@bacons/text-decoder": "0.0.0",
-    "@craftzdog/react-native-buffer": "6.0.5",
     "@op-engineering/op-sqlite": "^11.4.8",
     "@react-native-clipboard/clipboard": "1.16.1",
     "@react-native-community/netinfo": "11.4.1",

examples/chat-rn/src/polyfills.ts

@@ -4,9 +4,6 @@
 import { polyfillGlobal } from "react-native/Libraries/Utilities/PolyfillFunctions";
 // import 'react-native-polyfill-globals/auto';
 
-import { Buffer } from "@craftzdog/react-native-buffer";
-polyfillGlobal("Buffer", () => Buffer);
-
 // @ts-expect-error - @types/readable-stream doesn't have ReadableStream type
 import { ReadableStream } from "readable-stream";
 polyfillGlobal("ReadableStream", () => ReadableStream);

examples/chat-svelte/.gitignore

@@ -0,0 +1,21 @@
+node_modules
+
+# Output
+.output
+.vercel
+/.svelte-kit
+/build
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Env
+.env
+.env.*
+!.env.example
+!.env.test
+
+# Vite
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*

examples/chat-svelte/.npmrc

@@ -0,0 +1 @@
+engine-strict=true

examples/chat-svelte/.prettierignore

@@ -0,0 +1,4 @@
+# Package Managers
+package-lock.json
+pnpm-lock.yaml
+yarn.lock

examples/chat-svelte/.prettierrc

@@ -0,0 +1,16 @@
+{
+  "useTabs": false,
+  "tabWidth": 2,
+  "singleQuote": true,
+  "trailingComma": "none",
+  "printWidth": 100,
+  "plugins": ["prettier-plugin-svelte"],
+  "overrides": [
+    {
+      "files": "*.svelte",
+      "options": {
+        "parser": "svelte"
+      }
+    }
+  ]
+}

examples/chat-svelte/CHANGELOG.md

@@ -0,0 +1,554 @@
+# passkey-svelte
+
+## 0.0.86
+
+### Patch Changes
+
+- Updated dependencies [e35a380]
+  - jazz-svelte@0.14.26
+  - jazz-tools@0.14.26
+  - jazz-browser-media-images@0.14.26
+
+## 0.0.85
+
+### Patch Changes
+
+- Updated dependencies [99a2d9b]
+  - jazz-tools@0.14.25
+  - jazz-browser-media-images@0.14.25
+  - jazz-svelte@0.14.25
+
+## 0.0.84
+
+### Patch Changes
+
+- jazz-svelte@0.13.30
+- jazz-tools@0.13.30
+
+## 0.0.83
+
+### Patch Changes
+
+- jazz-svelte@0.13.29
+- jazz-tools@0.13.29
+
+## 0.0.82
+
+### Patch Changes
+
+- jazz-svelte@0.13.28
+- jazz-tools@0.13.28
+
+## 0.0.81
+
+### Patch Changes
+
+- jazz-svelte@0.13.27
+- jazz-tools@0.13.27
+
+## 0.0.80
+
+### Patch Changes
+
+- Updated dependencies [ff846d9]
+  - jazz-tools@0.13.26
+  - jazz-svelte@0.13.26
+
+## 0.0.79
+
+### Patch Changes
+
+- jazz-svelte@0.13.25
+- jazz-tools@0.13.25
+
+## 0.0.78
+
+### Patch Changes
+
+- Updated dependencies [ec546b4]
+  - jazz-svelte@0.13.24
+
+## 0.0.77
+
+### Patch Changes
+
+- Updated dependencies [3431076]
+- Updated dependencies [02a240c]
+  - jazz-svelte@0.13.23
+  - jazz-tools@0.13.23
+
+## 0.0.76
+
+### Patch Changes
+
+- jazz-svelte@0.13.21
+- jazz-tools@0.13.21
+
+## 0.0.75
+
+### Patch Changes
+
+- Updated dependencies [439f0fe]
+  - jazz-tools@0.13.20
+  - jazz-svelte@0.13.20
+
+## 0.0.74
+
+### Patch Changes
+
+- Updated dependencies [80530a4]
+  - jazz-tools@0.13.19
+  - jazz-svelte@0.13.19
+
+## 0.0.73
+
+### Patch Changes
+
+- Updated dependencies [761759c]
+  - jazz-tools@0.13.18
+  - jazz-svelte@0.13.18
+
+## 0.0.72
+
+### Patch Changes
+
+- jazz-svelte@0.13.17
+- jazz-tools@0.13.17
+
+## 0.0.71
+
+### Patch Changes
+
+- jazz-svelte@0.13.16
+- jazz-tools@0.13.16
+
+## 0.0.70
+
+### Patch Changes
+
+- jazz-svelte@0.13.15
+- jazz-tools@0.13.15
+
+## 0.0.69
+
+### Patch Changes
+
+- jazz-svelte@0.13.14
+- jazz-tools@0.13.14
+
+## 0.0.68
+
+### Patch Changes
+
+- jazz-svelte@0.13.13
+- jazz-tools@0.13.13
+
+## 0.0.67
+
+### Patch Changes
+
+- Updated dependencies [4547525]
+  - jazz-tools@0.13.12
+  - jazz-svelte@0.13.12
+
+## 0.0.66
+
+### Patch Changes
+
+- Updated dependencies [17273a6]
+  - jazz-tools@0.13.11
+  - jazz-svelte@0.13.11
+
+## 0.0.65
+
+### Patch Changes
+
+- jazz-svelte@0.13.10
+- jazz-tools@0.13.10
+
+## 0.0.64
+
+### Patch Changes
+
+- Updated dependencies [a6cf01f]
+  - jazz-tools@0.13.9
+  - jazz-svelte@0.13.9
+
+## 0.0.63
+
+### Patch Changes
+
+- jazz-svelte@0.13.7
+
+## 0.0.62
+
+### Patch Changes
+
+- jazz-svelte@0.13.5
+
+## 0.0.61
+
+### Patch Changes
+
+- jazz-svelte@0.13.4
+
+## 0.0.60
+
+### Patch Changes
+
+- jazz-svelte@0.13.3
+
+## 0.0.59
+
+### Patch Changes
+
+- jazz-svelte@0.13.2
+
+## 0.0.58
+
+### Patch Changes
+
+- jazz-svelte@0.13.0
+
+## 0.0.57
+
+### Patch Changes
+
+- jazz-svelte@0.12.2
+
+## 0.0.56
+
+### Patch Changes
+
+- jazz-svelte@0.12.1
+
+## 0.0.55
+
+### Patch Changes
+
+- jazz-svelte@0.12.0
+
+## 0.0.54
+
+### Patch Changes
+
+- jazz-svelte@0.11.8
+
+## 0.0.53
+
+### Patch Changes
+
+- jazz-svelte@0.11.7
+
+## 0.0.52
+
+### Patch Changes
+
+- 1bfa9bb: Removed when="singedUp" from examples apps' Jazz providers. This is a really niche use-case option and can lead to broken-feeling experiences when anonymous users try to load something.
+  - jazz-svelte@0.11.6
+
+## 0.0.51
+
+### Patch Changes
+
+- jazz-svelte@0.11.5
+
+## 0.0.50
+
+### Patch Changes
+
+- jazz-svelte@0.11.4
+
+## 0.0.49
+
+### Patch Changes
+
+- jazz-svelte@0.11.3
+
+## 0.0.48
+
+### Patch Changes
+
+- jazz-svelte@0.11.2
+
+## 0.0.47
+
+### Patch Changes
+
+- jazz-svelte@0.11.0
+
+## 0.0.46
+
+### Patch Changes
+
+- jazz-svelte@0.10.15
+
+## 0.0.45
+
+### Patch Changes
+
+- jazz-svelte@0.10.14
+
+## 0.0.44
+
+### Patch Changes
+
+- jazz-svelte@0.10.13
+
+## 0.0.43
+
+### Patch Changes
+
+- Updated dependencies [4612e05]
+  - jazz-svelte@0.10.12
+
+## 0.0.42
+
+### Patch Changes
+
+- jazz-svelte@0.10.9
+
+## 0.0.41
+
+### Patch Changes
+
+- jazz-svelte@0.10.8
+
+## 0.0.40
+
+### Patch Changes
+
+- Updated dependencies [1136d9b]
+  - jazz-svelte@0.10.7
+
+## 0.0.39
+
+### Patch Changes
+
+- jazz-svelte@0.10.6
+
+## 0.0.38
+
+### Patch Changes
+
+- jazz-svelte@0.10.5
+
+## 0.0.37
+
+### Patch Changes
+
+- jazz-svelte@0.10.4
+
+## 0.0.36
+
+### Patch Changes
+
+- jazz-svelte@0.10.3
+
+## 0.0.35
+
+### Patch Changes
+
+- jazz-svelte@0.10.2
+
+## 0.0.34
+
+### Patch Changes
+
+- jazz-svelte@0.10.1
+
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies [b426342]
+  - jazz-svelte@0.10.0
+
+## 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
+
+- jazz-svelte@0.9.8
+
+## 0.0.16
+
+### Patch Changes
+
+- jazz-svelte@0.9.1
+
+## 0.0.15
+
+### Patch Changes
+
+- Updated dependencies [9dd8d95]
+  - jazz-svelte@0.9.0
+
+## 0.0.14
+
+### Patch Changes
+
+- jazz-svelte@0.8.51
+
+## 0.0.13
+
+### Patch Changes
+
+- jazz-svelte@0.8.50
+
+## 0.0.12
+
+### Patch Changes
+
+- jazz-svelte@0.8.49
+
+## 0.0.11
+
+### Patch Changes
+
+- jazz-svelte@0.8.48
+
+## 0.0.10
+
+### Patch Changes
+
+- jazz-svelte@0.8.45
+
+## 0.0.9
+
+### Patch Changes
+
+- jazz-svelte@0.8.44
+
+## 0.0.8
+
+### Patch Changes
+
+- jazz-svelte@0.8.41
+
+## 0.0.7
+
+### Patch Changes
+
+- jazz-svelte@0.8.40
+
+## 0.0.6
+
+### Patch Changes
+
+- Updated dependencies [aa21072]
+  - jazz-svelte@0.8.39
+
+## 0.0.5
+
+### Patch Changes
+
+- jazz-svelte@0.8.38
+
+## 0.0.4
+
+### Patch Changes
+
+- jazz-svelte@0.0.4
+
+## 0.0.3
+
+### Patch Changes
+
+- jazz-svelte@0.0.3
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [0e59e65]
+  - jazz-svelte@0.0.2

examples/chat-svelte/README.md

@@ -0,0 +1,68 @@
+# Chat example with Jazz and Svelte
+
+## Getting started
+
+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.
+
+### Using the example as a template
+
+Create a new Jazz project, and use this example as a template.
+
+```bash
+npx create-jazz-app@latest chat-app --example chat-svelte
+```
+
+Go to the new project directory.
+
+```bash
+cd chat-app
+```
+
+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
+```
+
+Go to the example directory.
+
+```bash
+cd jazz/examples/chat-svelte/
+```
+
+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.
+
+## Configuration: sync server
+
+By default, the example app uses [Jazz Cloud](https://jazz.tools/cloud) (`wss://cloud.jazz.tools`) - so cross-device use, invites and collaboration should just work.
+
+You can also run a local sync server by running `npx jazz-run sync`, and setting the `sync` parameter of `JazzProvider` in [./src/routes/+layout.svelte](./src/routes/+layout.svelte) to `{ peer: "ws://localhost:4200" }`.

examples/chat-svelte/eslint.config.js

@@ -0,0 +1,33 @@
+import prettier from 'eslint-config-prettier';
+import js from '@eslint/js';
+import svelte from 'eslint-plugin-svelte';
+import globals from 'globals';
+import ts from 'typescript-eslint';
+
+export default ts.config(
+  js.configs.recommended,
+  ...ts.configs.recommended,
+  ...svelte.configs['flat/recommended'],
+  prettier,
+  ...svelte.configs['flat/prettier'],
+  {
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.node
+      }
+    }
+  },
+  {
+    files: ['**/*.svelte'],
+
+    languageOptions: {
+      parserOptions: {
+        parser: ts.parser
+      }
+    }
+  },
+  {
+    ignores: ['build/', '.svelte-kit/', 'dist/']
+  }
+);

examples/chat-svelte/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "chat-svelte",
+  "version": "0.0.86",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+    "format": "prettier --write .",
+    "lint": "prettier --check . && eslint .",
+    "format-and-lint": "pnpm run format && pnpm run lint",
+    "format-and-lint:fix": "pnpm run format --write && pnpm run lint --fix",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui"
+  },
+  "devDependencies": {
+    "@sveltejs/adapter-auto": "^3.3.1",
+    "@sveltejs/kit": "^2.21.1",
+    "@sveltejs/vite-plugin-svelte": "^5.0.3",
+    "@types/eslint": "^9.6.1",
+    "eslint": "^9.27.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-svelte": "^2.46.1",
+    "globals": "^15.15.0",
+    "jazz-inspector-element": "workspace:*",
+    "prettier": "^3.5.3",
+    "prettier-plugin-svelte": "^3.4.0",
+    "svelte": "^5.31.1",
+    "svelte-check": "^4.2.1",
+    "typescript": "5.6.2",
+    "typescript-eslint": "^8.32.1",
+    "vite": "6.0.11"
+  },
+  "dependencies": {
+    "@tailwindcss/vite": "^4.1.7",
+    "jazz-browser-media-images": "workspace:*",
+    "jazz-svelte": "workspace:*",
+    "jazz-tools": "workspace:*",
+    "tailwindcss": "^4.1.7"
+  }
+}

examples/chat-svelte/playwright.config.ts

@@ -0,0 +1,54 @@
+import { defineConfig, devices } from '@playwright/test';
+
+import isCI from 'is-ci';
+
+/**
+ * Read environment variables from file.
+ * https://github.com/motdotla/dotenv
+ */
+// import dotenv from 'dotenv';
+// dotenv.config({ path: path.resolve(__dirname, '.env') });
+
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ */
+export default defineConfig({
+  testDir: './tests',
+  /* Run tests in files in parallel */
+  fullyParallel: true,
+  /* Fail the build on CI if you accidentally left test.only in the source code. */
+  forbidOnly: isCI,
+  /* Retry on CI only */
+  retries: isCI ? 2 : 0,
+  /* Opt out of parallel tests on CI. */
+  workers: isCI ? 1 : undefined,
+  /* Reporter to use. See https://playwright.dev/docs/test-reporters */
+  reporter: 'html',
+
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  use: {
+    /* Base URL to use in actions like `await page.goto('/')`. */
+    baseURL: 'http://localhost:5173/',
+
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on-first-retry',
+    permissions: ['clipboard-read', 'clipboard-write']
+  },
+
+  /* Configure projects for major browsers */
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] }
+    }
+  ],
+
+  /* Run your local dev server before starting the tests */
+  webServer: [
+    {
+      command: 'pnpm preview --port 5173',
+      url: 'http://localhost:5173/',
+      reuseExistingServer: !isCI
+    }
+  ]
+});

examples/chat-svelte/src/apiKey.ts

@@ -0,0 +1 @@
+export const apiKey = 'svelte-chat-example@garden.co';

examples/chat-svelte/src/app.css

@@ -0,0 +1,21 @@
+@import 'tailwindcss';
+@theme {
+  --color-stone-50: oklch(0.988281 0.002 75);
+  --color-stone-75: oklch(0.980563 0.002 75);
+  --color-stone-100: oklch(0.964844 0.002 75);
+  --color-stone-200: oklch(0.917969 0.002 75);
+  --color-stone-300: oklch(0.853516 0.002 75);
+  --color-stone-400: oklch(0.789063 0.002 75);
+  --color-stone-500: oklch(0.726563 0.002 75);
+  --color-stone-600: oklch(0.613281 0.002 75);
+  --color-stone-700: oklch(0.523438 0.002 75);
+  --color-stone-800: oklch(0.412109 0.002 75);
+  --color-stone-900: oklch(0.302734 0.002 75);
+  --color-stone-925: oklch(0.22 0.002 75);
+  --color-stone-950: oklch(0.193359 0.002 75);
+  --color-blue: oklch(0.57 0.2346 261.2);
+}
+
+:focus {
+  @apply outline-hidden;
+}

examples/chat-svelte/src/app.d.ts

@@ -0,0 +1,13 @@
+// See https://svelte.dev/docs/kit/types#app.d.ts
+// for information about these interfaces
+declare global {
+  namespace App {
+    // interface Error {}
+    // interface Locals {}
+    // interface PageData {}
+    // interface PageState {}
+    // interface Platform {}
+  }
+}
+
+export {};

examples/chat-svelte/src/app.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" href="%sveltekit.assets%/jazz-icon.png" type="image/png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>

examples/chat-svelte/src/lib/components/AppContainer.svelte

@@ -0,0 +1,9 @@
+<script lang="ts">
+  let { children } = $props();
+</script>
+
+<div
+  class="flex flex-col justify-between w-screen h-screen bg-stone-50 dark:bg-stone-925 dark:text-white"
+>
+  {@render children()}
+</div>

examples/chat-svelte/src/lib/components/BubbleBody.svelte

@@ -0,0 +1,13 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  let { children, fromMe }: { children: Snippet; fromMe: boolean | undefined } = $props();
+</script>
+
+<div
+  class="line-clamp-10 text-ellipsis rounded-2xl overflow-hidden max-w-[calc(100%-5rem)] shadow-sm p-1 {fromMe
+    ? 'bg-white dark:bg-stone-900 dark:text-white'
+    : 'bg-blue text-white'}"
+>
+  {@render children()}
+</div>

examples/chat-svelte/src/lib/components/BubbleContainer.svelte

@@ -0,0 +1,9 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  let { children, fromMe }: { children: Snippet; fromMe: boolean | undefined } = $props();
+  const align = fromMe ? 'items-end' : 'items-start';
+</script>
+
+<div class="{align} flex flex-col m-3" role="row">
+  {@render children()}
+</div>

examples/chat-svelte/src/lib/components/BubbleImage.svelte

@@ -0,0 +1,12 @@
+<script lang="ts">
+  import { ImageDefinition, type Loaded } from 'jazz-tools';
+  import { useProgressiveImg } from '$lib/utils/useProgressiveImage.svelte';
+  let { image }: { image: Loaded<typeof ImageDefinition> } = $props();
+  const { src } = $derived(
+    useProgressiveImg({
+      image
+    })
+  );
+</script>
+
+<img class="h-auto max-h-[20rem] max-w-full rounded-t-xl mb-1" {src} alt="" />

examples/chat-svelte/src/lib/components/BubbleInfo.svelte

@@ -0,0 +1,7 @@
+<script lang="ts">
+  let { by, madeAt }: { by: string | undefined; madeAt: Date } = $props();
+</script>
+
+<div class="text-xs text-neutral-500 mt-1.5">
+  {by} · {madeAt.toLocaleTimeString()}
+</div>

examples/chat-svelte/src/lib/components/BubbleText.svelte

@@ -0,0 +1,7 @@
+<script lang="ts">
+  import type { CoPlainText } from 'jazz-tools';
+
+  let { text, className }: { text: CoPlainText | string | null; className?: string } = $props();
+</script>
+
+<div class="whitespace-pre-wrap"><p class="px-2 leading-relaxed {className}">{text}</p></div>

examples/chat-svelte/src/lib/components/ChatBody.svelte

@@ -0,0 +1,7 @@
+<script lang="ts">
+  let { children } = $props();
+</script>
+
+<div class="flex flex-col-reverse flex-1 overflow-y-auto" role="application">
+  {@render children()}
+</div>

examples/chat-svelte/src/lib/components/ChatBubble.svelte

@@ -0,0 +1,36 @@
+<script lang="ts">
+  import BubbleBody from '$lib/components/BubbleBody.svelte';
+  import BubbleContainer from '$lib/components/BubbleContainer.svelte';
+  import BubbleImage from '$lib/components/BubbleImage.svelte';
+  import BubbleInfo from '$lib/components/BubbleInfo.svelte';
+  import BubbleText from '$lib/components/BubbleText.svelte';
+  import type { Message } from '$lib/schema';
+  import type { Account, Loaded } from 'jazz-tools';
+  let {
+    me,
+    msg
+  }: {
+    me: Loaded<typeof Account> | null | undefined;
+    msg: Loaded<typeof Message>;
+  } = $props();
+  const lastEdit = $derived(msg._edits.text);
+  const fromMe = $derived(lastEdit?.by?.isMe);
+  const { text, image } = $derived(msg);
+</script>
+
+{#if me && (!me.canRead(msg) || !msg.text?.toString())}
+  <BubbleContainer fromMe={false}>
+    <BubbleBody fromMe={false}>
+      <BubbleText text="Message not readable" className="italic text-gray-500"></BubbleText>
+    </BubbleBody>
+  </BubbleContainer>
+{:else}
+  <BubbleContainer {fromMe}>
+    <BubbleBody {fromMe}>
+      {#if image}
+        <BubbleImage {image} />{/if}
+      <BubbleText {text} />
+    </BubbleBody>
+    <BubbleInfo by={lastEdit?.by?.profile?.name} madeAt={lastEdit?.madeAt || new Date()} />
+  </BubbleContainer>
+{/if}

examples/chat-svelte/src/lib/components/EmptyChatMessage.svelte

@@ -0,0 +1,3 @@
+<div class="flex items-center justify-center h-full px-3 text-base text-stone-500 md:text-2xl">
+  Start a conversation below.
+</div>

examples/chat-svelte/src/lib/components/ImageIcon.svelte

@@ -0,0 +1,19 @@
+<script lang="ts">
+  let { size = 24, strokeWidth = 2 } = $props();
+</script>
+
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width={size}
+  height={size}
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width={strokeWidth}
+  stroke-linecap="round"
+  stroke-linejoin="round"
+  class="lucide lucide-image-icon lucide-image"
+  ><rect width="18" height="18" x="3" y="3" rx="2" ry="2" /><circle cx="9" cy="9" r="2" /><path
+    d="m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21"
+  /></svg
+>

examples/chat-svelte/src/lib/components/ImageInput.svelte

@@ -0,0 +1,32 @@
+<script lang="ts">
+  import type { ChangeEventHandler } from 'svelte/elements';
+
+  import ImageIcon from '$lib/components/ImageIcon.svelte';
+  let { onImageChange }: { onImageChange?: ChangeEventHandler<HTMLInputElement> } = $props();
+
+  let input = $state<HTMLInputElement>();
+
+  const onUploadClick = () => {
+    input?.click();
+  };
+</script>
+
+<button
+  type="button"
+  aria-label="Send image"
+  title="Send image"
+  onclick={onUploadClick}
+  class="text-stone-500 p-1.5 rounded-full hover:bg-stone-100 hover:text-stone-800 dark:hover:bg-stone-800 dark:hover:text-stone-200 transition-colors"
+>
+  <ImageIcon size={24} strokeWidth={1.5} />
+</button>
+
+<label class="sr-only">
+  Image
+  <input
+    bind:this={input}
+    type="file"
+    accept="image/png, image/jpeg, image/gif"
+    onchange={onImageChange}
+  />
+</label>

examples/chat-svelte/src/lib/components/InputBar.svelte

@@ -0,0 +1,9 @@
+<script lang="ts">
+  let { children } = $props();
+</script>
+
+<div
+  class="flex gap-1 p-3 mt-auto bg-white border-t shadow-2xl border-stone-200 dark:bg-transparent dark:border-stone-900"
+>
+  {@render children()}
+</div>

examples/chat-svelte/src/lib/components/TextInput.svelte

@@ -0,0 +1,20 @@
+<script lang="ts">
+  let { onSubmit }: { onSubmit: (text: string) => void } = $props();
+  const inputId = $props.id();
+</script>
+
+<div class="flex-1">
+  <label class="sr-only" for={inputId}> Type a message and press Enter </label>
+  <input
+    id={inputId}
+    class="block w-full px-3 py-1 border rounded-full border-stone-200 placeholder:text-stone-500 dark:bg-stone-925 dark:text-white dark:border-stone-900"
+    placeholder="Type a message and press Enter"
+    maxLength={2048}
+    type="text"
+    onkeydown={({ key, currentTarget: input }) => {
+      if (key !== 'Enter' || !input.value) return;
+      onSubmit(input.value);
+      input.value = '';
+    }}
+  />
+</div>

examples/chat-svelte/src/lib/components/TopBar.svelte

@@ -0,0 +1,9 @@
+<script lang="ts">
+  let { children } = $props();
+</script>
+
+<div
+  class="flex justify-between w-full gap-2 p-3 bg-white border-b border-stone-200 dark:bg-transparent dark:border-stone-900"
+>
+  {@render children()}
+</div>

examples/chat-svelte/src/lib/schema.ts

@@ -0,0 +1,8 @@
+import { co, z } from 'jazz-tools';
+
+export const Message = co.map({
+  text: co.plainText(),
+  image: z.optional(co.image())
+});
+
+export const Chat = co.list(Message);

examples/chat-svelte/src/lib/utils.ts

@@ -0,0 +1,16 @@
+const animals = [
+  'elephant',
+  'penguin',
+  'giraffe',
+  'octopus',
+  'kangaroo',
+  'dolphin',
+  'cheetah',
+  'koala',
+  'platypus',
+  'pangolin'
+];
+
+export function getRandomUsername() {
+  return `Anonymous ${animals[Math.floor(Math.random() * animals.length)]}`;
+}

examples/chat-svelte/src/lib/utils/useProgressiveImage.svelte.ts

@@ -0,0 +1,53 @@
+import { ImageDefinition, type Loaded } from 'jazz-tools';
+import { onDestroy } from 'svelte';
+
+export function useProgressiveImg({
+  image,
+  maxWidth,
+  targetWidth
+}: {
+  image: Loaded<typeof ImageDefinition> | null | undefined;
+  maxWidth?: number;
+  targetWidth?: number;
+}) {
+  let current = $state<{
+    src?: string;
+    res?: `${number}x${number}` | 'placeholder';
+  }>();
+  const originalSize = $state(image?.originalSize);
+
+  const unsubscribe = image?.subscribe({}, (update: Loaded<typeof ImageDefinition>) => {
+    const highestRes = ImageDefinition.highestResAvailable(update, { maxWidth, targetWidth });
+    if (highestRes) {
+      if (highestRes.res !== current?.res) {
+        const blob = highestRes.stream.toBlob();
+        if (blob) {
+          const blobURI = URL.createObjectURL(blob);
+          current = { src: blobURI, res: highestRes.res };
+
+          setTimeout(() => URL.revokeObjectURL(blobURI), 200);
+        }
+      }
+    } else {
+      current = {
+        src: update?.placeholderDataURL,
+        res: 'placeholder'
+      };
+    }
+  });
+
+  onDestroy(() => () => {
+    unsubscribe?.();
+  });
+
+  return {
+    get src() {
+      return current?.src;
+    },
+    get res() {
+      return current?.res;
+    },
+
+    originalSize
+  };
+}

examples/chat-svelte/src/routes/+layout.svelte

@@ -0,0 +1,32 @@
+<script lang="ts">
+  import '../app.css';
+  import { JazzProvider } from 'jazz-svelte';
+  import 'jazz-inspector-element';
+  import { page } from '$app/state';
+  import { apiKey } from '../apiKey';
+  import { getRandomUsername } from '$lib/utils';
+  let { children } = $props();
+  const defaultProfileName = getRandomUsername();
+</script>
+
+<svelte:head>
+  <title>Jazz Chat Example</title>
+</svelte:head>
+
+<div class="h-full bg-white text-stone-700 dark:text-stone-400 dark:bg-stone-925">
+  <JazzProvider
+    sync={{
+      peer: `wss://cloud.jazz.tools/?key=${apiKey}`
+    }}
+    {defaultProfileName}
+  >
+    {@render children?.()}
+  </JazzProvider>
+  <jazz-inspector></jazz-inspector>
+</div>
+
+<style>
+  :global(html, body) {
+    margin: 0;
+  }
+</style>

examples/chat-svelte/src/routes/+page.svelte

@@ -0,0 +1,16 @@
+<script lang="ts">
+  import { goto } from '$app/navigation';
+  import { Chat } from '$lib/schema';
+  import { AccountCoState } from 'jazz-svelte';
+  import { Account, Group } from 'jazz-tools';
+
+  const account = new AccountCoState(Account);
+  const me = $derived(account.current);
+  $effect(() => {
+    if (!me) return;
+    const group = Group.create();
+    group.addMember('everyone', 'writer');
+    const chat = Chat.create([], group);
+    goto(`/chat/${chat.id}`);
+  });
+</script>

examples/chat-svelte/src/routes/chat/[id]/+page.svelte

@@ -0,0 +1,116 @@
+<script lang="ts">
+  import { createImage } from 'jazz-browser-media-images';
+  import { AccountCoState, CoState } from 'jazz-svelte';
+  import { Account, CoPlainText, type ID } from 'jazz-tools';
+
+  import { page } from '$app/state';
+
+  import { Chat, Message } from '$lib/schema';
+
+  import AppContainer from '$lib/components/AppContainer.svelte';
+  import ChatBody from '$lib/components/ChatBody.svelte';
+  import ChatBubble from '$lib/components/ChatBubble.svelte';
+  import EmptyChatMessage from '$lib/components/EmptyChatMessage.svelte';
+  import ImageInput from '$lib/components/ImageInput.svelte';
+  import InputBar from '$lib/components/InputBar.svelte';
+  import TopBar from '$lib/components/TopBar.svelte';
+  import TextInput from '$lib/components/TextInput.svelte';
+
+  const chatId = $derived(page.params.id) as ID<typeof Chat>;
+  const chat = $derived(
+    new CoState(Chat, chatId, {
+      resolve: {
+        $each: {
+          text: true
+        }
+      }
+    })
+  );
+  const account = new AccountCoState(Account, {
+    resolve: {
+      profile: true
+    }
+  });
+  const me = $derived(account.current);
+  let showNLastMessages = $state(30);
+  const sendImage = (event: Event & { currentTarget: HTMLInputElement }) => {
+    const file = event.currentTarget.files?.[0];
+
+    if (!file || !chat.current) return;
+
+    if (file.size > 5000000) {
+      alert('Please upload an image less than 5MB.');
+      return;
+    }
+
+    createImage(file, { owner: chat.current._owner }).then((image) => {
+      if (!chat.current) return;
+      chat.current.push(
+        Message.create(
+          {
+            text: CoPlainText.create(file.name, chat.current._owner),
+            image: image
+          },
+          chat.current._owner
+        )
+      );
+    });
+  };
+</script>
+
+<AppContainer>
+  <TopBar>
+    <input
+      type="text"
+      value={me?.profile?.name ?? ''}
+      class="bg-transparent"
+      onchange={(e) => {
+        if (!me?.profile) return;
+        const target = e.target as HTMLInputElement;
+        me.profile.name = target.value;
+      }}
+      placeholder="Set username"
+    />
+    <button
+      onclick={() => {
+        account.logOut();
+        window.location.reload(); // Otherwise the provider will not update with default profile name
+      }}>Log out</button
+    >
+  </TopBar>
+  {#if !chat}
+    <div class="flex items-center justify-center flex-1">Loading...</div>
+  {:else}
+    <ChatBody>
+      {#if chat.current && chat.current.length > 0}
+        {#each chat.current.slice(-showNLastMessages).reverse() as msg (msg.id)}
+          <ChatBubble {me} {msg} />
+        {/each}
+      {:else}
+        <EmptyChatMessage />
+      {/if}
+      {#if chat.current && chat.current.length > showNLastMessages}
+        <button
+          class="block px-4 py-1 mx-auto my-2 border rounded"
+          onclick={() => (showNLastMessages += 10)}
+        >
+          Show more
+        </button>
+      {/if}
+    </ChatBody>
+    <InputBar>
+      <ImageInput onImageChange={sendImage} />
+      <TextInput
+        onSubmit={(text: string) => {
+          if (!chat.current) return;
+          chat.current.push(
+            Message.create(
+              { text: CoPlainText.create(text, chat.current._owner) },
+              chat.current._owner
+            )
+          );
+        }}
+      />
+    </InputBar>
+  {/if}
+</AppContainer>

examples/chat-svelte/svelte.config.js

@@ -0,0 +1,18 @@
+import adapter from '@sveltejs/adapter-auto';
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+  // Consult https://svelte.dev/docs/kit/integrations
+  // for more information about preprocessors
+  preprocess: vitePreprocess(),
+
+  kit: {
+    // adapter-auto only supports some environments, see https://svelte.dev/docs/kit/adapter-auto for a list.
+    // If your environment is not supported, or you settled on a specific environment, switch out the adapter.
+    // See https://svelte.dev/docs/kit/adapters for more information about adapters.
+    adapter: adapter()
+  }
+};
+
+export default config;

examples/chat-svelte/tests/chat.spec.ts

@@ -0,0 +1,40 @@
+import { expect } from 'vitest';
+import { ChatPage } from './pages/ChatPage';
+import { test } from '@playwright/test';
+
+test('chat works between two windows', async ({ page: marioPage, browser }) => {
+  await marioPage.goto('/');
+  const context = await browser.newContext();
+  const luigiPage = await context.newPage();
+
+  await marioPage.waitForURL('/chat/**');
+  const roomUrl = marioPage.url();
+  await luigiPage.goto(roomUrl);
+
+  const marioChat = new ChatPage(marioPage);
+  const luigiChat = new ChatPage(luigiPage);
+
+
+  await marioChat.setUsername('Mario');
+
+  const message1ByMario = 'Hello Luigi, are you ready to save the princess?';
+
+  await marioChat.sendMessage(message1ByMario);
+  await marioChat.expectMessageRow(message1ByMario);
+
+  const roomURL = marioPage.url();
+  await luigiPage.goto(roomURL);
+
+  await luigiChat.setUsername('Luigi');
+
+  await luigiChat.expectMessageRow(message1ByMario);
+
+  const message2ByLuigi = "No, I'm not ready yet. I'm still trying to find the key to the castle.";
+
+  await luigiChat.sendMessage(message2ByLuigi);
+  await luigiChat.expectMessageRow(message2ByLuigi);
+
+  await marioChat.expectMessageRow(message1ByMario);
+  await luigiChat.expectMessageRow(message2ByLuigi);
+  await context.close();
+});

examples/chat-svelte/tests/pages/ChatPage.ts

@@ -0,0 +1,41 @@
+import { type Locator, type Page, expect } from '@playwright/test';
+
+export class ChatPage {
+  readonly page: Page;
+  readonly messageInput: Locator;
+  readonly logoutButton: Locator;
+  readonly usernameInput: Locator;
+  constructor(page: Page) {
+    this.page = page;
+    this.messageInput = page.getByRole('textbox', {
+      name: 'Type a message and press Enter'
+    });
+    this.logoutButton = page.getByRole('button', {
+      name: 'Log out'
+    });
+    this.usernameInput = page.getByPlaceholder('Set username');
+  }
+
+  async setUsername(username: string) {
+    await this.usernameInput.fill(username);
+  }
+
+  async sendMessage(message: string) {
+    await this.messageInput.fill(message);
+    await this.messageInput.press('Enter');
+  }
+
+  async expectMessageRow(message: string) {
+    await expect(this.page.getByText(message)).toBeVisible();
+  }
+
+  async expectUserNameNotToBeAnonymousUser() {
+    await expect(this.usernameInput).not.toHaveValue(/anonymous user/i);
+    await expect(this.usernameInput).toHaveValue(/^Anonymous \w+/);
+  }
+
+  async logout() {
+    await this.logoutButton.click();
+    await this.page.goto('/');
+  }
+}

examples/chat-svelte/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "extends": "./.svelte-kit/tsconfig.json",
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "strict": true,
+    "moduleResolution": "bundler"
+  }
+  // Path aliases are handled by https://svelte.dev/docs/kit/configuration#alias
+  // except $lib which is handled by https://svelte.dev/docs/kit/configuration#files
+  //
+  // If you want to overwrite includes/excludes, make sure to copy over the relevant includes/excludes
+  // from the referenced tsconfig.json - TypeScript does not merge them in
+}

examples/chat-svelte/vite.config.ts

@@ -0,0 +1,7 @@
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+import tailwindcss from '@tailwindcss/vite';
+
+export default defineConfig({
+  plugins: [tailwindcss(), sveltekit()]
+});

examples/chat-vue/.gitignore

@@ -1 +1,6 @@
 dist
+# env files
+.env
+.env.*
+!.env.example
+!.env.test

examples/chat-vue/index.html

@@ -1,9 +1,9 @@
 <!DOCTYPE html>
 <html lang="en">
   <head>
-    <meta charset="UTF-8">
+    <meta charset="UTF-8" />
-    <link rel="icon" href="./public/favicon.ico" type="image/png">
+    <link rel="icon" type="image/x-icon" href="/favicon.ico" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Jazz Chat Vue Example</title>
   </head>
   <body>

examples/chat-vue/package.json

@@ -1,6 +1,5 @@
 {
   "name": "chat-vue",
-  "version": "0.0.120",
   "private": true,
   "type": "module",
   "scripts": {
@@ -25,12 +24,12 @@
     "@vitejs/plugin-vue": "^5.1.4",
     "@vitejs/plugin-vue-jsx": "^4.0.1",
     "@vue/tsconfig": "^0.5.1",
-    "autoprefixer": "^10.4.20",
     "eslint": "^9.7.0",
     "eslint-plugin-vue": "^9.28.0",
     "npm-run-all2": "^6.2.3",
-    "postcss": "^8.4.27",
+    "postcss": "^8.4.40",
-    "tailwindcss": "^3.4.17",
+    "@tailwindcss/postcss": "^4.1.10",
+    "tailwindcss": "^4.1.10",
     "typescript": "5.6.2",
     "vite": "6.3.5",
     "vite-plugin-vue-devtools": "^7.4.6",

examples/chat-vue/postcss.config.js

@@ -1,6 +1,5 @@
 export default {
   plugins: {
-    tailwindcss: {},
+    "@tailwindcss/postcss": {},
-    autoprefixer: {},
   },
 };

examples/chat-vue/src/index.css

@@ -1,3 +1 @@
-@tailwind base;
+@import "tailwindcss";
-@tailwind components;
-@tailwind utilities;

examples/chat-vue/tailwind.config.ts

@@ -1,11 +0,0 @@
-import type { Config } from "tailwindcss";
-
-const config: Config = {
-  content: ["./index.html", "./src/**/*.{vue,js,ts,jsx,tsx}"],
-  theme: {
-    extend: {},
-  },
-  plugins: [],
-};
-
-export default config;

examples/chat/.gitignore

@@ -29,3 +29,9 @@ sync-db/
 /playwright-report/
 /blob-report/
 /playwright/.cache/
+
+# env files
+.env
+.env.*
+!.env.example
+!.env.test

examples/chat/index.html

@@ -2,7 +2,7 @@
 <html lang="en" class="h-full">
   <head>
     <meta charset="UTF-8" />
-    <link rel="icon" type="image/png" href="/jazz-logo.png" />
+    <link rel="icon" type="image/x-icon" href="/favicon.ico" />
     <link rel="stylesheet" href="/src/index.css" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Jazz Chat Example</title>

examples/chat/job-template.nomad

@@ -1,56 +0,0 @@
-job "chat$BRANCH_SUFFIX" {
-  region     = "global"
-  datacenters = ["*"]
-
-  group "static" {
-    count = 4
-
-    network {
-      port "http" {
-        to = 80
-      }
-    }
-
-    constraint {
-      attribute = "${node.class}"
-      operator  = "="
-      value     = "cloud"
-    }
-
-    spread {
-      attribute = "${node.datacenter}"
-      weight    = 100
-    }
-
-    constraint {
-      distinct_hosts = true
-    }
-
-    task "server" {
-      driver = "docker"
-
-      config {
-        image = "$DOCKER_TAG"
-        ports = ["http"]
-
-        auth = {
-          username = "$DOCKER_USER"
-          password = "$DOCKER_PASSWORD"
-        }
-      }
-
-      service {
-        tags = ["public"]
-        name = "chat$BRANCH_SUFFIX"
-        port = "http"
-        provider = "consul"
-      }
-
-      resources {
-        cpu    = 50 # MHz
-        memory = 50 # MB
-      }
-    }
-  }
-}
-# deploy bump 4

examples/chat/package.json

@@ -1,7 +1,6 @@
 {
   "name": "jazz-example-chat",
   "private": true,
-  "version": "0.0.220",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -25,13 +24,13 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
+    "@tailwindcss/postcss": "^4.1.10",
     "@types/react": "19.0.0",
     "@types/react-dom": "19.0.0",
     "@vitejs/plugin-react-swc": "^3.10.1",
-    "autoprefixer": "^10.4.20",
     "is-ci": "^3.0.1",
-    "postcss": "^8.4.27",
+    "postcss": "^8.4.40",
-    "tailwindcss": "^3.4.17",
+    "tailwindcss": "^4.1.10",
     "typescript": "5.6.2",
     "vite": "6.3.5"
   }

examples/chat/postcss.config.js

@@ -1,6 +1,5 @@
 export default {
   plugins: {
-    tailwindcss: {},
+    "@tailwindcss/postcss": {},
-    autoprefixer: {},
   },
 };

examples/chat/src/index.css

@@ -1,3 +1,54 @@
-@tailwind base;
+@import "tailwindcss";
-@tailwind components;
+
-@tailwind utilities;
+/* Custom stone color palette */
+@theme {
+  --color-stone-50: oklch(0.988281 0.002 75);
+  --color-stone-75: oklch(0.980563 0.002 75);
+  --color-stone-100: oklch(0.964844 0.002 75);
+  --color-stone-200: oklch(0.917969 0.002 75);
+  --color-stone-300: oklch(0.853516 0.002 75);
+  --color-stone-400: oklch(0.789063 0.002 75);
+  --color-stone-500: oklch(0.726563 0.002 75);
+  --color-stone-600: oklch(0.613281 0.002 75);
+  --color-stone-700: oklch(0.523438 0.002 75);
+  --color-stone-800: oklch(0.412109 0.002 75);
+  --color-stone-900: oklch(0.302734 0.002 75);
+  --color-stone-925: oklch(0.22 0.002 75);
+  --color-stone-950: oklch(0.193359 0.002 75);
+
+  /* Blue color overrides */
+  --color-blue-50: #eef2ff;
+  --color-blue-100: #e0e7ff;
+  --color-blue-200: #c7d2fe;
+  --color-blue-300: #a5b4fc;
+  --color-blue-400: #818cf8;
+  --color-blue-500: #5870f1;
+  --color-blue-600: #5145cd;
+  --color-blue-700: #4338ca;
+  --color-blue-800: #3730a3;
+  --color-blue-900: #312e81;
+  --color-blue-950: #1e1b4b;
+  --color-blue: #146aff;
+}
+
+@layer base {
+  *:focus {
+    outline: none;
+  }
+
+  :root {
+    --border-default: var(--color-stone-200);
+  }
+
+  .dark {
+    --border-default: var(--color-stone-900);
+  }
+
+  *,
+  ::after,
+  ::before,
+  ::backdrop,
+  ::file-selector-button {
+    border-color: var(--border-default, currentColor);
+  }
+}

examples/chat/src/ui.tsx

@@ -86,7 +86,7 @@ export function BubbleImage(props: { image: ImageDefinition }) {
     <ProgressiveImg image={props.image}>
       {({ src }) => (
         <img
-          className="h-auto max-h-[20rem] max-w-full rounded-t-xl mb-1"
+          className="h-auto max-h-80 max-w-full rounded-t-xl mb-1"
           src={src}
         />
       )}

examples/chat/tailwind.config.ts

@@ -1,67 +0,0 @@
-import type { Config } from "tailwindcss";
-import plugin from "tailwindcss/plugin";
-const colors = require("tailwindcss/colors");
-
-const stonePalette = {
-  50: "oklch(0.988281 0.002 75)",
-  75: "oklch(0.980563 0.002 75)",
-  100: "oklch(0.964844 0.002 75)",
-  200: "oklch(0.917969 0.002 75)",
-  300: "oklch(0.853516 0.002 75)",
-  400: "oklch(0.789063 0.002 75)",
-  500: "oklch(0.726563 0.002 75)",
-  600: "oklch(0.613281 0.002 75)",
-  700: "oklch(0.523438 0.002 75)",
-  800: "oklch(0.412109 0.002 75)",
-  900: "oklch(0.302734 0.002 75)",
-  925: "oklch(0.220000 0.002 75)",
-  950: "oklch(0.193359 0.002 75)",
-} as const;
-
-const stonePaletteWithAlpha = { ...stonePalette };
-
-Object.keys(stonePalette).forEach((key) => {
-  stonePaletteWithAlpha[key] = stonePaletteWithAlpha[key].replace(
-    ")",
-    "/ <alpha-value>)",
-  );
-});
-
-const config: Config = {
-  content: ["./index.html", "./src/**/*.{js,ts,jsx,tsx}"],
-  theme: {
-    extend: {
-      colors: {
-        stone: stonePaletteWithAlpha,
-        blue: {
-          ...colors.indigo,
-          500: "#5870F1",
-          DEFAULT: "#146AFF",
-        },
-      },
-      container: {
-        center: true,
-        padding: {
-          DEFAULT: "0.75rem",
-          sm: "1rem",
-        },
-        screens: {
-          md: "500px",
-          lg: "500px",
-          xl: "500px",
-        },
-      },
-    },
-  },
-  plugins: [
-    plugin(({ addBase }) =>
-      addBase({
-        "*:focus": {
-          outline: "none",
-        },
-      }),
-    ),
-  ],
-} as const;
-
-export default config;

examples/clerk/.env.example

@@ -0,0 +1 @@
+VITE_CLERK_PUBLISHABLE_KEY=

examples/clerk/.gitignore

@@ -24,3 +24,9 @@ dist-ssr
 *.sw?
 
 playwright-report
+
+# Env
+.env
+.env.*
+!.env.example
+!.env.test

examples/clerk/README.md

@@ -7,23 +7,34 @@ Live version: [https://clerk-demo.jazz.tools](https://clerk-demo.jazz.tools)
 ## Getting started
 
 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.
 
-
 ### Using the example as a template
 
 Create a new Jazz project, and use this example as a template.
+
 ```bash
 npx create-jazz-app@latest clerk-app --example clerk
 ```
 
 Go to the new project directory.
+
 ```bash
 cd clerk-app
 ```
 
+Rename .env.example to .env
+
+```bash
+mv .env.example .env
+```
+
+Update `VITE_CLERK_PUBLISHABLE_KEY` with your [Publishable Key](https://clerk.com/docs/deployments/clerk-environment-variables#clerk-publishable-and-secret-keys) from Clerk.
+
 Run the dev server.
+
 ```bash
 npm run dev
 ```
@@ -33,21 +44,33 @@ npm run dev
 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
 ```
 
 Go to the example directory.
+
 ```bash
 cd jazz/examples/clerk/
 ```
 
+Rename .env.example to .env
+
+```bash
+mv .env.example .env
+```
+
+Update `VITE_CLERK_PUBLISHABLE_KEY` with your [Publishable Key](https://clerk.com/docs/deployments/clerk-environment-variables#clerk-publishable-and-secret-keys) from Clerk.
+
 Start the dev server.
+
 ```bash
 pnpm dev
 ```
@@ -57,4 +80,3 @@ Open [http://localhost:5173](http://localhost:5173) with your browser to see the
 ## 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/index.html

@@ -3,7 +3,7 @@
 
 <head>
   <meta charset="UTF-8" />
-  <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+  <link rel="icon" type="image/x-icon" href="/favicon.ico" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>Minimal Auth Clerk Example | Jazz</title>
 </head>

examples/clerk/package.json

@@ -1,7 +1,6 @@
 {
   "name": "clerk",
   "private": true,
-  "version": "0.0.119",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -14,6 +13,7 @@
   },
   "dependencies": {
     "@clerk/clerk-react": "^5.4.1",
+    "jazz-inspector": "workspace:*",
     "jazz-react": "workspace:*",
     "jazz-react-auth-clerk": "workspace:*",
     "jazz-tools": "workspace:*",

examples/clerk/src/main.tsx

@@ -3,6 +3,7 @@ import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 import App from "./App.tsx";
 import "./index.css";
+import { JazzInspector } from "jazz-inspector";
 import { JazzProviderWithClerk } from "jazz-react-auth-clerk";
 import { ReactNode } from "react";
 import { apiKey } from "./apiKey";
@@ -44,6 +45,7 @@ if (location.search.includes("expirationTest")) {
       <ClerkProvider publishableKey={PUBLISHABLE_KEY} afterSignOutUrl="/">
         <JazzProvider>
           <App />
+          <JazzInspector />
         </JazzProvider>
       </ClerkProvider>
     </StrictMode>,

examples/file-share-svelte/package.json

@@ -1,6 +1,5 @@
 {
   "name": "file-share-svelte",
-  "version": "0.0.104",
   "private": true,
   "type": "module",
   "scripts": {
@@ -21,7 +20,6 @@
     "@sveltejs/kit": "^2.16.0",
     "@sveltejs/vite-plugin-svelte": "^5.0.0",
     "@types/is-ci": "^3.0.4",
-    "autoprefixer": "^10.4.20",
     "eslint": "^9.7.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-svelte": "^2.36.0",
@@ -32,7 +30,8 @@
     "prettier-plugin-tailwindcss": "^0.6.5",
     "svelte": "^5.33.0",
     "svelte-check": "^4.0.0",
-    "tailwindcss": "^3.4.17",
+    "@tailwindcss/postcss": "^4.1.10",
+    "tailwindcss": "^4.1.10",
     "typescript": "5.6.2",
     "typescript-eslint": "^8.0.0",
     "vite": "6.3.5"

examples/file-share-svelte/postcss.config.js

@@ -1,6 +1,5 @@
 export default {
   plugins: {
-    tailwindcss: {},
+    "@tailwindcss/postcss": {},
-    autoprefixer: {}
+  },
-  }
 };

examples/file-share-svelte/src/app.css

@@ -1,3 +1 @@
-@import 'tailwindcss/base';
+@import 'tailwindcss';
-@import 'tailwindcss/components';
-@import 'tailwindcss/utilities';

examples/file-share-svelte/src/app.html

@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />    
-    <link rel="icon" href="%sveltekit.assets%/favicon.png" />
+    <link rel="icon" type="image/png" href="%sveltekit.assets%/favicon.png" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     %sveltekit.head%
   </head>

examples/file-share-svelte/src/routes/+layout.svelte

@@ -1,11 +1,3 @@
-<script lang="ts" module>
-  declare module 'jazz-svelte' {
-    interface Register {
-      Account: typeof FileShareAccount;
-    }
-  }
-</script>
-
 <script lang="ts">
   import { JazzProvider } from 'jazz-svelte';
   import "jazz-inspector-element"

examples/file-share-svelte/src/routes/+page.svelte

@@ -66,7 +66,7 @@
 </script>
 
 <div class="min-h-screen bg-gray-50">
-  <div class="container mx-auto max-w-4xl px-4 py-8">
+  <div class="mx-auto max-w-4xl px-4 py-8">
     <div class="mb-12 flex items-center justify-between">
       <div>
         <h1 class="mb-2 text-4xl font-bold text-gray-900">File Share</h1>

examples/file-share-svelte/src/routes/file/[fileId]/+page.svelte

@@ -51,7 +51,7 @@
 </svelte:head>
 
 {#if file.current}
-  <div class="container mx-auto max-w-3xl p-4">
+  <div class="mx-auto max-w-3xl p-4">
     <div class="rounded-lg bg-white p-6 shadow-md">
       <div class="mb-6 flex items-center justify-between">
         <div class="flex items-center gap-3">
@@ -88,7 +88,7 @@
     </div>
   </div>
 {:else}
-  <div class="container mx-auto max-w-3xl p-4">
+  <div class="mx-auto max-w-3xl p-4">
     <div class="rounded-lg bg-white p-6 shadow-md">
       <p class="text-gray-600">Loading file...</p>
     </div>

examples/file-share-svelte/tailwind.config.ts

@@ -1,12 +0,0 @@
-import typography from '@tailwindcss/typography';
-import type { Config } from 'tailwindcss';
-
-export default {
-  content: ['./src/**/*.{html,js,svelte,ts}'],
-
-  theme: {
-    extend: {}
-  },
-
-  plugins: [typography]
-} satisfies Config;

examples/filestream/.gitignore

@@ -26,3 +26,9 @@ dist-ssr
 *.sw?
 
 playwright-report
+
+# env files
+.env
+.env.*
+!.env.example
+!.env.test

examples/filestream/index.html

@@ -2,7 +2,7 @@
 <html lang="en" class="h-full">
   <head>
     <meta charset="UTF-8" />
-    <link rel="icon" type="image/png" href="./public/favicon.ico" />
+    <link rel="icon" type="image/x-icon" href="/favicon.ico" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Jazz | React + Demo Auth + Tailwind</title>
   </head>

examples/filestream/package.json

@@ -1,7 +1,6 @@
 {
   "name": "filestream",
   "private": true,
-  "version": "0.0.59",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -11,22 +10,22 @@
     "format-and-lint:fix": "biome check . --write"
   },
   "dependencies": {
+    "jazz-inspector": "workspace:*",
     "jazz-react": "workspace:*",
     "jazz-tools": "workspace:*",
-    "jazz-inspector": "workspace:*",
     "react": "19.0.0",
     "react-dom": "19.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
+    "@tailwindcss/postcss": "^4.1.10",
     "@types/react": "19.0.0",
     "@types/react-dom": "19.0.0",
     "@vitejs/plugin-react": "^4.5.1",
-    "autoprefixer": "^10.4.20",
     "globals": "^15.11.0",
     "is-ci": "^3.0.1",
     "postcss": "^8.5.3",
-    "tailwindcss": "^3.4.17",
+    "tailwindcss": "^4.1.10",
     "typescript": "5.6.2",
     "vite": "6.3.5"
   }

examples/filestream/postcss.config.js

@@ -1,6 +1,5 @@
 export default {
   plugins: {
-    tailwindcss: {},
+    "@tailwindcss/postcss": {},
-    autoprefixer: {},
   },
 };

examples/filestream/src/App.tsx

@@ -4,7 +4,7 @@ import { Logo } from "./Logo.tsx";
 function App() {
   return (
     <>
-      <main className="container mt-16 flex flex-col gap-8">
+      <main className="max-w-3xl mx-auto px-3 mt-16 flex flex-col gap-8">
         <Logo />
         <FileWidget />
       </main>

examples/filestream/src/index.css

@@ -1,3 +1 @@
-@tailwind base;
+@import "tailwindcss";
-@tailwind components;
-@tailwind utilities;