I Shipped...

10 December 2025 (1PR)

a minor fix for a regression introduced in our navigation

Our nav was behaving strangely following an update designed to ensure the correct segments were always open. I fixed it.

9 December 2025 (1PR)

improve showcase display on smaller screens

The Jazz website has a showcase page that highlights apps built with the framework. On mobile phones, the images and text were spilling out of their containers and looking messy. I fixed the layout so everything stays neatly within bounds on smaller screens.

4 December 2025 (1PR)

clarify polyfill installation instructions in React Native setup

Jazz is a framework for building collaborative apps. The React Native setup guide said to "install" some compatibility patches, but you don't actually install them as separate packages -- you apply them in your code. I updated the wording to be more accurate and less confusing for developers following the guide.

2 December 2025 (2PRs)

improvements to our React Native and Expo documentation, added a 'polyfills' module to Jazz

In our React Native and Expo documentation, we had some references to outdated practices and unnecessary modules. I refactored the docs to remove these, and I also consolidated the polyfills into a single module which can be imported directly from Jazz.

a performance tip for using selectors

In Jazz, you can use 'selectors' to avoid React re-rendering on every state update. However, the selector function itself still runs. Added tips on avoiding heavy computation inside selector functions, and how to extract that into a useMemo call outside the selector to take advantage of batching.

1 December 2025 (2PRs)

increase Z-index of AoJ banner

The Jazz website had a promotional banner for "Advent of Jazz" that was supposed to stay visible on top of all other content as you scroll. But some elements further down the page were appearing over the banner, hiding it. I increased the banner's stacking priority so it always stays on top.

an 'Advent of Jazz' banner for our homepage to promote the initiative

I proposed and launched an 'Advent of Jazz' initiative on our Discord. This PR adds a prominent link through a banner for December.

25 November 2025 (3PRs)

an improvement to our homepage which lets us know when someone abandons a search

Previously, our analytics only captured successful search. This improvement allows us to track unsuccessful searches.

a bugfix for an issue where `ensureLoaded` was throwing despite `$onError: 'catch'` being set

Normally, Jazz will throw if it cannot complete a resolve query as requested by the user (for example because the user doesn't have access to the data or it doesn't actually exist). Users can override this by specifying $onError: 'catch', which will instead return the rest of the query completed correctly with only the CoValue in question missing.

There was a bug in how this was implemented which I fixed.

24 November 2025 (5PRs)

improved type-checking for vanilla snippets

We had some small issues with the new vanilla docs because the snippets were created before the big refactoring of code snippets was merged. This PR brought them in line with the framework specific snippets.

fix issue when code sample is formatted

The Jazz docs have code examples that hide certain lines to keep things simple. In the Svelte permissions guide, a "hide this line" marker was only hiding the first line of a multi-line block of code, leaving extra lines visible that shouldn't have been shown. I fixed the formatting so the right lines are hidden.

an update to the docs clarifying how to use React Native Fast Encoder

Expo and React Native do not ship a TextDecoder implementation. This docs update explains how to polyfill for (huge) performance improvements in native apps.

a refactoring of our useFramework hook

In our docs, we have a hook which fetches the current framework, however, there were other bits of code around the codebase which do similar things, and the hook was becoming unwieldy and difficult to follow.

I refactored the useFramework hook to make it easier to use, and improve the separation of concerns on the homepage docs.

a docs update regarding credential persistence on iOS

When a Jazz app is uninstalled, all data is deleted except the login credentials on iOS which are persisted to the keychain. This can cause issues if the account is not synced and the user reinstalls the app.

18 November 2025 (1PR)

fix #3186

Jazz's documentation had a missing asterisk in a role permissions table, which meant a footnote reference wasn't displaying correctly. I added the missing character to fix the formatting.

13 November 2025 (4PRs)

fix homepage build issues

The Jazz homepage stopped building after a recent change added a new dependency that made a previously-needed TypeScript workaround invalid. I removed the outdated workaround and added a proper type check, which got the homepage building and deploying again.

documentation for a pattern on how to create set-like collections

Users can create lists using Jazz, but there's no protection to stop users from inserting the same item multiple times into a CoList. For users wanting lists of unique items, I proposed and wrote up a pattern for using a CoRecord keyed on the CoValue ID.

an update to our React Native and Expo example apps, demonstrating how to use images

We have an example chat app for all our supported frameworks. For our browser-based frameworks, this chat allows also uploading images to the chat, but our mobile apps did not.

I added the image upload functionality to the mobile framework examples.

add .svelte-kit to ignored paths

Vercel's Workflow SDK helps you build long-running background tasks. SvelteKit (a web framework) generates a build folder called .svelte-kit that should be ignored by tools watching for file changes. I added it to the ignore list so the workflow SDK doesn't unnecessarily process those generated files.