# Nozbe/WatermelonDB

🍉 Reactive & asynchronous database for powerful React and React Native apps ⚡️

Repository: https://github.com/Nozbe/WatermelonDB
Canonical: https://ross.abutalabs.com/products/watermelondb
Homepage: https://watermelondb.dev
Language: JavaScript
License: MIT
License Family: permissive
Topics: react-native, react, database, persistence, rxjs, reactive, hacktoberfest
Last push: 2025-08-11T12:09:31+00:00

## Health v2 (maintenance only)
Score: 48/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 36, release rhythm 35, longevity 100
- inputs: {"age_days": 2927, "days_push": 387, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 11775, forks 656 (observed 2026-08-28T04:10:49.750253+00:00)

## What it is
WatermelonDB is a reactive and asynchronous database framework for React and React Native apps, built on SQLite. It lazily loads and observes data so apps scale from hundreds to tens of thousands of records while staying fast, with optional RxJS integration and offline-first sync.

## Use cases
- build an offline-first React Native app with local persistence
- store and query tens of thousands of records without slowing app launch
- auto re-render React components when database records change
- sync a local SQLite database with a custom backend
- lazy-load only the data a screen needs instead of loading everything into memory

## When to choose
- you're building a complex React or React Native app that needs fast launch times with large local datasets
- you want reactive, observable queries backed by SQLite
- you need offline-first storage with sync to your own backend

## When to avoid
- you have a simple app where Redux or MobX with a persistence adapter is enough
- you need a server-side relational database rather than client-side storage
- your project doesn't use JavaScript or React-based UI

## Facets
- artifact type: library
- maturity: stable
- function: database, orm, state-management
- domain: mobile-development, web-development, databases, frontend
- platform: windows, cross-platform
- tags: react-native, react, sqlite, offline-first, reactive, rxjs, lazy-loading, persistence, ios, android, web-server, nodejs

## Member repositories
- Nozbe/WatermelonDB (main) score 48

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:49.750253+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:15:20.320891+00:00, confidence not recorded.
  - readme: https://github.com/Nozbe/WatermelonDB (fetched 2026-08-28T04:10:49.750253+00:00, sha 23a5d31ee945)
  - homepage: https://watermelondb.dev (fetched 2026-08-29T08:13:45.724805+00:00, sha 8bbc1974e62b)
- Data as of 2026-08-30T08:39:29.467469+00:00.