Conductor Design System

Conductor extracts the visual language of agent-ai-platform/packages/web into reusable packages: a three-tier design token source, a framework-agnostic stylesheet, and Radix-based React primitives. Dark is the canonical theme; light is a second palette over the same semantic keys. Conductor ships npm packages and a static documentation site — there is no server runtime.

Packages

Package	Path	Description
@conductor-by-89soone/tokens	packages/tokens	Three-tier token source and the buildTokens / checkContrast CLIs
@conductor-by-89soone/css	packages/css	Framework-agnostic stylesheet, cascade-controlled by @layer cdt.*
@conductor-by-89soone/react	packages/react	React primitive components
docs (private)	apps/docs	Static documentation site, Conductor's first consumer

Dependency direction is strictly tokens → css → react → docs. A reverse reference fails pnpm lint:deps with exit code 1.

Commands

Command	Description
pnpm build	Checks dependency direction, then builds tokens → css → react → docs in order
pnpm test	Vitest unit and contract tests
pnpm typecheck	tsc --noEmit across every workspace package
pnpm lint	ESLint
pnpm lint:deps	Fails if a package declares a dependency outside the allowed direction

Requires Node 20+ and pnpm 10+.

Using Conductor in production

Conductor is 0.x. Until 1.0.0, a minor release may change how existing components look (its changeset starts with Visual change:), so:

• Pin exact versions of all three packages ("0.18.0", not "^0.18.0") and upgrade on purpose.
• When you upgrade, compare your screens before and after — screenshots of your main routes in both themes are enough.
• Read the package CHANGELOG.md for the minors you skip.

From 1.0.0 the three packages share one version, and removing or renaming a public export, cdt-* class, --cdt-* property or CLI option requires a major release. See SECURITY.md to report a vulnerability.

Documentation

The requirements, architecture, and delivery plan live in docs/README.md. Code implements the approved scope in docs/10_requirements/srs_final.md, one work package at a time from docs/40_delivery/conductor_work_packages.md.

License

MIT. See LICENSE.