{"id":15192468,"url":"https://github.com/code-hex/gqldoc","last_synced_at":"2025-10-02T08:30:48.915Z","repository":{"id":37744564,"uuid":"347399720","full_name":"Code-Hex/gqldoc","owner":"Code-Hex","description":"The easiest way to make API documents for GraphQL","archived":true,"fork":false,"pushed_at":"2024-04-01T05:46:24.000Z","size":126665,"stargazers_count":192,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-16T13:29:10.797Z","etag":null,"topics":["documentation","go","golang","graphql","graphql-endpoint","graphql-schema"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Code-Hex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-13T14:59:39.000Z","updated_at":"2024-08-03T23:40:01.000Z","dependencies_parsed_at":"2023-02-17T02:01:08.644Z","dependency_job_id":"d546f392-8714-4178-81fa-d062fa6059f4","html_url":"https://github.com/Code-Hex/gqldoc","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Hex%2Fgqldoc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Hex%2Fgqldoc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Hex%2Fgqldoc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Code-Hex%2Fgqldoc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Code-Hex","download_url":"https://codeload.github.com/Code-Hex/gqldoc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234957753,"owners_count":18913343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["documentation","go","golang","graphql","graphql-endpoint","graphql-schema"],"created_at":"2024-09-27T21:40:25.465Z","updated_at":"2025-10-02T08:30:42.650Z","avatar_url":"https://github.com/Code-Hex.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Document Generator for GraphQL\n\n\u003e gqldoc is now alpha\n\ngqldoc 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.\n\n## Demo\n\n- [Star Wars API](example/starwars)\n- [Github V4 API](example/github)\n  - Public schema is [here](https://docs.github.com/en/graphql/overview/public-schema)\n\n## How to use\n\n### Generate docs from graphql endpoint\n\nYou need to enable GraphQL [Introspection](https://graphql.org/learn/introspection/). `--header` and `--query` options are supported.\n\n```sh\n$ gqldoc -e http://127.0.0.1:8081/query --header 'Authorization: Bearer token' -o ./doc_dir\n```\n\n### Generate docs from graphql schema files\n\nSupported `.json` and `.graphql`, `.gql` extensions. `.json` must be contained the result of introspection.\n\n```sh\n$ gqldoc -s schema.graphql -o ./doc_dir\n```\n\nIf you want to specify multiple schema, you can use `--schema` flag repeatedly.\n\n```sh\n$ gqldoc -s a.graphql -s b.graphql -o ./doc_dir\n```\n\nYou can also use glob.\n\n```sh\n$ gqldoc -s \"schema/**/*.graphql\" -o ./doc_dir\n```\n\n## Installation\n\n### Mac and Linux users via Homebrew\n\n```sh\n$ brew install Code-Hex/tap/gqldoc\n```\n\n### Manually via go command\n\nAgain, this tool is supported Go 1.16 and above. If you are one of those users, you can install like below.\n\n```sh\n$ go install github.com/Code-Hex/gqldoc/cmd/gqldoc@latest\n```\n\n### Manually download\n\nYou can download binary from [here](https://github.com/Code-Hex/gqldoc/releases)\n\n## Todo\n\nThis todo list is written the order of priority.\n\n- [x] ~~GitHub Actions for this~~ **Available**\n  - Update document and push it to current branch If target schema has diff\n  - https://github.com/Code-Hex/gqldoc-actions\n- [ ] Subscription\n- [ ] Directive and it's location.\n- [x] ~~Put README.md in output directory~~\n  - TOC purpose\n- [ ] Custom Template\n- [ ] Render HTML\n  - I'm wondering if I should really support this feature.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-hex%2Fgqldoc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode-hex%2Fgqldoc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-hex%2Fgqldoc/lists"}