v0CLI Commands
⚠️
This is the documentation for the old GraphQL Mesh version v0. We recommend upgrading to the latest GraphQL Mesh version v1.

Migrate to GraphQL Mesh v1

CLI commands

Global Options

All commands can take two global optional options.

-r (alias: require) [array]

Loads specific require.extensions before running the codegen and reading the configuration.

yarn graphql-mesh -r lodash
yarn graphql-mesh --require lodash fluke2

--dir [string]

Used to modify the base directory for looking for a .meshrc config file.

yarn graphql-mesh --dir ./mystuff/meshproject

List of Commands

mesh dev

Serves a GraphQL server with a GraphQL interface to test your Mesh API locally.

Can have an optional --port argument.

💡
GraphQL Mesh does not currently support hot reloading.

Options

--port [number]

The system port on which graphql-mesh will be made available.

This should be one of the normal system ports [1-65386] not currently used by any other service.

yarn graphql-mesh dev --port 4002

mesh build

Builds artifacts required to use mesh start for a gateway (production) server or SDK.

Can have --throwOnInvalidConfig to make CLI throw in case of an invalid configuration. By default, CLI gives a warning and continues.

mesh validate

Validate the built artifacts (mesh build) required to use mesh start for a gateway (production) server. The validation will check the following:

More information about this on the Mesh deployment page.

mesh start

Serves a GraphQL server using the built artifacts. mesh start compared to mesh dev does not rely on the sources to build the schema. Instead, it uses the built artifacts. Therefore, mesh start is recommended to start a mesh server in production.

More information about mesh start on the Mesh deployment page.

Can have an optional --port argument.

Options

--port [number]

The system port on which graphql-mesh will be made available.

This should be one of the normal system ports [1-65386] not currently used by any other service.

yarn graphql-mesh start --port 4002

mesh serve-source

serve-source helps with quickly assessing that Mesh properly ingests a source. Given a source name as the only argument, Mesh will serve a GraphQL API only exposing the given source.

This command is handy to debug a source.

Example

Given the following configuration:

.meshrc.yaml
sources:
  - name: Cities
    handler:
      openapi:
        source: https://api.apis.guru/v2/specs/mashape.com/geodb/1.0.0/swagger.json
    transforms:
      - rename:
          - from:
              type: Error
            to:
              type: CitiesError
 
  - name: Weather
    handler:
      openapi:
        source: https://api.apis.guru/v2/specs/weatherbit.io/2.0.0/swagger.json
    transforms:
      - rename:
          - from:
              type: Error
            to:
              type: WeatherError

You can test that the “Weather” source is properly ingested by mesh by running:

yarn graphql-mesh serve-source Weather

Then, Mesh will serve a GraphQL API only exposing the “Weather” source.