perf: skip verify step when creating a new local transaction

.changeset/config.json

@@ -2,8 +2,8 @@
   "$schema": "https://unpkg.com/@changesets/config@2.3.1/schema.json",
   "changelog": "@changesets/cli/changelog",
   "commit": false,
-  "linked": [],
-  "fixed": [
+  "fixed": [],
+  "linked": [
     [
       "cojson",
       "cojson-storage",
@@ -11,24 +11,14 @@
       "cojson-storage-sqlite",
       "cojson-transport-ws",
       "jazz-browser",
-      "jazz-auth-clerk",
-      "jazz-auth-betterauth",
-      "jazz-betterauth-client-plugin",
-      "jazz-betterauth-server-plugin",
-      "jazz-react-auth-betterauth",
+      "jazz-browser-auth-clerk",
       "jazz-browser-media-images",
-      "jazz-expo",
-      "jazz-inspector",
-      "jazz-inspector-element",
       "jazz-nodejs",
       "jazz-react",
-      "jazz-react-core",
       "jazz-react-auth-clerk",
-      "jazz-react-native-core",
       "jazz-react-native",
+      "jazz-react-native-auth-clerk",
       "jazz-react-native-media-images",
-      "jazz-richtext-prosemirror",
-      "jazz-richtext-tiptap",
       "jazz-run",
       "jazz-svelte",
       "jazz-tools",

.changeset/fast-chicken-build.md

@@ -0,0 +1,5 @@
+---
+"cojson": patch
+---
+
+skip verify step when creating a new local transaction

.changeset/mean-ghosts-hunt.md

@@ -0,0 +1,5 @@
+---
+"jazz-run": patch
+---
+
+Fix the --json option on the account create command

.changeset/odd-numbers-mix.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Add a bundle step to not expose the circular deps to the lib consumers

.changeset/ten-toes-cross.md

@@ -0,0 +1,5 @@
+---
+"jazz-tools": patch
+---
+
+Reduce the amount of circular deps

.changeset/tiny-trains-vanish.md

@@ -0,0 +1,5 @@
+---
+"cojson": patch
+---
+
+Optimize RawCoMap and RawCoList init and add the assign and appendItems methods to create bulk transactions

.github/ISSUE_TEMPLATE/docs-request.md

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

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

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

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

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

.github/workflows/build-examples.yaml

@@ -6,7 +6,7 @@ on:
 
 jobs:
   build-examples:
-    runs-on: blacksmith-4vcpu-ubuntu-2204
+    runs-on: ubuntu-latest
     strategy:
       matrix:
         example: [
@@ -19,16 +19,40 @@ jobs:
           "pets",
           "reactions",
           "todo",
+          "onboarding",
         ]
 
     steps:
-    - name: Checkout
-      uses: actions/checkout@v4
+    - uses: actions/checkout@v3
       with:
         submodules: true
 
-    - name: Setup Source Code
-      uses: ./.github/actions/source-code/
+    - name: Enable corepack
+      run: corepack enable
+
+    - name: Install Node.js
+      uses: actions/setup-node@v3
+      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: actions/cache@v3
+      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
+      run: pnpm install --frozen-lockfile
+
 
     - name: Pnpm Build
       run: |

.github/workflows/build-starters.yaml

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

.github/workflows/code-quality.yml

@@ -6,7 +6,7 @@ on:
 
 jobs:
   quality:
-    runs-on: blacksmith-4vcpu-ubuntu-2204
+    runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -15,7 +15,4 @@ jobs:
         with:
           version: latest
       - name: Run Biome
-        run: biome ci .
-
-      - name: Check Catalog Dependencies
-        run: node scripts/check-catalog-deps.js
+        run: biome ci .

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

@@ -1,83 +0,0 @@
-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-expo/**"
-      - "packages/**"
-
-jobs:
-  e2e-tests:
-    runs-on: blacksmith-4vcpu-ubuntu-2204
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
-
-      - name: Create Output Directory
-        run: |
-          mkdir -p ~/output
-
-      - name: Setup JDK
-        uses: actions/setup-java@v4
-        with:
-          distribution: corretto
-          java-version: 22
-          cache: gradle
-
-      - name: Pnpm Build
-        run: pnpm turbo build --filter="./packages/*"
-
-      - name: chat-rn-expo App Pre Build
-        working-directory: ./examples/chat-rn-expo
-        run: |
-          pnpm expo prebuild --clean
-
-      - name: Install Maestro
-        run: |
-          curl -fsSL "https://get.maestro.mobile.dev" | bash
-
-      - name: Setup Android Emulator
-        id: android-emulator
-        uses: ./.github/actions/android-emulator/
-        with:
-          api-level: 29
-
-      - name: Test App
-        uses: reactivecircus/android-emulator-runner@v2
-        id: e2e_test
-        continue-on-error: true
-        with:
-          api-level: 29
-          force-avd-creation: false
-          emulator-options: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none -no-metrics
-          disable-animations: true
-          working-directory: ./examples/chat-rn-expo/
-          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

@@ -8,16 +8,38 @@ on:
 
 jobs:
   test:
-    runs-on: blacksmith-4vcpu-ubuntu-2204
+    runs-on: ubuntu-latest
     timeout-minutes: 5
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v3
         with:
           submodules: true
 
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
+      - name: Enable corepack
+        run: corepack enable
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        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: actions/cache@v3
+        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
+        run: pnpm install --frozen-lockfile
 
       - name: Build jazz-run
         run: pnpm exec turbo build && chmod +x dist/index.js;
@@ -26,3 +48,4 @@ jobs:
       - name: Run create account
         run: ./dist/index.js account create --name "Jazz Run CI test"
         working-directory: ./packages/jazz-run
+  

.github/workflows/playwright.yml

@@ -9,19 +9,41 @@ on:
 jobs:
   test:
     timeout-minutes: 60
-    runs-on: blacksmith-4vcpu-ubuntu-2204
+    runs-on: ubuntu-latest
     continue-on-error: true
     strategy:
       matrix:
-        project: ["tests/e2e", "examples/chat",  "examples/clerk", "examples/betterauth", "examples/file-share-svelte", "examples/form", "examples/music-player", "examples/organization", "examples/pets", "starters/react-passkey-auth"]
+        project: ["tests/e2e", "examples/chat", "examples/file-share-svelte", "examples/form", "examples/music-player", "examples/pets", "examples/onboarding"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v3
         with:
           submodules: true
 
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
+      - name: Enable corepack
+        run: corepack enable
+
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        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: actions/cache@v3
+        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
+        run: pnpm install --frozen-lockfile
 
       - name: Pnpm Build
         run: pnpm turbo build

.github/workflows/pre-release.yml

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

@@ -17,16 +17,35 @@ concurrency: ${{ github.workflow }}-${{ github.ref }}
 jobs:
   release:
     name: Release
-    runs-on: blacksmith-4vcpu-ubuntu-2204
+    runs-on: ubuntu-latest
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v4
+        uses: actions/checkout@v3
 
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
+      - name: Enable corepack
+        run: corepack enable
 
-      - name: Build packages
-        run: pnpm exec turbo run build --filter='./packages/*'
+      - name: Install Node.js
+        uses: actions/setup-node@v3
+        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: actions/cache@v3
+        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
+        run: pnpm install --frozen-lockfile
 
       - name: Create Release Pull Request or Publish to npm
         id: changesets

.github/workflows/unit-test.yml

@@ -9,20 +9,39 @@ on:
 
 jobs:
   unit-tests:
-    runs-on: blacksmith-4vcpu-ubuntu-2204
+    runs-on: ubuntu-latest
 
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Setup Source Code
-        uses: ./.github/actions/source-code/
+      - name: Enable corepack
+        run: corepack enable
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        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: actions/cache@v4
+        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
+        run: pnpm install --frozen-lockfile
 
       - 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

@@ -7,30 +7,15 @@ docsTmp
 coverage
 .direnv
 
-# Typescript
-**/*.tsbuildinfo
-
 # Next.js
 **/.next
 
 # Vite output
 **/dist
-__screenshots__
 
 # Playwright
 test-results
 
-# Java
-.java-version
-
 .husky
 
-.vscode/*
-.idea/*
-
-.svelte-kit
-
-.cursorrules
-.windsurfrules
-
-playwright-report
+.vscode/settings.json

CONTRIBUTING.md

@@ -36,7 +36,7 @@ We welcome all ideas! If you have suggestions, feel free to open an issue marked
 
 ### 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.
+You'll need Node.js 20.x or 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
@@ -48,25 +48,7 @@ You'll need Node.js 22.x installed (we're working on support for 23.x), and pnpm
    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:
+3. **Run tests** to verify everything is working:
    ```bash
    pnpm test
    ```

LICENSE.txt

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

README.md

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

biome.json

@@ -12,10 +12,7 @@
       "**/ios/**",
       "**/android/**",
       "packages/jazz-svelte/**",
-      "examples/*svelte*/**",
-      "examples/jazz-paper-scissors/src/routeTree.gen.ts",
-      "homepage/homepage/**",
-      "**/package.json"
+      "examples/*svelte*/**"
     ]
   },
   "formatter": {
@@ -55,24 +52,21 @@
       }
     },
     {
-      "include": ["packages/cojson-storage*/**", "cojson-transport-ws/**"],
-      "linter": {
-        "enabled": true,
-        "rules": {
-          "recommended": true
-        }
-      }
-    },
-    {
-      "include": ["packages/**/src/tests/**"],
+      "include": ["packages/**/src/tests/**", "packages/**/src/test/**"],
       "linter": {
         "rules": {
           "correctness": {
             "useImportExtensions": "off"
-          },
-          "style": {
-            "noNonNullAssertion": "off"
-          },
+          }
+        }
+      }
+    },
+    {
+      "include": ["packages/cojson-storage-indexeddb/**"],
+      "linter": {
+        "enabled": true,
+        "rules": {
+          "recommended": true,
           "suspicious": {
             "noExplicitAny": "info"
           }

examples/betterauth/.env

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

examples/betterauth/.gitignore

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

examples/betterauth/CHANGELOG.md

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

examples/betterauth/README.md

@@ -1,54 +0,0 @@
-# Better Auth Integration Example
-
-This example demonstrates how to integrate [Better Auth](https://www.better-auth.com/) with Jazz.
-
-## Getting started
-
-To run this example, you may either:
-* Clone the Jazz monorepo and run this example from within.
-* Create a new Jazz project using this example as a template, and run that new project.
-
-### Setting environment variables
-- `NEXT_PUBLIC_AUTH_BASE_URL`: A URL to a Better Auth server. If undefined, the example will self-host a Better Auth server.
-- `BETTER_AUTH_SECRET`: The encryption secret used by the self-hosted Better Auth server (required only if `NEXT_PUBLIC_AUTH_BASE_URL` is undefined)
-- `GITHUB_CLIENT_ID`: The client ID for the GitHub OAuth provider used by the self-hosted Better Auth server (required only if `NEXT_PUBLIC_AUTH_BASE_URL` is undefined)
-- `GITHUB_CLIENT_SECRET`: The client secret for the GitHub OAuth provider used by the self-hosted Better Auth server (required only if `NEXT_PUBLIC_AUTH_BASE_URL` is undefined)
-
-### Using this example as a template
-
-1. Create a new Jazz project, and use this example as a template.
-```sh
-npx create-jazz-app@latest betterauth-app --example betterauth
-```
-2. Navigate to the new project and start the development server.
-```sh
-cd betterauth-app
-pnpm install
-pnpm dev
-```
-
-### Using the monorepo
-
-This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation).
-
-Clone the jazz repository.
-```bash
-git clone https://github.com/garden-co/jazz.git
-```
-
-Install and build dependencies.
-```bash
-pnpm i && npx turbo build
-```
-
-Go to the example directory.
-```bash
-cd jazz/examples/betterauth/
-```
-
-Start the dev server.
-```bash
-pnpm dev
-```
-
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.

examples/betterauth/components.json

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

examples/betterauth/next.config.ts

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

examples/betterauth/package.json

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

examples/betterauth/playwright.config.ts

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

examples/betterauth/postcss.config.mjs

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

examples/betterauth/public/jazz-logo.svg

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

examples/betterauth/public/jazz.svg

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

examples/betterauth/src/app/globals.css

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

examples/betterauth/src/app/layout.tsx

@@ -1,26 +0,0 @@
-import { JazzAndAuth } from "@/components/JazzAndAuth";
-import { Toaster } from "@/components/ui/sonner";
-import type { Metadata } from "next";
-import "./globals.css";
-
-export const metadata: Metadata = {
-  title: "Jazz Example: Better Auth",
-  description: "Jazz example application demonstrating Better Auth integration",
-};
-
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <html lang="en">
-      <body className="antialiased">
-        <JazzAndAuth>
-          {children}
-          <Toaster richColors />
-        </JazzAndAuth>
-      </body>
-    </html>
-  );
-}

examples/betterauth/src/components/JazzAndAuth.tsx

@@ -1,33 +0,0 @@
-"use client";
-
-import { JazzProvider } from "jazz-react";
-import { AuthProvider } from "jazz-react-auth-betterauth";
-import { type ReactNode, lazy } from "react";
-
-const JazzDevTools =
-  process.env.NODE_ENV === "production"
-    ? () => null
-    : lazy(() =>
-        import("jazz-inspector").then((res) => ({
-          default: res.JazzInspector,
-        })),
-      );
-
-export function JazzAndAuth({ children }: { children: ReactNode }) {
-  return (
-    <JazzProvider
-      sync={{
-        peer: "wss://cloud.jazz.tools/?key=betterauth-example@garden.co",
-      }}
-    >
-      <AuthProvider
-        options={{
-          baseURL: process.env.NEXT_PUBLIC_AUTH_BASE_URL,
-        }}
-      >
-        {children}
-      </AuthProvider>
-      <JazzDevTools />
-    </JazzProvider>
-  );
-}

examples/betterauth/src/components/SSOButton.tsx

@@ -1,137 +0,0 @@
-import { Button } from "@/components/ui/button";
-import {
-  SiApple,
-  SiDiscord,
-  SiDropbox,
-  SiFacebook,
-  SiGithub,
-  SiGitlab,
-  SiGoogle,
-  SiKick,
-  SiReddit,
-  SiRoblox,
-  SiSpotify,
-  SiTiktok,
-  SiTwitch,
-  SiVk,
-  SiX,
-  SiZoom,
-} from "@icons-pack/react-simple-icons";
-import { type SSOProviderType, useAuth } from "jazz-react-auth-betterauth";
-import { useRouter } from "next/navigation";
-import type { ReactNode } from "react";
-import { toast } from "sonner";
-
-interface SocialProvider {
-  name: string;
-  icon?: ReactNode;
-}
-
-const socialProviderMap: Record<SSOProviderType, SocialProvider> = {
-  github: {
-    name: "GitHub",
-    icon: <SiGithub />,
-  },
-  google: {
-    name: "Google",
-    icon: <SiGoogle />,
-  },
-  apple: {
-    name: "Apple",
-    icon: <SiApple />,
-  },
-  discord: {
-    name: "Discord",
-    icon: <SiDiscord />,
-  },
-  facebook: {
-    name: "Facebook",
-    icon: <SiFacebook />,
-  },
-  microsoft: {
-    name: "Microsoft",
-  },
-  twitter: {
-    name: "X",
-    icon: <SiX />,
-  },
-  dropbox: {
-    name: "Dropbox",
-    icon: <SiDropbox />,
-  },
-  linkedin: {
-    name: "LinkedIn",
-  },
-  gitlab: {
-    name: "GitLab",
-    icon: <SiGitlab />,
-  },
-  kick: {
-    name: "Kick",
-    icon: <SiKick />,
-  },
-  tiktok: {
-    name: "TikTok",
-    icon: <SiTiktok />,
-  },
-  twitch: {
-    name: "Twitch",
-    icon: <SiTwitch />,
-  },
-  vk: {
-    name: "VK",
-    icon: <SiVk />,
-  },
-  zoom: {
-    name: "Zoom",
-    icon: <SiZoom />,
-  },
-  roblox: {
-    name: "Roblox",
-    icon: <SiRoblox />,
-  },
-  reddit: {
-    name: "Reddit",
-    icon: <SiReddit />,
-  },
-  spotify: {
-    name: "Spotify",
-    icon: <SiSpotify />,
-  },
-};
-
-interface Props {
-  provider: SSOProviderType;
-}
-
-export function SSOButton({ provider }: Props) {
-  const auth = useAuth();
-  const router = useRouter();
-
-  return (
-    <Button
-      type="button"
-      variant="outline"
-      onClick={() => {
-        auth.authClient.signIn.social(
-          {
-            provider,
-          },
-          {
-            onSuccess: () => {
-              router.push("/");
-            },
-            onError: (error) => {
-              toast.error("Error", {
-                description: error.error.message,
-              });
-            },
-          },
-        );
-      }}
-    >
-      {socialProviderMap[provider].icon}
-      Continue with {socialProviderMap[provider].name}
-    </Button>
-  );
-}

examples/betterauth/src/components/forgot-password-form.tsx

@@ -1,85 +0,0 @@
-"use client";
-
-import { Button } from "@/components/ui/button";
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from "@/components/ui/card";
-import { Input } from "@/components/ui/input";
-import { Label } from "@/components/ui/label";
-import { useAuth } from "jazz-react-auth-betterauth";
-import Link from "next/link";
-import { useRouter } from "next/navigation";
-import { useState } from "react";
-import { toast } from "sonner";
-
-export function ForgotPasswordForm() {
-  const router = useRouter();
-  const [email, setEmail] = useState("");
-  const auth = useAuth();
-
-  const handleSubmit = (e: React.FormEvent<HTMLFormElement>) => {
-    e.preventDefault();
-    auth.authClient.forgetPassword(
-      { email, redirectTo: `${window.location.origin}/auth/reset-password` },
-      {
-        onSuccess: () => {
-          toast.success("Email sent");
-        },
-        onError: (error) => {
-          toast.error("Error", {
-            description: error.error.message,
-          });
-        },
-      },
-    );
-  };
-
-  return (
-    <div className="flex flex-col gap-6">
-      <Card>
-        <CardHeader className="text-center">
-          <CardTitle className="text-xl">Recover password</CardTitle>
-          <CardDescription>
-            Enter your email to receive a link to reset your password
-          </CardDescription>
-        </CardHeader>
-        <CardContent>
-          <form onSubmit={handleSubmit}>
-            <div className="grid gap-6">
-              <div className="grid gap-6">
-                <div className="grid gap-3">
-                  <Label htmlFor="email">Email</Label>
-                  <Input
-                    id="email"
-                    type="email"
-                    placeholder="you@example.com"
-                    required
-                    value={email}
-                    onChange={(e) => setEmail(e.target.value)}
-                  />
-                </div>
-
-                <Button type="submit" className="w-full">
-                  Recover password
-                </Button>
-              </div>
-              <div className="text-center text-sm">
-                Back to{" "}
-                <Link
-                  href="/auth/sign-in"
-                  className="underline underline-offset-4"
-                >
-                  Sign in
-                </Link>
-              </div>
-            </div>
-          </form>
-        </CardContent>
-      </Card>
-    </div>
-  );
-}

examples/betterauth/src/components/navbar.tsx

@@ -1,55 +0,0 @@
-"use client";
-
-import { Button } from "@/components/ui/button";
-import { useAccount, useIsAuthenticated } from "jazz-react";
-import { useAuth } from "jazz-react-auth-betterauth";
-import { Account } from "jazz-tools";
-import Image from "next/image";
-import Link from "next/link";
-import { useCallback } from "react";
-
-export function Navbar() {
-  const { authClient } = useAuth();
-  const { logOut } = useAccount(Account, { resolve: { profile: {} } });
-
-  const isAuthenticated = useIsAuthenticated();
-
-  const signOut = useCallback(() => {
-    authClient.signOut().catch(console.error).finally(logOut);
-  }, [logOut, authClient]);
-
-  return (
-    <header className="absolute p-4 top-0 left-0 w-full z-10 flex justify-between">
-      <nav className="flex gap-4">
-        <Link href="/">
-          <Image
-            src="/jazz-logo.svg"
-            alt="Jazz logo"
-            width={96}
-            height={96}
-            priority
-          />
-        </Link>
-        {isAuthenticated && (
-          <Button asChild variant="link">
-            <Link href="/settings">Settings</Link>
-          </Button>
-        )}
-      </nav>
-      <nav className="flex gap-4">
-        {isAuthenticated ? (
-          <Button onClick={signOut}>Sign out</Button>
-        ) : (
-          <>
-            <Button asChild variant="secondary">
-              <Link href="/auth/sign-in">Sign in</Link>
-            </Button>
-            <Button asChild>
-              <Link href="/auth/sign-up">Sign up</Link>
-            </Button>
-          </>
-        )}
-      </nav>
-    </header>
-  );
-}

examples/betterauth/src/components/reset-password-form.tsx

@@ -1,108 +0,0 @@
-"use client";
-
-import { Button } from "@/components/ui/button";
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from "@/components/ui/card";
-import { Input } from "@/components/ui/input";
-import { Label } from "@/components/ui/label";
-import { useAuth } from "jazz-react-auth-betterauth";
-import Link from "next/link";
-import { useRouter, useSearchParams } from "next/navigation";
-import { useState } from "react";
-import { toast } from "sonner";
-
-export function ResetPasswordForm() {
-  const router = useRouter();
-  const [password, setPassword] = useState("");
-  const [confirmPassword, setConfirmPassword] = useState("");
-  const auth = useAuth();
-  const searchParams = useSearchParams();
-
-  const handleSubmit = (e: React.FormEvent<HTMLFormElement>) => {
-    e.preventDefault();
-    const token = searchParams.get("token");
-
-    if (password !== confirmPassword) {
-      toast.error("Passwords do not match");
-      return;
-    }
-
-    if (!token) {
-      toast.error("Invalid token");
-      return;
-    }
-
-    auth.authClient.resetPassword(
-      { newPassword: password, token },
-      {
-        onSuccess: () => {
-          toast.success("Password successfully updated");
-          router.push("/auth/sign-in");
-        },
-        onError: (error) => {
-          toast.error("Error", {
-            description: error.error.message,
-          });
-        },
-      },
-    );
-  };
-
-  return (
-    <div className="flex flex-col gap-6">
-      <Card>
-        <CardHeader className="text-center">
-          <CardTitle className="text-xl">Reset password</CardTitle>
-          <CardDescription>Enter your new password</CardDescription>
-        </CardHeader>
-        <CardContent>
-          <form onSubmit={handleSubmit}>
-            <div className="grid gap-6">
-              <div className="grid gap-6">
-                <div className="grid gap-3">
-                  <Label htmlFor="password">New password</Label>
-                  <Input
-                    id="password"
-                    type="password"
-                    required
-                    value={password}
-                    onChange={(e) => setPassword(e.target.value)}
-                  />
-                </div>
-
-                <div className="grid gap-3">
-                  <Label htmlFor="confirmPassword">Confirm password</Label>
-                  <Input
-                    id="confirmPassword"
-                    type="password"
-                    required
-                    value={confirmPassword}
-                    onChange={(e) => setConfirmPassword(e.target.value)}
-                  />
-                </div>
-
-                <Button type="submit" className="w-full">
-                  Set password
-                </Button>
-              </div>
-              <div className="text-center text-sm">
-                Back to{" "}
-                <Link
-                  href="/auth/sign-in"
-                  className="underline underline-offset-4"
-                >
-                  Sign in
-                </Link>
-              </div>
-            </div>
-          </form>
-        </CardContent>
-      </Card>
-    </div>
-  );
-}

examples/betterauth/src/components/signin-form.tsx

@@ -1,124 +0,0 @@
-"use client";
-
-import { Button } from "@/components/ui/button";
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from "@/components/ui/card";
-import { Input } from "@/components/ui/input";
-import { Label } from "@/components/ui/label";
-import { type SSOProviderType, useAuth } from "jazz-react-auth-betterauth";
-import Link from "next/link";
-import { useRouter } from "next/navigation";
-import { useState } from "react";
-import { toast } from "sonner";
-import { SSOButton } from "./SSOButton";
-
-interface Props {
-  providers: SSOProviderType[];
-}
-
-export function SigninForm({ providers }: Props) {
-  const router = useRouter();
-  const [email, setEmail] = useState("");
-  const [password, setPassword] = useState("");
-
-  const auth = useAuth();
-
-  const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
-    e.preventDefault();
-    await auth.authClient.signIn.email(
-      { email, password },
-      {
-        onSuccess: async () => {
-          await auth.logIn();
-          router.push("/");
-        },
-        onError: (error) => {
-          toast.error("Error", {
-            description: error.error.message,
-          });
-        },
-      },
-    );
-  };
-
-  return (
-    <div className="flex flex-col gap-6">
-      <Card>
-        <CardHeader className="text-center">
-          <CardTitle className="text-xl">Welcome back</CardTitle>
-          <CardDescription>
-            Sign in with one of the following providers
-          </CardDescription>
-        </CardHeader>
-        <CardContent>
-          <form onSubmit={handleSubmit}>
-            <div className="grid gap-6">
-              {providers.length > 0 && (
-                <>
-                  <div className="flex flex-col gap-4">
-                    {providers?.map((provider) => (
-                      <SSOButton key={provider} provider={provider} />
-                    ))}
-                  </div>
-                  <div className="after:border-border relative text-center text-sm after:absolute after:inset-0 after:top-1/2 after:z-0 after:flex after:items-center after:border-t">
-                    <span className="bg-card text-muted-foreground relative z-10 px-2">
-                      Or continue with
-                    </span>
-                  </div>
-                </>
-              )}
-              <div className="grid gap-6">
-                <div className="grid gap-3">
-                  <Label htmlFor="email">Email</Label>
-                  <Input
-                    id="email"
-                    type="email"
-                    placeholder="you@example.com"
-                    required
-                    value={email}
-                    onChange={(e) => setEmail(e.target.value)}
-                  />
-                </div>
-                <div className="grid gap-3">
-                  <div className="flex items-center justify-between">
-                    <Label htmlFor="password">Password</Label>
-                    <Link
-                      href="/auth/forgot-password"
-                      className="ml-auto inline-block text-sm underline-offset-4 hover:underline"
-                    >
-                      Forgot your password?
-                    </Link>
-                  </div>
-                  <Input
-                    id="password"
-                    type="password"
-                    required
-                    value={password}
-                    onChange={(e) => setPassword(e.target.value)}
-                  />
-                </div>
-                <Button type="submit" className="w-full">
-                  Sign in
-                </Button>
-              </div>
-              <div className="text-center text-sm">
-                Don&apos;t have an account?{" "}
-                <Link
-                  href="/auth/sign-up"
-                  className="underline underline-offset-4"
-                >
-                  Sign up
-                </Link>
-              </div>
-            </div>
-          </form>
-        </CardContent>
-      </Card>
-    </div>
-  );
-}

examples/betterauth/src/components/signup-form.tsx

@@ -1,151 +0,0 @@
-"use client";
-
-import { Button } from "@/components/ui/button";
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from "@/components/ui/card";
-import { Input } from "@/components/ui/input";
-import { Label } from "@/components/ui/label";
-import { type SSOProviderType, useAuth } from "jazz-react-auth-betterauth";
-import Link from "next/link";
-import { useRouter } from "next/navigation";
-import { useState } from "react";
-import { toast } from "sonner";
-import { SSOButton } from "./SSOButton";
-
-interface Props {
-  providers: SSOProviderType[];
-}
-
-export function SignupForm({ providers }: Props) {
-  const router = useRouter();
-  const auth = useAuth();
-  const [name, setName] = useState("");
-  const [email, setEmail] = useState("");
-  const [password, setPassword] = useState("");
-  const [confirmPassword, setConfirmPassword] = useState("");
-
-  const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
-    e.preventDefault();
-
-    if (password !== confirmPassword) {
-      toast.error("Error", {
-        description: "Passwords do not match",
-      });
-      return;
-    }
-
-    await auth.authClient.signUp.email(
-      {
-        email,
-        password,
-        name,
-      },
-      {
-        onSuccess: async () => {
-          await auth.signIn();
-          router.push("/");
-        },
-        onError: (error) => {
-          toast.error("Sign up error", {
-            description: error.error.message,
-          });
-        },
-      },
-    );
-  };
-
-  return (
-    <div className="flex flex-col gap-6">
-      <Card>
-        <CardHeader className="text-center">
-          <CardTitle className="text-xl">Welcome</CardTitle>
-          <CardDescription>
-            Sign up with one of the following providers
-          </CardDescription>
-        </CardHeader>
-        <CardContent>
-          <form onSubmit={handleSubmit}>
-            <div className="grid gap-6">
-              {providers.length > 0 && (
-                <>
-                  <div className="flex flex-col gap-4">
-                    {providers?.map((provider) => (
-                      <SSOButton key={provider} provider={provider} />
-                    ))}
-                  </div>
-                  <div className="after:border-border relative text-center text-sm after:absolute after:inset-0 after:top-1/2 after:z-0 after:flex after:items-center after:border-t">
-                    <span className="bg-card text-muted-foreground relative z-10 px-2">
-                      Or continue with
-                    </span>
-                  </div>
-                </>
-              )}
-              <div className="grid gap-6">
-                <div className="grid gap-3">
-                  <Label htmlFor="name">Name</Label>
-                  <Input
-                    id="name"
-                    type="text"
-                    placeholder="John Doe"
-                    required
-                    value={name}
-                    onChange={(e) => setName(e.target.value)}
-                  />
-                </div>
-                <div className="grid gap-3">
-                  <Label htmlFor="email">Email</Label>
-                  <Input
-                    id="email"
-                    type="email"
-                    placeholder="you@example.com"
-                    required
-                    value={email}
-                    onChange={(e) => setEmail(e.target.value)}
-                  />
-                </div>
-                <div className="grid gap-3">
-                  <Label htmlFor="password">Password</Label>
-                  <Input
-                    id="password"
-                    type="password"
-                    placeholder="********"
-                    required
-                    value={password}
-                    onChange={(e) => setPassword(e.target.value)}
-                  />
-                </div>
-                <div className="grid gap-3">
-                  <Label htmlFor="confirmPassword">Confirm password</Label>
-                  <Input
-                    id="confirmPassword"
-                    type="password"
-                    required
-                    value={confirmPassword}
-                    onChange={(e) => setConfirmPassword(e.target.value)}
-                  />
-                </div>
-                <Button type="submit" className="w-full">
-                  Sign up
-                </Button>
-              </div>
-              <div className="text-center text-sm">
-                Already have an account?{" "}
-                <Link
-                  href="/auth/sign-in"
-                  className="underline underline-offset-4"
-                >
-                  Sign in
-                </Link>
-              </div>
-            </div>
-          </form>
-        </CardContent>
-      </Card>
-    </div>
-  );
-}

examples/betterauth/src/components/ui/button.tsx

@@ -1,59 +0,0 @@
-import { Slot } from "@radix-ui/react-slot";
-import { type VariantProps, cva } from "class-variance-authority";
-import * as React from "react";
-
-import { cn } from "@/lib/utils";
-
-const buttonVariants = cva(
-  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
-  {
-    variants: {
-      variant: {
-        default:
-          "bg-primary text-primary-foreground shadow-xs hover:bg-primary/90",
-        destructive:
-          "bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
-        outline:
-          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50",
-        secondary:
-          "bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80",
-        ghost:
-          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
-        link: "text-primary underline-offset-4 hover:underline",
-      },
-      size: {
-        default: "h-9 px-4 py-2 has-[>svg]:px-3",
-        sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5",
-        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
-        icon: "size-9",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-      size: "default",
-    },
-  },
-);
-
-function Button({
-  className,
-  variant,
-  size,
-  asChild = false,
-  ...props
-}: React.ComponentProps<"button"> &
-  VariantProps<typeof buttonVariants> & {
-    asChild?: boolean;
-  }) {
-  const Comp = asChild ? Slot : "button";
-
-  return (
-    <Comp
-      data-slot="button"
-      className={cn(buttonVariants({ variant, size, className }))}
-      {...props}
-    />
-  );
-}
-
-export { Button, buttonVariants };

examples/betterauth/src/components/ui/card.tsx

@@ -1,92 +0,0 @@
-import * as React from "react";
-
-import { cn } from "@/lib/utils";
-
-function Card({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card"
-      className={cn(
-        "bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-header"
-      className={cn(
-        "@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-1.5 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-title"
-      className={cn("leading-none font-semibold", className)}
-      {...props}
-    />
-  );
-}
-
-function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-description"
-      className={cn("text-muted-foreground text-sm", className)}
-      {...props}
-    />
-  );
-}
-
-function CardAction({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-action"
-      className={cn(
-        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-function CardContent({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-content"
-      className={cn("px-6", className)}
-      {...props}
-    />
-  );
-}
-
-function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="card-footer"
-      className={cn("flex items-center px-6 [.border-t]:pt-6", className)}
-      {...props}
-    />
-  );
-}
-
-export {
-  Card,
-  CardHeader,
-  CardFooter,
-  CardTitle,
-  CardAction,
-  CardDescription,
-  CardContent,
-};

examples/betterauth/src/components/ui/input.tsx

@@ -1,21 +0,0 @@
-import * as React from "react";
-
-import { cn } from "@/lib/utils";
-
-function Input({ className, type, ...props }: React.ComponentProps<"input">) {
-  return (
-    <input
-      type={type}
-      data-slot="input"
-      className={cn(
-        "file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input flex h-9 w-full min-w-0 rounded-md border bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
-        "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
-        "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-export { Input };

examples/betterauth/src/components/ui/label.tsx

@@ -1,22 +0,0 @@
-import * as LabelPrimitive from "@radix-ui/react-label";
-import * as React from "react";
-
-import { cn } from "@/lib/utils";
-
-function Label({
-  className,
-  ...props
-}: React.ComponentProps<typeof LabelPrimitive.Root>) {
-  return (
-    <LabelPrimitive.Root
-      data-slot="label"
-      className={cn(
-        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
-        className,
-      )}
-      {...props}
-    />
-  );
-}
-
-export { Label };

examples/betterauth/src/components/ui/sonner.tsx

@@ -1,22 +0,0 @@
-"use client";
-
-import { Toaster as Sonner, type ToasterProps } from "sonner";
-
-const Toaster = ({ ...props }: ToasterProps) => {
-  return (
-    <Sonner
-      theme="light"
-      className="toaster group"
-      style={
-        {
-          "--normal-bg": "var(--popover)",
-          "--normal-text": "var(--popover-foreground)",
-          "--normal-border": "var(--border)",
-        } as React.CSSProperties
-      }
-      {...props}
-    />
-  );
-};
-
-export { Toaster };

examples/betterauth/src/components/user-settings.tsx

@@ -1,60 +0,0 @@
-"use client";
-
-import { Button } from "@/components/ui/button";
-import { useAccount, useIsAuthenticated } from "jazz-react";
-import { useAuth } from "jazz-react-auth-betterauth";
-import Link from "next/link";
-import { useRouter } from "next/navigation";
-import { toast } from "sonner";
-
-export function UserSettings() {
-  const router = useRouter();
-  const { authClient } = useAuth();
-  const { logOut } = useAccount();
-  const isAuthenticated = useIsAuthenticated();
-
-  if (!isAuthenticated) {
-    return (
-      <div className="flex flex-col gap-8">
-        <h1 className="text-center text-2xl">Forbidden</h1>
-        <p className="text-center text-sm text-muted-foreground">
-          Please{" "}
-          <Link href="/auth/sign-in" className="underline text-primary">
-            sign in
-          </Link>{" "}
-          to access this page.
-        </p>
-      </div>
-    );
-  }
-
-  return (
-    <>
-      <div className="flex flex-col gap-8">
-        <h1 className="text-4xl font-semibold">Settings</h1>
-
-        <Button
-          variant="destructive"
-          className="relative"
-          type="button"
-          onClick={async (e) => {
-            e.preventDefault();
-            authClient.deleteUser(undefined, {
-              onSuccess: () => {
-                logOut();
-                router.push("/");
-              },
-              onError: (error) => {
-                toast.error("Error", {
-                  description: error.error.message,
-                });
-              },
-            });
-          }}
-        >
-          Delete account
-        </Button>
-      </div>
-    </>
-  );
-}

examples/betterauth/src/lib/auth.ts

@@ -1,50 +0,0 @@
-import { betterAuth } from "better-auth";
-import { getMigrations } from "better-auth/db";
-import Database from "better-sqlite3";
-import { jazzPlugin } from "jazz-betterauth-server-plugin";
-import { socialProviders } from "./socialProviders";
-
-export const auth = await (async () => {
-  // Configure Better Auth server
-  const auth = betterAuth({
-    appName: "Jazz Example: Better Auth",
-    database: new Database("sqlite.db"),
-    emailAndPassword: {
-      enabled: true,
-      async sendResetPassword({ url }) {
-        // Here we can send an email to the user with the reset password link
-        console.log("****** RESET PASSWORD ******");
-        console.log("navigate to", url, "to reset your password");
-        console.log("******");
-      },
-    },
-    emailVerification: {
-      async sendVerificationEmail(data) {
-        console.error("Not implemented");
-      },
-    },
-    socialProviders,
-    user: {
-      deleteUser: {
-        enabled: true,
-      },
-    },
-    plugins: [jazzPlugin()],
-    databaseHooks: {
-      user: {
-        create: {
-          async after(user) {
-            // Here we can send a welcome email to the user
-            console.error("Not implemented");
-          },
-        },
-      },
-    },
-  });
-
-  // Run database migrations
-  const migrations = await getMigrations(auth.options);
-  await migrations.runMigrations();
-
-  return auth;
-})();

examples/betterauth/src/lib/socialProviders.ts

@@ -1,186 +0,0 @@
-const apple =
-  process.env.APPLE_CLIENT_ID &&
-  process.env.APPLE_CLIENT_SECRET &&
-  process.env.APPLE_APP_BUNDLE_IDENTIFIER
-    ? {
-        apple: {
-          clientId: process.env.APPLE_CLIENT_ID as string,
-          clientSecret: process.env.APPLE_CLIENT_SECRET as string,
-          // For native iOS
-          appBundleIdentifier: process.env
-            .APPLE_APP_BUNDLE_IDENTIFIER as string,
-        },
-      }
-    : undefined;
-const discord =
-  process.env.DISCORD_CLIENT_ID && process.env.DISCORD_CLIENT_SECRET
-    ? {
-        discord: {
-          clientId: process.env.DISCORD_CLIENT_ID as string,
-          clientSecret: process.env.DISCORD_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const facebook =
-  process.env.FACEBOOK_CLIENT_ID && process.env.FACEBOOK_CLIENT_SECRET
-    ? {
-        facebook: {
-          clientId: process.env.FACEBOOK_CLIENT_ID as string,
-          clientSecret: process.env.FACEBOOK_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const github =
-  process.env.GITHUB_CLIENT_ID && process.env.GITHUB_CLIENT_SECRET
-    ? {
-        github: {
-          clientId: process.env.GITHUB_CLIENT_ID as string,
-          clientSecret: process.env.GITHUB_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const google =
-  process.env.GOOGLE_CLIENT_ID && process.env.GOOGLE_CLIENT_SECRET
-    ? {
-        google: {
-          clientId: process.env.GOOGLE_CLIENT_ID as string,
-          clientSecret: process.env.GOOGLE_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const kick =
-  process.env.KICK_CLIENT_ID && process.env.KICK_CLIENT_SECRET
-    ? {
-        kick: {
-          clientId: process.env.KICK_CLIENT_ID as string,
-          clientSecret: process.env.KICK_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const microsoft =
-  process.env.MICROSOFT_CLIENT_ID && process.env.MICROSOFT_CLIENT_SECRET
-    ? {
-        microsoft: {
-          clientId: process.env.MICROSOFT_CLIENT_ID as string,
-          clientSecret: process.env.MICROSOFT_CLIENT_SECRET as string,
-          tenantId: "common",
-          requireSelectAccount: true,
-        },
-      }
-    : undefined;
-const tiktok =
-  process.env.TIKTOK_CLIENT_ID &&
-  process.env.TIKTOK_CLIENT_SECRET &&
-  process.env.TIKTOK_CLIENT_KEY
-    ? {
-        tiktok: {
-          clientId: process.env.TIKTOK_CLIENT_ID,
-          clientSecret: process.env.TIKTOK_CLIENT_SECRET,
-          clientKey: process.env.TIKTOK_CLIENT_KEY,
-        },
-      }
-    : undefined;
-const twitch =
-  process.env.TWITCH_CLIENT_ID && process.env.TWITCH_CLIENT_SECRET
-    ? {
-        twitch: {
-          clientId: process.env.TWITCH_CLIENT_ID as string,
-          clientSecret: process.env.TWITCH_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const twitter =
-  process.env.TWITTER_CLIENT_ID && process.env.TWITTER_CLIENT_SECRET
-    ? {
-        twitter: {
-          clientId: process.env.TWITTER_CLIENT_ID,
-          clientSecret: process.env.TWITTER_CLIENT_SECRET,
-        },
-      }
-    : undefined;
-const dropbox =
-  process.env.DROPBOX_CLIENT_ID && process.env.DROPBOX_CLIENT_SECRET
-    ? {
-        dropbox: {
-          clientId: process.env.DROPBOX_CLIENT_ID as string,
-          clientSecret: process.env.DROPBOX_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const linkedin =
-  process.env.LINKEDIN_CLIENT_ID && process.env.LINKEDIN_CLIENT_SECRET
-    ? {
-        linkedin: {
-          clientId: process.env.LINKEDIN_CLIENT_ID as string,
-          clientSecret: process.env.LINKEDIN_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const gitlab =
-  process.env.GITLAB_CLIENT_ID &&
-  process.env.GITLAB_CLIENT_SECRET &&
-  process.env.GITLAB_ISSUER
-    ? {
-        gitlab: {
-          clientId: process.env.GITLAB_CLIENT_ID as string,
-          clientSecret: process.env.GITLAB_CLIENT_SECRET as string,
-          issuer: process.env.GITLAB_ISSUER as string,
-        },
-      }
-    : undefined;
-const reddit =
-  process.env.REDDIT_CLIENT_ID && process.env.REDDIT_CLIENT_SECRET
-    ? {
-        reddit: {
-          clientId: process.env.REDDIT_CLIENT_ID as string,
-          clientSecret: process.env.REDDIT_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const roblox =
-  process.env.ROBLOX_CLIENT_ID && process.env.ROBLOX_CLIENT_SECRET
-    ? {
-        roblox: {
-          clientId: process.env.ROBLOX_CLIENT_ID,
-          clientSecret: process.env.ROBLOX_CLIENT_SECRET,
-        },
-      }
-    : undefined;
-const spotify =
-  process.env.SPOTIFY_CLIENT_ID && process.env.SPOTIFY_CLIENT_SECRET
-    ? {
-        spotify: {
-          clientId: process.env.SPOTIFY_CLIENT_ID as string,
-          clientSecret: process.env.SPOTIFY_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-const vk =
-  process.env.VK_CLIENT_ID && process.env.VK_CLIENT_SECRET
-    ? {
-        vk: {
-          clientId: process.env.VK_CLIENT_ID as string,
-          clientSecret: process.env.VK_CLIENT_SECRET as string,
-        },
-      }
-    : undefined;
-
-export const socialProviders = {
-  ...(apple && { ...apple }),
-  ...(discord && { ...discord }),
-  ...(facebook && { ...facebook }),
-  ...(github && { ...github }),
-  ...(google && { ...google }),
-  ...(kick && { ...kick }),
-  ...(microsoft && { ...microsoft }),
-  ...(tiktok && { ...tiktok }),
-  ...(twitch && { ...twitch }),
-  ...(twitter && { ...twitter }),
-  ...(dropbox && { ...dropbox }),
-  ...(linkedin && { ...linkedin }),
-  ...(gitlab && { ...gitlab }),
-  ...(reddit && { ...reddit }),
-  ...(roblox && { ...roblox }),
-  ...(spotify && { ...spotify }),
-  ...(vk && { ...vk }),
-};

examples/betterauth/src/lib/utils.ts

@@ -1,6 +0,0 @@
-import { type ClassValue, clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs));
-}

examples/betterauth/tests/authFlow.spec.ts

@@ -1,28 +0,0 @@
-import { randomBytes } from "node:crypto";
-import { test } from "@playwright/test";
-import { HomePage } from "./pages/HomePage";
-
-test("should sign up, sign in, and logout", async ({ page }) => {
-  const username = randomBytes(4).toString("hex");
-  const email = `${username}@example.com`;
-  const password = randomBytes(8).toString("hex");
-
-  // Sign up
-  await page.goto("/");
-  const homePage = new HomePage(page);
-  await homePage.expectLoggedOut();
-  await homePage.signUpLink.click();
-  await homePage.signUpEmail(username, email, password);
-  await homePage.expectLoggedIn(username);
-
-  // Log out & sign in
-  await homePage.logout();
-  await homePage.expectLoggedOut();
-  await homePage.signInLink.click();
-  await homePage.signInEmail(email, password);
-  await homePage.expectLoggedIn(username);
-
-  // Logout
-  await homePage.logout();
-  await homePage.expectLoggedOut();
-});

examples/betterauth/tests/pages/HomePage.ts

@@ -1,76 +0,0 @@
-import { type Page, expect } from "@playwright/test";
-
-export class HomePage {
-  constructor(public page: Page) {}
-
-  usernameInput = this.page.getByRole("textbox", {
-    name: "Name",
-    exact: true,
-  });
-  emailInput = this.page.getByRole("textbox", {
-    name: "Email",
-    exact: true,
-  });
-  passwordInput = this.page.getByRole("textbox", {
-    name: "Password",
-    exact: true,
-  });
-  confirmPasswordInput = this.page.getByRole("textbox", {
-    name: "Confirm password",
-    exact: true,
-  });
-  signUpButton = this.page.getByRole("button", {
-    name: "Sign up",
-    exact: true,
-  });
-  signInButton = this.page.getByRole("button", {
-    name: "Sign in",
-    exact: true,
-  });
-  signUpLink = this.page.getByRole("link", {
-    name: "Sign up",
-    exact: true,
-  });
-  signInLink = this.page.getByRole("link", {
-    name: "Sign in",
-    exact: true,
-  });
-  logoutButton = this.page.getByRole("button", {
-    name: "Sign out",
-    exact: true,
-  });
-
-  async signUpEmail(name: string, email: string, password: string) {
-    await this.usernameInput.fill(name);
-    await this.emailInput.fill(email);
-    await this.passwordInput.fill(password);
-    await this.confirmPasswordInput.fill(password);
-    await this.signUpButton.click();
-  }
-
-  async signInEmail(email: string, password: string) {
-    await this.emailInput.fill(email);
-    await this.passwordInput.fill(password);
-    await this.signInButton.click();
-  }
-
-  async logout() {
-    await this.logoutButton.click();
-  }
-
-  async expectLoggedIn(name?: string) {
-    await expect(this.logoutButton).toBeVisible();
-    await expect(this.signInLink).not.toBeVisible();
-    await expect(this.signUpLink).not.toBeVisible();
-    if (name) {
-      await expect(this.page.getByText(`Signed in as ${name}`)).toBeVisible();
-    }
-  }
-
-  async expectLoggedOut() {
-    await expect(this.logoutButton).not.toBeVisible();
-    await expect(this.signInLink).toBeVisible();
-    await expect(this.signUpLink).toBeVisible();
-    await expect(this.page.getByText(`Anonymous user`)).toBeVisible();
-  }
-}

examples/book-shelf/.gitignore

@@ -3,12 +3,8 @@
 # dependencies
 /node_modules
 /.pnp
-.pnp.*
-.yarn/*
-!.yarn/patches
-!.yarn/plugins
-!.yarn/releases
-!.yarn/versions
+.pnp.js
+.yarn/install-state.gz
 
 # testing
 /coverage
@@ -28,10 +24,9 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-.pnpm-debug.log*
 
-# env files (can opt-in for committing if needed)
-.env*
+# local env files
+.env*.local
 
 # vercel
 .vercel

examples/book-shelf/CHANGELOG.md

@@ -0,0 +1,286 @@
+# jazz-example-book-shelf
+
+## 0.1.34
+
+### Patch Changes
+
+- jazz-react@0.8.44
+- jazz-tools@0.8.44
+- jazz-browser-media-images@0.8.44
+
+## 0.1.33
+
+### Patch Changes
+
+- jazz-react@0.8.41
+- jazz-tools@0.8.41
+- jazz-browser-media-images@0.8.41
+
+## 0.1.32
+
+### Patch Changes
+
+- jazz-browser-media-images@0.8.40
+- jazz-react@0.8.40
+
+## 0.1.31
+
+### Patch Changes
+
+- Updated dependencies [249eecb]
+  - jazz-tools@0.8.39
+  - jazz-browser-media-images@0.8.39
+  - jazz-react@0.8.39
+
+## 0.1.30
+
+### Patch Changes
+
+- jazz-react@0.8.38
+- jazz-tools@0.8.38
+- jazz-browser-media-images@0.8.38
+
+## 0.1.29
+
+### Patch Changes
+
+- jazz-react@0.8.37
+- jazz-tools@0.8.37
+- jazz-browser-media-images@0.8.37
+
+## 0.1.28
+
+### Patch Changes
+
+- Updated dependencies [441fe27]
+  - jazz-tools@0.8.36
+  - jazz-react@0.8.36
+  - jazz-browser-media-images@0.8.36
+
+## 0.1.27
+
+### Patch Changes
+
+- Updated dependencies [9212ab8]
+- Updated dependencies [8b87117]
+  - jazz-react@0.8.35
+  - jazz-tools@0.8.35
+  - jazz-browser-media-images@0.8.35
+
+## 0.1.26
+
+### Patch Changes
+
+- jazz-react@0.8.34
+- jazz-tools@0.8.34
+- jazz-browser-media-images@0.8.34
+
+## 0.1.25
+
+### Patch Changes
+
+- jazz-browser-media-images@0.8.33
+- jazz-react@0.8.33
+
+## 0.1.24
+
+### Patch Changes
+
+- Updated dependencies [df42b2b]
+  - jazz-tools@0.8.32
+  - jazz-react@0.8.32
+  - jazz-browser-media-images@0.8.32
+
+## 0.1.23
+
+### Patch Changes
+
+- jazz-react@0.8.31
+- jazz-tools@0.8.31
+- jazz-browser-media-images@0.8.31
+
+## 0.1.22
+
+### Patch Changes
+
+- jazz-react@0.8.30
+- jazz-tools@0.8.30
+- jazz-browser-media-images@0.8.30
+
+## 0.1.21
+
+### Patch Changes
+
+- jazz-react@0.8.29
+- jazz-tools@0.8.29
+- jazz-browser-media-images@0.8.29
+
+## 0.1.20
+
+### Patch Changes
+
+- jazz-react@0.8.28
+- jazz-tools@0.8.28
+- jazz-browser-media-images@0.8.28
+
+## 0.1.19
+
+### Patch Changes
+
+- jazz-react@0.8.27
+- jazz-tools@0.8.27
+- jazz-browser-media-images@0.8.27
+
+## 0.1.18
+
+### Patch Changes
+
+- Updated dependencies [59d37df]
+  - jazz-react@0.8.26
+
+## 0.1.17
+
+### Patch Changes
+
+- jazz-browser-media-images@0.8.24
+- jazz-react@0.8.24
+
+## 0.1.16
+
+### Patch Changes
+
+- Updated dependencies [d348c2d]
+- Updated dependencies [6902b5b]
+- Updated dependencies [1a0cd3d]
+  - jazz-tools@0.8.23
+  - jazz-react@0.8.23
+  - jazz-browser-media-images@0.8.23
+
+## 0.1.15
+
+### Patch Changes
+
+- Updated dependencies [59cc64d]
+  - jazz-react@0.8.22
+  - jazz-browser-media-images@0.8.22
+
+## 0.1.14
+
+### Patch Changes
+
+- Updated dependencies [149ca97]
+  - jazz-tools@0.8.21
+  - jazz-react@0.8.21
+  - jazz-browser-media-images@0.8.21
+
+## 0.1.13
+
+### Patch Changes
+
+- Updated dependencies [dd9b13f]
+- Updated dependencies [a69ed0b]
+- Updated dependencies [3ef3ff3]
+- Updated dependencies [c6931b8]
+  - jazz-react@0.8.20
+  - jazz-browser-media-images@0.8.20
+
+## 0.1.12
+
+### Patch Changes
+
+- jazz-react@0.8.19
+- jazz-tools@0.8.19
+- jazz-browser-media-images@0.8.19
+
+## 0.1.11
+
+### Patch Changes
+
+- jazz-react@0.8.18
+- jazz-tools@0.8.18
+- jazz-browser-media-images@0.8.18
+
+## 0.1.10
+
+### Patch Changes
+
+- jazz-react@0.8.17
+- jazz-tools@0.8.17
+- jazz-browser-media-images@0.8.17
+
+## 0.1.9
+
+### Patch Changes
+
+- Updated dependencies [2af107c]
+  - jazz-react@0.8.16
+  - jazz-browser-media-images@0.8.16
+  - jazz-tools@0.8.16
+
+## 0.1.8
+
+### Patch Changes
+
+- Updated dependencies [cce679b]
+  - jazz-tools@0.8.15
+  - jazz-browser-media-images@0.8.15
+  - jazz-react@0.8.15
+
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies [36273b3]
+  - jazz-tools@0.8.14
+  - jazz-browser-media-images@0.8.14
+  - jazz-react@0.8.14
+
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies [fd011d7]
+  - jazz-tools@0.8.13
+  - jazz-browser-media-images@0.8.13
+  - jazz-react@0.8.13
+
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies [3cc6aee]
+  - jazz-react@0.8.12
+  - jazz-tools@0.8.12
+  - jazz-browser-media-images@0.8.12
+
+## 0.1.4
+
+### Patch Changes
+
+- jazz-react@0.8.11
+- jazz-tools@0.8.11
+- jazz-browser-media-images@0.8.11
+
+## 0.1.3
+
+### Patch Changes
+
+- jazz-browser-media-images@0.8.7
+- jazz-react@0.8.7
+
+## 0.1.2
+
+### Patch Changes
+
+- jazz-browser-media-images@0.8.6
+- jazz-react@0.8.6
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies [c3f4e6b]
+- Updated dependencies [d9152ed]
+  - jazz-tools@0.8.5
+  - jazz-browser-media-images@0.8.5
+  - jazz-react@0.8.5

examples/book-shelf/Dockerfile

@@ -0,0 +1,4 @@
+FROM caddy:2.7.3-alpine
+LABEL org.opencontainers.image.source="https://github.com/garden-co/jazz"
+
+COPY ./dist /usr/share/caddy/

examples/book-shelf/README.md

@@ -0,0 +1,41 @@
+# Book shelf example with Jazz and Next.js
+
+This is an example of a book shelf where you can add and review books.
+It shows you how to create and edit data, upload images, and share data publicly.
+
+Live version: https://books-demo.jazz.tools
+
+## Installing & running the example locally
+
+(This requires `pnpm` to be installed, see [https://pnpm.io/installation](https://pnpm.io/installation))
+
+Start by downloading the [jazz repository](https://github.com/garden-co/jazz):
+```bash
+npx degit gardencmp/jazz jazz
+```
+
+Go to the book-shelf example directory:
+```bash
+cd jazz/examples/book-shelf
+```
+
+Install and build dependencies:
+```bash
+pnpm i && npx turbo build
+```
+
+Start the dev server:
+```bash
+pnpm dev
+```
+
+## Questions / problems / feedback
+
+If you have feedback, let us know on [Discord](https://discord.gg/utDMjHYg42) or open an issue or PR to fix something that seems wrong.
+
+
+## Configuration: sync server
+
+By default, the example app uses [Jazz Cloud](https://jazz.tools/cloud) (`wss://cloud.jazz.tools`) - so cross-device use, invites and collaboration should just work.
+
+You can also run a local sync server by running `npx jazz-run sync` and adding the query param `?sync=ws://localhost:4200` to the URL of the example app (for example: `http://localhost:5173/?peer=ws://localhost:4200`), or by setting the `sync` parameter of the `<Jazz.Provider>` provider component in [./src/components/JazzAndAuth.tsx](./src/components/JazzAndAuth.tsx).

examples/book-shelf/job-template.nomad

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

examples/book-shelf/next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/basic-features/typescript for more information.

examples/book-shelf/next.config.mjs

@@ -0,0 +1,4 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {};
+
+export default nextConfig;

examples/book-shelf/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "jazz-example-book-shelf",
+  "version": "0.1.34",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "format-and-lint": "biome check .",
+    "format-and-lint:fix": "biome check . --write",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "clsx": "^2.0.0",
+    "jazz-browser-media-images": "workspace:0.8.44",
+    "jazz-react": "workspace:0.8.44",
+    "jazz-tools": "workspace:0.8.44",
+    "next": "14.2.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.5.1",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "postcss": "^8.4.27",
+    "tailwindcss": "^3.4.9",
+    "typescript": "~5.6.2"
+  }
+}

examples/book-shelf/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    tailwindcss: {},
+  },
+};
+
+export default config;

examples/book-shelf/src/app/add/page.tsx

@@ -0,0 +1,139 @@
+"use client";
+
+import { Button } from "@/components/Button";
+import { Container } from "@/components/Container";
+import { useAccount } from "@/components/JazzAndAuth";
+import RatingInput from "@/components/RatingInput";
+import { BookReview, ListOfBookReviews } from "@/schema";
+import { createImage } from "jazz-browser-media-images";
+import { Group, ImageDefinition } from "jazz-tools";
+import { useRouter } from "next/navigation";
+import { ChangeEvent, useState } from "react";
+
+export default function AddBookReview() {
+  const { me } = useAccount();
+
+  const [title, setTitle] = useState("");
+  const [author, setAuthor] = useState("");
+  const [review, setReview] = useState("");
+  const [rating, setRating] = useState(0);
+  const [dateRead, setDateRead] = useState(
+    new Date().toISOString().split("T")[0],
+  );
+  const [coverImage, setCoverImage] = useState<ImageDefinition | undefined>();
+
+  const router = useRouter();
+
+  const onDateChange = (event: ChangeEvent<HTMLInputElement>) => {
+    const date = new Date(event.currentTarget.value)
+      .toISOString()
+      .split("T")[0];
+    setDateRead(date);
+  };
+
+  const onImageChange = (event: ChangeEvent<HTMLInputElement>) => {
+    const file = event.currentTarget.files?.[0];
+    const group = Group.create({ owner: me });
+    group.addMember("everyone", "reader");
+
+    if (file) {
+      createImage(file, { owner: group }).then((image) => {
+        setCoverImage(image);
+      });
+    }
+  };
+
+  const onSubmit = (event: React.FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+
+    if (!me?.profile) return;
+
+    const bookReview = BookReview.create(
+      {
+        title,
+        author,
+        review,
+        rating,
+        dateRead: new Date(dateRead),
+        cover: coverImage,
+      },
+      {
+        owner: me.profile._owner,
+      },
+    );
+
+    if (!me.profile.bookReviews) {
+      me.profile.bookReviews = ListOfBookReviews.create([], {
+        owner: me.profile._owner,
+      });
+    }
+
+    me.profile.bookReviews.push(bookReview);
+    router.push("/");
+  };
+
+  return (
+    <Container className="grid max-w-lg gap-8 py-8">
+      <h1 className="text-lg font-semibold text-black">Add book review</h1>
+      <form action="" className="grid gap-4" onSubmit={onSubmit}>
+        <label className="grid gap-1 text-sm text-gray-600">
+          Cover
+          <input type="file" onChange={onImageChange} />
+        </label>
+
+        <label className="grid gap-1 text-sm text-gray-600">
+          Title
+          <input
+            className="rounded border border-gray-300 px-2 py-1 shadow-sm"
+            type="text"
+            value={title}
+            required
+            onChange={(e) => setTitle(e.target.value)}
+          ></input>
+        </label>
+
+        <label className="grid gap-1 text-sm text-gray-600">
+          Author
+          <input
+            className="rounded border border-gray-300 px-2 py-1 shadow-sm"
+            type="text"
+            value={author}
+            required
+            onChange={(e) => setAuthor(e.target.value)}
+          ></input>
+        </label>
+
+        <label className="grid gap-1 text-sm text-gray-600">
+          Date read
+          <input
+            className="rounded border border-gray-300 px-2 py-1 shadow-sm"
+            type="date"
+            value={dateRead}
+            required
+            onChange={onDateChange}
+          />
+        </label>
+
+        <div className="grid gap-1 text-sm text-gray-600">
+          Rating
+          <RatingInput
+            value={rating}
+            onChange={(rating) => setRating(rating)}
+          />
+        </div>
+
+        <label className="grid gap-1 text-sm text-gray-600">
+          Review
+          <textarea
+            className="rounded border border-gray-300 px-2 py-1 shadow-sm"
+            value={review}
+            onChange={(e) => setReview(e.target.value)}
+          ></textarea>
+        </label>
+        <Button variant="primary" type="submit">
+          Add
+        </Button>
+      </form>
+    </Container>
+  );
+}

examples/book-shelf/src/app/book/[slug]/page.tsx

@@ -0,0 +1,172 @@
+"use client";
+
+import { BookCover } from "@/components/BookCover";
+import { Container } from "@/components/Container";
+import { useCoState } from "@/components/JazzAndAuth";
+import Rating from "@/components/Rating";
+import RatingInput from "@/components/RatingInput";
+import { BookReview } from "@/schema";
+import clsx from "clsx";
+import { Group, ID } from "jazz-tools";
+
+const BookReviewTitle = ({
+  bookReview,
+  readOnly,
+}: {
+  bookReview: BookReview;
+  readOnly: boolean;
+}) => {
+  const className = "font-serif text-2xl font-bold lg:text-4xl";
+
+  if (readOnly) {
+    return <h1 className={className}>{bookReview.title}</h1>;
+  }
+
+  return (
+    <input
+      value={bookReview.title}
+      placeholder="Book title"
+      className={clsx(
+        className,
+        "w-full rounded border border-transparent px-2 py-1 hover:border-gray-300 hover:shadow-sm",
+      )}
+      onChange={(e) => (bookReview.title = e.target.value)}
+    ></input>
+  );
+};
+
+const BookReviewAuthor = ({
+  bookReview,
+  readOnly,
+}: {
+  bookReview: BookReview;
+  readOnly: boolean;
+}) => {
+  const className = "text-gray-700";
+
+  if (readOnly) {
+    return <p className={className}>by {bookReview.author}</p>;
+  }
+
+  return (
+    <input
+      value={bookReview.author}
+      placeholder="Author"
+      className={clsx(
+        className,
+        "w-full rounded border border-transparent px-2 py-1 hover:border-gray-300 hover:shadow-sm",
+      )}
+      onChange={(e) => (bookReview.author = e.target.value)}
+    ></input>
+  );
+};
+
+const BookReviewDateRead = ({
+  bookReview,
+  readOnly,
+}: {
+  bookReview: BookReview;
+  readOnly: boolean;
+}) => {
+  const className = "text-gray-700 max-w-[10rem]";
+
+  if (readOnly) {
+    return (
+      bookReview.dateRead && (
+        <p className={className}>{bookReview.dateRead.toLocaleDateString()}</p>
+      )
+    );
+  }
+
+  return (
+    <input
+      type="date"
+      value={bookReview.dateRead?.toISOString().split("T")[0]}
+      placeholder="Date read"
+      className={clsx(
+        className,
+        "w-full rounded border border-transparent px-2 py-1 hover:border-gray-300 hover:shadow-sm",
+      )}
+      onChange={(e) => {
+        const date = new Date(e.target.value);
+        bookReview.dateRead = date;
+      }}
+    ></input>
+  );
+};
+
+const BookReviewReview = ({
+  bookReview,
+  readOnly,
+}: {
+  bookReview: BookReview;
+  readOnly: boolean;
+}) => {
+  const className = "text-sm leading-relaxed text-gray-600";
+
+  if (readOnly) {
+    if (bookReview.review) {
+      return <p className={className}>{bookReview.review}</p>;
+    }
+  }
+
+  return (
+    <textarea
+      value={bookReview.review}
+      placeholder="Write your review here..."
+      className={clsx(
+        className,
+        "w-full rounded border border-transparent px-2 py-1 hover:border-gray-300 hover:shadow-sm",
+      )}
+      onChange={(e) => (bookReview.review = e.target.value)}
+    ></textarea>
+  );
+};
+
+const BookReviewRating = ({
+  bookReview,
+  readOnly,
+}: {
+  bookReview: BookReview;
+  readOnly: boolean;
+}) => {
+  const className = "text-2xl sm:mx-0";
+
+  if (readOnly) {
+    return <Rating className={className} rating={bookReview.rating} />;
+  }
+
+  return (
+    <RatingInput
+      className={clsx(className, "p-2")}
+      onChange={(rating) => (bookReview.rating = rating)}
+      value={bookReview.rating}
+    />
+  );
+};
+
+export default function Page({ params }: { params: { slug: string } }) {
+  const bookReview = useCoState(BookReview, params.slug as ID<BookReview>);
+
+  if (!bookReview) return <></>;
+
+  const readOnly = !(bookReview._owner.castAs(Group).myRole() === "admin");
+
+  return (
+    <Container className="grid gap-12 py-8">
+      <div className="flex flex-col gap-6 sm:flex-row md:gap-10">
+        <div className="w-[180px]">
+          <BookCover bookReview={bookReview} readOnly={readOnly} />
+        </div>
+
+        <div className="-mx-2 grid max-w-lg flex-1 gap-3 sm:mx-0">
+          <BookReviewTitle bookReview={bookReview} readOnly={readOnly} />
+          <BookReviewAuthor bookReview={bookReview} readOnly={readOnly} />
+          <BookReviewDateRead bookReview={bookReview} readOnly={readOnly} />
+          <BookReviewRating bookReview={bookReview} readOnly={readOnly} />
+          <BookReviewReview bookReview={bookReview} readOnly={readOnly} />
+        </div>
+      </div>
+    </Container>
+  );
+}

examples/book-shelf/src/app/globals.css

@@ -0,0 +1,13 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  :focus {
+    @apply outline-none;
+  }
+
+  :focus-visible {
+    @apply ring-2 ring-purple-600/75 dark:ring-2 dark:ring-white/75;
+  }
+}

examples/book-shelf/src/app/layout.tsx

@@ -0,0 +1,39 @@
+import type { Metadata } from "next";
+import { Inter } from "next/font/google";
+import "./globals.css";
+import { JazzAndAuth } from "@/components/JazzAndAuth";
+import { Nav } from "@/components/Nav";
+import clsx from "clsx";
+import { Fraunces } from "next/font/google";
+
+const fraunces = Fraunces({
+  subsets: ["latin"],
+  display: "swap",
+  variable: "--font-fraunces",
+});
+
+const inter = Inter({ subsets: ["latin"] });
+
+export const metadata: Metadata = {
+  title: "Jazz Book Shelf",
+  description: "Jazz Book Shelf",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={clsx(inter.className, fraunces.variable)}>
+        <JazzAndAuth>
+          <header>
+            <Nav />
+          </header>
+          <main>{children}</main>
+        </JazzAndAuth>
+      </body>
+    </html>
+  );
+}

examples/book-shelf/src/app/page.tsx

@@ -0,0 +1,27 @@
+"use client";
+
+import { Container } from "@/components/Container";
+import { useAccount } from "@/components/JazzAndAuth";
+import UserProfile from "@/components/UserProfile";
+import { JazzAccount } from "@/schema";
+import { ID } from "jazz-tools";
+
+export default function Home() {
+  const { me } = useAccount();
+
+  return (
+    <Container className="grid gap-12 py-8">
+      <UserProfile id={me?.id as ID<JazzAccount>} />
+
+      <label className="flex flex-wrap items-center gap-3">
+        Share your profile:
+        <input
+          type="text"
+          className="w-full rounded border p-1"
+          value={`${window.location.origin}/user/${me?.id}`}
+          readOnly
+        />
+      </label>
+    </Container>
+  );
+}

examples/book-shelf/src/app/user/[slug]/page.tsx

@@ -0,0 +1,14 @@
+import { Container } from "@/components/Container";
+import UserProfile from "@/components/UserProfile";
+import { JazzAccount } from "@/schema";
+import { ID } from "jazz-tools";
+
+export default function Page({ params }: { params: { slug: string } }) {
+  const { slug } = params;
+
+  return (
+    <Container className="py-8">
+      <UserProfile id={slug as ID<JazzAccount>} />
+    </Container>
+  );
+}

examples/book-shelf/src/components/BookCover.tsx

@@ -0,0 +1,134 @@
+import { Button } from "@/components/Button";
+import { useAccount } from "@/components/JazzAndAuth";
+import PlusIcon from "@/components/icons/PlusIcon";
+import { BookReview } from "@/schema";
+import clsx from "clsx";
+import { createImage } from "jazz-browser-media-images";
+import { ProgressiveImg } from "jazz-react";
+import { Group, ImageDefinition } from "jazz-tools";
+import { ChangeEvent, useRef, useState } from "react";
+
+const BookCoverContainer = ({
+  children,
+  className = "",
+}: {
+  children: React.ReactNode;
+  className?: string;
+}) => {
+  return (
+    <div className={clsx("h-[240px] lg:h-[260px]", className)}>{children}</div>
+  );
+};
+
+const MockCover = ({ bookReview }: { bookReview: BookReview }) => {
+  return (
+    <div className="flex h-full flex-col items-center justify-center gap-3 rounded-l-sm rounded-r-md bg-gray-100 px-3 text-center shadow-lg">
+      <p className="font-medium">{bookReview.title}</p>
+      <p className="text-xs">{bookReview.author}</p>
+    </div>
+  );
+};
+
+export function BookCoverReadOnly({
+  bookReview,
+  className,
+}: {
+  bookReview: BookReview;
+  className?: string;
+}) {
+  if (bookReview.cover) {
+    return (
+      <BookCoverContainer className={className}>
+        <ProgressiveImg image={bookReview.cover}>
+          {({ src }) => (
+            <img
+              className="max-h-full max-w-full rounded-l-sm rounded-r-md shadow-lg"
+              src={src}
+            />
+          )}
+        </ProgressiveImg>
+      </BookCoverContainer>
+    );
+  }
+
+  return (
+    <BookCoverContainer className={className}>
+      <MockCover bookReview={bookReview} />
+    </BookCoverContainer>
+  );
+}
+
+export function BookCoverInput({ bookReview }: { bookReview: BookReview }) {
+  const { me } = useAccount();
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  const onImageChange = (event: ChangeEvent<HTMLInputElement>) => {
+    if (!me?.profile) return;
+
+    const file = event.currentTarget.files?.[0];
+
+    if (file) {
+      createImage(file, { owner: me.profile._owner }).then((image) => {
+        bookReview.cover = image;
+      });
+    }
+  };
+
+  const onUploadClick = () => {
+    inputRef.current?.click();
+  };
+
+  const remove = () => {
+    bookReview.cover = null;
+  };
+
+  if (bookReview.cover) {
+    return (
+      <div className="group relative inline-block">
+        <BookCoverReadOnly
+          className="transition-opacity group-hover:opacity-40"
+          bookReview={bookReview}
+        />
+        <div className="absolute left-0 top-0 hidden h-full w-full items-center justify-center rounded-l-sm rounded-r-md group-hover:flex">
+          <Button
+            variant="tertiary"
+            type="button"
+            className="shadow"
+            onClick={remove}
+          >
+            Remove
+          </Button>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <BookCoverContainer className="flex w-[180px] flex-col justify-center rounded-l-sm rounded-r-md bg-gray-100 p-3 shadow-lg">
+      <button
+        className="flex h-full w-full flex-col items-center justify-center gap-3 text-gray-500 transition-colors hover:text-gray-600"
+        type="button"
+        onClick={onUploadClick}
+      >
+        <PlusIcon className="h-10 w-10" />
+        Upload book cover
+      </button>
+      <label className="sr-only">
+        Cover
+        <input ref={inputRef} type="file" onChange={onImageChange} />
+      </label>
+    </BookCoverContainer>
+  );
+}
+
+export function BookCover({
+  bookReview,
+  readOnly,
+}: {
+  bookReview: BookReview;
+  readOnly?: boolean;
+}) {
+  if (readOnly) return <BookCoverReadOnly bookReview={bookReview} />;
+
+  return <BookCoverInput bookReview={bookReview} />;
+}

examples/book-shelf/src/components/BookReviewHeader.tsx

@@ -0,0 +1,30 @@
+import { BookCover } from "@/components/BookCover";
+import Rating from "@/components/Rating";
+import RatingInput from "@/components/RatingInput";
+import { BookReview } from "@/schema";
+import { Group } from "jazz-tools";
+
+export function BookReviewHeader({ bookReview }: { bookReview: BookReview }) {
+  const { title, author, rating, review, dateRead } = bookReview;
+
+  return (
+    <div className="grid gap-5">
+      <div>
+        <h1 className="mb-1 font-serif text-2xl font-bold md:mb-3 lg:text-4xl">
+          {title}
+        </h1>
+
+        <p className="text-gray-500">by {author}</p>
+      </div>
+
+      {bookReview._owner.castAs(Group).myRole() === "admin" ? (
+        <RatingInput
+          onChange={(rating) => (bookReview.rating = rating)}
+          value={rating}
+        />
+      ) : (
+        <Rating className="mx-auto text-2xl sm:mx-0" rating={rating} />
+      )}
+    </div>
+  );
+}

examples/book-shelf/src/components/BookReviewThumbnail.tsx

@@ -0,0 +1,35 @@
+"use client";
+
+import { BookCover, BookCoverReadOnly } from "@/components/BookCover";
+import { useCoState } from "@/components/JazzAndAuth";
+import StarIcon from "@/components/icons/StarIcon";
+import { ID } from "jazz-tools";
+import Link from "next/link";
+import { BookReview } from "../schema";
+
+export function BookReviewThumbnail({ id }: { id: ID<BookReview> }) {
+  const bookReview = useCoState(BookReview, id);
+
+  if (!bookReview) return <></>;
+
+  return (
+    <div className="inline-flex shrink-0 gap-4 rounded border p-4 sm:block sm:space-y-6 sm:border-0 sm:p-0 md:w-[200px]">
+      <Link href={`/book/${bookReview.id}`} className="sm:block sm:flex-1">
+        <BookCoverReadOnly bookReview={bookReview} />
+      </Link>
+
+      <div className="flex-1">
+        <Link href={`/book/${bookReview.id}`}>
+          <h2 className="mb-1 text-sm font-medium">{bookReview.title}</h2>
+        </Link>
+        <div className="mb-2 flex flex-col gap-2 text-sm text-gray-500 sm:flex-row sm:items-center">
+          <p>{bookReview.author}</p>
+          <div className="flex items-center gap-0.5 text-xs font-semibold leading-none">
+            <StarIcon className="-mt-px text-base text-yellow-400" />
+            {bookReview.rating}
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

examples/book-shelf/src/components/Button.tsx

@@ -0,0 +1,65 @@
+import clsx from "clsx";
+import Link from "next/link";
+import type { ComponentProps } from "react";
+
+interface Props {
+  variant?: "primary" | "secondary" | "tertiary";
+  className?: string;
+  size?: "sm" | "md" | "lg";
+}
+
+interface AnchorProps
+  extends Props,
+    React.AnchorHTMLAttributes<HTMLAnchorElement> {
+  href: string;
+}
+
+type ButtonProps = ComponentProps<"button"> & Props;
+
+export function Button(props: AnchorProps | ButtonProps) {
+  const {
+    className: customClassName = "",
+    variant = "primary",
+    children,
+    size = "md",
+  } = props;
+
+  const variantClassNames = {
+    base: "inline-flex gap-2 items-center justify-center rounded-full overflow-hidden transition-colors",
+    primary:
+      "bg-purple-300 font-medium text-purple-950 px-4 py-2 rounded-full hover:bg-purple-200",
+    secondary:
+      "rounded-full bg-slate-100 font-medium text-slate-600 hover:bg-slate-200",
+    tertiary: "rounded-full bg-white text-purple-950 font-medium",
+  };
+
+  const sizeClassNames = {
+    sm: "py-1.5 px-3 text-sm",
+    md: "py-2 px-5",
+    lg: "py-2 md:py-2.5 px-6 md:text-lg",
+  };
+
+  const className = clsx(
+    customClassName,
+    variantClassNames.base,
+    variantClassNames[variant],
+    sizeClassNames[size],
+  );
+
+  if (!!(props as AnchorProps).href) {
+    const anchorProps = props as AnchorProps;
+    return (
+      <Link href={anchorProps.href} className={className}>
+        {children}
+      </Link>
+    );
+  }
+
+  const buttonProps = props as ButtonProps;
+
+  return (
+    <button {...buttonProps} className={className}>
+      {children}
+    </button>
+  );
+}

examples/book-shelf/src/components/Container.tsx

@@ -0,0 +1,13 @@
+import clsx from "clsx";
+
+export function Container({
+  children,
+  className,
+}: {
+  children: React.ReactNode;
+  className?: string;
+}) {
+  return (
+    <div className={clsx("mx-auto max-w-4xl px-4", className)}>{children}</div>
+  );
+}

examples/book-shelf/src/components/JazzAndAuth.tsx

@@ -0,0 +1,29 @@
+"use client";
+
+import { JazzAccount } from "@/schema";
+import { DemoAuthBasicUI, createJazzReactApp, useDemoAuth } from "jazz-react";
+
+const Jazz = createJazzReactApp({
+  AccountSchema: JazzAccount,
+});
+
+export const { useAccount, useCoState } = Jazz;
+
+export function JazzAndAuth({ children }: { children: React.ReactNode }) {
+  const [auth, authState] = useDemoAuth();
+
+  return (
+    <>
+      <Jazz.Provider
+        auth={auth}
+        // replace `you@example.com` with your email as a temporary API key
+        peer="wss://cloud.jazz.tools/?key=you@example.com"
+      >
+        {children}
+      </Jazz.Provider>
+      {authState.state !== "signedIn" && (
+        <DemoAuthBasicUI appName="Jazz Book Shelf" state={authState} />
+      )}
+    </>
+  );
+}

examples/book-shelf/src/components/Nav.tsx

@@ -0,0 +1,26 @@
+"use client";
+
+import { Button } from "@/components/Button";
+import { Container } from "@/components/Container";
+import { useAccount } from "@/components/JazzAndAuth";
+import Link from "next/link";
+
+export function Nav() {
+  const { me, logOut } = useAccount();
+
+  return (
+    <nav className="border-b py-3">
+      <Container className="flex items-center justify-between gap-12 text-sm">
+        <Link href="/" className="font-serif text-lg font-semibold">
+          Jazz Book Shelf
+        </Link>
+        <div className="flex items-center gap-4 text-sm">
+          <p>{me?.profile?.name}</p>
+          <Button variant="secondary" onClick={logOut}>
+            Log out
+          </Button>
+        </div>
+      </Container>
+    </nav>
+  );
+}

examples/book-shelf/src/components/Rating.tsx

@@ -0,0 +1,21 @@
+import StarIcon from "@/components/icons/StarIcon";
+import StarOutlineIcon from "@/components/icons/StarOutlineIcon";
+
+export default function Rating({
+  rating,
+  className = "",
+}: {
+  rating?: number;
+  className?: string;
+}) {
+  const max = 5;
+  const outline = max - (rating || 0);
+  return (
+    <div className={`inline-flex gap-0.5 text-yellow-400 ${className}`}>
+      {rating ? [...Array(rating)].map((x, i) => <StarIcon key={i} />) : <></>}
+      {[...Array(outline)].map((x, i) => (
+        <StarOutlineIcon key={i} />
+      ))}
+    </div>
+  );
+}

examples/book-shelf/src/components/RatingInput.tsx

@@ -0,0 +1,47 @@
+"use client";
+
+import StarIcon from "@/components/icons/StarIcon";
+import StarOutlineIcon from "@/components/icons/StarOutlineIcon";
+import clsx from "clsx";
+
+interface RatingInputProps {
+  value?: number;
+  onChange: (value: number) => void;
+  className?: string;
+}
+
+export default function RatingInput({
+  value = 0,
+  onChange,
+  className,
+}: RatingInputProps) {
+  const handleChange = (newRating: number) => {
+    onChange(newRating > 5 ? 5 : newRating);
+  };
+
+  return (
+    <div className={clsx(className, "flex gap-0.5 text-2xl text-yellow-400")}>
+      {[...Array(5)].map((_, i) => {
+        return i < value ? (
+          <button
+            type="button"
+            className="focus:outline-none"
+            onClick={() => handleChange(i + 1)}
+            key={i}
+          >
+            <StarIcon />
+          </button>
+        ) : (
+          <button
+            type="button"
+            className="focus:outline-none"
+            onClick={() => handleChange(i + 1)}
+            key={i}
+          >
+            <StarOutlineIcon />
+          </button>
+        );
+      })}
+    </div>
+  );
+}

examples/book-shelf/src/components/UserProfile.tsx

@@ -0,0 +1,39 @@
+"use client";
+
+import { BookReviewThumbnail } from "@/components/BookReviewThumbnail";
+import { Button } from "@/components/Button";
+import { useCoState } from "@/components/JazzAndAuth";
+import { JazzAccount, JazzProfile, ListOfBookReviews } from "@/schema";
+import { Group, ID } from "jazz-tools";
+
+export default function UserProfile({ id }: { id: ID<JazzAccount> }) {
+  const user = useCoState(JazzAccount, id);
+  const profile = useCoState(JazzProfile, user?.profile?.id);
+
+  const bookReviews = useCoState(
+    ListOfBookReviews,
+    user?.profile?._refs.bookReviews?.id,
+    [{}],
+  );
+
+  return (
+    <div className="grid gap-4">
+      <div className="flex items-center justify-between">
+        <h1 className="font-serif text-lg font-medium sm:text-2xl">
+          {profile?.name}&apos;s book shelf
+        </h1>
+        {profile?._owner.castAs(Group).myRole() === "admin" && (
+          <Button href="/add" variant="primary">
+            Add book
+          </Button>
+        )}
+      </div>
+
+      <div className="grid gap-4 md:grid-cols-4">
+        {bookReviews?.map((bookReview) => (
+          <BookReviewThumbnail key={bookReview.id} id={bookReview.id} />
+        ))}
+      </div>
+    </div>
+  );
+}

examples/book-shelf/src/components/icons/PlusIcon.tsx

@@ -0,0 +1,20 @@
+export default function PlusIcon({ className }: { className?: string }) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      fill="none"
+      viewBox="0 0 24 24"
+      strokeWidth={1.5}
+      stroke="currentColor"
+      className={className}
+      width="1em"
+      height="1em"
+    >
+      <path
+        strokeLinecap="round"
+        strokeLinejoin="round"
+        d="M12 4.5v15m7.5-7.5h-15"
+      />
+    </svg>
+  );
+}

examples/book-shelf/src/components/icons/StarIcon.tsx

@@ -0,0 +1,18 @@
+export default function StarIcon({ className }: { className?: string }) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+      fill="currentColor"
+      className={className}
+      width="1em"
+      height="1em"
+    >
+      <path
+        fillRule="evenodd"
+        d="M10.788 3.21c.448-1.077 1.976-1.077 2.424 0l2.082 5.006 5.404.434c1.164.093 1.636 1.545.749 2.305l-4.117 3.527 1.257 5.273c.271 1.136-.964 2.033-1.96 1.425L12 18.354 7.373 21.18c-.996.608-2.231-.29-1.96-1.425l1.257-5.273-4.117-3.527c-.887-.76-.415-2.212.749-2.305l5.404-.434 2.082-5.005Z"
+        clipRule="evenodd"
+      />
+    </svg>
+  );
+}

examples/book-shelf/src/components/icons/StarOutlineIcon.tsx

@@ -0,0 +1,20 @@
+export default function StarOutlineIcon({ className }: { className?: string }) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      fill="none"
+      viewBox="0 0 24 24"
+      strokeWidth={1.5}
+      stroke="currentColor"
+      className={className}
+      width="1em"
+      height="1em"
+    >
+      <path
+        strokeLinecap="round"
+        strokeLinejoin="round"
+        d="M11.48 3.499a.562.562 0 0 1 1.04 0l2.125 5.111a.563.563 0 0 0 .475.345l5.518.442c.499.04.701.663.321.988l-4.204 3.602a.563.563 0 0 0-.182.557l1.285 5.385a.562.562 0 0 1-.84.61l-4.725-2.885a.562.562 0 0 0-.586 0L6.982 20.54a.562.562 0 0 1-.84-.61l1.285-5.386a.562.562 0 0 0-.182-.557l-4.204-3.602a.562.562 0 0 1 .321-.988l5.518-.442a.563.563 0 0 0 .475-.345L11.48 3.5Z"
+      />
+    </svg>
+  );
+}

examples/book-shelf/src/schema.ts

@@ -0,0 +1,37 @@
+import {
+  Account,
+  CoList,
+  CoMap,
+  Encoders,
+  ImageDefinition,
+  Profile,
+  co,
+} from "jazz-tools";
+
+export class BookReview extends CoMap {
+  title = co.string;
+  author = co.string;
+  rating = co.number;
+  dateRead? = co.encoded(Encoders.Date);
+  review? = co.string;
+  cover? = co.ref(ImageDefinition, { optional: true });
+}
+
+export class ListOfBookReviews extends CoList.Of(co.ref(BookReview)) {}
+
+/** The profile is an app-specific per-user public `CoMap`
+ *  where you can store top-level objects for that user */
+export class JazzProfile extends Profile {
+  bookReviews = co.ref(ListOfBookReviews);
+}
+
+export class JazzAccount extends Account {
+  profile = co.ref(JazzProfile);
+
+  /** The account migration is run on account creation and on every log-in.
+   *  You can use it to set up the account root and any other initial CoValues you need.
+   */
+  migrate(this: JazzAccount, creationProps?: { name: string }) {
+    super.migrate(creationProps);
+  }
+}

examples/book-shelf/tailwind.config.ts

@@ -0,0 +1,25 @@
+import type { Config } from "tailwindcss";
+const colors = require("tailwindcss/colors");
+
+const config: Config = {
+  content: [
+    "./src/pages/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/components/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/app/**/*.{js,ts,jsx,tsx,mdx}",
+  ],
+  theme: {
+    extend: {
+      fontFamily: {
+        serif: ["var(--font-fraunces)"],
+      },
+      colors: {
+        purple: {
+          ...colors.purple,
+          950: "#211f5a",
+        },
+      },
+    },
+  },
+  plugins: [],
+};
+export default config;

examples/book-shelf/tsconfig.json

@@ -1,7 +1,8 @@
 {
   "compilerOptions": {
-    "target": "ES2017",
-    "lib": ["dom", "dom.iterable", "esnext"],
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
     "allowJs": true,
     "skipLibCheck": true,
     "strict": true,

examples/book-shelf/vercel.json

@@ -1,7 +1,7 @@
 {
   "build": {
     "env": {
-      "APP_NAME": "filestream"
+      "APP_NAME": "books-demo"
     }
   },
   "ignoreCommand": "node ../../ignore-vercel-build.js"