Note: for Spectrum 2 token data has been graduated to the main branch. If you need access to the S1 data, use the s1-legacy branch and v12.x.x packages on NPM.

The Spectrum token visualizer shows the token data for S1. For Spectrum 2 data, use opensource.adobe.com/spectrum-tokens/s2-visualizer/.

Spectrum Tokens Monorepo

This repo uses:

• pnpm for package management
• moon to manage task running
• Changesets for automated versioning and releasing
• Prettier for code formatting/linting
• commitlint and Convetional Commits to standardize commit messages
• husky to automate formatting of committed files and linting of commit messages

Packages in this monorepo:

Core Packages

• Spectrum Tokens design tokens for Spectrum, Adobe's design system.
• Spectrum Component Schemas JSON schemas for validating Spectrum component APIs and properties.

Documentation & Visualization

• Spectrum Token Visualizer Tool a visualizer for inspecting S1 tokens. Published as a static site.
• Spectrum Token Visualizer Tool S2 a version of the visualizer that shows the Spectrum 2 data. Published as a static site.
• Spectrum S2 Tokens Viewer an enhanced token viewer with component usage analysis for Spectrum 2 tokens.
• Spectrum Tokens Docs a static site to show the component options API and other token data.
• Release Timeline Visualization interactive charts showing release frequency and development activity patterns. Published as a static site.

Development Tools

• Spectrum Token Diff Generator a library and cli tool that reports changes made between two schema/releases/branches.
• Optimized Diff Engine high-performance diff algorithm for large token datasets.
• Release Analyzer tool for analyzing release history and generating data for change frequency visualization.
• Token Changeset Generator automates creation of changeset files from token diff analysis.
• Token CSV Generator exports token data to CSV format for analysis and reporting.
• Transform Tokens JSON utilities for merging and transforming token data between formats.
• Token Manifest Builder generates manifest files for token distribution.
• Spectrum Design Data MCP Model Context Protocol server providing AI assistants with structured access to Spectrum design system data.

Setup monorepo locally

1. Install pnpm using this guide.
2. Install dependencies

   pnpm i

Build all packages locally

Run build script

pnpm moon run :build

Run all tests locally

pnpm moon run :test