Your fetch mate!

Hey there!

Are you tired of struggling with complex client-side data fetching in your React projects? Say hello to fetch-mate - the simple, lightweight library that makes it a breeze to request and cache data from any source.

No need to get overwhelmed by tons of configuration options - fetch-mate's intuitive interface is perfect for beginners or those looking for a straightforward solution. Whether you're working with a REST API, GraphQL, or a database, fetch-mate has got you covered

Simple, intuitive interface
Support for REST, GraphQL, and other data sources
Ability to cache data in memory or in the browser
Automatic refetching of data on specified intervals

All of this comes via a single dependency install.

npm install fetch-mate

yarn add fetch-mate

Quick Start

fetch-mate can act as simple as a single custom hook around your data source with additional options to control your data flow, options like: isLoading, isError, isDone, error and of course the data itself.

by default fetch-mate doesn't cache anything, its just a single hook do its job:

 const { data, isLoading, error } = useFetchMate({
        src: () => fetch('https://jsonplaceholder.typicode.com/todos/1').then((res) => res.json())
    });

but if you want to have a global store and a cache layer, fetch-mate also has option for it, just use FetchMateStore as your global store

const fetchMateConfig = new FetchMateConfig({
   ttl: 1000 * 60 * 60 * 24,
   cacheType: 'memory'
});

<FetchMateStore config={fetchMateConfig}>
   <App />
</FetchMateStore>

Contribution 🥳

We welcome contributions to fetch-mate! fetch-mate still is in alpha release, if you're a beginner looking to practice contributing to an open source project, or an experienced developer looking to help out, we'd love to have you on board. Whether you want to fix a bug, add a new feature, or simply improve the documentation, every contribution helps us make fetch-mate better.

If you're new to open source contributions, check out the Open Source Guides for helpful resources and tips. Then, take a look at our issues page to see where you can help out.

Thanks in advance for your support!

devhe4d/fetch-mate

Your fetch mate!

Quick Start

Contribution 🥳