Visual language

Bifrost's two glass recipes: the cloud-duo gradient for premium CTAs and lead cards, and the navbar's quiet chrome glass for floating surfaces.

5 pages in this section

Bifrost has a single canonical recipe for surfaces that need lead-card or premium-CTA prominence: a frosted-glass blur on top of a slowly drifting two-colour gradient (“cloud-duo”). The recipe is centralised in two mixins so adopters never reinvent the background treatment.

The reading grammar page comes first: it sets the rules every reading page follows (ink and hairlines, one accent, the mono metadata voice, one pill, the rainbow in four placements). The mixins below are the surface recipes the index and landing pages still use.

MixinShapeUse for
glass-cloud-cardCardLead cards on section landings, reading-path tiles, lead Dispatch on /news/.
glass-cloud-buttonButtonIn-content CTAs that should feel premium (“Read in Book”, utility footers).

There is a second, unrelated glass recipe. glass-cloud is for surfaces that should draw the eye; chrome-glass is for surfaces that should not — floating chrome that reads as the same material as the navbar. It adds no gradient and no animation.

MixinShapeUse for
chrome-glassAnyFloating chrome and overlay panels: control clusters, map legends, popovers above a page rather than in it.

Do not reach for glass-cloud on chrome. The cloud-duo gradient makes a control cluster the loudest thing on the page — which is how the map’s zoom controls ended up with cyan and mauve blobs behind their icons.

Both expose two CSS custom properties (--cloud-a, --cloud-b) that adopters override per instance to pick a duo from the Bifrost 300-tier palette. Pick a duo that fits the prominence and mood of the surface — cool/quiet duos for utility, vibrant duos for lead positions.

  • Reading grammar The one visual grammar every reading page follows: ink and hairlines, one accent, a mono metadata voice, one pill, serif for citations, and the rainbow in four fixed placements.
  • Page frame One geometry for every page type: the navbar's frame, a 44rem reading measure, the title at the same edge and height everywhere, and the breadcrumb in the footer.
  • glass-cloud-card Frosted glass + drifting cloud-duo gradient. The Bifrost mixin that lead cards on /read/, /articles/, and /news/ share.
  • glass-cloud-button Glass-cloud-card scaled to button affordances. Used for in-content CTAs that should feel premium and match the lead-card visual language.
  • chrome-glass The navbar's glass recipe as a reusable mixin, for floating chrome that should read as one surface with it. Distinct from the glass-cloud premium-CTA language.

Edit this page on GitHub