v21.4.0

21.4.0 (2025-05-14)

Features

• support granular context file setting (#7284) (dbe275f)

v21.3.0

21.3.0 (2025-05-12)

Features

• automatically detects IDE - windsurf or cursor - for AI context files. (#7280) (fd02e5d)
• update API client (#7282) (99e5472)

Bug Fixes

• deploy: fix typo in post-deploy message (#7289) (6eecb4e)
• deps: pin dependencies (#7281) (84920cd)
• deps: update netlify packages (#7288) (7299efb)

v21.2.1

21.2.1 (2025-05-08)

Bug Fixes

• deps: update netlify packages (#7278) (ab897bd)

v21.2.0

21.2.0 (2025-05-07)

Features

• update recipes to include windsurf rules directory preset (#7275) (7502e5f)
• add experimental support for Node 24 (note that we do not consider this support stable yet and this may not work on Windows)

v21.1.0

21.1.0 (2025-05-06)

Features

• add new netlify clone command, to clone an existing repo + connected Netlify site in one step (#7260) (fe9940e)
• init: prompt to configure build settings in 'no git remote' case (#7258) (cb881e8)

Bug Fixes

• deps: update dependency fastify to v4.29.1 (#7265) (d7bc2f8)
• deps: update dependency open to v10.1.2 (#7266) (6abe1a4)
• deps: update dependency ulid to v2.4.0 (#7268) (9476b24)
• deps: update dependency ulid to v3 (#7270) (4e0f92f)
• deps: update dependency ws to v8.18.2 (#7267) (4e8732c)

v21.0.1

21.0.1 (2025-05-06)

Bug Fixes

• actually stop spinning on success/failure (#7262) (5f68338)

v21.0.0

21.0.0 (2025-05-06)

⚠ BREAKING CHANGES

• remove support for deprecated netlify-lambda package (#7236)

The netlify-lambda NPM package was deprecated in Feb 2023. If you are one of the few using this, see the migration guide.

⚠ Potentially breaking changes

run build before deploy (#7195)

The deploy command now runs the site's configured build command before deployment by default. Previously, this was achieved by passing the --build flag. In other words, --build is no longer needed.

To opt into the previous default behavior, users can now specify netlify deploy --no-build.

Why are we changing this?

This has long been one of the most common sources of confusion with the Netlify CLI. Developers expect a "deploy" command to deploy their project. We're making this change to follow the Principle of Least Surprise and streamline the experience for new users.

Upgrading

👉🏼 (most common) Build and deploy

Remove the --build flag:

netlify deploy --build [...] # before

→

netlify deploy [...] # after

👉🏼 Separate build and deploy

Warning

Make sure your deploy command runs in your expected environment, e.g. if you were running FOO=bar netlify build && netlify deploy, make sure FOO is visible to the deploy command, which is now running the build: FOO=bar netlify deploy.

Collapse into one command, if you can:

netlify build && netlify deploy # before

→

netlify deploy # after

Otherwise, add the --no-build flag:

make spaghetti && netlify deploy # before

→

make spaghetti && netlify deploy --no-build # after

👉🏼 (rare) Deploy without build step

Add the --no-build flag:

netlify deploy [...] # before (there was no `--build` here)

→

netlify deploy --no-build [...]

polish and improve deploy command output (#7250) (795a451)

If you were automatically looking for specific strings in the netlify deploy output, your scripts may stop working. See the above PR for details.

Note that this is not recommended and such changes may not be considered breaking in the future. For stable output that conforms to semantic versioning, use netlify deploy --json.

Features

• link out to relevant Netlify docs in command help output (#7254) (1978faf)
• remove support for deprecated netlify-lambda package (#7236) (0d48c28)
• run build before deploy (#7195) (8e95c58)
• telemetry: send command opts and args (#7251) (9545bdc)

Bug Fixes

• deploy: remove messages about future deprecated flag removals (#7252) (758fd88)
• deps: update dependency @netlify/edge-functions to v2.12.0 (#7239) (5d70c98)
• dev: polish and improve dev command output (#7249) (7a5b7c0)
• fix framework server loading spinner ("Waiting for framework port") (#7242) (841d782)
• polish and improve deploy command output (#7250) (795a451)
• polish and improve postinstall onboarding message (#7248) (d9523c7)

v20.1.1

20.1.1 (2025-04-25)

Bug Fixes

• deps: update netlify packages (fixes TanStack Start framework detection) (#7230) (1d024b0)

v20.1.0

20.1.0 (2025-04-25)

Features

• beautify update notif and link to release notes (#7237) (0bf2db7)

Bug Fixes

• deps: update dependency @netlify/blobs to v8.2.0 (#7215) (1428374)

v20.0.4

20.0.4 (2025-04-24)

Bug Fixes

• deps: remove tempy (#7223) (fd28f48)
• match the branch-deploy context when using --context branch:foo (#7235) (ccb079a)
• skip framework detection for deploy only command (fixes erroneous Multiple possible build commands found) (#7229) (444ddff)