SPB Git

Repository Public

BRAND.md 6.7 KB 118 lines markdown

1# SP Term — mini brand guide23## 1. The mark45An **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.67| File | Purpose |8|---|---|9| `SPTermIcon.svg` | Master drawing, used for 64 px and above |10| `SPTermIcon-small.svg` | Simplified drawing, used for the 16 and 32 px renders |11| `SPTermGlyph.svg` | Single-colour template glyph (menus, toolbar, in-app) |12| `Concepts/concept-{a,b,c}.svg` | The three explored concepts |13| `Exports/SPTermIcon-{1024…16}.png` | RGBA exports, transparent background |14| `render.sh` | Regenerates every PNG and `Resources/Assets.xcassets/AppIcon.appiconset` |1516All 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.1718### Geometry1920- Canvas 1024 × 1024, body 824 × 824 at (100, 100), corner radius 185, drop shadow inside the canvas.21- 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.22- Cursor: 126 × 124 block, radius 18, aligned to the P baseline and to the right edge of the bowl.23- Small drawing: body 864 × 864, stroke 100, radius 104, wider gap between S and P, flat white cursor, no glow, gloss or shadow.2425## 2. Concepts and decision2627| | Idea | At 1024 px | At 32 px | At 16 px |28|---|---|---|---|---|29| **A** (winner) | Monoline SP + cursor under the P bowl | Clear, calm, reads as a name | SP legible | Letters start to merge |30| **B** | S built from two prompt chevrons, lower one is the `>` of `>_` | Bold and graphic | Strongest silhouette | Still a readable zigzag |31| **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 |3233**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.3435**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.3637**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.3839**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.4041## 3. Colour4243### Graphite surfaces4445| Token | Hex | Use |46|---|---|---|47| Graphite 950 | `#0D0F13` | Icon body bottom, deepest window background |48| Graphite 900 | `#14171D` | Terminal background |49| Graphite 850 | `#1B1F27` | Icon body mid, sidebar, tab bar |50| Graphite 800 | `#242933` | Raised panels, popovers |51| Graphite 700 | `#323844` | Icon body top, hover, selection background |52| Graphite 600 | `#454C5A` | Borders, dividers |53| Graphite 400 | `#8A93A3` | Secondary text |54| Graphite 100 | `#E6E9EF` | Primary text on dark |5556### Accent5758| Token | Hex | Use |59|---|---|---|60| Cyan | `#22D3EE` | Gradient start, cursor glow, focus ring |61| Electric blue | `#4C8DFF` | Gradient mid, **AccentColor (dark)**, links, primary buttons |62| Violet | `#9B6CFF` | Gradient end, secondary highlights |63| Cursor white | `#EAFDFF` | Cursor block |64| Accent blue (light) | `#1F6FEB` | **AccentColor (light)**: darker for contrast on light surfaces |6566Brand gradient: `#22D3EE → #4C8DFF → #9B6CFF`, bottom-left to top-right (about 42° above horizontal). Small-size gradient: `#5EE6FA → #78AEFF → #BBA2FF`.6768### Semantic6970| Token | Dark | Light | Use |71|---|---|---|---|72| Success | `#3DD68C` | `#1A7F4B` | Exit 0, connected |73| Warning | `#F5B94A` | `#9A6700` | Long-running, unsaved |74| Error | `#FF6B6B` | `#CF222E` | Non-zero exit, failure |75| Info | `#4C8DFF` | `#1F6FEB` | Notices |7677Never signal state by colour alone: pair it with a symbol or a label.7879## 4. Typography8081- **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.82- **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.83- **Numbers in the UI** (timers, sizes, exit codes): SF Pro with monospaced digits.84- 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.8586## 5. Clear space and minimum size8788- **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.89- **App icon:** minimum 16 px. At 16 and 32 px always use the renders made from `SPTermIcon-small.svg`; never scale the master down.90- **Glyph:** minimum 14 px tall. Below that, use the cursor block alone or text.91- The body, margin and shadow are part of the icon: do not crop the tile to the edge of the canvas.9293## 6. Do / don't9495**Do**9697- Use the supplied exports, or regenerate them with `./render.sh`.98- Place the app icon on any background; the tile carries its own contrast.99- Use the glyph as a template image tinted with the label colour or the accent.100- Keep the gradient direction: cyan at the bottom-left, violet at the top-right.101102**Don't**103104- Don't recolour the monogram outside the palette, or flatten the gradient to a single hue on the app icon.105- Don't add a `>` chevron, window chrome, traffic-light dots or scan lines to the icon.106- Don't rotate, skew, outline or add extra shadows and glows.107- Don't move or remove the cursor, or separate S and P.108- Don't place the full-colour monogram without its graphite tile on a light or busy background: use the glyph there.109- Don't typeset "SP" in a font as a substitute for the mark.110111## 7. Regenerating112113```bash114Assets/Brand/render.sh   # needs rsvg-convert (brew install librsvg)115```116117Sizes 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`.118
Files main
Menu

Theme