
August 17, 2026
4 min read
Every Project Starts with a Style Guide
Blue Monkey Makes
A page added six months after launch looks slightly off. The heading is a little heavier. The button has a different radius. The spacing feels looser than everything around it.
Nobody made a bad decision. The visual rules just weren't written down.
This is a predictable outcome when design decisions exist in someone's head rather than in a document. The developer remembers the exact green. The designer recalls why the type scale skips a step. But the next piece of work starts: a new section, a landing page, a feature added months later. Those decisions get re-made. Usually close. Not always consistent.
What we document before building
Before production code begins, we build a living style guide for the project. Not a mood board. Not a loose collection of UI screenshots. A decision document that defines how the project looks and behaves.
It covers:
- Color palette: not just swatches, but usage rules. Which color is the primary action color. What draws attention in a neutral section. Where accent colors apply and where they don't.
- Typography: the full type scale from display headings down to captions. Which weights apply where. How hierarchy is communicated through size and spacing, not just font choice.
- Spacing and layout: how content breathes. Consistent margins, padding, and grid decisions that make a page feel considered rather than assembled.
- Components with usage notes: buttons, cards, forms, navigation patterns. What each element is for, when to use it, and when to reach for something else.
These aren't abstract design principles. They're answers to specific questions that come up every time something new gets added.
Brand guidelines, honored and extended
If the client has existing brand guidelines, they're the starting point, not an obstacle and not something to override.
Established colors, wordmarks, typefaces, and brand personality all come into the style guide. Existing guidelines often have gaps: a defined palette but no web type scale, or a logo but no documented component behavior. We add to them. The goal is a complete working system for the project, built on what the business already owns.
For businesses earlier in their brand development, this process often produces guidelines they didn't have before. Those belong to the client.
Voice and user stories belong here
The same phase that establishes the visual system is when we define or confirm the content voice and user stories for the project.
Who is this site actually for? What are they trying to accomplish when they arrive? What does the brand sound like to them, and is that voice consistent across the homepage, service pages, and the contact flow?
These questions sit alongside the visual decisions because they shape the same thing: how someone experiences the project. A homepage that looks right but sounds wrong has the same coherence problem as one that sounds right but looks scattered.
Documenting voice and user stories at this stage also prevents a common kind of drift, where the visual system stays consistent but copy added later reads like it was written by a different business.
Approval before building
The style guide gets reviewed and approved before the full build begins. This isn't sign-off as a formality. It's how both sides reach a shared understanding of what the project is before significant work has been committed.
Feedback at this stage is inexpensive. "This doesn't feel right" costs almost nothing to address when the system is still being defined. The same feedback six weeks into a build is expensive. By then, those decisions are embedded everywhere.
Approval also changes the nature of feedback later. A client who has reviewed and signed off on a documented color system has a reference point. So does the team building it. Disagreements shift from matters of taste to matters of record.
A deliverable that outlives the project
The style guide ships with the project. It's part of what gets handed over at the end.
This matters because most projects don't end. They continue. New pages get added. Features get built. Someone new joins the team or takes over the work. When that happens, they start from a documented system rather than from trying to reverse-engineer decisions out of existing pages.
Consistency, at that point, isn't dependent on institutional memory. It's in the guide.
The site you launch is one thing. The system it's built on determines what everything after the launch looks like.


