Design Tokens Pro is officially live

My guide to design tokens now has a home at designtokens.pro.

It started as a project on Notion, shared through a link. That was a simple way to put what I knew in one place and let other people read it.

Now it’s available on its own website, with a PDF option if you prefer reading offline or keeping a copy nearby while you work.

This feels like a good moment to give it a proper introduction.

I’ve spent years working on different design systems, from B2B products to editorial platforms and public sector projects. I’ve put everything I know about design tokens into this guide, drawing on that experience.

A lot of the work comes down to questions that sound small until you have to answer them. What should we call this token? Does it need a semantic alias? How do we support another theme? How much should we document so someone else can actually use it?

Those are the kinds of questions I wanted the guide to help with.

Design Tokens Pro has eight chapters and more than 100 pages, covering the basics, naming, architecture, compound tokens, themes, lifecycle, and documentation. There are practical JSON examples and code snippets throughout. You can read it from the beginning or jump to the topic you’re working on.

One idea from the guide matters a lot to me: “Translate values into design decisions.” Giving a value a name is only part of the work. The name should help people understand what that value is for and when to use it. Getting that right takes thought, conversations, and sometimes a few revisions.

I hope the guide makes those decisions a little easier, whether you’re starting your first token set or sorting out one that has grown over time.

You can explore the guide and get two free chapters on the website.

And if you read it, I’d love to hear what you think, especially what you find useful and what you feel is missing.

Go to designtokens.pro ->