Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/launchport/graphdoc

Generate beautiful documentantion for your/any GraphQL API in an instant ✨
https://github.com/launchport/graphdoc

documentation documentation-generator generator graphql

Last synced: about 1 month ago
JSON representation

Generate beautiful documentantion for your/any GraphQL API in an instant ✨

Awesome Lists containing this project

README

        

**Instant, beautiful docs for your GraphQL API**

---

## Providing a custom configuration

GraphDoc will check for a the existence of `.well-known/graphql.json` file on the same domain as your GraphQL API. So if your API runs on `https://api.example.com/graphql` the config will be expected at `https://api.example.com/.well-known/graphql.json`.

### Example configuration

```json
{
"title": "My GraphQL API",
"description": "Awesome API that provides a ton of value.",
"favicon_url": "http://static.example.com/favicon.ico",
"logo_light_url": "http://static.example.com/logo-light.svg",
"logo_dark_url": "http://static.example.com/logo-dark.svg",
"headers": {
"Authorization": "Bearer MyPublicSecret"
}
}
```

## Issues

If you have any issues regarding rendering your GraphQL API, [don't hesitate to report it here](https://github.com/launchport/graphdoc/issues).