Every theme in every static site generator gallery was designed from the same direction. Start from the user’s comfort. Work backward toward minimalism. Stop when it feels like enough. Add some tasteful touches. Ship.
The result is a thousand themes that balance on the edge of minimalism without ever falling over it. A little bit of whitespace. A little bit of serif. A little bit of muted color. A little bit of everything and a lot of nothing. The themes land in the middle because the middle is safe. The middle is rational. The middle is where nobody complains and nobody remembers.
I went the other direction. I went full nuclear first. And then I looked back.
The Wrong Direction
The conventional approach to theme design asks: what will the reader tolerate?
This question produces compromise. The designer starts with a blank page and adds elements until the page feels “enough.” Enough typography. Enough color. Enough spacing. Enough personality. The threshold is comfort. The goal is adequacy. The reader should not be confused, not be alienated, not be challenged. The theme should be pleasant.
Pleasant is the enemy of memorable. Nobody remembers pleasant. Nobody screenshots pleasant and sends it to a friend. Nobody chooses a publishing platform because the theme was adequate. Pleasant themes are wallpaper. They exist behind the content without contributing to it. They are the visual equivalent of hold music – technically present, functionally absent.
Hugo has hundreds of themes. Name three. Gatsby had a theme ecosystem. Name one. Jekyll themes powered millions of blogs. Which one made you feel something? Which one had a personality you could describe in a sentence? Which one would you recognize from a screenshot without seeing the content?
The themes are forgotten because they were designed to be inoffensive. Inoffensive is another word for invisible. And invisible themes produce invisible blogs.
Full Nuclear
The Brutalist theme in note2cms does not ask what the reader will tolerate. It does not care.
IBM Plex Mono. The entire blog in monospace. Not just code blocks – body text, headings, dates, tags, navigation. Everything in a typeface designed for terminals and code editors, applied to prose without apology.
Four-pixel black borders. Not hairline borders. Not subtle separators. Four pixels of black on every container, every card, every section boundary. The borders are not decorative. They are structural. They say: this is a box. The content is inside. The border is the wall.
Zero color. Black text on white background. No accent color. No brand color. No subtle tint on the headings. No muted tone on the metadata. Black and white. The entire chromatic range of a photocopied document.
Zero curves. No border-radius. No rounded corners. No soft edges. Every element is a rectangle with ninety-degree angles. The page is a grid of boxes. The boxes do not apologize for being boxes.
This is not minimalism. Minimalism implies careful reduction – a designer choosing what to remove. This is brutalism. It implies no choice at all. There is nothing to remove because nothing was added. The theme is the default state of HTML with a monospace font and thick borders. It is what a web page looks like before a designer touches it, except the designer touched it deliberately to keep it that way.
Every SSG theme designer looked at this combination and said: too much. Too stark. Too aggressive. Too uncomfortable. The reader will not tolerate this. The designer is correct – the reader will not tolerate this in a theme that is trying to be pleasant. But the Brutalist theme is not trying to be pleasant. It is trying to be honest. And honesty in monospace with four-pixel borders is more memorable than pleasantry in Georgia with a muted color palette.
Then One Trick
After going full nuclear – after committing to the extremity without reservation, without escape hatches, without a “but we should soften this” compromise – then and only then did I add one trick.
The hover inversion. When you hover over a post title in the index, the entire row flips. White text on black background. Instant. No transition. No easing. No animation duration. Binary. On or off. Zero or one.
The CSS is two lines:
That is the entire trick. Two properties. On any other theme – on a theme with color, with curves, with decoration – this hover effect would be invisible. One more visual event in a sea of visual events. The reader would not notice because there would be nothing to notice against. The baseline is already active. The trick has no contrast to work with.
On Brutalist, the hover inversion is an event. The reader has adjusted to the austerity. Their eye has accepted that this page will not do anything interesting. It is monospace text in black-bordered boxes. What could it possibly do?
And then they hover. And the row inverts. And they stop moving their mouse. And they hover again to confirm what happened. And they remember.
The trick works because of what preceded it. The austerity earned the inversion. The silence earned the sound. The nuclear commitment earned the single violation. The trick is not the two lines of CSS. The trick is the entire theme leading up to those two lines.
The Sequence
This is the discovery: extreme first, trick second. Never the reverse.
The SSG theme world does it backwards. Start moderate, add tricks to make it interesting. An animation on page load. A parallax scroll effect. A gradient that shifts on hover. A card that lifts with a shadow. A dozen tricks scattered across a theme that committed to nothing. The tricks compete for attention. None of them land because none of them have contrast. The theme is a moderate baseline with moderate violations. The result is moderate impact.
note2cms themes follow the opposite sequence. Commit to an extreme. Go all the way. Do not stop at the edge. Fall over it. Live there. And then – only then – add one trick from the opposite direction.
The Ink theme commits to stillness. Japanese calligraphy aesthetics. Cormorant Garamond on rice paper. Vermillion accents. Everything is quiet, poised, motionless. The metaphor is a scroll in a temple. Scrolls do not move. And then on page load, a vermillion brushstroke unfurls beneath the title – left to right, with a slight overshoot, like wet ink dragged across paper. One animation. One moment of motion. The stillness earned it.
The Darkroom theme commits to darkness. Source Serif on deep black. Amber accents like a safelight in a windowless room. A radial vignette darkening the edges. The metaphor is a photography darkroom. Everything is dim. And then images “develop” – they start nearly black with sepia toning and slowly emerge into full visibility, like a photograph materializing in a tray of developer fluid. One animation. One reveal. The darkness earned it.
The Manuscript theme commits to academic austerity. Literata body text. Courier Prime metadata. Cream paper. A vertical red line in the margin like ruled notebook paper. The metaphor is a reviewed academic paper. And then section headings get automatically numbered in the margin – faint red annotations that brighten on hover, as if a reviewer had penciled them in. One trick. One implication that someone has already read this document. The austerity earned it.
Each theme goes nuclear in one direction. Each theme adds one trick from the opposite direction. The nuclear commitment is what makes the trick land. Without the commitment, the trick is decoration. With the commitment, the trick is revelation.
Why Nobody Did This
The SSG theme designers did not lack skill. Many of them are better designers than I am. They did not lack tools – CSS animations, transitions, pseudo-elements, and keyframes have been available for a decade. They did not lack imagination – the CSS art community proves that browsers can render anything.
They lacked permission. The implicit contract of an SSG theme is that it should serve the content without challenging the reader. The theme should be a container, not a participant. The designer’s job is to disappear – to create a vessel so neutral that any content fits inside it.
This contract produces adequate themes. It does not produce memorable ones. Because a theme that disappears cannot, by definition, be remembered. And a theme that cannot be remembered cannot differentiate one blog from another. And blogs that cannot be differentiated are blogs that nobody bookmarks, nobody returns to, nobody recommends.
note2cms broke this contract by refusing to sign it. The themes are participants, not containers. The Brutalist theme does not disappear behind the content. It frames the content with four-pixel borders and monospace type and dares the content to be worthy of the frame. The Ink theme does not neutrally present the content. It sets a mood of calligraphic stillness and then breaks it with one brushstroke. The Darkroom theme does not politely display images. It develops them like photographs, making the reader wait and watch.
The themes have opinions. The themes have personalities. The themes have tricks. And the tricks work because each theme committed to an extreme before adding the trick. The commitment is the permission. The extreme is the context. The trick is the payoff.
The Validation
The strongest validation of this approach is not that people liked the themes. It is that garrul4ik – the first outside contributor, a developer who has written themes himself, who understands every CSS trick available – chose Brutalist for his own blog and never switched.
He did not choose it because he lacks options. He has eight themes available and has built more himself. He chose it because he understands what Brutalist offers that no other theme does: the dare. Brutalist dares the writer to be good enough. It offers no decoration to hide behind. No atmosphere to lean on. No visual warmth to compensate for weak prose. The words carry themselves or they do not.
His blog has Shakespeare’s Hamlet. A Telegram privacy expose. An Obsidian plugin announcement. A heroic Russian ode. Technical documentation and medieval poetry and security journalism – all in uppercase IBM Plex Mono with four-pixel black borders. Every post works because the theme demands that the content work. The austerity is the quality filter.
A chef who cooks elaborate meals for others eats simply at home. A theme designer who builds visual experiences for others publishes in Brutalist. Both know what is possible. Both chose what is honest.
The Principle
Go nuclear first. Commit to the extreme. Do not stop at the edge of monochrome, or the edge of stillness, or the edge of darkness, or the edge of austerity. Fall over the edge. Live there.
Then add one trick. Only one. From the opposite direction. A moment of motion in a still design. A flash of color in a monochrome design. A reveal of light in a dark design. A whisper of annotation in an austere design.
The extreme earns the trick. The trick rewards the reader for engaging with the extreme. The combination – commitment plus violation – is what the reader remembers.
A dozen tricks on a moderate theme is noise. One trick on a nuclear theme is music.
That is the visual flair principle. That is why note2cms themes feel designed when SSG themes feel generated. Not because the CSS is more complex. Because the commitment is more total. The themes went somewhere the SSG world was afraid to go. And from that place, one small trick was all it took.
Go nuclear first. Then add one trick. The extreme earns the trick. The trick rewards the reader. Everything else is wallpaper.