A simple database built on React Native AsyncStorage for local data persistence.
react-native-store is a lightweight database solution for React Native applications, built on top of the platform's AsyncStorage API. It provides a structured, model-based interface to store, query, and manage local data, simplifying state persistence in mobile apps by reducing boilerplate code.
React Native developers who need a simple, structured way to handle local data persistence without the complexity of a full SQL database or external service. It's particularly suited for those familiar with model-based APIs and looking for minimal abstraction over AsyncStorage.
Developers choose react-native-store for its familiar model-based API and advanced filtering inspired by LoopBack, offering a straightforward way to perform CRUD operations with promise-based methods. Its lightweight nature and focus on simplicity make it an efficient alternative to more heavy-handed database solutions for common local storage use cases.
A simple database base on react-native AsyncStorage.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Organizes data into named models (e.g., 'foo', 'bar') for clean separation, reducing boilerplate and simplifying CRUD operations, as demonstrated in the simple example with DB.foo and DB.bar.
Supports complex filters like where, order, limit, and offset, inspired by LoopBack's syntax, enabling flexible data retrieval without manual parsing, as shown in the handleFilter example.
All operations such as add, update, and find return promises, making asynchronous handling straightforward and compatible with modern async/await patterns.
Automatically assigns unique _id to each entry, ensuring easy record management and data integrity, as outlined in the data anatomy section.
The README admits that query operations on nested objects are flawed; updates can overwrite entire nested properties, and filters cannot be applied deeply, limiting data structure flexibility.
Key operators like 'like' and 'near' are not implemented, and the include filter is omitted, reducing querying power compared to more comprehensive databases.
Built on AsyncStorage, which is not optimized for large-scale operations, so performance may suffer with extensive data or complex queries, and it lacks transactional guarantees.
The presence of a breaking-changes.md file indicates potential migration issues and instability between updates, requiring careful version management.