@servicetitan/docs-uikit 32.2.0 → 32.3.0

package/docs/startup/install.mdx

@@ -17,14 +17,24 @@ See [package.json in the example project](https://github.com/search?q=repo%3Aser
 
 ## Options
 
-| Option       | Description                                   |
-| :----------- | :-------------------------------------------- |
-| `--no-token` | Disable configuring npm authentication token. |
+| Option       | Description                                                              |
+| :----------- | :----------------------------------------------------------------------- |
+| `--no-token` | Only install dependencies. Don't configure the npm authentication token. |
+| `--token`    | Only configure the npm authentication token. Don't install dependencies. |
 
 ## Configuring NPM Token in Development
 
 In development environments, `startup install` automatically configures an npm authentication token that grants access to private ServiceTitan packages. It securely retrieves the token and updates your npm configuration so you can install dependencies without any further setup.
 
+:::tip
+If your project is using `startup` v31 or earlier, or isn't using `startup` at all, run this command to manually configure the npm authentication token.
+
+```
+npx --yes @servicetitan/startup@latest install --token
+```
+
+:::
+
 :::caution
 `startup install` detects if it is running in development by checking for standard environment variables set by CI systems (e.g.,`CI` and `TEAMCITY_VERSION`). If none of these variables are set, it assumes it is running on a developer machine.
 If it mistakes a CI environment for a developer machine, add a `CI` environment variable (with any value) to the workflow, or [use `--no-token`](#how-to-use---no-token) to disable configuring the npm token.
@@ -119,7 +129,7 @@ These instructions are only for projects using [Option 2](#option-2-use-environm
 
 If your project is [using an environment variable](#option-2-use-environment-variable), and it isn't using `startup` v32 or later, then developers must also defined the same environment variable manually. And they must repeat these steps each time the token is rotated,
 
-1. Run `npx --yes @servicetitan/startup@latest install` to add the token to your per-user configuration.
+1. Run `npx --yes @servicetitan/startup@latest install --token` to add the token to your per-user configuration.
 2. Run `npm config get userconfig` to get the location of your per-user configuration file.
 3. Find the token in the configuration file, on the line that starts `//registry.npmjs.org/:_authToken=`
 4. Create a local environment variable with the token. Use the same variable name as in project's `.npmrc`.

package/docs/startup/mfe-list.mdx

@@ -0,0 +1,73 @@
+---
+title: mfe-list
+---
+
+Lists published MFE packages.
+
+Use `mfe-list` to see what MFE versions were published and when.
+
+```sh
+npx startup mfe-list
+```
+
+It outputs, for each MFE in the current workspace,
+
+- The MFE's name, current version, and total number of versions
+- A table listing the 20 most recently published versions, with the following columns:
+    - **Version** : the published version
+    - **Tag** : assigned tag (if any)
+    - **When** : when the version was published, relative to the current time
+
+For example,
+
+```
+@servicetitan/examples | version: 0.0.0-far1369uploadsourcemaps.8e4f1ca0 | versions: 20
+┌────────────────────────────────────────┬─────────┬───────────────┐
+│ Version                                │ Tag     │ When          │
+├────────────────────────────────────────┼─────────┼───────────────┤
+│ 0.0.0-far1369uploadsourcemaps.8e4f1ca0 │ latest  │ 2 months ago  │
+├────────────────────────────────────────┼─────────┼───────────────┤
+│ 0.0.0-test.7cf27f80                    │         │ 3 months ago  │
+├────────────────────────────────────────┼─────────┼───────────────┤
+│ 0.0.0-test.2c98b704                    │         │ 3 months ago  │
+
+~                                                                  ~
+~                                                                  ~
+├────────────────────────────────────────┼─────────┼───────────────┤
+│ 0.0.3                                  │         │ 4 years ago   │
+├────────────────────────────────────────┼─────────┼───────────────┤
+│ 1.2.4                                  │         │ 4 years ago   │
+└────────────────────────────────────────┴─────────┴───────────────┘
+```
+
+## Options
+
+| Option            | Description                                                         |
+| :---------------- | :------------------------------------------------------------------ |
+| `--all`           | List all published versions.                                        |
+| `--ignore <glob>` | Exclude MFEs with names matching the given glob pattern.            |
+| `--limit <count>` | List the last `<count>` published versions. Ignores `<count> <= 0`. |
+| `--tagged`        | List only tagged versions.                                          |
+
+## Listing specific MFEs
+
+To list specific MFEs, pass their package names on the command line. For example, to list all tagged versions of `@servicetitan/dispatch-center` run,
+
+```
+npx startup mfe-list @servicetitan/dispatch-center --tagged
+```
+
+:::tip
+Use this syntax to list any MFE, not just the ones in the project workspace.
+:::
+
+## Authorization
+
+If the machine is not authorized to access [Verdaccio](/docs/frontend/verdaccio-unpkg/#verdaccio), `startup` prompts you to authorize it. E.g.,
+
+```sh
+$ npx startup mfe-list
+This machine is not authorized to access https://verdaccio.servicetitan.com. Authorize? [Y/n]
+```
+
+Enter `y` to confirm, or `n` to cancel. If you confirm, `startup` runs [verdaccio-okta-oauth](/docs/frontend/verdaccio-unpkg/#authorzation) then proceeds with the command.

package/docs/startup/startup.mdx

@@ -29,6 +29,7 @@ Updating build tooling is typically a daunting and time-consuming task. When new
 - [install](./install) install project dependencies
 - [kendo-ui-license](./kendo-ui-license) install KendoReact license key
 - [lint](./lint) run eslint and stylelint
+- [mfe-list](./mfe-list) list published MFE packages
 - [mfe-publish](./mfe-publish) publish or unpublish MFE packages
 - [review](./review) check project for configuration errors
 - [start](./start) run project in development mode

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicetitan/docs-uikit",
-    "version": "32.2.0",
+    "version": "32.3.0",
     "description": "",
     "repository": {
         "type": "git",
@@ -16,5 +16,5 @@
     "cli": {
         "webpack": false
     },
-    "gitHead": "76a83fea33e04809b97c72720751878b1e3002d7"
+    "gitHead": "201392862b3cb12500b3c8c4f6310b101b87201b"
 }