---
name: vosso
description: How to make anything that carries vosso's brand, for coding agents. Palette, type, marks, the grammar of surfaces, and what to avoid.
---

# Build on vosso's brand

vosso turns what you ship into the media that sells it, from the real
product, kept current with every release. The brand's job is to get out of
the way of the work: output does the talking, chrome stays quiet, and the
one loud colour marks time.

## Priority order

1. Show a real render of a real product before any claim about one.
2. One message per screen, one primary action. Secondary paths are text.
3. Structure by tone, unequal space and type, never by drawn lines.
4. Everything below.

## Palette

- Paper `#FAF9F5` is the ground of every marketing surface; ink `#141413`
  is the type on it. The dark stage `#0D0C0B` with `#FAFAFA` type is
  where the engine's output sits (films, clips, code), never a whole page.
- Every other surface tone is derived: a plane is ink mixed 5% into the
  ground, a well is ink at 5.5%, a hairline is ink at low alpha. Do not
  invent greys; step the ground.
- Record red `#ff5148` marks time and only time: the playhead, the record
  dot, a live state. Never on a button, a hover, a border, a background or a
  gradient. At most one signal element in view.
- Errors are a separate destructive red; they report, they never warn. A
  button that has not run yet has broken nothing and is never red.
- Spectrum colour lives in the content being rendered, never in the chrome.

## Type

- Lexend for every word a human reads: display, body, labels, links, status
  words, controls. Weight and size carry hierarchy.
- JetBrains Mono for code and data literals only: commands, paths, ids,
  keys, timecodes, dimensions, tabular numbers.
- Never all caps. Never an eyebrow above a heading. Sentence or Title case.
- Two-tone headlines (ink, then a muted second phrase) are hero-only. A
  hero H1 stays under eight words.

## Marks

- The wordmark is the word `vosso`, lowercase, set in Lexend. There is no
  stylised wordmark asset.
- The mark is the tricorn, published bare with a transparent ground:
  https://vos.so/mark.svg (ink, for light grounds) and
  https://vos.so/mark-on-dark.svg (paper, for dark grounds). These are the
  files to place on a poster, a card or an end card, beside the wordmark at
  about 1.3 times its cap height. The favicon (https://vos.so/favicon.svg)
  and the app icon (https://vos.so/logo512.png) carry a tile and are never
  placed on a composition. Solid fills only; a gradient or a purple tint
  reads as generic AI and is wrong.
- `vos` is the open engine's name and stays lowercase too. There is one
  product, vosso; inputs (a recording, a URL, a program, a model) are doors,
  never brands.

## Surfaces

- Ground, plane, well: three tonal rungs. Controls are wells, not outlines.
  A border survives only on the bare canvas and the focus ring.
- Three drawn lines per viewport is the budget. A line must separate dense
  peer content with no room for a gap.
- Radius grows with the object: 8 for controls, 12 for wells and tiles, 16
  for panels and cards, 20 for floating surfaces; an inner radius is the
  parent's minus its padding.
- Spacing is a ratio, 8 / 20 / 28 / 56, never one generous value everywhere.
- A state is a dot plus a word. Hue goes on the dot; the word stays ink.

## Voice

- Claims are short, benefit-led and provable. The claim without an artifact
  made by the product does not ship.
- Numbers are real and set in mono with tabular figures.
- No em-dash. Restructure with periods and commas.
- Say what you can do here, what you get, and the next step, in one glance.

## Reject

- A card grid of equal boxes.
- Purple, gradients or glows on the mark or the chrome.
- Record red anywhere but a time mark.
- All caps, tracked eyebrows, meta labels above headings.
- A hero that claims without a render beside it.
- Stock imagery, mockups, anything not made by the product.
- A wordmark used as a control.
- Em-dashes in shipped copy.

## Machine surfaces

- https://vos.so/llms.txt routes an agent by its ask.
- https://vos.so/llms-full.txt is the complete CLI contract.
- `vos brand https://vos.so` writes this brand as a BRAND.md recipe and
  reads this file first.