---
description: Install private Capawesome Insiders npm packages in GitLab CI/CD pipelines. Configure access tokens, npm registry, and Capacitor build steps.
title: Integrate Capawesome Insiders with GitLab CI/CD - Capawesome
image: https://capawesome.io/docs/assets/images/social/insiders/integrations/gitlab-ci.png
---

[ Skip to content](#gitlab-cicd) 

[ 🎉 Introducing **Capawesome Platform** — one platform for Live Updates, Native Builds, App Store Publishing, and Insider SDKs.](https://capawesome.io) 

* [  Formbricks ](/docs/plugins/formbricks/)
* [  Geocoder ](/docs/plugins/geocoder/)
* [  Google Sign-In ](/docs/plugins/google-sign-in/)
* [  libSQL ](/docs/plugins/libsql/)
* [  Live Update ](/docs/plugins/live-update/)
* [  Managed Configurations ](/docs/plugins/managed-configurations/)
* [  Media Session ](/docs/plugins/media-session/)
* [  ML Kit ](/docs/plugins/mlkit/)
* [  NFC ](/docs/plugins/nfc/)
* [  OAuth ](/docs/plugins/oauth/)
* [  Pedometer ](/docs/plugins/pedometer/)
* [  Photo Editor ](/docs/plugins/photo-editor/)
* [  PostHog ](/docs/plugins/posthog/)
* [  Printer ](/docs/plugins/printer/)
* [  Purchases ](/docs/plugins/purchases/)
* [  RealtimeKit ](/docs/plugins/realtimekit/)
* [  Screen Orientation ](/docs/plugins/screen-orientation/)
* [  Screenshot ](/docs/plugins/screenshot/)
* [  Secure Preferences ](/docs/plugins/secure-preferences/)
* [  Speech Recognition ](/docs/plugins/speech-recognition/)
* [  Speech Synthesis ](/docs/plugins/speech-synthesis/)
* [  Share Target ](/docs/plugins/share-target/)
* [  Square Mobile Payments ](/docs/plugins/square-mobile-payments/)
* [  SQLite ](/docs/plugins/sqlite/)
* [  Superwall ](/docs/plugins/superwall/)
* [  Torch ](/docs/plugins/torch/)
* [  Wifi ](/docs/plugins/wifi/)
* [  Zip ](/docs/plugins/zip/)
* [  Cloud ](/docs/cloud/)
* [  Live Updates ](/docs/cloud/live-updates/)
* Advanced
* Integrations
* [  Native Builds ](/docs/cloud/native-builds/)
* [  Configuration ](/docs/cloud/native-builds/configuration/)
* [  Environments ](/docs/cloud/native-builds/environments/)
* Guides
* [  Sample Projects ](/docs/cloud/native-builds/sample-projects/)
* [  Troubleshooting ](/docs/cloud/native-builds/troubleshooting/)
* [  Automations ](/docs/cloud/automations/)
* [  Assist ](/docs/cloud/assist/)
* Account
* Organizations
* [  Organization and User Management ](/docs/cloud/organizations/memberships/)
* [  Single Sign-On (SSO) ](/docs/cloud/organizations/sso/)
* [  Teams ](/docs/cloud/organizations/teams/)
* [  Two-Factor Authentication ](/docs/cloud/organizations/two-factor-authentication/)
* [  Integrations ](/docs/cloud/integrations/)
* [  License Keys ](/docs/cloud/license-keys/)
* [  Webhooks ](/docs/cloud/webhooks/)
* [  Pricing ](https://capawesome.io/pricing/)
* [  FAQ ](/docs/cloud/faq/)
* [  Support ](/docs/cloud/support/)
* [  Contributing ](/docs/contributing/)
* [  LLMs ](/docs/llms/)
* [  Insiders ](/docs/insiders/)
* [  Pipeline Configuration ](#pipeline-configuration)
* [  Ionic Appflow ](/docs/insiders/integrations/ionic-appflow/)
* [  Jenkins ](/docs/insiders/integrations/jenkins/)
* [  Vercel ](/docs/insiders/integrations/vercel/)
* [  License ](https://capawesome.io/legal/eula/)
* [  Support ](/docs/insiders/support/)
* [  FAQ ](/docs/insiders/faq/)
* [  Blog ](/blog/)
* Categories

* [  Pipeline Configuration ](#pipeline-configuration)

# GitLab CI/CD[¶](#gitlab-cicd "Permanent link")

You can use private Capawesome npm packages within your [GitLab CI/CD](https://docs.gitlab.com/ci/) pipelines 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[¶](#preparation "Permanent link")

### Create a GitLab CI/CD Variable[¶](#create-a-gitlab-cicd-variable "Permanent link")

[Get your license key](/docs/insiders/faq/#where-can-i-find-my-license-key) and add it to your GitLab project as a CI/CD variable with the name `CAPAWESOME_NPM_REGISTRY_TOKEN` as described in [CI/CD variables](https://docs.gitlab.com/ci/variables/). Make sure to mark the variable as masked and protected.

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.

## Pipeline Configuration[¶](#pipeline-configuration "Permanent link")

### Configure the npm registry[¶](#configure-the-npm-registry "Permanent link")

Add the following script to your GitLab CI/CD pipeline **before** installing npm dependencies:

`[](#%5F%5Fcodelineno-0-1)before_script:
[](#%5F%5Fcodelineno-0-2)  - echo "@capawesome-team:registry=https://npm.registry.capawesome.io" >> .npmrc
[](#%5F%5Fcodelineno-0-3)  - echo "//npm.registry.capawesome.io/:_authToken=${CAPAWESOME_NPM_REGISTRY_TOKEN}" >> .npmrc
`

This will automatically configure npm to use the Capawesome registry for `@capawesome-team` packages during GitLab CI/CD builds.

### Example[¶](#example "Permanent link")

Here's a complete example of a GitLab CI/CD pipeline that builds an Ionic app using private Capawesome packages:

`[](#%5F%5Fcodelineno-1-1)stages:
[](#%5F%5Fcodelineno-1-2)  - build
[](#%5F%5Fcodelineno-1-3)
[](#%5F%5Fcodelineno-1-4)build-app:
[](#%5F%5Fcodelineno-1-5)  stage: build
[](#%5F%5Fcodelineno-1-6)  image: node:20
[](#%5F%5Fcodelineno-1-7)  before_script:
[](#%5F%5Fcodelineno-1-8)    - echo "@capawesome-team:registry=https://npm.registry.capawesome.io" >> .npmrc
[](#%5F%5Fcodelineno-1-9)    - echo "//npm.registry.capawesome.io/:_authToken=${CAPAWESOME_NPM_REGISTRY_TOKEN}" >> .npmrc
[](#%5F%5Fcodelineno-1-10)    - npm ci
[](#%5F%5Fcodelineno-1-11)  script:
[](#%5F%5Fcodelineno-1-12)    - npx cap sync
[](#%5F%5Fcodelineno-1-13)    - npm run build
[](#%5F%5Fcodelineno-1-14)  artifacts:
[](#%5F%5Fcodelineno-1-15)    paths:
[](#%5F%5Fcodelineno-1-16)      - dist/
[](#%5F%5Fcodelineno-1-17)    expire_in: 1 hour
[](#%5F%5Fcodelineno-1-18)  rules:
[](#%5F%5Fcodelineno-1-19)    - if: $CI_COMMIT_BRANCH == "main"
[](#%5F%5Fcodelineno-1-20)    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
`

This pipeline will authenticate with the Capawesome npm registry and install any private packages specified in your `package.json` file.

May 7, 2026 

 Back to top