billet  ·  brand guidelines  ·  v1.0 — 2026
billet

A stateless CLI that billets each repo's devcontainer onto a shared cloud Host.

github.com/rinman24/billet·MIT·Python
running building open
01 The idea

Everything runs on one metaphor: a posting.

In its truest sense a billet is an assignment of quarters. A Host has berths; billet posts each repo into one. The identity is that rack — three berths posted, three left open.

Host
The shared cloud machine. It has a fixed set of berths.
Berth
One slot on the Host where a Workspace can be posted.
Workspace
Your repo's devcontainer, running inside a berth.
Post
To billet a repo — claim a berth and bring it up.
02 The mark

The berth rack.

Two columns, three rows. Occupied berths carry the accents; open berths are outlined. It is square-first, so it drops straight into a favicon or an app icon.

Geometry
Grid2 × 3 berths
Berth ratio1 : 0.7
Gap¼ berth
Corner radius0.15 berth
Posted3 of 6
Clearspace
Keep one berth of air on every side.
Minimum size
Never render the mark below 16px.
Occupied berth — carries an accent
Open berth — outlined only
Three posted, three open — never fill all six. billet always leaves room.
03 Logo lockups

Four lockups. Two themes. Ship both.

The accents stay the same on light and dark — only ink and ground flip. Wordmark is always lowercase Space Grotesk 600.

billet
primary · horizontal · dark
billet
primary · horizontal · light
billet
stacked · dark
billet
stacked · light
mark only
billet
wordmark only
04 Favicon & app icon

The mark is the favicon.

No wordmark, no tricks. The aubergine tile ships baked into the icon, so it stays self-contained on any browser theme. At 32px and below the open berths trade their outline for a solid recessive fill, keeping every berth crisp down to 16px.

app icon · 88 · squircle
64 · outlined
32 · solid
16 · solid
favicon ladderopen fill · #9C8BB2
billet · docs ×
browser tab
05 Color

Grape — aubergine, magenta, mint.

The ground dominates. Accents are punctuation — one action per view. Magenta leads and means running; mint supports and means building.

Aubergine
Ground
#17101F
The background. Almost everything sits on it.
Surface
Surface
#211829
Cards, terminals, raised panels.
Ink
Text
#EDE6F2
Headings and body on the ground.
Muted
Secondary
#837390
Meta, labels, quiet detail.
Magenta
Running · lead
#C05CE0
Prompt, active state, the one action.
Mint
Building · second
#3FD2BE
Progress, the supporting accent.
Light-theme neutrals
Paper
#FAF9F7
Light ground
White
#FFFFFF
Cards
Ink
#141414
Text
Line
#E7E4DF
Hairline
Gray
#8C8A85
Secondary
06 Typography

Two families. One does words, one does machines.

Space Grotesk carries the wordmark, headings and body. JetBrains Mono carries anything the machine says — code, CLI, labels, status.

Ag
Space Grotesk
Wordmark · display · body · UI
400500600700
Ag
JetBrains Mono
Code · CLI · labels · data
400500600700
Display
Space Grotesk · 600 · −0.045em
billet
Heading
Space Grotesk · 600 · −0.02em
Post to a berth
Body
Space Grotesk · 400 · 1.6
A stateless CLI for shared devcontainers.
Label
JetBrains Mono · 500 · .14em
Running · berth 3
Code
JetBrains Mono · 400 · 1.6
❯ billet post api
wordmark rule Always lowercase. Space Grotesk 600. Letter-spacing −0.045em. Never substitute another face.
07 The command line

The terminal is where the brand lives.

A magenta prompt. Status carried by color, not adjectives. Commands that read like a sentence: billet post api.

host — billet
❯ billet post api web
  api   posting… → berth 3
  web   posting… → berth 5
❯ billet ls
apirunningberth 3
webbuildingberth 5
docsopenberth 1
❯
Command surface
billet post <repo>
Claim a berth on the Host and bring the Workspace up.
billet ls
List berths — running, building, or open.
billet shell <repo>
Drop into the Workspace posted at a berth.
billet logs <repo>
Stream a Workspace's build and run output.
billet rm <repo>
Vacate the berth and free it on the Host.
Voice
Terse and lowercase. No exclamation.
Present tense — posting, not will post.
Status is a color, then a word.
08 Applications

The mark in the wild.

README header
billet
Post any repo's devcontainer to a shared Host — from the command line.
pip install billet MIT python 3.11+
Social card · 1200×630
billet
A berth for every repo.
Stateless CLI · shared cloud Host · devcontainers
Die-cut sticker
Editor status bar
billet api · berth 3
09 Misuse

Six ways to break it.

billet
✗
Don't color the wordmark. It stays ink.
✗
Don't fill every berth. Three stay open.
✗
Don't rotate or skew the rack.
✗
Don't add glow, gradient or shadow to the mark.
billet
✗
Don't stretch or condense the wordmark.
billet
✗
Don't crowd the mark. Keep the clearspace.
✓ ink wordmark ✓ 3 posted · 3 open ✓ upright, flat ✓ magenta = running
10 Voice
A berth for every repo. Post it, and it's up.
Tagline · A stateless CLI for shared devcontainers. Short · billet posts.