Suede started with a foundation: a restrained WordPress design system built around typography, space, contrast, imagery, and composition.
With version 0.4, I wanted to make more of the thinking behind that system explicit, while beginning to turn those decisions into capabilities that can be used directly inside WordPress.
The idea has become central to how I think about the project:
Suede isn’t designed around a collection of styles. It’s designed around a system of decisions.
Version 0.4 is the first release where that idea becomes tangible in both the documentation and the theme itself.
DESIGN.md and design intelligence
The most important addition in Suede 0.4 might not be something you see in the WordPress editor.
Suede now ships with DESIGN.md, an intelligent source of truth for the design system. It defines not only the specifications behind Suede, but the reasoning that should guide how they are applied.
It covers the major parts of the system:
- Principles and composition
- Typography, color, layout, and spacing
- Shape, depth, interaction, and iconography
- Imagery, motion, responsive behavior, and accessibility
The distinction matters. A list of tokens can tell you which font size or spacing value is available. It cannot tell you what deserves attention, when to introduce contrast, why an image should carry more visual weight, or when subtraction is a better decision than adding another element.
DESIGN.md provides that context.
It also makes Suede more useful in AI-assisted design workflows. An agent can read the same design guidance a person can, giving it more context than it would get from inspecting theme.json, patterns, and CSS.
That is what I mean by design intelligence: making the decisions behind the system portable along with the system itself.
Expressive typography with Display
Version 0.4 also introduces Display, a new style variation built around the variable-width capabilities of Google Sans Flex.
Rather than introducing another typeface, Display extends the existing one across three distinct proportions for greater expressive range:
Condensed — 85%
Standard — 100%
Standard remains the foundation. Condensed can introduce density, verticality, or greater scale within limited horizontal space. Expanded creates presence and horizontal scale for large editorial statements, numerals, pull quotes, and other moments that deserve more territory.
The widths are expressive tools, not alternate defaults.
One typeface. Three widths. One system.
Behind the scenes, I also optimized Google Sans Flex specifically for Suede. The original variable font was roughly 4 MB. The version shipping with Suede is approximately 200 KB while retaining the capabilities the system actually uses: weight, width, and slant.
There is something appropriately Suede about that: remove what isn’t necessary while making what remains more useful.
Extending Suede with the Icon block
Suede 0.4 also registers the Suede mark for use with the Icon block.
Previously, patterns using the mark treated the SVG as an image. Registering it through the Icon block API means the mark can now behave like an icon, with the controls and flexibility that come with the block.
It’s a small change, but it follows the same direction as Display: taking something that previously required a workaround and expressing it more naturally within WordPress.
That creates a useful filter for future development: identify the recurring design decisions Suede makes, then find the most natural way to express them within WordPress.
Where Suede goes next
A clearer progression is beginning to emerge for the project:
0.3 — Foundation
0.4 — Design intelligence
0.5 — Composition
Composition feels like the natural next problem to explore.
Suede already defines ideas around reading measure, wide composition, hierarchy, rhythm, negative space, scale, and relationships between typography and imagery. The interesting question is how to make more of that thinking tangible inside WordPress without turning Suede into a collection of rigid templates.
Suede 0.4 isn’t about adding more options. It’s about making the system more capable and the thinking behind it more explicit.
The goal isn’t to make Suede bigger. It’s to make the system smarter.