# @sap-ux/feature-toggle

> Feature toggle manager for Fiori tools

Latest version **1.0.5** (published 2026-07-07) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @sap-ux/feature-toggle
pnpm add @sap-ux/feature-toggle
yarn add @sap-ux/feature-toggle
bun add @sap-ux/feature-toggle
```

## Health

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

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.0.5 |
| Published | 2026-07-07 |
| First published | 2024-02-13 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22.x |
| Dependencies | 0 |
| Unpacked size | 43.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 162 |
| Author | @SAP/ux-tools-team |
| Maintainers | tqueck, kranthie.sap, sap_extncrepos, sap-ospo-admin, devinea |

## Links

- npm: https://www.npmjs.com/package/@sap-ux/feature-toggle
- Repository: https://github.com/SAP/open-ux-tools
- npm.io page: https://npm.io/package/@sap-ux/feature-toggle

## Recent versions

- 1.0.5 (latest) — 2026-07-07
- 1.0.4 — 2026-07-03
- 1.0.3 — 2026-06-25
- 1.0.2 — 2026-06-12
- 1.0.1 — 2026-06-04
- 1.0.0 — 2026-05-30
- 0.4.0 — 2026-05-15
- 0.3.8 — 2026-03-30
- 0.3.7 — 2026-02-21
- 0.3.6 — 2026-02-04
- 0.3.5 — 2025-12-15
- 0.3.4 — 2025-11-05
- 0.3.3 — 2025-10-22
- 0.3.2 — 2025-10-14
- 0.3.1 — 2025-09-02
- … 9 more at https://npm.io/package/@sap-ux/feature-toggle/versions

## README

[![Changelog](https://img.shields.io/badge/changelog-8A2BE2)](https://github.com/SAP/open-ux-tools/blob/main/packages/feature-toggle/CHANGELOG.md) [![Github repo](https://img.shields.io/badge/github-repo-blue)](https://github.com/SAP/open-ux-tools/tree/main/packages/feature-toggle)

# [`@sap-ux/feature-toggle`](https://github.com/SAP/open-ux-tools/tree/main/packages/feature-toggle)

This module can be used for accessing and managing feature toggles in Fiori tools.

## Installation
Npm
`npm install --save @sap-ux/feature-toggle`

Yarn
`yarn add @sap-ux/feature-toggle`

Pnpm
`pnpm add @sap-ux/feature-toggle`

## Definition of toggle

### Define in VS Code Config

#### Define boolean based toggle
the key must follow the format `sap.ux.{extensionName}`
"sap.ux.serviceModeler.testBetaFeatures.annotationWideView":
```json
"configuration": {
      "id": "sap.ux.serviceModeler",
      "type": "object",
      "properties": {
        "sap.ux.serviceModeler.testBetaFeatures.annotationWideView": {
          "type": "boolean",
          "description": "<Still in Development> - Service Modeler Annotation Wide View",
          "default": false,
          "scope": "window"
        }
      }
}
```
#### Define Token based toggle
the key must follow the format `sap.ux.{extensionName}`
"sap.ux.serviceModeler.testBetaFeatures.annotationWideView":
```json
"configuration": {
      "id": "sap.ux.applicationModeler",
      "type": "object",
      "properties": {
        "sap.ux.applicationModeler.testBetaFeatures.enableV4": {
        		  "type": [ "string", null ],
        		  "description": "<Still in Development> - Fiori tools V4 support - token required",
        		  "default": null,
        		  "scope": "window"
        		}
      }
}
```
feature id -> token is mapped in (./src/constants.ts)
```
const tokenToggleGuid: ExtensionConfigKeys = {
    'sap.ux.help.testBetaFeatures.enableAppStudioGDContribution': 'c8c52f0b-0d7d-4697-997a-d6f29814f42e',
    'sap.ux.help.testBetaFeatures.showTestGuides': 'fbb03f42-0a86-4fd5-9fc4-8c9b38a4d1a3'
} as ExtensionConfigKeys;
```


### Enable feature toggle via environment variable (note: this over-rides VS Code Config if the feature name exists in both )
Launch VS Code passing the toggles :
```shell script
TOOLSUITE_FEATURES=featureName1,FeatureName2,FeatureName3 code .
```

## Usage

Checking a feature toggle
```typescript
import { isFeatureEnabled } from '@sap/ux-feature-toggle';
const EditMode = isFeatureEnabled('sap.ux.serviceModeler.testBetaFeatures.enableEditMode'),
```

Note boolean and token based toggles both return boolean in calls to `isFeatureEnabled()`

Checking a if the internal Feature flag is set
```typescript
import { isInternalFeaturesSettingEnabled } from '@sap/ux-feature-toggle';
const isInternal = isInternalFeaturesSettingEnabled();

```
Checking a if a specific internal Feature flag is set
```typescript
import { isFeatureEnabled } from '@sap/ux-feature-toggle';
const capCdsMode = isFeatureEnabled('sap.ux.internal.testBetaFeatures.capCdsMode'),


```

## Keywords
SAP Fiori Tools

---
_Source: https://npm.io/package/@sap-ux/feature-toggle · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._