Brand

Brand pairs a product mark with an optional wordmark. Choose a wordmark when text can name the brand; a mark-only Brand needs an explicit accessible name instead.

Custom property	Default	What it sets
`--brand-mark-size`	`24px`	The mark's width and height. The `size` prop sets it in pixels.

Examples

Mark and wordmark

A wordmark provides the name people see and assistive technology reads. href makes the native element an anchor, so use it for a home destination.

Lyra

Mark only

A mark is not self-describing. Without a wordmark, aria-label is required so the brand still has an accessible name.

Omit mark and Brand draws an initial-letter mark from the wordmark text (or from aria-label for a mark-only brand), so a bare <Brand>Lyra</Brand> renders without an image.

Rendering through a link

asChild keeps your routing link as the rendered element. It and href are mutually exclusive: the child owns the destination.

Lyra components

When to use

Use Brand wherever a product identity needs its mark and, when space allows, its name. It renders both theme images and CSS selects one with [data-theme], so no JavaScript theme read is needed.

Reach for something else when:

The identity is only text — use ordinary text or a heading; an empty mark image adds no value.
The mark is a decorative image in content — use an img with the right alt decision.

Accessibility

A wordmark supplies the accessible name by default. A mark-only Brand renders role="img" and requires aria-label; the type system rejects its omission.
Brand images have empty alt because the wordmark or accessible name names the whole brand once.
href renders a native anchor. With asChild, the child must remain a real, keyboard-reachable link with its own destination.
The light and dark marks are both in the DOM and CSS hides one. Provide equivalent artwork so a theme change never changes the product name or meaning.

API and code

Name	Type	Required	Description
`mark`	`string`	—	Image source used for the light theme mark. When omitted, the mark falls back to the initial of the wordmark text (or of `aria-label` for a mark-only brand).
`markDark`	`string`	—	Optional image source used for the dark theme mark.
`size`	`number`	—	Mark edge length in pixels. Sets `--brand-mark-size`.
`children`	`ReactNode \| undefined \| ReactElement`	—	Wordmark content that gives the brand its accessible name. Omit the wordmark to render a mark-only brand. A child link or framework routing element containing the wordmark.
`'aria-label'`	`string`	—	Optional translated accessible name that overrides the wordmark text. Translated accessible name required when no wordmark is rendered.
`href`	`string \| never`	—	Destination rendered as an anchor. Mutually exclusive with `asChild`. Destination is provided by the child element when `asChild` is enabled.
`asChild`	`false \| true`	—	Render the native anchor or span. Render the single child element with the brand's props and classes merged.

The examples use documentation assets, so their image paths will 404 in your app. Replace them with your product's own light and dark mark files when copying this markup:

html

<a class="lyra-brand" href="/">
  <img class="lyra-brand__mark lyra-brand__mark--light" src="/mark.svg" alt="" />
  <img class="lyra-brand__mark lyra-brand__mark--dark" src="/mark-light.svg" alt="" />
  <span class="lyra-brand__word">Acme</span>
</a>

<span class="lyra-brand" role="img" aria-label="Acme home">
  <img class="lyra-brand__mark" src="/mark.svg" alt="" />
</span>

<lyra:brand> Generated from lyra-ds/blade v0.10.0.

Prop	Default	Required	Example values
`mark`	—	Required	—
`markDark`	`null`	—	—
`size`	`null`	—	—
`href`	`null`	—	—

blade

<lyra:brand mark="/img/lyra-mark.svg" :size="24" href="/">Lyra</lyra:brand>