EVERYTHING XIAOMI
Get listed

GraphQL Docs

GraphQL Docs is a free, self-hosted web explorer for documenting GraphQL schemas.

Place
#26 of 27
Score
5.6
GraphQL Docs's website

What GraphQL Docs is

GraphQL Docs is a free, self-hosted web explorer for documenting GraphQL schemas. It focuses on presenting a schema overview rather than providing GraphiQL-style querying. The project supports dynamic documentation and static generation. Its command-line generator creates a static HTML documentation file from a schema file or GraphQL endpoint. The explorer renders Markdown descriptions and recursively follows types and fields reachable from the schema’s root query and mutation objects. Described field arguments appear in separate tables, while types that cannot be queried are excluded. A React component is available and requires a fetcher function that queries a server and returns a Promise. Installation is documented through npm, with minified files also available from GitHub releases. CSS is included in the JavaScript for its styling. Package metadata specifies Node.js 4.4.0 or higher and React and ReactDOM peer dependencies at version 15.0.1 or higher within the stated range. The repository uses the MIT license.

Good

  • Free and self-hosted
  • Supports dynamic and static documentation
  • Generates static HTML from schemas or endpoints
  • Renders Markdown descriptions
  • Provides a React component

Watch out

  • Does not include querying features
  • Excludes types that cannot be queried
  • React component requires a fetcher function
  • Planned navigation and search remain listed features

Who it suits

It suits developers and teams who need self-hosted GraphQL schema documentation in dynamic or static form, without query execution features.

Verdict

GraphQL Docs provides focused schema exploration and static publishing for GraphQL projects. It is not a query tool, and its explorer omits unreachable types.

The facts

Each one read from GraphQL Docs's own pages, with the date it was checked.

What it does

Dependencies
The README says the CSS is included in the JavaScript code, so no other dependencies are required for that styling.checked 4 Oct 2026
Documentation features
The explorer renders Markdown documentation and recursively searches types and fields reachable from the schema’s root query and mutation objects.checked 4 Oct 2026
Field arguments
Field arguments with descriptions are listed in separate tables.checked 9 Oct 2026
Installation
The project can be installed from NPM as graphql-docs.checked 9 Oct 2026
License
The repository identifies its license as MIT.checked 9 Oct 2026
Limit
The project README says GraphQL Docs does not include querying features.checked 9 Oct 2026
Notable limits
Types that cannot be queried are excluded from the explorer.checked 4 Oct 2026
Operating modes
It supports dynamic and static documentation modes.checked 4 Oct 2026
Package compatibility
The package metadata specifies Node.js version 4.4.0 or higher and React and ReactDOM peer dependencies at version 15.0.1 or higher within the stated range.checked 4 Oct 2026
Purpose
GraphQL Docs is a documentation explorer for GraphQL schemas.checked 9 Oct 2026
React component
In dynamic mode, it exposes a React component that requires a function to run a query against a server and return a Promise.checked 9 Oct 2026
Rendered descriptions
Documentation is rendered as Markdown using Marked.checked 9 Oct 2026
Schema overview
It aims to provide a better overview of a schema than GraphiQL, without GraphiQL’s querying features.checked 9 Oct 2026
Schema traversal
It recursively searches types and fields reachable from the schema’s root query and mutation objects, excluding types that can’t be queried.checked 9 Oct 2026
Scope
The project says it aims to give a better schema overview than GraphiQL, without querying features.checked 4 Oct 2026
Static generation
The command-line generator can create a static HTML documentation file from a schema file or GraphQL endpoint.checked 4 Oct 2026
Static output
The command line generator can create a static HTML documentation file from a schema file or GraphQL endpoint.checked 9 Oct 2026
Usage modes
It supports dynamic and static documentation modes.checked 9 Oct 2026

The company

Maker
The package metadata names Magnus Hallin as the author.checked 4 Oct 2026

Money

Planned features
Improved navigation and on-page search are listed as planned features.checked 9 Oct 2026

Alternatives to GraphQL Docs

All alternatives
  1. 1Mintlify logo

    Mintlify

    Free planWebAPILinuxmacOS
    8.0From $450 a month
  2. 2

    Fern

    Free planOpen sourceWebAPILinuxmacOS
    7.8Free plan
  3. 3DocPlatform logo

    DocPlatform

    Free planWebAPILinuxmacOS
    7.7From $29 a month
  4. 4VitePress logo

    VitePress

    Free planOpen sourceWebAPILinuxmacOS
    7.7Free plan
  5. 5GitBook logo

    GitBook

    Free planWebAPI
    7.6From $65 a month
  6. 6Documentation.AI logo

    Documentation.AI

    Free planWebAPI
    7.4From $55 a month