nestjs

nestjs/graphql

TypeScript MIT Web Dev

GraphQL (TypeScript) module for Nest framework (node.js) 🍷

1.6k stars
428 forks
active
GitHub +1 / week

1.6k

Stars

428

Forks

37

Open issues

30

Contributors

v13.4.2 21 May 2026

AI Analysis

GraphQL module for NestJS that enables efficient, type-safe GraphQL server development in TypeScript within the NestJS ecosystem. It's specifically designed for developers building GraphQL APIs using NestJS, offering end-to-end typing and integration with Apollo GraphQL. Not a general GraphQL library—it targets NestJS developers exclusively and requires familiarity with the NestJS framework.

Web Dev Library Discovery value: 3/10
Documentation 7/10
Activity 9/10
Community 8/10
Code quality 7/10

Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.

Overall score 8/10

AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.

graphql nestjs typescript apollo server-side
Actively maintained MIT licensed Popular Niche/specialized use case Production ready
Deep Analysis · Based on README and public signals
4d ago

TypeScript-first GraphQL integration for NestJS, tightly coupled to the framework ecosystem

@nestjs/graphql is the official GraphQL module for NestJS, providing decorator-based schema definition and resolver patterns. It targets Node.js backend teams already committed to NestJS and seeking type-safe GraphQL without boilerplate. Adoption is concentrated within the NestJS community rather than the broader GraphQL ecosystem. The module is actively maintained as part of the core NestJS framework family.

Origin

Created December 2017 as NestJS expanded beyond REST patterns. Evolved to support multiple GraphQL execution engines (Apollo Server, Mercurius) and schema-first vs code-first approaches. Represents NestJS's effort to provide opinionated, integrated solutions across API paradigms.

Growth

Growth appears tied directly to NestJS adoption. Star count (1,549) reflects narrow positioning as a framework module rather than independent tool. No meaningful growth in past 7 days suggests stable rather than expanding adoption. Positioned as standard choice for GraphQL within NestJS rather than competing for broader market share.

In production

Adoption not verified through README, but contextual evidence suggests production use: (1) official NestJS module status implies integrations by NestJS adopters; (2) comparison repos (typeorm 2,142 stars, swagger 1,880 stars) suggest similar adoption pattern for framework-specific modules; (3) MIT license and clear documentation structure indicate production-ready intent. Concrete user counts or case studies not provided in README.

Code analysis
Architecture

Based on README, appears to use decorator-driven architecture consistent with NestJS patterns. Likely supports both code-first (decorators) and schema-first (SDL) approaches. Abstracts underlying GraphQL engines (Apollo, Mercurius) through adapter pattern. Cannot assess implementation depth without code inspection.

Tests

Not documented in README excerpt provided.

Maintenance

Last push 2026-07-06 (same day as analysis date) indicates active maintenance. Repository created 2017-12-15 shows 8+ year history. Organized under official nestjs GitHub org. No indication of stagnation; appears to receive regular updates aligned with NestJS core releases. Slow star growth typical of mature, narrowly-scoped framework module rather than indicator of abandonment.

Honest verdict

ADOPT IF: you are building GraphQL APIs within NestJS and want type-safe resolvers with minimal boilerplate via decorators; decorator-first workflow and DI integration are priorities. AVOID IF: you need GraphQL framework independence, want to evaluate multiple execution engines without vendor lock-in to NestJS patterns, or prefer minimal framework coupling. MONITOR IF: you're considering NestJS + GraphQL but haven't committed to NestJS yet—evaluate whether NestJS's architecture and module ecosystem fit your team first; @nestjs/graphql quality depends on that decision.

Independent dimensions

Mainstream potential

3/10

Technical importance

6/10

Adoption evidence

4/10

Risks
  • Tight coupling to NestJS means breaking changes to NestJS core or major version bumps create friction. Adoption limited to NestJS ecosystem rather than portable across frameworks.
  • README does not document schema complexity limits, query depth restrictions, N+1 query prevention patterns, or DataLoader integration strategy. Performance characteristics unclear.
  • Star growth flat (0 gained in last 7 days) may indicate saturation within NestJS community or reduced active expansion. Cannot distinguish between 'stable maturity' and 'low growth trajectory' from metrics alone.
  • Official module status creates expectation of long-term maintenance but also potential for maintenance burden to shift if NestJS team priorities change.
  • No evidence in README of multi-tenancy patterns, federation support, or advanced schema composition. Likely serves standard GraphQL use cases but limits on enterprise patterns unclear.
Prediction

Will remain the standard GraphQL integration for NestJS—maintenance and adoption tied to NestJS framework health. Unlikely to expand beyond NestJS ecosystem or achieve independent prominence in broader GraphQL tooling category. Steady, modest adoption within narrowing niche rather than growth-phase trajectory.

0 found this helpful

Newsletter

Get analyses like this every Monday

Free weekly digest of the most interesting open-source discoveries.

Languages

TypeScript
99.7%
JavaScript
0.3%

Information

Language
TypeScript
License
MIT
Last updated
16h ago
Created
104mo ago
Analyzed with
anthropic/claude-haiku-4-5

Stars over time

Loading…

Contributors over time

Top 100 contributors only — repos with more will plateau at 100.

Loading…

Similar repos

nestjs

nestjs/typeorm

TypeORM module for NestJS that enables seamless integration of TypeORM (a...

2.1k TypeScript Web Dev
nestjs

nestjs/nest

NestJS is a TypeScript-first Node.js server-side framework that combines OOP,...

76.2k TypeScript Web Dev
nestjs

nestjs/swagger

This is an OpenAPI (Swagger) integration module for NestJS, enabling developers...

1.9k TypeScript Dev Tools
graphql

graphql/graphql-js

GraphQL.js is the official JavaScript reference implementation of GraphQL, a...

20.4k TypeScript Web Dev
nestjs

nestjs/nest-cli

The Nest CLI is a command-line tool for initializing, developing, and...

2.2k TypeScript Dev Tools
vs. alternatives
Apollo Server + graphql-js

Language-agnostic, framework-independent GraphQL server. Broader adoption outside NestJS but requires manual resolver/schema integration. @nestjs/graphql adds framework conventions and decorators at cost of NestJS coupling.

nestjs/swagger

Similar ecosystem position (1,880 stars vs 1,549). Swagger module shows framework-specific modules can achieve moderate adoption. Both serve framework users, not competing for broader markets.

Mercurius (Fastify GraphQL)

Framework-specific alternative for Fastify. @nestjs/graphql likely achieves higher adoption due to NestJS's larger userbase, but both follow framework-coupled design pattern.

TypeGraphQL

Standalone TypeScript-first GraphQL library with decorator support. Works with any Node.js framework but smaller ecosystem than NestJS. @nestjs/graphql integrates more tightly with NestJS middleware and DI.

Hasura / PostGraphile

Schema-generation from databases. Solves different problem (rapid schema generation) vs @nestjs/graphql (manual schema with type safety). Not direct competitors.