ado-npm-auth 0.1.2 → 0.1.4

package/README.md

@@ -33,3 +33,28 @@ One of the easiest ways to use the tool is to add it to your `"preinstall"` scri
 It will then perform a quick "pre-flight" check to assess if the token is valid, and generate a new one if it has expired.
 
 ![screenshot of tool running via preinstall](https://github.com/microsoft/ado-npm-auth/raw/main/packages/ado-npm-auth/static/preinstall.png)
+
+### Beware the chicken and egg problem
+
+You may need to set the registry to the public NPM feed when running `npm exec` or `npx`. 
+
+There are 2 options to address this case:
+
+### 1: Explictly pass the config file.
+You can hop one directory up, or run it from an arbitrary path and pass the configuration.
+```cmd
+pushd ..
+npx ado-npm-auth -c <myrepo>\.npmrc
+popd
+```
+
+### 2: configure registry explicilty
+If that's the case, set the environment variable `npm_config_registry=https://registry.npmjs.org`. 
+
+That will ensure that `npx` or `npm exec` grabs from the public NPM feed, bypassing the soon-to-be authenticated ADO feed. 
+
+```json
+"scripts": {
+  "preinstall": "npm_config_registry=https://registry.npmjs.org npm exec ado-npm-auth"
+},
+```