Design Systems Principles

Notes From Building Systems

I have spent years building design systems, teaching frontend development, and exploring how AI changes the way teams write software. These are the principles that show up across my work.

Operating Model

I build systems, teach systems, and help AI work with systems.

The projects are different, but the pattern is consistent: make the model visible, reduce the number of unsupported decisions, and help people move from standards to adoption.

01

Documentation is not governance

Documentation matters, but it is not enough. A system succeeds when it influences decisions at the moment work happens.

That means moving standards into contribution workflows, lint rules, validation mechanisms, and AI-assisted review loops.

02

Design systems are adoption problems

The hard part is not building a component. The hard part is helping teams choose it, trust it, extend it, and avoid rebuilding it differently elsewhere.

Pine had to support 40+ engineers across 6 product teams while giving teams a practical path from Sage-era UI to a modern component system.

03

Dark mode reveals debt

Dark mode did not create the technical debt. It revealed it. A second theme exposes hardcoded colors, legacy assumptions, disconnected styling systems, and places where the system was not actually being followed.

The work behind Kajabi Admin dark mode was really a platform architecture, semantic token, migration, and compatibility problem.

04

AI is a new design system consumer

Design systems used to be written for designers and engineers. AI-assisted development adds another consumer: the agent generating code.

That changes how systems need to expose guidance, constraints, examples, and validation before generated UI reaches production code.

05

The right thing should be easier than the wrong thing

Good systems reduce judgment fatigue. They make the expected path easier to find, easier to implement, and harder to accidentally bypass.

Component APIs, design tokens, accessibility standards, and learning materials all work best when they make the preferred path obvious.

06

Teaching is system design

Teaching frontend development has shaped how I build systems. If people cannot understand the model, they cannot adopt it.

Learn.QuintonJason.com applies the same principle to students that design systems apply to product teams: structure the material so people can move from concepts to practice.

Related Work

The principles show up in the work.

Pine, Pine MCP, Kajabi Admin Dark Mode, Learn.QuintonJason.com, and my writing all point at the same problem: systems only matter when people and tools can actually use them.

View work