gatsby-cli

The Gatsby command line interface (CLI). It is used to perform common functionality, such as creating a Gatsby application based on a starter, spinning up a hot-reloading local development server, and more!

Lets you create new Gatsby apps using Gatsby starters. It also lets you run commands on sites. The tool runs code from the gatsby package installed locally.

The Gatsby CLI (gatsby-cli) is packaged as an executable that can be used globally. The Gatsby CLI is available via npm and should be installed globally by running npm install -g gatsby-cli to use it locally.

Run gatsby --help for full help.

You can also use the package.json script variant of these commands, typically exposed for you with most starters. For example, if we want to make the gatsby develop command available in our application, we would open up package.json and add a script like so:

{
  "scripts": {
    "develop": "gatsby develop"
  }
}

`new`

gatsby new [<site-name> [<starter-url>]]

Argument	Description
site-name	Your Gatsby site name, which is also used to create the project directory.
starter-url	A Gatsby starter URL or local file path. Defaults to gatsby-starter-default; see the Gatsby starters docs for more information.

Note: The site-name should only consist of letters and numbers. If you specify a ., ./ or a <space> in the name, gatsby new will throw an error.

Examples

Create a Gatsby site named my-awesome-site, using the default starter:

gatsby new my-awesome-site

Create a Gatsby site named my-awesome-blog-site, using gatsby-starter-blog:

gatsby new my-awesome-blog-site https://github.com/gatsbyjs/gatsby-starter-blog

If you leave out both of the arguments, the CLI will run an interactive shell asking for these inputs:

gatsby new
? What is your project called? › my-gatsby-project
? What starter would you like to use? › - Use arrow-keys. Return to submit.
❯  gatsby-starter-default
   gatsby-starter-hello-world
   gatsby-starter-blog
   (Use a different starter)

See the Gatsby starters docs for more details.

`develop`

At the root of a Gatsby app run gatsby develop to start the Gatsby development server.

Options

Option	Description	Default
`-H`, `--host`	Set host.	`localhost`
`-p`, `--port`	Set port.	`env.PORT` or `8000`
`-o`, `--open`	Open the site in your (default) browser for you
`-S`, `--https`	Use HTTPS

Follow the Local HTTPS guide to find out how you can set up an HTTPS development server using Gatsby.

`build`

At the root of a Gatsby app run gatsby build to do a production build of a site.

Options

Option	Description	Default
`--prefix-paths`	Build site with link paths prefixed (set pathPrefix in your config)	`env.PREFIX_PATHS` or `false`
`--no-uglify`	Build site without uglifying JS bundles (for debugging)	`false`
`--profile`	Build site with react profiling. See https://www.gatsbyjs.org/docs/profiling-site-performance-with-react-profiler/	`false`
`--open-tracing-config-file`	Tracer configuration file (OpenTracing compatible). See https://www.gatsbyjs.org/docs/performance-tracing/
`--no-color`, `--no-colors`	Disables colored terminal output	`false`

For prefixing paths, most will want to use the CLI flag (gatsby build --prefix-paths). For environments where you can't pass the --prefix-paths flag (ie Gatsby Cloud),the environment variable PREFIX_PATHS can be set to true to provide another way to prefix paths.

`serve`

At the root of a Gatsby app run gatsby serve to serve the production build of the site

Options

Option	Description	Default
`-H`, `--host`	Set host. Defaults to localhost
`-p`, `--port`	Set port. Defaults to 9000
`-o`, `--open`	Open the site in your (default) browser for you
`--prefix-paths`	Serve site with link paths prefixed (if built with pathPrefix in your gatsby-config.js).	`env.PREFIX_PATHS` or `false`

`clean`

At the root of a Gatsby app run gatsby clean to wipe out the cache (.cache folder) and public directories. This is useful as a last resort when your local project seems to have issues or content does not seem to be refreshing. Issues this may fix commonly include:

Stale data, e.g. this file/resource/etc. isn't appearing
GraphQL error, e.g. this GraphQL resource should be present but is not
Dependency issues, e.g. invalid version, cryptic errors in console, etc.
Plugin issues, e.g. developing a local plugin and changes don't seem to be taking effect

`plugin`

Run commands pertaining to gatsby plugins.

`docs`

gatsby plugin docs

Directs you to documentation about using and creating plugins.

`info`

At the root of a Gatsby site run gatsby info to get helpful environment information which will be required when reporting a bug.

Options

Option	Description	Default
`-C`, `--clipboard`	Automagically copy environment information to clipboard	`false`

`repl`

Get a node repl with context of Gatsby environment

Current Tags

2.8.28-berry-mdx.26 ... berry-mdx (6 years ago)
1.2.0-alphasldfjsljfd ... beta (8 years ago)
2.11.4-alpha.53 ... canary (6 years ago)
2.7.41-cli-postinstall.73 ... cli-postinstall (6 years ago)
2.8.1-cli-react-dom.20 ... cli-react-dom (6 years ago)
2.8.30-cli-react-from-ink.158 ... cli-react-from-ink (6 years ago)
2.12.25-cli-ts.23 ... cli-ts (6 years ago)
2.11.18-cli-ux.2 ... cli-ux (6 years ago)
2.5.7-clipboardy.1 ... clipboardy (7 years ago)
2.6.8-error-codes.71 ... error-codes (6 years ago)
2.5.9-ink.61 ... ink (7 years ago)
2.6.1-ink-node6.16 ... ink-node6 (7 years ago)
2.7.25-jarmo.4 ... jarmo (6 years ago)
2.12.45 ... latest (6 years ago)
2.7.41-otp-test.31 ... otp-test (6 years ago)
2.6.13-process-develop.5 ... process-develop (6 years ago)
2.11.3-prompt-restart.96 ... prompt-restart (6 years ago)
2.11.4-recipes.53 ... recipes (6 years ago)
2.6.11-reporter-npm.8 ... reporter-npm (6 years ago)
2.10.14-state-machine.77 ... state-machine (6 years ago)
2.7.1-structured-logs.161 ... structured-logs (6 years ago)
2.7.1-structured-logs-test.128 ... structured-logs-test (6 years ago)

125 Versions

3.2.0-next.1 ... 5 years ago
2.19.0-next.1 ... 5 years ago
2.12.67 ... 5 years ago
2.12.110 ... 5 years ago
2.12.111 ... 5 years ago
2.19.1 ... 5 years ago
3.13.0-next.0 ... 4 years ago
4.10.0-next.2 ... 4 years ago
2.16.0-next.2 ... 5 years ago
2.12.52 ... 5 years ago
2.18.0-next.0 ... 5 years ago
4.12.0-next.3 ... 4 years ago
4.3.0-next.2 ... 4 years ago
4.3.0-next.0 ... 4 years ago
2.15.0-next.2 ... 5 years ago
3.14.0-next.2 ... 4 years ago
3.13.0-next.1 ... 4 years ago
3.6.0-next.1 ... 5 years ago
2.20.0-next.0 ... 5 years ago
4.7.0-next.0 ... 4 years ago
3.14.2 ... 4 years ago
3.10.0-next.0 ... 4 years ago
3.4.0-next.0 ... 5 years ago
4.0.0-zz-next.1 ... 4 years ago
4.7.0-next.3 ... 4 years ago
4.2.0-next.0 ... 4 years ago
4.9.0-next.0 ... 4 years ago
3.8.0-next.0 ... 5 years ago
3.6.0-next.0 ... 5 years ago
3.1.0-next.3 ... 5 years ago
4.15.0-next.0 ... 4 years ago
4.15.0-next.2 ... 4 years ago
4.13.0-next.0 ... 4 years ago
4.8.0-next.1 ... 4 years ago
3.3.0-next.0 ... 5 years ago
3.2.0-next.0 ... 5 years ago
3.11.0-next.0 ... 4 years ago
3.0.0-v3rc.2 ... 5 years ago
2.11.10-unifiedroutes-v2.135 ... 5 years ago
2.11.10-unifiedroutes.76 ... 5 years ago
2.12.100-telemetry-testt.461 ... 5 years ago
2.14.0-telemetry-test2.327 ... 5 years ago
3.5.0-telemetry-test.296 ... 4 years ago
2.12.88-stuck-diagnostics.39 ... 5 years ago
2.12.100-static-image.22 ... 5 years ago
2.12.38-recipes-renderer.75 ... 5 years ago
3.14.0-preview-resiliancy.52 ... 4 years ago
3.5.0-alpha-node-manifest.73 ... 5 years ago
4.16.0-next.0 ... 4 years ago
4.11.0-alpha-luda.25 ... 4 years ago
4.15.0 ... 4 years ago
2.12.90-jsx-transform.5 ... 5 years ago
2.12.69-ink3.23 ... 5 years ago
2.12.112-ink-compiled.24 ... 5 years ago
2.12.88-incbuild-collections.5 ... 5 years ago
4.8.0-alpha-image-service.26 ... 4 years ago
4.9.0-alpha-image-cdn.39 ... 4 years ago
3.4.0-functions-next.18 ... 5 years ago
3.14.0-drupal-next.94 ... 4 years ago
2.12.89-dev-ssr-2.60 ... 5 years ago
2.16.0-create-gatsby.2 ... 5 years ago
3.12.0-coreutils.29 ... 4 years ago
3.0.0-cpb3.20 ... 5 years ago
4.6.0-alpha-ts-jit.26 ... 4 years ago
4.7.0-alpha-ts-aot.33 ... 4 years ago
4.5.0-alpha-trailing-slash.71 ... 4 years ago
3.10.0-alpha-remote-file.48 ... 4 years ago
3.14.0-alpha-remote-fetch.79 ... 4 years ago
3.14.0-alpha-qe-sm.46 ... 4 years ago
3.6.0-alpha-parallel-query.75 ... 5 years ago
3.2.0-alpha-parallel.28 ... 5 years ago
4.2.0-alpha-ot-global-span.15 ... 4 years ago
4.2.0-alpha-jobs-progress.16 ... 4 years ago
4.0.0-alpha-9689ff.13 ... 4 years ago
2.19.3 ... 5 years ago
2.8.16 ... 6 years ago
2.10.10 ... 6 years ago
2.12.11 ... 6 years ago
2.12.42 ... 6 years ago
2.6.13 ... 6 years ago
2.8.4 ... 6 years ago
2.7.0 ... 6 years ago
2.12.21 ... 6 years ago
2.11.8 ... 6 years ago
2.12.15 ... 6 years ago
2.7.44 ... 6 years ago
2.12.35 ... 6 years ago
2.7.15 ... 6 years ago
2.6.5 ... 7 years ago
1.1.58 ... 8 years ago
2.8.27 ... 6 years ago
2.8.28 ... 6 years ago
2.11.3 ... 6 years ago
2.6.4 ... 7 years ago
2.11.17 ... 6 years ago
2.8.30 ... 6 years ago
2.12.40 ... 6 years ago
2.9.0 ... 6 years ago
2.7.30 ... 6 years ago
2.7.47 ... 6 years ago
2.7.7 ... 6 years ago
2.8.29 ... 6 years ago
2.8.1 ... 6 years ago
2.7.1-structured-logs-test.128 ... 6 years ago
2.7.1-structured-logs.161 ... 6 years ago
2.10.14-state-machine.77 ... 6 years ago
2.6.11-reporter-npm.8 ... 6 years ago
2.11.4-recipes.53 ... 6 years ago
2.11.3-prompt-restart.96 ... 6 years ago
2.6.13-process-develop.5 ... 6 years ago
2.7.41-otp-test.31 ... 6 years ago
2.7.25-jarmo.4 ... 6 years ago
2.6.1-ink-node6.16 ... 7 years ago
2.5.9-ink.61 ... 7 years ago
2.6.8-error-codes.71 ... 6 years ago
2.5.7-clipboardy.1 ... 7 years ago
2.11.18-cli-ux.2 ... 6 years ago
2.12.25-cli-ts.23 ... 6 years ago
2.8.30-cli-react-from-ink.158 ... 6 years ago
2.8.1-cli-react-dom.20 ... 6 years ago
2.7.41-cli-postinstall.73 ... 6 years ago
2.11.4-alpha.53 ... 6 years ago
1.2.0-alphasldfjsljfd ... 8 years ago
2.8.28-berry-mdx.26 ... 6 years ago
2.12.45 ... 6 years ago