Fieldnote Design System
A shared component library and documentation site that brought three drifting product teams onto one visual language.
- design systems
- B2B SaaS
- documentation
- accessibility
Context
Fieldnote's analytics platform had grown through three separate product teams. Each maintained its own buttons, tables and colour palette, and customers moving between modules felt like they were switching products.
My role
Design systems lead
Problem
Inconsistent components slowed every release. Designers rebuilt the same patterns, engineers maintained parallel implementations, and accessibility fixes made in one module never reached the others.
Process
I began with a full interface audit, cataloguing every variant of each component across the product. Working with an engineer from each team, we agreed on a core set of foundations: colour, type, spacing and data-table patterns. We shipped them incrementally, one module at a time, instead of attempting a single big-bang migration.
Decisions
We used design tokens as the single source of truth, shared between the design tool and the codebase. Components were built to meet WCAG contrast and keyboard requirements by default, so teams inherited accessibility rather than retrofitting it. A lightweight contribution model let any team propose a new pattern, with a fortnightly review to keep the library focused.
Outcome
All three teams adopted the core library for new work, and the most-used components were migrated across the product. Designers reported spending far less time on repeated layout work, and accessibility issues fixed in the library now reached every module at once.
Lessons
A design system is a product with its own users. The documentation site and office hours did more for adoption than the components themselves. I would start the contribution model earlier, since teams trusted the system more once they could shape it.
Starting with the data table
Rather than beginning with buttons and colour, we started with the data table, the most complex and most duplicated pattern in the product. Solving the hardest shared problem first earned credibility with engineers and made the simpler components an easy follow-on.