Design
Palette
Every colour on bloxcd.dev, what it's for, and its value in each theme. Use colours through their tokens, e.g. var(--c-fetch), never as raw hex. Select a token name to copy it.
Ground
Platinum grey, after old computer cases. In dark mode it turns to a blue-black.
Page background.
- Light
#DCDDD6- Dark
#131820
Dot grid on the page background.
- Light
#C3C5BC- Dark
#1F2731
Raised surfaces: cards, window title bars, pills.
- Light
#ECEDE7- Dark
#1A212B
Hairlines, dividers and bars that aren't active.
- Light
#B8BBB1- Dark
#2A3340
Ink
Text and the hard offset shadows that give windows and buttons their retro look.
Text, borders and hard shadows.
- Light
#18202C- Dark
#E7E9E2
Secondary text.
- Light
#4F5966- Dark
#9BA4AF
Steps
One colour per reconcile step, in loop order. The same colour marks the Blox fields that step handles. Each colour always appears next to a text label, so colour is never the only way to tell them apart.
Fetch. Marks spec.source.
- Light
#2F5BEA- Dark
#5B7FF2
Text on the fetch blue. Other step colours take --block-ink.
- Light
#FFFFFF- Dark
#121820
Render. Marks spec.render.
- Light
#9A7AE8- Dark
#9A7AE8same
Apply. Marks spec.targets.
- Light
#F0B429- Dark
#F0B429same
Prune. Marks spec.prune.
- Light
#E75D33- Dark
#E75D33same
Wait. Marks spec.wait.
- Light
#35B27A- Dark
#35B27Asame
Report. Writes status.
- Light
#4BB4E6- Dark
#4BB4E6same
Accent
The yellow block from the logo. It's the same yellow as the apply step.
Headline highlight, primary buttons, focus ring, link underlines.
- Light
#F0B429- Dark
#F0B429same
Text on the accent.
- Light
#18202C- Dark
#18202Csame
Status
The dot in a status pill.
Shipped.
- Light
#1E7A5F- Dark
#5CC29C
Planned.
- Light
#6B5A1E- Dark
#E2C46A
Bands
Full-width sections that break up the page: cobalt for visibility, mint for Flux, yellow for the quickstart.
Cobalt band background.
- Light
#1E3A9E- Dark
#15296F
Headings on the cobalt band.
- Light
#F2F4FF- Dark
#EEF1FF
Body text on the cobalt band.
- Light
#C6D0FA- Dark
#B4C0F0
Rules on the cobalt band.
- Light
#5A73D6- Dark
#3C55B8
Hard shadows on the cobalt band.
- Light
#0B1230- Dark
#0B1230same
Mint band background.
- Light
#CFEBDB- Dark
#13302A
Dot grid on the mint band.
- Light
#B5DCC6- Dark
#1B3D35
Yellow band background.
- Light
#F6CB4F- Dark
#2E2610
Dot grid on the yellow band.
- Light
#E8B93A- Dark
#3A3115
Secondary text on the yellow band.
- Light
#3E3A2C- Dark
#D9CFAE
Code
Code blocks stay dark in both themes.
Code block background.
- Light
#18202C- Dark
#0C1016
Code text.
- Light
#E4E7DE- Dark
#E1E4DC
Comments and prompts.
- Light
#8C96A3- Dark
#7D8794
YAML keys.
- Light
#9EC1E6- Dark
#9EC1E6same
YAML strings.
- Light
#E9C46A- Dark
#E9C46Asame
Copy button on code blocks.
- Light
#2A3340- Dark
#2A3340same
Terminal
The CRT windows in the visibility band: near-black glass with green phosphor text.
Screen.
- Light
#070A0E- Dark
#070A0Esame
Window title bar.
- Light
#121820- Dark
#121820same
Window frame and title bar buttons.
- Light
#3A4554- Dark
#3A4554same
Terminal text.
- Light
#CFEFDF- Dark
#CFEFDFsame
True, and the cursor.
- Light
#6FD1A8- Dark
#6FD1A8same
False.
- Light
#F08A73- Dark
#F08A73same
Glow around terminal text.
- Light
rgba(111, 209, 168, 0.35)- Dark
rgba(111, 209, 168, 0.35)same
CRT scanlines over the terminal.
- Light
rgba(0, 0, 0, 0.28)- Dark
rgba(0, 0, 0, 0.28)same
Contrast
Every text colour on the background it's used against, in both themes. WCAG AA asks for 4.5:1 for normal text. cargo xtask check fails if any of these drop below it.
| Sample | Used for | Text on background | Light | Dark |
|---|---|---|---|---|
| Ready | Body text | --ink on --ground | 12.0:1 AAA | 14.5:1 AAA |
| Ready | Secondary text | --muted on --ground | 5.2:1 AA | 7.1:1 AAA |
| Ready | Text on cards | --ink on --surface | 13.9:1 AAA | 13.2:1 AAA |
| Ready | Secondary text on cards | --muted on --surface | 6.0:1 AA | 6.4:1 AA |
| Ready | Primary button, headline highlight | --block-ink on --block | 8.8:1 AAA | 8.8:1 AAA |
| Ready | Label on the fetch step | --c-fetch-ink on --c-fetch | 5.5:1 AA | 4.9:1 AA |
| Ready | Label on the render step | --block-ink on --c-render | 4.9:1 AA | 4.9:1 AA |
| Ready | Label on the apply step | --block-ink on --c-apply | 8.8:1 AAA | 8.8:1 AAA |
| Ready | Label on the prune step | --block-ink on --c-prune | 4.7:1 AA | 4.7:1 AA |
| Ready | Label on the wait step | --block-ink on --c-wait | 6.1:1 AA | 6.1:1 AA |
| Ready | Label on the report step | --block-ink on --c-report | 7.0:1 AA | 7.0:1 AA |
| Ready | Headings on the cobalt band | --band-fg on --band-status | 8.9:1 AAA | 11.8:1 AAA |
| Ready | Body text on the cobalt band | --band-dim on --band-status | 6.4:1 AA | 7.4:1 AAA |
| Ready | Text on the mint band | --ink on --band-flux | 12.9:1 AAA | 11.6:1 AAA |
| Ready | Secondary text on the mint band | --muted on --band-flux | 5.6:1 AA | 5.6:1 AA |
| Ready | Text on the yellow band | --ink on --band-start | 10.6:1 AAA | 12.2:1 AAA |
| Ready | Secondary text on the yellow band | --band-start-muted on --band-start | 7.4:1 AAA | 9.6:1 AAA |
| Ready | Code | --code-fg on --code-bg | 13.1:1 AAA | 14.8:1 AAA |
| Ready | Comments and prompts in code | --code-dim on --code-bg | 5.5:1 AA | 5.2:1 AA |
| Ready | YAML keys | --code-key on --code-bg | 8.8:1 AAA | 10.2:1 AAA |
| Ready | YAML strings | --code-str on --code-bg | 9.8:1 AAA | 11.4:1 AAA |
| Ready | Terminal text | --term-fg on --term-bg | 16.1:1 AAA | 16.1:1 AAA |
| Ready | Ready True | --term-ok on --term-bg | 10.7:1 AAA | 10.7:1 AAA |
| Ready | Ready False | --term-fail on --term-bg | 8.1:1 AAA | 8.1:1 AAA |