Netlify Config

This is your complete netlify.toml reference for when you're configuring Netlify sites. It covers the whole syntax: build settings, redirects with splats and conditions, headers, deploy contexts, environment variables, functions and edge functions config. The redirect section is especially thorough, showing you how to handle SPAs, proxying, country-based routing, and the force flag. One thing to remember: rule order matters since Netlify uses the first match, so put specific redirects before your catch-all. It also reminds you not to commit secrets in the toml file, which is easy to forget when you're moving fast.

skills.sh installs: 3.6K
GitHub stars: 51
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add netlify/context-and-tools --skill netlify-config --agent claude-code

Installs into .claude/skills of the current project.

Files

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).

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly