mirror of https://github.com/hanzoai/design.git synced 2026-10-30 14:58:37 +00:00

Files

T

zeekay 7fd808daea Add z-index tokens, content (voice/taglines), prompts (system/rules/pages), docs

- tokens/z.css: the missing z-index ladder (named roles, no magic numbers)
- content/: brand voice + approved taglines (the words)
- prompts/: system-level generation guidance — the 'make it look Hanzo' system
  prompt, do/don't rules, page prompts (complements co-located component prompts)
- docs/: how to integrate the tokens, theme, and extend
- wire new dirs into README index, styles.css import chain, package.json files

2026-07-24 17:19:28 -07:00

2.3 KiB

Raw Permalink Blame History

Voice

Direct, technical, understated. Hanzo builds enterprise AI infrastructure and frontier models; the writing sounds like the people who build it, not the people who market it.

The five rules

Numbers over adjectives. "92.9% on GPQA" beats "incredibly smart." "40ms p50" beats "blazing fast." If you cannot measure it, question whether it belongs.
Say the thing, then stop. Lead with the claim. Cut the throat-clearing ("We're excited to announce…", "In today's world…"). The reader is busy.
No exclamation marks. No emoji. Enthusiasm is carried by substance, not punctuation. This is a hard rule, the same way monochrome is a hard rule.
Verbs, active, present. "Deploy a model in one command." Not "Models can be deployed."
Concrete nouns. "inference," "agents," "the C-Chain," "an SQLite database" — name the real thing rather than "solutions," "offerings," or "capabilities."

Before / after

Instead of	Write
"Blazing-fast, next-gen AI cloud!"	"The AI cloud. Inference at 40ms p50."
"We're thrilled to introduce our new models 🚀"	"New frontier models. Available today."
"Leverage our powerful suite of solutions"	"Run models, agents, and search on one platform."
"Sign up now and get started on your journey!"	"Start free. No card."
"Revolutionary paradigm-shifting technology"	(delete — show the benchmark instead)

Words

Product names, capitalized: Hanzo, Hanzo Cloud, Enso, Base, KMS, IAM.
Lowercase the plumbing: inference, agents, models, tokens, endpoints.
One space, one period. Sentence case for headings and buttons — "Get started," not "Get Started" or "GET STARTED." Eyebrows are the one exception: small uppercase category labels (see --type-eyebrow).
Never "revolutionary," "cutting-edge," "game-changing," "seamless," "unleash," "supercharge," "delve," "in today's fast-paced world."

Length

Hero headline: ≤ 7 words.
Hero subline / tagline: ≤ 140 characters, one sentence.
Body: short paragraphs, two to four sentences. If a paragraph needs a scrollbar, split it.

The test

Read it aloud. If it sounds like a person explaining their work to a smart colleague, keep it. If it sounds like a press release, rewrite it.

2.3 KiB Raw Permalink Blame History