I Shipped...

12 December 2025 (3PRs)

an update to our docs showing how to use version control effectively in different frameworks

Our docs previously had a page showing how to use Jazz's version control functionality with React. I updated our docs to show how it can be done across all our supported frameworks.

an update to our docs landing page with a minimal example of how to use Jazz

I'm quite proud of this one: I build a minimal Jazz example (a working to-do list with sync in less than 100 lines of code), and published it on our docs landing page.

a quick fix to address a security issue in Next

There was a security issue in Next due to an issue in React. I bumped our Next versions.

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 (1PR)

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.