# @camunda/feel-builtins

> Collection of builtin Camunda extensions for FEEL

Latest version **1.5.0** (published 2026-10-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install @camunda/feel-builtins
pnpm add @camunda/feel-builtins
yarn add @camunda/feel-builtins
bun add @camunda/feel-builtins
```

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.5.0 |
| Published | 2026-10-21 |
| First published | 2025-07-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Dependencies | 0 |
| Unpacked size | 191.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Camunda |
| Maintainers | nikku, barmac, maxtru, philippfromme, barinali, jarekdanielak, alekseymanetov |

## Links

- npm: https://www.npmjs.com/package/@camunda/feel-builtins
- Repository: https://github.com/camunda/feel-builtins
- Homepage: https://github.com/camunda/feel-builtins#readme
- Issues: https://github.com/camunda/feel-builtins/issues
- npm.io page: https://npm.io/package/@camunda/feel-builtins

## Recent versions

- 1.5.0 (latest) — 2026-10-21
- 1.4.1 — 2026-08-24
- 1.4.0 — 2026-07-15
- 1.3.0 — 2026-06-30
- 1.2.0 — 2026-04-21
- 1.1.0 — 2026-03-19
- 1.0.0 — 2026-02-11
- 0.4.0 — 2026-02-10
- 0.3.0 — 2026-02-05
- 0.2.0 — 2025-07-22
- 0.1.0 — 2025-07-21

## README

# Camunda FEEL Builtins

[![CI](https://github.com/camunda/feel-builtins/actions/workflows/CI.yml/badge.svg)](https://github.com/camunda/feel-builtins/actions/workflows/CI.yml)

Collection of builtin Camunda extensions for FEEL (Friendly Enough Expression Language). These builtins get extracted from [camunda-docs](https://github.com/camunda/camunda-docs/tree/main/docs/components/modeler/feel/builtin-functions).

## Installation

Install via npm:

```sh
npm install @camunda/feel-builtins
```

## Usage

This package exports multiple collections of FEEL builtins:

* **`camundaBuiltins`**: Collection of builtins of camunda scala FEEL.
* **`feelBuiltins`**: List of standard FEEL built-in functions (excluding Camunda-specific extensions).
* **`camundaExtensions`**: List of FEEL camunda extensions.
* **`camundaReservedNameBuiltins`**: Functions using reserved keywords in their name and need to be added to the parser context during parsing.

You can feed built-ins as context into your favorite [FEEL editor](#feel-editor) or [validator](#feel-lint).

### Feel Editor

In your [FEEL editor](https://github.com/bpmn-io/feel-editor) you can use these builtins to establish the Camunda context:

```js
import { camundaBuiltins } from '@camunda/feel-builtins';
import FeelEditor from '@bpmn-io/feel-editor';

const editor = new FeelEditor({
  container,
  builtins: camundaBuiltins,
  parserDialect: 'camunda'
});
```

If you only want standard FEEL functions, use `feelBuiltins` instead:

```js
import { feelBuiltins } from '@camunda/feel-builtins';

const editor = new FeelEditor({
  container,
  builtins: feelBuiltins
});
```

### Feel Lint

With [@bpmn-io/feel-lint](https://github.com/bpmn-io/feel-lint) you can also use the builtins to lint expressions in the Camunda world:

```js
import { camundaBuiltins } from '@camunda/feel-builtins';
import { lintExpression } from '@bpmn-io/feel-lint';

lintExpression(expression, {
  builtins: camundaBuiltins,
  parserDialect: 'camunda'
});
```

## Resources

* [Changelog](./CHANGELOG.md)
* [Issues](https://github.com/camunda/feel-builtins/issues)

## Build and Run  

Prepare the project by installing dependencies:

```sh
npm install
```

Then, depending on your use-case you may run any of the following commands:

```sh
# lint the library and run all tests
npm run all

# update the built-ins from latest camunda-docs
npm run update-builtins
```

## Related

* [@bpmn-io/feel-editor](https://github.com/bpmn-io/feel-editor): FEEL editor and playground
* [@bpmn-io/feel-lint](https://github.com/bpmn-io/feel-lint): A linter for FEEL expressions

## License

[MIT](./LICENSE)

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