---
description: Learn how to install the private Capawesome Insiders npm packages in your Bitbucket Pipelines builds.
title: Integrate Capawesome Insiders with Bitbucket Pipelines - Capawesome
image: https://capawesome.io/docs/assets/images/social/insiders/integrations/bitbucket-pipelines.png
---

[ Skip to content](#bitbucket-pipelines) 

[ 🎉 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/)
* [  Grafana Faro ](/docs/plugins/grafana-faro/)
* [  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/)
* [  Navigation Bar ](/docs/plugins/navigation-bar/)
* [  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)
* [  Capawesome Cloud ](/docs/insiders/integrations/capawesome-cloud/)
* [  Cloudflare Pages ](/docs/insiders/integrations/cloudflare-pages/)
* [  GitHub Actions ](/docs/insiders/integrations/github-actions/)
* [  GitLab CI/CD ](/docs/insiders/integrations/gitlab-ci/)
* [  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)

# Bitbucket Pipelines[¶](#bitbucket-pipelines "Permanent link")

You can use private Capawesome npm packages within your [Bitbucket Pipelines](https://www.atlassian.com/software/bitbucket/features/pipelines) 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[¶](#preparation "Permanent link")

### Create a Bitbucket Repository Variable[¶](#create-a-bitbucket-repository-variable "Permanent link")

[Get your license key](/docs/insiders/faq/#where-can-i-find-my-license-key) and add it to your Bitbucket repository as a secured repository variable with the name `CAPAWESOME_NPM_REGISTRY_TOKEN` as described in [Variables and secrets](https://support.atlassian.com/bitbucket-cloud/docs/variables-and-secrets/). Make sure to mark the variable as secured.

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 Bitbucket Pipeline **before** installing npm dependencies:

`[](#%5F%5Fcodelineno-0-1)- echo "@capawesome-team:registry=https://npm.registry.capawesome.io" >> .npmrc
[](#%5F%5Fcodelineno-0-2)- 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 Bitbucket Pipelines builds.

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

Here's a complete example of a `bitbucket-pipelines.yml` file that builds an Ionic app using private Capawesome packages:

`[](#%5F%5Fcodelineno-1-1)image: node:20
[](#%5F%5Fcodelineno-1-2)
[](#%5F%5Fcodelineno-1-3)pipelines:
[](#%5F%5Fcodelineno-1-4)  default:
[](#%5F%5Fcodelineno-1-5)    - step:
[](#%5F%5Fcodelineno-1-6)        name: Build App
[](#%5F%5Fcodelineno-1-7)        caches:
[](#%5F%5Fcodelineno-1-8)          - node
[](#%5F%5Fcodelineno-1-9)        script:
[](#%5F%5Fcodelineno-1-10)          - echo "@capawesome-team:registry=https://npm.registry.capawesome.io" >> .npmrc
[](#%5F%5Fcodelineno-1-11)          - echo "//npm.registry.capawesome.io/:_authToken=${CAPAWESOME_NPM_REGISTRY_TOKEN}" >> .npmrc
[](#%5F%5Fcodelineno-1-12)          - npm ci
[](#%5F%5Fcodelineno-1-13)          - npx cap sync
[](#%5F%5Fcodelineno-1-14)          - npm run build
[](#%5F%5Fcodelineno-1-15)        artifacts:
[](#%5F%5Fcodelineno-1-16)          - dist/**
`

January 24, 2026 

 Back to top