Creating a Single Source of Truth (SSOT) for Atomic Design
Creating a Single Source of Truth (SSOT) is a fundamental step in Atomic Design. The SSOT serves as the central repository of all design elements, ensuring consistency and accuracy across the entire design system.
The first stage in creating an SSOT involves defining the global elements: the atoms. This includes universal aspects such as typography, color palette, grid system, and spacing rules—for example, that H1 text is bold and large. This definition of an H1 then would be universal throughout the entire project, as it would be inherited by other elements further up in the Atomic Design hierarchy (the molecules, organisms, templates, and pages).
At b13, we work mainly with Figma and cloud-based design. This allows us to build an Atomic Design system efficiently, linking design files, reusing elements at any level of the hierarchy, connecting libraries, and adding documentation and external links. This network of design files provides consistency and scales easily as a website grows and expands.
At the beginning of a project, we first create a file to define all of the atoms—this will be our Single Source of Truth. We begin with the basics, defining the main color, supporting colors, and the font. Building on that, we declare headlines, links, and buttons. These are styles that are going to be consistent throughout the website, and could even provide universal definitions across multiple websites of the same client.
We then create one primary component for each defined element. Each time we use or reuse that component, a new instance is created. All changes made to the primary component will be inherited by its instances.
For example, we define a button as a component and make it blue. After placing it in ten different places on three different pages, we decide the button actually needs to be red. Instead of changing every button manually, we simply change the primary component and all other instances of it instantly inherit the change. You can immediately understand how this can save you time and hassle: When you are 500 (or 10,000) pages into building your site, with an SSOT, you can make one change that will update all the buttons. Without that central definition, you’d need to make 500 individual changes.