# @atlaskit/tokens

> Design tokens are the single source of truth to name and store design decisions.

Latest version **18.2.0** (published 2026-09-17) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @atlaskit/tokens
pnpm add @atlaskit/tokens
yarn add @atlaskit/tokens
bun add @atlaskit/tokens
```

## Health

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

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

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 18.2.0 |
| Published | 2026-09-17 |
| First published | 2021-07-02 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 7 |
| Unpacked size | 16 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Atlassian Pty Ltd |
| Maintainers | atlassianartifactteam |

## Links

- npm: https://www.npmjs.com/package/@atlaskit/tokens
- Repository: https://bitbucket.org/atlassian/atlassian-frontend-mirror
- Homepage: https://atlassian.design/components/tokens
- Issues: https://bitbucket.org/atlassian/atlassian-frontend-mirror/issues
- npm.io page: https://npm.io/package/@atlaskit/tokens

## Dependencies (7)

- [@babel/types](https://npm.io/package/@babel/types.md) ^7.20.0
- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.0.0
- [@babel/traverse](https://npm.io/package/@babel/traverse.md) ^7.23.2
- [@atlaskit/ds-lib](https://npm.io/package/@atlaskit/ds-lib.md) ^8.0.0
- [bind-event-listener](https://npm.io/package/bind-event-listener.md) ^3.0.0
- [@atlaskit/react-compiler-gating](https://npm.io/package/@atlaskit/react-compiler-gating.md) ^0.2.0
- [@atlaskit/platform-feature-flags](https://npm.io/package/@atlaskit/platform-feature-flags.md) ^2.2.0

## Recent versions

- 18.2.0 (latest) — 2026-09-17
- 1.4.2 (next) — 2023-05-17
- 18.1.0 — 2026-09-17
- 18.0.0 — 2026-09-17
- 17.0.1 — 2026-09-16
- 17.0.0 — 2026-09-15
- 16.12.0 — 2026-09-10
- 16.11.3 — 2026-09-08
- 16.11.2 — 2026-09-02
- 16.11.1 — 2026-09-01
- 16.11.0 — 2026-08-31
- 16.10.0 — 2026-08-29
- 16.9.0 — 2026-08-28
- 16.8.1 — 2026-08-25
- 16.8.0 — 2026-08-20
- … 344 more at https://npm.io/package/@atlaskit/tokens/versions

## README

# Tokens

Tokens are a single source of truth to name and store Atlassian design decisions.

## Installation

```sh
yarn add @atlaskit/tokens
```

## Usage

[View documentation](https://atlassian.design/components/tokens).

# BabelPlugin

A babel plugin to optimise performance and support fallbacks for Design System tokens.

It replaces any calls to the `@atlaskit/tokens` token() function with the CSS value the function
would return (i.e. var(--token-name) or variations with fallbacks).

If there’s no fallback, the plugin (optionally) finds the token’s value from the default Atlassian
theme, and sets it as the fallback.

If there is a fallback defined in code, it’s inserted into the style (expressions are inserted using
template strings).

## Usage

Add the plugin to your babel configuration:

```
{
  "plugins": [
    ["@atlaskit/tokens/babel-plugin", { "shouldUseAutoFallback": true }]
  ]
}
```

### Options

Currently the plugin supports one option, `shouldUseAutoFallback`. When not disabled, the plugin
will fetch the token's value in the default Atlassian theme (currently `atlassian-light`) and use it
as the fallback value.

This is useful for cases where tokens are in use, but token definitions aren't guaranteed to be
present in the top-level page CSS.

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