Hero, wordmark
betaA heading and its actions over a wide photo, with the brand or one word set across the full width beneath it.
Quotes, invoices, payments and reminders in one calm place, for freelancers and small studios.
- Use it
- A short, strong name worth showing big: a product, a restaurant, a studio. Six to ten letters read best.
- Avoid it
- A long name (over twelve letters), or no wide photo: hero-centered or hero-photo.
- Built with
- ButtonText Reveal
- Pairs with
- Logos, gridMenu, cards
Installation
It installs into components/blocks/hero-wordmark/, with what it uses (Button, Text Reveal) and lib/blocks.ts.
Usage
Without content, the block shows its example. Pass your own, typed by the block's schema, from a content file (here, the example with one field changed):
The block is in both families: a product's brand or a place's name. The word's size follows the block's width (cqi) and its length, so it fills the width on one line; past about twelve letters it wraps to a second line on a phone rather than shrinking out of reach. The photo overlaps its top.
Ndolé on Fridays, grilled fish every evening, and plantains fried to order.
Content
| Field | Type | Limits | Guidance |
|---|---|---|---|
word | string | 2–24 chars | The brand or one word, set across the full width under the photo: 'Senbon', 'Ngono'. Short words read largest; past about twelve letters it takes two lines on a phone. |
headline | string | 8–70 chars | The page's heading, above the photo: the promise in at most nine words. |
sublineoptional | string | ≤ 180 chars | |
primary | object | ||
primary.label | string | 1–32 chars | A verb first, two to four words: 'Start free', 'Book a table'. |
primary.href | string | A path ('/pricing'), an anchor ('#menu'), or a full URL. | |
secondaryoptional | object | ||
secondary.label | string | 1–32 chars | A verb first, two to four words: 'Start free', 'Book a table'. |
secondary.href | string | A path ('/pricing'), an anchor ('#menu'), or a full URL. | |
image | object | Wide (16:9 or so): the product, the place or the dish. It overlaps the top of the word. | |
image.src | string | A local path ('/images/terrace.jpg') or the project's asset URL. | |
image.alt | string | ≤ 140 chars | What the image shows, for people who cannot see it. Empty only if purely decorative. |
image.width | integer | ||
image.height | integer |
Props
| Prop | Notes |
|---|---|
content | HeroWordmarkContent; the example when left out |
id | the section's id, for anchor links; "hero" by default |
headingLevel | 1, 2 or 3: the heading's tag; 1 by default |
className | on the <section>, for spacing |
Accessibility
- The big word is decoration, hidden from screen readers: the heading carries the meaning.
- The page's one
h1by default.