Netlify llms.txt

The actual file

Source Markdown

The saved llms.txt text, displayed as source. The file belongs to its publisher; the live endpoint may change.

Showing the first 18000 characters. Load the complete file to read the remainder.

# LLM documentation for Netlify

> Comprehensive documentation for the Netlify web platform for building and deploying production-ready sites and web apps that are highly performant, secure, and ready to scale. Covers serverless functions, edge functions, async workloads, data and blob storage, image CDN, build configuration, deploys, domains, forms, team management, and AI tooling (skills, agent runners). Agent skills repository: https://github.com/netlify/context-and-tools.

Netlify is a web platform for building highly performant, secure, and reliable websites and web apps.
Use the following docs to identify the available capabilities and where to learn more about them

## Markdown versions of any page

Every documentation page in this index is also available as Markdown: append `.md` to any docs.netlify.com URL to get the raw Markdown source instead of the rendered HTML page.

For example, https://docs.netlify.com/build/functions/overview/ is also available at https://docs.netlify.com/build/functions/overview.md.

This applies to every page listed below, so you can fetch Markdown directly rather than parsing HTML.

## Quick setup

Netlify provides official skills to give AI coding agents accurate, up-to-date context and tools for building on Netlify.

### Install the Netlify CLI

```
npm install -g netlify-cli
```

Learn more: https://docs.netlify.com/api-and-cli-guides/cli-guides/get-started-with-cli/

### Install Netlify Skills

Netlify Skills are focused, factual references for building with Netlify platform primitives, such as serverless functions, edge functions, async workloads, Netlify Database, Blobs storage, Image CDN, forms, redirects, headers, caching, and more. Install all available skills with:

```
npx skills add netlify/context-and-tools --skill '*' --yes
```

Learn more: https://docs.netlify.com/build/build-with-ai/agent-setup-guides/agent-setup-overview.md and https://github.com/netlify/context-and-tools

### Install Netlify MCP Server

The Netlify MCP Server lets code agents create projects, deploy sites, manage environment variables, and more using the Netlify API and CLI.

Add the following to your MCP configuration (e.g. `mcp.json`):

```json
{
  "mcpServers": {
    "netlify": {
      "command": "npx",
      "args": ["-y", "@netlify/mcp"]
    }
  }
}
```

For Claude Code, run: `claude mcp add --transport http netlify https://netlify-mcp.netlify.app/mcp`

Learn more: https://docs.netlify.com/build/build-with-ai/agent-setup-guides/agent-setup-overview.md

### Netlify API Reference

Full OpenAPI specification: https://open-api.netlify.com/

If you're an AI agent, check out https://netlify.ai for more info on how to deploy to the web autonomously.

## Serverless Functions
- [Netlify Functions Overview](https://docs.netlify.com/build/functions/overview.md): Use serverless functions to run on-demand, server-side code without having to run a dedicated server.
- [Get started with Functions](https://docs.netlify.com/build/functions/get-started.md): Create functions source files in TypeScript and JavaScript; use environment variables, manage dependencies, and test locally.
- [Background Functions](https://docs.netlify.com/build/functions/background-functions.md): Use Background Functions for long-running serverless functions that handle tasks like batch processing, scraping, and more.
- [Scheduled Functions](https://docs.netlify.com/build/functions/scheduled-functions.md): Enable Scheduled Functions to run serverless functions on a regular and consistent schedule, like a cron job.
- [Function logs](https://docs.netlify.com/build/functions/logs.md): Observe and troubleshoot serverless functions using logs in the Netlify UI across your published deploy, branch deploys, and Deploy Previews.
- [Functions usage and billing](https://docs.netlify.com/build/functions/usage-and-billing.md): Monitor Functions service usage, track requests and run time, and change service levels.

## Edge Functions
- [Netlify Edge Functions Overview](https://docs.netlify.com/build/edge-functions/overview.md): Fast, personalized web experiences using TypeScript/JavaScript at the edge; modify requests, localize content, authenticate users, and more.
- [Netlify Edge Functions: Get Started](https://docs.netlify.com/build/edge-functions/get-started.md): Learn to create, test, deploy, invoke, and monitor Netlify Edge Functions.
- [Netlify Edge Functions API](https://docs.netlify.com/build/edge-functions/api.md): Edge Functions API reference: request handling, response types, context object, and supported Web APIs.
- [Edge Function Declarations](https://docs.netlify.com/build/edge-functions/declarations.md): Configure edge functions using inline code or `netlify.toml` for specific URL patterns, including optional exclusions and processing order.
- [Edge Functions Configuration](https://docs.netlify.com/build/edge-functions/optional-configuration.md): Optional settings for directory, caching, and error handling.
- [Edge Functions Limits](https://docs.netlify.com/build/edge-functions/limits.md): Size, memory, and execution time limits; invocation limits by plan; feature limitations and caveats.
- [Edge Functions Integrations](https://docs.netlify.com/build/edge-functions/create-integration.md): Integrate your framework with Netlify Edge Functions by generating function files and declarations.
- [Edge Functions Usage and Billing](https://docs.netlify.com/build/edge-functions/usage-and-billing.md): Monitor Edge Functions invocations, usage, and billing; understand pricing and limits.

## Async Workloads
- [Netlify Async Workloads Overview](https://docs.netlify.com/build/async-workloads/overview.md): Build scalable, event-driven apps with Netlify's Async Workloads; manage workflows, retries, and more.
- [Async Workloads: Get Started](https://docs.netlify.com/build/async-workloads/get-started.md): Enable Async Workloads, create basic functions, and send events.
- [Writing Async Workloads](https://docs.netlify.com/build/async-workloads/writing-workloads.md): Write Async Workload functions; includes installation, function writing, event handling, retries, error handling, and type safety.
- [Sending Events](https://docs.netlify.com/build/async-workloads/sending-events.md): Send events to trigger Async Workload functions using AsyncWorkloadsClient or router API; includes scheduling and priority options.
- [Multi-Step Workloads](https://docs.netlify.com/build/async-workloads/multi-step-workloads.md): Build multi-step Async Workloads using step functions for durable, retryable workflows with parallel and nested steps.
- [Async Workloads Configuration](https://docs.netlify.com/build/async-workloads/optional-configuration.md): Customize Async Workloads settings, API keys, limits, and scheduler intervals.
- [Async Workloads Lifecycle](https://docs.netlify.com/build/async-workloads/lifecycle.md): Lifecycle, guarantees, retries, failures, management APIs, and local/branch behavior.
- [Async Workloads Limits](https://docs.netlify.com/build/async-workloads/limitations.md): Payload size restrictions, function configuration, and invocation methods.

## CLI & API
- [Netlify CLI: Get Started](https://docs.netlify.com/api-and-cli-guides/cli-guides/get-started-with-cli.md): Use Netlify's command-line interface for local development, builds, and deployment.
- [Netlify CLI: Manage Functions](https://docs.netlify.com/api-and-cli-guides/cli-guides/manage-functions.md): Create, test, and serve Netlify functions locally using the Netlify CLI; invoke functions, debug, and deploy.
- [Netlify Dev: Local Development](https://docs.netlify.com/api-and-cli-guides/cli-guides/local-development.md): Develop and share Netlify sites locally; use Netlify Dev for local development environments, including custom configurations and HTTPS.
- [VS Code Netlify CLI Debugging](https://docs.netlify.com/api-and-cli-guides/cli-guides/debug-with-vscode.md): Configure VS Code to debug Netlify CLI functions and development server.
- [Netlify API Quickstart](https://docs.netlify.com/api-and-cli-guides/api-guides/get-started-with-api.md): Netlify API basics, deployment, common endpoints, and authentication using OAuth2.

## Build with AI
- [Build with AI overview](https://docs.netlify.com/build/build-with-ai/overview.md): Optimize AI workflows using Agent Runners, AI Gateway, the Netlify MCP Server, or other AI tools; best practices for building with AI.
- [Agent Runners overview](https://docs.netlify.com/build/build-with-ai/agent-runners/overview.md): Prompt AI agents to create, fix, update, and ship code using your unique project context directly from your Netlify dashboard.
- [Make changes with Agent Runners](https://docs.netlify.com/build/build-with-ai/agent-runners/make-changes-with-agent-runners.md): Use Agent Runners to build and iterate on an existing project with your preferred AI agent.
- [AI context files](https://docs.netlify.com/build/build-with-ai/agent-setup-guides/agent-setup-overview.md): Use Netlify's AI context files to improve results when building with AI tools and code agents.

## Framework Integration
- [Netlify Framework Docs](https://docs.netlify.com/build/frameworks/overview.md): Netlify framework deployment configurations, build commands, and publish directory settings for popular frameworks and architectures.
- [Netlify Frameworks API](https://docs.netlify.com/build/frameworks/frameworks-api.md): Deploy web frameworks to Netlify; full API reference for framework adapters.
- [Next.js Adapter v5](https://docs.netlify.com/build/frameworks/framework-setup-guides/nextjs/overview.md): Netlify's Next.js adapter v5 (current) configures Netlify sites for optimal performance, including caching, on-demand revalidation, and image optimization.
- [Next.js Legacy Runtime Overview (v4)](https://docs.netlify.com/build/frameworks/framework-setup-guides/nextjs/legacy-runtime/overview.md): Overview of Netlify's Next.js Runtime v4, which supports Next.js 10–13.4 and is in maintenance support. Use the v5 adapter for newer Next.js versions.
- [Next.js Advanced API Routes (Legacy v4)](https://docs.netlify.com/build/frameworks/framework-setup-guides/nextjs/legacy-runtime/advanced-api-routes.md): Background and scheduled API routes for Next.js 10–13.4 on Netlify Runtime v4 (maintenance support only).
- [Next.js Middleware on Netlify (Legacy v4)](https://docs.netlify.com/build/frameworks/framework-setup-guides/nextjs/legacy-runtime/middleware.md): Enhanced Next.js Middleware for Next.js 10–13.4 on Netlify Runtime v4 (maintenance support only), using `@netlify/next` for extended request/response access.
- [Next.js Redirects & Rewrites (Legacy v4)](https://docs.netlify.com/build/frameworks/framework-setup-guides/nextjs/legacy-runtime/redirects-and-rewrites.md): Redirects and rewrites for Next.js 10–13.4 on Netlify Runtime v4 (maintenance support only); covers when to use Next.js vs. platform-level routing.
- [Astro on Netlify](https://docs.netlify.com/build/frameworks/framework-setup-guides/astro.md): Deploy high-performance Astro sites on Netlify; leverage partial hydration, Netlify Image CDN, and server-side rendering.
- [Angular on Netlify](https://docs.netlify.com/build/frameworks/framework-setup-guides/angular.md): Deploy and optimize Angular apps on Netlify; leverage Netlify Image CDN, serverless functions, and more.
- [TanStack Start on Netlify](https://docs.netlify.com/build/frameworks/framework-setup-guides/tanstack-start.md): React-based full-stack framework with SSR, server routes, server functions, and middleware; powered by TanStack Router with type-safe routing.
- [Gatsby on Netlify](https://docs.netlify.com/build/frameworks/framework-setup-guides/gatsby.md): Gatsby and Netlify integration: features, adapters, build processes, and performance optimization.
- [Hugo framework on Netlify](https://docs.netlify.com/build/frameworks/framework-setup-guides/hugo.md): Fast static site generator; build speed, themes, Netlify integration, and version control.
- [Eleventy Static Site Generator on Netlify](https://docs.netlify.com/build/frameworks/framework-setup-guides/eleventy.md): Flexible, JavaScript-based SSG; Netlify integration, Edge Functions, build configurations.
- [Hydrogen on Netlify](https://docs.netlify.com/build/frameworks/framework-setup-guides/hydrogen.md): Deploy Shopify Hydrogen storefronts on Netlify using Netlify Edge Functions for enhanced performance.
- [Deploy Express on Netlify](https://docs.netlify.com/build/frameworks/framework-setup-guides/express.md): Deploy Express apps on Netlify using Netlify Functions; integrate with frontend or standalone.

## Build & Configuration
- [Netlify Build Configuration](https://docs.netlify.com/build/configure-builds/overview.md): Configure Netlify's build settings, including build commands, publish directories, and more.
- [Netlify File-Based Configuration](https://docs.netlify.com/build/configure-builds/file-based-configuration.md): Configure Netlify builds, deploys, and settings using the netlify.toml file; learn best practices.
- [Netlify Environment Variables](https://docs.netlify.com/build/environment-variables/overview.md): Configure Netlify sites' build and functionality using environment variables; learn about options, overrides, and limitations.
- [Netlify Environment Variables: Get Started](https://docs.netlify.com/build/environment-variables/get-started.md): Manage Netlify environment variables via UI, CLI, or API; use .env files; secure sensitive data.
- [Netlify Build Environment Variables](https://docs.netlify.com/build/configure-builds/environment-variables.md): Configure environment variables for builds; access and use them in your build process.
- [Netlify Environment Variables with Frameworks](https://docs.netlify.com/build/frameworks/use-environment-variables-with-frameworks.md): Use Netlify environment variables during builds or at runtime for browser, functions, or post-processing.
- [Netlify Secrets Controller](https://docs.netlify.com/build/environment-variables/secrets-controller.md): Securely manage sensitive environment variables with Netlify's enhanced security policy and secret scanning.
- [Netlify Build Software](https://docs.netlify.com/build/configure-builds/available-software-at-build-time.md): Available software at build time, including languages (Node.js, Python, Ruby, etc.) and tools, versions, and configuration.
- [Netlify Dependency Management](https://docs.netlify.com/build/configure-builds/manage-dependencies.md): Manage dependencies for Netlify builds, specifying Node.js, Go, PHP, Python, Ruby, Rust, and Swift versions.
- [Netlify Build Plugins](https://docs.netlify.com/extend/develop-and-share/develop-build-plugins.md): Build Netlify plugins using JavaScript or TypeScript, including ES modules, event handling, and plugin configuration.
- [Share Netlify Build Plugins](https://docs.netlify.com/extend/develop-and-share/share-build-plugins.md): Publish your Netlify plugins to npm for others to use via file-based install.
- [Netlify Build Hooks](https://docs.netlify.com/build/configure-builds/build-hooks.md): Trigger Netlify builds and deploys using build hook URLs; customize with parameters and payloads.
- [Netlify On-demand Builders](https://docs.netlify.com/build/configure-builds/on-demand-builders.md): Generate web content via serverless functions, automatically cached on Netlify's Edge CDN.
- [Netlify Build Control](https://docs.netlify.com/build/configure-builds/stop-or-activate-builds.md): Stop or activate Netlify site builds; control production deploys, previews, and branch deploys.
- [Netlify Build Ignoring](https://docs.netlify.com/build/configure-builds/ignore-builds.md): Prevent unnecessary builds using the `ignore` command with Node.js or Bash; skip builds based on branch, file changes, or custom logic.
- [Netlify Monorepo Builds](https://docs.netlify.com/build/configure-builds/monorepos.md): Configure Netlify builds for monorepo projects; base, package, build, and publish directory settings; commit status control.
- [Netlify SPA Build Configurations](https://docs.netlify.com/build/configure-builds/javascript-spas.md): Build configuration for JavaScript single-page applications, covering build commands, publish directory, and avoiding 404s.
- [Netlify Build Troubleshooting](https://docs.netlify.com/build/configure-builds/troubleshooting-tips.md): Troubleshoot failing Netlify builds; get AI-powered solutions for build errors and deploy failures.

## Deploy
- [Deploy overview](https://docs.netlify.com/deploy/deploy-overview.md): Understand how site deploys work, access deploy detail pages, and control branches, deploy contexts, and deploy permissions.
- [Create deploys](https://docs.netlify.com/deploy/create-deploys.md): Discover different methods of deploying a site; take advantage of continuous deployment, manual deployment, or integration options.
- [Manage deploys](https://docs.netlify.com/deploy/manage-deploys/manage-deploys-overview.md): Roll back, lock, cancel, skip, cleanup, or delete a deploy; use environment variables to control the deploy environment.
- [Protect deploys](https://docs.netlify.com/deploy/protect-deploys.md): Secure deploys with password protection, visitor access controls, and other security measures.
- [Deploy notifications](https://docs.netlify.com/deploy/deploy-notifications.md): Enable notifications for deploy events using Slack, webhooks, email, your Git provider, or other integrations.

## Data & Storage
- [Netlify Database](https://docs.netlify.com/build/data-and-storage/netlify-database/index.md): A zero-config, fully integrated Postgres database primitive for Netlify; build full-stack apps with isolated database branches and platform-managed migrations.
- [Netlify Database: Getting started](https://docs.netlify.com/build/data-and-storage/netlify-database/getting-started.md): Start a new project with Netlify Database or add it to an existing project.
- [Netlify Database: Migrations](https: