@yahoo/uds 1.5.0 → 1.6.0

package/cli/README.md

@@ -179,6 +179,22 @@ Commands are organized in a tree structure in `uds/cli/commands`. The root comma
 
 Adding nested commands, i.e. `uds expo dev` does work correctly when UDS is consumed from npm. As a workaround, please see code for expo/expo.ts for re-routing sub-commands from the root command file. To verify your CLI command works correctly you should run `npm pack` within the packages/uds directory. Once you have your generated tarball you should copy that tarball to a test application such as https://github.com/yahoo-uds/uds-nextjs-demo, then add `"@yahoo/uds": "file:./tarball-generated-from-npm-pack.tgz` to it's dependencies and run an install. Now you should be able to run `bun uds [your command name]` to test your functionality.
 
+### Testing the login flow
+
+To test the login flow, the CLI starts a web server and opens browser window to
+a login page in Configurator. In prod, it opens https://config.uds.build/login.
+In local dev, http://localhost:4001/login is opened.
+
+In the root of the UDS monorepo, run the following commands:
+
+```
+# Start configurator app web server:
+turbo --filter uds-configurator dev
+
+# Run the CLI login command:
+bun run --cwd packages/uds uds login
+```
+
 ### API Reference
 
 Bluebun comes with a number of built-in utilities that are exported from the main `bluebun` package. See [reference guide](https://github.com/jamonholmgren/bluebun/blob/main/docs/reference.md) for more.