How waterfall looks, and why.

Light pages, one luminous ribbon, a mark called the Drop, and the product shown big. Everything here is generated from one approved source, so people and agents build the same thing.

Colour: ink, blue, and light.

Pages are white and tint. Ink carries words. Blue means action, links, and the mark. Green is only ever money saved. The ribbon is the one place colour sings.

Do

Keep blue scarce so it always means "you can act here".

Don't

Use green for anything but savings, or put body text on the ribbon.
--ink #0a2540--blue #0a6fd6--tint #f6f9fc--good #08744e
Ink#0a2540
Blue#0a6fd6
Tint#f6f9fc
Saved#08744e
Ribboncyan, blue, violet, teal

Typography: light and large.

One family, Inter Tight, self-hosted. Headlines are big and light (weight 300) with tight tracking. Labels are sentence case, never tracked capitals.

Do

Let one headline carry the page. Keep body at 17px with room to breathe.

Don't

Use bold display type, uppercase eyebrow labels, or text under 12px.
72 / 300 / -0.035em48 / 30017 / 400 / 1.6

Pay the least.

A real cascade.

One local board for all your repos.

Sentence-case labels, 12px minimum.

Ribbon: the one art layer.

A luminous cascade of cyan, blue, violet, and teal, crossed by fine falling lines. It appears twice: behind the hero, and again in the closing band.

Do

Let it bleed off the top right and fade into white before it reaches the words.

Don't

Add a second art style, or place copy or the mark on top of it.
var(--ribbon)clip-path + mask

Product: show the board, big.

The local board is the hero image: large, overlapping the ribbon, running off the edge. A few real words, quiet placeholders for the rest, and example numbers always labelled.

Do

Crop the window so it bleeds off the page, with depth from soft shadows.

Don't

Shrink it into a boxed card, or show savings that were not measured without a label.
The waterfall.sh hero: the board overlapping the ribbon

Layout: one idea per section.

1200px wide, 128px between sections, 22px tile corners, pill buttons. Promises go in a bento with one wide tile, never three identical cards.

Do

Vary tile sizes so the most important idea is the biggest.

Don't

Repeat label, headline, paragraph, card grid in every section.
--max-width 1200px--section 128px--radius-tile 22px

Motion: quick and quiet.

Only colour and shadow move, in 300ms on one ease-out curve. Under reduced motion, nothing moves at all.

Do

Confirm a hover or a press, then get out of the way.

Don't

Animate layout, slide sections in on scroll, or loop anything.
300mscubic-bezier(.22, 1, .36, 1)

Voice: terse and honest.

Write like a developer explaining it to a friend. Short sentences, real numbers with their source, limits stated plainly. No hype, no em dashes.

Do

"The installer is unsigned, so SmartScreen warns once."

Don't

"Revolutionary AI-powered savings, guaranteed."

Routine work falls to cheap models. Hard work stays with Claude.

Example figures, not measured savings.

Unlock limitless AI efficiency today!

In use.

The system on the live site.

Home hero
Hero: ribbon, light headline, the board
Cascade band
The cascade band
Bento of promises
Bento, one wide tile
Closing band
The ribbon returns in the close
Leaderboard page
Leaderboard
Workshop page
Workshop

Docs for agents.

Machine-readable, generated from one approved source, readable cross-origin.

system.json

The full Shapeable v3 pack: identity, tokens, patterns, voice, rules.

https://waterfall.sh/design/system.json

tokens.json

W3C Design Tokens: colour, type, space, radius, shadow, motion.

https://waterfall.sh/design/tokens.json

tokens.css

Drop-in CSS variables, including var(--ribbon).

https://waterfall.sh/design/tokens.css