netlify-frameworks
Deploy and configure web frameworks on Netlify — build settings and SSR/edge adapters plus local platform emulation and env vars. Use when setting up or fixing a framework deploy (Next.js / Astro / Nuxt / SvelteKit / Remix / React Router / TanStack Start / SolidStart / Gatsby / Angular / Vite / Express / Hydrogen / Hugo / Eleventy / Vue / React), adding SSR or edge functions or middleware wired to Netlify context, fixing SPA redirect and catch-all rules, setting a build command or publish direct
Security Assessment
About netlify-frameworks
netlify-frameworks is a developer guidance skill for deploying and configuring web frameworks on Netlify, covering build settings, SSR/edge adapters, and local platform emulation. It solves the problem of correctly wiring a framework project (Vite/React, Astro, TanStack Start, Next.js, Nuxt, SvelteKit, Remix, and others) to Netlify so that server-side rendering, API routes, and middleware are translated automatically into Netlify Functions and Edge Functions.
The skill explains how framework adapters write files to `.netlify/v1/` during build, how to detect which framework a project uses from its config files, and where to find per-framework reference guides (Astro, Next.js, Nuxt, SvelteKit, Vite, TanStack). It documents the two local-development paths — the `netlify dev` wrapper that injects environment variables, Functions, Edge Functions, and redirect/header processing around any framework's dev server, and the Netlify Vite plugin family that exposes platform primitives directly inside a Vite-based dev server — plus `netlify dev:exec` for running a single command with the Netlify environment loaded. It also covers general patterns such as SPA catch-all redirects and a key gotcha: removing the `/* → /index.html` catch-all when adopting an SSR adapter, since user-defined redirects take precedence over adapter-generated routes. The reference guides add framework-specific detail, including advice to verify current package versions before pinning rather than guessing.
It targets frontend and full-stack developers deploying framework apps to Netlify. Use cases include initial deploy setup, configuring adapters/plugins, running locally with Netlify platform features, and troubleshooting SSR, redirect, and build-command issues. It is educational platform documentation with no risky behavior.
FAQ
How does Netlify run a framework's server-side code?
A framework adapter or plugin writes functions, edge functions, redirects, and configuration to .netlify/v1/ during the build, and Netlify reads those to deploy. You do not write Netlify Functions manually when using a framework adapter for SSR, API routes, or middleware.
What are the local development options?
Either `netlify dev`, which wraps the framework's own dev server and adds env vars, Functions, Edge Functions, and redirects/headers, or the Netlify Vite plugin family for Vite-based frameworks, which exposes platform primitives inside the normal dev command. `netlify dev:exec <cmd>` loads the Netlify environment for a single command.
Which frameworks are covered?
Vite + React (SPA or with server routes), Astro, TanStack Start, Next.js, Nuxt, SvelteKit, and Remix, each with a dedicated reference guide, plus general support for any framework that produces static output.
What's a common SSR redirect gotcha?
A leftover SPA catch-all `/* → /index.html` rule shadows server routes because user-defined redirects in netlify.toml/_redirects take precedence over adapter-generated routes. Remove the catch-all when you adopt an SSR adapter.
Should I pin framework package versions?
The reference guides advise checking the current latest version with `npm view <pkg> version` (or omitting pins and letting npm install choose) before pinning, since knowledge cutoffs lag npm and guessing exact versions tends to fail. Never present an unverified version as the current release.
Install netlify-frameworks
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
netlify/context-and-tools