fix: The .load function now returns null on error

1656 Document loading and subscriptions

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/breezy-boxes-unite.md

@@ -0,0 +1,6 @@
+---
+"jazz-tools": minor
+"cojson": minor
+---
+
+Check CoValue access permissions when loading

.changeset/config.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@2.3.1/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [
+    [
+      "cojson",
+      "cojson-storage",
+      "cojson-storage-indexeddb",
+      "cojson-storage-sqlite",
+      "cojson-storage-rn-sqlite",
+      "cojson-transport-ws",
+      "jazz-browser",
+      "jazz-auth-clerk",
+      "jazz-browser-media-images",
+      "jazz-inspector",
+      "jazz-nodejs",
+      "jazz-react",
+      "jazz-react-core",
+      "jazz-react-auth-clerk",
+      "jazz-react-native",
+      "jazz-react-native-auth-clerk",
+      "jazz-react-native-media-images",
+      "jazz-run",
+      "jazz-svelte",
+      "jazz-tools",
+      "jazz-vue"
+    ]
+  ],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": [],
+  "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
+    "onlyUpdatePeerDependentsWhenOutOfRange": true
+  }
+}

.changeset/fast-beans-decide.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": minor
+---
+
+Implement new API for deep loading

.changeset/forty-tips-swim.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": minor
+---
+
+The .load function now returns `null` on error

.changeset/funny-birds-flash.md

@@ -0,0 +1,5 @@
+---
+"cojson": minor
+---
+
+Return the EVERYONE role if the account is not direct a member of the group

.changeset/thin-melons-give.md

@@ -0,0 +1,5 @@
+---
+"jazz-vue": patch
+---
+
+Fix types compilation for useAccount

.editorconfig

@@ -0,0 +1,11 @@
+# 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

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

.git-blame-ignore-revs

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

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

@@ -0,0 +1,39 @@
+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

@@ -0,0 +1,36 @@
+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/workflows/build-and-deploy.yaml

@@ -1,81 +0,0 @@
-name: Build and Deploy
-
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-
-jobs:
-  build-and-deploy:
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v3
-      with:
-        submodules: true
-
-    - uses: actions/setup-node@v3
-      with:
-        node-version: 18
-        cache: 'yarn'
-        cache-dependency-path: yarn.lock
-    - name: Nuke Workspace
-      run: |
-        rm package.json yarn.lock;
-    - name: Yarn Build
-      run: |
-        yarn install --frozen-lockfile;
-        yarn build;
-      working-directory: ./examples/todo
-
-    - uses: satackey/action-docker-layer-caching@v0.0.11
-      continue-on-error: true
-      with:
-        key: docker-layer-caching-${{ github.workflow }}-{hash}
-        restore-keys: |
-          docker-layer-caching-${{ github.workflow }}-
-
-    - name: Login to GitHub Container Registry
-      uses: docker/login-action@v1
-      with:
-        registry: ghcr.io
-        username: gardencmp
-        password: ${{ secrets.GITHUB_TOKEN }}
-
-    - name: Docker Build & Push
-      run: |
-        export DOCKER_TAG=ghcr.io/gardencmp/jazz-example-todo:${{github.head_ref || github.ref_name}}-${{github.sha}}-$(date +%s) ;
-        docker build . --file Dockerfile --tag $DOCKER_TAG;
-        docker push $DOCKER_TAG;
-        echo "DOCKER_TAG=$DOCKER_TAG" >> $GITHUB_ENV
-      working-directory: ./examples/todo
-
-    - 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=${{ env.DOCKER_TAG }};
-
-        for region in ${{ vars.DEPLOY_REGIONS }}
-        do
-          export REGION=$region;
-          envsubst '${DOCKER_USER} ${DOCKER_PASSWORD} ${DOCKER_TAG} ${BRANCH_SUFFIX} ${BRANCH_SUBDOMAIN} ${REGION}' < job-template.nomad > job-instance.nomad;
-          cat job-instance.nomad;
-          NOMAD_ADDR='${{ secrets.NOMAD_ADDR }}' nomad job run job-instance.nomad;
-        done
-      working-directory: ./examples/todo

.github/workflows/build-examples.yaml

@@ -0,0 +1,37 @@
+name: Build Examples
+
+on:
+  push:
+    branches: [ "main" ]
+
+jobs:
+  build-examples:
+    runs-on: blacksmith-4vcpu-ubuntu-2204
+    strategy:
+      matrix:
+        example: [
+          "chat",
+          "clerk",
+          "passkey",
+          "inspector",
+          "music-player",
+          "password-manager",
+          "pets",
+          "reactions",
+          "todo",
+        ]
+
+    steps:
+    - name: Checkout
+      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: ./examples/${{ matrix.example }}

.github/workflows/build-starters.yaml

@@ -0,0 +1,26 @@
+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/code-quality.yml

@@ -0,0 +1,18 @@
+name: Code quality
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  quality:
+    runs-on: blacksmith-4vcpu-ubuntu-2204
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Biome
+        uses: biomejs/setup-biome@v2
+        with:
+          version: latest
+      - name: Run Biome
+        run: biome ci .

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

@@ -0,0 +1,85 @@
+name: End-to-End Tests for React Native
+
+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/**"
+      - "examples/chat-rn-clerk/**"
+      - "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 App Pre Build
+        working-directory: ./examples/chat-rn
+        run: |
+          pnpm build
+          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/
+          script: ./test/e2e/run.sh
+
+      - 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

@@ -0,0 +1,28 @@
+name: Jazz Run Tests
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  test:
+    runs-on: blacksmith-4vcpu-ubuntu-2204
+    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

@@ -0,0 +1,43 @@
+name: Playwright Tests
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  test:
+    timeout-minutes: 60
+    runs-on: blacksmith-4vcpu-ubuntu-2204
+    continue-on-error: true
+    strategy:
+      matrix:
+        project: ["tests/e2e", "examples/chat", "examples/file-share-svelte", "examples/form", "examples/music-player", "examples/pets", "starters/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 turbo build
+        working-directory: ./${{ matrix.project }}
+
+      - name: Install Playwright Browsers
+        run: pnpm exec playwright install
+        working-directory: ./${{ matrix.project }}
+
+      - name: Run Playwright tests
+        run: pnpm exec playwright test
+        working-directory: ./${{ matrix.project }}
+
+      - uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: ${{ hashFiles(format('{0}/package.json', matrix.project)) }}-playwright-report
+          path: ./${{ matrix.project }}/playwright-report/
+          retention-days: 30

.github/workflows/pre-release.yml

@@ -0,0 +1,102 @@
+name: Pre-Publish tagged Pull Requests
+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

@@ -0,0 +1,46 @@
+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-2204
+    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

@@ -0,0 +1,28 @@
+name: Unit Tests
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  push:
+    branches:
+      - 'main'
+
+jobs:
+  unit-tests:
+    runs-on: blacksmith-4vcpu-ubuntu-2204
+
+    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

@@ -1,3 +1,27 @@
 node_modules
 yarn-error.log
-lerna-debug.log
+lerna-debug.log
+docsTmp
+.DS_Store
+.turbo
+coverage
+.direnv
+
+# Typescript
+**/*.tsbuildinfo
+
+# Next.js
+**/.next
+
+# Vite output
+**/dist
+__screenshots__
+
+# Playwright
+test-results
+
+.husky
+
+.vscode/settings.json
+
+.svelte-kit

.node-version

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

.npmrc

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

.nvmrc

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

CODE_OF_CONDUCT.md

@@ -0,0 +1,131 @@
+# 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

@@ -0,0 +1,99 @@
+# 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
+   ```
+
+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

@@ -0,0 +1,19 @@
+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,9 +1,20 @@
-# Jazz - instant sync
+# Jazz - Build local-first apps
 
-Jazz is an open-source toolkit for telepathic data.
+ **Jazz is an open-source toolkit for building apps with *distributed state.***
 
-Ship faster and simplify frontend, backend & devops by building with Telepathic Data.
-Get real-time multiplayer and cross-device sync for free.
+## Getting started
 
-## What is Telepathic Data?
-...
+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.
+
+If you're interested in contributing, please read [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+For community and support, please join our [Discord](https://discord.gg/utDMjHYg42).
+
+---
+
+- 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)
+
+Copyright 2025 — Garden Computing, Inc.

biome.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "ignore": [
+      "jazz-tools.json",
+      "**/ios/**",
+      "**/android/**",
+      "packages/jazz-svelte/**",
+      "examples/*svelte*/**",
+      "homepage/homepage/**",
+      "**/package.json"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": false,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "useImportExtensions": {
+          "level": "error",
+          "options": {
+            "suggestedExtensions": {
+              "ts": {
+                "module": "js",
+                "component": "jsx"
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "overrides": [
+    {
+      "include": ["packages/**/src/**"],
+      "linter": {
+        "enabled": true,
+        "rules": {
+          "recommended": false
+        }
+      }
+    },
+    {
+      "include": ["packages/cojson-storage*/**", "cojson-transport-ws/**"],
+      "linter": {
+        "enabled": true,
+        "rules": {
+          "recommended": true
+        }
+      }
+    },
+    {
+      "include": ["packages/**/src/tests/**"],
+      "linter": {
+        "rules": {
+          "correctness": {
+            "useImportExtensions": "off"
+          },
+          "style": {
+            "noNonNullAssertion": "off"
+          },
+          "suspicious": {
+            "noExplicitAny": "info"
+          }
+        }
+      }
+    }
+  ]
+}

examples/chat-rn-clerk/.env

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

examples/chat-rn-clerk/.gitignore

@@ -0,0 +1,17 @@
+node_modules/
+.expo/
+dist/
+npm-debug.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+*.orig.*
+web-build/
+
+# macOS
+.DS_Store
+
+ios
+android

examples/chat-rn-clerk/CHANGELOG.md

@@ -0,0 +1,820 @@
+# chat-rn-clerk
+
+## 1.0.87
+
+### 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.
+- Updated dependencies [e7c85b7]
+  - jazz-react-native@0.11.6
+  - jazz-tools@0.11.6
+  - jazz-react-native-auth-clerk@0.11.6
+  - jazz-react-native-media-images@0.11.6
+
+## 1.0.86
+
+### Patch Changes
+
+- jazz-react-native@0.11.5
+- jazz-react-native-auth-clerk@0.11.5
+- jazz-tools@0.11.5
+- jazz-react-native-media-images@0.11.5
+
+## 1.0.85
+
+### Patch Changes
+
+- Updated dependencies [57a3dbe]
+- Updated dependencies [a717754]
+- Updated dependencies [a91f343]
+  - jazz-tools@0.11.4
+  - jazz-react-native@0.11.4
+  - jazz-react-native-auth-clerk@0.11.4
+  - jazz-react-native-media-images@0.11.4
+
+## 1.0.84
+
+### Patch Changes
+
+- jazz-react-native@0.11.3
+- jazz-react-native-auth-clerk@0.11.3
+- jazz-tools@0.11.3
+- jazz-react-native-media-images@0.11.3
+
+## 1.0.83
+
+### Patch Changes
+
+- Updated dependencies [6892dc6]
+  - jazz-tools@0.11.2
+  - jazz-react-native@0.11.2
+  - jazz-react-native-auth-clerk@0.11.2
+  - jazz-react-native-media-images@0.11.2
+
+## 1.0.82
+
+### Patch Changes
+
+- jazz-react-native@0.11.1
+- jazz-react-native-auth-clerk@0.11.1
+
+## 1.0.81
+
+### Patch Changes
+
+- Updated dependencies [6a96d8b]
+- Updated dependencies [a35249a]
+- Updated dependencies [b9d194a]
+- Updated dependencies [a4713df]
+- Updated dependencies [34cbdc3]
+- Updated dependencies [f039e8f]
+- Updated dependencies [e22de9f]
+  - jazz-tools@0.11.0
+  - jazz-react-native-media-images@0.11.0
+  - jazz-react-native-auth-clerk@0.11.0
+  - jazz-react-native@0.11.0
+
+## 1.0.80
+
+### Patch Changes
+
+- Updated dependencies [2f99de0]
+  - jazz-tools@0.10.15
+  - jazz-react-native@0.10.15
+  - jazz-react-native-auth-clerk@0.10.15
+  - jazz-react-native-media-images@0.10.15
+
+## 1.0.79
+
+### Patch Changes
+
+- Updated dependencies [75211e3]
+  - jazz-tools@0.10.14
+  - jazz-react-native@0.10.14
+  - jazz-react-native-auth-clerk@0.10.14
+  - jazz-react-native-media-images@0.10.14
+
+## 1.0.78
+
+### Patch Changes
+
+- Updated dependencies [07feedd]
+  - jazz-tools@0.10.13
+  - jazz-react-native@0.10.13
+  - jazz-react-native-auth-clerk@0.10.13
+  - jazz-react-native-media-images@0.10.13
+
+## 1.0.77
+
+### Patch Changes
+
+- Updated dependencies [4612e05]
+  - jazz-tools@0.10.12
+  - jazz-react-native@0.10.12
+  - jazz-react-native-auth-clerk@0.10.12
+  - jazz-react-native-media-images@0.10.12
+
+## 1.0.76
+
+### Patch Changes
+
+- Updated dependencies [5a54e4a]
+  - jazz-react-native@0.10.11
+  - jazz-react-native-auth-clerk@0.10.11
+
+## 1.0.75
+
+### Patch Changes
+
+- Updated dependencies [3405d8f]
+  - jazz-react-native@0.10.10
+  - jazz-react-native-auth-clerk@0.10.10
+
+## 1.0.74
+
+### Patch Changes
+
+- jazz-react-native-auth-clerk@0.10.9
+
+## 1.0.73
+
+### Patch Changes
+
+- Updated dependencies [2fb6428]
+  - jazz-tools@0.10.8
+  - jazz-react-native@0.10.8
+  - jazz-react-native-auth-clerk@0.10.8
+  - jazz-react-native-media-images@0.10.8
+
+## 1.0.72
+
+### Patch Changes
+
+- Updated dependencies [1136d9b]
+- Updated dependencies [0eed228]
+  - jazz-react-native@0.10.7
+  - jazz-tools@0.10.7
+  - jazz-react-native-auth-clerk@0.10.7
+  - jazz-react-native-media-images@0.10.7
+
+## 1.0.71
+
+### Patch Changes
+
+- Updated dependencies [ada802b]
+  - jazz-tools@0.10.6
+  - jazz-react-native@0.10.6
+  - jazz-react-native-auth-clerk@0.10.6
+  - jazz-react-native-media-images@0.10.6
+
+## 1.0.70
+
+### Patch Changes
+
+- Updated dependencies [59ff77e]
+  - jazz-tools@0.10.5
+  - jazz-react-native@0.10.5
+  - jazz-react-native-auth-clerk@0.10.5
+  - jazz-react-native-media-images@0.10.5
+
+## 1.0.69
+
+### Patch Changes
+
+- jazz-react-native@0.10.4
+- jazz-react-native-auth-clerk@0.10.4
+- jazz-tools@0.10.4
+- jazz-react-native-media-images@0.10.4
+
+## 1.0.68
+
+### Patch Changes
+
+- Updated dependencies [d8582fc]
+  - jazz-tools@0.10.3
+  - jazz-react-native@0.10.3
+  - jazz-react-native-auth-clerk@0.10.3
+  - jazz-react-native-media-images@0.10.3
+
+## 1.0.67
+
+### Patch Changes
+
+- jazz-react-native@0.10.2
+- jazz-react-native-auth-clerk@0.10.2
+- jazz-tools@0.10.2
+- jazz-react-native-media-images@0.10.2
+
+## 1.0.66
+
+### Patch Changes
+
+- Updated dependencies [5a63cba]
+  - jazz-tools@0.10.1
+  - jazz-react-native@0.10.1
+  - jazz-react-native-auth-clerk@0.10.1
+  - jazz-react-native-media-images@0.10.1
+
+## 1.0.65
+
+### Patch Changes
+
+- Updated dependencies [498954f]
+- Updated dependencies [d42c2aa]
+- Updated dependencies [dd03464]
+- Updated dependencies [b426342]
+  - jazz-react-native-auth-clerk@0.10.0
+  - jazz-react-native@0.10.0
+  - jazz-tools@0.10.0
+  - jazz-react-native-media-images@0.10.0
+
+## 1.0.64
+
+### Patch Changes
+
+- jazz-react-native@0.9.23
+- jazz-react-native-auth-clerk@0.9.23
+- jazz-tools@0.9.23
+- jazz-react-native-media-images@0.9.23
+
+## 1.0.63
+
+### Patch Changes
+
+- jazz-react-native@0.9.22
+- jazz-react-native-auth-clerk@0.9.22
+
+## 1.0.62
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react-native@0.9.21
+  - jazz-react-native-auth-clerk@0.9.21
+  - jazz-react-native-media-images@0.9.21
+
+## 1.0.61
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react-native@0.9.20
+  - jazz-react-native-auth-clerk@0.9.20
+  - jazz-react-native-media-images@0.9.20
+
+## 1.0.60
+
+### Patch Changes
+
+- jazz-react-native@0.9.19
+- jazz-react-native-auth-clerk@0.9.19
+- jazz-tools@0.9.19
+- jazz-react-native-media-images@0.9.19
+
+## 1.0.59
+
+### Patch Changes
+
+- jazz-react-native@0.9.18
+- jazz-react-native-auth-clerk@0.9.18
+- jazz-tools@0.9.18
+- jazz-react-native-media-images@0.9.18
+
+## 1.0.58
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react-native@0.9.17
+  - jazz-react-native-auth-clerk@0.9.17
+  - jazz-react-native-media-images@0.9.17
+
+## 1.0.57
+
+### Patch Changes
+
+- Updated dependencies [24b3b6a]
+  - jazz-react-native-auth-clerk@0.9.16
+  - jazz-tools@0.9.16
+  - jazz-react-native@0.9.16
+  - jazz-react-native-media-images@0.9.16
+
+## 1.0.56
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react-native@0.9.15
+  - jazz-react-native-auth-clerk@0.9.15
+  - jazz-react-native-media-images@0.9.15
+
+## 1.0.55
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react-native@0.9.14
+  - jazz-react-native-auth-clerk@0.9.14
+  - jazz-react-native-media-images@0.9.14
+
+## 1.0.54
+
+### Patch Changes
+
+- jazz-react-native@0.9.13
+- jazz-react-native-auth-clerk@0.9.13
+- jazz-tools@0.9.13
+- jazz-react-native-media-images@0.9.13
+
+## 1.0.53
+
+### Patch Changes
+
+- jazz-react-native@0.9.12
+- jazz-react-native-auth-clerk@0.9.12
+- jazz-tools@0.9.12
+- jazz-react-native-media-images@0.9.12
+
+## 1.0.52
+
+### Patch Changes
+
+- jazz-react-native@0.9.11
+- jazz-react-native-auth-clerk@0.9.11
+- jazz-tools@0.9.11
+- jazz-react-native-media-images@0.9.11
+
+## 1.0.51
+
+### Patch Changes
+
+- f76274c: Fix image handling in react-native
+- Updated dependencies [f76274c]
+- Updated dependencies [5e83864]
+  - jazz-react-native@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-react-native-auth-clerk@0.9.10
+  - jazz-react-native-media-images@0.9.10
+
+## 1.0.50
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react-native@0.9.9
+  - jazz-react-native-auth-clerk@0.9.9
+  - jazz-react-native-media-images@0.9.9
+
+## 1.0.49
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react-native@0.9.8
+  - jazz-react-native-auth-clerk@0.9.8
+  - jazz-react-native-media-images@0.9.8
+
+## 1.0.48
+
+### Patch Changes
+
+- Updated dependencies [8a390d2]
+  - jazz-react-native@0.9.6
+  - jazz-react-native-auth-clerk@0.9.6
+
+## 1.0.47
+
+### Patch Changes
+
+- Updated dependencies [c871912]
+  - jazz-react-native@0.9.5
+  - jazz-react-native-auth-clerk@0.9.5
+
+## 1.0.46
+
+### Patch Changes
+
+- jazz-react-native@0.9.4
+- jazz-react-native-auth-clerk@0.9.4
+
+## 1.0.45
+
+### Patch Changes
+
+- Updated dependencies [7cd691f]
+  - jazz-react-native@0.9.3
+  - jazz-react-native-auth-clerk@0.9.3
+
+## 1.0.44
+
+### Patch Changes
+
+- Updated dependencies [80fd3e9]
+  - jazz-react-native@0.9.2
+  - jazz-react-native-auth-clerk@0.9.2
+
+## 1.0.43
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-tools@0.9.1
+  - jazz-react-native@0.9.1
+  - jazz-react-native-auth-clerk@0.9.1
+  - jazz-react-native-media-images@0.9.1
+
+## 1.0.42
+
+### Patch Changes
+
+- Updated dependencies [1da4d55]
+- Updated dependencies [8eda792]
+- Updated dependencies [1e5e3a1]
+  - jazz-react-native@0.9.0
+  - jazz-tools@0.9.0
+  - jazz-react-native-auth-clerk@0.9.0
+  - jazz-react-native-media-images@0.9.0
+
+## 1.0.41
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-react-native@0.8.51
+  - jazz-react-native-auth-clerk@0.8.51
+  - jazz-react-native-media-images@0.8.51
+
+## 1.0.40
+
+### Patch Changes
+
+- jazz-react-native@0.8.50
+- jazz-react-native-auth-clerk@0.8.50
+- jazz-tools@0.8.50
+- jazz-react-native-media-images@0.8.50
+
+## 1.0.39
+
+### Patch Changes
+
+- jazz-react-native@0.8.49
+- jazz-react-native-auth-clerk@0.8.49
+- jazz-tools@0.8.49
+- jazz-react-native-media-images@0.8.49
+
+## 1.0.38
+
+### Patch Changes
+
+- Updated dependencies [635e824]
+- Updated dependencies [0a85982]
+  - jazz-tools@0.8.48
+  - jazz-react-native@0.8.48
+  - jazz-react-native-auth-clerk@0.8.48
+  - jazz-react-native-media-images@0.8.48
+
+## 1.0.37
+
+### Patch Changes
+
+- Updated dependencies [33ef9c4]
+  - jazz-react-native@0.8.47
+  - jazz-react-native-auth-clerk@0.8.47
+
+## 1.0.36
+
+### Patch Changes
+
+- Updated dependencies [ab4ffbd]
+  - jazz-react-native@0.8.46
+  - jazz-react-native-auth-clerk@0.8.46
+
+## 1.0.35
+
+### Patch Changes
+
+- Updated dependencies [7701307]
+- Updated dependencies [fa41f8e]
+- Updated dependencies [88d7d9a]
+- Updated dependencies [60e35ea]
+  - jazz-react-native@0.8.45
+  - jazz-tools@0.8.45
+  - jazz-react-native-auth-clerk@0.8.45
+  - jazz-react-native-media-images@0.8.45
+
+## 1.0.34
+
+### Patch Changes
+
+- jazz-react-native@0.8.44
+- jazz-react-native-auth-clerk@0.8.44
+- jazz-tools@0.8.44
+- jazz-react-native-media-images@0.8.44
+
+## 1.0.33
+
+### Patch Changes
+
+- cdc7f9f: Fixing react-native examples
+- Updated dependencies [cdc7f9f]
+  - jazz-react-native-auth-clerk@0.8.43
+
+## 1.0.32
+
+### Patch Changes
+
+- jazz-react-native@0.8.41
+- jazz-react-native-auth-clerk@0.8.41
+- jazz-tools@0.8.41
+- jazz-react-native-media-images@0.8.41
+
+## 1.0.31
+
+### Patch Changes
+
+- Updated dependencies [0c6b0f3]
+- Updated dependencies [249eecb]
+  - jazz-react-native@0.8.39
+  - jazz-tools@0.8.39
+  - jazz-react-native-auth-clerk@0.8.39
+  - jazz-react-native-media-images@0.8.39
+
+## 1.0.30
+
+### Patch Changes
+
+- jazz-react-native@0.8.38
+- jazz-react-native-auth-clerk@0.8.38
+- jazz-tools@0.8.38
+- jazz-react-native-media-images@0.8.38
+
+## 1.0.29
+
+### Patch Changes
+
+- jazz-react-native@0.8.37
+- jazz-react-native-auth-clerk@0.8.37
+- jazz-tools@0.8.37
+- jazz-react-native-media-images@0.8.28
+
+## 1.0.28
+
+### Patch Changes
+
+- c84764a: feat: added jazz-react-native-auth-clerk package
+- Updated dependencies [c84764a]
+- Updated dependencies [441fe27]
+  - jazz-react-native-auth-clerk@0.8.36
+  - jazz-react-native@0.8.36
+  - jazz-tools@0.8.36
+  - jazz-react-native-media-images@0.8.27
+
+## 1.0.27
+
+### Patch Changes
+
+- Updated dependencies [8b87117]
+  - jazz-tools@0.8.35
+  - jazz-react-auth-clerk@0.8.35
+  - jazz-react-native@0.8.35
+  - jazz-react-native-media-images@0.8.26
+
+## 1.0.26
+
+### Patch Changes
+
+- Updated dependencies [9ca25d1]
+  - jazz-react-auth-clerk@0.8.34
+  - jazz-react-native@0.8.34
+  - jazz-tools@0.8.34
+  - jazz-react-native-media-images@0.8.25
+
+## 1.0.25
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.33
+
+## 1.0.24
+
+### Patch Changes
+
+- Updated dependencies [1a4bda0]
+- Updated dependencies [df42b2b]
+  - jazz-react-auth-clerk@0.8.32
+  - jazz-tools@0.8.32
+  - jazz-react-native@0.8.32
+  - jazz-react-native-media-images@0.8.24
+
+## 1.0.23
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.31
+- jazz-react-native@0.8.31
+- jazz-tools@0.8.31
+- jazz-react-native-media-images@0.8.23
+
+## 1.0.22
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.30
+- jazz-react-native@0.8.30
+- jazz-tools@0.8.30
+- jazz-react-native-media-images@0.8.22
+
+## 1.0.21
+
+### Patch Changes
+
+- jazz-react-native@0.8.29
+- jazz-react-auth-clerk@0.8.29
+- jazz-tools@0.8.29
+- jazz-react-native-media-images@0.8.21
+
+## 1.0.20
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.28
+- jazz-react-native@0.8.28
+- jazz-tools@0.8.28
+- jazz-react-native-media-images@0.8.20
+
+## 1.0.19
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.27
+- jazz-react-native@0.8.27
+- jazz-tools@0.8.27
+- jazz-react-native-media-images@0.8.19
+
+## 1.0.18
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.26
+
+## 1.0.17
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.24
+
+## 1.0.16
+
+### Patch Changes
+
+- Updated dependencies [d348c2d]
+- Updated dependencies [6902b5b]
+- Updated dependencies [1a0cd3d]
+  - jazz-tools@0.8.23
+  - jazz-react-auth-clerk@0.8.23
+  - jazz-react-native@0.8.23
+  - jazz-react-native-media-images@0.8.18
+
+## 1.0.15
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.22
+
+## 1.0.14
+
+### Patch Changes
+
+- Updated dependencies [149ca97]
+  - jazz-tools@0.8.21
+  - jazz-react-auth-clerk@0.8.21
+  - jazz-react-native@0.8.21
+  - jazz-react-native-media-images@0.8.17
+
+## 1.0.13
+
+### Patch Changes
+
+- Updated dependencies [3ef3ff3]
+  - jazz-react-native-media-images@0.8.16
+  - jazz-react-native@0.8.20
+  - jazz-react-auth-clerk@0.8.20
+
+## 1.0.12
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.19
+- jazz-react-native@0.8.19
+- jazz-tools@0.8.19
+- jazz-react-native-media-images@0.8.15
+
+## 1.0.11
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.18
+- jazz-react-native@0.8.18
+- jazz-tools@0.8.18
+- jazz-react-native-media-images@0.8.14
+
+## 1.0.10
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.17
+- jazz-react-native@0.8.17
+- jazz-tools@0.8.17
+- jazz-react-native-media-images@0.8.13
+
+## 1.0.9
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.16
+- jazz-react-native@0.8.16
+- jazz-tools@0.8.16
+- jazz-react-native-media-images@0.8.12
+
+## 1.0.8
+
+### Patch Changes
+
+- Updated dependencies [cce679b]
+- Updated dependencies [221c58f]
+  - jazz-tools@0.8.15
+  - jazz-react-auth-clerk@0.8.15
+  - jazz-react-native@0.8.15
+  - jazz-react-native-media-images@0.8.11
+
+## 1.0.7
+
+### Patch Changes
+
+- Updated dependencies [36273b3]
+  - jazz-tools@0.8.14
+  - jazz-react-auth-clerk@0.8.14
+  - jazz-react-native@0.8.14
+  - jazz-react-native-media-images@0.8.10
+
+## 1.0.6
+
+### Patch Changes
+
+- Updated dependencies [fd011d7]
+  - jazz-tools@0.8.13
+  - jazz-react-auth-clerk@0.8.13
+  - jazz-react-native@0.8.13
+  - jazz-react-native-media-images@0.8.9
+
+## 1.0.5
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.12
+- jazz-react-native@0.8.12
+- jazz-tools@0.8.12
+- jazz-react-native-media-images@0.8.8
+
+## 1.0.4
+
+### Patch Changes
+
+- jazz-react-auth-clerk@0.8.11
+- jazz-react-native@0.8.11
+- jazz-tools@0.8.11
+- jazz-react-native-media-images@0.8.7
+
+## 1.0.3
+
+### Patch Changes
+
+- b7639cf: feat(react-native): replaced react-native-mmkv with expo-secure-store and initialize it by default as kvStore in createJazzRNApp() (BREAKING)
+- Updated dependencies [b7639cf]
+  - jazz-react-native@0.8.8
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies [32b05b6]
+  - jazz-react-native-media-images@0.8.6
+  - jazz-react-native@0.8.7
+  - jazz-react-auth-clerk@0.8.7
+
+## 1.0.1
+
+### Patch Changes
+
+- jazz-react-native@0.8.6
+- jazz-react-auth-clerk@0.8.6

examples/chat-rn-clerk/README.md

@@ -0,0 +1,24 @@
+# 🎷 Jazz + Expo + `expo-router` + Clerk Auth
+
+## 🚀 How to Run
+
+### 1. Inside the Workspace Root
+
+First, install dependencies and build the project:
+
+```bash
+pnpm i
+pnpm run build
+```
+
+### 2. Inside the `examples/chat-rn-clerk` Directory
+
+Next, navigate to the specific example project and run the following commands:
+
+```bash
+pnpm expo prebuild
+npx pod-install
+pnpm expo run:ios
+```
+
+This will set up and launch the app on iOS. For Android, you can replace the last command with `pnpm expo run:android`.

examples/chat-rn-clerk/app.json

@@ -0,0 +1,54 @@
+{
+  "expo": {
+    "name": "jazz-chat-rn-clerk",
+    "scheme": "jazz-chat-rn-clerk",
+    "slug": "jazz-chat-rn-clerk",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/images/icon.png",
+    "userInterfaceStyle": "light",
+    "splash": {
+      "image": "./assets/images/splash.png",
+      "resizeMode": "contain",
+      "backgroundColor": "#ffffff"
+    },
+    "ios": {
+      "supportsTablet": true,
+      "bundleIdentifier": "com.jazz.chatrnclerk"
+    },
+    "android": {
+      "adaptiveIcon": {
+        "foregroundImage": "./assets/images/adaptive-icon.png",
+        "backgroundColor": "#ffffff"
+      },
+      "package": "com.jazz.chatrnclerk"
+    },
+    "plugins": [
+      [
+        "expo-build-properties",
+        {
+          "ios": {
+            "newArchEnabled": true
+          },
+          "android": {
+            "newArchEnabled": true
+          }
+        }
+      ],
+      "expo-secure-store",
+      "expo-font",
+      "expo-router",
+      [
+        "expo-image-picker",
+        {
+          "photosPermission": "The app accesses your photos to let you share them with your friends."
+        }
+      ]
+    ],
+    "extra": {
+      "eas": {
+        "projectId": "ca3d46e5-a10a-47ec-9d77-3b841e1c62d4"
+      }
+    }
+  }
+}

examples/chat-rn-clerk/app/(app)/_layout.tsx

@@ -0,0 +1,15 @@
+import { Redirect, Stack } from "expo-router";
+import { useIsAuthenticated } from "jazz-react-native";
+import React from "react";
+
+export default function HomeLayout() {
+  const isAuthenticated = useIsAuthenticated();
+
+  if (isAuthenticated) {
+    return <Redirect href={"/chat"} />;
+  }
+
+  return (
+    <Stack screenOptions={{ headerShown: false, headerBackVisible: true }} />
+  );
+}

examples/chat-rn-clerk/app/(app)/index.tsx

@@ -0,0 +1,33 @@
+import { SignedOut } from "@clerk/clerk-expo";
+import { Link } from "expo-router";
+import React from "react";
+import { Text, View } from "react-native";
+
+export default function HomePage() {
+  return (
+    <View className="flex-1 justify-center items-center bg-gray-100 p-6">
+      <SignedOut>
+        <View className="bg-white p-6 rounded-lg shadow-lg w-11/12 max-w-md">
+          <Text className="text-2xl font-bold text-center text-gray-900 mb-4">
+            Jazz 🤝 Clerk 🤝 Expo
+          </Text>
+          <Link href="/sign-in" className="mb-4">
+            <Text className="text-center text-blue-600 underline text-lg">
+              Sign In
+            </Text>
+          </Link>
+          <Link href="/sign-in-oauth" className="mb-4">
+            <Text className="text-center text-blue-600 underline text-lg">
+              Sign In OAuth
+            </Text>
+          </Link>
+          <Link href="/sign-up">
+            <Text className="text-center text-blue-600 underline text-lg">
+              Sign Up
+            </Text>
+          </Link>
+        </View>
+      </SignedOut>
+    </View>
+  );
+}

examples/chat-rn-clerk/app/(auth)/_layout.tsx

@@ -0,0 +1,20 @@
+import { Redirect, Stack } from "expo-router";
+import { useIsAuthenticated } from "jazz-react-native";
+
+export default function UnAuthenticatedLayout() {
+  const isAuthenticated = useIsAuthenticated();
+
+  if (isAuthenticated) {
+    return <Redirect href={"/chat"} />;
+  }
+
+  return (
+    <Stack
+      screenOptions={{
+        headerShown: true,
+        headerBackVisible: true,
+        headerTitle: "",
+      }}
+    />
+  );
+}

examples/chat-rn-clerk/app/(auth)/sign-in-oauth.tsx

@@ -0,0 +1,65 @@
+import { useOAuth } from "@clerk/clerk-expo";
+import * as Linking from "expo-linking";
+import { Link } from "expo-router";
+import * as WebBrowser from "expo-web-browser";
+import React from "react";
+import { Text, TouchableOpacity, View } from "react-native";
+
+export const useWarmUpBrowser = () => {
+  React.useEffect(() => {
+    // Warm up the android browser to improve UX
+    // https://docs.expo.dev/guides/authentication/#improving-user-experience
+    void WebBrowser.warmUpAsync();
+    return () => {
+      void WebBrowser.coolDownAsync();
+    };
+  }, []);
+};
+
+WebBrowser.maybeCompleteAuthSession();
+
+const SignInWithOAuth = () => {
+  useWarmUpBrowser();
+
+  const { startOAuthFlow } = useOAuth({ strategy: "oauth_google" });
+
+  const onPress = React.useCallback(async () => {
+    try {
+      const { createdSessionId, signIn, signUp, setActive } =
+        await startOAuthFlow({
+          redirectUrl: Linking.createURL("/", {
+            scheme: "jazz-chat-rn-clerk",
+          }),
+        });
+
+      if (createdSessionId) {
+        setActive!({ session: createdSessionId });
+      } else {
+        // Use signIn or signUp for next steps such as MFA
+      }
+    } catch (err) {
+      console.error("OAuth error", err);
+    }
+  }, []);
+
+  return (
+    <View className="flex-1 justify-center items-center bg-gray-50 p-6">
+      <View className="bg-white w-11/12 max-w-md p-8 rounded-lg shadow-lg items-center">
+        <TouchableOpacity
+          onPress={onPress}
+          className="w-full bg-red-500 py-3 rounded-lg flex items-center justify-center"
+        >
+          <Text className="text-white text-lg font-semibold">
+            Sign in with Google
+          </Text>
+        </TouchableOpacity>
+        <Link href="/" className="mt-4">
+          <Text className="text-blue-600 text-lg font-semibold underline mb-6">
+            Back to Home
+          </Text>
+        </Link>
+      </View>
+    </View>
+  );
+};
+export default SignInWithOAuth;

examples/chat-rn-clerk/app/(auth)/sign-in.tsx

@@ -0,0 +1,79 @@
+import { useSignIn } from "@clerk/clerk-expo";
+import { Link } from "expo-router";
+import React from "react";
+import { Text, TextInput, TouchableOpacity, View } from "react-native";
+
+export default function SignInPage() {
+  const { signIn, setActive, isLoaded } = useSignIn();
+  const [emailAddress, setEmailAddress] = React.useState("");
+  const [password, setPassword] = React.useState("");
+  const [errorMessage, setErrorMessage] = React.useState("");
+
+  const onSignInPress = React.useCallback(async () => {
+    if (!isLoaded) {
+      return;
+    }
+
+    setErrorMessage("");
+
+    try {
+      const signInAttempt = await signIn.create({
+        identifier: emailAddress,
+        password,
+      });
+
+      if (signInAttempt.status === "complete") {
+        await setActive({ session: signInAttempt.createdSessionId });
+      } else {
+        console.error(JSON.stringify(signInAttempt, null, 2));
+        setErrorMessage("Invalid credentials. Please try again.");
+      }
+    } catch (err: any) {
+      console.error(JSON.stringify(err, null, 2));
+      if (err.errors && err.errors[0]?.message) {
+        setErrorMessage(err.errors[0].message);
+      } else {
+        setErrorMessage("An unexpected error occurred. Please try again.");
+      }
+    }
+  }, [isLoaded, emailAddress, password]);
+
+  return (
+    <View className="flex-1 justify-center items-center bg-gray-50 p-6">
+      <View className="bg-white w-11/12 max-w-md p-8 rounded-lg shadow-md">
+        <Text className="text-3xl font-bold text-center text-gray-800 mb-6">
+          Sign In
+        </Text>
+        {errorMessage ? (
+          <Text className="text-red-500 text-center mb-4">{errorMessage}</Text>
+        ) : null}
+        <TextInput
+          autoCapitalize="none"
+          value={emailAddress}
+          placeholder="Email..."
+          onChangeText={(emailAddress) => setEmailAddress(emailAddress)}
+          className="w-full h-12 mb-4 px-4 bg-gray-100 border border-gray-300 rounded-lg focus:border-blue-500 focus:outline-none"
+        />
+        <TextInput
+          value={password}
+          placeholder="Password..."
+          secureTextEntry={true}
+          onChangeText={(password) => setPassword(password)}
+          className="w-full h-12 mb-6 px-4 bg-gray-100 border border-gray-300 rounded-lg focus:border-blue-500 focus:outline-none"
+        />
+        <TouchableOpacity
+          onPress={onSignInPress}
+          className="w-full h-12 bg-blue-600 rounded-lg flex items-center justify-center"
+        >
+          <Text className="text-white text-lg font-semibold">Sign In</Text>
+        </TouchableOpacity>
+        <View className="flex-row items-center justify-center mt-4">
+          <Text className="text-gray-600">Don't have an account?</Text>
+          <Link href="/sign-up">
+            <Text className="text-blue-500 ml-2 font-semibold">Sign up</Text>
+          </Link>
+        </View>
+      </View>
+    </View>
+  );
+}

examples/chat-rn-clerk/app/(auth)/sign-up.tsx

@@ -0,0 +1,120 @@
+import { useSignUp } from "@clerk/clerk-expo";
+import { useNavigation } from "@react-navigation/native";
+import * as React from "react";
+import { Text, TextInput, TouchableOpacity, View } from "react-native";
+
+export default function SignUpPage() {
+  const { isLoaded, signUp, setActive } = useSignUp();
+
+  const [emailAddress, setEmailAddress] = React.useState("");
+  const [password, setPassword] = React.useState("");
+  const [pendingVerification, setPendingVerification] = React.useState(false);
+  const [code, setCode] = React.useState("");
+  const [errorMessage, setErrorMessage] = React.useState("");
+  const navigation = useNavigation();
+
+  const onSignUpPress = async () => {
+    if (!isLoaded) return;
+
+    setErrorMessage("");
+
+    try {
+      await signUp.create({
+        emailAddress,
+        password,
+      });
+
+      await signUp.prepareEmailAddressVerification({
+        strategy: "email_code",
+      });
+
+      setPendingVerification(true);
+    } catch (err: any) {
+      console.error(JSON.stringify(err, null, 2));
+      if (err.errors && err.errors[0]?.message) {
+        setErrorMessage(err.errors[0].message);
+      } else {
+        setErrorMessage("An unexpected error occurred. Please try again.");
+      }
+    }
+  };
+
+  const onPressVerify = async () => {
+    if (!isLoaded) return;
+
+    setErrorMessage("");
+
+    try {
+      const completeSignUp = await signUp.attemptEmailAddressVerification({
+        code,
+      });
+
+      if (completeSignUp.status === "complete") {
+        await setActive({ session: completeSignUp.createdSessionId });
+      } else {
+        console.error(JSON.stringify(completeSignUp, null, 2));
+        setErrorMessage("Failed to verify. Please check your code.");
+      }
+    } catch (err: any) {
+      console.error(JSON.stringify(err, null, 2));
+      setErrorMessage("Invalid verification code. Please try again.");
+    }
+  };
+
+  return (
+    <View className="flex-1 justify-center items-center bg-gray-50 p-6">
+      <View className="bg-white w-11/12 max-w-md p-8 rounded-lg shadow-lg">
+        <Text className="text-3xl font-bold text-center text-gray-800 mb-6">
+          {pendingVerification ? "Verify Email" : "Sign Up"}
+        </Text>
+        {errorMessage ? (
+          <Text className="text-red-500 text-center mb-4">{errorMessage}</Text>
+        ) : null}
+
+        {!pendingVerification && (
+          <>
+            <TextInput
+              autoCapitalize="none"
+              value={emailAddress}
+              placeholder="Email..."
+              onChangeText={(email) => setEmailAddress(email)}
+              className="w-full h-12 mb-4 px-4 bg-gray-100 border border-gray-300 rounded-lg focus:border-blue-500 focus:outline-none"
+            />
+            <TextInput
+              value={password}
+              placeholder="Password..."
+              secureTextEntry={true}
+              onChangeText={(password) => setPassword(password)}
+              className="w-full h-12 mb-6 px-4 bg-gray-100 border border-gray-300 rounded-lg focus:border-blue-500 focus:outline-none"
+            />
+            <TouchableOpacity
+              onPress={onSignUpPress}
+              className="w-full h-12 bg-blue-600 rounded-lg flex justify-center items-center mb-4"
+            >
+              <Text className="text-white text-lg font-semibold">Sign Up</Text>
+            </TouchableOpacity>
+          </>
+        )}
+
+        {pendingVerification && (
+          <>
+            <TextInput
+              value={code}
+              placeholder="Verification Code..."
+              onChangeText={(code) => setCode(code)}
+              className="w-full h-12 mb-4 px-4 bg-gray-100 border border-gray-300 rounded-lg focus:border-blue-500 focus:outline-none"
+            />
+            <TouchableOpacity
+              onPress={onPressVerify}
+              className="w-full h-12 bg-green-600 rounded-lg flex justify-center items-center mb-4"
+            >
+              <Text className="text-white text-lg font-semibold">
+                Verify Email
+              </Text>
+            </TouchableOpacity>
+          </>
+        )}
+      </View>
+    </View>
+  );
+}

examples/chat-rn-clerk/app/+html.tsx

@@ -0,0 +1,42 @@
+import { ScrollViewStyleReset } from "expo-router/html";
+import { type PropsWithChildren } from "react";
+
+/**
+ * This file is web-only and used to configure the root HTML for every web page during static rendering.
+ * The contents of this function only run in Node.js environments and do not have access to the DOM or browser APIs.
+ */
+export default function Root({ children }: PropsWithChildren) {
+  return (
+    <html lang="en">
+      <head>
+        <meta charSet="utf-8" />
+        <meta httpEquiv="X-UA-Compatible" content="IE=edge" />
+        <meta
+          name="viewport"
+          content="width=device-width, initial-scale=1, shrink-to-fit=no"
+        />
+
+        {/*
+          Disable body scrolling on web. This makes ScrollView components work closer to how they do on native.
+          However, body scrolling is often nice to have for mobile web. If you want to enable it, remove this line.
+        */}
+        <ScrollViewStyleReset />
+
+        {/* Using raw CSS styles as an escape-hatch to ensure the background color never flickers in dark-mode. */}
+        <style dangerouslySetInnerHTML={{ __html: responsiveBackground }} />
+        {/* Add any additional <head> elements that you want globally available on web... */}
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+
+const responsiveBackground = `
+body {
+  background-color: #fff;
+}
+@media (prefers-color-scheme: dark) {
+  body {
+    background-color: #000;
+  }
+}`;

examples/chat-rn-clerk/app/+not-found.tsx

@@ -0,0 +1,29 @@
+import { Link, Stack } from "expo-router";
+import { StyleSheet, Text, View } from "react-native";
+
+export default function NotFoundScreen() {
+  return (
+    <>
+      <Stack.Screen options={{ title: "Oops!" }} />
+      <View style={styles.container}>
+        <Text>This screen doesn't exist.</Text>
+        <Link href="/" style={styles.link}>
+          <Text>Go to home screen!</Text>
+        </Link>
+      </View>
+    </>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    alignItems: "center",
+    justifyContent: "center",
+    padding: 20,
+  },
+  link: {
+    marginTop: 15,
+    paddingVertical: 15,
+  },
+});

examples/chat-rn-clerk/app/_layout.tsx

@@ -0,0 +1,49 @@
+import "../global.css";
+import { ClerkLoaded, ClerkProvider } from "@clerk/clerk-expo";
+import { secureStore } from "@clerk/clerk-expo/secure-store";
+import { useFonts } from "expo-font";
+import { Slot } from "expo-router";
+import * as SplashScreen from "expo-splash-screen";
+import React, { useEffect } from "react";
+import { tokenCache } from "../cache";
+import { JazzAndAuth } from "../src/auth-context";
+
+SplashScreen.preventAutoHideAsync();
+
+export default function RootLayout() {
+  const [loaded] = useFonts({
+    SpaceMono: require("../assets/fonts/SpaceMono-Regular.ttf"),
+  });
+
+  useEffect(() => {
+    if (loaded) {
+      SplashScreen.hideAsync();
+    }
+  }, [loaded]);
+
+  if (!loaded) {
+    return null;
+  }
+
+  const publishableKey = process.env.EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY;
+
+  if (!publishableKey) {
+    throw new Error(
+      "Missing Publishable Key. Please set EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY in your .env",
+    );
+  }
+
+  return (
+    <ClerkProvider
+      tokenCache={tokenCache}
+      publishableKey={publishableKey}
+      __experimental_resourceCache={secureStore}
+    >
+      <ClerkLoaded>
+        <JazzAndAuth>
+          <Slot />
+        </JazzAndAuth>
+      </ClerkLoaded>
+    </ClerkProvider>
+  );
+}

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

@@ -0,0 +1,224 @@
+import { Chat, Message } from "@/src/schema";
+import { useNavigation } from "@react-navigation/native";
+import clsx from "clsx";
+import * as Clipboard from "expo-clipboard";
+import * as ImagePicker from "expo-image-picker";
+import { useLocalSearchParams } from "expo-router";
+import { useAccount, useCoState } from "jazz-react-native";
+import { ProgressiveImg } from "jazz-react-native";
+import { createImage } from "jazz-react-native-media-images";
+import { Group, ID } from "jazz-tools";
+import { useEffect, useLayoutEffect, useState } from "react";
+import React, {
+  SafeAreaView,
+  View,
+  Text,
+  Alert,
+  TouchableOpacity,
+  FlatList,
+  KeyboardAvoidingView,
+  TextInput,
+  Button,
+  Image,
+  ActivityIndicator,
+} from "react-native";
+
+export default function Conversation() {
+  const { chatId } = useLocalSearchParams();
+  const { me } = useAccount();
+  const [chat, setChat] = useState<Chat>();
+  const [message, setMessage] = useState("");
+  const loadedChat = useCoState(Chat, chat?.id, { resolve: { $each: true } });
+  const navigation = useNavigation();
+  const [isUploading, setIsUploading] = useState(false);
+
+  useEffect(() => {
+    if (chat) return;
+    if (chatId === "new") {
+      createChat();
+    } else {
+      loadChat(chatId as ID<Chat>);
+    }
+  }, [chat]);
+
+  // Effect to dynamically set header options
+  useLayoutEffect(() => {
+    navigation.setOptions({
+      headerTitle: "Chat",
+      headerRight: () =>
+        chat ? (
+          <Button
+            onPress={() => {
+              if (chat?.id) {
+                Clipboard.setStringAsync(
+                  `https://chat.jazz.tools/#/chat/${chat.id}`,
+                );
+                Alert.alert("Copied to clipboard", `Chat ID: ${chat.id}`);
+              }
+            }}
+            title="Share"
+          />
+        ) : null,
+    });
+  }, [navigation, chat]);
+
+  const createChat = () => {
+    const group = Group.create({ owner: me });
+    group.addMember("everyone", "writer");
+    const chat = Chat.create([], { owner: group });
+    setChat(chat);
+  };
+
+  const loadChat = async (chatId: ID<Chat>) => {
+    try {
+      const chat = await Chat.load(chatId, me);
+      setChat(chat);
+    } catch (error) {
+      console.log("Error loading chat", error);
+      Alert.alert("Error", `Error loading chat: ${error}`);
+    }
+  };
+
+  const sendMessage = () => {
+    if (!chat) return;
+    if (message.trim()) {
+      chat.push(Message.create({ text: message }, { owner: chat._owner }));
+      setMessage("");
+    }
+  };
+
+  const handleImageUpload = async () => {
+    try {
+      const result = await ImagePicker.launchImageLibraryAsync({
+        mediaTypes: ImagePicker.MediaTypeOptions.Images,
+        base64: true,
+        quality: 0.7,
+      });
+
+      if (!result.canceled && result.assets[0].base64 && chat) {
+        setIsUploading(true);
+        const base64Uri = `data:image/jpeg;base64,${result.assets[0].base64}`;
+
+        const image = await createImage(base64Uri, {
+          owner: chat._owner,
+          maxSize: 2048,
+        });
+
+        chat.push(Message.create({ text: "", image }, { owner: chat._owner }));
+      }
+    } catch (error) {
+      Alert.alert("Error", "Failed to upload image");
+    } finally {
+      setIsUploading(false);
+    }
+  };
+
+  const renderMessageItem = ({ item }: { item: Message }) => {
+    const isMe = item._edits.text.by?.isMe;
+    return (
+      <View
+        className={clsx(
+          `rounded-xl px-3 py-2 max-w-[75%] my-1`,
+          isMe ? `bg-blue-500 self-end` : `bg-gray-200 self-start`,
+        )}
+      >
+        {!isMe ? (
+          <Text
+            className={clsx(
+              `text-xs text-gray-500 mb-1`,
+              isMe ? "text-right" : "text-left",
+            )}
+          >
+            {item._edits.text.by?.profile?.name}
+          </Text>
+        ) : null}
+        <View
+          className={clsx(
+            "flex relative items-end justify-between",
+            isMe ? "flex-row" : "flex-row",
+          )}
+        >
+          {item.image && (
+            <ProgressiveImg image={item.image} maxWidth={1024}>
+              {({ src, res, originalSize }) => (
+                <Image
+                  source={{ uri: src }}
+                  className="w-48 h-48 rounded-lg mb-2"
+                  resizeMode="cover"
+                />
+              )}
+            </ProgressiveImg>
+          )}
+          {item.text && (
+            <Text
+              className={clsx(
+                !isMe ? "text-black" : "text-gray-200",
+                `text-md max-w-[85%]`,
+              )}
+            >
+              {item.text}
+            </Text>
+          )}
+          <Text
+            className={clsx(
+              "text-[10px] text-right ml-2",
+              !isMe ? "mt-2 text-gray-500" : "mt-1 text-gray-200",
+            )}
+          >
+            {item._edits.text.madeAt.getHours()}:
+            {item._edits.text.madeAt.getMinutes()}
+          </Text>
+        </View>
+      </View>
+    );
+  };
+
+  return (
+    <View className="flex-1 bg-gray-50">
+      <FlatList
+        contentContainerStyle={{
+          flexGrow: 1,
+          paddingVertical: 10,
+          paddingHorizontal: 8,
+        }}
+        className="flex"
+        data={loadedChat}
+        keyExtractor={(item) => item.id}
+        renderItem={renderMessageItem}
+      />
+      <KeyboardAvoidingView
+        keyboardVerticalOffset={110}
+        behavior="padding"
+        className="p-3 bg-white border-t border-gray-300"
+      >
+        <SafeAreaView className="flex-row items-center gap-2">
+          <TouchableOpacity
+            onPress={handleImageUpload}
+            disabled={isUploading}
+            className="h-10 w-10 items-center justify-center"
+          >
+            {isUploading ? (
+              <ActivityIndicator size="small" color="#0000ff" />
+            ) : (
+              <Text className="text-2xl">🖼️</Text>
+            )}
+          </TouchableOpacity>
+          <TextInput
+            className="flex-1 rounded-full h-10 px-4 bg-gray-100 border border-gray-300 focus:border-blue-500 focus:bg-white"
+            value={message}
+            onChangeText={setMessage}
+            placeholder="Type a message..."
+            textAlignVertical="center"
+            onSubmitEditing={sendMessage}
+          />
+          <TouchableOpacity
+            onPress={sendMessage}
+            className="bg-blue-500 rounded-full h-10 w-10 items-center justify-center"
+          >
+            <Text className="text-white text-xl">↑</Text>
+          </TouchableOpacity>
+        </SafeAreaView>
+      </KeyboardAvoidingView>
+    </View>
+  );
+}

examples/chat-rn-clerk/app/chat/_layout.tsx

@@ -0,0 +1,14 @@
+import { Stack } from "expo-router";
+import React from "react";
+
+export default function ChatLayout() {
+  return (
+    <Stack
+      screenOptions={{
+        headerShown: true,
+        headerBackVisible: true,
+        headerTitle: "",
+      }}
+    />
+  );
+}

examples/chat-rn-clerk/app/chat/index.tsx

@@ -0,0 +1,90 @@
+import { useNavigation } from "@react-navigation/native";
+import { useRouter } from "expo-router";
+import { ID } from "jazz-tools";
+import { useLayoutEffect } from "react";
+import React, {
+  Button,
+  Text,
+  TouchableOpacity,
+  View,
+  Alert,
+} from "react-native";
+
+import { useUser } from "@clerk/clerk-expo";
+import { useAccount } from "jazz-react-native";
+import { Chat } from "../../src/schema";
+
+export default function ChatScreen() {
+  const { logOut } = useAccount();
+  const router = useRouter();
+  const navigation = useNavigation();
+  const { user } = useUser();
+
+  function handleLogOut() {
+    logOut();
+    router.navigate("/");
+  }
+
+  useLayoutEffect(() => {
+    navigation.setOptions({
+      headerTitle: "Chat",
+      headerRight: () => <Button onPress={handleLogOut} title="Logout" />,
+    });
+  }, [navigation]);
+
+  const loadChat = async (chatId: ID<Chat> | "new") => {
+    router.navigate(`/chat/${chatId}`);
+  };
+
+  const joinChat = () => {
+    Alert.prompt(
+      "Join Chat",
+      "Enter the Chat ID (example: co_zBGEHYvRfGuT2YSBraY3njGjnde)",
+      [
+        {
+          text: "Cancel",
+          style: "cancel",
+        },
+        {
+          text: "Join",
+          onPress: (chatId) => {
+            if (chatId) {
+              loadChat(chatId as ID<Chat>);
+            } else {
+              Alert.alert("Error", "Chat ID cannot be empty.");
+            }
+          },
+        },
+      ],
+      "plain-text",
+    );
+  };
+
+  return (
+    <View className="flex-1 bg-gray-50">
+      <View className="flex-1 justify-center items-center px-6">
+        <View className="w-full max-w-sm bg-white p-8 rounded-lg shadow-lg">
+          <Text className="text-xl font-semibold text-gray-800">
+            Welcome, {user?.emailAddresses[0].emailAddress}
+          </Text>
+          <TouchableOpacity
+            onPress={() => loadChat("new")}
+            className="w-full bg-blue-600 py-4 rounded-md mb-4 mt-4"
+          >
+            <Text className="text-white text-lg font-semibold text-center">
+              Start New Chat
+            </Text>
+          </TouchableOpacity>
+          <TouchableOpacity
+            onPress={joinChat}
+            className="w-full bg-green-500 py-4 rounded-md"
+          >
+            <Text className="text-white text-lg font-semibold text-center">
+              Join Chat
+            </Text>
+          </TouchableOpacity>
+        </View>
+      </View>
+    </View>
+  );
+}

examples/chat-rn-clerk/babel.config.js

@@ -0,0 +1,9 @@
+module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: [
+      ["babel-preset-expo", { jsxImportSource: "nativewind" }],
+      "nativewind/babel",
+    ],
+  };
+};

examples/chat-rn-clerk/cache.ts

@@ -0,0 +1,39 @@
+import * as SecureStore from "expo-secure-store";
+import { Platform } from "react-native";
+
+export interface TokenCache {
+  getToken: (key: string) => Promise<string | undefined | null>;
+  saveToken: (key: string, token: string) => Promise<void>;
+  clearToken: (key: string) => void;
+}
+
+const createTokenCache = (): TokenCache => {
+  return {
+    getToken: async (key: string) => {
+      try {
+        const item = await SecureStore.getItemAsync(key);
+        if (item) {
+          console.log(`${key} was used 🔐 \n`);
+        } else {
+          console.log("No values stored under key: " + key);
+        }
+        return item;
+      } catch (error) {
+        console.error("secure store get item error: ", error);
+        await SecureStore.deleteItemAsync(key);
+        return null;
+      }
+    },
+    saveToken: (key: string, token: string) => {
+      return SecureStore.setItemAsync(key, token);
+    },
+    clearToken: (key: string) => {
+      return SecureStore.deleteItemAsync(key);
+    },
+  };
+};
+
+// SecureStore is not supported on the web
+// https://github.com/expo/expo/issues/7744#issuecomment-611093485
+export const tokenCache =
+  Platform.OS !== "web" ? createTokenCache() : undefined;

examples/chat-rn-clerk/eas.json

@@ -0,0 +1,27 @@
+{
+  "cli": {
+    "version": ">= 12.5.1",
+    "appVersionSource": "remote"
+  },
+  "build": {
+    "development": {
+      "developmentClient": true,
+      "distribution": "internal"
+    },
+    "ios-simulator": {
+      "extends": "development",
+      "ios": {
+        "simulator": true
+      }
+    },
+    "preview": {
+      "distribution": "internal"
+    },
+    "production": {
+      "autoIncrement": true
+    }
+  },
+  "submit": {
+    "production": {}
+  }
+}

examples/chat-rn-clerk/global.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

examples/chat-rn-clerk/index.js

@@ -0,0 +1,2 @@
+import "./polyfills";
+import "expo-router/entry";

examples/chat-rn-clerk/metro.config.js

@@ -0,0 +1,35 @@
+// Learn more https://docs.expo.dev/guides/monorepos
+const { getDefaultConfig } = require("expo/metro-config");
+const { withNativeWind } = require("nativewind/metro");
+const { FileStore } = require("metro-cache");
+const path = require("path");
+
+// eslint-disable-next-line no-undef
+const projectRoot = __dirname;
+const workspaceRoot = path.resolve(projectRoot, "../..");
+
+const config = getDefaultConfig(projectRoot);
+
+// Since we are using pnpm, we have to setup the monorepo manually for Metro
+// #1 - Watch all files in the monorepo
+config.watchFolders = [workspaceRoot];
+// #2 - Try resolving with project modules first, then workspace modules
+config.resolver.nodeModulesPaths = [
+  path.resolve(projectRoot, "node_modules"),
+  path.resolve(workspaceRoot, "node_modules"),
+];
+config.resolver.sourceExts = ["mjs", "js", "json", "ts", "tsx"];
+config.resolver.requireCycleIgnorePatterns = [
+  /(^|\/|\\)node_modules($|\/|\\)/,
+  /(^|\/|\\)packages($|\/|\\)/,
+];
+
+// Use turborepo to restore the cache when possible
+config.cacheStores = [
+  new FileStore({
+    root: path.join(projectRoot, "node_modules", ".cache", "metro"),
+  }),
+];
+
+// module.exports = config;
+module.exports = withNativeWind(config, { input: "./global.css" });

examples/chat-rn-clerk/nativewind-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="nativewind/types" />

examples/chat-rn-clerk/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "chat-rn-clerk",
+  "main": "index.js",
+  "version": "1.0.87",
+  "scripts": {
+    "build": "expo export -p ios",
+    "start": "expo start",
+    "format-and-lint": "biome check .",
+    "format-and-lint:fix": "biome check . --write",
+    "android": "expo run:android",
+    "ios": "expo run:ios",
+    "web": "expo start --web"
+  },
+  "jest": {
+    "preset": "jest-expo"
+  },
+  "dependencies": {
+    "@azure/core-asynciterator-polyfill": "^1.0.2",
+    "@bacons/text-decoder": "0.0.0",
+    "@bam.tech/react-native-image-resizer": "^3.0.11",
+    "@craftzdog/react-native-buffer": "6.0.5",
+    "@clerk/clerk-expo": "^2.2.21",
+    "@expo/vector-icons": "^14.0.2",
+    "@op-engineering/op-sqlite": "^11.2.12",
+    "@react-native-community/netinfo": "^11.4.1",
+    "@react-navigation/native": "^7.0.13",
+    "@react-navigation/native-stack": "^7.1.14",
+    "clsx": "^2.0.0",
+    "expo": "^52.0.0",
+    "expo-build-properties": "~0.13.1",
+    "expo-clipboard": "~7.0.0",
+    "expo-constants": "~17.0.3",
+    "expo-crypto": "~14.0.1",
+    "expo-dev-client": "~5.0.5",
+    "expo-file-system": "^18.0.4",
+    "expo-font": "~13.0.1",
+    "expo-image-picker": "~16.0.4",
+    "expo-linking": "~7.0.3",
+    "expo-router": "~4.0.11",
+    "expo-secure-store": "~14.0.0",
+    "expo-splash-screen": "~0.29.16",
+    "expo-status-bar": "~2.0.0",
+    "expo-system-ui": "~4.0.5",
+    "expo-web-browser": "~14.0.1",
+    "jazz-react-native": "workspace:*",
+    "jazz-react-native-auth-clerk": "workspace:*",
+    "jazz-react-native-media-images": "workspace:*",
+    "jazz-tools": "workspace:*",
+    "nativewind": "^4.1.21",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-native": "~0.76.3",
+    "react-native-gesture-handler": "~2.20.2",
+    "react-native-get-random-values": "^1.11.0",
+    "react-native-reanimated": "~3.16.3",
+    "react-native-safe-area-context": "4.12.0",
+    "react-native-screens": "4.1.0",
+    "react-native-url-polyfill": "^2.0.0",
+    "react-native-web": "~0.19.13",
+    "readable-stream": "4.7.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.20.0",
+    "@types/jest": "^29.5.3",
+    "@types/react": "^18.3.12",
+    "@types/react-test-renderer": "^18.0.7",
+    "jest": "^29.2.1",
+    "jest-expo": "~52.0.2",
+    "react-test-renderer": "18.2.0",
+    "tailwindcss": "^3.4.17",
+    "typescript": "~5.6.2"
+  },
+  "private": true
+}

examples/chat-rn-clerk/polyfills.js

@@ -0,0 +1,17 @@
+/* eslint-disable import/order */
+
+// @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);
+
+import "@azure/core-asynciterator-polyfill";
+
+import "@bacons/text-decoder/install";
+
+import "react-native-get-random-values";

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

@@ -0,0 +1 @@
+export const apiKey = "chat-rn-clerk-example-jazz@garden.co";

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

@@ -0,0 +1,20 @@
+import { useClerk } from "@clerk/clerk-expo";
+import { JazzProviderWithClerk } from "jazz-react-native-auth-clerk";
+import React, { PropsWithChildren } from "react";
+import { apiKey } from "./apiKey";
+
+export function JazzAndAuth({ children }: PropsWithChildren) {
+  const clerk = useClerk();
+
+  return (
+    <JazzProviderWithClerk
+      clerk={clerk}
+      storage="sqlite"
+      sync={{
+        peer: `wss://cloud.jazz.tools/?key=${apiKey}`,
+      }}
+    >
+      {children}
+    </JazzProviderWithClerk>
+  );
+}

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

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

examples/chat-rn-clerk/tailwind.config.js

@@ -0,0 +1,14 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  // NOTE: Update this to include the paths to all of your component files.
+  content: [
+    "./app/**/*.{js,jsx,ts,tsx}",
+    "./components/**/*.{js,jsx,ts,tsx}",
+    "./src/**/*.{js,jsx,ts,tsx}",
+  ],
+  presets: [require("nativewind/preset")],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

examples/chat-rn-clerk/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "moduleResolution": "bundler",
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["**/*.ts", "**/*.tsx", "nativewind-env.d.ts"]
+}

examples/chat-rn/.gitignore

@@ -0,0 +1,38 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+
+# Native
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+ios
+android

examples/chat-rn/CHANGELOG.md

@@ -0,0 +1,645 @@
+# chat-rn
+
+## 1.0.83
+
+### Patch Changes
+
+- Updated dependencies [e7c85b7]
+  - jazz-react-native@0.11.6
+  - jazz-tools@0.11.6
+
+## 1.0.82
+
+### Patch Changes
+
+- jazz-react-native@0.11.5
+- jazz-tools@0.11.5
+
+## 1.0.81
+
+### Patch Changes
+
+- Updated dependencies [57a3dbe]
+- Updated dependencies [a717754]
+- Updated dependencies [a91f343]
+  - jazz-tools@0.11.4
+  - jazz-react-native@0.11.4
+
+## 1.0.80
+
+### Patch Changes
+
+- jazz-react-native@0.11.3
+- jazz-tools@0.11.3
+
+## 1.0.79
+
+### Patch Changes
+
+- Updated dependencies [6892dc6]
+  - jazz-tools@0.11.2
+  - jazz-react-native@0.11.2
+
+## 1.0.78
+
+### Patch Changes
+
+- jazz-react-native@0.11.1
+
+## 1.0.77
+
+### Patch Changes
+
+- Updated dependencies [6a96d8b]
+- Updated dependencies [a35249a]
+- Updated dependencies [b9d194a]
+- Updated dependencies [a4713df]
+- Updated dependencies [34cbdc3]
+- Updated dependencies [f039e8f]
+- Updated dependencies [e22de9f]
+  - jazz-tools@0.11.0
+  - jazz-react-native@0.11.0
+
+## 1.0.76
+
+### Patch Changes
+
+- Updated dependencies [2f99de0]
+  - jazz-tools@0.10.15
+  - jazz-react-native@0.10.15
+
+## 1.0.75
+
+### Patch Changes
+
+- Updated dependencies [75211e3]
+  - jazz-tools@0.10.14
+  - jazz-react-native@0.10.14
+
+## 1.0.74
+
+### Patch Changes
+
+- Updated dependencies [07feedd]
+  - jazz-tools@0.10.13
+  - jazz-react-native@0.10.13
+
+## 1.0.73
+
+### Patch Changes
+
+- Updated dependencies [4612e05]
+  - jazz-tools@0.10.12
+  - jazz-react-native@0.10.12
+
+## 1.0.72
+
+### Patch Changes
+
+- Updated dependencies [5a54e4a]
+  - jazz-react-native@0.10.11
+
+## 1.0.71
+
+### Patch Changes
+
+- Updated dependencies [3405d8f]
+  - jazz-react-native@0.10.10
+
+## 1.0.70
+
+### Patch Changes
+
+- Updated dependencies [2fb6428]
+  - jazz-tools@0.10.8
+  - jazz-react-native@0.10.8
+
+## 1.0.69
+
+### Patch Changes
+
+- Updated dependencies [1136d9b]
+- Updated dependencies [0eed228]
+  - jazz-react-native@0.10.7
+  - jazz-tools@0.10.7
+
+## 1.0.68
+
+### Patch Changes
+
+- Updated dependencies [ada802b]
+  - jazz-tools@0.10.6
+  - jazz-react-native@0.10.6
+
+## 1.0.67
+
+### Patch Changes
+
+- Updated dependencies [59ff77e]
+  - jazz-tools@0.10.5
+  - jazz-react-native@0.10.5
+
+## 1.0.66
+
+### Patch Changes
+
+- jazz-react-native@0.10.4
+- jazz-tools@0.10.4
+
+## 1.0.65
+
+### Patch Changes
+
+- Updated dependencies [d8582fc]
+  - jazz-tools@0.10.3
+  - jazz-react-native@0.10.3
+
+## 1.0.64
+
+### Patch Changes
+
+- jazz-react-native@0.10.2
+- jazz-tools@0.10.2
+
+## 1.0.63
+
+### Patch Changes
+
+- Updated dependencies [5a63cba]
+  - jazz-tools@0.10.1
+  - jazz-react-native@0.10.1
+
+## 1.0.62
+
+### Patch Changes
+
+- Updated dependencies [498954f]
+- Updated dependencies [d42c2aa]
+- Updated dependencies [dd03464]
+- Updated dependencies [b426342]
+  - jazz-react-native@0.10.0
+  - jazz-tools@0.10.0
+
+## 1.0.61
+
+### Patch Changes
+
+- jazz-react-native@0.9.23
+- jazz-tools@0.9.23
+
+## 1.0.60
+
+### Patch Changes
+
+- jazz-react-native@0.9.22
+
+## 1.0.59
+
+### Patch Changes
+
+- Updated dependencies [1be017d]
+  - jazz-tools@0.9.21
+  - jazz-react-native@0.9.21
+
+## 1.0.58
+
+### Patch Changes
+
+- Updated dependencies [b01cc1f]
+  - jazz-tools@0.9.20
+  - jazz-react-native@0.9.20
+
+## 1.0.57
+
+### Patch Changes
+
+- jazz-react-native@0.9.19
+- jazz-tools@0.9.19
+
+## 1.0.56
+
+### Patch Changes
+
+- jazz-react-native@0.9.18
+- jazz-tools@0.9.18
+
+## 1.0.55
+
+### Patch Changes
+
+- Updated dependencies [c2ca1fe]
+- Updated dependencies [1227047]
+  - jazz-tools@0.9.17
+  - jazz-react-native@0.9.17
+
+## 1.0.54
+
+### Patch Changes
+
+- Updated dependencies [24b3b6a]
+  - jazz-tools@0.9.16
+  - jazz-react-native@0.9.16
+
+## 1.0.53
+
+### Patch Changes
+
+- Updated dependencies [7491711]
+  - jazz-tools@0.9.15
+  - jazz-react-native@0.9.15
+
+## 1.0.52
+
+### Patch Changes
+
+- Updated dependencies [3df93cc]
+  - jazz-tools@0.9.14
+  - jazz-react-native@0.9.14
+
+## 1.0.51
+
+### Patch Changes
+
+- jazz-react-native@0.9.13
+- jazz-tools@0.9.13
+
+## 1.0.50
+
+### Patch Changes
+
+- jazz-react-native@0.9.12
+- jazz-tools@0.9.12
+
+## 1.0.49
+
+### Patch Changes
+
+- jazz-react-native@0.9.11
+- jazz-tools@0.9.11
+
+## 1.0.48
+
+### Patch Changes
+
+- Updated dependencies [f76274c]
+- Updated dependencies [5e83864]
+  - jazz-react-native@0.9.10
+  - jazz-tools@0.9.10
+
+## 1.0.47
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react-native@0.9.9
+
+## 1.0.46
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react-native@0.9.8
+
+## 1.0.45
+
+### Patch Changes
+
+- Updated dependencies [8a390d2]
+  - jazz-react-native@0.9.6
+
+## 1.0.44
+
+### Patch Changes
+
+- Updated dependencies [c871912]
+  - jazz-react-native@0.9.5
+
+## 1.0.43
+
+### Patch Changes
+
+- jazz-react-native@0.9.4
+
+## 1.0.42
+
+### Patch Changes
+
+- Updated dependencies [7cd691f]
+  - jazz-react-native@0.9.3
+
+## 1.0.41
+
+### Patch Changes
+
+- Updated dependencies [80fd3e9]
+  - jazz-react-native@0.9.2
+
+## 1.0.40
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-tools@0.9.1
+  - jazz-react-native@0.9.1
+
+## 1.0.39
+
+### Patch Changes
+
+- Updated dependencies [1da4d55]
+- Updated dependencies [8eda792]
+- Updated dependencies [1e5e3a1]
+  - jazz-react-native@0.9.0
+  - jazz-tools@0.9.0
+
+## 1.0.38
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-react-native@0.8.51
+
+## 1.0.37
+
+### Patch Changes
+
+- jazz-react-native@0.8.50
+- jazz-tools@0.8.50
+
+## 1.0.36
+
+### Patch Changes
+
+- jazz-react-native@0.8.49
+- jazz-tools@0.8.49
+
+## 1.0.35
+
+### Patch Changes
+
+- Updated dependencies [635e824]
+- Updated dependencies [0a85982]
+  - jazz-tools@0.8.48
+  - jazz-react-native@0.8.48
+
+## 1.0.34
+
+### Patch Changes
+
+- Updated dependencies [33ef9c4]
+  - jazz-react-native@0.8.47
+
+## 1.0.33
+
+### Patch Changes
+
+- Updated dependencies [ab4ffbd]
+  - jazz-react-native@0.8.46
+
+## 1.0.32
+
+### Patch Changes
+
+- Updated dependencies [7701307]
+- Updated dependencies [fa41f8e]
+- Updated dependencies [88d7d9a]
+- Updated dependencies [60e35ea]
+  - jazz-react-native@0.8.45
+  - jazz-tools@0.8.45
+
+## 1.0.31
+
+### Patch Changes
+
+- jazz-react-native@0.8.44
+- jazz-tools@0.8.44
+
+## 1.0.30
+
+### Patch Changes
+
+- jazz-react-native@0.8.41
+- jazz-tools@0.8.41
+
+## 1.0.29
+
+### Patch Changes
+
+- Updated dependencies [0c6b0f3]
+- Updated dependencies [249eecb]
+  - jazz-react-native@0.8.39
+  - jazz-tools@0.8.39
+
+## 1.0.28
+
+### Patch Changes
+
+- jazz-react-native@0.8.38
+- jazz-tools@0.8.38
+
+## 1.0.27
+
+### Patch Changes
+
+- jazz-react-native@0.8.37
+- jazz-tools@0.8.37
+
+## 1.0.26
+
+### Patch Changes
+
+- Updated dependencies [c84764a]
+- Updated dependencies [441fe27]
+  - jazz-react-native@0.8.36
+  - jazz-tools@0.8.36
+
+## 1.0.25
+
+### Patch Changes
+
+- Updated dependencies [8b87117]
+  - jazz-tools@0.8.35
+  - jazz-react-native@0.8.35
+
+## 1.0.24
+
+### Patch Changes
+
+- jazz-react-native@0.8.34
+- jazz-tools@0.8.34
+
+## 1.0.23
+
+### Patch Changes
+
+- Updated dependencies [df42b2b]
+  - jazz-tools@0.8.32
+  - jazz-react-native@0.8.32
+
+## 1.0.22
+
+### Patch Changes
+
+- jazz-react-native@0.8.31
+- jazz-tools@0.8.31
+
+## 1.0.21
+
+### Patch Changes
+
+- jazz-react-native@0.8.30
+- jazz-tools@0.8.30
+
+## 1.0.20
+
+### Patch Changes
+
+- jazz-react-native@0.8.29
+- jazz-tools@0.8.29
+
+## 1.0.19
+
+### Patch Changes
+
+- jazz-react-native@0.8.28
+- jazz-tools@0.8.28
+
+## 1.0.18
+
+### Patch Changes
+
+- jazz-react-native@0.8.27
+- jazz-tools@0.8.27
+
+## 1.0.17
+
+### Patch Changes
+
+- Updated dependencies [d348c2d]
+- Updated dependencies [6902b5b]
+- Updated dependencies [1a0cd3d]
+  - jazz-tools@0.8.23
+  - jazz-react-native@0.8.23
+
+## 1.0.16
+
+### Patch Changes
+
+- Updated dependencies [149ca97]
+  - jazz-tools@0.8.21
+  - jazz-react-native@0.8.21
+
+## 1.0.15
+
+### Patch Changes
+
+- Updated dependencies [3ef3ff3]
+  - jazz-react-native@0.8.20
+
+## 1.0.14
+
+### Patch Changes
+
+- jazz-react-native@0.8.19
+- jazz-tools@0.8.19
+
+## 1.0.13
+
+### Patch Changes
+
+- jazz-react-native@0.8.18
+- jazz-tools@0.8.18
+
+## 1.0.12
+
+### Patch Changes
+
+- jazz-react-native@0.8.17
+- jazz-tools@0.8.17
+
+## 1.0.11
+
+### Patch Changes
+
+- jazz-react-native@0.8.16
+- jazz-tools@0.8.16
+
+## 1.0.10
+
+### Patch Changes
+
+- Updated dependencies [cce679b]
+  - jazz-tools@0.8.15
+  - jazz-react-native@0.8.15
+
+## 1.0.9
+
+### Patch Changes
+
+- Updated dependencies [36273b3]
+  - jazz-tools@0.8.14
+  - jazz-react-native@0.8.14
+
+## 1.0.8
+
+### Patch Changes
+
+- Updated dependencies [fd011d7]
+  - jazz-tools@0.8.13
+  - jazz-react-native@0.8.13
+
+## 1.0.7
+
+### Patch Changes
+
+- jazz-react-native@0.8.12
+- jazz-tools@0.8.12
+
+## 1.0.6
+
+### Patch Changes
+
+- jazz-react-native@0.8.11
+- jazz-tools@0.8.11
+
+## 1.0.5
+
+### Patch Changes
+
+- b7639cf: feat(react-native): replaced react-native-mmkv with expo-secure-store and initialize it by default as kvStore in createJazzRNApp() (BREAKING)
+- Updated dependencies [b7639cf]
+  - jazz-react-native@0.8.8
+
+## 1.0.4
+
+### Patch Changes
+
+- Updated dependencies [32b05b6]
+  - jazz-react-native@0.8.7
+
+## 1.0.3
+
+### Patch Changes
+
+- jazz-react-native@0.8.6
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies [c3f4e6b]
+- Updated dependencies [d9152ed]
+  - jazz-react-native@0.8.5
+  - jazz-tools@0.8.5
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - jazz-react-native@0.8.3
+  - jazz-tools@0.8.3

examples/chat-rn/README.md

@@ -0,0 +1,24 @@
+# 🎷 Jazz + Expo + `react-navigation` + Demo Auth
+
+## 🚀 How to Run
+
+### 1. Inside the Workspace Root
+
+First, install dependencies and build the project:
+
+```bash
+pnpm i
+pnpm run build
+```
+
+### 2. Inside the `examples/chat-rn` Directory
+
+Next, navigate to the specific example project and run the following commands:
+
+```bash
+pnpm expo prebuild
+npx pod-install
+pnpm expo run:ios
+```
+
+This will set up and launch the app on iOS. For Android, you can replace the last command with `pnpm expo run:android`.

examples/chat-rn/app.json

@@ -0,0 +1,47 @@
+{
+  "expo": {
+    "name": "jazz-chat-rn",
+    "scheme": "jazz-chat-rn",
+    "slug": "jazz-chat-rn",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/icon.png",
+    "userInterfaceStyle": "light",
+    "splash": {
+      "image": "./assets/splash.png",
+      "resizeMode": "contain",
+      "backgroundColor": "#ffffff"
+    },
+    "ios": {
+      "supportsTablet": true,
+      "bundleIdentifier": "com.jazz.chatrn"
+    },
+    "android": {
+      "adaptiveIcon": {
+        "foregroundImage": "./assets/adaptive-icon.png",
+        "backgroundColor": "#ffffff"
+      },
+      "package": "com.jazz.chatrn"
+    },
+    "plugins": [
+      [
+        "expo-build-properties",
+        {
+          "ios": {
+            "newArchEnabled": true
+          },
+          "android": {
+            "newArchEnabled": true
+          }
+        }
+      ],
+      "expo-secure-store"
+    ],
+    "extra": {
+      "eas": {
+        "projectId": "e0e61872-1906-4c84-b9d8-9be77355cad0"
+      }
+    },
+    "owner": "paxx"
+  }
+}

examples/chat-rn/babel.config.js

@@ -0,0 +1,9 @@
+module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: [
+      ["babel-preset-expo", { jsxImportSource: "nativewind" }],
+      "nativewind/babel",
+    ],
+  };
+};

examples/chat-rn/eas.json

@@ -0,0 +1,27 @@
+{
+  "cli": {
+    "version": ">= 12.5.1",
+    "appVersionSource": "remote"
+  },
+  "build": {
+    "development": {
+      "developmentClient": true,
+      "distribution": "internal"
+    },
+    "ios-simulator": {
+      "extends": "development",
+      "ios": {
+        "simulator": true
+      }
+    },
+    "preview": {
+      "distribution": "internal"
+    },
+    "production": {
+      "autoIncrement": true
+    }
+  },
+  "submit": {
+    "production": {}
+  }
+}

examples/chat-rn/global.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

examples/chat-rn/index.js

@@ -0,0 +1,4 @@
+import "./polyfills";
+import { registerRootComponent } from "expo";
+import App from "./src/App";
+registerRootComponent(App);

examples/chat-rn/metro.config.js

@@ -0,0 +1,35 @@
+// Learn more https://docs.expo.dev/guides/monorepos
+const { getDefaultConfig } = require("expo/metro-config");
+const { withNativeWind } = require("nativewind/metro");
+const { FileStore } = require("metro-cache");
+const path = require("path");
+
+// eslint-disable-next-line no-undef
+const projectRoot = __dirname;
+const workspaceRoot = path.resolve(projectRoot, "../..");
+
+const config = getDefaultConfig(projectRoot, { isCSSEnabled: true });
+
+// Since we are using pnpm, we have to setup the monorepo manually for Metro
+// #1 - Watch all files in the monorepo
+config.watchFolders = [workspaceRoot];
+// #2 - Try resolving with project modules first, then workspace modules
+config.resolver.nodeModulesPaths = [
+  path.resolve(projectRoot, "node_modules"),
+  path.resolve(workspaceRoot, "node_modules"),
+];
+config.resolver.sourceExts = ["mjs", "js", "json", "ts", "tsx"];
+config.resolver.requireCycleIgnorePatterns = [
+  /(^|\/|\\)node_modules($|\/|\\)/,
+  /(^|\/|\\)packages($|\/|\\)/,
+];
+
+// Use turborepo to restore the cache when possible
+config.cacheStores = [
+  new FileStore({
+    root: path.join(projectRoot, "node_modules", ".cache", "metro"),
+  }),
+];
+
+// module.exports = config;
+module.exports = withNativeWind(config, { input: "./global.css" });

examples/chat-rn/nativewind-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="nativewind/types" />

examples/chat-rn/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "chat-rn",
+  "version": "1.0.83",
+  "main": "index.js",
+  "scripts": {
+    "build": "expo export -p ios",
+    "start": "expo start",
+    "format-and-lint": "biome check .",
+    "format-and-lint:fix": "biome check . --write",
+    "android": "expo run:android",
+    "ios": "expo run:ios",
+    "web": "expo start --web"
+  },
+  "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.2.12",
+    "@react-native-community/netinfo": "^11.4.1",
+    "@react-navigation/native": "^7.0.13",
+    "@react-navigation/native-stack": "^7.1.14",
+    "clsx": "^2.0.0",
+    "expo": "^52.0.0",
+    "expo-build-properties": "~0.13.1",
+    "expo-clipboard": "~7.0.0",
+    "expo-constants": "~17.0.3",
+    "expo-dev-client": "~5.0.5",
+    "expo-linking": "~7.0.3",
+    "expo-secure-store": "~14.0.0",
+    "expo-status-bar": "~2.0.0",
+    "expo-web-browser": "~14.0.1",
+    "jazz-react-native": "workspace:*",
+    "jazz-tools": "workspace:*",
+    "nativewind": "^4.1.21",
+    "react": "^18.3.1",
+    "react-native": "~0.76.3",
+    "react-native-get-random-values": "^1.11.0",
+    "react-native-safe-area-context": "4.12.0",
+    "react-native-screens": "4.1.0",
+    "react-native-url-polyfill": "^2.0.0",
+    "readable-stream": "4.7.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.20.0",
+    "@types/react": "^18.3.12",
+    "tailwindcss": "^3.4.17",
+    "typescript": "~5.6.2"
+  },
+  "private": true
+}

examples/chat-rn/polyfills.js

@@ -0,0 +1,17 @@
+/* eslint-disable import/order */
+
+// @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);
+
+import "@azure/core-asynciterator-polyfill";
+
+import "@bacons/text-decoder/install";
+
+import "react-native-get-random-values";

examples/chat-rn/src/App.tsx

@@ -0,0 +1,73 @@
+import "../global.css";
+
+import {
+  NavigationContainer,
+  useNavigationContainerRef,
+} from "@react-navigation/native";
+import { createNativeStackNavigator } from "@react-navigation/native-stack";
+import * as Linking from "expo-linking";
+import React, { StrictMode, useEffect, useState } from "react";
+import HandleInviteScreen from "./invite";
+
+import { JazzProvider } from "jazz-react-native";
+import { apiKey } from "./apiKey";
+import ChatScreen from "./chat";
+
+const Stack = createNativeStackNavigator();
+
+const prefix = Linking.createURL("/");
+
+const linking = {
+  prefixes: [prefix],
+  config: {
+    screens: {
+      HandleInviteScreen: {
+        path: "router/invite/:valueHint?/:valueID/:inviteSecret",
+      },
+    },
+  },
+};
+
+function App() {
+  const [initialRoute, setInitialRoute] = useState<
+    "ChatScreen" | "HandleInviteScreen"
+  >("ChatScreen");
+  const navigationRef = useNavigationContainerRef();
+  useEffect(() => {
+    Linking.getInitialURL().then((url) => {
+      if (url) {
+        if (url && url.includes("invite")) {
+          setInitialRoute("HandleInviteScreen");
+        }
+      }
+    });
+  }, []);
+
+  return (
+    <StrictMode>
+      <JazzProvider
+        storage="sqlite"
+        sync={{
+          peer: `wss://cloud.jazz.tools/?key=${apiKey}`,
+        }}
+      >
+        <NavigationContainer linking={linking} ref={navigationRef}>
+          <Stack.Navigator initialRouteName={initialRoute}>
+            <Stack.Screen
+              options={{ title: "Jazz Chat" }}
+              name="ChatScreen"
+              // @ts-ignore
+              component={ChatScreen}
+            />
+            <Stack.Screen
+              name="HandleInviteScreen"
+              component={HandleInviteScreen}
+            />
+          </Stack.Navigator>
+        </NavigationContainer>
+      </JazzProvider>
+    </StrictMode>
+  );
+}
+
+export default App;

examples/chat-rn/src/apiKey.ts

@@ -0,0 +1 @@
+export const apiKey = "chat-rn-example-jazz@garden.co";

examples/chat-rn/src/chat.tsx

@@ -0,0 +1,209 @@
+import clsx from "clsx";
+import * as Clipboard from "expo-clipboard";
+import { Group, ID, Profile } from "jazz-tools";
+import { useEffect, useState } from "react";
+import React, {
+  Button,
+  FlatList,
+  KeyboardAvoidingView,
+  SafeAreaView,
+  Text,
+  TextInput,
+  TouchableOpacity,
+  View,
+  Alert,
+} from "react-native";
+
+import { useAccount, useCoState } from "jazz-react-native";
+import { Chat, Message } from "./schema";
+
+export default function ChatScreen({ navigation }: { navigation: any }) {
+  const { me, logOut } = useAccount();
+  const [chatId, setChatId] = useState<ID<Chat>>();
+  const loadedChat = useCoState(Chat, chatId, { resolve: { $each: true } });
+  const [message, setMessage] = useState("");
+  const profile = useCoState(Profile, me._refs.profile?.id, {});
+
+  function handleLogOut() {
+    setChatId(undefined);
+    logOut();
+  }
+
+  useEffect(() => {
+    navigation.setOptions({
+      headerRight: () => <Button onPress={handleLogOut} title="Logout" />,
+      headerLeft: () =>
+        loadedChat ? (
+          <Button
+            onPress={() => {
+              if (loadedChat?.id) {
+                Clipboard.setStringAsync(
+                  `https://chat.jazz.tools/#/chat/${loadedChat.id}`,
+                );
+                Alert.alert("Copied to clipboard", `Chat ID: ${loadedChat.id}`);
+              }
+            }}
+            title="Share"
+          />
+        ) : null,
+    });
+  }, [navigation, loadedChat]);
+
+  const createChat = () => {
+    const group = Group.create({ owner: me });
+    group.addMember("everyone", "writer");
+    const chat = Chat.create([], { owner: group });
+    setChatId(chat.id);
+  };
+
+  const joinChat = () => {
+    Alert.prompt(
+      "Join Chat",
+      "Enter the Chat ID (example: co_zBGEHYvRfGuT2YSBraY3njGjnde)",
+      [
+        {
+          text: "Cancel",
+          style: "cancel",
+        },
+        {
+          text: "Join",
+          onPress: (chatId) => {
+            if (chatId) {
+              setChatId(chatId as ID<Chat>);
+            } else {
+              Alert.alert("Error", "Chat ID cannot be empty.");
+            }
+          },
+        },
+      ],
+      "plain-text",
+    );
+  };
+
+  const sendMessage = () => {
+    if (!loadedChat) return;
+    if (message.trim()) {
+      loadedChat.push(
+        Message.create({ text: message }, { owner: loadedChat?._owner }),
+      );
+      setMessage("");
+    }
+  };
+
+  const renderMessageItem = ({ item }: { item: Message }) => {
+    const isMe = item._edits.text.by?.isMe;
+    return (
+      <View
+        className={clsx(
+          `rounded-lg p-1 px-1.5 max-w-[80%] `,
+
+          isMe ? `bg-gray-200 self-end text-right` : `bg-gray-300 self-start `,
+        )}
+      >
+        {!isMe ? (
+          <Text
+            className={clsx(
+              `text-xs text-gray-500`,
+              isMe ? "text-right" : "text-left",
+            )}
+          >
+            {item._edits.text.by?.profile?.name}
+          </Text>
+        ) : null}
+        <View
+          className={clsx(
+            "flex relative items-end justify-between",
+            isMe ? "flex-row" : "flex-row",
+          )}
+        >
+          <Text className={clsx(`text-black text-md max-w-[85%]`)}>
+            {item.text}
+          </Text>
+          <Text
+            className={clsx(
+              "text-[10px] text-gray-500 text-right ml-2",
+              !isMe ? "mt-2" : "mt-1",
+            )}
+          >
+            {item._edits.text.madeAt.getHours()}:
+            {item._edits.text.madeAt.getMinutes()}
+          </Text>
+        </View>
+      </View>
+    );
+  };
+
+  return (
+    <View className="flex flex-col h-full">
+      {!loadedChat ? (
+        <View className="flex flex-col h-full items-center justify-center">
+          <Text className="text-m font-bold mb-6">Username</Text>
+          <TextInput
+            className="rounded h-12 p-2 mb-12 w-40 border border-gray-200 block"
+            value={profile?.name ?? ""}
+            onChangeText={(value) => {
+              if (profile) {
+                profile.name = value;
+              }
+            }}
+            textAlignVertical="center"
+            onSubmitEditing={sendMessage}
+            testID="username-input"
+          />
+          <TouchableOpacity
+            onPress={createChat}
+            className="bg-blue-500 p-4 rounded-md"
+          >
+            <Text className="text-white font-semibold">Start new chat</Text>
+          </TouchableOpacity>
+          <TouchableOpacity
+            onPress={joinChat}
+            className="bg-green-500 p-4 rounded-md mt-4"
+          >
+            <Text className="text-white font-semibold">Join chat</Text>
+          </TouchableOpacity>
+        </View>
+      ) : (
+        <>
+          <FlatList
+            contentContainerStyle={{
+              flexGrow: 1,
+              flex: 1,
+              gap: 6,
+              padding: 8,
+            }}
+            className="flex"
+            data={loadedChat}
+            keyExtractor={(item) => item.id}
+            renderItem={renderMessageItem}
+          />
+
+          <KeyboardAvoidingView
+            keyboardVerticalOffset={110}
+            behavior="padding"
+            className="p-3 bg-white border-t border-gray-300"
+          >
+            <SafeAreaView className="flex flex-row items-center gap-2">
+              <TextInput
+                className="rounded-full h-8 py-0 px-2  border border-gray-200 block flex-1"
+                value={message}
+                onChangeText={setMessage}
+                placeholder="Type a message..."
+                textAlignVertical="center"
+                onSubmitEditing={sendMessage}
+                testID="message-input"
+              />
+              <TouchableOpacity
+                onPress={sendMessage}
+                className="bg-gray-300 text-white rounded-full h-8 w-8 items-center justify-center"
+                testID="send-button"
+              >
+                <Text>↑</Text>
+              </TouchableOpacity>
+            </SafeAreaView>
+          </KeyboardAvoidingView>
+        </>
+      )}
+    </View>
+  );
+}

examples/chat-rn/src/invite.tsx

@@ -0,0 +1,18 @@
+import { useAcceptInvite } from "jazz-react-native";
+import React, { Text } from "react-native";
+import { Chat } from "./schema";
+
+export default function HandleInviteScreen({
+  navigation,
+}: {
+  navigation: any;
+}) {
+  useAcceptInvite({
+    invitedObjectSchema: Chat,
+    onAccept: async (chatId) => {
+      navigation.navigate("ChatScreen", { chatId });
+    },
+  });
+
+  return <Text>Accepting invite...</Text>;
+}

examples/chat-rn/src/schema.ts

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

examples/chat-rn/tailwind.config.js

@@ -0,0 +1,14 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  // NOTE: Update this to include the paths to all of your component files.
+  content: [
+    "./app/**/*.{js,jsx,ts,tsx}",
+    "./components/**/*.{js,jsx,ts,tsx}",
+    "./src/**/*.{js,jsx,ts,tsx}",
+  ],
+  presets: [require("nativewind/preset")],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

examples/chat-rn/test/e2e/erase_text.yml

@@ -0,0 +1,16 @@
+# this sub-flow exists to work around an ios issue where the text field is not
+# fully erased.  The tap into the input field hits the middle, and clears all
+# text to the left.  If there's more to the right, it slides left, and thus we
+# repeat this step.  https://maestro.mobile.dev/api-reference/commands/erasetext
+appId: com.jazz.chatrn
+---
+- copyTextFrom:
+   id: ${id}
+- repeat:
+    times: 4
+    commands:
+      - tapOn:
+          id: ${id}
+      - eraseText
+      - copyTextFrom:
+          id: ${id}

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

@@ -0,0 +1,50 @@
+appId: com.jazz.chatrn
+---
+- launchApp
+
+# # handle Expo screens (for local dev)
+# - assertVisible: "Continue"
+# - tapOn: "Continue"
+# - assertVisible: "Reload"
+# - tapOn: "Reload"
+
+# login
+- assertVisible: "Anonymous user"
+- runFlow:
+    label: "Erase existing username"
+    file: erase_text.yml
+    env:
+      id: "username-input"
+- inputText: "boorad"
+- assertVisible: "boorad"
+
+# start new chat
+- tapOn: "Start new chat"
+- assertVisible: "Share"
+- assertVisible: "Jazz Chat"
+- assertVisible: "Logout"
+
+# send a message
+- tapOn:
+    id: "message-input"
+- inputText: "bro, low key, it do be like that tho"
+- tapOn:
+    id: "send-button"
+- assertVisible: "bro, low key, it do be like that tho"
+
+# get invite code
+- tapOn: "Share"
+- assertVisible: "Copied to clipboard"
+- tapOn:  "OK"
+# this assert doesn't work.  maestro.copiedText only populates from `copyTextFrom`
+# - assertTrue: ${maestro.copiedText.startsWith("co_z")}
+
+# logout
+- tapOn: "Logout"
+- assertVisible: "Anonymous user"
+# This doesn't work on CI, maybe because Android has a different alert dialog
+# - tapOn: "Join chat"
+# - inputText: "co_zFs6KFyhxPw4xtw83tcEMzeHUNv" # Use a static id because maestro doesn't have access to the system clipboard
+# - pressKey: "enter"
+# - assertVisible: "boorad"
+# - assertVisible: "bro, low key, it do be like that tho"

examples/chat-rn/test/e2e/run.sh

@@ -0,0 +1,20 @@
+#!/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
+
+# build and install the app
+echo "Building and installing Android app."
+echo "If it fails, its output will be in artifact: android-install.log..."
+cd ./android/
+./gradlew installRelease >> ~/output/android-install.log 2>&1
+cd ..
+
+# 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/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "moduleResolution": "bundler"
+  },
+  "exclude": ["src/tests"]
+}