Token interoperability roadmap

[seonghobae]

Current role

Canonical meta issue for the current token interoperability roadmap.

Current state

The repository still has concrete interoperability requests in flight:

• Feature: add CSS custom properties export (--format css-vars) for native CSS consumers #15 CSS custom properties export
• Support for Tailwindcss version 4.0 & above #19 Tailwind v4 export support
• Support creation of DESIGN.md from DTCG tokens.json #28 DTCG tokens.json -> DESIGN.md creation/import
• Support OKLCH colors #27 OKLCH color support

Current-code inspection on origin/main still shows the repository-baseline blocker on main:

• root bun run build fails because Turbo cannot resolve workspaces without a root packageManager field
• root bun run test and bun run lint fail through the same missing root contract
• bun install emits warn: incorrect peer dependency "ink@7.0.1" from stale CLI dependencies that are not imported by the current source tree
• .github/workflows/test.yml still works around the repo-level build contract by building only packages/cli and by using bun-version: latest

Current code validity

This roadmap remains current-code-valid because:

• packages/cli/src/commands/export.ts still exposes only tailwind and dtcg
• packages/cli/src/index.ts exposes no import / round-trip command
• README.md and docs/spec.md still document hex sRGB colors and one-way export surfaces only
• main still contains the workspace/build reliability gap described above

Current code evidence

• package.json
• packages/cli/package.json
• packages/cli/tsconfig.json
• packages/cli/src/index.ts
• packages/cli/src/commands/export.ts
• .github/workflows/test.yml
• README.md
• docs/spec.md

Hierarchy

This issue is the parent/meta issue for the active interoperability program.

Execution items currently linked under this roadmap:

• Restore root Bun/Turbo build contract and remove stale Ink peer mismatch #30 — workspace/build reliability blocker
• Feature: add CSS custom properties export (--format css-vars) for native CSS consumers #15 — native CSS consumer export surface
• Support for Tailwindcss version 4.0 & above #19 — Tailwind v4 export surface
• Support creation of DESIGN.md from DTCG tokens.json #28 — DTCG -> DESIGN.md import surface

Cross-cutting linked issue:

• Support OKLCH colors #27 — OKLCH color support (spec/fidelity dependency, but not a required blocker for every export slice)

Execution sequence

1. Restore workspace/build reliability on main (Restore root Bun/Turbo build contract and remove stale Ink peer mismatch #30)
2. Continue export interoperability delivery (Feature: add CSS custom properties export (--format css-vars) for native CSS consumers #15 / Support for Tailwindcss version 4.0 & above #19)
3. Add round-trip/import surface (Support creation of DESIGN.md from DTCG tokens.json #28)
4. Expand spec fidelity for modern color models (Support OKLCH colors #27) where needed

External blocker evidence

• Formal sub-issue wiring is not currently available from this account for this repository, so hierarchy is recorded via issue body and issue comments.
• Milestone creation is also unavailable from this account for this repository (404 Not Found from the milestones creation API), so milestone intent is recorded here rather than applied as repo metadata.
• Open contributor PRs feat: foundational infrastructure for CSS Custom Properties export #20 and feat(tailwind): add Tailwind v4 CSS-first export #21 are blocked by CLA checks, so the repo-owned path from origin/main remains the canonical delivery path.

Completion conditions

• repo baseline build/install/lint path is reliable on main
• the active interoperability execution tree is linked from this issue
• remaining work is represented by concrete child or related issues with a clear order

[seonghobae]

Execution links for the current roadmap:

• Blocker issue: Restore root Bun/Turbo build contract and remove stale Ink peer mismatch #30 — restore the root Bun/Turbo build contract and remove the stale Ink peer mismatch
• Export surfaces already in scope: Feature: add CSS custom properties export (--format css-vars) for native CSS consumers #15, Support for Tailwindcss version 4.0 & above #19
• Round-trip/import surface: Support creation of DESIGN.md from DTCG tokens.json #28
• Cross-cutting spec/fidelity follow-up: Support OKLCH colors #27

Sub-issue wiring is not available with the current repository permissions from this account, so these relationships are recorded here explicitly.