micro-graphql-react
A lightweight GraphQL React client with extensible, composable cache invalidation and Suspense support.
What is micro-graphql-react?
micro-graphql-react is a lightweight GraphQL client for React that provides hooks for data fetching and mutations while emphasizing explicit cache control. It solves common caching problems like coordinating mutations with filtered result sets and handling empty arrays by giving developers low-level building blocks to manage cache invalidation manually.
React developers building applications with GraphQL backends who need fine-grained control over caching behavior and prefer simplicity over automated cache management.
Developers choose micro-graphql-react for its minimal size, predictable caching through explicit invalidation rules, and avoidance of the complexity and edge cases associated with normalized caches in other GraphQL clients.
Overview
Light and simple GraphQL React client with extensible, composable cache invalidation. Works with Suspense.
Use Cases
Best For
- Applications where automated GraphQL cache invalidation leads to unpredictable behavior
- Projects requiring a lightweight GraphQL client with minimal bundle size impact
- React apps using Suspense for declarative data fetching
- Scenarios where mutations must precisely control cache clearing for filtered queries
- Developers who prefer explicit cache management over black-box solutions
- Prototyping or small-to-medium projects where simplicity is prioritized over advanced caching features
Not Ideal For
- Projects requiring automated, normalized cache management without manual invalidation logic
- Teams needing built-in GraphQL features like subscriptions or offline persistence out of the box
- Large-scale applications where manual cache control could become error-prone or cumbersome
- Developers who prefer extensive ecosystems with dev tools and community plugins, like Apollo Client
Pros & Cons
Pros
At only 2.8K min+gzip, it's one of the smallest GraphQL clients, minimizing impact on app performance and load times.
Provides fine-grained invalidation with hard and soft resets, allowing precise management of cache entries after mutations, as detailed in the docs for filtered queries.
Integrates with React Suspense for declarative data fetching, enabling smoother loading states in modern React applications.
Offers intuitive hooks for queries and mutations, similar to other clients, reducing the learning curve for developers familiar with React patterns.
Cons
Relies on React Suspense, which is still in beta, making parts of the library unstable and potentially risky for production use.
Requires developers to explicitly manage cache invalidation, which can increase complexity and bug potential compared to automated solutions.
Lacks advanced GraphQL features like subscriptions, real-time updates, or built-in dev tools, as it focuses solely on minimal caching control.
Frequently Asked Questions
Related Projects
apollo-clientThe industry-leading GraphQL client for TypeScript, JavaScript, React, Vue, Angular, and more. Apollo Client delivers powerful caching, intuitive APIs, and comprehensive developer tools to accelerate your app development.
relayRelay is a JavaScript framework for building data-driven React applications.
aws-amplifyA declarative JavaScript library for application development using cloud services.
urqlThe highly customizable and versatile GraphQL client with which you add on features like normalized caching as you grow.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.