netlify-deployment-specialist

Configure Netlify builds, redirects, environment variables, and serverless functions for static sites.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Whaleylaw/llm-lawyer --skill netlify-deployment-specialist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-deployment-specialist
Source: https://github.com/Whaleylaw/llm-lawyer/tree/main/.claude/skills/netlify-deployment-specialist
Command: npx skills add https://github.com/Whaleylaw/llm-lawyer --skill netlify-deployment-specialist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines deploying static sites and single-page applications to Netlify by guiding build configuration, redirects, environment variables, functions setup, and troubleshooting to prevent common failures like 404s, build errors, or inaccessible functions.

Core Features & Use Cases

  • Build & Publish Configuration: Identify and verify build commands and publish directories for Vite, Create React App, Next.js static exports, and similar toolchains.
  • Routing & Redirects: Provide SPA fallback configuration using _redirects or netlify.toml and set up API proxies to avoid route refresh 404s.
  • Environment & Serverless Functions: Manage build-time environment variables with proper prefixes and deploy Netlify Functions under netlify/functions with correct handler exports.
  • Use Case: Deploy a Vite React SPA with SPA fallback, CI deploy previews for PRs, a custom domain with SSL, and an API proxy to a backend service.

Quick Start

Connect the repository in the Netlify dashboard, set the build command to npm run build and the publish directory to dist, add an SPA fallback redirect, configure required environment variables, and trigger a deploy.

Frequently Asked Questions about netlify-deployment-specialist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix 404 errors when refreshing a deployed SPA on Netlify?

To fix SPA 404 refresh errors on Netlify, configure an SPA fallback redirect using a `netlify.toml` file or a `_redirects` file so client-side routes resolve to your index.html instead of returning a server 404.

How do I configure build commands and publish directories for a Vite app on Netlify?

Configuring Vite deployments on Netlify requires setting the build command to `npm run build` and the publish directory to `dist`, ensuring the output folder matches your framework's static asset generation path.

Does Netlify support deploying Next.js static exports and serverless functions together?

Netlify supports deploying Next.js static exports alongside serverless functions by placing handlers in the `netlify/functions` directory and configuring proper API proxying within your build settings.

How do I manage environment variables with client-side prefixes during a Netlify build?

Managing environment variables during a Netlify build involves scoping variables properly in the dashboard and applying client-side prefixes like `VITE_` or `REACT_APP_` to expose them safely to the frontend.

What's the best way to set up branch-based deployments and deploy previews on Netlify?

Setting up branch-based deploy previews on Netlify involves connecting your repository to the dashboard to automatically generate isolated preview environments triggered by pull requests and branch pushes.

Why are my Netlify Functions returning errors after deployment?

Netlify Functions deployment errors often occur when handlers lack correct exports or when files are placed outside the designated `netlify/functions` directory specified in your build configuration.