Skip to main content

NPM Packages

To access private packages hosted in Acro Commerce's GitLab registry, configure your .npmrc file with the necessary credentials. This file serves as the npm configuration file and enables authentication for accessing required packages.

Setting your local ~/.npmrc file​

  1. Create a .npmrc file in your home directory (~/.npmrc) or in the root of your project.
  2. Add the following lines to the .npmrc file:
@acromedia:registry=https://git.acromedia.com/api/v4/packages/npm/
//git.acromedia.com/api/v4/packages/npm/:_authToken=<YOUR GITLAB PRIVATE ACCESS TOKEN>
//git.acromedia.com/api/v4/projects/:_authToken=<YOUR GITLAB PRIVATE ACCESS TOKEN>
caution

Do not remove the // these are not comments. Doing so will result in incorrect authentication causing errors downloading gesso packages.

For seamless access to Acro Commerce's registry, it is recommended to place the .npmrc file in your home directory (~/.npmrc). This ensures constant accessibility to the registry. If you choose to create the file within an individual project, you will need to repeat the setup process every time, resulting in compatibility issues with the starter kits.

tip

In order to pull from Acro Commerce's registry, you must be added as a member in GitLab acromedia-npm-registry.

  • Join the Gesso Support Channel in Slack if you need support.

Access Tokens for Gitlab CI / Lagoon Projects​

For detailed configurations of the required tokens, please refer to the deployment section.