id       = "gatsby"
name     = "Gatsby"
homepage = "https://www.gatsbyjs.com/docs/reference/gatsby-cli/"
description = "A free and open-source framework based on React that helps developers build blazing fast websites and apps."
icon     = "theSVG:gatsby"
executables   = ["gatsby"]

[dotfiles]

# https://www.gatsbyjs.com/docs/telemetry/ — "stored in global gatsby config at
# ~/.config/gatsby/config.json". gatsby-core-utils/src/get-config-store.ts
# builds it as `new Configstore("gatsby", {}, { globalConfigPath: true })`, and
# configstore with globalConfigPath resolves to <xdg-config>/gatsby/config.json
# — and xdg-basedir falls back to ~/.config on every platform, so there is one
# spelling everywhere. gatsby-config.js is a project file, not a dotfile.
paths = ["~/.config/gatsby/config.json"]

exclude = []

# The file also holds ordinary preferences — cli.packageManager, the feedback
# opt-out — so it is not a whole-file secret.
secret = []

# Read and rewritten per command; nothing keeps it open.
side_effect = false

# gatsby-cli/src/util/manage-token.ts writes the login token under the key
# `cli.token` (with `cli.tokenExpiration` beside it), and configstore nests
# dotted keys, so it is the `token` field of the `cli` object.
[[dotfiles.secret_paths]]
file  = "~/.config/gatsby/config.json"
match = { key_path = ["cli.token"] }

# No machine_lines: cli.packageManager and the feedback keys are preferences
# and timestamps, not facts about one machine.

[commands]
format = 1
label = "Gatsby site"
description = "Develop, build and serve a Gatsby site from the project directory. Tracing and plugin commands are left out."
quality = "ai-draft"
base = "fig:gatsby"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/gatsby.ts"
license = "MIT"

[[commands.subcommand]]
path = ["develop"]
label = "Start dev server"

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/gatsby.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "host"
label = "Host"
type = "string"
option = ["--host", "-H"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "port"
label = "Port"
type = "integer"
option = ["--port", "-p"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "open"
label = "Open in browser"
type = "boolean"
option = ["--open", "-o"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "https"
label = "Use HTTPS"
type = "boolean"
option = ["--https", "-S"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "develop"
label = "Start dev server"
fields = ["host", "port", "open", "https"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["host", "port", "open", "https"]

[[commands.subcommand]]
path = ["build"]
label = "Build for production"

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/gatsby.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "prefix_paths"
label = "Prefix link paths"
type = "boolean"
option = ["--prefix-paths"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "no_uglify"
label = "Skip minifying JS"
type = "boolean"
option = ["--no-uglify"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "profile"
label = "React profiling"
type = "boolean"
option = ["--profile"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "build"
label = "Build site"
fields = ["prefix_paths", "no_uglify", "profile"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["prefix_paths", "no_uglify", "profile"]

[[commands.subcommand]]
path = ["serve"]
label = "Serve production build"

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/gatsby.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "host"
label = "Host"
type = "string"
option = ["--host", "-H"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "port"
label = "Port"
type = "integer"
option = ["--port", "-p"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "open"
label = "Open in browser"
type = "boolean"
option = ["--open", "-o"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "prefix_paths"
label = "Prefix link paths"
type = "boolean"
option = ["--prefix-paths"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "serve"
label = "Serve build"
fields = ["host", "port", "open", "prefix_paths"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["host", "port", "open", "prefix_paths"]

[[commands.subcommand]]
path = ["clean"]
label = "Clean cache"
description = "Deletes .cache and public."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/gatsby.ts"
license = "MIT"