@cryptotaxi247 / documentation / commits / 0bb6ed0

CLI documentation update from CI

npm CLI robot committed Feb 19, 2026 at 22:03 UTC 0bb6ed0b631a246c3d162f6348b3d2c61f88f13c
6 files changed +95 -4
cli-cache.json
+1 -1
@@ -2,5 +2,5 @@
2 "v8": "aa8fff11cdab94fff1a2160ee5241f5f4632e96b",
3 "v9": "64763a341e7aa5b456e696f956759bf9b3440dc1",
4 "v10": "6755ca2d5301b079f9e2581fc72ba2a612171364",
5 - "v11": "40fcab45d356545f8db7f34df3e5630116d0dd40"
5 + "v11": "c029cb2e5e8b6b61d1a7fd8c454da51a52cd650c"
6 }
\ No newline at end of file
content/cli/v11/commands/npm-ls.mdx
+1 -1
@@ -52,7 +52,7 @@ Note: to get a "bottoms up" view of why a given package is included in the tree
52 Positional arguments are `name@version-range` identifiers, which will limit the results to only the paths to the packages named. Note that nested packages will _also_ show the paths to the specified packages. For example, running `npm ls promzard` in npm's source tree will show:
53
54 ```bash
55 -npm@11.10.0 /path/to/npm
55 +npm@11.10.1 /path/to/npm
56 └─┬ init-package-json@0.0.4
57 └── promzard@0.1.5
58 ```
content/cli/v11/commands/npm.mdx
+1 -1
@@ -31,7 +31,7 @@ Note: This command is unaware of workspaces.
31
32 ### Version
33
34 -11.10.0
34 +11.10.1
35
36 ### Description
37
content/cli/v11/configuring-npm/npmrc.mdx
+51
@@ -101,6 +101,37 @@ The full list is:
101
102 In order to scope these values, they must be prefixed by a URI fragment. If the credential is meant for any request to a registry on a single host, the scope may look like `//registry.npmjs.org/:`. If it must be scoped to a specific path on the host that path may also be provided, such as `//my-custom-registry.org/unique/path:`.
103
104 +### Unsupported Custom Configuration Keys
105 +
106 +Starting in npm v11.2.0, npm warns when unknown configuration keys are defined in `.npmrc`. In a future major version of npm, these unknown keys may no longer be accepted.
107 +
108 +Only configuration keys that npm officially supports are recognized. Custom keys intended for third-party tools (for example, `electron-builder`) should not be placed in `.npmrc`.
109 +
110 +If you need package-level configuration for use in scripts, use the `config` field in your `package.json` instead:
111 +
112 +```json
113 +{
114 + "name": "my-package",
115 + "config": {
116 + "mirror": "https://example.com/"
117 + }
118 +}
119 +```
120 +
121 +Values defined in `package.json#config` are exposed to scripts as environment variables prefixed with `npm_package_config_`. For example:
122 +
123 +```
124 +npm_package_config_mirror
125 +```
126 +
127 +If you need to pass arguments to a script command, use `--` to separate npm arguments from script arguments:
128 +
129 +```
130 +npm run build -- --customFlag
131 +```
132 +
133 +Using environment variables is also recommended for cross-platform configuration instead of defining unsupported keys in `.npmrc`.
134 +
135 ```
136 ; bad config
137 _authToken=MYTOKEN
@@ -120,6 +151,26 @@ _authToken=MYTOKEN
151 //somewhere-else.com/another/:_authToken=MYTOKEN2
152 ```
153
154 +### Custom / third-party config keys
155 +
156 +npm only recognizes its own [configuration options](/cli/v11/using-npm/config). If your `.npmrc` contains keys that are not part of npm's config definitions (for example, `electron_mirror` or `sass_binary_site`), npm will emit a warning:
157 +
158 +```
159 +warn Unknown user config "electron_mirror".
160 +This will stop working in the next major version of npm.
161 +```
162 +
163 +These keys were historically tolerated but are not officially supported. A future major version of npm will treat unknown top-level keys as errors.
164 +
165 +Some tools (such as `@electron/get` or `node-sass`) read their own configuration from environment variables or from `.npmrc` by convention. You can set these values as environment variables instead:
166 +
167 +```bash
168 +export ELECTRON_MIRROR="https://mirrorexample.npmjs.org/mirrors/electron/"
169 +export ELECTRON_CUSTOM_DIR="{{ version }}"
170 +```
171 +
172 +Environment variables are the most portable approach and work regardless of `.npmrc` format.
173 +
174 ### See also
175
176 - [npm folders](/cli/v11/configuring-npm/folders)
content/cli/v11/using-npm/changelog.mdx
+40
@@ -15,6 +15,46 @@ redirect_from:
15 - /using-npm/changelog
16 ---
17
18 +## [11.10.1](https://github.com/npm/cli/compare/v11.10.0...v11.10.1) (2026-02-19)
19 +
20 +### Bug Fixes
21 +
22 +- [`9fac412`](https://github.com/npm/cli/commit/9fac412105c4bbd116cffb6e27dda54a2adecf33) [#8995](https://github.com/npm/cli/pull/8995) improve unknown config warning with .npmrc section hint (#8995) (@umeshmore45)
23 +- [`bb135cc`](https://github.com/npm/cli/commit/bb135cc8998b8b936f2cb412ec3303ae02d6920c) [#8981](https://github.com/npm/cli/pull/8981) arborist: fix `peerOptional` dependency resolution in `buildIdealTree` (#8981) (@Saibamen, @cursoragent)
24 +- [`5c03826`](https://github.com/npm/cli/commit/5c03826e7aabedc03aaeaaa2f6863e6259519443) [#8993](https://github.com/npm/cli/pull/8993) remove tabular output from "npm view" (@wraithgar)
25 +- [`4648f26`](https://github.com/npm/cli/commit/4648f26f2e68c86306161b7ed6550c06adba4483) [#8993](https://github.com/npm/cli/pull/8993) remove tabular output from "npm team" (@wraithgar)
26 +
27 +### Documentation
28 +
29 +- [`0a5756d`](https://github.com/npm/cli/commit/0a5756d5d06972dcf29cdee6978f5317dce92e6b) [#8998](https://github.com/npm/cli/pull/8998) clarify unsupported custom .npmrc keys and recommend alternatives (#8998) (@maitrawebtech)
30 +- [`22c9153`](https://github.com/npm/cli/commit/22c91534d057dc4474495ed1d675fc9b15829275) [#8985](https://github.com/npm/cli/pull/8985) fix typo and grammar in README (#8985) (@csmit195, Chris)
31 +
32 +### Dependencies
33 +
34 +- [`aa8ffbf`](https://github.com/npm/cli/commit/aa8ffbf955a0ba768e58af1865988894d3404d78) [#9002](https://github.com/npm/cli/pull/9002) `init-package-json@8.2.5` (#9002)
35 +- [`67a0f09`](https://github.com/npm/cli/commit/67a0f09ad2e6a4e217963d73cd61e60ae9a27192) [#9001](https://github.com/npm/cli/pull/9001) `glob@13.0.6`
36 +- [`56b8fd4`](https://github.com/npm/cli/commit/56b8fd43467f49607eb52095ade83138ae35583b) [#9001](https://github.com/npm/cli/pull/9001) `minimatch@10.2.2`
37 +- [`aa7fef5`](https://github.com/npm/cli/commit/aa7fef50603457a0f74828042ab0f4ae124c0617) [#9001](https://github.com/npm/cli/pull/9001) `minipass@7.1.3`
38 +- [`d3a4161`](https://github.com/npm/cli/commit/d3a41615d857437af43ddc5c94f0f644c3cc2491) [#9000](https://github.com/npm/cli/pull/9000) `@npmcli/package-json@7.0.5` (#9000)
39 +- [`7aa9338`](https://github.com/npm/cli/commit/7aa9338565bd5b1fa9364727900225089746f0c9) [#8993](https://github.com/npm/cli/pull/8993) remove cli-columns
40 +- [`f7f7c53`](https://github.com/npm/cli/commit/f7f7c5383f9d599cd1982783e9afcb3e45b0e7e7) [#8991](https://github.com/npm/cli/pull/8991) hoist balanced-match
41 +- [`10cb575`](https://github.com/npm/cli/commit/10cb575743deb1ca0459c957fd19e50129116afe) [#8991](https://github.com/npm/cli/pull/8991) hoist latest yallist
42 +- [`1b3dc9a`](https://github.com/npm/cli/commit/1b3dc9a79a2bfc9ac9217bca724a38ce504eca0a) [#8991](https://github.com/npm/cli/pull/8991) `cidr-regex@5.0.3`
43 +- [`4307af6`](https://github.com/npm/cli/commit/4307af6c1d5a0a6a9d301f109546181e1d747c5a) [#8991](https://github.com/npm/cli/pull/8991) `glob@13.0.5`
44 +- [`13b4d6a`](https://github.com/npm/cli/commit/13b4d6a715b2369363a7e2d237eed8e45a5752aa) [#8991](https://github.com/npm/cli/pull/8991) `minimatch@10.2.1`
45 +- [`45d4000`](https://github.com/npm/cli/commit/45d40008877357c645256de4c244e065d20b8932) [#8991](https://github.com/npm/cli/pull/8991) `tar@7.5.9`
46 +
47 +### Chores
48 +
49 +- [`40fcab4`](https://github.com/npm/cli/commit/40fcab45d356545f8db7f34df3e5630116d0dd40) [#8991](https://github.com/npm/cli/pull/8991) `@npmcli/template-oss@4.29.0` (@wraithgar)
50 +- [`1598adb`](https://github.com/npm/cli/commit/1598adb05de18cb738c9a7fbcc63692059f46a17) [#8991](https://github.com/npm/cli/pull/8991) dev dependency updates (@wraithgar)
51 +- [workspace](https://github.com/npm/cli/releases/tag/arborist-v9.3.1): `@npmcli/arborist@9.3.1`
52 +- [workspace](https://github.com/npm/cli/releases/tag/config-v10.7.1): `@npmcli/config@10.7.1`
53 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmdiff-v8.1.2): `libnpmdiff@8.1.2`
54 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmexec-v10.2.2): `libnpmexec@10.2.2`
55 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmfund-v7.0.16): `libnpmfund@7.0.16`
56 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmpack-v9.1.2): `libnpmpack@9.1.2`
57 +
58 ## [11.10.0](https://github.com/npm/cli/compare/v11.9.0...v11.10.0) (2026-02-11)
59
60 ### Features
content/nav.yml
+1 -1
@@ -1596,7 +1596,7 @@
1596 - title: Changelog
1597 url: /cli/v10/using-npm/changelog
1598 description: Changelog notes for each version
1599 - - title: Version 11.10.0
1599 + - title: Version 11.10.1
1600 shortName: v11
1601 url: /cli/v11
1602 default: true