crazy auth refactoring

feat: in-app inspector component for react web

.changeset/healthy-pianos-rest.md

@@ -1,5 +0,0 @@
----
-"jazz-tools": patch
----
-
-Return field name on \_edits

.changeset/loud-llamas-compare.md

@@ -1,5 +0,0 @@
----
-"jazz-tools": patch
----
-
-Simplify the .create calls by accepting directly "Account | Group" as second param

.changeset/lucky-cherries-hug.md

@@ -1,5 +0,0 @@
----
-"cojson": patch
----
-
-Add a crypto entry to optionally import the crypto modules

.changeset/seven-islands-grin.md

@@ -1,7 +0,0 @@
----
-"jazz-react": minor
----
-
-Change the way the JazzProvider is created and make the hooks available as top-level imports.
-
-This is a breaking change.

.changeset/tall-zoos-smile.md

@@ -1,5 +0,0 @@
----
-"jazz-tools": patch
----
-
-Optimize the subscribe to resolve the CoValues stored in memory synchronously

.changeset/unlucky-mails-search.md

@@ -1,5 +0,0 @@
----
-"jazz-react-native": minor
----
-
-Change the way the JazzProvider is created and make the hooks available as top-level imports.

.github/workflows/build-starters.yaml

@@ -0,0 +1,52 @@
+name: Build Starters
+
+on:
+  push:
+    branches: [ "main" ]
+
+jobs:
+  build-starters:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        starter: [
+          "react-demo-auth-tailwind",
+        ]
+
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        submodules: true
+
+    - 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 install
+        pnpm turbo build;
+      working-directory: ./starters/${{ matrix.starter }}

.github/workflows/playwright.yml

@@ -13,7 +13,7 @@ jobs:
     continue-on-error: true
     strategy:
       matrix:
-        project: ["tests/e2e", "examples/chat", "examples/file-share-svelte", "examples/form", "examples/music-player", "examples/pets", "examples/onboarding"]
+        project: ["tests/e2e", "examples/chat", "examples/file-share-svelte", "examples/form", "examples/music-player", "examples/pets", "examples/onboarding", "starters/react-demo-auth-tailwind"]
 
     steps:
       - uses: actions/checkout@v3

examples/book-shelf/.gitignore

@@ -1,36 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-.yarn/install-state.gz
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# local env files
-.env*.local
-
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts

examples/book-shelf/CHANGELOG.md

@@ -1,323 +0,0 @@
-# jazz-example-book-shelf
-
-## 0.1.38
-
-### Patch Changes
-
-- jazz-react@0.8.50
-- jazz-tools@0.8.50
-- jazz-browser-media-images@0.8.50
-
-## 0.1.37
-
-### Patch Changes
-
-- jazz-react@0.8.49
-- jazz-tools@0.8.49
-- jazz-browser-media-images@0.8.49
-
-## 0.1.36
-
-### Patch Changes
-
-- Updated dependencies [635e824]
-- Updated dependencies [0a85982]
-  - jazz-tools@0.8.48
-  - jazz-browser-media-images@0.8.48
-  - jazz-react@0.8.48
-
-## 0.1.35
-
-### Patch Changes
-
-- Updated dependencies [fa41f8e]
-- Updated dependencies [88d7d9a]
-- Updated dependencies [60e35ea]
-  - jazz-tools@0.8.45
-  - jazz-react@0.8.45
-  - jazz-browser-media-images@0.8.45
-
-## 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

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

@@ -1,41 +0,0 @@
-# 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 `<JazzProvider>` provider component in [./src/components/JazzAndAuth.tsx](./src/components/JazzAndAuth.tsx).

examples/book-shelf/job-template.nomad

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

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

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

examples/book-shelf/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "jazz-example-book-shelf",
-  "version": "0.1.38",
-  "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.50",
-    "jazz-react": "workspace:0.8.50",
-    "jazz-tools": "workspace:0.8.50",
-    "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.15",
-    "typescript": "~5.6.2"
-  }
-}

examples/book-shelf/postcss.config.mjs

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

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

@@ -1,139 +0,0 @@
-"use client";
-
-import { Button } from "@/components/Button";
-import { Container } from "@/components/Container";
-import RatingInput from "@/components/RatingInput";
-import { BookReview, ListOfBookReviews } from "@/schema";
-import { createImage } from "jazz-browser-media-images";
-import { useAccount } from "jazz-react";
-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

@@ -1,172 +0,0 @@
-"use client";
-
-import { BookCover } from "@/components/BookCover";
-import { Container } from "@/components/Container";
-import Rating from "@/components/Rating";
-import RatingInput from "@/components/RatingInput";
-import { BookReview } from "@/schema";
-import clsx from "clsx";
-import { useCoState } from "jazz-react";
-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

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

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

@@ -1,27 +0,0 @@
-"use client";
-
-import { Container } from "@/components/Container";
-import UserProfile from "@/components/UserProfile";
-import { JazzAccount } from "@/schema";
-import { useAccount } from "jazz-react";
-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

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

@@ -1,133 +0,0 @@
-import { Button } from "@/components/Button";
-import PlusIcon from "@/components/icons/PlusIcon";
-import { BookReview } from "@/schema";
-import clsx from "clsx";
-import { createImage } from "jazz-browser-media-images";
-import { useAccount } from "jazz-react";
-import { ProgressiveImg } from "jazz-react";
-import { ChangeEvent, useRef } 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

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

@@ -1,35 +0,0 @@
-"use client";
-
-import { BookCoverReadOnly } from "@/components/BookCover";
-import StarIcon from "@/components/icons/StarIcon";
-import { useCoState } from "jazz-react";
-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

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

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

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

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

@@ -1,26 +0,0 @@
-"use client";
-
-import { Button } from "@/components/Button";
-import { Container } from "@/components/Container";
-import { useAccount } from "jazz-react";
-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

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

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

@@ -1,39 +0,0 @@
-"use client";
-
-import { BookReviewThumbnail } from "@/components/BookReviewThumbnail";
-import { Button } from "@/components/Button";
-import { JazzAccount, JazzProfile, ListOfBookReviews } from "@/schema";
-import { useCoState } from "jazz-react";
-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/StarIcon.tsx

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

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

@@ -1,35 +0,0 @@
-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() {}
-}

examples/book-shelf/tailwind.config.ts

@@ -1,25 +0,0 @@
-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/chat-rn-clerk/CHANGELOG.md

@@ -1,5 +1,109 @@
 # chat-rn-clerk
 
+## 1.0.51
+
+### Patch Changes
+
+- f76274c: Fix image handling in react-native
+- Updated dependencies [f76274c]
+- Updated dependencies [5e83864]
+  - jazz-react-native@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-react-native-auth-clerk@0.9.10
+  - jazz-react-native-media-images@0.9.10
+
+## 1.0.50
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react-native@0.9.9
+  - jazz-react-native-auth-clerk@0.9.9
+  - jazz-react-native-media-images@0.9.9
+
+## 1.0.49
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react-native@0.9.8
+  - jazz-react-native-auth-clerk@0.9.8
+  - jazz-react-native-media-images@0.9.8
+
+## 1.0.48
+
+### Patch Changes
+
+- Updated dependencies [8a390d2]
+  - jazz-react-native@0.9.6
+  - jazz-react-native-auth-clerk@0.9.6
+
+## 1.0.47
+
+### Patch Changes
+
+- Updated dependencies [c871912]
+  - jazz-react-native@0.9.5
+  - jazz-react-native-auth-clerk@0.9.5
+
+## 1.0.46
+
+### Patch Changes
+
+- jazz-react-native@0.9.4
+- jazz-react-native-auth-clerk@0.9.4
+
+## 1.0.45
+
+### Patch Changes
+
+- Updated dependencies [7cd691f]
+  - jazz-react-native@0.9.3
+  - jazz-react-native-auth-clerk@0.9.3
+
+## 1.0.44
+
+### Patch Changes
+
+- Updated dependencies [80fd3e9]
+  - jazz-react-native@0.9.2
+  - jazz-react-native-auth-clerk@0.9.2
+
+## 1.0.43
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-tools@0.9.1
+  - jazz-react-native@0.9.1
+  - jazz-react-native-auth-clerk@0.9.1
+  - jazz-react-native-media-images@0.9.1
+
+## 1.0.42
+
+### Patch Changes
+
+- Updated dependencies [1da4d55]
+- Updated dependencies [8eda792]
+- Updated dependencies [1e5e3a1]
+  - jazz-react-native@0.9.0
+  - jazz-tools@0.9.0
+  - jazz-react-native-auth-clerk@0.9.0
+  - jazz-react-native-media-images@0.9.0
+
+## 1.0.41
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-react-native@0.8.51
+  - jazz-react-native-auth-clerk@0.8.51
+  - jazz-react-native-media-images@0.8.51
+
 ## 1.0.40
 
 ### Patch Changes

examples/chat-rn-clerk/app.json

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

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

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

examples/chat-rn-clerk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chat-rn-clerk",
   "main": "index.js",
-  "version": "1.0.40",
+  "version": "1.0.51",
   "scripts": {
     "build": "expo export -p ios",
     "start": "expo start",
@@ -20,6 +20,7 @@
     "@bam.tech/react-native-image-resizer": "^3.0.11",
     "@clerk/clerk-expo": "^2.2.21",
     "@expo/vector-icons": "^14.0.2",
+    "@op-engineering/op-sqlite": "^11.2.12",
     "@react-native-community/netinfo": "^11.4.1",
     "@react-navigation/native": "^7.0.13",
     "@react-navigation/native-stack": "^7.1.14",
@@ -34,6 +35,7 @@
     "expo-dev-client": "~5.0.5",
     "expo-file-system": "^18.0.4",
     "expo-font": "~13.0.1",
+    "expo-image-picker": "~16.0.4",
     "expo-linking": "~7.0.3",
     "expo-router": "~4.0.11",
     "expo-secure-store": "~14.0.0",

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

@@ -50,6 +50,7 @@ export function JazzAndAuth({ children }: PropsWithChildren) {
       {auth && clerk.user ? (
         <JazzProvider
           auth={auth}
+          storage="sqlite"
           peer="wss://cloud.jazz.tools/?key=chat-rn-clerk-example-jazz@garden.co"
         >
           {children}

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

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

examples/chat-rn/CHANGELOG.md

@@ -1,5 +1,91 @@
 # chat-rn
 
+## 1.0.48
+
+### Patch Changes
+
+- Updated dependencies [f76274c]
+- Updated dependencies [5e83864]
+  - jazz-react-native@0.9.10
+  - jazz-tools@0.9.10
+
+## 1.0.47
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react-native@0.9.9
+
+## 1.0.46
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react-native@0.9.8
+
+## 1.0.45
+
+### Patch Changes
+
+- Updated dependencies [8a390d2]
+  - jazz-react-native@0.9.6
+
+## 1.0.44
+
+### Patch Changes
+
+- Updated dependencies [c871912]
+  - jazz-react-native@0.9.5
+
+## 1.0.43
+
+### Patch Changes
+
+- jazz-react-native@0.9.4
+
+## 1.0.42
+
+### Patch Changes
+
+- Updated dependencies [7cd691f]
+  - jazz-react-native@0.9.3
+
+## 1.0.41
+
+### Patch Changes
+
+- Updated dependencies [80fd3e9]
+  - jazz-react-native@0.9.2
+
+## 1.0.40
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-tools@0.9.1
+  - jazz-react-native@0.9.1
+
+## 1.0.39
+
+### Patch Changes
+
+- Updated dependencies [1da4d55]
+- Updated dependencies [8eda792]
+- Updated dependencies [1e5e3a1]
+  - jazz-react-native@0.9.0
+  - jazz-tools@0.9.0
+
+## 1.0.38
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-react-native@0.8.51
+
 ## 1.0.37
 
 ### Patch Changes

examples/chat-rn/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-rn",
-  "version": "1.0.37",
+  "version": "1.0.48",
   "main": "index.js",
   "scripts": {
     "build": "expo export -p ios",
@@ -13,6 +13,7 @@
   },
   "dependencies": {
     "@azure/core-asynciterator-polyfill": "^1.0.2",
+    "@op-engineering/op-sqlite": "^11.2.12",
     "@react-native-community/netinfo": "^11.4.1",
     "@react-navigation/native": "^7.0.13",
     "@react-navigation/native-stack": "^7.1.14",

examples/chat-rn/src/App.tsx

@@ -33,7 +33,6 @@ function App() {
     "ChatScreen" | "HandleInviteScreen"
   >("ChatScreen");
   const navigationRef = useNavigationContainerRef();
-
   useEffect(() => {
     Linking.getInitialURL().then((url) => {
       if (url) {
@@ -52,6 +51,7 @@ function App() {
     <StrictMode>
       <JazzProvider
         auth={auth}
+        storage="sqlite"
         peer="wss://cloud.jazz.tools/?key=chat-rn-example-jazz@garden.co"
       >
         <NavigationContainer linking={linking} ref={navigationRef}>

examples/chat-rn/src/chat.tsx

@@ -19,45 +19,35 @@ import { Chat, Message } from "./schema";
 
 export default function ChatScreen({ navigation }: { navigation: any }) {
   const { me, logOut } = useAccount();
-  const [chat, setChat] = useState<Chat>();
+  const [chatId, setChatId] = useState<ID<Chat>>();
+  const loadedChat = useCoState(Chat, chatId, [{}]);
   const [message, setMessage] = useState("");
-  const loadedChat = useCoState(Chat, chat?.id, [{}]);
 
   useEffect(() => {
     navigation.setOptions({
       headerRight: () => <Button onPress={logOut} title="Logout" />,
       headerLeft: () =>
-        chat ? (
+        loadedChat ? (
           <Button
             onPress={() => {
-              if (chat?.id) {
+              if (loadedChat?.id) {
                 Clipboard.setStringAsync(
-                  `https://chat.jazz.tools/#/chat/${chat.id}`,
+                  `https://chat.jazz.tools/#/chat/${loadedChat.id}`,
                 );
-                Alert.alert("Copied to clipboard", `Chat ID: ${chat.id}`);
+                Alert.alert("Copied to clipboard", `Chat ID: ${loadedChat.id}`);
               }
             }}
             title="Share"
           />
         ) : null,
     });
-  }, [navigation, chat]);
+  }, [navigation, loadedChat]);
 
   const createChat = () => {
     const group = Group.create({ owner: me });
     group.addMember("everyone", "writer");
     const chat = Chat.create([], { owner: group });
-    setChat(chat);
-  };
-
-  const loadChat = async (chatId: ID<Chat>) => {
-    try {
-      const chat = await Chat.load(chatId, me, []);
-      setChat(chat);
-    } catch (error) {
-      console.log("Error loading chat", error);
-      Alert.alert("Error", `Error loading chat: ${error}`);
-    }
+    setChatId(chat.id);
   };
 
   const joinChat = () => {
@@ -73,7 +63,7 @@ export default function ChatScreen({ navigation }: { navigation: any }) {
           text: "Join",
           onPress: (chatId) => {
             if (chatId) {
-              loadChat(chatId as ID<Chat>);
+              setChatId(chatId as ID<Chat>);
             } else {
               Alert.alert("Error", "Chat ID cannot be empty.");
             }
@@ -85,9 +75,11 @@ export default function ChatScreen({ navigation }: { navigation: any }) {
   };
 
   const sendMessage = () => {
-    if (!chat) return;
+    if (!loadedChat) return;
     if (message.trim()) {
-      chat.push(Message.create({ text: message }, { owner: chat._owner }));
+      loadedChat.push(
+        Message.create({ text: message }, { owner: loadedChat?._owner }),
+      );
       setMessage("");
     }
   };
@@ -137,7 +129,7 @@ export default function ChatScreen({ navigation }: { navigation: any }) {
 
   return (
     <View className="flex flex-col h-full">
-      {!chat ? (
+      {!loadedChat ? (
         <View className="flex flex-col h-full items-center justify-center">
           <TouchableOpacity
             onPress={createChat}

examples/chat-vue/CHANGELOG.md

@@ -1,5 +1,62 @@
 # chat-vue
 
+## 0.0.35
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-tools@0.9.10
+  - jazz-browser@0.9.10
+  - jazz-vue@0.9.10
+
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser@0.9.9
+  - jazz-vue@0.9.9
+
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-browser@0.9.8
+  - jazz-vue@0.9.8
+
+## 0.0.32
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+- Updated dependencies [5d98189]
+  - jazz-browser@0.9.1
+  - jazz-tools@0.9.1
+  - jazz-vue@0.9.1
+
+## 0.0.31
+
+### Patch Changes
+
+- Updated dependencies [9dd8d95]
+- Updated dependencies [8eda792]
+  - jazz-vue@0.9.0
+  - jazz-tools@0.9.0
+  - jazz-browser@0.9.0
+
+## 0.0.30
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-browser@0.8.51
+  - jazz-vue@0.8.51
+
 ## 0.0.29
 
 ### Patch Changes

examples/chat-vue/README.md

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

examples/chat-vue/package.json

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

examples/chat-vue/src/App.vue

@@ -9,9 +9,9 @@
 </template>
 
 <script setup lang="ts">
+import { useAccount } from "jazz-vue";
 import AppContainer from "./components/AppContainer.vue";
 import TopBar from "./components/TopBar.vue";
-import { useAccount } from "./main";
 
 const { me, logOut } = useAccount();
 </script>

examples/chat-vue/src/main.ts

@@ -1,13 +1,9 @@
-import { DemoAuthBasicUI, createJazzVueApp, useDemoAuth } from "jazz-vue";
+import { DemoAuthBasicUI, JazzProvider, useDemoAuth } from "jazz-vue";
 import { createApp, defineComponent, h } from "vue";
 import App from "./App.vue";
 import "./index.css";
 import router from "./router";
 
-const Jazz = createJazzVueApp();
-export const { useAccount, useCoState } = Jazz;
-const { JazzProvider } = Jazz;
-
 const RootComponent = defineComponent({
   name: "RootComponent",
   setup() {

examples/chat-vue/src/views/ChatView.vue

@@ -26,12 +26,12 @@
 
 <script lang="ts">
 import type { ID } from "jazz-tools";
+import { useCoState } from "jazz-vue";
 import { type PropType, computed, defineComponent, ref } from "vue";
 import ChatBody from "../components/ChatBody.vue";
 import ChatBubble from "../components/ChatBubble.vue";
 import ChatInput from "../components/ChatInput.vue";
 import EmptyChatMessage from "../components/EmptyChatMessage.vue";
-import { useCoState } from "../main";
 import { Chat, Message } from "../schema";
 
 export default defineComponent({

examples/chat-vue/src/views/HomeView.vue

@@ -4,8 +4,8 @@
   
   <script setup lang="ts">
 import { Group } from "jazz-tools";
+import { useAccount } from "jazz-vue";
 import { useRouter } from "vue-router";
-import { useAccount } from "../main";
 import { Chat } from "../schema";
 
 const router = useRouter();

examples/chat/CHANGELOG.md

@@ -1,5 +1,68 @@
 # jazz-example-chat
 
+## 0.0.131
+
+### Patch Changes
+
+- f76274c: Fix image handling in react-native
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.130
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
+## 0.0.129
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react@0.9.8
+  - jazz-browser-media-images@0.9.8
+
+## 0.0.128
+
+### Patch Changes
+
+- jazz-react@0.9.4
+
+## 0.0.127
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-react@0.9.1
+  - jazz-tools@0.9.1
+  - jazz-browser-media-images@0.9.1
+
+## 0.0.126
+
+### Patch Changes
+
+- Updated dependencies [956a4d1]
+- Updated dependencies [8eda792]
+  - jazz-react@0.9.0
+  - jazz-tools@0.9.0
+  - jazz-browser-media-images@0.9.0
+
+## 0.0.125
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-browser-media-images@0.8.51
+  - jazz-react@0.8.51
+
 ## 0.0.124
 
 ### Patch Changes

examples/chat/README.md

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

examples/chat/package.json

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

examples/chat/src/app.tsx

@@ -16,9 +16,9 @@ export function App() {
 
   const createChat = () => {
     if (!me) return;
-    const group = Group.create({ owner: me });
+    const group = Group.create();
     group.addMember("everyone", "writer");
-    const chat = Chat.create([], { owner: group });
+    const chat = Chat.create([], group);
     router.navigate("/#/chat/" + chat.id);
 
     // for https://jazz.tools marketing site demo only

examples/chat/src/chatScreen.tsx

@@ -1,5 +1,5 @@
 import { createImage } from "jazz-browser-media-images";
-import { useAccount, useCoState } from "jazz-react";
+import { useCoState } from "jazz-react";
 import { ID } from "jazz-tools";
 import { useState } from "react";
 import { Chat, Message } from "./schema.ts";
@@ -18,7 +18,6 @@ import {
 
 export function ChatScreen(props: { chatID: ID<Chat> }) {
   const chat = useCoState(Chat, props.chatID, [{}]);
-  const { me } = useAccount();
   const [showNLastMessages, setShowNLastMessages] = useState(30);
 
   if (!chat)
@@ -27,8 +26,6 @@ export function ChatScreen(props: { chatID: ID<Chat> }) {
     );
 
   const sendImage = (event: React.ChangeEvent<HTMLInputElement>) => {
-    if (!me?.profile) return;
-
     const file = event.currentTarget.files?.[0];
 
     if (!file) return;
@@ -39,12 +36,7 @@ export function ChatScreen(props: { chatID: ID<Chat> }) {
     }
 
     createImage(file, { owner: chat._owner }).then((image) => {
-      chat.push(
-        Message.create(
-          { text: file.name, image: image },
-          { owner: chat._owner },
-        ),
-      );
+      chat.push(Message.create({ text: file.name, image: image }, chat._owner));
     });
   };
 

examples/clerk/CHANGELOG.md

@@ -1,5 +1,68 @@
 # minimal-auth-clerk
 
+## 0.0.30
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-react-auth-clerk@0.9.10
+
+## 0.0.29
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+  - jazz-react-auth-clerk@0.9.9
+
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react@0.9.8
+  - jazz-react-auth-clerk@0.9.8
+
+## 0.0.27
+
+### Patch Changes
+
+- jazz-react@0.9.4
+- jazz-react-auth-clerk@0.9.4
+
+## 0.0.26
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-react@0.9.1
+  - jazz-tools@0.9.1
+  - jazz-react-auth-clerk@0.9.1
+
+## 0.0.25
+
+### Patch Changes
+
+- Updated dependencies [956a4d1]
+- Updated dependencies [8eda792]
+  - jazz-react@0.9.0
+  - jazz-tools@0.9.0
+  - jazz-react-auth-clerk@0.9.0
+
+## 0.0.24
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-react@0.8.51
+  - jazz-react-auth-clerk@0.8.51
+
 ## 0.0.23
 
 ### Patch Changes

examples/clerk/README.md

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

examples/clerk/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clerk",
   "private": true,
-  "version": "0.0.23",
+  "version": "0.0.30",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -13,7 +13,7 @@
   "dependencies": {
     "@clerk/clerk-react": "^5.4.1",
     "jazz-react": "workspace:*",
-    "jazz-react-auth-clerk": "workspace:0.8.50",
+    "jazz-react-auth-clerk": "workspace:0.9.10",
     "jazz-tools": "workspace:*",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"

examples/file-share-svelte/CHANGELOG.md

@@ -1,5 +1,55 @@
 # file-share-svelte
 
+## 0.0.15
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-tools@0.9.10
+  - jazz-svelte@0.9.10
+
+## 0.0.14
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-svelte@0.9.9
+
+## 0.0.13
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-svelte@0.9.8
+
+## 0.0.12
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-tools@0.9.1
+  - jazz-svelte@0.9.1
+
+## 0.0.11
+
+### Patch Changes
+
+- Updated dependencies [9dd8d95]
+- Updated dependencies [8eda792]
+  - jazz-svelte@0.9.0
+  - jazz-tools@0.9.0
+
+## 0.0.10
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-svelte@0.8.51
+
 ## 0.0.9
 
 ### Patch Changes

examples/file-share-svelte/package.json

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

examples/file-share-svelte/src/lib/components/FileItem.svelte

@@ -3,7 +3,7 @@
   import { SharedFile } from '$lib/schema';
   import { FileStream } from 'jazz-tools';
   import { File, FileDown, Trash2, Link2 } from 'lucide-svelte';
-  import { useAccount } from '$lib/jazz';
+  import { useAccount } from 'jazz-svelte';
   import { toast } from 'svelte-sonner';
   import { formatFileSize } from '$lib/utils';
 

examples/file-share-svelte/src/lib/jazz.ts

@@ -1,7 +0,0 @@
-import { createJazzApp } from 'jazz-svelte';
-import { FileShareAccount } from './schema';
-
-export const { useAccount, useCoState, useAcceptInvite, useAccountOrGuest, Provider } =
-  createJazzApp({
-    AccountSchema: FileShareAccount
-  });

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

@@ -1,8 +1,17 @@
+<script lang="ts" module>
+  declare module 'jazz-svelte' {
+    interface Register {
+      Account: FileShareAccount;
+    }
+  }
+</script>
+
 <script lang="ts">
-  import { Provider } from '$lib/jazz';
+  import { JazzProvider } from 'jazz-svelte';
   import { PasskeyAuthBasicUI, usePasskeyAuth } from 'jazz-svelte';
   import { Toaster } from 'svelte-sonner';
   import '../app.css';
+  import { FileShareAccount } from '$lib/schema';
 
   let { children } = $props();
   const auth = usePasskeyAuth({
@@ -24,9 +33,13 @@
   </div>
 {/if}
 {#if auth.current}
-  <Provider auth={auth.current} peer="wss://cloud.jazz.tools/?key=file-share-svelte@garden.co">
+  <JazzProvider
+    AccountSchema={FileShareAccount}
+    auth={auth.current}
+    peer="wss://cloud.jazz.tools/?key=file-share-svelte@garden.co"
+  >
     <div class="min-h-screen bg-gray-100">
       {@render children()}
     </div>
-  </Provider>
+  </JazzProvider>
 {/if}

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

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { useAccount, useCoState } from '$lib/jazz';
+  import { useAccount, useCoState } from 'jazz-svelte';
   import { SharedFile, ListOfSharedFiles } from '$lib/schema';
   import { createInviteLink } from 'jazz-svelte';
   import { FileStream } from 'jazz-tools';

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

@@ -1,6 +1,6 @@
 <script lang="ts">
   import { page } from '$app/stores';
-  import { useAccount, useCoState } from '$lib/jazz';
+  import { useAccount, useCoState } from 'jazz-svelte';
   import { SharedFile } from '$lib/schema';
   import { File, FileDown, Link2 } from 'lucide-svelte';
   import type { ID } from 'jazz-tools';

examples/form/CHANGELOG.md

@@ -1,5 +1,67 @@
 # form
 
+## 0.0.26
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.25
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
+## 0.0.24
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react@0.9.8
+  - jazz-browser-media-images@0.9.8
+
+## 0.0.23
+
+### Patch Changes
+
+- jazz-react@0.9.4
+
+## 0.0.22
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-react@0.9.1
+  - jazz-tools@0.9.1
+  - jazz-browser-media-images@0.9.1
+
+## 0.0.21
+
+### Patch Changes
+
+- Updated dependencies [956a4d1]
+- Updated dependencies [8eda792]
+  - jazz-react@0.9.0
+  - jazz-tools@0.9.0
+  - jazz-browser-media-images@0.9.0
+
+## 0.0.20
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-browser-media-images@0.8.51
+  - jazz-react@0.8.51
+
 ## 0.0.19
 
 ### Patch Changes

examples/form/README.md

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

examples/form/package.json

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

examples/form/src/CreateOrder.tsx

@@ -30,12 +30,9 @@ export function CreateOrder() {
     me.root.orders.push(draft as BubbleTeaOrder);
 
     // reset the draft
-    me.root.draft = DraftBubbleTeaOrder.create(
-      {
-        addOns: ListOfBubbleTeaAddOns.create([], me),
-      },
-      me,
-    );
+    me.root.draft = DraftBubbleTeaOrder.create({
+      addOns: ListOfBubbleTeaAddOns.create([]),
+    });
 
     router.navigate("/");
   };

examples/image-upload/CHANGELOG.md

@@ -1,5 +1,67 @@
 # image-upload
 
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+  - jazz-browser-media-images@0.9.10
+
+## 0.0.27
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-browser-media-images@0.9.9
+  - jazz-react@0.9.9
+
+## 0.0.26
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react@0.9.8
+  - jazz-browser-media-images@0.9.8
+
+## 0.0.25
+
+### Patch Changes
+
+- jazz-react@0.9.4
+
+## 0.0.24
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-react@0.9.1
+  - jazz-tools@0.9.1
+  - jazz-browser-media-images@0.9.1
+
+## 0.0.23
+
+### Patch Changes
+
+- Updated dependencies [956a4d1]
+- Updated dependencies [8eda792]
+  - jazz-react@0.9.0
+  - jazz-tools@0.9.0
+  - jazz-browser-media-images@0.9.0
+
+## 0.0.22
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-browser-media-images@0.8.51
+  - jazz-react@0.8.51
+
 ## 0.0.21
 
 ### Patch Changes

examples/image-upload/README.md

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

examples/image-upload/package.json

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

examples/inspector/CHANGELOG.md

@@ -1,5 +1,30 @@
 # jazz-example-inspector
 
+## 0.0.95
+
+### Patch Changes
+
+- Updated dependencies [4aa377d]
+  - cojson@0.9.10
+  - cojson-transport-ws@0.9.10
+
+## 0.0.94
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - cojson@0.9.9
+  - cojson-transport-ws@0.9.9
+
+## 0.0.93
+
+### Patch Changes
+
+- Updated dependencies [8eda792]
+- Updated dependencies [1ef3226]
+  - cojson@0.9.0
+  - cojson-transport-ws@0.9.0
+
 ## 0.0.92
 
 ### Patch Changes

examples/inspector/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "jazz-inspector",
+  "name": "jazz-inspector-app",
   "private": true,
-  "version": "0.0.92",
+  "version": "0.0.95",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -16,8 +16,8 @@
     "@radix-ui/react-toast": "^1.1.4",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",
-    "cojson": "workspace:0.8.50",
-    "cojson-transport-ws": "workspace:0.8.50",
+    "cojson": "workspace:0.9.10",
+    "cojson-transport-ws": "workspace:0.9.10",
     "hash-slash": "workspace:0.2.1",
     "lucide-react": "^0.274.0",
     "qrcode": "^1.5.3",

examples/music-player/CHANGELOG.md

@@ -1,5 +1,61 @@
 # jazz-example-musicplayer
 
+## 0.0.51
+
+### Patch Changes
+
+- Updated dependencies [5e83864]
+  - jazz-react@0.9.10
+  - jazz-tools@0.9.10
+
+## 0.0.50
+
+### Patch Changes
+
+- Updated dependencies [8eb9247]
+  - jazz-tools@0.9.9
+  - jazz-react@0.9.9
+
+## 0.0.49
+
+### Patch Changes
+
+- Updated dependencies [d1d773b]
+  - jazz-tools@0.9.8
+  - jazz-react@0.9.8
+
+## 0.0.48
+
+### Patch Changes
+
+- jazz-react@0.9.4
+
+## 0.0.47
+
+### Patch Changes
+
+- Updated dependencies [1b71969]
+  - jazz-react@0.9.1
+  - jazz-tools@0.9.1
+
+## 0.0.46
+
+### Patch Changes
+
+- Updated dependencies [956a4d1]
+- Updated dependencies [8eda792]
+  - jazz-react@0.9.0
+  - jazz-tools@0.9.0
+
+## 0.0.45
+
+### Patch Changes
+
+- Updated dependencies [dc62b95]
+- Updated dependencies [1de26f8]
+  - jazz-tools@0.8.51
+  - jazz-react@0.8.51
+
 ## 0.0.44
 
 ### Patch Changes

examples/music-player/README.md

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

examples/music-player/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jazz-example-music-player",
   "private": true,
-  "version": "0.0.44",
+  "version": "0.0.51",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -13,13 +13,17 @@
     "test:ui": "playwright test --ui"
   },
   "dependencies": {
+    "@radix-ui/react-dialog": "^1.1.4",
     "@radix-ui/react-dropdown-menu": "^2.1.1",
-    "@radix-ui/react-slot": "^1.0.2",
+    "@radix-ui/react-label": "^2.1.1",
+    "@radix-ui/react-slot": "^1.1.1",
     "@radix-ui/react-toast": "^1.1.4",
+    "@radix-ui/react-tooltip": "^1.1.6",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.0.0",
-    "jazz-react": "workspace:0.8.50",
-    "jazz-tools": "workspace:0.8.50",
+    "jazz-react": "workspace:0.9.10",
+    "jazz-tools": "workspace:0.9.10",
+    "jazz-inspector": "workspace:*",
     "lucide-react": "^0.274.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",

examples/music-player/src/1_schema.ts

@@ -85,7 +85,7 @@ export class MusicaAccount extends Account {
    *  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() {
+  migrate(this: MusicaAccount) {
     if (!this._refs.root) {
       const ownership = { owner: this };
 

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

@@ -1,4 +1,5 @@
 import { Toaster } from "@/components/ui/toaster";
+import { JazzInspector } from "jazz-inspector";
 /* eslint-disable react-refresh/only-export-components */
 import React from "react";
 import ReactDOM from "react-dom/client";
@@ -10,7 +11,7 @@ import { PlayerControls } from "./components/PlayerControls";
 import "./index.css";
 
 import { MusicaAccount } from "@/1_schema";
-import { DemoAuthBasicUI, JazzProvider, useDemoAuth } from "jazz-react";
+import { JazzProvider, useIsAnonymousUser } from "jazz-react";
 import { useUploadExampleData } from "./lib/useUploadExampleData";
 
 /**
@@ -54,26 +55,24 @@ function Main() {
 }
 
 function JazzAndAuth({ children }: { children: React.ReactNode }) {
-  const [auth, state] = useDemoAuth();
-
   const peer =
     (new URL(window.location.href).searchParams.get(
       "peer",
     ) as `ws://${string}`) ??
     "wss://cloud.jazz.tools/?key=music-player-example-jazz@garden.co";
 
+  const isAnonymous = useIsAnonymousUser();
+
   return (
-    <>
-      <JazzProvider
-        storage={["singleTabOPFS", "indexedDB"]}
-        auth={auth}
-        peer={peer}
-        AccountSchema={MusicaAccount}
-      >
-        {children}
-      </JazzProvider>
-      <DemoAuthBasicUI appName="Jazz Music Player" state={state} />
-    </>
+    <JazzProvider
+      storage="indexedDB"
+      peer={peer}
+      localOnly={isAnonymous}
+      AccountSchema={MusicaAccount}
+    >
+      {children}
+      <JazzInspector />
+    </JazzProvider>
   );
 }
 

examples/music-player/src/3_HomePage.tsx

@@ -1,12 +1,17 @@
 import { useToast } from "@/hooks/use-toast";
-import { createInviteLink, useAccount, useCoState } from "jazz-react";
+import {
+  createInviteLink,
+  useAccount,
+  useCoState,
+  useIsAnonymousUser,
+} from "jazz-react";
 import { ID } from "jazz-tools";
 import { useNavigate, useParams } from "react-router";
 import { Playlist } from "./1_schema";
 import { createNewPlaylist, uploadMusicTracks } from "./4_actions";
 import { MediaPlayer } from "./5_useMediaPlayer";
+import { AuthButton } from "./components/AuthButton";
 import { FileUploadButton } from "./components/FileUploadButton";
-import { LogoutButton } from "./components/LogoutButton";
 import { MusicTrackRow } from "./components/MusicTrackRow";
 import { PlaylistTitleInput } from "./components/PlaylistTitleInput";
 import { SidePanel } from "./components/SidePanel";
@@ -31,19 +36,15 @@ export function HomePage({ mediaPlayer }: { mediaPlayer: MediaPlayer }) {
   const { toast } = useToast();
 
   async function handleFileLoad(files: FileList) {
-    if (!me) return;
-
     /**
      * Follow this function definition to see how we update
      * values in Jazz and manage files!
      */
-    await uploadMusicTracks(me, files);
+    await uploadMusicTracks(files);
   }
 
   async function handleCreatePlaylist() {
-    if (!me) return;
-
-    const playlist = await createNewPlaylist(me);
+    const playlist = await createNewPlaylist();
 
     navigate(`/playlist/${playlist.id}`);
   }
@@ -70,6 +71,8 @@ export function HomePage({ mediaPlayer }: { mediaPlayer: MediaPlayer }) {
     });
   };
 
+  const isAnonymousUser = useIsAnonymousUser();
+
   return (
     <div className="flex flex-col h-screen text-gray-800 bg-blue-50">
       <div className="flex flex-1 overflow-hidden">
@@ -90,12 +93,12 @@ export function HomePage({ mediaPlayer }: { mediaPlayer: MediaPlayer }) {
                   <Button onClick={handleCreatePlaylist}>New playlist</Button>
                 </>
               )}
-              {!isRootPlaylist && (
+              {!isRootPlaylist && !isAnonymousUser && (
                 <Button onClick={handlePlaylistShareClick}>
                   Share playlist
                 </Button>
               )}
-              <LogoutButton />
+              <AuthButton />
             </div>
           </div>
           <ul className="flex flex-col">

examples/music-player/src/4_actions.ts

@@ -22,14 +22,22 @@ import {
  * pattern that best fits your app.
  */
 
-export async function uploadMusicTracks(
-  account: MusicaAccount,
-  files: Iterable<File>,
-) {
+export async function uploadMusicTracks(files: Iterable<File>) {
+  const me = await MusicaAccount.getMe().ensureLoaded({
+    root: {
+      rootPlaylist: {
+        tracks: [],
+      },
+      playlists: [],
+    },
+  });
+
+  if (!me) return;
+
   for (const file of files) {
     // The ownership object defines the user that owns the created coValues
     // We are creating a group for each CoValue in order to be able to share them via Playlist
-    const group = Group.create(account);
+    const group = Group.create();
 
     const data = await getAudioFileData(file);
 
@@ -50,15 +58,23 @@ export async function uploadMusicTracks(
 
     // The newly created musicTrack can be associated to the
     // user track list using a simple push call
-    account.root?.rootPlaylist?.tracks?.push(musicTrack);
+    me.root.rootPlaylist.tracks.push(musicTrack);
   }
 }
 
-export async function createNewPlaylist(account: MusicaAccount) {
+export async function createNewPlaylist() {
+  const me = await MusicaAccount.getMe().ensureLoaded({
+    root: {
+      playlists: [],
+    },
+  });
+
+  if (!me) throw new Error("Current playlist not resolved");
+
   // Since playlists are meant to be shared we associate them
   // to a group which will contain the keys required to get
   // access to the "owned" values
-  const playlistGroup = Group.create(account);
+  const playlistGroup = Group.create();
 
   const playlist = Playlist.create(
     {
@@ -70,7 +86,7 @@ export async function createNewPlaylist(account: MusicaAccount) {
 
   // Again, we associate the new playlist to the
   // user by pushing it into the playlists CoList
-  account.root?.playlists?.push(playlist);
+  me.root.playlists.push(playlist);
 
   return playlist;
 }
@@ -78,10 +94,7 @@ export async function createNewPlaylist(account: MusicaAccount) {
 export async function addTrackToPlaylist(
   playlist: Playlist,
   track: MusicTrack,
-  account: MusicaAccount | undefined,
 ) {
-  if (!account) return;
-
   const alreadyAdded = playlist.tracks?.some(
     (t) => t?.id === track.id || t?._refs.sourceTrack?.id === track.id,
   );
@@ -108,12 +121,8 @@ export async function addTrackToPlaylist(
    *
    * Doing this for backwards compatibility for when the Group inheritance wasn't possible
    */
-  const blob = await FileStream.loadAsBlob(track._refs.file.id, account);
-  const waveform = await MusicTrackWaveform.load(
-    track._refs.waveform.id,
-    account,
-    {},
-  );
+  const blob = await FileStream.loadAsBlob(track._refs.file.id);
+  const waveform = await MusicTrackWaveform.load(track._refs.waveform.id, {});
 
   if (!blob || !waveform) return;
 
@@ -142,13 +151,25 @@ export async function updateMusicTrackTitle(track: MusicTrack, title: string) {
   track.title = title;
 }
 
-export async function updateActivePlaylist(
-  playlist: Playlist,
-  me: MusicaAccount,
-) {
-  me.root!.activePlaylist = playlist ?? me.root!.rootPlaylist;
+export async function updateActivePlaylist(playlist?: Playlist) {
+  const me = await MusicaAccount.getMe().ensureLoaded({
+    root: {
+      activePlaylist: {},
+      rootPlaylist: {},
+    },
+  });
+
+  if (!me) return;
+
+  me.root.activePlaylist = playlist ?? me.root.rootPlaylist;
 }
 
-export async function updateActiveTrack(track: MusicTrack, me: MusicaAccount) {
-  me.root!.activeTrack = track;
+export async function updateActiveTrack(track: MusicTrack) {
+  const me = await MusicaAccount.getMe().ensureLoaded({
+    root: {},
+  });
+
+  if (!me) return;
+
+  me.root.activeTrack = track;
 }

examples/music-player/src/5_useMediaPlayer.ts

@@ -8,26 +8,26 @@ import { updateActivePlaylist, updateActiveTrack } from "./4_actions";
 import { getNextTrack, getPrevTrack } from "./lib/getters";
 
 export function useMediaPlayer() {
-  const { me } = useAccount();
+  const { me } = useAccount({
+    root: {},
+  });
 
   const playState = usePlayState();
   const playMedia = usePlayMedia();
 
   const [loading, setLoading] = useState<ID<MusicTrack> | null>(null);
 
-  const activeTrackId = me?.root?._refs.activeTrack?.id;
+  const activeTrackId = me?.root._refs.activeTrack?.id;
 
   // Reference used to avoid out-of-order track loads
   const lastLoadedTrackId = useRef<ID<MusicTrack> | null>(null);
 
   async function loadTrack(track: MusicTrack) {
-    if (!me.root) return;
-
     lastLoadedTrackId.current = track.id;
 
     setLoading(track.id);
 
-    const file = await FileStream.loadAsBlob(track._refs.file.id, me);
+    const file = await FileStream.loadAsBlob(track._refs.file.id);
 
     if (!file) {
       setLoading(null);
@@ -40,7 +40,7 @@ export function useMediaPlayer() {
       return;
     }
 
-    updateActiveTrack(track, me);
+    updateActiveTrack(track);
 
     await playMedia(file);
 
@@ -48,20 +48,16 @@ export function useMediaPlayer() {
   }
 
   async function playNextTrack() {
-    if (!me?.root) return;
-
-    const track = await getNextTrack(me);
+    const track = await getNextTrack();
 
     if (track) {
-      updateActiveTrack(track, me);
+      updateActiveTrack(track);
       await loadTrack(track);
     }
   }
 
   async function playPrevTrack() {
-    if (!me?.root) return;
-
-    const track = await getPrevTrack(me);
+    const track = await getPrevTrack();
 
     if (track) {
       await loadTrack(track);
@@ -69,14 +65,12 @@ export function useMediaPlayer() {
   }
 
   async function setActiveTrack(track: MusicTrack, playlist?: Playlist) {
-    if (!me?.root) return;
-
     if (activeTrackId === track.id && lastLoadedTrackId.current !== null) {
       playState.toggle();
       return;
     }
 
-    updateActivePlaylist(playlist!, me);
+    updateActivePlaylist(playlist);
 
     await loadTrack(track);
 

examples/music-player/src/6_InvitePage.tsx

@@ -1,25 +1,25 @@
-import { useAcceptInvite, useAccount } from "jazz-react";
+import { useAcceptInvite } from "jazz-react";
 import { ID } from "jazz-tools";
 import { useCallback } from "react";
 import { useNavigate } from "react-router-dom";
-import { Playlist } from "./1_schema";
+import { MusicaAccount, Playlist } from "./1_schema";
 
 export function InvitePage() {
   const navigate = useNavigate();
 
-  const { me } = useAccount({
-    root: {
-      playlists: [],
-    },
-  });
-
   useAcceptInvite({
     invitedObjectSchema: Playlist,
     onAccept: useCallback(
       async (playlistId: ID<Playlist>) => {
-        if (!me) return;
+        const playlist = await Playlist.load(playlistId, {});
 
-        const playlist = await Playlist.load(playlistId, me, {});
+        const me = await MusicaAccount.getMe().ensureLoaded({
+          root: {
+            playlists: [],
+          },
+        });
+
+        if (!me) return;
 
         if (
           playlist &&
@@ -30,7 +30,7 @@ export function InvitePage() {
 
         navigate("/playlist/" + playlistId);
       },
-      [navigate, me],
+      [navigate],
     ),
   });
 

examples/music-player/src/components/AuthButton.tsx

@@ -0,0 +1,40 @@
+"use client";
+
+import { Button } from "@/components/ui/button";
+import { useAccount, useIsAnonymousUser } from "jazz-react";
+import { useState } from "react";
+import { useNavigate } from "react-router-dom";
+import { AuthModal } from "./AuthModal";
+
+export function AuthButton() {
+  const [open, setOpen] = useState(false);
+  const { logOut } = useAccount();
+  const navigate = useNavigate();
+
+  const isOnboarding = useIsAnonymousUser();
+
+  function handleSignOut() {
+    logOut();
+    navigate("/");
+  }
+
+  if (!isOnboarding) {
+    return (
+      <Button variant="outline" onClick={handleSignOut}>
+        Sign out
+      </Button>
+    );
+  }
+
+  return (
+    <>
+      <Button
+        onClick={() => setOpen(true)}
+        className="bg-white text-black hover:bg-gray-100"
+      >
+        Sign up
+      </Button>
+      <AuthModal open={open} onOpenChange={setOpen} />
+    </>
+  );
+}

examples/music-player/src/components/AuthModal.tsx

@@ -0,0 +1,112 @@
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { useAccount, usePasskeyAuth } from "jazz-react";
+import { Loader2 } from "lucide-react";
+import { useState } from "react";
+
+interface AuthModalProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+}
+
+export function AuthModal({ open, onOpenChange }: AuthModalProps) {
+  const [username, setUsername] = useState("");
+  const [isSignUp, setIsSignUp] = useState(true);
+
+  const { me } = useAccount();
+
+  const [, authState] = usePasskeyAuth({
+    appName: "Jazz Music Player",
+    onAnonymousUserUpgrade: ({ username, isSignUp }) => {
+      if (isSignUp) {
+        me.profile!.name = username;
+      }
+
+      onOpenChange(false);
+    },
+  });
+
+  const handleSubmit = (e: React.FormEvent) => {
+    e.preventDefault();
+    if (authState.state === "ready") {
+      if (isSignUp) {
+        authState.signUp(username);
+      } else {
+        authState.logIn();
+      }
+    }
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="sm:max-w-[425px]">
+        <DialogHeader>
+          <DialogTitle className="text-2xl font-bold">
+            {isSignUp ? "Create account" : "Welcome back"}
+          </DialogTitle>
+          {authState.state === "ready" && (
+            <DialogDescription>
+              {isSignUp
+                ? "Sign up to enable network sync and share your playlists with others"
+                : "Changes done before logging in will be lost"}
+            </DialogDescription>
+          )}
+        </DialogHeader>
+        <form onSubmit={handleSubmit} className="space-y-4">
+          {isSignUp && (
+            <div className="space-y-2">
+              <Label htmlFor="username">Username</Label>
+              <Input
+                id="username"
+                value={username}
+                onChange={(e) => setUsername(e.target.value)}
+                placeholder="Enter your username"
+                required
+              />
+            </div>
+          )}
+          {authState.errors.length > 0 && (
+            <div className="text-sm text-red-500">
+              {authState.errors.map((error, i) => (
+                <p key={i}>{error}</p>
+              ))}
+            </div>
+          )}
+          <div className="space-y-4">
+            <Button
+              type="submit"
+              className="w-full bg-blue-600 hover:bg-blue-700"
+              disabled={authState.state === "loading"}
+            >
+              {authState.state === "loading" ? (
+                <Loader2 className="mr-2 h-4 w-4 animate-spin" />
+              ) : isSignUp ? (
+                "Sign up with passkey"
+              ) : (
+                "Login with passkey"
+              )}
+            </Button>
+            <div className="text-center text-sm">
+              {isSignUp ? "Already have an account?" : "Don't have an account?"}{" "}
+              <button
+                type="button"
+                onClick={() => setIsSignUp(!isSignUp)}
+                className="text-blue-600 hover:underline"
+              >
+                {isSignUp ? "Login" : "Sign up"}
+              </button>
+            </div>
+          </div>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

examples/music-player/src/components/LocalOnlyTag.tsx

@@ -0,0 +1,37 @@
+import { Badge } from "@/components/ui/badge";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
+import { useIsAnonymousUser } from "jazz-react";
+import { Info } from "lucide-react";
+
+export function LocalOnlyTag() {
+  const isAnonymousUser = useIsAnonymousUser();
+
+  if (!isAnonymousUser) {
+    return null;
+  }
+
+  return (
+    <TooltipProvider>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <div className="inline-flex items-center gap-1.5 cursor-help">
+            <Badge variant="default" className="h-5 text-xs font-normal">
+              Local only
+            </Badge>
+            <Info className="h-3.5 w-3.5 text-muted-foreground" />
+          </div>
+        </TooltipTrigger>
+        <TooltipContent className="max-w-[250px]">
+          <p>
+            Sign up to enable network sync and share your playlists with others
+          </p>
+        </TooltipContent>
+      </Tooltip>
+    </TooltipProvider>
+  );
+}

examples/music-player/src/components/MusicTrackRow.tsx

@@ -43,7 +43,7 @@ export function MusicTrackRow({
 
   function handleAddToPlaylist(playlist: Playlist) {
     if (!track) return;
-    addTrackToPlaylist(playlist, track, me);
+    addTrackToPlaylist(playlist, track);
   }
 
   return (

examples/music-player/src/components/SidePanel.tsx

@@ -1,5 +1,6 @@
 import { useAccount } from "jazz-react";
 import { useNavigate, useParams } from "react-router";
+import { LocalOnlyTag } from "./LocalOnlyTag";
 
 export function SidePanel() {
   const { playlistId } = useParams();
@@ -25,7 +26,7 @@ export function SidePanel() {
 
   return (
     <aside className="w-64 p-6 bg-white overflow-y-auto">
-      <div className="flex items-center mb-6">
+      <div className="flex items-center mb-1">
         <svg
           className="w-8 h-8 mr-2"
           viewBox="0 0 24 24"
@@ -46,6 +47,9 @@ export function SidePanel() {
         </svg>
         <span className="text-xl font-bold text-blue-600">Music Player</span>
       </div>
+      <div className="mb-6">
+        <LocalOnlyTag />
+      </div>
       <nav>
         <h2 className="mb-2 text-sm font-semibold text-gray-600">Playlists</h2>
         <ul className="space-y-1">

examples/music-player/src/components/ui/badge.tsx

@@ -0,0 +1,36 @@
+import { type VariantProps, cva } from "class-variance-authority";
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const badgeVariants = cva(
+  "inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",
+  {
+    variants: {
+      variant: {
+        default:
+          "border-transparent bg-primary text-primary-foreground hover:bg-primary/80",
+        secondary:
+          "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        destructive:
+          "border-transparent bg-destructive text-destructive-foreground hover:bg-destructive/80",
+        outline: "text-foreground",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  },
+);
+
+export interface BadgeProps
+  extends React.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof badgeVariants> {}
+
+function Badge({ className, variant, ...props }: BadgeProps) {
+  return (
+    <div className={cn(badgeVariants({ variant }), className)} {...props} />
+  );
+}
+
+export { Badge, badgeVariants };

examples/music-player/src/components/ui/dialog.tsx

@@ -0,0 +1,120 @@
+import * as DialogPrimitive from "@radix-ui/react-dialog";
+import { X } from "lucide-react";
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const Dialog = DialogPrimitive.Root;
+
+const DialogTrigger = DialogPrimitive.Trigger;
+
+const DialogPortal = DialogPrimitive.Portal;
+
+const DialogClose = DialogPrimitive.Close;
+
+const DialogOverlay = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Overlay>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Overlay
+    ref={ref}
+    className={cn(
+      "fixed inset-0 z-50 bg-black/80  data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
+      className,
+    )}
+    {...props}
+  />
+));
+DialogOverlay.displayName = DialogPrimitive.Overlay.displayName;
+
+const DialogContent = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content>
+>(({ className, children, ...props }, ref) => (
+  <DialogPortal>
+    <DialogOverlay />
+    <DialogPrimitive.Content
+      ref={ref}
+      className={cn(
+        "fixed left-[50%] top-[50%] z-50 grid w-full max-w-lg translate-x-[-50%] translate-y-[-50%] gap-4 border bg-background p-6 shadow-lg duration-200 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:slide-out-to-left-1/2 data-[state=closed]:slide-out-to-top-[48%] data-[state=open]:slide-in-from-left-1/2 data-[state=open]:slide-in-from-top-[48%] sm:rounded-lg",
+        className,
+      )}
+      {...props}
+    >
+      {children}
+      <DialogPrimitive.Close className="absolute right-4 top-4 rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none data-[state=open]:bg-accent data-[state=open]:text-muted-foreground">
+        <X className="h-4 w-4" />
+        <span className="sr-only">Close</span>
+      </DialogPrimitive.Close>
+    </DialogPrimitive.Content>
+  </DialogPortal>
+));
+DialogContent.displayName = DialogPrimitive.Content.displayName;
+
+const DialogHeader = ({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>) => (
+  <div
+    className={cn(
+      "flex flex-col space-y-1.5 text-center sm:text-left",
+      className,
+    )}
+    {...props}
+  />
+);
+DialogHeader.displayName = "DialogHeader";
+
+const DialogFooter = ({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>) => (
+  <div
+    className={cn(
+      "flex flex-col-reverse sm:flex-row sm:justify-end sm:space-x-2",
+      className,
+    )}
+    {...props}
+  />
+);
+DialogFooter.displayName = "DialogFooter";
+
+const DialogTitle = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Title>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Title
+    ref={ref}
+    className={cn(
+      "text-lg font-semibold leading-none tracking-tight",
+      className,
+    )}
+    {...props}
+  />
+));
+DialogTitle.displayName = DialogPrimitive.Title.displayName;
+
+const DialogDescription = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Description>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Description
+    ref={ref}
+    className={cn("text-sm text-muted-foreground", className)}
+    {...props}
+  />
+));
+DialogDescription.displayName = DialogPrimitive.Description.displayName;
+
+export {
+  Dialog,
+  DialogPortal,
+  DialogOverlay,
+  DialogClose,
+  DialogTrigger,
+  DialogContent,
+  DialogHeader,
+  DialogFooter,
+  DialogTitle,
+  DialogDescription,
+};

examples/music-player/src/components/ui/input.tsx

@@ -0,0 +1,22 @@
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<"input">>(
+  ({ className, type, ...props }, ref) => {
+    return (
+      <input
+        type={type}
+        className={cn(
+          "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-base ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+          className,
+        )}
+        ref={ref}
+        {...props}
+      />
+    );
+  },
+);
+Input.displayName = "Input";
+
+export { Input };

examples/music-player/src/components/ui/label.tsx

@@ -0,0 +1,24 @@
+import * as LabelPrimitive from "@radix-ui/react-label";
+import { type VariantProps, cva } from "class-variance-authority";
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const labelVariants = cva(
+  "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70",
+);
+
+const Label = React.forwardRef<
+  React.ElementRef<typeof LabelPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root> &
+    VariantProps<typeof labelVariants>
+>(({ className, ...props }, ref) => (
+  <LabelPrimitive.Root
+    ref={ref}
+    className={cn(labelVariants(), className)}
+    {...props}
+  />
+));
+Label.displayName = LabelPrimitive.Root.displayName;
+
+export { Label };

examples/music-player/src/components/ui/tooltip.tsx

@@ -0,0 +1,30 @@
+"use client";
+
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const TooltipProvider = TooltipPrimitive.Provider;
+
+const Tooltip = TooltipPrimitive.Root;
+
+const TooltipTrigger = TooltipPrimitive.Trigger;
+
+const TooltipContent = React.forwardRef<
+  React.ElementRef<typeof TooltipPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content>
+>(({ className, sideOffset = 4, ...props }, ref) => (
+  <TooltipPrimitive.Content
+    ref={ref}
+    sideOffset={sideOffset}
+    className={cn(
+      "z-50 overflow-hidden rounded-md border bg-popover px-3 py-1.5 text-sm text-popover-foreground shadow-md animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
+      className,
+    )}
+    {...props}
+  />
+));
+TooltipContent.displayName = TooltipPrimitive.Content.displayName;
+
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

examples/music-player/src/lib/getters.ts

@@ -1,10 +1,18 @@
 import { MusicaAccount } from "../1_schema";
 
-export async function getNextTrack(account: MusicaAccount) {
-  if (!account.root?.activePlaylist?.tracks) return;
+export async function getNextTrack() {
+  const me = await MusicaAccount.getMe().ensureLoaded({
+    root: {
+      activePlaylist: {
+        tracks: [],
+      },
+    },
+  });
 
-  const tracks = account.root.activePlaylist.tracks;
-  const activeTrack = account.root._refs.activeTrack;
+  if (!me) return;
+
+  const tracks = me.root.activePlaylist.tracks;
+  const activeTrack = me.root._refs.activeTrack;
 
   const currentIndex = tracks.findIndex((item) => item?.id === activeTrack.id);
 
@@ -13,11 +21,19 @@ export async function getNextTrack(account: MusicaAccount) {
   return tracks[nextIndex];
 }
 
-export async function getPrevTrack(account: MusicaAccount) {
-  if (!account.root?.activePlaylist?.tracks) return;
+export async function getPrevTrack() {
+  const me = await MusicaAccount.getMe().ensureLoaded({
+    root: {
+      activePlaylist: {
+        tracks: [],
+      },
+    },
+  });
 
-  const tracks = account.root.activePlaylist.tracks;
-  const activeTrack = account.root._refs.activeTrack;
+  if (!me) return;
+
+  const tracks = me.root.activePlaylist.tracks;
+  const activeTrack = me.root._refs.activeTrack;
 
   const currentIndex = tracks.findIndex((item) => item?.id === activeTrack.id);
 

examples/music-player/src/lib/useUploadExampleData.ts

@@ -1,30 +1,30 @@
-import { useAccount } from "jazz-react";
-// eslint-disable-next-line react-compiler/react-compiler
-/* eslint-disable react-hooks/exhaustive-deps */
+import { MusicaAccount } from "@/1_schema";
 import { useEffect } from "react";
-import { MusicaAccount } from "../1_schema";
 import { uploadMusicTracks } from "../4_actions";
 
 export function useUploadExampleData() {
-  const { me } = useAccount({
+  useEffect(() => {
+    uploadOnboardingData();
+  }, []);
+}
+
+async function uploadOnboardingData() {
+  const me = await MusicaAccount.getMe().ensureLoaded({
     root: {},
   });
 
-  const shouldUploadOnboardingData = me?.root?.exampleDataLoaded === false;
+  if (!me) throw new Error("Me not resolved");
 
-  useEffect(() => {
-    if (me?.root && shouldUploadOnboardingData) {
-      me.root.exampleDataLoaded = true;
+  if (me.root.exampleDataLoaded) return;
 
-      uploadOnboardingData(me).then(() => {
-        me.root.exampleDataLoaded = true;
-      });
-    }
-  }, [shouldUploadOnboardingData]);
-}
-
-async function uploadOnboardingData(me: MusicaAccount) {
-  const trackFile = await (await fetch("/example.mp3")).blob();
-
-  return uploadMusicTracks(me, [new File([trackFile], "Example song")]);
+  me.root.exampleDataLoaded = true;
+
+  try {
+    const trackFile = await (await fetch("/example.mp3")).blob();
+
+    await uploadMusicTracks([new File([trackFile], "Example song")]);
+  } catch (error) {
+    me.root.exampleDataLoaded = false;
+    throw error;
+  }
 }