WatermelonDB
watermelondb.dev
- Free plan
- Windows
- Web
- iPhone and iPad
- Android
- API
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
Plans
Every plan and priceWatermelonDB
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.