Implement & test & sketch out further tests

.changeset/calm-cameras-film.md

@@ -0,0 +1,6 @@
+---
+"jazz-browser": patch
+"cojson": patch
+---
+
+WIP working-ish version of LSM storage

.changeset/clean-ladybugs-decide.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Implement first devtools formatters

.changeset/clever-onions-call.md

@@ -0,0 +1,6 @@
+---
+"jazz-tools": patch
+"cojson": patch
+---
+
+Implement profile visibility based on groups & new migration signature

.changeset/config.json

@@ -1,23 +1,23 @@
 {
-  "$schema": "https://unpkg.com/@changesets/config@2.3.1/schema.json",
-  "changelog": "@changesets/cli/changelog",
-  "commit": false,
-  "linked": [],
-  "fixed": [
-    [
-      "cojson",
-      "cojson-storage-indexeddb",
-      "cojson-storage-sqlite",
-      "cojson-transport-ws",
-      "jazz-auth-betterauth",
-      "jazz-betterauth-client-plugin",
-      "jazz-betterauth-server-plugin",
-      "jazz-react-auth-betterauth",
-      "jazz-run",
-      "jazz-tools"
-    ]
-  ],
-  "access": "public",
-  "baseBranch": "main",
-  "updateInternalDependencies": "minor"
+    "$schema": "https://unpkg.com/@changesets/config@2.3.1/schema.json",
+    "changelog": "@changesets/cli/changelog",
+    "commit": false,
+    "fixed": [],
+    "linked": [
+        [
+            "cojson",
+            "jazz-tools",
+            "jazz-browser",
+            "jazz-react",
+            "jazz-nodejs",
+            "jazz-run",
+            "cojson-transport-nodejs-ws",
+            "cojson-storage-indexeddb",
+            "cojson-storage-sqlite"
+        ]
+    ],
+    "access": "public",
+    "baseBranch": "main",
+    "updateInternalDependencies": "patch",
+    "ignore": []
 }

.changeset/curly-jars-crash.md

@@ -0,0 +1,8 @@
+---
+"jazz-browser-media-images": patch
+"jazz-browser": patch
+"jazz-react": patch
+"jazz-tools": patch
+---
+
+CoMap fix

.changeset/early-zebras-collect.md

@@ -0,0 +1,5 @@
+---
+"jazz-react": patch
+---
+
+Use fresh subscribe context for useProgressiveImg

.changeset/empty-lamps-punch.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Add .all to CoStreamEntry

.changeset/friendly-jeans-deny.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Make Account -> Profile a lazy ref schema

.changeset/gentle-jeans-sell.md

@@ -0,0 +1,5 @@
+---
+"cojson": patch
+---
+
+CoJSON performance improvement

.changeset/happy-knives-pull.md

@@ -0,0 +1,5 @@
+---
+"hash-slash": patch
+---
+
+Allow fall-through of routes

.changeset/heavy-years-occur.md

@@ -0,0 +1,6 @@
+---
+"jazz-tools": patch
+"cojson": patch
+---
+
+Fix CoList.splice / RawCoList.append

.changeset/honest-sloths-taste.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+More precise imports from @effect/schema

.changeset/itchy-swans-sneeze.md

@@ -0,0 +1,5 @@
+---
+"jazz-react": patch
+---
+
+Fix Provider params

.changeset/khaki-dryers-worry.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+More superclass-compatible CoMaps

.changeset/large-rocks-worry.md

@@ -0,0 +1,6 @@
+---
+"jazz-react": patch
+"jazz-tools": patch
+---
+
+Add maxWidth option for loading images

.changeset/late-socks-explain.md

@@ -0,0 +1,5 @@
+---
+"cojson": patch
+---
+
+Optimizations for incoming sync messages

.changeset/lazy-windows-fold.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Use effect 3.0

.changeset/lemon-trees-perform.md

@@ -0,0 +1,6 @@
+---
+"jazz-react": patch
+"jazz-tools": patch
+---
+
+Fix image resolution loading

.changeset/long-ties-relax.md

@@ -0,0 +1,10 @@
+---
+"jazz-browser-media-images": minor
+"jazz-browser": minor
+"hash-slash": minor
+"jazz-react": minor
+"jazz-tools": minor
+"cojson": minor
+---
+
+New simplified API

.changeset/lovely-carpets-draw.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Fix CoMap \_refs for co.items

.changeset/mean-panthers-look.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+CoValue casting & auto-subbing \_owner

.changeset/mighty-jars-leave.md

@@ -0,0 +1,5 @@
+---
+"jazz-nodejs": patch
+---
+
+Simplify jazz-nodejs

.changeset/odd-beans-jam.md

@@ -0,0 +1,13 @@
+---
+"cojson-transport-nodejs-ws": patch
+"jazz-browser-media-images": patch
+"cojson-storage-indexeddb": patch
+"cojson-storage-sqlite": patch
+"jazz-browser": patch
+"jazz-nodejs": patch
+"jazz-react": patch
+"jazz-tools": patch
+"cojson": patch
+---
+
+Support stricter TS lint rules

.changeset/orange-pigs-clean.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Relax types of CoMap.\_schema

.changeset/popular-tips-appear.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Make CoMaps even more subclassable

.changeset/pre.json

@@ -0,0 +1,80 @@
+{
+  "mode": "pre",
+  "tag": "alpha",
+  "initialVersions": {
+    "jazz-example-chat": "0.0.46",
+    "jazz-example-chat-passphrase": "0.0.47",
+    "counter-js-auth0": "0.0.46",
+    "jazz-example-file-drop": "0.0.63",
+    "jazz-example-pets": "0.0.64",
+    "jazz-example-todo": "0.0.63",
+    "jazz-example-twit": "0.1.1",
+    "twit-stresstest": "0.2.0",
+    "cojson": "0.6.6",
+    "cojson-simple-sync": "0.6.0",
+    "cojson-storage-indexeddb": "0.6.3",
+    "cojson-storage-sqlite": "0.5.2",
+    "cojson-transport-nodejs-ws": "0.5.1",
+    "hash-slash": "0.1.3",
+    "jazz-browser": "0.6.3",
+    "jazz-browser-auth0": "0.6.2",
+    "jazz-browser-media-images": "0.6.0",
+    "jazz-tools": "0.6.1",
+    "jazz-nodejs": "0.6.4",
+    "jazz-react": "0.5.4",
+    "jazz-run": "0.7.0-alpha.32"
+  },
+  "changesets": [
+    "calm-cameras-film",
+    "clean-ladybugs-decide",
+    "clever-onions-call",
+    "curly-jars-crash",
+    "early-zebras-collect",
+    "empty-lamps-punch",
+    "friendly-jeans-deny",
+    "gentle-jeans-sell",
+    "happy-knives-pull",
+    "heavy-years-occur",
+    "honest-sloths-taste",
+    "itchy-swans-sneeze",
+    "khaki-dryers-worry",
+    "large-rocks-worry",
+    "late-socks-explain",
+    "lazy-windows-fold",
+    "lemon-trees-perform",
+    "long-ties-relax",
+    "lovely-carpets-draw",
+    "mean-panthers-look",
+    "mighty-jars-leave",
+    "odd-beans-jam",
+    "orange-pigs-clean",
+    "popular-tips-appear",
+    "pretty-shirts-applaud",
+    "purple-jars-change",
+    "real-actors-jam",
+    "rotten-crabs-invite",
+    "selfish-bobcats-fetch",
+    "serious-buses-sniff",
+    "serious-donuts-end",
+    "seven-rivers-divide",
+    "shy-flies-fold",
+    "silent-berries-complain",
+    "silly-oranges-look",
+    "slow-beans-stare",
+    "smart-guests-work",
+    "smooth-emus-hunt",
+    "tame-bikes-poke",
+    "tasty-boats-watch",
+    "thin-bulldogs-leave",
+    "thin-knives-fail",
+    "thin-rice-know",
+    "thirty-tools-matter",
+    "three-berries-study",
+    "three-months-carry",
+    "tough-waves-shave",
+    "wet-schools-travel",
+    "wicked-adults-visit",
+    "wise-geckos-buy",
+    "witty-cougars-swim"
+  ]
+}

.changeset/pretty-shirts-applaud.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Make refs type more precise

.changeset/purple-jars-change.md

@@ -0,0 +1,5 @@
+---
+"jazz-browser": patch
+---
+
+Add missing @scure/bip39 dep

.changeset/real-actors-jam.md

@@ -0,0 +1,10 @@
+---
+"jazz-browser-media-images": patch
+"cojson-storage-indexeddb": patch
+"jazz-browser": patch
+"jazz-react": patch
+"jazz-tools": patch
+"cojson": patch
+---
+
+Consistent proxy based API

.changeset/rotten-crabs-invite.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Add ability to declare minimum required data in subscribe & Improve property access tracing

.changeset/selfish-bobcats-fetch.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Fix CoMap.Record.toJSON()

.changeset/serious-buses-sniff.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Introduce jazz-tools CLI

.changeset/serious-donuts-end.md

@@ -0,0 +1,9 @@
+---
+"cojson-transport-nodejs-ws": patch
+"cojson-storage-indexeddb": patch
+"cojson-storage-sqlite": patch
+"jazz-tools": patch
+"cojson": patch
+---
+
+Reintroduce changes from main

.changeset/seven-rivers-divide.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Get rid of self generics, new create syntax

.changeset/shy-flies-fold.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Fix schema of Account & Group

.changeset/silent-berries-complain.md

@@ -0,0 +1,5 @@
+---
+"jazz-run": patch
+---
+
+Ensure accounts are synced after creation

.changeset/silly-oranges-look.md

@@ -0,0 +1,9 @@
+---
+"jazz-browser-media-images": patch
+"jazz-browser": patch
+"jazz-nodejs": patch
+"jazz-react": patch
+"jazz-tools": patch
+---
+
+Fix variance of ID.\_\_type

.changeset/slow-beans-stare.md

@@ -0,0 +1,8 @@
+---
+"jazz-browser-media-images": patch
+"jazz-browser": patch
+"jazz-react": patch
+"jazz-tools": patch
+---
+
+Even friendlier for subclassing CoMap

.changeset/smart-guests-work.md

@@ -0,0 +1,5 @@
+---
+"jazz-react": patch
+---
+
+Fix subscription to account in useAccount

.changeset/smooth-emus-hunt.md

@@ -0,0 +1,7 @@
+---
+"jazz-browser": patch
+"jazz-react": patch
+"jazz-tools": patch
+---
+
+Clean up exports

.changeset/tame-bikes-poke.md

@@ -0,0 +1,13 @@
+---
+"jazz-browser-media-images": patch
+"cojson-storage-indexeddb": patch
+"cojson-storage-sqlite": patch
+"cojson-simple-sync": patch
+"jazz-browser": patch
+"hash-slash": patch
+"jazz-react": patch
+"jazz-tools": patch
+"cojson": patch
+---
+
+Use effect schema much less

.changeset/tasty-boats-watch.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Fix CoStream types

.changeset/thin-bulldogs-leave.md

@@ -0,0 +1,13 @@
+---
+"cojson-transport-nodejs-ws": patch
+"jazz-browser-media-images": patch
+"cojson-storage-indexeddb": patch
+"cojson-storage-sqlite": patch
+"jazz-browser": patch
+"jazz-nodejs": patch
+"jazz-react": patch
+"jazz-tools": patch
+"cojson": patch
+---
+
+Clean up API more & re-add jazz-nodejs

.changeset/thin-knives-fail.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Make refs on list more precise

.changeset/thin-rice-know.md

@@ -0,0 +1,10 @@
+---
+"jazz-browser-media-images": patch
+"cojson-storage-indexeddb": patch
+"jazz-browser": patch
+"jazz-react": patch
+"jazz-tools": patch
+"cojson": patch
+---
+
+Refactoring

.changeset/thirty-tools-matter.md

@@ -0,0 +1,11 @@
+---
+"cojson-transport-nodejs-ws": patch
+"jazz-browser-media-images": patch
+"cojson-storage-indexeddb": patch
+"jazz-browser": patch
+"hash-slash": patch
+"jazz-react": patch
+"jazz-tools": patch
+---
+
+Get rid of Co namespace

.changeset/three-berries-study.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Cache CoValue proxies

.changeset/three-months-carry.md

@@ -0,0 +1,6 @@
+---
+"jazz-tools": patch
+"cojson": patch
+---
+
+Make sure delete on CoMaps deletes keys

.changeset/tough-waves-shave.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Make fast-check a direct dependency to help dev time resolution

.changeset/wet-schools-travel.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+CoMap fixes and improvements

.changeset/wicked-adults-visit.md

@@ -0,0 +1,8 @@
+---
+"jazz-browser-media-images": patch
+"jazz-browser": patch
+"jazz-react": patch
+"jazz-tools": patch
+---
+
+More subclass-friendly types in CoMap

.changeset/wise-geckos-buy.md

@@ -0,0 +1,6 @@
+---
+"jazz-tools": patch
+"jazz-run": patch
+---
+
+Extract jazz cli into jazz-run package

.changeset/witty-cougars-swim.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Fix Costream[...].all

.editorconfig

@@ -1,11 +0,0 @@
-# EditorConfig is awesome: https://editorconfig.org
-
-# top-most EditorConfig file
-root = true
-
-# Unix-style newlines with a newline ending every file
-[*]
-end_of_line = lf
-insert_final_newline = true
-indent_style = space
-indent_size = 2

.envrc

@@ -1 +0,0 @@
-use flake

.git-blame-ignore-revs

@@ -1,2 +0,0 @@
-# Formatted workspace with biome
-be0a09a22295cd5d2ee3ef323e2d999da8a14110

.github/ISSUE_TEMPLATE/docs-request.md

@@ -1,10 +0,0 @@
----
-name: Docs request
-about: Allow people to quickly report issues & improvements for the docs
-title: 'Docs: '
-labels: docs, requested
-assignees: bensleveritt
-
----
-
-

.github/actions/android-emulator/action.yml

@@ -1,39 +0,0 @@
-name: Setup Android Emulator
-
-inputs:
-  api-level:
-    description: 'API level to use for the emulator'
-    required: true
-    default: '29'
-
-runs:
-  using: "composite"
-  steps:
-    - name: Enable KVM
-      shell: bash
-      run: |
-        echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
-        sudo udevadm control --reload-rules
-        sudo udevadm trigger --name-match=kvm
-
-    - name: Gradle cache
-      uses: gradle/actions/setup-gradle@v4
-
-    - name: AVD cache
-      uses: useblacksmith/cache@v5
-      id: avd-cache
-      with:
-        path: |
-          ~/.android/avd/*
-          ~/.android/adb*
-        key: avd-${{ inputs.api-level }}
-
-    - name: Create AVD and Generate Snapshot for Caching
-      if: steps.avd-cache.outputs.cache-hit != 'true'
-      uses: reactivecircus/android-emulator-runner@v2
-      with:
-        api-level: ${{ inputs.api-level }}
-        force-avd-creation: false
-        emulator-options: -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none -no-metrics
-        disable-animations: false
-        script: echo "Generated AVD snapshot for caching."

.github/actions/source-code/action.yml

@@ -1,36 +0,0 @@
-name: Get and Build Source Code
-
-runs:
-  using: "composite"
-  steps:
-    - name: Enable latestcorepack
-      shell: bash
-      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: useblacksmith/setup-node@v5
-      with:
-        node-version-file: '.node-version'
-        cache: 'pnpm'
-
-    - name: Get pnpm store directory
-      shell: bash
-      run: |
-        echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
-
-    - uses: useblacksmith/cache@v5
-      name: Setup pnpm cache
-      with:
-        path: ${{ env.STORE_PATH }}
-        key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
-        restore-keys: |
-          ${{ runner.os }}-pnpm-store-
-
-    - name: Install dependencies
-      shell: bash
-      run: pnpm install --frozen-lockfile

.github/pull_request_template.md

@@ -1,23 +0,0 @@
-# Description
-<!-- Please include a summary of the change and which issue is fixed -->
-<!-- Please also include relevant motivation and context -->
-<!-- Include any links to documentation like RFC’s if necessary -->
-<!-- Add a link to to relevant preview environments or anything that would simplify visual review process -->
-<!-- Supplemental screenshots and video are encouraged, but the primary description should be in text -->
-
-## Manual testing instructions
-
-<!-- Add any actions required to manually test the changes -->
-
-## Tests
-
-- [ ] Tests have been added and/or updated
-- [ ] Tests have not been updated, because: <!-- Insert reason for not updating tests here -->
-- [ ] I need help with writing tests
-
-
-## Checklist
-
-- [ ] I've updated the part of the docs that are affected the PR changes
-- [ ] I've generated a changeset, if a version bump is required
-- [ ] I've updated the jsDoc comments to the public APIs I've modified, or added them when missing

.github/workflows/build-and-deploy.yaml

@@ -0,0 +1,151 @@
+name: Build and Deploy
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build-examples:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        example: ["chat", "pets", "todo"]
+        # example: ["twit", "chat", "counter-js-auth0", "pets", "twit", "file-drop", "inspector"]
+
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        submodules: true
+
+    - uses: pnpm/action-setup@v2
+      with:
+        version: 8
+
+    - uses: actions/setup-node@v3
+      with:
+        node-version: 16
+        cache: 'pnpm'
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v2
+
+    - name: Login to GitHub Container Registry
+      uses: docker/login-action@v2
+      with:
+        registry: ghcr.io
+        username: gardencmp
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Pnpm Build
+      run: |
+        pnpm install
+        pnpm turbo build;
+      working-directory: ./examples/${{ matrix.example }}
+
+    - name: Docker Build & Push
+      uses: docker/build-push-action@v4
+      with:
+        context: ./examples/${{ matrix.example }}
+        push: true
+        tags: ghcr.io/gardencmp/${{github.event.repository.name}}-example-${{ matrix.example }}:${{github.head_ref || github.ref_name}}-${{github.sha}}-${{github.run_number}}-${{github.run_attempt}}
+        cache-from: type=gha
+        cache-to: type=gha,mode=max
+
+  build-homepage:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        submodules: true
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v2
+
+    - name: Login to GitHub Container Registry
+      uses: docker/login-action@v2
+      with:
+        registry: ghcr.io
+        username: gardencmp
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Docker Build & Push
+      uses: docker/build-push-action@v4
+      with:
+        context: ./homepage
+        push: true
+        tags: ghcr.io/gardencmp/${{github.event.repository.name}}-homepage-jazz:${{github.head_ref || github.ref_name}}-${{github.sha}}-${{github.run_number}}-${{github.run_attempt}}
+        cache-from: type=gha
+        cache-to: type=gha,mode=max
+
+  deploy-examples:
+    runs-on: ubuntu-latest
+    needs: build-examples
+    strategy:
+      matrix:
+        example: ["chat", "pets", "todo"]
+        # example: ["twit", "chat", "counter-js-auth0", "pets", "twit", "file-drop", "inspector"]
+
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        submodules: true
+    - uses: gacts/install-nomad@v1
+    - name: Tailscale
+      uses: tailscale/github-action@v1
+      with:
+        authkey: ${{ secrets.TAILSCALE_AUTHKEY }}
+
+    - name: Deploy on Nomad
+      run: |
+        if [ "${{github.ref_name}}" == "main" ]; then
+          export BRANCH_SUFFIX="";
+          export BRANCH_SUBDOMAIN="";
+        else
+          export BRANCH_SUFFIX=-${{github.head_ref || github.ref_name}};
+          export BRANCH_SUBDOMAIN=${{github.head_ref || github.ref_name}}.;
+        fi
+
+        export DOCKER_USER=gardencmp;
+        export DOCKER_PASSWORD=${{ secrets.DOCKER_PULL_PAT }};
+        export DOCKER_TAG=ghcr.io/gardencmp/${{github.event.repository.name}}-example-${{ matrix.example }}:${{github.head_ref || github.ref_name}}-${{github.sha}}-${{github.run_number}}-${{github.run_attempt}};
+
+        envsubst '${DOCKER_USER} ${DOCKER_PASSWORD} ${DOCKER_TAG} ${BRANCH_SUFFIX} ${BRANCH_SUBDOMAIN}' < job-template.nomad > job-instance.nomad;
+        cat job-instance.nomad;
+        NOMAD_ADDR=${{ secrets.NOMAD_ADDR }} nomad job run job-instance.nomad;
+      working-directory: ./examples/${{ matrix.example }}
+
+  deploy-homepage:
+    runs-on: ubuntu-latest
+    needs: build-homepage
+
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        submodules: true
+    - uses: gacts/install-nomad@v1
+    - name: Tailscale
+      uses: tailscale/github-action@v1
+      with:
+        authkey: ${{ secrets.TAILSCALE_AUTHKEY }}
+
+    - name: Deploy on Nomad
+      run: |
+        if [ "${{github.ref_name}}" == "main" ]; then
+          export BRANCH_SUFFIX="";
+          export BRANCH_SUBDOMAIN="";
+        else
+          export BRANCH_SUFFIX=-${{github.head_ref || github.ref_name}};
+          export BRANCH_SUBDOMAIN=${{github.head_ref || github.ref_name}}.;
+        fi
+
+        export DOCKER_USER=gardencmp;
+        export DOCKER_PASSWORD=${{ secrets.DOCKER_PULL_PAT }};
+        export DOCKER_TAG=ghcr.io/gardencmp/${{github.event.repository.name}}-homepage-jazz:${{github.head_ref || github.ref_name}}-${{github.sha}}-${{github.run_number}}-${{github.run_attempt}};
+
+        envsubst '${DOCKER_USER} ${DOCKER_PASSWORD} ${DOCKER_TAG} ${BRANCH_SUFFIX} ${BRANCH_SUBDOMAIN}' < job-template.nomad > job-instance.nomad;
+        cat job-instance.nomad;
+        NOMAD_ADDR=${{ secrets.NOMAD_ADDR }} nomad job run job-instance.nomad;
+      working-directory: ./homepage

.github/workflows/code-quality.yml

@@ -1,30 +0,0 @@
-name: Code quality
-
-concurrency:
-  # For pushes, this lets concurrent runs happen, so each push gets a result.
-  # But for other events (e.g. PRs), we can cancel the previous runs.
-  group: ${{ github.workflow }}-${{ github.event_name == 'push' && github.sha || github.ref }}
-  cancel-in-progress: true
-
-on:
-  push:
-    branches: 
-      - "main"
-  pull_request:
-
-
-jobs:
-  quality:
-    runs-on: blacksmith-2vcpu-ubuntu-2404-arm
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Setup Biome
-        uses: biomejs/setup-biome@v2
-        with:
-          version: 2.1.3
-      - name: Run Biome
-        run: biome ci .
-
-      - name: Check Catalog Dependencies
-        run: node scripts/check-catalog-deps.js

.github/workflows/e2e-rn-test.yml

@@ -1,90 +0,0 @@
-name: End-to-End Tests for React Native
-
-concurrency:
-  # For pushes, this lets concurrent runs happen, so each push gets a result.
-  # But for other events (e.g. PRs), we can cancel the previous runs.
-  group: ${{ github.workflow }}-${{ github.event_name == 'push' && github.sha || github.ref }}
-  cancel-in-progress: true
-
-on:
-  pull_request:
-    types: [opened, synchronize, reopened]
-    paths:
-      - ".github/actions/android-emulator/**"
-      - ".github/actions/source-code/**"
-      - ".github/workflows/e2e-rn-test.yml"
-      - "examples/chat-rn-expo/**"
-      - "packages/**"
-
-jobs:
-  e2e-tests:
-    runs-on: blacksmith-4vcpu-ubuntu-2204
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
-
-      - name: Create Output Directory
-        run: |
-          mkdir -p ~/output
-
-      - name: Setup JDK
-        uses: actions/setup-java@v4
-        with:
-          distribution: corretto
-          java-version: 22
-          cache: gradle
-
-      - name: Pnpm Build
-        run: pnpm turbo build --filter="./packages/*"
-
-      - name: chat-rn-expo App Pre Build
-        working-directory: ./examples/chat-rn-expo
-        run: |
-          pnpm expo prebuild --clean
-
-      - name: Install Maestro
-        run: |
-          curl -fsSL "https://get.maestro.mobile.dev" | bash
-
-      - name: Setup Android Emulator
-        id: android-emulator
-        uses: ./.github/actions/android-emulator/
-        with:
-          api-level: 29
-
-      - name: Test App
-        uses: reactivecircus/android-emulator-runner@v2
-        id: e2e_test
-        continue-on-error: true
-        with:
-          api-level: 29
-          force-avd-creation: false
-          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none -no-metrics
-          disable-animations: true
-          working-directory: ./examples/chat-rn-expo/
-          # killall due to this issue: https://github.com/ReactiveCircus/android-emulator-runner/issues/385
-          script: ./test/e2e/run.sh && ( killall -INT crashpad_handler || true )
-
-      - name: Copy Maestro Output
-        if: steps.e2e_test.outcome != 'success'
-        run: |
-          cp -r ~/.maestro/tests/* ~/output
-
-      - name: Upload Output Files
-        if: steps.e2e_test.outcome != 'success'
-        uses: actions/upload-artifact@v4
-        with:
-          name: e2e-test-output
-          path: ~/output/*
-          retention-days: 5
-
-      - name: Exit with Test Result
-        if: always()
-        run: |
-          if [ "${{ steps.e2e_test.outcome }}" != "success" ]; then
-            exit 1
-          fi

.github/workflows/jazz-run.yml

@@ -1,34 +0,0 @@
-name: Jazz Run Tests
-
-concurrency:
-  # For pushes, this lets concurrent runs happen, so each push gets a result.
-  # But for other events (e.g. PRs), we can cancel the previous runs.
-  group: ${{ github.workflow }}-${{ github.event_name == 'push' && github.sha || github.ref }}
-  cancel-in-progress: true
-
-on:
-  push:
-    branches: ["main"]
-  pull_request:
-    types: [opened, synchronize, reopened]
-
-jobs:
-  test:
-    runs-on: blacksmith-4vcpu-ubuntu-2404
-    timeout-minutes: 5
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: true
-
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
-
-      - name: Build jazz-run
-        run: pnpm exec turbo build && chmod +x dist/index.js;
-        working-directory: ./packages/jazz-run
-
-      - name: Run create account
-        run: ./dist/index.js account create --name "Jazz Run CI test"
-        working-directory: ./packages/jazz-run

.github/workflows/playwright.yml

@@ -1,158 +0,0 @@
-name: Playwright Tests
-
-concurrency:
-  # For pushes, this lets concurrent runs happen, so each push gets a result.
-  # But for other events (e.g. PRs), we can cancel the previous runs.
-  group: ${{ github.workflow }}-${{ github.event_name == 'push' && github.sha || github.ref }}
-  cancel-in-progress: true
-
-on:
-  push:
-    branches: ["main"]
-  pull_request:
-    types: [opened, synchronize, reopened]
-
-jobs:
-  test:
-    timeout-minutes: 60
-    runs-on: blacksmith-4vcpu-ubuntu-2404
-    continue-on-error: true
-    strategy:
-      matrix:
-        shard: ["1/2", "2/2"]
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: true
-
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
-
-      - name: Install Playwright Browsers
-        run: pnpm exec playwright install
-
-      - name: Run Playwright tests for shard ${{ matrix.shard }}
-        run: |
-          # Parse shard information (e.g., "1/2" -> shard_num=1, total_shards=2)
-          IFS='/' read -r shard_num total_shards <<< "${{ matrix.shard }}"
-          shard_index=$((shard_num - 1))  # Convert to 0-based index
-          
-          # Debug: Print parsed values
-          echo "Parsed shard_num: $shard_num"
-          echo "Parsed total_shards: $total_shards"
-          echo "Calculated shard_index: $shard_index"
-          
-          # Define all projects to test
-          all_projects=(
-            "tests/e2e"
-            "examples/chat"
-            "examples/chat-svelte"
-            "examples/clerk"
-            "examples/betterauth"
-            "examples/file-share-svelte"
-            "examples/form"
-            "examples/inspector"
-            "examples/music-player"
-            "examples/organization"
-            "examples/server-worker-http"
-            "starters/react-passkey-auth"
-            "starters/svelte-passkey-auth"
-            "tests/jazz-svelte"
-          )
-          
-          # Calculate which projects this shard should run
-          shard_projects=()
-          for i in "${!all_projects[@]}"; do
-            if [ $((i % total_shards)) -eq $shard_index ]; then
-              shard_projects+=("${all_projects[i]}")
-            fi
-          done
-          
-          # Track project results
-          overall_exit_code=0
-          failed_projects=()
-          passed_projects=()
-          
-          echo "=== Running tests for shard ${{ matrix.shard }} ==="
-          echo "Projects in this shard:"
-          printf '%s\n' "${shard_projects[@]}"
-          echo
-          
-          # Run tests for each project
-          for project in "${shard_projects[@]}"; do
-            echo "=== Testing project: $project ==="
-            
-            # Check if project directory exists
-            if [ ! -d "$project" ]; then
-              echo "❌ FAILED: Project directory $project does not exist"
-              failed_projects+=("$project (directory not found)")
-              overall_exit_code=1
-              continue
-            fi
-            
-            # Check if project has package.json
-            if [ ! -f "$project/package.json" ]; then
-              echo "❌ FAILED: No package.json found in $project"
-              failed_projects+=("$project (no package.json)")
-              overall_exit_code=1
-              continue
-            fi
-            
-            # Build the project
-            echo "🔨 Building $project..."
-            cd "$project"
-            
-            if [ -f .env.test ]; then
-              cp .env.test .env
-            fi
-            
-            if ! pnpm turbo build; then
-              echo "❌ BUILD FAILED: $project"
-              failed_projects+=("$project (build failed)")
-              overall_exit_code=1
-              cd - > /dev/null
-              continue
-            fi
-            
-            # Run Playwright tests
-            echo "🧪 Running Playwright tests for $project..."
-            if ! pnpm exec playwright test; then
-              echo "❌ TESTS FAILED: $project"
-              failed_projects+=("$project (tests failed)")
-              overall_exit_code=1
-            else
-              echo "✅ TESTS PASSED: $project"
-              passed_projects+=("$project")
-            fi
-            
-            cd - > /dev/null
-            echo "=== Finished testing $project ==="
-            echo
-          done
-          
-          # Print summary report
-          echo "=========================================="
-          echo "📊 TEST SUMMARY FOR SHARD ${{ matrix.shard }}"
-          echo "=========================================="
-          
-          if [ ${#passed_projects[@]} -gt 0 ]; then
-            echo "✅ PASSED (${#passed_projects[@]}):"
-            printf '  - %s\n' "${passed_projects[@]}"
-            echo
-          fi
-          
-          if [ ${#failed_projects[@]} -gt 0 ]; then
-            echo "❌ FAILED (${#failed_projects[@]}):"
-            printf '  - %s\n' "${failed_projects[@]}"
-            echo
-          fi
-  
-          
-          echo "Total projects in shard: ${#shard_projects[@]}"
-          echo "Passed: ${#passed_projects[@]}"
-          echo "Failed: ${#failed_projects[@]}"
-          echo "=========================================="
-          
-          # Exit with overall status
-          exit $overall_exit_code

.github/workflows/pre-release.yml

@@ -1,109 +0,0 @@
-name: Pre-Publish tagged Pull Requests
-
-concurrency:
-  # For pushes, this lets concurrent runs happen, so each push gets a result.
-  # But for other events (e.g. PRs), we can cancel the previous runs.
-  group: ${{ github.workflow }}-${{ github.event_name == 'push' && github.sha || github.ref }}
-  cancel-in-progress: true
-
-on:
-  pull_request:
-    types: [opened, synchronize, reopened, labeled]
-
-jobs:
-  pre-release:
-    if: contains(github.event.pull_request.labels.*.name, 'pre-release')
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
-
-      - name: Pnpm Build
-        run: pnpm turbo build --filter="./packages/*"
-
-      - name: Pre publish
-        run: pnpm exec pkg-pr-new publish --json output.json --comment=off "./packages/*"
-
-      - name: Post or update comment
-        uses: actions/github-script@v6
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const fs = require('fs');
-            const output = JSON.parse(fs.readFileSync('output.json', 'utf8'));
-
-            const packages = output.packages
-              .map((p) => `- ${p.name}: ${p.url}`)
-              .join('\n');
-
-            const sha =
-              context.event_name === 'pull_request'
-                ? context.payload.pull_request.head.sha
-                : context.payload.after;
-
-            const resolutions = Object.fromEntries(
-              output.packages.map((p) => [p.name, p.url])
-            );
-
-            const commitUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/commit/${sha}`;
-
-            const body = `## Jazz pre-release
-
-            ### Packages:
-            
-            \`\`\`json
-            ${JSON.stringify(resolutions, null, 4)}
-            \`\`\`
-
-            [View Commit](${commitUrl})`;
-
-            async function logPublishInfo() {
-              console.log('\n' + '='.repeat(50));
-              console.log('Publish Information');
-              console.log('='.repeat(50));
-              console.log('\nPublished Packages:');
-              console.log(output.packages);
-              console.log('\nTemplates:');
-              console.log(templates);
-              console.log(`\nCommit URL: ${commitUrl}`);
-              console.log('\n' + '='.repeat(50));
-            }
-
-            if (context.eventName === 'pull_request') {
-              if (context.issue.number) {
-                await github.rest.issues.createComment({
-                  issue_number: context.issue.number,
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  body: body,
-                });
-              }
-            } else if (context.eventName === 'push') {
-              const pullRequests = await github.rest.pulls.list({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                state: 'open',
-                head: `${context.repo.owner}:${context.ref.replace(
-                  'refs/heads/',
-                  ''
-                )}`,
-              });
-
-              if (pullRequests.data.length > 0) {
-                await github.rest.issues.createComment({
-                  issue_number: pullRequests.data[0].number,
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  body: body,
-                });
-              } else {
-                console.log(
-                  'No open pull request found for this push. Logging publish information to console:'
-                );
-                await logPublishInfo();
-              }
-            }

.github/workflows/release.yml

@@ -1,46 +0,0 @@
-name: Release
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-    inputs:
-      debug_enabled:
-        type: boolean
-        description: "Run tmate session for debugging"
-        required: false
-        default: false
-
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-
-jobs:
-  release:
-    name: Release
-    runs-on: blacksmith-4vcpu-ubuntu-2404
-    steps:
-      - name: Checkout Repo
-        uses: actions/checkout@v4
-
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
-
-      - name: Build packages
-        run: pnpm exec turbo run build --filter='./packages/*'
-
-      - name: Create Release Pull Request or Publish to npm
-        id: changesets
-        uses: changesets/action@v1
-        with:
-          version: pnpm changeset-version
-          publish: pnpm release
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      # Enable tmate debugging only if the workflow is manually triggered, debug_enabled is true, and the workflow failed
-      - name: Setup tmate session for debugging
-        if: ${{ failure() && github.event_name == 'workflow_dispatch' && inputs.debug_enabled }}
-        uses: mxschmitt/action-tmate@v3
-        with:
-          timeout-minutes: 15

.github/workflows/unit-test.yml

@@ -1,34 +0,0 @@
-name: Unit Tests
-
-concurrency:
-  # For pushes, this lets concurrent runs happen, so each push gets a result.
-  # But for other events (e.g. PRs), we can cancel the previous runs.
-  group: ${{ github.workflow }}-${{ github.event_name == 'push' && github.sha || github.ref }}
-  cancel-in-progress: true
-
-on:
-  pull_request:
-    types: [opened, synchronize, reopened]
-  push:
-    branches:
-      - 'main'
-
-jobs:
-  unit-tests:
-    runs-on: blacksmith-4vcpu-ubuntu-2404
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
-
-      - name: Pnpm Build
-        run: pnpm turbo build --filter="./packages/*"
-
-      - name: Install Playwright Browsers
-        run: pnpm exec playwright install
-
-      - name: Unit Tests
-        run: pnpm test:ci

.gitignore

@@ -3,34 +3,4 @@ yarn-error.log
 lerna-debug.log
 docsTmp
 .DS_Store
-.turbo
-coverage
-.direnv
-
-# Typescript
-**/*.tsbuildinfo
-
-# Next.js
-**/.next
-
-# Vite output
-**/dist
-__screenshots__
-
-# Playwright
-test-results
-
-# Java
-.java-version
-
-.husky
-
-.vscode/*
-.idea/*
-
-.svelte-kit
-
-.cursorrules
-.windsurfrules
-
-playwright-report
+.turbo

.node-version

@@ -1 +0,0 @@
-22

.npmrc

@@ -1 +0,0 @@
-node-linker=hoisted

.nvmrc

@@ -1 +0,0 @@
-22

CODE_OF_CONDUCT.md

@@ -1,131 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, caste, color, religion, or sexual
-identity and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-- Demonstrating empathy and kindness toward other people
-- Being respectful of differing opinions, viewpoints, and experiences
-- Giving and gracefully accepting constructive feedback
-- Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-- Focusing on what is best not just for us as individuals, but for the overall
-  community
-
-Examples of unacceptable behavior include:
-
-- The use of sexualized language or imagery, and sexual attention or advances of
-  any kind
-- Trolling, insulting or derogatory comments, and personal or political attacks
-- Public or private harassment
-- Publishing others' private information, such as a physical or email address,
-  without their explicit permission
-- Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official email address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to [the community leaders responsible for enforcement](mailto:hello@garden.co).
-All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series of
-actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or permanent
-ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior, harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within the
-community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-
-Community Impact Guidelines were inspired by
-[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
-
-For answers to common questions about this code of conduct, see the FAQ at
-[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
-[https://www.contributor-covenant.org/translations][translations].
-
-[homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
-[Mozilla CoC]: https://github.com/mozilla/diversity
-[FAQ]: https://www.contributor-covenant.org/faq
-[translations]: https://www.contributor-covenant.org/translations

CONTRIBUTING.md

@@ -1,99 +0,0 @@
-# Contribution Guide
-
-Thank you for considering contributing to Jazz! Jazz is an open-source framework for building local-first apps. We value your time and effort and are excited to collaborate with you. This guide will help you get started with contributing.
-
-## How to Contribute
-
-### 1. Reporting Bugs
-
-If you find a bug, please [open an issue with as much detail as possible](https://github.com/garden-co/jazz/issues). Include:
-
-- A clear and descriptive title.
-- Steps to reproduce the issue.
-- What you expected to happen.
-- What actually happened.
-
-### 2. Suggesting Enhancements
-
-We welcome all ideas! If you have suggestions, feel free to open an issue marked with the "enhancement" label. Please provide context on why the enhancement would be beneficial and how it could be implemented.
-
-### 3. Pull Requests
-
-1. **Fork the repository** and create your feature branch (see [GitHub's guide on forking a repository](https://docs.github.com/en/get-started/quickstart/fork-a-repo) if you're unfamiliar with the process):
-
-2. **Make your changes**, ensuring that you follow our coding standards (`pnpm format` (prettier) and `pnpm lint` (eslint) will automatically let you know there are issues).
-
-3. **Commit your changes** with a descriptive commit message.
-
-4. **Push to your fork** and submit a pull request.
-
-5. **Describe your pull request**, explaining the problem it solves or the enhancement it adds.
-
-### 4. Code Style Guidelines
-
-- We use [Prettier](https://prettier.io/) for formatting. Please ensure your code is formatted before submitting.
-- Write descriptive comments where necessary.
-
-### 5. Local Setup
-
-You'll need Node.js 22.x installed (we're working on support for 23.x), and pnpm 9.x installed. If you're using nix, run `nix develop` to get a shell with the correct versions of everything installed.
-
-1. **Clone the repository**:
-   ```bash
-   git clone https://github.com/garden-co/jazz.git
-   ```
-
-2. **Install dependencies**:
-   ```bash
-   pnpm install
-   ```
-
-3. **Install homepage dependencies**:
-
-   ```bash
-   cd homepage && pnpm install
-   ```
-
-4. **Go back to the project root**:
-
-   ```bash
-   cd ..
-   ```
-
-4. **Build the packages**:
-
-   ```bash
-   pnpm build:packages
-   ```
-
-5. **Run tests** to verify everything is working:
-   ```bash
-   pnpm test
-   ```
-
-### 6. Testing
-
-Please write tests for any new features or bug fixes. We use Vitest for unit tests, and Playwright for e2e tests. Make sure all tests pass before submitting a pull request.
-
-```bash
-pnpm test
-```
-
-NB: You'll need to run `pnpm exec playwright install` to install the Playwright browsers before first run.
-
-### 7. Communication
-
-- If you're unsure about anything, feel free to ask questions by opening a discussion, reaching out via issues, or on our [Discord](https://discord.gg/utDMjHYg42).
-- Be respectful and constructive, this is a welcoming community for everyone.
-- Please be mindful of GitHub’s [Community Guidelines](https://docs.github.com/en/site-policy/github-terms/github-community-guidelines), which include being kind, avoiding disruptive behavior, and respecting others.
-
-## Code of Conduct
-
-Please read and adhere to our [Code of Conduct](./CODE_OF_CONDUCT.md) to ensure a positive experience for all contributors.
-
----
-
-Thank you again for your interest in contributing to Jazz. Your help makes this project better for everyone!
-
-If you have any questions, don't hesitate to reach out. Let's make something great together!
-

LICENSE.txt

@@ -1,19 +0,0 @@
-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
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-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.

README.md

@@ -1,20 +1,116 @@
-# Jazz - Build local-first apps
+# Jazz - instant sync
 
- **Jazz is an open-source toolkit for building apps with *distributed state.***
+<sub>Homepage: [jazz.tools](https://jazz.tools) &mdash; Docs: [DOCS.md](./DOCS.md) &mdash; Community & support: [Discord](https://discord.gg/utDMjHYg42) &mdash; Updates: [Twitter](https://twitter.com/jazz_tools) & [Email](https://gcmp.io/news)</sub>
 
-## Getting started
+ **Jazz is an open-source toolkit for building apps with *secure sync.***
 
-We recommend reading the [homepage](https://jazz.tools) and [docs](https://jazz.tools/docs) to get an overview of what Jazz is and how it works.
+Quickly build and ship apps with:
 
-If you're interested in contributing, please read [CONTRIBUTING.md](./CONTRIBUTING.md).
+- **Cross-device sync**
+- **Collaborative features** (incl. real-time multiplayer)
+- **Instantly reacting UIs**
+- Local-first storage & offline support
+- File upload and real-time media streaming
 
-For community and support, please join our [Discord](https://discord.gg/utDMjHYg42).
+# What is *secure sync*?
 
----
+**Sync** means that, *instead of making API requests*, you:
 
-- Homepage: [jazz.tools](https://jazz.tools)
-- Docs: [jazz.tools/docs](https://jazz.tools/docs)
-- Community & support: [Discord](https://discord.gg/utDMjHYg42)
-- Updates: [X](https://x.com/jazz_tools) & [Email](https://garden.co/news)
+- **Read and write data as if it was local** &mdash; from anywhere in your app.
+- **Always have data synced to wherever it's needed, instantly:** to other devices of the same user, to other users, to your backend, to your local machine for debugging, etc.
 
-Copyright 2025 &mdash; Garden Computing, Inc.
+**Secure** means that, *instead of relying on your API or DB for access control*, you:
+
+- **Set fine-grained, role-based permissions in `Group`s** that are **synced along with your data**.
+- **Permissions *verifiably enforced* everywhere,** using encryption & signatures under the hood.
+- **Change roles dynamically** for evolving teams, expiring Invite Links and more.
+
+# What's special about Jazz?
+
+Compared to other libraries and frameworks for local-first, sync-based or real-time apps, these are some of the things that make Jazz unique:
+
+- **Jazz is a *batteries-included,* vertically integrated toolkit,** offering everything you need to build an app, including auth, permissions, data model, sync, conflict resolution, blob storage, file uploads, real-time media streaming and more.
+- **Jazz has a *small API surface* of only a few abstractions to learn,** which combine in powerful ways to implement a broad set of features.
+- **Jazz *granularly* loads and caches *only the data that is needed*,** combining *local-first* instant UI reactivity and offline support with the on-demand data efficiency of conventional APIs
+- **Jazz supports end-to-end encryption, but doesn't require it,** allowing you to either manage your user's secret keys for them (based on existing auth flows) or letting your users
+- **Jazz is based on CoJSON, a soon-to-be *open standard,*** which means that there will be a whole ecosystem of compatible libraries and frameworks in a variety of environments &mdash; and it will be easy to achieve (secure) interop between Jazz/CoJSON-based apps and services.
+
+# Jazz Global Mesh
+
+Jazz is open source and you can run your own sync & storage server, but to really provide you with everything you need, we're also running
+**[Jazz Global Mesh](https://jazz.tools/mesh)**, a globally distributed mesh of servers optimized for:
+
+ - **Ultra-low-latency sync** (with geo-aware edge caching and optimal routing)
+ - **Low-cost, reliable storage**
+
+
+**Jazz Global Mesh is free for small volumes of data** and it's the **default syncing peer,** so you can  **start building multi-user Jazz apps with persistent data in minutes,** using only frontend code!
+
+# Getting started
+
+## Example App Walkthrough
+
+**For now the best tutorial is the walkthrough of the [Todo List Example App](#todo-list).**
+
+## General Scenarios
+
+### Building a new, entirely sync-based React app
+
+1. Define your data model with [cojson Collaborative Values (CoValues)](./DOCS.md#covalue).
+2. Implement permission logic using [cojson Groups](./DOCS.md#group).
+3. Build a user interface with [jazz-react](./DOCS.md#jazz-react) and [auto-sub](./DOCS.md#useautosubid).
+
+### Gradually adding sync to an existing React app
+
+Gradually migrate app features to use sync:
+
+1. Define data model for small aspect of your app with [cojson Collaborative Values (CoValues)](./DOCS.md#covalue).
+    - Schema adapters/importers for Prisma/Drizzle/PostgreSQL introspection coming soon.
+2. Map existing permission logic with [cojson Groups](./DOCS.md#group) & integrate existing auth.
+    - Auth integrations coming soon.
+3. Replace some of the React state and API requests in your UI with [jazz-react](./DOCS.md#jazz-react) and [auto-sub](./DOCS.md#useautosubid).
+
+# Example Apps
+
+## Todo List
+
+**A simple collaborative todo list app.**
+
+Live version: https://example-todo.jazz.tools
+
+Source code & walkthrough: [`./examples/todo`](./examples/todo)
+
+Demonstrates:
+  - Defining a data model with `CoMap`s and `CoList`s
+  - Creating data and setting permissions with `Group`s
+  - Fetching, rendering & editing data from nested `CoValue`s with reactive synced queries
+
+
+## Rate-My-Pet
+
+**A simple social polling app.**
+
+Live version: https://example-pets.jazz.tools
+
+Source code (walkthrough coming soon): [`./examples/pets`](./examples/pets)
+
+Demonstrates:
+  - Implementing per-account data streams (reactions) with `CoStream`s
+  - Implementing image upload and progressive image streaming using helpers from `jazz-react-media-images` (on top of CoJSON's `BinaryCoStreams` & `ImageDefinition` convention)
+
+
+# Documentation & API Reference
+
+For now, docs are hosted in a single well-structured markdown file: [`./DOCS.md`](./DOCS.md).
+
+- [Package Overview](./DOCS.md#overview)
+- [`jazz-react` API](./DOCS.md#jazz-react)
+- [`cojson` API](./DOCS.md#cojson)
+- [`jazz-browser-media-images` API](./DOCS.md#jazz-browser-media-images)
+
+
+In the future we'll build a dedicated docs page on the Jazz homepage.
+
+----
+
+Copyright 2023 &mdash; Garden Computing, Inc.

biome.json

@@ -1,83 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.1.3/schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "files": {
-    "ignoreUnknown": false,
-    "includes": [
-      "**",
-      "!**/jazz-tools.json",
-      "!**/ios/**",
-      "!**/android/**",
-      "!**/tests/jazz-svelte/src/**",
-      "!**/examples/**/*svelte*/**",
-      "!**/starters/**/*svelte*/**",
-      "!**/examples/server-worker-inbox/src/routeTree.gen.ts",
-      "!**/homepage/homepage/**",
-      "!**/package.json",
-      "!**/*svelte*/**"
-    ]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space"
-  },
-  "assist": { "actions": { "source": { "organizeImports": "off" } } },
-  "linter": {
-    "enabled": false,
-    "rules": {
-      "recommended": true,
-      "correctness": {
-        "useExhaustiveDependencies": "off",
-        "useImportExtensions": {
-          "level": "error",
-          "options": {
-            "forceJsExtensions": true
-          }
-        }
-      }
-    }
-  },
-  "overrides": [
-    {
-      "includes": ["**/packages/**/src/**"],
-      "linter": {
-        "enabled": true,
-        "rules": {
-          "recommended": false
-        }
-      }
-    },
-    {
-      "includes": [
-        "**/packages/cojson/src/storage/**/*/**",
-        "**/cojson-transport-ws/**"
-      ],
-      "linter": {
-        "enabled": true,
-        "rules": {
-          "recommended": true
-        }
-      }
-    },
-    {
-      "includes": ["**/tests/**"],
-      "linter": {
-        "rules": {
-          "correctness": {
-            "useImportExtensions": "off"
-          },
-          "style": {
-            "noNonNullAssertion": "off"
-          },
-          "suspicious": {
-            "noExplicitAny": "off"
-          }
-        }
-      }
-    }
-  ]
-}

examples/betterauth/.env.example

@@ -1 +0,0 @@
-BETTER_AUTH_SECRET="TEST_SECRET"

examples/betterauth/.gitignore

@@ -1,49 +0,0 @@
-/test-results/
-/playwright-report/
-/blob-report/
-/playwright/.cache/
-sqlite.db
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.*
-.yarn/*
-!.yarn/patches
-!.yarn/plugins
-!.yarn/releases
-!.yarn/versions
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
-# env files (can opt-in for committing if needed)
-.env
-.env.*
-!.env.example
-!.env.test
-
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts

examples/betterauth/CHANGELOG.md

@@ -1,298 +0,0 @@
-# betterauth
-
-## 0.1.25
-
-### Patch Changes
-
-- Updated dependencies [048ac1d]
-  - jazz-tools@0.14.22
-  - jazz-betterauth-server-plugin@0.14.22
-  - jazz-inspector@0.14.22
-  - jazz-react@0.14.22
-  - jazz-react-auth-betterauth@0.14.22
-  - jazz-betterauth-client-plugin@0.14.22
-
-## 0.1.24
-
-### Patch Changes
-
-- Updated dependencies [e7e505e]
-- Updated dependencies [13b57aa]
-- Updated dependencies [5662faa]
-- Updated dependencies [2116a59]
-  - jazz-tools@0.14.21
-  - jazz-betterauth-server-plugin@0.14.21
-  - jazz-inspector@0.14.21
-  - jazz-react@0.14.21
-  - jazz-react-auth-betterauth@0.14.21
-  - jazz-betterauth-client-plugin@0.14.21
-
-## 0.1.23
-
-### Patch Changes
-
-- Updated dependencies [6f72419]
-- Updated dependencies [04b20c2]
-  - jazz-tools@0.14.20
-  - jazz-betterauth-server-plugin@0.14.20
-  - jazz-inspector@0.14.20
-  - jazz-react@0.14.20
-  - jazz-react-auth-betterauth@0.14.20
-  - jazz-betterauth-client-plugin@0.14.20
-
-## 0.1.22
-
-### Patch Changes
-
-- jazz-betterauth-client-plugin@0.14.19
-- jazz-betterauth-server-plugin@0.14.19
-- jazz-react-auth-betterauth@0.14.19
-- jazz-inspector@0.14.19
-- jazz-react@0.14.19
-- jazz-tools@0.14.19
-
-## 0.1.21
-
-### Patch Changes
-
-- Updated dependencies [4b950bc]
-- Updated dependencies [d6d9c0a]
-- Updated dependencies [c559054]
-  - jazz-tools@0.14.18
-  - jazz-betterauth-server-plugin@0.14.18
-  - jazz-inspector@0.14.18
-  - jazz-react@0.14.18
-  - jazz-react-auth-betterauth@0.14.18
-  - jazz-betterauth-client-plugin@0.14.18
-
-## 0.1.20
-
-### Patch Changes
-
-- Updated dependencies [e512df4]
-  - jazz-betterauth-server-plugin@0.14.17
-  - jazz-tools@0.14.17
-  - jazz-betterauth-client-plugin@0.14.17
-  - jazz-inspector@0.14.17
-  - jazz-react@0.14.17
-  - jazz-react-auth-betterauth@0.14.17
-
-## 0.1.19
-
-### Patch Changes
-
-- jazz-betterauth-server-plugin@0.14.16
-- jazz-inspector@0.14.16
-- jazz-react@0.14.16
-- jazz-react-auth-betterauth@0.14.16
-- jazz-tools@0.14.16
-- jazz-betterauth-client-plugin@0.14.16
-
-## 0.1.18
-
-### Patch Changes
-
-- Updated dependencies [f9590f9]
-  - jazz-react@0.14.15
-  - jazz-betterauth-server-plugin@0.14.15
-  - jazz-inspector@0.14.15
-  - jazz-react-auth-betterauth@0.14.15
-  - jazz-tools@0.14.15
-  - jazz-betterauth-client-plugin@0.14.15
-
-## 0.1.17
-
-### Patch Changes
-
-- Updated dependencies [e32a1f7]
-  - jazz-tools@0.14.14
-  - jazz-betterauth-server-plugin@0.14.14
-  - jazz-inspector@0.14.14
-  - jazz-react@0.14.14
-  - jazz-react-auth-betterauth@0.14.14
-  - jazz-betterauth-client-plugin@0.14.14
-
-## 0.1.16
-
-### Patch Changes
-
-- jazz-inspector@0.14.13
-- jazz-react@0.14.13
-- jazz-react-auth-betterauth@0.14.13
-
-## 0.1.15
-
-### Patch Changes
-
-- jazz-inspector@0.14.12
-- jazz-react@0.14.12
-- jazz-react-auth-betterauth@0.14.12
-
-## 0.1.14
-
-### Patch Changes
-
-- Updated dependencies [dc746a2]
-- Updated dependencies [f869d9a]
-- Updated dependencies [3fe6832]
-  - jazz-react-auth-betterauth@0.14.10
-  - jazz-inspector@0.14.10
-  - jazz-react@0.14.10
-  - jazz-tools@0.14.10
-  - jazz-betterauth-server-plugin@0.14.10
-  - jazz-betterauth-client-plugin@0.14.10
-
-## 0.1.13
-
-### Patch Changes
-
-- Updated dependencies [22c2600]
-  - jazz-tools@0.14.9
-  - jazz-betterauth-server-plugin@0.14.9
-  - jazz-inspector@0.14.9
-  - jazz-react@0.14.9
-  - jazz-react-auth-betterauth@0.14.9
-  - jazz-betterauth-client-plugin@0.14.9
-
-## 0.1.12
-
-### Patch Changes
-
-- Updated dependencies [637ae13]
-  - jazz-tools@0.14.8
-  - jazz-betterauth-server-plugin@0.14.8
-  - jazz-inspector@0.14.8
-  - jazz-react@0.14.8
-  - jazz-react-auth-betterauth@0.14.8
-  - jazz-betterauth-client-plugin@0.14.8
-
-## 0.1.11
-
-### Patch Changes
-
-- Updated dependencies [365b0ea]
-  - jazz-tools@0.14.7
-  - jazz-betterauth-server-plugin@0.14.7
-  - jazz-inspector@0.14.7
-  - jazz-react@0.14.7
-  - jazz-react-auth-betterauth@0.14.7
-  - jazz-betterauth-client-plugin@0.14.7
-
-## 0.1.10
-
-### Patch Changes
-
-- Updated dependencies [9d6d9fe]
-- Updated dependencies [9d6d9fe]
-  - jazz-tools@0.14.6
-  - jazz-betterauth-server-plugin@0.14.6
-  - jazz-inspector@0.14.6
-  - jazz-react@0.14.6
-  - jazz-react-auth-betterauth@0.14.6
-  - jazz-betterauth-client-plugin@0.14.6
-
-## 0.1.9
-
-### Patch Changes
-
-- Updated dependencies [91cbb2f]
-- Updated dependencies [20b3d88]
-  - jazz-tools@0.14.5
-  - jazz-betterauth-server-plugin@0.14.5
-  - jazz-inspector@0.14.5
-  - jazz-react@0.14.5
-  - jazz-react-auth-betterauth@0.14.5
-  - jazz-betterauth-client-plugin@0.14.5
-
-## 0.1.8
-
-### Patch Changes
-
-- Updated dependencies [011af55]
-  - jazz-tools@0.14.4
-  - jazz-betterauth-server-plugin@0.14.4
-  - jazz-inspector@0.14.4
-  - jazz-react@0.14.4
-  - jazz-react-auth-betterauth@0.14.4
-  - jazz-betterauth-client-plugin@0.14.4
-
-## 0.1.7
-
-### Patch Changes
-
-- Updated dependencies [3d1027f]
-- Updated dependencies [c240eed]
-  - jazz-tools@0.14.2
-  - jazz-betterauth-server-plugin@0.14.2
-  - jazz-inspector@0.14.2
-  - jazz-react@0.14.2
-  - jazz-react-auth-betterauth@0.14.2
-  - jazz-betterauth-client-plugin@0.14.2
-
-## 0.1.6
-
-### Patch Changes
-
-- Updated dependencies [cdfc105]
-  - jazz-tools@0.14.1
-  - jazz-betterauth-server-plugin@0.14.1
-  - jazz-inspector@0.14.1
-  - jazz-react@0.14.1
-  - jazz-react-auth-betterauth@0.14.1
-  - jazz-betterauth-client-plugin@0.14.1
-
-## 0.1.5
-
-### Patch Changes
-
-- Updated dependencies [5835ed1]
-  - jazz-tools@0.14.0
-  - jazz-betterauth-server-plugin@0.14.0
-  - jazz-inspector@0.14.0
-  - jazz-react@0.14.0
-  - jazz-react-auth-betterauth@0.14.0
-  - jazz-betterauth-client-plugin@0.14.0
-
-## 0.1.4
-
-### Patch Changes
-
-- jazz-betterauth-server-plugin@0.13.32
-- jazz-react@0.13.32
-- jazz-react-auth-betterauth@0.13.32
-- jazz-betterauth-client-plugin@0.13.32
-
-## 0.1.3
-
-### Patch Changes
-
-- Updated dependencies [e5b170f]
-  - jazz-tools@0.13.31
-  - jazz-betterauth-server-plugin@0.13.31
-  - jazz-inspector@0.13.31
-  - jazz-react@0.13.31
-  - jazz-react-auth-betterauth@0.13.31
-  - jazz-betterauth-client-plugin@0.13.31
-
-## 0.1.2
-
-### Patch Changes
-
-- jazz-betterauth-server-plugin@0.13.30
-- jazz-inspector@0.13.30
-- jazz-react@0.13.30
-- jazz-react-auth-betterauth@0.13.30
-- jazz-tools@0.13.30
-- jazz-betterauth-client-plugin@0.13.30
-
-## 0.1.1
-
-### Patch Changes
-
-- Updated dependencies [8e5ff13]
-  - jazz-inspector@0.13.29
-  - jazz-betterauth-server-plugin@0.0.1
-  - jazz-react@0.13.29
-  - jazz-react-auth-betterauth@0.0.1
-  - jazz-tools@0.13.29
-  - jazz-betterauth-client-plugin@0.0.1

examples/betterauth/README.md

@@ -1,82 +0,0 @@
-# Better Auth Integration Example
-
-This example demonstrates how to integrate [Better Auth](https://www.better-auth.com/) with Jazz.
-
-## 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.
-
-### 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)
-- `GITHUB_CLIENT_SECRET`: The client secret for the GitHub OAuth provider used by the self-hosted Better Auth server (required only if `NEXT_PUBLIC_AUTH_BASE_URL` is undefined)
-
-### 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 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
-```
-
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.

examples/betterauth/components.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "new-york",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "",
-    "css": "src/styles/globals.css",
-    "baseColor": "neutral",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  },
-  "iconLibrary": "lucide"
-}

examples/betterauth/next.config.ts

@@ -1,7 +0,0 @@
-import type { NextConfig } from "next";
-
-const nextConfig: NextConfig = {
-  /* config options here */
-};
-
-export default nextConfig;

examples/betterauth/package.json

@@ -1,48 +0,0 @@
-{
-	"name": "betterauth",
-	"private": true,
-	"type": "module",
-	"scripts": {
-		"dev": "next dev --turbopack",
-		"build": "next build",
-		"start": "next start",
-		"lint": "next lint",
-		"format-and-lint": "biome check .",
-		"format-and-lint:fix": "biome check . --write",
-		"test:e2e": "playwright test",
-		"test:e2e:ui": "playwright test --ui",
-		"email": "email dev --dir src/components/emails"
-	},
-	"dependencies": {
-		"@icons-pack/react-simple-icons": "^12.8.0",
-		"@radix-ui/react-label": "^2.1.6",
-		"@radix-ui/react-slot": "^1.2.2",
-		"better-auth": "^1.2.4",
-		"better-sqlite3": "^11.9.1",
-		"class-variance-authority": "^0.7.1",
-		"clsx": "^2.1.1",
-		"jazz-react-auth-betterauth": "workspace:*",
-		"jazz-betterauth-client-plugin": "workspace:*",
-		"jazz-betterauth-server-plugin": "workspace:*",
-		"jazz-tools": "workspace:*",
-		"lucide-react": "^0.510.0",
-		"next": "15.3.2",
-		"react": "^18.0.0",
-		"react-dom": "^18.0.0",
-		"sonner": "^2.0.3",
-		"tailwind-merge": "^3.3.0",
-		"tw-animate-css": "^1.2.5"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "1.9.4",
-		"@playwright/test": "^1.50.1",
-		"@tailwindcss/postcss": "^4",
-		"@types/better-sqlite3": "^7.6.12",
-		"@types/node": "^20",
-		"@types/react": "^18",
-		"@types/react-dom": "^18",
-		"react-email": "^4.0.11",
-		"tailwindcss": "^4",
-		"typescript": "^5"
-	}
-}

examples/betterauth/playwright.config.ts

@@ -1,53 +0,0 @@
-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:3000/",
-
-    /* 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 dev",
-      url: "http://localhost:3000/",
-      reuseExistingServer: !isCI,
-    },
-  ],
-});

examples/betterauth/postcss.config.mjs

@@ -1,5 +0,0 @@
-const config = {
-  plugins: ["@tailwindcss/postcss"],
-};
-
-export default config;

examples/betterauth/public/jazz-logo.svg

@@ -1,15 +0,0 @@
-<svg
-      viewBox="0 0 386 146"
-      fill="currentColor"
-      xmlns="http://www.w3.org/2000/svg"
-    >
-      <path id="text"
-        d="M176.725 33.865H188.275V22.7H176.725V33.865ZM164.9 129.4H172.875C182.72 129.4 188.275 123.9 188.275 114.22V43.6H176.725V109.545C176.725 115.65 173.975 118.51 167.925 118.51H164.9V129.4ZM245.298 53.28C241.613 45.47 233.363 41.95 222.748 41.95C208.998 41.95 200.748 48.44 197.888 58.615L208.613 61.915C210.648 55.315 216.368 52.565 222.638 52.565C231.933 52.565 235.673 56.415 236.058 64.61C226.433 65.93 216.643 67.195 209.768 69.23C200.583 72.145 195.743 77.865 195.743 86.83C195.743 96.51 202.673 104.65 215.818 104.65C225.443 104.65 232.318 101.35 237.213 94.365V103H247.388V66.425C247.388 61.475 247.168 57.185 245.298 53.28ZM217.853 95.245C210.483 95.245 207.128 91.34 207.128 86.72C207.128 82.045 210.593 79.515 215.323 77.92C220.328 76.435 226.983 75.5 235.948 74.18C235.893 76.93 235.673 80.725 234.738 83.475C233.418 89.25 227.643 95.245 217.853 95.245ZM251.22 103H301.545V92.715H269.535L303.195 45.47V43.6H254.3V53.885H284.935L251.22 101.185V103ZM304.815 103H355.14V92.715H323.13L356.79 45.47V43.6H307.895V53.885H338.53L304.815 101.185V103Z"
-      />
-      <path
-        fillRule="evenodd"
-        clipRule="evenodd"
-        d="M136.179 44.8277C136.179 44.8277 136.179 44.8277 136.179 44.8276V21.168C117.931 28.5527 97.9854 32.6192 77.0897 32.6192C65.1466 32.6192 53.5138 31.2908 42.331 28.7737V51.4076C42.331 51.4076 42.331 51.4076 42.331 51.4076V81.1508C41.2955 80.4385 40.1568 79.8458 38.9405 79.3915C36.1732 78.358 33.128 78.0876 30.1902 78.6145C27.2524 79.1414 24.5539 80.4419 22.4358 82.3516C20.3178 84.2613 18.8754 86.6944 18.291 89.3433C17.7066 91.9921 18.0066 94.7377 19.1528 97.2329C20.2991 99.728 22.2403 101.861 24.7308 103.361C27.2214 104.862 30.1495 105.662 33.1448 105.662H33.1455C33.6061 105.662 33.8365 105.662 34.0314 105.659C44.5583 105.449 53.042 96.9656 53.2513 86.4386C53.2534 86.3306 53.2544 86.2116 53.2548 86.0486H53.2552V85.7149L53.2552 85.5521V82.0762L53.2552 53.1993C61.0533 54.2324 69.0092 54.7656 77.0897 54.7656C77.6696 54.7656 78.2489 54.7629 78.8276 54.7574V110.696C77.792 109.983 76.6533 109.391 75.437 108.936C72.6697 107.903 69.6246 107.632 66.6867 108.159C63.7489 108.686 61.0504 109.987 58.9323 111.896C56.8143 113.806 55.3719 116.239 54.7875 118.888C54.2032 121.537 54.5031 124.283 55.6494 126.778C56.7956 129.273 58.7368 131.405 61.2273 132.906C63.7179 134.406 66.646 135.207 69.6414 135.207C70.1024 135.207 70.3329 135.207 70.5279 135.203C81.0548 134.994 89.5385 126.51 89.7478 115.983C89.7517 115.788 89.7517 115.558 89.7517 115.097V111.621L89.7517 54.3266C101.962 53.4768 113.837 51.4075 125.255 48.2397V80.9017C124.219 80.1894 123.081 79.5966 121.864 79.1424C119.097 78.1089 116.052 77.8384 113.114 78.3653C110.176 78.8922 107.478 80.1927 105.36 82.1025C103.242 84.0122 101.799 86.4453 101.215 89.0941C100.631 91.743 100.931 94.4886 102.077 96.9837C103.223 99.4789 105.164 101.612 107.655 103.112C110.145 104.612 113.073 105.413 116.069 105.413C116.53 105.413 116.76 105.413 116.955 105.409C127.482 105.2 135.966 96.7164 136.175 86.1895C136.179 85.9945 136.179 85.764 136.179 85.3029V81.8271L136.179 44.8277Z"
-        fill="#146AFF"
-      />
-    </svg>

examples/betterauth/public/jazz.svg

@@ -1,12 +0,0 @@
-<svg
-      xmlns="http://www.w3.org/2000/svg"
-      viewBox="0 0 125 125"
-      fill="none"
-    >
-      <path
-        fillRule="evenodd"
-        clipRule="evenodd"
-        d="M118.179 29.6597V6C99.931 13.3847 79.9854 17.4512 59.0897 17.4512C47.1466 17.4512 35.5138 16.1228 24.331 13.6057V36.2396V65.9828C23.2955 65.2705 22.1568 64.6778 20.9405 64.2235C18.1732 63.19 15.128 62.9196 12.1902 63.4465C9.25242 63.9734 6.55392 65.2739 4.43582 67.1836C2.31782 69.0933 0.875416 71.5264 0.291016 74.1753C-0.293384 76.8241 0.00661504 79.5697 1.15281 82.0649C2.29911 84.56 4.24032 86.693 6.73082 88.193C9.22142 89.694 12.1495 90.494 15.1448 90.494C15.6054 90.494 15.8365 90.494 16.0314 90.491C26.5583 90.281 35.042 81.7976 35.2513 71.2706C35.2534 71.1626 35.2544 71.0436 35.2548 70.8806L35.2552 70.5469V70.3841V66.9082V38.0313C43.0533 39.0644 51.0092 39.5976 59.0897 39.5976C59.6696 39.5976 60.2489 39.5949 60.8276 39.5894V95.528C59.792 94.815 58.6533 94.223 57.437 93.768C54.6697 92.735 51.6246 92.464 48.6867 92.991C45.7489 93.518 43.0504 94.819 40.9323 96.728C38.8143 98.638 37.3719 101.071 36.7875 103.72C36.2032 106.369 36.5031 109.115 37.6494 111.61C38.7956 114.105 40.7368 116.237 43.2273 117.738C45.7179 119.238 48.646 120.039 51.6414 120.039C52.1024 120.039 52.3329 120.039 52.5279 120.035C63.0548 119.826 71.5385 111.342 71.7478 100.815C71.7517 100.62 71.7517 100.39 71.7517 99.929V96.453V39.1586C83.962 38.3088 95.837 36.2395 107.255 33.0717V65.7337C106.219 65.0214 105.081 64.4286 103.864 63.9744C101.097 62.9409 98.052 62.6704 95.114 63.1973C92.176 63.7242 89.478 65.0247 87.36 66.9345C85.242 68.8442 83.799 71.2773 83.215 73.9261C82.631 76.575 82.931 79.3206 84.077 81.8157C85.223 84.3109 87.164 86.444 89.655 87.944C92.145 89.444 95.073 90.245 98.069 90.245C98.53 90.245 98.76 90.245 98.955 90.241C109.482 90.032 117.966 81.5484 118.175 71.0215C118.179 70.8265 118.179 70.596 118.179 70.1349V66.6591V29.6597Z"
-        fill="#146AFF"
-      />
-    </svg>

examples/betterauth/src/app/(app)/layout.tsx

@@ -1,22 +0,0 @@
-import { Navbar } from "@/components/navbar";
-import type { Metadata } from "next";
-
-export const metadata: Metadata = {
-  title: "Jazz Example: Better Auth",
-  description: "Jazz example application demonstrating Better Auth integration",
-};
-
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <>
-      <Navbar />
-      <div className="container mx-auto pt-16 min-h-screen flex flex-col items-center justify-center">
-        {children}
-      </div>
-    </>
-  );
-}

examples/betterauth/src/app/(app)/page.tsx

@@ -1,113 +0,0 @@
-"use client";
-
-import { Button } from "@/components/ui/button";
-import { Account } from "jazz-tools";
-import { useAccount } from "jazz-tools/react";
-import {
-  AppWindowMacIcon,
-  FileTextIcon,
-  GlobeIcon,
-  WrenchIcon,
-} from "lucide-react";
-import Image from "next/image";
-
-export default function Home() {
-  const { me } = useAccount(Account, { resolve: { profile: {} } });
-
-  if (!me) {
-    return null;
-  }
-
-  return (
-    <div className="grow flex flex-col items-center justify-center">
-      <main className="flex flex-col gap-8 row-start-2 grow justify-center">
-        <Image
-          src="/jazz-logo.svg"
-          alt="Jazz logo"
-          width={180}
-          height={38}
-          priority
-        />
-        <p className="text-sm/6 text-center sm:text-left">
-          Signed in as{" "}
-          <span className="bg-black/[.05] dark:bg-white/[.06] px-1 py-0.5 rounded font-mono font-semibold">
-            {me.profile.name}
-          </span>{" "}
-          with id{" "}
-          <span className="bg-black/[.05] dark:bg-white/[.06] px-1 py-0.5 rounded font-mono font-semibold">
-            {me.id}
-          </span>
-        </p>
-
-        <div className="flex gap-4 items-center flex-row">
-          <Button asChild size="lg">
-            <a
-              href="https://jazz.tools/docs"
-              target="_blank"
-              rel="noopener noreferrer"
-            >
-              <Image src="/jazz.svg" alt="" width={20} height={20} />
-              Start building
-            </a>
-          </Button>
-
-          <Button asChild variant="secondary" size="lg">
-            <a
-              href="https://jazz.tools/docs"
-              target="_blank"
-              rel="noopener noreferrer"
-            >
-              <FileTextIcon className="size-4" />
-              Read the docs
-            </a>
-          </Button>
-        </div>
-      </main>
-
-      <footer className="flex gap-4 py-8">
-        <Button asChild variant="ghost">
-          <a
-            href="https://jazz.tools/api-reference"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            <FileTextIcon className="size-4" />
-            API reference
-          </a>
-        </Button>
-        <Button asChild variant="ghost">
-          <a
-            href="https://jazz.tools/examples"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            <AppWindowMacIcon className="size-4" />
-            Examples
-          </a>
-        </Button>
-
-        <Button asChild variant="ghost">
-          <a
-            href="https://jazz.tools/status"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            <GlobeIcon className="size-4" />
-            Status
-          </a>
-        </Button>
-
-        <Button asChild variant="ghost">
-          <a
-            href="https://jazz.tools/showcase"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            <WrenchIcon className="size-4" />
-            Built with Jazz
-          </a>
-        </Button>
-      </footer>
-    </div>
-  );
-}

examples/betterauth/src/app/(app)/settings/page.tsx

@@ -1,14 +0,0 @@
-import { UserSettings } from "@/components/user-settings";
-import type { Metadata } from "next";
-
-export const metadata: Metadata = {
-  title: "Settings | Jazz Example: Better Auth",
-};
-
-export default function SettingsPage() {
-  return (
-    <div className="max-w-screen-md w-full mx-auto px-4">
-      <UserSettings />
-    </div>
-  );
-}

examples/betterauth/src/app/api/auth/[...all]/route.ts

@@ -1,10 +0,0 @@
-import { auth } from "@/lib/auth";
-import { toNextJsHandler } from "better-auth/next-js";
-
-export const { GET, POST } = (() => {
-  if (!process.env.NEXT_PUBLIC_AUTH_BASE_URL) {
-    return toNextJsHandler(auth.handler);
-  } else {
-    return { GET: undefined, POST: undefined };
-  }
-})();

examples/betterauth/src/app/auth/forgot-password/page.tsx

@@ -1,10 +0,0 @@
-import { ForgotPasswordForm } from "@/components/forgot-password-form";
-import type { Metadata } from "next";
-
-export const metadata: Metadata = {
-  title: "Forgot password | Jazz Example: Better Auth",
-};
-
-export default function ForgotPasswordPage() {
-  return <ForgotPasswordForm />;
-}

examples/betterauth/src/app/auth/layout.tsx

@@ -1,23 +0,0 @@
-import Image from "next/image";
-import Link from "next/link";
-
-interface Props {
-  children: React.ReactNode;
-}
-
-export default function AuthLayout({ children }: Props) {
-  return (
-    <div className="bg-muted flex min-h-svh flex-col items-center justify-center gap-6 p-6 md:p-10">
-      <div className="flex w-full max-w-sm flex-col gap-6">
-        <Link
-          href="/"
-          className="flex items-center gap-2 self-center font-medium"
-        >
-          <Image src="/jazz.svg" alt="Jazz Logo" width={24} height={24} />
-          Jazz BetterAuth Demo
-        </Link>
-        {children}
-      </div>
-    </div>
-  );
-}

examples/betterauth/src/app/auth/reset-password/page.tsx

@@ -1,10 +0,0 @@
-import { ResetPasswordForm } from "@/components/reset-password-form";
-import type { Metadata } from "next";
-
-export const metadata: Metadata = {
-  title: "Reset password | Jazz Example: Better Auth",
-};
-
-export default function ResetPasswordPage() {
-  return <ResetPasswordForm />;
-}

examples/betterauth/src/app/auth/sign-in/page.tsx

@@ -1,11 +0,0 @@
-import { SigninForm } from "@/components/signin-form";
-import type { Metadata } from "next";
-import { ssoProviders } from "../sso-providers";
-
-export const metadata: Metadata = {
-  title: "Sign in | Jazz Example: Better Auth",
-};
-
-export default function LoginPage() {
-  return <SigninForm providers={ssoProviders} />;
-}

examples/betterauth/src/app/auth/sign-up/page.tsx

@@ -1,11 +0,0 @@
-import { SignupForm } from "@/components/signup-form";
-import type { Metadata } from "next";
-import { ssoProviders } from "../sso-providers";
-
-export const metadata: Metadata = {
-  title: "Sign up | Jazz Example: Better Auth",
-};
-
-export default function LoginPage() {
-  return <SignupForm providers={ssoProviders} />;
-}

examples/betterauth/src/app/auth/sso-providers.ts

@@ -1,4 +0,0 @@
-import type { SSOProviderType } from "jazz-react-auth-betterauth";
-
-// Fill in the providers you want to use
-export const ssoProviders: SSOProviderType[] = ["github"];

examples/betterauth/src/app/globals.css

@@ -1,123 +0,0 @@
-@import "tailwindcss";
-@import "tw-animate-css";
-
-@custom-variant dark (&:is(.dark *));
-
-:root {
-  --background: oklch(1 0 0);
-  --foreground: oklch(0.145 0 0);
-  --card: oklch(1 0 0);
-  --card-foreground: oklch(0.145 0 0);
-  --popover: oklch(1 0 0);
-  --popover-foreground: oklch(0.145 0 0);
-  --primary: oklch(0.205 0 0);
-  --primary-foreground: oklch(0.985 0 0);
-  --secondary: oklch(0.97 0 0);
-  --secondary-foreground: oklch(0.205 0 0);
-  --muted: oklch(0.97 0 0);
-  --muted-foreground: oklch(0.556 0 0);
-  --accent: oklch(0.97 0 0);
-  --accent-foreground: oklch(0.205 0 0);
-  --destructive: oklch(0.577 0.245 27.325);
-  --destructive-foreground: oklch(0.577 0.245 27.325);
-  --border: oklch(0.922 0 0);
-  --input: oklch(0.922 0 0);
-  --ring: oklch(0.708 0 0);
-  --chart-1: oklch(0.646 0.222 41.116);
-  --chart-2: oklch(0.6 0.118 184.704);
-  --chart-3: oklch(0.398 0.07 227.392);
-  --chart-4: oklch(0.828 0.189 84.429);
-  --chart-5: oklch(0.769 0.188 70.08);
-  --radius: 0.625rem;
-  --sidebar: oklch(0.985 0 0);
-  --sidebar-foreground: oklch(0.145 0 0);
-  --sidebar-primary: oklch(0.205 0 0);
-  --sidebar-primary-foreground: oklch(0.985 0 0);
-  --sidebar-accent: oklch(0.97 0 0);
-  --sidebar-accent-foreground: oklch(0.205 0 0);
-  --sidebar-border: oklch(0.922 0 0);
-  --sidebar-ring: oklch(0.708 0 0);
-}
-
-.dark {
-  --background: oklch(0.145 0 0);
-  --foreground: oklch(0.985 0 0);
-  --card: oklch(0.145 0 0);
-  --card-foreground: oklch(0.985 0 0);
-  --popover: oklch(0.145 0 0);
-  --popover-foreground: oklch(0.985 0 0);
-  --primary: oklch(0.985 0 0);
-  --primary-foreground: oklch(0.205 0 0);
-  --secondary: oklch(0.269 0 0);
-  --secondary-foreground: oklch(0.985 0 0);
-  --muted: oklch(0.269 0 0);
-  --muted-foreground: oklch(0.708 0 0);
-  --accent: oklch(0.269 0 0);
-  --accent-foreground: oklch(0.985 0 0);
-  --destructive: oklch(0.396 0.141 25.723);
-  --destructive-foreground: oklch(0.637 0.237 25.331);
-  --border: oklch(0.269 0 0);
-  --input: oklch(0.269 0 0);
-  --ring: oklch(0.439 0 0);
-  --chart-1: oklch(0.488 0.243 264.376);
-  --chart-2: oklch(0.696 0.17 162.48);
-  --chart-3: oklch(0.769 0.188 70.08);
-  --chart-4: oklch(0.627 0.265 303.9);
-  --chart-5: oklch(0.645 0.246 16.439);
-  --sidebar: oklch(0.205 0 0);
-  --sidebar-foreground: oklch(0.985 0 0);
-  --sidebar-primary: oklch(0.488 0.243 264.376);
-  --sidebar-primary-foreground: oklch(0.985 0 0);
-  --sidebar-accent: oklch(0.269 0 0);
-  --sidebar-accent-foreground: oklch(0.985 0 0);
-  --sidebar-border: oklch(0.269 0 0);
-  --sidebar-ring: oklch(0.439 0 0);
-}
-
-@theme inline {
-  --color-background: var(--background);
-  --color-foreground: var(--foreground);
-  --color-card: var(--card);
-  --color-card-foreground: var(--card-foreground);
-  --color-popover: var(--popover);
-  --color-popover-foreground: var(--popover-foreground);
-  --color-primary: var(--primary);
-  --color-primary-foreground: var(--primary-foreground);
-  --color-secondary: var(--secondary);
-  --color-secondary-foreground: var(--secondary-foreground);
-  --color-muted: var(--muted);
-  --color-muted-foreground: var(--muted-foreground);
-  --color-accent: var(--accent);
-  --color-accent-foreground: var(--accent-foreground);
-  --color-destructive: var(--destructive);
-  --color-destructive-foreground: var(--destructive-foreground);
-  --color-border: var(--border);
-  --color-input: var(--input);
-  --color-ring: var(--ring);
-  --color-chart-1: var(--chart-1);
-  --color-chart-2: var(--chart-2);
-  --color-chart-3: var(--chart-3);
-  --color-chart-4: var(--chart-4);
-  --color-chart-5: var(--chart-5);
-  --radius-sm: calc(var(--radius) - 4px);
-  --radius-md: calc(var(--radius) - 2px);
-  --radius-lg: var(--radius);
-  --radius-xl: calc(var(--radius) + 4px);
-  --color-sidebar: var(--sidebar);
-  --color-sidebar-foreground: var(--sidebar-foreground);
-  --color-sidebar-primary: var(--sidebar-primary);
-  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
-  --color-sidebar-accent: var(--sidebar-accent);
-  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
-  --color-sidebar-border: var(--sidebar-border);
-  --color-sidebar-ring: var(--sidebar-ring);
-}
-
-@layer base {
-  * {
-    @apply border-border outline-ring/50;
-  }
-  body {
-    @apply bg-background text-foreground;
-  }
-}