Build powerful React and React Native apps that scale from hundreds to tens of thousands of records and remain fast โšก๏ธ

Programming language: JavaScript
License: MIT License
Tags: Storage     Indexeddb     React     Sqlite     React Native    
Latest version: v0.24

WatermelonDB alternatives and similar libraries

Based on the "Storage" category.
Alternatively, view WatermelonDB alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of WatermelonDB or a related project?

Add another 'Storage' Library


A reactive database framework

Build powerful React and React Native apps that scale from hundreds to tens of thousands of records and remain fast โšก๏ธ

โšก๏ธ Launch your app instantly no matter how much data you have
๐Ÿ“ˆ Highly scalable from hundreds to tens of thousands of records
๐Ÿ˜Ž Lazy loaded. Only load data when you need it
๐Ÿ”„ Offline-first. Sync with your own backend
๐Ÿ“ฑ Multiplatform. iOS, Android, web, and Node.js
โš›๏ธ Optimized for React. Easily plug data into components
๐Ÿงฐ Framework-agnostic. Use JS API to plug into other UI frameworks
โฑ Fast. And getting faster with every release!
โœ… Proven. Powers Nozbe Teams since 2017 (and many others)
โœจ Reactive. (Optional) RxJS API
๐Ÿ”— Relational. Built on rock-solid SQLite foundation
โš ๏ธ Static typing with Flow or TypeScript

Why Watermelon?

WatermelonDB is a new way of dealing with user data in React Native and React web apps.

It's optimized for building complex applications in React Native, and the number one goal is real-world performance. In simple words, your app must launch fast.

For simple apps, using Redux or MobX with a persistence adapter is the easiest way to go. But when you start scaling to thousands or tens of thousands of database records, your app will now be slow to launch (especially on slower Android devices). Loading a full database into JavaScript is expensive!

Watermelon fixes it by being lazy. Nothing is loaded until it's requested. And since all querying is performed directly on the rock-solid SQLite database on a separate native thread, most queries resolve in an instant.

But unlike using SQLite directly, Watermelon is fully observable. So whenever you change a record, all UI that depends on it will automatically re-render. For example, completing a task in a to-do app will re-render the task component, the list (to reorder), and all relevant task counters. Learn more.

๐Ÿ“บ Next-generation React databases(a talk about WatermelonDB) โœจ Check out web Demo


Quick (over-simplified) example: an app with posts and comments.

First, you define Models:

class Post extends Model {
  @field('name') name
  @field('body') body
  @children('comments') comments

class Comment extends Model {
  @field('body') body
  @field('author') author

Then, you connect components to the data:

const Comment = ({ comment }) => (
  <View style={styles.commentBox}>
    <Text>{comment.body} โ€” by {comment.author}</Text>

// This is how you make your app reactive! โœจ
const enhance = withObservables(['comment'], ({ comment }) => ({
const EnhancedComment = enhance(Comment)

And now you can render the whole Post:

const Post = ({ post, comments }) => (
    {comments.map(comment =>
      <EnhancedComment key={comment.id} comment={comment} />

const enhance = withObservables(['post'], ({ post }) => ({
  comments: post.comments

The result is fully reactive! Whenever a post or comment is added, changed, or removed, the right components will automatically re-render on screen. Doesn't matter if a change occurred in a totally different part of the app, it all just works out of the box!

โžก๏ธ Learn more: see full documentation

Who uses WatermelonDB

Does your company or app use ๐Ÿ‰? Open a pull request and add your logo/icon with link here!


WatermelonDB is an open-source project and it needs your help to thrive!

If there's a missing feature, a bug, or other improvement you'd like, we encourage you to contribute! Feel free to open an issue to get some guidance and see [Contributing guide](./CONTRIBUTING.md) for details about project setup, testing, etc.

If you're just getting started, see good first issues that are easy to contribute to. If you make a non-trivial contribution, email me, and I'll send you a nice ๐Ÿ‰ sticker!

If you make or are considering making an app using WatermelonDB, please let us know!

Author and license

WatermelonDB was created by @Nozbe.

WatermelonDB's main author and maintainer is Radek Pietruszewski (website โ‹… twitter โ‹… engineering posters)

See all contributors.

WatermelonDB is available under the MIT license. See the [LICENSE file](./LICENSE) for more info.

*Note that all licence references and agreements mentioned in the WatermelonDB README section above are relevant to that project's source code only.