Re: [community-group] Proposal: JSON Schema $ref for aliases (breaking change) (#259)

> if we adopt JSON Schema holistically, we can allow tokens to reference arbitrary parts of other tokens (or documents) in future.

Could you provide an example of what that looks like? JSON Schema exists to enforce a top-down, fixed _schema_ for something. You cannot store values in JSON Schema; it is only meant for validation of external files. My understanding is that “adopting JSON Schema holistically” would fundamentally change the DTCG spec from an interchange format to a format where people can validate files they’ve written themselves.

I think you may be missing some context here—the purpose of this spec reacts to something like Style Dictionary, where users can create token syntax adhoc, but from one design system to another tools and code isn’t as portable. The DTCG spec was created to create common, standard formats for design tokens in JSON that could be shared across systems. The goal is not to constrict what folks do, rather, just reduce reinventing the wheel.

If I’m misunderstanding, perhaps a more concrete example would help—could you, say, recreate a color system from an open design system illustrating what you had in mind? I think providing more concrete code could really help clear some confusion here on both sides.

> There are no legitimate downstream consumers yet, this specification is not final. There is still time to make a clean break.

This isn’t true. There are many, many legitimate downstream consumers, including GitHub, Figma, The Guardian, and more. Pen Pot, Tokens Studio, Styled Dictionary, and Terrazzo are all tools that support the latest draft versions of the spec.

-- 
GitHub Notification of comment by drwpow
Please view or discuss this issue at https://github.com/design-tokens/community-group/pull/259#issuecomment-3289764105 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Sunday, 14 September 2025 18:34:36 UTC