thecactusblue / react-cell

Redwood Cells, but without Redwood and with TypeScript

react-cell

🔋 Declarative React Components that fetch GraphQL. Inspired by Redwood Cells, using Apollo Client.

Getting started

yarn add react-cell

Features

• 🍱 Structured declaration for components
• 📘 First-class TypeScript support
• 🚀 Apollo-based GraphQL queries
• ⚡ Only peer dependencies

Usage

import cell from 'react-cell';
import { gql } from '@apollo/client';

interface NovelCellProps {
  title: string;
}

const QUERY = gql`
query($title: String) {
  novel(title: $title) {
    title
    description
  }
}`;

// props are passed onto the query as variables
const NovelCell = cell<{ novel: Novel }, NovelCellProps>(QUERY, {
  Success({ novel }) {
    return (
      <div>
        <h1>{novel.title}</h1>
        <h1>{novel.description}</h1>
      </div>
    );
  },

  // While your query is executing.
  Loading: () =>
    <div>Loading...</div>,

  // Renders if your query results in null or an empty array.
  Empty: () =>
    <div>Found nothing.</div>,

  // This renders if your query results in an error.
  Failure: ({ error }) =>
    <div>Error: {error.message}</div>
});

<NovelCell title="Title here">

react-cell's Issues

Allow passing options to useQuery

I would like to use polling to have a 'reactive' cell. The current implementation does not support this. I propose allowing to pass a third, optional argument that gets used as 'options' argument for the useQuery apollo hook.