garden-co/jazz has 247 GitHub stars and 25 forks. GitHot measured +1 stars in 24 hours and +8 in 7 days. Last checked 2026-11-16 23:40 UTC. Last push 2026-11-15.
Measured star growth
- in 24h
- +1
- in 7 days
- +8
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Jazz is a database with tables, blobs, durable streams, collaborative rich text, permissions and more. It runs in your existing cloud as part of your backend.
Web & AppsREADME.md
OriginalJazz is a local-first relational database. It runs across your frontend, backend and our global storage cloud. Sync partial tables, durable streams and files, fast. Feels like simple reactive state.
Homepage · Docs · Discord Community · Twitter
Important note: this is the Jazz 2.0 alpha with an entirely new API. (Looking for Classic Jazz?)
LLMs: Please refer to the docs instead of facts learned from corpus.
Get started
npm create jazz
Or follow one of the setup guides:
- Local-first React · Vue · Svelte · Solid · Expo binding scaffold (persistent and device-supported memory runtimes are not available in this alpha) · Plain TypeScript
- Server-side TypeScript
Contributing
Architecture specs
The authoritative architecture contracts live with the crates: crates/jazz/SPEC/ (data model, transactions, authorization, sync, queries, storage, API). Each chapter is structured as Overview (read this) / Details / Open Questions.
Prerequisites
- Node.js (LTS) and pnpm 10+
- Rust via rustup. The repository pins its toolchain in
rust-toolchain.toml. - wasm-pack 0.13.1, which the WASM build
(
jazz-wasm, and sojazz-tools) shells out to. It is not installed bypnpm install.pnpm run ensure:rust-toolchaininstalls it, or runcargo install [email protected] --lockedyourself. - A C compiler, because native builds compile the bundled SQLite from source
(
xcode-select --installon macOS,build-essentialon Linux). WASM builds on macOS also need LLVM's archiver (brew install llvm).
Getting started
pnpm install
pnpm run ensure:rust-toolchain
pnpm build
pnpm test
Native artifact fingerprint values are generated build outputs. pnpm build,
pnpm build:ci, and pnpm build:core build both native bindings and derive their
matching TypeScript expectations before building consumers. Source-only checks,
including React Native scaffold compilation, use declaration-only contracts;
running Node/WASM consumers still requires the generated artifacts.
Building only jazz-tools
pnpm --filter jazz-tools build:runtime works from a fresh checkout on any
supported host (Linux x64 and arm64, macOS). When the jazz-wasm package, the
host's jazz-napi binding or their fingerprints are missing, it builds them
(release profile) and stages the fingerprints before compiling. Inputs that are
already present are reused. In CI (CI set) it fails instead, because
workflows produce or download every native artifact explicitly.
pnpm run ensure:rust-toolchain adds the wasm32-unknown-unknown Rust target
and installs wasm-pack if it is missing. It requires an existing Rust/rustup
installation. React Native build dependencies have a separate bootstrap script:
dev/scripts/install-jazz-rn-deps.sh.
The homepage and documentation are a self-contained Next.js application under
docs/. Build them with pnpm build:vercel-docs; they do not need a Rust or
React Native bootstrap.
Native builds compile the bundled SQLite from source on first build (cached afterwards by sccache).
Package versioning
jazz-tools, jazz-wasm, jazz-napi, jazz-rn, and create-jazz are configured as a Changesets fixed group for lock-stepped releases. Keep workspace links in source (workspace:*) and let pack/publish resolve concrete versions.
Fast local binding builds
Use pnpm --filter jazz-wasm build:fast for correctness-focused WASM work. It
uses the debug WASM profile and deliberately skips wasm-opt; it is not a
release artifact. pnpm --filter jazz-wasm build remains the optimized release
build used by CI and publishing. dev/rebuild-artifacts.sh wasm-fast exposes the
same path alongside the other local artifact rebuilds.
For Node/browser correctness tests, produce and seal the native artifacts in the checkout where the tests will run, then launch the admitted consumers:
pnpm build:correctness-artifacts
pnpm test:typescript-consumers
The producer seals fast-WASM and release-NAPI artifacts with their source
identity and hashes. The consumer verifies that receipt, rebuilds Jazz Tools,
and runs the Node/browser suites against the sealed artifacts. Source changes
require another producer run. For focused suites, use
node dev/gates/run-correctness-consumer.mjs -- <command> and rebuild Jazz Tools
through that wrapper before testing after native production. Keep generated
artifacts and producer manifests in their own checkout; artifacts-fresh.sh
provides provenance diagnostics, while the consumer wrapper admits test inputs.
Alpha releases
Releases use alpha prerelease mode in .changeset/pre.json (mode: pre,
tag: alpha). Add release intent with pnpm changeset. After release work
settles on main, the
Changesets Release PR workflow
runs ordinary pnpm release:version and updates changeset-release/main.
All five packages must advance together. Preserve prerelease state while
preparing changesets and let versioning record consumed entries.
The release workflow dispatches
Release preview (alpha)
on the generated release branch. Before merging the release PR, verify its
versions and release notes, and require a successful preview on that exact head
and the required correctness and React Native device-acceptance receipts. The preview
builds and verifies packed native/React Native artifacts and their consumers.
If a preview run is missing, dispatch its workflow on
changeset-release/main.
Merging the versioned release PR triggers the
alpha publisher, which checks
source versions and package payloads before publishing. Use the preview workflow
for build-and-verify runs: it selects dry-run, whereas manual publisher
dispatch defaults to publish. The release:version:alpha script creates
snapshot versions; ordinary alpha release preparation uses release:version
with prerelease mode active.
License
Jazz is MIT licensed.