| sidebar_position |
|---|
5 |
GraphQL developement requires number of tools and packages that can be used on both client and server. Our target will be to provide comprehensive set of the tools to add graphql support for both client and server side applications
-
express-graphql- https://graphql.org/graphql-js/express-graphql Exposes GraphQL schema using Express.js -
GraphQL Tools- https://github.com/ardatan/graphql-tools Builds GraphQL schema using resolvers -
DataLoader- https://github.com/graphql/dataloader Prevents from overfetching data when querying relationships
-
GraphQL-Tag- https://github.com/apollographql/graphql-tag Compiles graphql schema on the client (provides browserify plugin) -
URQL- https://formidable.com/open-source/urql GraphQL Client with caching and offline support -
Apollo-Client- https://github.com/apollographql/apollo-client/ Alternative GraphQL Client with caching and offline support -
GraphQL-Code-Generator- https://graphql-code-generator.com Generates TypeScript source code for client and server
-
graphiql- https://github.com/graphql/graphiql Graphiql is web application that allows you to build and execute GraphQL queries against your schema -
GraphQL-CLIhttps://github.com/Urigo/graphql-cli Suite of tools and commands for performing various operations on GraphQL schema.
-
GraphQL Rules- https://graphql-rules.com/ Set of recomendations for building proper schema -
GraphQL CRUD- https://graphqlcrud.org Set of rules and generators to automate building GraphQL schema
When building GraphQL API from scratch we recomend using reference GraphQL-js reference implementation which was proven to be the most performant and have continous support from community. Entire development is currently backed by Linux foundation.
For GraphQL Server we recomend using GraphQL-Express for exposing GraphQL APIs over the network and GraphQL-Tools to build GraphQL Schema:
https://github.com/ardatan/graphql-tools#example
Developers can use top level database query languages. We recomend using Knex(http://knexjs.org/) for performing queries from GraphQL to relational databases.
If your GraphQL Schema contains relationships that can lead to "N+1 Problem", please consider using DataLoader library.
https://github.com/graphql/dataloader
Usage of the dataloader will be specific to your database/ORM solution.
For GraphQL client we recomend URQL that can work with React and any other JavaScript based library.
https://formidable.com/open-source/urql
When using module bundler we strongly recomend to compile your graphql queries using GraphQL-Tag:
https://github.com/apollographql/graphql-tag
If you use typescript in your project we recomend GraphQL-Code-Generator to generate typings for both client and server:
https://graphql-code-generator.com
For instrumentation and tracking we recomend using official OpenTelemetry package
https://www.npmjs.com/package/@opentelemetry/instrumentation-graphql
When building GraphQL API we often need to restrict it in terms of complexity and query rate.
For rejecting complex queries and detecting possible API missuse we recomend using
https://github.com/slicknode/graphql-query-complexity
For building fixed window rate limiting middleware for GraphQL we recomend
https://github.com/ravangen/graphql-rate-limit
When building GraphQL we can build our authorization logic inside resolvers. Developers can use any library or solution that is specific to their infrastructure. We recomend to follow official authorization guide:
https://graphql.org/learn/authorization
For Keycloak SSO users we recomend library that provides helpers and GraphQL directives for authorization and authentication:
https://github.com/aerogear/keycloak-connect-graphql
Persisted queries are mechanism to improve performance by utilizing already cached and well known queries. Those queries can be also later hosted on the CDN.
For persisted queries we can use approaches that are:
- Dynamic (no need to compile queries on client as server caches them)
- Static (requires client side compilation)
For static persited queries we recomend https://github.com/valu-digital/graphql-codegen-persisted-query-ids
For dynamic persisted queries we recomend
- Apollo APQs which needs Apollo server