SKILL.md
Netlify configuration
Config lives in three files at the repo root (or the base/package directory for monorepos):
netlify.toml— build, contexts, plugins, functions, redirects, headers, dev._redirects— plain-text redirect/rewrite rules, saved to the publish directory, no extension._headers— plain-text response headers, saved to the publish directory.
netlify.toml values take precedence over the Netlify UI when they conflict. Paths in netlify.toml are absolute relative to the base directory (root / by default).
Modern vs legacy syntax to reach for
- Functions bundler: use
node_bundler = "esbuild".zisiis the legacy JS default; TypeScript always usesesbuild. - Temporary redirect: use
status = 302.307is unsupported. - Gatsby Image CDN: use
NETLIFY_IMAGE_CDN, not the deprecatedGATSBY_CLOUD_IMAGE_CDN. - Injecting env values into TOML:
key = "$VAR"is NOT supported (exceptsignedin proxy redirects). Use a build-commandsedsubstitution or a build plugin (see below).