# Wordmark

> The Poesía brand mark, set as a word.

- **Level**: atom · **Status**: stable · **Role**: content
- **Import**: `import { Wordmark } from "@rrios-forge/ui/atoms/wordmark";`
- **Source**: `packages/ui/src/atoms/wordmark`

Poesía's brand mark: an ink rounded square with a soft highlight, beside the name set in the display serif. Mark and name share one colour, near-black by day and near-white by night, so the mark sits in the monochrome theme like the primary action does. It comes at three sizes, as the full lockup or the square alone, and can be held to a light or dark ground for photos and print.

## Axes

| Axis | Part | Values | Default | Meaning |
|---|---|---|---|---|
| `size` | — | `sm` `md` `lg` | `md` | Ergonomic scale, in three families (control, text, container). |
| `lockup` | — | `full` `mark` | `full` | Which form of the brand mark. |
| `ground` | — | `auto` `light` `dark` | `auto` | Which ground a brand mark sits on. |
| `palette` | — | `brand` `mono` | `brand` | Brand colour or monochrome for a brand mark. |

## Stories

- [Playground](/?path=/story/components-atoms-wordmark--playground) · frame: `/iframe.html?id=components-atoms-wordmark--playground&viewMode=story`
- [Sizes](/?path=/story/components-atoms-wordmark--sizes) · frame: `/iframe.html?id=components-atoms-wordmark--sizes&viewMode=story`
- [Variants](/?path=/story/components-atoms-wordmark--variants) · frame: `/iframe.html?id=components-atoms-wordmark--variants&viewMode=story`
- [Tones](/?path=/story/components-atoms-wordmark--tones) · frame: `/iframe.html?id=components-atoms-wordmark--tones&viewMode=story`

## Decisions that name it

- ADR-009 — Editorial Frame: PageShell v3 + new `TopBar` molecule
- ADR-030 — Axis vocabulary: one name, one meaning

## Always

- Tokens only (R04); variants are semantic axes, never appearance (R02).
- Typography and actions are Poesía atoms, never raw HTML with utilities.
- Vibrant panes need a ground and never nest (ADR-027).