Visual Identity
Every color, face, mark, and badge the site draws with is declared in palette.ts, the stylesheets, emblems.ts, and the files under site/public. Each specimen below reads its values from those declarations as the site builds or as the page loads, so a change to a declaration reaches this page in the same change.
Palette
The colors palette.ts declares sit in one band, grouped by the declaration that assigns each one. Choosing a strip names the color beneath the band beside its hex, token, and OKLCH value, its contrast against the page ground of each scheme, and every place the site reads it.
Ube
I · Brand · № 01
- Hex
- Token
- OKLCH
- 0.639 0.111 289.0°
- On light
- , passes as a mark but not as text
- On dark
- , passes as text and as a mark
| Token | Where | Scheme |
|---|---|---|
| --color-family-engine | palette.ts | both |
| --scope-ink | theme/styles/accents.css [data-scope="file"] | both |
| --scope-mark | theme/styles/accents.css [data-scope="file"] | both |
| --scope-tint | theme/styles/accents.css [data-scope="file"] | both |
| --domain-color | theme/styles/accents.css [data-domain='cli-flag'] | both |
| --knob-figure | theme/styles/accents.css [data-hue="ube"] | both |
| --knob-guide | theme/styles/accents.css [data-hue="ube"] | both |
| --knob-tether | theme/styles/accents.css [data-hue="ube"] | both |
| color | theme/styles/markdown/body.css :is(.vp-doc, .glossary-tooltip-body) .prose-mark | both |
| --layer-hue | theme/styles/tailwind/architecture.css .primitives-composition [data-layer='analysis'] | both |
| --layer-ink | theme/styles/tailwind/architecture.css .primitives-composition [data-layer='analysis'] | both |
| --color-ube-page-45 | theme/styles/tailwind/base.css | both |
| --color-ube-soft-45 | theme/styles/tailwind/base.css | both |
| --color-ube-60-panel-edge | theme/styles/tailwind/landing.css | both |
| background | theme/styles/tailwind/landing.css .landing-cta-scroll::-webkit-scrollbar-thumb | both |
| --stack-accent | theme/styles/tailwind/landing.css .stack-accent-ube | both |
| box-shadow | theme/styles/tailwind/reference.css .hairline-ube | both |
| box-shadow | theme/styles/tailwind/reference.css .hairline-ube-38 | both |
| --vp-c-brand-2 | theme/styles/tokens.css :root | both |
| --vp-c-brand-soft | theme/styles/tokens.css :root | both |
| --vp-c-brand-3 | theme/styles/tokens.css .dark | dark |
| PALETTE.ube | config.ts | both |
| PALETTE.ube | lib/og/render/landing.ts | both |
| PALETTE.ube | lib/og/render/template.ts | both |
| border-ube | theme/components/integrations/IntegrationCardGrid.tsx | both |
| border-ube | theme/components/integrations/ShellCompletions.tsx | both |
| text-ube | theme/components/landing/Hero.tsx | both |
| text-ube | theme/components/landing/Metaphor.tsx | both |
| text-ube | theme/components/reference/RunSummary.tsx | both |
| outline-ube | theme/components/reference/RunSummarySelect.tsx | both |
| bg-ube | theme/components/reference/RunSummarySelect.tsx | both |
The band sets every color as one strip, grouped by declaration, and the entry under it follows the strip a reader points at or focuses, a click pinning it until Escape. Each ratio sets a color against the page ground, #ffffff in the light scheme and #1b1b1f in the dark, and the word that follows it names what the ratio passes, text at 4.5:1 or more and mark at 3:1 or more, or fails under 3:1.
- Ube · brand · #8a80cb · --color-ube · OKLCH 0.639 0.111 289.0° · on #ffffff 3.48:1, passes as a mark but not as text · on #1b1b1f 4.93:1, passes as text and as a mark · --color-family-engine in palette.ts, both · --scope-ink in theme/styles/accents.css [data-scope="file"], both · --scope-mark in theme/styles/accents.css [data-scope="file"], both · --scope-tint in theme/styles/accents.css [data-scope="file"], both · --domain-color in theme/styles/accents.css [data-domain='cli-flag'], both · --knob-figure in theme/styles/accents.css [data-hue="ube"], both · --knob-guide in theme/styles/accents.css [data-hue="ube"], both · --knob-tether in theme/styles/accents.css [data-hue="ube"], both · color in theme/styles/markdown/body.css :is(.vp-doc, .glossary-tooltip-body) .prose-mark, both · --layer-hue in theme/styles/tailwind/architecture.css .primitives-composition [data-layer='analysis'], both · --layer-ink in theme/styles/tailwind/architecture.css .primitives-composition [data-layer='analysis'], both · --color-ube-page-45 in theme/styles/tailwind/base.css, both · --color-ube-soft-45 in theme/styles/tailwind/base.css, both · --color-ube-60-panel-edge in theme/styles/tailwind/landing.css, both · background in theme/styles/tailwind/landing.css .landing-cta-scroll::-webkit-scrollbar-thumb, both · --stack-accent in theme/styles/tailwind/landing.css .stack-accent-ube, both · box-shadow in theme/styles/tailwind/reference.css .hairline-ube, both · box-shadow in theme/styles/tailwind/reference.css .hairline-ube-38, both · --vp-c-brand-2 in theme/styles/tokens.css :root, both · --vp-c-brand-soft in theme/styles/tokens.css :root, both · --vp-c-brand-3 in theme/styles/tokens.css .dark, dark · PALETTE.ube in config.ts, both · PALETTE.ube in lib/og/render/landing.ts, both · PALETTE.ube in lib/og/render/template.ts, both · border-ube in theme/components/integrations/IntegrationCardGrid.tsx, both · border-ube in theme/components/integrations/ShellCompletions.tsx, both · text-ube in theme/components/landing/Hero.tsx, both · text-ube in theme/components/landing/Metaphor.tsx, both · text-ube in theme/components/reference/RunSummary.tsx, both · outline-ube in theme/components/reference/RunSummarySelect.tsx, both · bg-ube in theme/components/reference/RunSummarySelect.tsx, both
- Ube Night · brand · #3a3559 · --color-ube-night · OKLCH 0.351 0.062 289.2° · on #ffffff 11.45:1, passes as text and as a mark · on #1b1b1f 1.50:1, fails as text and as a mark · 45% toward black from Ube · --color-family-cli in palette.ts, both
- Ube Deep · brand · #615a91 · --color-ube-deep · OKLCH 0.498 0.087 288.7° · on #ffffff 6.21:1, passes as text and as a mark · on #1b1b1f 2.76:1, fails as text and as a mark · 22% toward black from Ube · --color-link in palette.ts, light · --vp-button-brand-active-bg in theme/styles/tokens.css :root, both
- Ube Mid · brand · #9e97d5 · --color-ube-mid · OKLCH 0.705 0.090 289.0° · on #ffffff 2.68:1, fails as text and as a mark · on #1b1b1f 6.41:1, passes as text and as a mark · 18% toward white from Ube · --vp-c-brand-2 in theme/styles/tokens.css .dark, dark · PALETTE.ube-mid in lib/og/render/landing.ts, both · PALETTE.ube-mid in lib/og/render/parts.ts, both · text-ube-mid in theme/components/reference/RunSummarySelect.tsx, both
- Ube Pale · brand · #b2addf · --color-ube-pale · OKLCH 0.769 0.071 289.2° · on #ffffff 2.11:1, fails as text and as a mark · on #1b1b1f 8.12:1, passes as text and as a mark · 36% toward white from Ube · --color-link in palette.ts, dark · --vp-c-brand-3 in theme/styles/tokens.css :root, both · --vp-c-brand-soft in theme/styles/tokens.css .dark, dark · PALETTE.ube-pale in lib/og/render/template.ts, both
- Celadon · complements · #8cc5a3 · --color-celadon · OKLCH 0.775 0.077 157.9° · on #ffffff 1.98:1, fails as text and as a mark · on #1b1b1f 8.69:1, passes as text and as a mark · --color-family-docs in palette.ts, both · --scope-ink in theme/styles/accents.css [data-scope="construct"], both · --scope-mark in theme/styles/accents.css [data-scope="construct"], both · --scope-tint in theme/styles/accents.css [data-scope="construct"], both · --domain-color in theme/styles/accents.css [data-domain='config-key'], both · --outcome-ink in theme/styles/accents.css [data-outcome="success"], both · --outcome-mark in theme/styles/accents.css [data-outcome="success"], both · --layer-hue in theme/styles/tailwind/architecture.css .primitives-composition [data-layer='base'], both · --layer-ink in theme/styles/tailwind/architecture.css .primitives-composition [data-layer='base'], both · --color-celadon-code-45 in theme/styles/tailwind/base.css, both · --color-celadon-selected-45 in theme/styles/tailwind/base.css, both · --color-celadon-soft-45 in theme/styles/tailwind/base.css, both · --workflow-accent in theme/styles/tailwind/landing.css .workflow-accent-celadon, both · color in theme/styles/tailwind/reference.css .toggle-pill[aria-selected="true"][data-side="after"], both · color in theme/styles/vitepress-chrome.css .copy-host > button.copy.copied:has(> svg.glyph), .copy-host > button.copy:hover.copied:has(> svg.glyph), both · color in theme/styles/vitepress-chrome.css :is(.vp-doc, body) div[class*='language-'] > button.copy.copied::before, :is(.vp-doc, body) div[class*='language-'] > button.copy:hover.copied::before, both · color in theme/styles/vitepress-chrome.css to, both · border-celadon in theme/components/fixtures/FixtureConvergence.tsx, both · bg-celadon in theme/components/fixtures/FixtureConvergence.tsx, both
- Heath · complements · #c08597 · --color-heath · OKLCH 0.681 0.076 359.4° · on #ffffff 2.98:1, fails as text and as a mark · on #1b1b1f 5.76:1, passes as text and as a mark · --color-family-formatting in palette.ts, both
- Toronto · complements · #5069ad · --color-toronto · OKLCH 0.533 0.111 267.3° · on #ffffff 5.30:1, passes as text and as a mark · on #1b1b1f 3.24:1, passes as a mark but not as text · --color-family-layout in palette.ts, both
- Chambray · complements · #7db3e0 · --color-chambray · OKLCH 0.746 0.087 244.5° · on #ffffff 2.23:1, fails as text and as a mark · on #1b1b1f 7.68:1, passes as text and as a mark · --color-family-ordering in palette.ts, both · --scope-ink in theme/styles/accents.css [data-scope="block"], both · --scope-mark in theme/styles/accents.css [data-scope="block"], both · --scope-tint in theme/styles/accents.css [data-scope="block"], both · --domain-color in theme/styles/accents.css [data-domain='exit-code'], both
- Champagne · complements · #f0e9bc · --color-champagne · OKLCH 0.928 0.059 100.1° · on #ffffff 1.23:1, fails as text and as a mark · on #1b1b1f 13.97:1, passes as text and as a mark · PALETTE.champagne in lib/og/render/landing.ts, both · PALETTE.champagne in lib/og/render/parts.ts, both · PALETTE.champagne in lib/og/render/template.ts, both
- Eureka · states · #e8c840 · --color-eureka · OKLCH 0.837 0.152 95.4° · on #ffffff 1.64:1, fails as text and as a mark · on #1b1b1f 10.44:1, passes as text and as a mark · --color-family-alignment in palette.ts, both · --domain-color in theme/styles/accents.css [data-domain='subcommand'], both · --outcome-ink in theme/styles/accents.css [data-outcome="findings"], both · --outcome-mark in theme/styles/accents.css [data-outcome="findings"], both · --callout-mark in theme/styles/markdown/callouts.css .vp-doc .custom-block.warning, both · --color-eureka-page-35 in theme/styles/tailwind/sandbox.css, both · --color-eureka-page-45 in theme/styles/tailwind/sandbox.css, both
- Apricot · states · #e8876f · --color-apricot · OKLCH 0.722 0.125 34.8° · on #ffffff 2.58:1, fails as text and as a mark · on #1b1b1f 6.64:1, passes as text and as a mark · --color-family-lint in palette.ts, both · --domain-color in theme/styles/accents.css [data-domain='suppression'], both · --outcome-ink in theme/styles/accents.css [data-outcome="error"], both · --outcome-mark in theme/styles/accents.css [data-outcome="error"], both · --callout-mark in theme/styles/markdown/callouts.css .vp-doc .custom-block.danger, both · --color-apricot-code-45 in theme/styles/tailwind/base.css, both · --color-apricot-medium-bg in theme/styles/tailwind/base.css, both · --color-apricot-page-45 in theme/styles/tailwind/base.css, both · --color-apricot-selected-45 in theme/styles/tailwind/base.css, both · --lint-color in theme/styles/tailwind/fixtures.css .lint-flag, both · text-apricot in theme/components/layout/NotFound.tsx, both · decoration-apricot in theme/components/layout/NotFound.tsx, both · border-apricot in theme/components/layout/NotFound.tsx, both · border-apricot in theme/components/reference/OutputSamples.tsx, both
- Dexter · sections · #6db0b5 · --color-dexter · OKLCH 0.714 0.068 201.8° · on #ffffff 2.46:1, fails as text and as a mark · on #1b1b1f 6.97:1, passes as text and as a mark · --color-section-architecture in palette.ts, both · --knob-figure in theme/styles/accents.css [data-hue="dexter"], both · --knob-guide in theme/styles/accents.css [data-hue="dexter"], both · --knob-tether in theme/styles/accents.css [data-hue="dexter"], both
- Oat · sections · #cdbda5 · --color-oat · OKLCH 0.805 0.037 78.1° · on #ffffff 1.84:1, fails as text and as a mark · on #1b1b1f 9.33:1, passes as text and as a mark · --color-section-guide in palette.ts, both
- Rainee · sections · #b8c8a8 · --color-rainee · OKLCH 0.812 0.047 129.1° · on #ffffff 1.77:1, fails as text and as a mark · on #1b1b1f 9.70:1, passes as text and as a mark · --color-section-integrations in palette.ts, both
- Casper · sections · #adbdcd · --color-casper · OKLCH 0.791 0.029 248.2° · on #ffffff 1.92:1, fails as text and as a mark · on #1b1b1f 8.94:1, passes as text and as a mark · --color-section-reference in palette.ts, both
- Whiskey · sections · #d4a574 · --color-whiskey · OKLCH 0.754 0.085 67.1° · on #ffffff 2.23:1, fails as text and as a mark · on #1b1b1f 7.71:1, passes as text and as a mark · --color-section-sandbox in palette.ts, both · --scope-ink in theme/styles/accents.css [data-scope="line"], both · --scope-mark in theme/styles/accents.css [data-scope="line"], both · --scope-tint in theme/styles/accents.css [data-scope="line"], both · --domain-color in theme/styles/accents.css [data-domain='output-format'], both · --knob-figure in theme/styles/accents.css [data-hue="whiskey"], both · --knob-guide in theme/styles/accents.css [data-hue="whiskey"], both · --knob-tether in theme/styles/accents.css [data-hue="whiskey"], both · --layer-hue in theme/styles/tailwind/architecture.css .primitives-composition [data-layer='orchestration'], both · --layer-ink in theme/styles/tailwind/architecture.css .primitives-composition [data-layer='orchestration'], both · --stamp-accent in theme/styles/tailwind/landing.css .landing-cta, both · --stamp-ink in theme/styles/tailwind/landing.css .landing-cta, both · background in theme/styles/tailwind/shapes.css .code-caret, both
- Grams Hair · neutrals · #f6f8fa · --color-grams-hair · OKLCH 0.978 0.003 247.9° · on #ffffff 1.06:1, fails as text and as a mark · on #1b1b1f 16.13:1, passes as text and as a mark · GROUNDS.code in palette.ts, light · --vp-code-block-bg in theme/styles/tokens.css :root, both
- Woodsmoke · neutrals · #17171b · --color-woodsmoke · OKLCH 0.206 0.008 285.7° · on #ffffff 17.88:1, passes as text and as a mark · on #1b1b1f 1.04:1, fails as text and as a mark · GROUNDS.soft in palette.ts, dark · --vp-c-bg-soft in theme/styles/tokens.css .dark, dark · PALETTE.woodsmoke in lib/og/render/parts.ts, both · text-woodsmoke in theme/components/suppression/DirectiveAnatomy.tsx, both
Roles
A page draws with a small set of color roles, each a custom property the stylesheets read. The passage below sets every role in the scheme its switch names, and the legend beside it judges each role's contrast at the floor its level takes, a text role and a callout mark each against the page ground and a ground by the text it carries. Pointing at, focusing, or pinning a role marks every place the passage uses it.
Body text sits on the page ground, a link carries the link rule and turns to the link hover under the pointer, inline code sits on its own ground, and an italic aside takes the aside color.
prose check --output-format sarif .
| Format | Output |
|---|---|
text | Snippets for a terminal |
sarif | A SARIF 2.1.0 document |
Each format prints to stdout.
Tip
Its mark reads --color-link.
Info
Its mark reads --vp-c-text-2.
Warning
Its mark reads --prose-shade-eureka-page-45.
Danger
Its mark reads --prose-shade-apricot-page-45.
The passage is drawn in the light scheme whatever the page around it is set to, and the switch above it turns it to the other. Each text role is judged at 4.5:1 against the page ground, each callout mark and the link rule at 3:1, and each ground by the text it carries. Pointing at, focusing, or pinning a role marks every place the passage uses it.
Typefaces
Each typographic role is set in the site's own styles and read back as the page loads. The index groups the roles by the face each one computes, and the pane gives the chosen role's weight, size, and tracking, the tokens and the selector that set them, a sample at its true size, the role marked in place among the others, and the face's figures and reference marks.
Marks
The pen-nib P, the letters, and the tagline compose the lockup. The switches turn each part on or off, and the stage draws the parts turned on over the file's box, marking the clear space they leave on each side. The composed mark also sits in a copy of the nav title, where the corner handle or the ruler resizes it, and the diamond on the ruler marks the height the nav bar serves the mark at. The rows beneath name the file that draws the parts turned on and the tagline the lockup sets.
- Matches
- title-with-tagline.svg
- Tagline
- A Python typesetter for the reader.
Family Badges
Every rule family and each cross-cutting concern takes a badge drawn with a broad nib. Choosing a family draws its badge large, stroke by stroke, and the line beneath gives its motif, the ink it takes in the scheme the page is set to, its stroke count, and the number of rules the family holds.
Stroke 0 of 5
Alignment🪜 Ladderink #877421#e8c8405 strokes7 rules
- The alignment badge is a ladder 🪜 drawn in 5 strokes, inked #877421 on the light page and #e8c840 on the dark, the family color shaded to 4.5:1 against each. The family holds 7 rules.
- The docs badge is a newspaper 📰 drawn in 6 strokes, inked #587e67 on the light page and #8cc5a3 on the dark, the family color shaded to 4.5:1 against each. The family holds 3 rules.
- The formatting badge is a feather 🪶 drawn in 4 strokes, inked #986877 on the light page and #c08597 on the dark, the family color shaded to 4.5:1 against each. The family holds 13 rules.
- The layout badge is a basket 🧺 drawn in 6 strokes, inked #5069ad on the light page and #6b82bc on the dark, the family color shaded to 4.5:1 against each. The family holds 7 rules.
- The lint badge is a yarn 🧶 drawn in 5 strokes, inked #ac6351 on the light page and #e8876f on the dark, the family color shaded to 4.5:1 against each. The family holds 10 rules.
- The ordering badge is a harp drawn in 4 strokes, inked #537998 on the light page and #7db3e0 on the dark, the family color shaded to 4.5:1 against each. The family holds 3 rules.
- The cli badge is a wand 🪄 drawn in 4 strokes, inked #3a3559 on the light page and #84829a on the dark, the family color shaded to 4.5:1 against each. It marks a concern rather than a rule family.
- The engine badge is a owl 🦉 drawn in 4 strokes, inked #776eb0 on the light page and #8a80cb on the dark, the family color shaded to 4.5:1 against each. It marks a concern rather than a rule family.
The alignment badge is a ladder 🪜 drawn in 5 strokes, inked #877421 on the light page and #e8c840 on the dark, the family color shaded to 4.5:1 against each.