Dynamic documentation for GraphQL endpoints

Downloads in past


0.2.07 years ago8 years agoMinified + gzip package size for graphql-docs in KB


GraphQL Documentation Explorer
Dynamically generated documentation explorer for GraphQL schemas. It aims to provide a better overview of a schema than GraphiQL, but without querying features.
Build Status npm
Example Screenshot

Installation and usage

GraphQL-Docs supports both a dynamic mode and a static mode. In dynamic mode, GraphQL-Docs tries to work similarly to GraphiQL. Either use the minified files from GitHub:
<script src=""></script>
<!-- Note that you need to include React and ReactDOM *before* this script tag -->

Or download it into your own package via NPM:
npm install --save graphql-docs

GraphQL-Docs exposes a single React component that requires a function to run a query against a server and return a Promise with the result:
function fetcher(query) {
    return fetch(window.location.origin + '/graphql', {
        method: 'POST',
        headers: {
            Accept: 'application/json',
            'Content-Type': 'application/json',
        body: JSON.stringify({
            query: query,
    }).then(function(r) {
        return r.json();

ReactDOM.render(<GraphQLDocs.GraphQLDocs fetcher={fetcher} />, document.body);

All CSS is included in the Javascript code, so no other dependencies are required. You can find examples of both the first and second paradigms in the examples folder.

Static documentation generation

You can also generate a static documentation file based on a schema file or GraphQL endpoint:
npm install -g graphql-docs

graphql-docs-gen http://GRAPHQL_ENDPOINT documentation.html


  • Markdown rendered documentation (using
  • All types and fields are recursively searched from the schema's root query and
mutation objects. Types that can't be queried are not included.
  • Field arguments listed in separate tables in the cases where they do contain
a description.

Planned features

  • Improved layout with some sort of navigation
  • On-page search