National Preventative Mechanism

    recoil-relay
    TypeScript icon, indicating that this package has built-in type declarations

    0.1.0 • Public • Published

    Recoil Relay · NPM Version Node.js CI GitHub license Follow on Twitter

    The recoil-relay library helps Recoil perform type safe and efficient queries using GraphQL with the Relay library.

    Please see the Recoil Relay GraphQL Documentation

    recoil-relay provides graphQLSelector() and graphQLSelectorFamily() selectors which can easily query with GraphQL. The queries are synced with the Recoil data-flow graph so downstream selectors can derive state from them, they can depend on upstream Recoil state, and they are automatically subscribed to any changes in the graph from Relay. Everything stays in sync automatically.

    Example

    After setting up your Relay environment adding a GraphQL query is as simple as defining a GraphQL selector.

    const userNameQuery = graphQLSelector({
      key: 'UserName',
      environment: myEnvironment,
      query: graphql`
        query UserQuery($id: ID!) {
          user(id: $id) {
            name
          }
        }
      `,
      variables: ({get}) => ({id: get(currentIDAtom)}),
      mapResponse: data => data.user?.name,
    });

    Then use it like any other Recoil selector:

    function MyComponent() {
      const userName = useRecoilValue(userNameQuery);
      return <span>{userName}</span>;
    }

    Installation

    Please see the Recoil installation guide for installing Recoil and the Relay documentation for installing and setting up the Relay library, GraphQL compiler, Babel plugin, and ESLint plugin. Then add recoil-relay as a dependency.

    Contributing

    Development of Recoil happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving Recoil.

    License

    Recoil is MIT licensed.

    Keywords

    none

    Install

    npm i recoil-relay

    DownloadsWeekly Downloads

    168

    Version

    0.1.0

    License

    MIT

    Unpacked Size

    207 kB

    Total Files

    36

    Last publish

    Collaborators

    • mondaychen
    • drarmstr