# rox-node

> CloudBees Feature Management JavaScript SDK for Node.js

Latest version **6.0.16** (published 2026-07-23) · SEE LICENSE IN LICENSE license · 0 weekly downloads

## Install

```sh
npm install rox-node
pnpm add rox-node
yarn add rox-node
bun add rox-node
```

## Health

**Score 68/100 (B)** — status: active.

Positive: has types package; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 6.0.16 |
| Published | 2026-07-23 |
| First published | 2017-08-20 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE |
| TypeScript types | separate (@types/rox-node) |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 337.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | CloudBees, Inc. |
| Maintainers | cloudbees-owner, asaf_rollout, markwm, ankurv0202 |
| Keywords | feature-flag, feature-flags, cloudbees, cloudbees.io, rox, flags, flag, configuration, remote-control, feature-management |

## Links

- npm: https://www.npmjs.com/package/rox-node
- Repository: https://github.com/rollout/roxjs
- Homepage: https://www.cloudbees.com/products/feature-management
- Issues: https://github.com/rollout/roxjs/issues
- npm.io page: https://npm.io/package/rox-node

## Dependencies (1)

- [axios](https://npm.io/package/axios.md) ^1.16.0

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 6.0.16 (latest) — 2026-07-23
- 5.4.3-beta2 (beta1) — 2023-05-12
- 3.3.0-alpha.afac4f25 (canary) — 2018-07-31
- 6.0.15 — 2026-07-06
- 6.0.14 — 2026-06-29
- 6.0.13 — 2026-05-15
- 6.0.11 — 2026-05-14
- 6.0.10 — 2026-05-08
- 6.0.8 — 2025-11-04
- 6.0.7 — 2025-10-13
- 6.0.6 — 2025-09-10
- 6.0.5 — 2025-09-08
- 6.0.4 — 2025-09-04
- 6.0.3 — 2025-06-03
- 6.0.2 — 2025-02-11
- … 89 more at https://npm.io/package/rox-node/versions

## README

# CloudBees Feature Management - Node.js SDK 🦆

CloudBees Feature Management is a secure feature management solution for the enterprise.

> Accelerate development and minimize the risk of deploying new code with simple to create feature flags, controlled rollouts, advanced target groups & deployment rules.

## Getting Started

Please see the detailed instructions in our docs on how to [add CloudBees Feature Management to your project](https://docs.cloudbees.com/docs/cloudbees-feature-management/).

## Documentation

Getting started guide, use cases, examples and videos can be found at [CloudBees Feature Management documentation](https://docs.cloudbees.com/docs/cloudbees-feature-management/).

## About

CloudBees Feature Management JavaScript SDK for Node.js. Define and use simple and advanced feature flags, remote configuration variables, static and computed custom properties in code. Control your application features via CloudBees Feature Management dashboard.

## Installation
```
npm i rox-node --save
```

## Usage
Obtain an application key by registering at [CloudBees Unify](https://cloudbees.io).

```javascript
import Rox from 'rox-node';

const appSettingsContainer = {
  shouldShowWelcome: new Rox.Flag(),
  textColor: new Rox.RoxString('black'),
  textSize: new Rox.RoxNumber(12, [18, 24])
};

const onRoxReady = async () => {
  if (appSettingsContainer.shouldShowWelcome.isEnabled()) {
    const color = appSettingsContainer.textColor.getValue();
    const size = appSettingsContainer.textSize.getValue();
    console.log(`Welcome! Color: ${color}, Size: ${size}`);
  }
};

Rox.register('settingsNamespace', appSettingsContainer);
await Rox.setup('<app key>', {
  configurationFetchedHandler: onRoxReady
});
```

## Configure the SDK with different options
Override the default configuration by providing predefined configuration preset for `Rox.setup`.

For example:
```javascript
import Rox from 'rox-node';

/*
- roxOptions.distinctId
- roxOptions.version
- roxOptions.configurationFetchedHandler
- roxOptions.fetchIntervalInSec
*/

const roxOptions = {
  distinctId: 'userId123',
  version: '1.0',
  fetchIntervalInSec: 60,
  configurationFetchedHandler: () => {}
};

await Rox.setup('<app key>', roxOptions);
```

## LICENSE

CloudBees Feature Management is free-to-use, proprietary software. Please see the full license (found in LICENSE in this distribution) for details on its license and the licenses of its dependencies.

CloudBees Feature Management Node.js SDK is free-to-use, proprietary software. Please see the full license found under the LICENSE file for more details.

## Feedback

Feedback is always welcomed
[support@cloudbees.com](mailto:support@cloudbees.com)

---
_Source: https://npm.io/package/rox-node · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._