SPB Git

Repository Public

BRAND.md 6.7 KB

# SP Term — mini brand guide

# 1. The mark

An SP monogram drawn as a monoline, with a glowing block cursor parked in the empty space under the bowl of the P. Read left to right it says SP▮: the initials, then the terminal waiting for input. The body is a dark graphite glass tile on the macOS icon grid.

File Purpose
SPTermIcon.svg Master drawing, used for 64 px and above
SPTermIcon-small.svg Simplified drawing, used for the 16 and 32 px renders
SPTermGlyph.svg Single-colour template glyph (menus, toolbar, in-app)
Concepts/concept-{a,b,c}.svg The three explored concepts
Exports/SPTermIcon-{1024…16}.png RGBA exports, transparent background
render.sh Regenerates every PNG and Resources/Assets.xcassets/AppIcon.appiconset

All sources are plain vector: shapes, stroked paths, gradients and blur filters. No embedded raster, no <text>, no external references. Letterforms are arcs and lines, so no font is required.

# Geometry

  • Canvas 1024 × 1024, body 824 × 824 at (100, 100), corner radius 185, drop shadow inside the canvas.
  • Letters: circles of radius 96 on a 84-unit round-capped stroke; S is two stacked 240° arcs, P is a stem plus a half-circle bowl.
  • Cursor: 126 × 124 block, radius 18, aligned to the P baseline and to the right edge of the bowl.
  • Small drawing: body 864 × 864, stroke 100, radius 104, wider gap between S and P, flat white cursor, no glow, gloss or shadow.

# 2. Concepts and decision

Idea At 1024 px At 32 px At 16 px
A (winner) Monoline SP + cursor under the P bowl Clear, calm, reads as a name SP legible Letters start to merge
B S built from two prompt chevrons, lower one is the > of >_ Bold and graphic Strongest silhouette Still a readable zigzag
C P whose bowl is a terminal screen, S knocked out of it Clever, the heaviest shape S becomes a dark smudge Blue block, S gone

Why A. It is the only concept that carries both initials at every size down to 32 px, and the cursor placement gives it a terminal cue without borrowing the >_ glyph that almost every terminal icon uses.

Why not B. It has the best 16 px silhouette, but it drops the P entirely, and a chevron followed by an underscore is the shared vocabulary of terminal icons. It was the most likely of the three to be mistaken for another product.

Why not C. The idea depends on the S inside the bowl, and that detail is the first thing lost: at 32 px it is a smudge, at 16 px it is gone and what remains is an anonymous blue flag shape.

Refinement after looking at the small renders. Concept A at 16 px showed S and P fused into one blue mass, and mid-blue on graphite had too little contrast. The master got heavier strokes (76 → 84), larger letters, a brighter gradient, a taller cursor and a soft depth shadow. A separate small drawing was added with a 100-unit stroke, a full-pixel gap between the letters at 16 px, lighter accent stops and a flat white cursor.

# 3. Colour

# Graphite surfaces

Token Hex Use
Graphite 950 #0D0F13 Icon body bottom, deepest window background
Graphite 900 #14171D Terminal background
Graphite 850 #1B1F27 Icon body mid, sidebar, tab bar
Graphite 800 #242933 Raised panels, popovers
Graphite 700 #323844 Icon body top, hover, selection background
Graphite 600 #454C5A Borders, dividers
Graphite 400 #8A93A3 Secondary text
Graphite 100 #E6E9EF Primary text on dark

# Accent

Token Hex Use
Cyan #22D3EE Gradient start, cursor glow, focus ring
Electric blue #4C8DFF Gradient mid, AccentColor (dark), links, primary buttons
Violet #9B6CFF Gradient end, secondary highlights
Cursor white #EAFDFF Cursor block
Accent blue (light) #1F6FEB AccentColor (light): darker for contrast on light surfaces

Brand gradient: #22D3EE → #4C8DFF → #9B6CFF, bottom-left to top-right (about 42° above horizontal). Small-size gradient: #5EE6FA → #78AEFF → #BBA2FF.

# Semantic

Token Dark Light Use
Success #3DD68C #1A7F4B Exit 0, connected
Warning #F5B94A #9A6700 Long-running, unsaved
Error #FF6B6B #CF222E Non-zero exit, failure
Info #4C8DFF #1F6FEB Notices

Never signal state by colour alone: pair it with a symbol or a label.

# 4. Typography

  • UI: SF Pro (system font). Window titles and tabs 13 pt regular/medium, sidebar 12–13 pt, captions 11 pt. Use .system text styles so Dynamic Type and localisation keep working.
  • Terminal: SF Mono, default 13 pt, regular for text and semibold for bold. Line height 1.2, no ligatures by default, user-selectable font as an option.
  • Numbers in the UI (timers, sizes, exit codes): SF Pro with monospaced digits.
  • The wordmark is written SP Term: two words, capital S, P and T, in SF Pro Semibold with normal tracking. Do not set it in a monospace face and do not letter-space it.

# 5. Clear space and minimum size

  • Clear space: keep a margin of at least one stroke width of the mark around the app icon (10 % of the body width); for the glyph, half the height of the cursor on every side.
  • App icon: minimum 16 px. At 16 and 32 px always use the renders made from SPTermIcon-small.svg; never scale the master down.
  • Glyph: minimum 14 px tall. Below that, use the cursor block alone or text.
  • The body, margin and shadow are part of the icon: do not crop the tile to the edge of the canvas.

# 6. Do / don't

Do

  • Use the supplied exports, or regenerate them with ./render.sh.
  • Place the app icon on any background; the tile carries its own contrast.
  • Use the glyph as a template image tinted with the label colour or the accent.
  • Keep the gradient direction: cyan at the bottom-left, violet at the top-right.

Don't

  • Don't recolour the monogram outside the palette, or flatten the gradient to a single hue on the app icon.
  • Don't add a > chevron, window chrome, traffic-light dots or scan lines to the icon.
  • Don't rotate, skew, outline or add extra shadows and glows.
  • Don't move or remove the cursor, or separate S and P.
  • Don't place the full-colour monogram without its graphite tile on a light or busy background: use the glyph there.
  • Don't typeset "SP" in a font as a substitute for the mark.

# 7. Regenerating

bash
Assets/Brand/render.sh   # needs rsvg-convert (brew install librsvg)

Sizes of 32 px and below are rendered from the small drawing, everything else from the master. The script also refreshes the concept previews and copies the ten PNGs into Resources/Assets.xcassets/AppIcon.appiconset.

Files main
Menu

Theme