npx skills add ...
npx skills add netlify/context-and-tools --skill netlify-cli-and-deploy
npx skills add netlify/context-and-tools --skill netlify-cli-and-deploy
Guide for using the Netlify CLI and deploying sites. Use when installing the CLI, linking sites, deploying (Git-based or manual), managing environment variables, or running local development. Covers netlify dev, netlify deploy, Git vs non-Git workflows, and environment variable management.
Requires Node.js 18.14.0+.
For CI, set NETLIFY_AUTH_TOKEN environment variable instead.
Check if already linked with netlify status. If not:
Site ID is stored in .netlify/state.json. Add .netlify to .gitignore.
Set up with netlify init. Automatic deploys trigger on push/PR:
Build runs on Netlify's servers. Configure build settings in netlify.toml.
Build locally, then upload:
This works without Git — useful for prototypes, local-only projects, or CI pipelines.
Wraps your framework's dev server and provides:
For projects using Vite (React SPA, TanStack Start, SvelteKit, Remix), the Vite plugin provides Netlify platform primitives directly in the framework's dev server:
Then run your normal dev command (npm run dev) — no netlify dev wrapper needed. This gives you access to Blobs, DB, Functions, and environment variables during development.
See the netlify-frameworks skill for framework-specific local dev guidance.
Variables can be scoped to deploy contexts:
Netlify.env.get("VAR") (preferred) or process.env.VARVITE_-prefixed vars via import.meta.env.VITE_VARPUBLIC_-prefixed vars via import.meta.env.PUBLIC_VARNever use VITE_ or PUBLIC_ prefix for secrets — these are exposed to the browser.
| Command | Description |
|---|---|
netlify status | Auth and site link status |
netlify dev | Start local dev server |
netlify build | Run build locally (mimics Netlify environment) |
netlify deploy | Draft deploy |
netlify deploy --prod | Production deploy |
netlify dev:exec <cmd> | Run command with Netlify environment loaded |
netlify env:list | List environment variables |
netlify clone org/repo | Clone, link, and set up in one step |
netlify deploy # Draft deploy (preview URL)
netlify deploy --prod # Production deploy
netlify deploy --dir=dist # Specify output directorynetlify devnpm install @netlify/vite-plugin// vite.config.ts
import netlify from "@netlify/vite-plugin";
export default defineConfig({ plugins: [netlify()] });# Set
netlify env:set API_KEY "value"
netlify env:set API_KEY "value" --secret # Hidden from logs
netlify env:set API_KEY "value" --context production # Context-specific
# Get
netlify env:get API_KEY
# List
netlify env:list
netlify env:list --plain > .env # Export to file
# Import from file
netlify env:import .env
# Delete
netlify env:unset API_KEYnetlify env:set API_URL "https://api.prod.com" --context production
netlify env:set API_URL "https://api.staging.com" --context deploy-preview
netlify env:set DEBUG "true" --context branch:feature-x