WatermelonDB
WatermelonDB is a free, MIT-licensed reactive database framework for React and React Native applications.
What WatermelonDB is
WatermelonDB is a free, MIT-licensed reactive database framework for React and React Native applications. It is built for offline-first apps that synchronize local data with a remote database. Records load lazily, and queries run directly on SQLite on a separate native thread; the project describes its target scale as hundreds to tens of thousands of records. When records change, dependent UI components update automatically. WatermelonDB provides sync primitives and a built-in adapter for backend endpoints that follow its sync protocol, but developers must provide their own backend. The documented setup uses SQLite for React Native and Node.js, and LokiJS for web. Documentation also describes an optional RxJS API and a JavaScript API for other UI frameworks. React Native Windows support is experimental, requires JSI, and does not implement Turbo Sync. The sync documentation notes that a push can fail if a record changes remotely between pull and push, and pushed changes may be pulled again on a later sync. The project invites contributions and issue reports, and links to Stack Overflow for community help.
Good
- Free and MIT licensed
- Offline-first design with sync primitives
- Updates dependent UI components when records change
- Queries SQLite on a separate native thread
- Supports SQLite and LokiJS storage adapters
Watch out
- Developers must provide their own sync backend
- React Native Windows support is experimental
- Sync has documented push and repeat-pull edge cases
Who it suits
WatermelonDB is for developers building React or React Native apps that need local, offline-first data and synchronization. It also offers a JavaScript API for developers using other UI frameworks.
Verdict
WatermelonDB combines a local database with reactive UI updates and tools for synchronizing to a backend you supply. Windows support and the documented sync edge cases are worth considering before adopting it.
Plans and prices
From WatermelonDB's own pricing page, checked 7 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| WatermelonDB | Free | Open-source database framework · MIT license |
The facts
Each one read from WatermelonDB's own pages, with the date it was checked.
What it does
- Backend requirement
- WatermelonDB is a local database, so users need to provide their own backend for synchronization.checked 7 Oct 2026
- Integrations
- The docs describe React and React Native usage, an optional RxJS API, and a JavaScript API for other UI frameworks.checked 7 Oct 2026
- Known sync limitations
- The docs note that a push can fail if a record changes remotely between pull and push, and that pushed changes may be pulled again on the next sync.checked 7 Oct 2026
- License and maintainer
- WatermelonDB is MIT licensed and names Radek Pietruszewski as its main author and maintainer.checked 7 Oct 2026
- Offline first
- WatermelonDB is designed for offline first use and synchronization with a remote database.checked 7 Oct 2026
- Performance
- It lazily loads records and runs queries directly on SQLite on a separate native thread.checked 7 Oct 2026
- Product
- WatermelonDB is a reactive database framework for React and React Native applications.checked 7 Oct 2026
- Reactive UI
- Changes to records automatically re-render the UI components that depend on them.checked 7 Oct 2026
- Scale
- The project describes its target scale as hundreds to tens of thousands of records.checked 7 Oct 2026
- Security guidance
- The sync backend guide says to whitelist acceptable collection and column names and validate record IDs and permissions.checked 7 Oct 2026
- Storage adapters
- The setup guide uses SQLite for React Native and Node.js, and LokiJS for web.checked 7 Oct 2026
- Support and contribution
- The project invites users to open issues and contribute, and its docs link to Stack Overflow for community help.checked 7 Oct 2026
- Sync support
- It provides sync primitives and a built-in sync adapter that works with backend endpoints following its sync protocol.checked 7 Oct 2026
Where it runs
- Platforms
- The installation guide documents iOS, Android, web, Node.js, and experimental React Native Windows support.checked 7 Oct 2026
- Windows limits
- React Native Windows support is experimental, requires JSI, and does not implement Turbo Sync.checked 7 Oct 2026
Alternatives to WatermelonDB
- 1
Hive
Free planOpen sourceAndroidiOSWebAPI8.6From $5 a month - 2

Firestore
Free planAndroidiOSWebAPI8.1$0.03 usage-based - 3
SQLDelight
Free planOpen sourceAndroidiOSWebAPI7.9Free plan - 4
PouchDB
Free planOpen sourceAndroidiOSWebAPI7.8Free plan - 5

Sparksee
Free planAndroidiOSAPILinux7.6Free plan - 6

RxDB
Free planAndroidiOSWebAPI7.5From $99 a month
