---
title: Integrate Capawesome Insiders with Capawesome Cloud
description: Install private Capawesome Insiders npm packages in Capawesome Cloud builds. Configure access tokens and npm registry for native and live updates.
---

# Capawesome Cloud

You can use private Capawesome npm packages within your [Capawesome Cloud](/){:target="_blank"} 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](../faq.md#where-can-i-find-my-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](../../cloud/native-builds/environments.md#secrets).

???+ warning "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:

```.npmrc
@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.