Skip to content

coroutine/rest-hooks

This branch is 3913 commits behind reactive/data-client:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4f37bdc ยท Mar 8, 2020
Feb 18, 2020
Feb 19, 2020
Feb 21, 2020
Feb 13, 2020
Mar 4, 2020
Mar 8, 2020
Dec 16, 2019
Mar 4, 2020
Nov 20, 2019
Apr 21, 2019
Sep 2, 2019
Nov 20, 2019
Feb 18, 2020
Dec 1, 2019
Dec 22, 2019
Feb 23, 2019
Dec 17, 2019
Jan 29, 2020
Feb 18, 2020
Apr 21, 2019
Feb 18, 2020
Dec 23, 2019
Mar 8, 2020
Dec 11, 2019
Feb 18, 2020
Feb 18, 2020
Feb 18, 2020
Mar 8, 2020

Repository files navigation

๐Ÿ›Œ๐ŸŽฃ Rest hooks

CircleCI Coverage Status npm downloads bundle size npm version PRs Welcome

Making dynamic sites performant, scalable, simple to build with any API design.

Simple TypeScript definition

class ArticleResource extends Resource {
  readonly id: number | undefined = undefined;
  readonly title: string = '';
  readonly body: string = '';

  pk() { return this.id; }
  static urlRoot = '/articles/';
}

One line data hookup

const article = useResource(ArticleResource.detailShape(), { id });
return (
  <>
    <h2>{article.title}</h2>
    <p>{article.body}</p>
  </>
);

Mutation

const update = useFetcher(ArticleResource.updateShape());
return <ArticleForm onSubmit={data => update({ id }, data)} />;

And subscriptions

const price = useResource(PriceResource.detailShape(), { symbol });
useSubscription(PriceResource.detailShape(), { symbol });
return price.value;

...all typed ...fast ...and consistent

For the small price of 8kb gziped.    ๐ŸGet started now

Features

  • TS Strong Typescript types
  • ๐Ÿ›Œ React Suspense support
  • โ›“๏ธ React Concurrent mode compatible
  • ๐ŸŽฃ Simple declarative API
  • ๐Ÿ’ฐ Normalized response configurable caching
  • ๐Ÿ’ฅ Tiny bundle footprint
  • ๐Ÿ›‘ Automatic overfetching elimination
  • โœจ Optimistic updates
  • ๐Ÿง˜ Flexible to fit any API design (one size fits all)
  • ๐ŸŒณ Tree-shakable (only use what you need)
  • ๐Ÿ” Subscriptions
  • โ™ป๏ธ Optional redux integration
  • ๐Ÿ“™ Storybook mocking
  • ๐Ÿ“ฑ React Native support
  • ๐Ÿšฏ Pluggable garbage collection policy

Special thanks

Thanks to @0xcaff, @melissafzhang and @alexiswolfish for their valuable feedback.

About

Delightful data fetching for React.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 68.9%
  • JavaScript 29.8%
  • CSS 1.3%