rfs-brand

Ember

The brand, once per screen. Glow in Nightshift only. Never for errors.

Mint and Raspberry

Status, not decoration. Mint only ever means OK; Raspberry only ever means failed.

A word with every status

Pair the colour with ok, warn or fail, or a line that says what happened. To red–green colour-blind readers, Dayshift Ember and Amber look the same, and Mint and Raspberry come close.

Focus

A 2px Ember outline with a 3px offset on every focusable element. Press Tab on this page to see it.

Never

Gradients, or a third accent.

display48 / 1.05 · Sans 700 · −0.03em

Real tools. No filler.

h132 / 1.1 · Sans 700 · −0.02em

Starting a new repo

h222 / 1.2 · Sans 600 · −0.01em

Known issues

body16 / 1.6 · Sans 400 · 16 px since 1.2.0, was 15

Keeps a forwarded VPN port and qBittorrent in sync. Short sentences, concrete nouns; the reader is busy and competent. Prose stays between 60 and 75 characters a line.

small13 / 1.5 · Sans 400 · mute

Secondary text and captions.

label11 / 1 · Mono 500 · caps · +0.08em

Nightshift · Dayshift · Ember

code13 / 1.7 · Mono 400

port-sync check

wordmarkMono 600 · −0.05em

RFS

--rfs-font-sans: "IBM Plex Sans", Inter, system-ui, sans-serif;
--rfs-font-mono: "IBM Plex Mono", "JetBrains Mono", ui-monospace, monospace;

Plain

Short sentences. Concrete nouns. The reader is busy and competent.

Could a tired admin at 2 am act on it?

Specific

Versions, OS names, command names, numbers.

Is every adjective replaceable with a fact?

Dry

Humour lives in details, like a flag name or a commit message. Never in the headline.

Still funny with the emoji removed? There are no emoji.

Honest

Say what it doesn't do. “Tested on” is a list. Known issues go above the fold.

Is the first limitation visible without scrolling?

Banned blazing powerful modern seamless supercharge awesome Welcome! coming soon and every emoji and exclamation mark.

name        = "rfs-brand"
description = "RFS brand, profile art and repo templates"

[panel]
kind = "art"
file = "cover-art.svg"

Judged at 400 px

That's this cover at the width of a Slack, Discord or X card, where everything is a third of its size and anything drawn under about 20 px turns into a grey line. make-cover.py --preview shows a cover at 1200, 830 and 400 px in both themes; judge it there, not at 1200. The tool refuses text that won't fit rather than shrinking it.

Four panel kinds

Flow for a tool that turns one thing into another: input, the tool on an Ember connector, output. Terminal for a command: six lines at most, and it types. Art when the tool has a UI and draws itself. Screenshot when the UI is too detailed to draw, cropped to what still reads.

# from the folder that holds both clones
python3 rfs-brand/tools/make-cover.py my-repo/docs/assets/cover.toml   # cover + social preview
python3 rfs-brand/tools/make-cover.py my-repo/docs/assets/cover.toml --preview preview.png   # at 1200, 830, 400
python3 rfs-brand/tools/make-org-art.py                                # profile banner, org card, X header
python3 rfs-brand/tools/make-avatar.py                                 # profile picture

# once
pip install fonttools resvg-py pillow

Reduced motion is on, so each specimen below is its finished still frame. That's the rule working.

$ ./install.sh
ok   carify 1.1.0 installed

An entrance totals 1.2 s at most and never delays reading the headline. Nothing loops except the cursor's two blinks. Every motion sits inside prefers-reduced-motion: no-preference. No parallax, no scroll-jacking. Repo covers are the one exception: a cover may run to 3.5 s, since its terminal types, and because an <img> can ignore reduced motion, it has to be safe without it (§7).