26
Our design system went from a PDF to a live site and it changed everything
For about two years, our team's design system was a 50-page PDF living in a shared drive. It had all the right parts, but nobody used it because it was a pain to find anything. A designer would ask, 'What's the hex for our primary button again?' and we'd all just shrug. Six months ago, we moved the whole thing to a simple internal website built with Zeroheight. Now, you can search, copy code snippets right from the page, and see live component examples. The change was huge. In the first month after launch, our dev team reported a 30% drop in questions about basic styles. It stopped being a dusty rulebook and became a tool people actually open every day. The big shift wasn't the rules themselves, but making them easy to get to. Has anyone else seen a simple format change make that big of a difference for adoption?
3 comments
Log in to join the discussion
Log In3 Comments
the_river1mo ago
Yeah, that bit about it going from a dusty rulebook to a tool people open every day hits home. A friend at another company had the same thing with their brand guidelines, which were just a huge PowerPoint file. They moved it all into Notion where you could actually click on things and copy colors, and suddenly the marketing team stopped making up their own logos. It's crazy how much just being able to search and copy a code snippet changes how people work. What was the hardest part of moving your system over?
4
danieljenkins6d ago
...and that 30% drop in basic questions is exactly what I saw too, not with a design system but with our internal process guide. We had this 40 page Word doc for how to request time off, submit expenses, all that boring stuff. Nobody ever opened it. They'd just ask the office manager the same three questions every single week. We moved it to a simple Google Site with a search bar and links to the actual forms. Suddenly people started reading it. The office manager said her email volume on that stuff dropped by half in two weeks. It's wild how we all think we just need better rules when really we just need the rules to not be buried. People aren't lazy, they just don't want to dig through a PDF every time they need one number.
4