Loona is a state management library built on top of Apollo Client. It brings the simplicity of managing remote data with Apollo, to your local state. Instead of maintaining a second store for your local data with tools like Redux, MobX or NGRX, use Loona to keep data in just one space and make it a single source of truth.
With Loona you get all the benefits of Apollo, like caching, offline persistence and more. On top of that you gain all the other benefits like stream of actions, better sepatation between mutation and store updates.
UI Frameworks
Loona works with React and Angular:
Documentation
All of the documentation for Loona including usage articles and helpful recipes lives on loonajs.com.
Read about Loona
Features
- Single store - Keep your remote and local data in just one space and make it a single source of truth.
- Separation of concerns - Loona helps you to keep every piece of your data flow separated.
- Benefits of Apollo - You get all the benefits of Apollo, like caching, offline persistence and more.
- Works on Mobile - Works out of the box with React Native and NativeScript.
Concept
Loona can be described by few core concepts. First two of them are related to GraphQL:
- Queries - ask for what you need.
- Mutations - a way to modify your remote and local data.
- Store - a single source of truth of all your data.
It also uses a concept of:
- Actions - declarative way to call a mutation or trigger a different action
- Updates - modify the store after a mutation happens
By having it all, Loona helps you to keep every piece of your data's flow separated.
Contributing
This project uses Lerna.
Bootstraping:
yarn install
Running tests locally:
yarn test
Formatting code:
yarn format
This project uses TypeScript for static typing. You can get it built into your editor with no configuration by opening this project in Visual Studio Code, an open source IDE which is available for free on all platforms.