rest-hooks

🛌🎣 Rest hooks

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

📖Read The Docs  |  🏁Getting Started  |  🎮Demo

Simple TypeScript definition

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

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

One line data hookup

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

And mutation

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

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

For the small price of 6kb gziped.    🏁Get started now

Features

• Strong Typescript types
• 🚦 React Suspense support
• 🎣 Simple declarative API
• 💰 Normalized response caching
• 💥 Tiny bundle footprint
• 🛑 Automatic overfetching elimination
• ✨ Optimistic updates
• 🧘 Flexible to fit any API design (one size fits all)
• 🚯 Pluggable garbage collection policy
• 🔁 Subscriptions
• ♻️ Optional redux integration
• 📙 Storybook mocking

Special thanks

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