gqldoc is now alpha

gqldoc is command line tool to generate documents from GraphQL schema or your GraphQL endpoint. the command is written by Go 1.16. So You need Go 1.16 and above If you want to build.

• Star Wars API
• Github V4 API
  • Public schema is here

You need to enable GraphQL Introspection. --header and --query options are supported.

$ gqldoc -e http://127.0.0.1:8081/query --header 'Authorization: Bearer token' -o ./doc_dir

Supported .json and .graphql, .gql extensions. .json must be contained the result of introspection.

$ gqldoc -s schema.graphql -o ./doc_dir

If you want to specify multiple schema, you can use --schema flag repeatedly.

$ gqldoc -s a.graphql -s b.graphql -o ./doc_dir

You can also use glob.

$ gqldoc -s "schema/**/*.graphql" -o ./doc_dir

$ brew install Code-Hex/tap/gqldoc

Again, this tool is supported Go 1.16 and above. If you are one of those users, you can install like below.

$ go install github.com/Code-Hex/gqldoc/cmd/gqldoc@latest

You can download binary from here

This todo list is written the order of priority.

• GitHub Actions for this Available
  • Update document and push it to current branch If target schema has diff
  • https://github.com/Code-Hex/gqldoc-actions
• Subscription
• Directive and it's location.
• Put README.md in output directory
  • TOC purpose
• Custom Template
• Render HTML
  • I'm wondering if I should really support this feature.