Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

WatermelonDB

watermelondb.dev

  • Free plan
  • Windows
  • Web
  • iPhone and iPad
  • Android
  • API
7.5 Club score Visit watermelondb.dev

What WatermelonDB is

WatermelonDB is a free, MIT-licensed reactive database framework for React and React Native applications. It targets offline-first apps that synchronize local data with a remote database, while leaving backend provision to the developer. Records load lazily, and queries run directly on SQLite on a separate native thread. The project describes a target scale from hundreds to tens of thousands of records. Record changes automatically re-render dependent UI components. WatermelonDB supplies synchronization primitives and a built-in adapter for backend endpoints following its sync protocol. Documented storage uses SQLite for React Native and Node.js, and LokiJS for web. Optional RxJS and JavaScript APIs support additional UI approaches. It supports Android, iOS, web, Windows, and API use, with JavaScript, TypeScript, and React Native listed. React Native Windows support is experimental, requires JSI, and lacks Turbo Sync. Sync documentation notes push conflicts and repeated pulls in some cases.

Who it suits

It suits developers building React or React Native applications that need local data, reactive interfaces, and synchronization with a backend they provide.

Good to know, and what to watch

  • Offline-first local database design
  • Reactive updates automatically refresh dependent UI
  • SQLite queries run on a separate native thread
  • Built-in sync adapter follows documented protocol
  • Free MIT-licensed framework
  • Developers must provide their own synchronization backend
  • React Native Windows support is experimental
  • Documented sync edge cases include push conflicts

WatermelonDB

Free

Open source

The verdict

WatermelonDB offers a focused local database and synchronization foundation for React ecosystems. Teams should account for backend responsibility, Windows limitations, and the documented sync edge cases.

What the maker publishes

Backend requirement
WatermelonDB is a local database, so users need to provide their own backend for synchronization. source
Integrations
The docs describe React and React Native usage, an optional RxJS API, and a JavaScript API for other UI frameworks. source
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. source
License and maintainer
WatermelonDB is MIT licensed and names Radek Pietruszewski as its main author and maintainer. source
Offline first
WatermelonDB is designed for offline first use and synchronization with a remote database. source
Performance
It lazily loads records and runs queries directly on SQLite on a separate native thread. source
Platforms
The installation guide documents iOS, Android, web, Node.js, and experimental React Native Windows support. source
Product
WatermelonDB is a reactive database framework for React and React Native applications. source
Reactive UI
Changes to records automatically re-render the UI components that depend on them. source
Scale
The project describes its target scale as hundreds to tens of thousands of records. source
Security guidance
The sync backend guide says to whitelist acceptable collection and column names and validate record IDs and permissions. source
Storage adapters
The setup guide uses SQLite for React Native and Node.js, and LokiJS for web. source
Support and contribution
The project invites users to open issues and contribute, and its docs link to Stack Overflow for community help. source
Sync support
It provides sync primitives and a built-in sync adapter that works with backend endpoints following its sync protocol. source
Windows limits
React Native Windows support is experimental, requires JSI, and does not implement Turbo Sync. source

Checked against the maker's pages on 7 Oct 2026.