Why a GraphQL endpoint rather than a schema file?

[njlr]

Why does the tool require a running endpoint or the output of the introspection query?

Wouldn't the GraphQL schema be enough?

This would make the build process simpler.

[Zaid-Ajaj]

Why does the tool require a running endpoint or the output of the introspection query?

Because a lot of the times you don't have control of the schema and you only have a running GraphQL backend

Wouldn't the GraphQL schema be enough?

Actually, if you have you a schema file definition, then that can be your input for the schema configuration. Just put the schema definition in a file with a .gql or .graphql extension and point the schema config to that file:

{
   "schema": "./schema-definition.gql" 
}  

Maybe I forgot to actually document that part 🤔

[njlr]

Makes sense!

PR for the docs: #5

[Zaid-Ajaj]

Fixed and the docs are now in the README