Atlassian Design System

Add to your project

DESIGN.md encodes Atlassian Design System's visual language for AI coding tools. Add it to your project so Claude Code, Cursor, or any agent that reads files can reference it directly.

Quick start

Fetch /raw/design-systems/atlassian/design-md/DESIGN.md and use it as the design foundation for this project.

Overview

The Atlassian Design System (implemented as Atlaskit) is Atlassian's open-source design system for building product interfaces across its suite — Jira, Confluence, Trello, Bitbucket, and others. It is a comprehensive React component library backed by a robust design token system built on semantic role-based naming.

Atlassian's most distinctive architectural feature is its all-semantic token system: all consumer-facing tokens are role-based with a structured dot-path naming convention (color.background.brand.bold). There are no primitive tokens exposed to consumers — the palette is an internal implementation detail. This is a significant departure from both Material's three-tier system and Carbon's two-tier approach.

A second key feature is the emphasis tier baked into token names (subtlestsubtlersubtle(default)boldboldest) — a nuanced system that lets a single role (e.g. danger) express a full range of visual weight without requiring new role names.

Key characteristics:

  • All-semantic token architecture: color.*, elevation.*, font.*, space.*, radius.*, border.*, motion.* — no primitive layer exposed to consumers
  • Role + emphasis + state model: Token names encode property, role, emphasis, and interaction state in one path
  • 10 color roles: neutral, brand, information, success, warning, danger, discovery, accent, inverse, input
  • Light and dark theme support: tokens resolve to different values per theme; theme switching via setGlobalTheme()
  • Atlassian Sans typeface: Custom typeface for product UI; Charlie Display/Text for brand/marketing
  • Spacing, radius, elevation fully tokenized: Complete coverage beyond color — a unified token vocabulary across all design decisions
  • Atlaskit package ecosystem: Each component is a separate package under @atlaskit/; @atlaskit/tokens is the foundation

When to reference this system:

  • Enterprise SaaS product interfaces (especially team collaboration tools)
  • Reference for all-semantic token architectures (no primitive tier)
  • Reference for the role + emphasis + state token naming convention
  • Dark mode theming via token system (no manual CSS overrides)
  • Full-coverage token systems (color, spacing, radius, elevation, motion all in one package)

When not to use as primary reference:

  • Consumer-facing mobile apps (not a mobile design system)
  • Projects not using React (Atlaskit is React-only)
  • Teams that want to manage their own primitive palette

Sources

Content TypeSourceNotes
Guidancehttps://atlassian.design/foundationsJS SPA; scraped via Firecrawl
Tokenshttps://atlassian.design/tokens/design-tokensJS SPA; token values from CDN package
Token packagehttps://cdn.jsdelivr.net/npm/@atlaskit/tokens@13.0.4/npm CDN; token-default-values.js for light theme values
Source codehttps://bitbucket.org/atlassian/atlassian-frontend-mirrorBitbucket; not GitHub