# graphql-hive/graphql-modules

Enterprise Grade Tooling For Your GraphQL Server

Repository: https://github.com/graphql-hive/graphql-modules
Canonical: https://ross.abutalabs.com/products/graphql-modules
Homepage: https://graphql-modules.com/
Language: TypeScript
License: MIT
License Family: permissive
Topics: graphql, graphql-server, apollo, apollo-server, modules, typescript, dependency-injection
Last push: 2026-07-12T08:59:17+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 92, release rhythm 62, longevity 100
- inputs: {"age_days": 3037, "days_push": 52, "days_rel": 99, "gap_med": 119, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1327, forks 113 (observed 2026-08-28T04:04:22.905972+00:00)

## What it is
GraphQL Modules is a TypeScript library for building reusable, testable, and maintainable modules out of a GraphQL server's schema and resolvers. It supports schema-first design, dependency injection, middlewares, and a unified runtime schema composed from independently developed modules.

## Use cases
- split a large GraphQL schema into reusable modules
- add dependency injection to GraphQL resolvers
- structure a GraphQL server for multiple teams
- test and mock GraphQL modules in isolation
- gradually scale a single-file GraphQL API
- share GraphQL modules between apps and microservices

## When to choose
- your GraphQL server is growing large and needs modular separation of concerns
- you want schema-first design with typed TypeScript resolvers
- you need dependency injection and testability in your GraphQL backend
- multiple teams work on different parts of one GraphQL API

## When to avoid
- you have a small, simple GraphQL API that doesn't need modular structure
- you want full schema federation across independent services rather than modular composition
- your stack is not JavaScript/TypeScript

## Facets
- artifact type: library
- maturity: stable
- function: graphql, api-framework, middleware, testing, mocking
- domain: web-development, backend, apis, developer-tools
- platform: cross-platform
- tags: graphql-server, schema-first, dependency-injection, modular-architecture, the-guild, nodejs, typescript

## Member repositories
- graphql-hive/graphql-modules (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:22.905972+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:46:17.251827+00:00, confidence not recorded.
  - readme: https://github.com/graphql-hive/graphql-modules (fetched 2026-08-28T04:04:22.905972+00:00, sha b2e9d51f5c9f)
  - homepage: https://graphql-modules.com/ (fetched 2026-08-29T12:05:35.044880+00:00, sha 2bdb1132e7cf)
  - site_page: https://the-guild.dev/graphql/modules/docs (fetched 2026-08-29T12:05:35.051067+00:00, sha 2d39d4a88a25)
  - site_page: https://the-guild.dev/about-us (fetched 2026-08-29T12:05:35.053463+00:00, sha 4c4f11519fb9)
  - site_page: https://the-guild.dev/graphql/modules/docs/get-started (fetched 2026-08-29T12:05:35.057131+00:00, sha 38ab79032bc4)
  - site_page: https://the-guild.dev/graphql/modules/docs/essentials/type-definitions (fetched 2026-08-29T12:05:35.061789+00:00, sha 47a50a2fe7a7)
  - site_page: https://the-guild.dev/graphql/modules/docs/essentials/resolvers (fetched 2026-08-29T12:05:35.065907+00:00, sha 61a9dcd8a2cb)
  - site_page: https://the-guild.dev/graphql/modules/docs/essentials/context (fetched 2026-08-29T12:05:35.069108+00:00, sha 7a083b26b399)
  - site_page: https://the-guild.dev/graphql/modules/docs/essentials/type-safety (fetched 2026-08-29T12:05:35.071581+00:00, sha af8e11cea6c7)
  - site_page: https://the-guild.dev/graphql/modules/changelog (fetched 2026-08-29T12:05:35.048419+00:00, sha 740762eb6ad3)
- Data as of 2026-08-30T08:39:29.467469+00:00.