chore(main): release 21.0.0 (#7241)

* chore(main): release 21.0.0

* docs(changelog): add more detail to v21.0.0

---------

Co-authored-by: token-generator-app[bot] <82042599+token-generator-app[bot]@users.noreply.github.com>
Co-authored-by: Philippe Serhal <[email protected]>

Author: token-generator-app[bot]

CHANGELOG.md

@@ -7,11 +7,101 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+
+## [21.0.0](https://github.com/netlify/cli/compare/v20.1.1...v21.0.0) (2025-05-06)
+
+
+### ⚠ BREAKING CHANGES
+
+* remove support for deprecated `netlify-lambda` package ([#7236](https://github.com/netlify/cli/issues/7236))
+
+[The netlify-lambda NPM package](https://github.com/netlify/netlify-lambda) was deprecated in Feb 2023. If you are one of the few using this, see the [migration guide](https://github.com/netlify/netlify-lambda/blob/main/MIGRATE.md).
+
+### ⚠ Potentially breaking changes
+
+#### run build before deploy ([#7195](https://github.com/netlify/cli/issues/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:
+
+```sh
+netlify deploy --build [...] # before
+```
+→
+```sh
+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:
+
+```sh
+netlify build && netlify deploy # before
+```
+→
+```sh
+netlify deploy # after
+```
+
+Otherwise, add the `--no-build` flag:
+
+```sh
+make spaghetti && netlify deploy # before
+```
+→
+```sh
+make spaghetti && netlify deploy --no-build # after
+```
+
+👉🏼 (rare) Deploy without build step
+
+Add the `--no-build` flag:
+
+```sh
+netlify deploy [...] # before (there was no `--build` here)
+```
+→
+```sh
+netlify deploy --no-build [...]
+```
+
+#### polish and improve deploy command output ([#7250](https://github.com/netlify/cli/issues/7250)) ([795a451](https://github.com/netlify/cli/commit/795a4516bc12bf60fba05eda73215d937f062194))
+
+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
 
-* add integration deploy command ([#6078](https://github.com/netlify/cli/issues/6078)) ([aa9b0be](https://github.com/netlify/cli/commit/aa9b0be3b6f91df45e136cbdca3a92f7a04a0d7e))
+* link out to relevant Netlify docs in command help output ([#7254](https://github.com/netlify/cli/issues/7254)) ([1978faf](https://github.com/netlify/cli/commit/1978faf6ca59e128449a462292f3a13b328c8f2a))
+* remove support for deprecated `netlify-lambda` package ([#7236](https://github.com/netlify/cli/issues/7236)) ([0d48c28](https://github.com/netlify/cli/commit/0d48c284ea0c6b6d3d34ffb72dd8bd93a85b7ed6))
+* run build before deploy ([#7195](https://github.com/netlify/cli/issues/7195)) ([8e95c58](https://github.com/netlify/cli/commit/8e95c58c51677d56ea8a6ba3a428e292576d1c75))
+* **telemetry:** send command opts and args ([#7251](https://github.com/netlify/cli/issues/7251)) ([9545bdc](https://github.com/netlify/cli/commit/9545bdc9689952c1131153591342d3859e0b2715))
 
 
+### Bug Fixes
+
+* **deploy:** remove messages about future deprecated flag removals ([#7252](https://github.com/netlify/cli/issues/7252)) ([758fd88](https://github.com/netlify/cli/commit/758fd884ad46864f4731604a93a9cd0f496df354))
+* **deps:** update dependency @netlify/edge-functions to v2.12.0 ([#7239](https://github.com/netlify/cli/issues/7239)) ([5d70c98](https://github.com/netlify/cli/commit/5d70c989562df4918c9c1dcfcfa0d2192f130a5a))
+* **dev:** polish and improve dev command output ([#7249](https://github.com/netlify/cli/issues/7249)) ([7a5b7c0](https://github.com/netlify/cli/commit/7a5b7c0efefc761a26c449e3545d8f8e216cf18b))
+* fix framework server loading spinner ("Waiting for framework port") ([#7242](https://github.com/netlify/cli/issues/7242)) ([841d782](https://github.com/netlify/cli/commit/841d782e851fd1672febd1db5be2b3e94982f588))
+* polish and improve deploy command output ([#7250](https://github.com/netlify/cli/issues/7250)) ([795a451](https://github.com/netlify/cli/commit/795a4516bc12bf60fba05eda73215d937f062194))
+* polish and improve postinstall onboarding message ([#7248](https://github.com/netlify/cli/issues/7248)) ([d9523c7](https://github.com/netlify/cli/commit/d9523c72ffcd8869b05a2e982d30fed44ce600bd))
 
 ## [20.1.1](https://github.com/netlify/cli/compare/v20.1.0...v20.1.1) (2025-04-25)
 

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "netlify-cli",
   "description": "Netlify command line tool",
-  "version": "20.1.1",
+  "version": "21.0.0",
   "author": "Netlify Inc.",
   "type": "module",
   "engines": {