Taking on 2 founders this quarter, the kind who want a designer who can drive the work without hand-holding.
Healthcare, SaaS, EdTech, B2B tools. 0-to-1. Messy products that need rescuing.
Split it into two separate decisions:
1. Intent = brand (your primary color), neutral, destructive. that's it
2. Type = filled, outlined, or ghost
Now you're not stacking hierarchy on top of style. You combine intent + type and get exactly what you need, without inventing a new "tertiary" every time a designer wants one more button.
Still don't get why so many design systems name colors/buttons "primary, secondary, tertiary"
Here's why I don't recommend it:
- It doesn't scale. what comes after tertiary? quaternary? Nobody's typing that.
- It's a ranking, not a meaning. "primary" tells you nothing about when to use it, just that it's "the important one". It doesn't say what the color actually is or why it exists.
- Teams could end up with two "primary" buttons on one screen because stakeholders said both matter.
- It breaks the second you theme, since you're managing rank instead of purpose.
My suggestion๐
Little Claude habit:
Always expand the thinking output before reading the response.
Understanding WHY it makes certain decisions teaches you more than the answer itself.
Updates on journey building Capsule UI into code:
Dropped a full dashboard screen (Dittowords) on Claude as a test. It used the right semantic tokens throughout, no hardcoded hex, no invented values.
The first pass is tedious: getting the rules tight, wiring the token pipeline. But once it clicks, the logic of preparing a Figma kit for LLMs starts to feel surprisingly natural.
Deep in the rabbit hole trying to make Capsule UI AI-readable so an LLM can open the project and generate correct component code on the first try.
Finally found a clean way to keep tokens in sync: Tokens Studio > JSON > a Node script that converts to DTCG format (Style Dictionary v5). Change a color in Figma, push the JSON, run the script: primitives.css and semantic.css rebuild automatically.
Wild how building with Claude unlocked in me a whole new DS level.