Capawesome Cloud

You can use private Capawesome npm packages within your Capawesome Cloud builds by configuring the Capawesome npm registry. This guide shows you how to set up authentication to access the private packages from the Capawesome Insiders program.

Preparation

Create a Capawesome Cloud Environment Secret

Get your license key and add it to your Capawesome Cloud app as an environment secret with the name CAPAWESOME_NPM_REGISTRY_TOKEN as described in Environment secrets.

Keep your license key secure

Never commit your license key directly to your repository and always use environment variables to store sensitive information like authentication tokens.

Configuration

Configure the npm registry

Create a new file named .npmrc in the root of your project and add the following content:

@capawesome-team:registry=https://npm.registry.capawesome.io
//npm.registry.capawesome.io/:_authToken=${CAPAWESOME_NPM_REGISTRY_TOKEN}

This file will automatically configure npm to use the Capawesome registry for @capawesome-team packages during Capawesome Cloud builds.

Managing multiple environments

In the event that your local development no longer works with your new .npmrc file, you can create a separate .npmrc.capawesome file specifically for Capawesome Cloud. Just navigate to your Capawesome Cloud app > Settings > Environment variables, add a new environment variable named NPM_CONFIG_USERCONFIG and set its value to /tmp/capawesome/repo/.npmrc.capawesome. If your .npmrc.capawesome file is not in your project's root directory, adjust this path accordingly.