https://github.com/adobe/spectrum-design-data
Design data, including design tokens, component schemas, and tooling for Spectrum, Adobe's design system.
https://github.com/adobe/spectrum-design-data
design-system design-tokens
Last synced: 8 days ago
JSON representation
Design data, including design tokens, component schemas, and tooling for Spectrum, Adobe's design system.
- Host: GitHub
- URL: https://github.com/adobe/spectrum-design-data
- Owner: adobe
- License: apache-2.0
- Created: 2022-03-08T10:02:49.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-06-05T00:07:18.000Z (14 days ago)
- Last Synced: 2026-06-05T00:15:13.091Z (14 days ago)
- Topics: design-system, design-tokens
- Language: Rust
- Homepage: http://opensource.adobe.com/spectrum-design-data/
- Size: 48 MB
- Stars: 137
- Watchers: 15
- Forks: 28
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- Changelog: changeset-example-concise.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Copyright: COPYRIGHT
- Agents: AGENTS.md
Awesome Lists containing this project
README
Note: for [Spectrum 2](https://s2.spectrum.adobe.com/) token data has been graduated to the `main` branch. If you need access to the S1 data, use the [`s1-legacy` branch](https://github.com/adobe/spectrum-design-data/tree/s1-legacy) and `v12.x.x` packages on [NPM](https://www.npmjs.com/package/@adobe/spectrum-tokens?activeTab=versions).
The [Spectrum token visualizer](https://opensource.adobe.com/spectrum-design-data/visualizer/) shows the token data for S1. For Spectrum 2 data, use [opensource.adobe.com/spectrum-design-data/s2-visualizer/](https://opensource.adobe.com/spectrum-design-data/s2-visualizer/).
# Spectrum Tokens Monorepo
This repo uses:
* [pnpm](https://pnpm.io/) for package management
* [moon](https://moonrepo.dev/moon) to manage task running
* [Changesets](https://github.com/changesets/changesets) for automated versioning and releasing
* [Prettier](https://prettier.io/) for code formatting/linting
* [commitlint](https://commitlint.js.org/) and [Convetional Commits](https://www.conventionalcommits.org/en/v1.0.0/) to standardize commit messages
* [husky](https://typicode.github.io/husky/) to automate formatting of committed files and linting of commit messages
Packages in this monorepo:
## Core Packages
* [Spectrum Tokens](packages/tokens/) design tokens for Spectrum, Adobe's design system.
* [Spectrum Component Schemas](packages/component-schemas/) JSON schemas for validating Spectrum component APIs and properties.
## Design Data
* [Spectrum Design Data](packages/design-data/) the canonical Spectrum dataset — tokens, components, fields, mode-sets, guidelines, and registry data. This is the primary data package consumed by the SDK and tooling.
* [Design Data Specification](packages/design-data-spec/) normative spec artifacts: human-readable spec (`spec/`), JSON Schemas, validation rule catalog (`rules/rules.yaml`), and conformance fixtures.
* [Token Names](packages/token-names/) sidecar taxonomy `name` objects for `@adobe/spectrum-tokens`, decoupled so taxonomy changes don't bump the token package. Private; delivery format TBD.
* [Design System Registry](packages/design-system-registry/) (**deprecated** — registry data has moved to `packages/design-data/registry/`. Use `@adobe/spectrum-design-data` instead.)
## Documentation & Visualization
* [Spectrum Token Visualizer Tool](docs/visualizer/) a visualizer for inspecting S1 tokens. Published as a [static site](https://opensource.adobe.com/spectrum-design-data/visualizer/).
* [Spectrum Token Visualizer Tool S2](docs/s2-visualizer/) a version of the visualizer that shows the Spectrum 2 data. Published as a [static site](https://opensource.adobe.com/spectrum-design-data/s2-visualizer/).
* [Spectrum S2 Tokens Viewer](docs/s2-tokens-viewer/) an enhanced token viewer with component usage analysis for Spectrum 2 tokens.
* [Spectrum Tokens Docs](docs/site/) a static site to show the component options API and other token data.
* [Release Timeline Visualization](docs/release-timeline/) interactive charts showing release frequency and development activity patterns. Published as a [static site](https://opensource.adobe.com/spectrum-design-data/release-timeline/).
* [Spectrum 2 Documentation](docs/s2-docs/) comprehensive component guides and design principles from s2.spectrum.corp.adobe.com.
## Development Tools
* [Component Options Editor](tools/component-options-editor/) Figma plugin for authoring and editing Spectrum component option schemas with visual UI and JSON validation.
* [Spectrum Token Diff Generator](tools/diff-generator/) a library and cli tool that reports changes made between two schema/releases/branches.
* [Optimized Diff Engine](tools/optimized-diff/) high-performance diff algorithm for large token datasets.
* [Release Analyzer](tools/release-analyzer/) tool for analyzing release history and generating data for change frequency visualization.
* [Token Changeset Generator](tools/token-changeset-generator/) automates creation of changeset files from token diff analysis.
* [Transform Tokens JSON](tools/transform-tokens-json/) utilities for merging and transforming token data between formats.
* [Token Manifest Builder](tools/token-manifest-builder/) generates manifest files for token distribution.
* [Spectrum Design Data MCP](tools/spectrum-design-data-mcp/) Model Context Protocol server providing AI assistants with structured access to Spectrum design system data.
* [Design Data Agent MCP](tools/design-data-agent-mcp/) agent-facing MCP server (distinct from the general MCP above) for AI agent authoring sessions.
* [Design Data Skill](tools/design-data-skill/) packaged Claude Code agent skill for consuming Spectrum design data from agent sessions.
* [S2 Docs MCP](tools/s2-docs-mcp/) MCP server providing AI assistants with access to Spectrum 2 component documentation and design guidelines.
## SDK & TUI
* [design-data](sdk/cli/) unified CLI and interactive TUI — validate, resolve, diff, query, and migrate tokens from the command line; run bare (`design-data`) to launch the interactive TUI (command palette, cascade resolver, validator, four-screen authoring wizard). The TUI library lives in [sdk/tui/](sdk/tui/).
## Setup monorepo locally
1. Install pnpm using [this guide](https://pnpm.io/installation).
2. Install dependencies
```bash
pnpm i
```
### Build all packages locally
Run build script
```bash
pnpm moon run :build
```
### Run all tests locally
```bash
pnpm moon run :test
```