Schema with multiple files

In my case, my schema is separeted in multiple files as the image below

Currently is possible generate a markdown when have a case like mine? I tried add multiple files as parameter, but I got error.

The solution in my case was transfer content of all the files to schema.graphql and use the graphql-markdown to generate a file.md.

My suggestion is create a possibility to this case when have a schema splited in multiple files. Make sense? It’s possible?

[hiagolcm]

I joined all .graphql files programmatically using some extra libs. And then attached it to a git hook

const fs = require('fs')

const { loadFilesSync } = require('@graphql-tools/load-files')
const { mergeTypeDefs } = require('@graphql-tools/merge')
const graphql = require('graphql')
const {
 loadSchemaJSON,
 renderSchema,
} = require('graphql-markdown')

const SCHEMA_PATH = `${__dirname}/../graphql/**/*.graphql`
const BUNDLE_PATH = `${__dirname}/../joined.graphql`
const MARKDOWN_PATH = `${__dirname}/../docs/README.md`

;(async () => {
 // Generate bundle
 const loadedFiles = loadFilesSync(SCHEMA_PATH)
 const typeDefs = mergeTypeDefs(loadedFiles)
 const printedTypeDefs = graphql.print(typeDefs)
 fs.writeFileSync(BUNDLE_PATH, printedTypeDefs)

 // Generate markdown
 fs.unlinkSync(MARKDOWN_PATH)
 const schema = await loadSchemaJSON(BUNDLE_PATH, { graphql })
 renderSchema(schema, {
   printer: (doc) => fs.appendFileSync(MARKDOWN_PATH, doc)
 })

 // Delete temp file
 fs.unlinkSync(BUNDLE_PATH)
})()

[nextdude-mdsol]

@wagnerlduarte @GabrielBarross not really, but

cat types/*.graphql | graphql-markdown /dev/stdin

might work if your system is linux or mac (has /dev/stdin). Basically, you’re limited to a single file given how graphql-markdown parses its arguments. This example combines your files and pipes the resulting output to graphql-markdown passing in dev./stdin as the file (which represents the piped input).