Merge pull request #8033 from MicrosoftDocs/artifacts/437409

denrea · web-flow · commit 46bdd1bbc8db · 2025-06-20T10:37:01.000-07:00
npm publish &amp; restore artifacts
diff --git a/docs/artifacts/get-started-npm.md b/docs/artifacts/get-started-npm.md
@@ -1,107 +1,124 @@
 ---
-title: Publish and download npm packages
-description: Learn how to set up your project to manage your npm packages in Azure Artifacts.
+title: Publish and download npm packages with Azure Artifacts
+description: Learn how to configure your npm project to publish and consume packages using Azure Artifacts.
 ms.service: azure-devops-artifacts
 ms.topic: quickstart
 ms.assetid: 5BFBA0C3-85ED-40C9-AC5F-F686923160D6
-ms.date: 05/28/2024
+ms.date: 06/17/2025
 monikerRange: '>= azure-devops-2020'
 "recommendations": "true"
 ---
 
-# Get started with npm packages in Azure Artifacts
+# Publish and download npm packages with Azure Artifacts
 
 [!INCLUDE [version-gt-eq-2020](../includes/version-gt-eq-2020.md)]
 
-Using Azure Artifacts, you can publish and download your npm packages from feeds and public registries such as npmjs.com. This quickstart will guide you through creating your feed, configuring your project, and managing npm packages with your Azure Artifacts feed.
+With Azure Artifacts, you can publish and download npm packages from both your own feeds and public registries such as npmjs.com. This quickstart guides you through creating a feed, configuring your project, and managing npm packages using Azure Artifacts.
 
 ## Prerequisites
 
-- An Azure DevOps organization. [Create one for free](../organizations/accounts/create-organization.md).
-
-- An Azure DevOps project. Create a new [project](../organizations/projects/create-project.md#create-a-project) if you don't have one already.
-
-- [Download and install Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
+| **Product**        | **Requirements**   |
+|--------------------|--------------------|
+| **Azure DevOps**   | - An Azure DevOps [organization](../organizations/accounts/create-organization.md).<br>- An Azure DevOps [project](../organizations/projects/create-project.md).<br> - [Download and install Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm). |
 
 ## Create a feed
 
 [!INCLUDE [](includes/create-feed.md)]
 
 ## Connect to a feed
 
-> [!NOTE]
-> `vsts-npm-auth` is not supported in Azure DevOps Server.
+Azure Artifacts recommends using two separate configuration files. The first should be kept locally in the *$HOME* directory (Linux/macOS) or *$env.HOME* (Windows) to securely store your credentials. This allows the npm client to access your credentials for authentication.
+
+In this section, you'll configure the second *npmrc* file, which should be placed in the same directory as your *package.json* file.
 
-Azure Artifacts recommends using two .npmrc files. The first one should be placed in the *$home* directory (Linux/macOS) or *$env.HOME* (Windows) to securely store your credentials. This allows the npm client to locate the file and retrieve your credentials for authentication, enabling you to share your config file without exposing your credentials. In this section, we will set up the second *.npmrc* file, which should be placed in the same directory as your *package.json* file.
+This setup lets you share your configuration file without exposing your credentials.
 
 ::: moniker range="azure-devops"   
 
 1. Sign in to your Azure DevOps organization, and then navigate to your project.
 
-1. Select **Artifacts**, and then select **Connect to feed**.
+1. Select **Artifacts**, select your feed from the dropdown menu, and then select **Connect to feed**.
 
-1. Select **npm** from the left navigation area. If this is your first time using Azure Artifacts with npm, make sure you've installed the prerequisites.
+1. In the left navigation pane, select **npm**. If this is your first time using Azure Artifacts with npm, make sure you've installed the prerequisites.
 
-1. Follow the instructions in the **Project setup** section to set up your config file and connect to your feed.
+1. Under the **Project setup** section, select **Windows** or **Other** depending on your operating system, then follow the provided instructions to configure your config file and connect to your Azure Artifacts feed.
 
-    :::image type="content" source="media/npm-project-setup-azure-devops.png" alt-text="A screenshot that shows how to set up an npm project and connect to an Azure Artifacts feed in Azure DevOps Services.":::
+    :::image type="content" source="media/npm-project-setup-azure-devops.png" alt-text="A screenshot displaying how to set up an npm project and connect to a feed in Azure DevOps Services.":::
 
 ::: moniker-end
 
+
 ::: moniker range="azure-devops-2022"
 
+> [!NOTE]
+> The `vsts-npm-auth` is not supported in Azure DevOps Server.
+
 1. Sign in to your Azure DevOps collection, and then navigate to your project.
 
-1. Select **Artifacts**, and then select **Connect to Feed**.
+1. Select **Artifacts**, select your feed from the dropdown menu, and then select **Connect to feed**.
+
+1. In the left navigation pane, select **npm**. If this is your first time using Azure Artifacts with npm, make sure you've installed the prerequisites.
 
-1. Select **npm** from the left, and then follow the instructions in the **Project setup** section to connect to your feed.
+1. Under the **Project setup** section, select **Windows** or **Other** depending on your operating system, then follow the provided instructions to configure your config file and connect to your Azure Artifacts feed.
 
-   :::image type="content" source="media/npm-project-setup-server-2022-1.png" alt-text="A screenshot that shows how to set up an npm project and connect to an Azure Artifacts feed in Azure DevOps Server 2022.":::
+   :::image type="content" source="media/npm-project-setup-server-2022-1.png" alt-text="A screenshot displaying how to set up an npm project and connect to an Azure Artifacts feed in Azure DevOps Server 2022.":::
 
 ::: moniker-end
 
+
 ::: moniker range="azure-devops-2020"
 
+> [!NOTE]
+> The `vsts-npm-auth` is not supported in Azure DevOps Server.
+
 1. Sign in to your Azure DevOps collection, and then navigate to your project.
 
-1. Select **Artifacts**, and then select **Connect to feed**.
+1. Select **Artifacts**, select your feed from the dropdown menu, and then select **Connect to feed**.
+
+1. In the left navigation pane, select **npm**. If this is your first time using Azure Artifacts with npm, make sure you've installed the prerequisites.
 
-1. Select **npm** from the left, and then follow the instructions in **Project setup** to set up your config file and connect to your feed.
+1. Under the **Project setup** section, select **Windows** or **Other** depending on your operating system, then follow the provided instructions to configure your config file and connect to your Azure Artifacts feed.
 
    :::image type="content" source="media/npm-project-setup-server-2020-1.png" alt-text="A screenshot that shows how to set up an npm project and connect to an Azure Artifacts feed in Azure DevOps Server 2020.":::
 
 ::: moniker-end
 
 > [!IMPORTANT]
-> npm supports a single `registry` in your .npmrc file. Multiple registries are possible with [scopes](npm/scopes.md) and [upstream sources](npm/upstream-sources.md).
+> Npm supports only a single `registry` setting in your *npmrc* file. To use multiple registries, you must use [upstream sources](npm/upstream-sources.md) or [scopes](npm/scopes.md).
 
-## Publish packages
+## Publish packages to your feed
 
-Run the following command in your project directory to publish your npm packages:
+To successfully run the publish command, you must first authenticate with your feed. If you haven’t done this yet, follow the steps in the [Connect to a feed](#connect-to-a-feed) section then continue with the instructions below.
 
-```Command
-npm publish
-```
+- In your project directory, run the following command to publish the npm package defined in your *package.json*:
+
+    ```
+    npm publish
+    ```
 
 > [!IMPORTANT]
-> Using the `publishConfig` property to override the registry config param at publish-time is not supported. 
+> Using the `publishConfig` property to override the registry configuration at publish time is not supported.
+
+## Restore packages from your feed
+
+To successfully run the restore command, you must first authenticate with your feed. If you haven’t done this yet, follow the steps in the [Connect to a feed](#connect-to-a-feed) section then continue with the instructions below.
+
+1. In your project directory, run the following command to restore all npm packages:
 
-## Restore packages
+    ```
+    npm install
+    ```
 
-Run the following command in your project directory to restore your npm packages:
+1. To restore a specific npm package, run the following command from your project directory:
 
-```Command
-npm install
-```
+    ```
+    npm install --save <PACKAGE_NAME>
+    ```
 
-To restore a specific npm package, run the following command from your project directory:
+## Related content
 
-```Command
-npm install --save <PACKAGE_NAME>
-```
+- [Publish npm packages with Azure Pipelines (YAML/Classic)](../pipelines/artifacts/npm.md)
 
-## Related articles
+- [Use packages from npmjs.com](npm/upstream-sources.md)
 
-- [Publish npm packages (YAML/Classic)](../pipelines/artifacts/npm.md)
-- [Use packages from npmjs.com](./npm/upstream-sources.md)
-- [Use npm scopes](npm/scopes.md)
+- [Use npm audit](npm/npm-audit.md)
diff --git a/docs/artifacts/includes/create-feed.md b/docs/artifacts/includes/create-feed.md
@@ -48,4 +48,4 @@ ms.date: 03/15/2024
 ::: moniker-end
 
 > [!NOTE]
-> By default, newly created feeds have their project's **Build Service** value set to **Feed and Upstream Reader (Collaborator)**.
+> By default, the **Build Service** for the project *(for example: projectName Build Service (orgName))* is assigned the **Feed and Upstream Reader (Collaborator)** role when a new feed is created.
