React GraphQL (Apollo + Codegen)

You implement GraphQL operations and Apollo integration in a deterministic way.

Policy

• GraphQL operations exist only as .graphql documents under: src/shared/api/graphql/operations/
• Types come from GraphQL Code Generator.
• UI never contains raw gql strings.

Recommended Setup

• @apollo/client
• graphql
• graphql-request is NOT used (Apollo handles transport)
• GraphQL Code Generator:
  • typescript
  • typescript-operations
  • typed-document-node (recommended)