Brand reference
Humans + AI, as the application draws it
Generated from @hai/brand at build time, so it cannot drift. Token file 0.10.8 (2026-11-15), snapshot of design-system/tokens/hai-tokens.json at HAI-orgs-OS commit 00d3c627d. The identity belongs to the people who rule on the design system.
5 questions are open for Ross and Dan. Contrast: 62 pairs measured, 0 below their required ratio.
Colour
Spectrum, 8-step, with shade, tint and solid plate
pink
#ED1860
shade 70
#AB1649
tint 20
#FBD1DF
plate (white type 3:1)
#ED1860
magenta
#C3386C
shade 70
#8E2D52
tint 20
#F3D7E2
plate (white type 3:1)
#C3386C
purple
#68318A
shade 70
#4E2867
tint 20
#E1D6E8
plate (white type 3:1)
#68318A
indigo
#4A50A2
shade 70
#393D77
tint 20
#DBDCEC
plate (white type 3:1)
#4A50A2
blue
#2590CF
shade 70
#1F6A97
tint 20
#D3E9F5
plate (white type 3:1)
#2590CF
teal
#08B5A5
shade 70
#0B847A
tint 20
#CEF0ED
plate (white type 3:1)
#09A698
green
#4DB358
shade 70
#3B8344
tint 20
#DBF0DE
plate (white type 3:1)
#48A653
orange
#F47521
shade 70
#B0571D
tint 20
#FDE3D3
plate (white type 3:1)
#EB7120
Spectrum, 12-step
pink
#ED1860
cerise
#D22C68
mulberry
#AA3674
plum
#703287
violet
#584297
cobalt
#435CAA
azure
#2C84C7
turquoise
#18A1BC
jade
#0EB59E
emerald
#3AB46D
olive
#8A9C44
orange
#F47521
Fields, ink and lines
field-dark
#121214
field-dark-panel
#464648
field-white
#FFFFFF
field-light
#FCFCFD
field-light-warm
#F6F5F2
field-light-panel
#F7F7F7
ink-on-dark
#FFFFFF
ink-on-light
#17171A
ink-panel-text
#333333
line-hairline-on-light
#B5B5B6
chart-comparison
#8B8B8C
actor-human
#3B8344
actor-ai
#4A50A2
Roles the components use
Each role names the token it takes its value from. Where the choice of token is the application's, it says so.
| Role | Light | Dark | Taken from (light / dark) |
|---|---|---|---|
| surface | #FFFFFF | #121214 | color.field.white / color.field.dark |
| panel | #F7F7F7 | #464648 | color.field.light_panel / color.field.dark_panel |
| ink | #17171A | #FFFFFF | color.ink.on_light / color.ink.on_dark |
| ink-secondary | #333333 | #FFFFFF | color.ink.panel_text / color.ink.on_dark (rules.dark_type) |
| line | #B5B5B6 | #6F6F70 | color.line.hairline_on_light / color.field.dark_panel mixed 22% toward white (line note) |
| control-line | #8B8B8C | #8B8B8C | color.chart.comparison / color.chart.comparison (application choice) |
| action | #4A50A2 | #4A50A2 | color.primary / color.primary (application choice) |
| action-ink | #FFFFFF | #FFFFFF | color.ink.on_dark / color.ink.on_dark |
| action-hover | #393D77 | #393D77 | color.spectrum8_shade70 (rules.hover_state) / color.spectrum8_shade70 (rules.hover_state) |
| link | #4A50A2 | #FFFFFF | color.primary / color.ink.on_dark (application choice) |
| link-hover | #393D77 | #FFFFFF | color.spectrum8_shade70 (rules.hover_state) / color.ink.on_dark (application choice) |
| focus | #4A50A2 | #FFFFFF | color.primary / color.ink.on_dark (application choice) |
| selected | #4A50A2 | #FFFFFF | color.primary / color.ink.on_dark (application choice) |
| selected-ink | #FFFFFF | #121214 | color.ink.on_dark / color.field.dark (application choice) |
| status-ink | #333333 | #FFFFFF | color.ink.panel_text (rules.worksheet_cell_tint.ink) / color.ink.on_dark |
| error-fill | #FBD1DF | #AB1649 | color.spectrum8_tint20_on_light pink (worksheet role problem) / color.spectrum8_shade70 pink (worksheet role problem) (application choice) |
| error | #BB174F | #F797B7 | spectrum pink, least changed to clear 4.5:1 (worksheet role problem) / spectrum pink, least changed to clear 4.5:1 (worksheet role problem) (application choice) |
| caution-fill | #FDE3D3 | #B0571D | color.spectrum8_tint20_on_light orange (worksheet role caution) / color.spectrum8_shade70 orange (worksheet role caution) (application choice) |
| caution | #A3511C | #FABD94 | spectrum orange, least changed to clear 4.5:1 (worksheet role caution) / spectrum orange, least changed to clear 4.5:1 (worksheet role caution) (application choice) |
| success-fill | #DBF0DE | #3B8344 | color.spectrum8_tint20_on_light green (worksheet role aligned) / color.spectrum8_shade70 green (worksheet role aligned) (application choice) |
| success | #37773F | #ADDCB2 | spectrum green, least changed to clear 4.5:1 (worksheet role aligned) / spectrum green, least changed to clear 4.5:1 (worksheet role aligned) (application choice) |
| actor-human | #3B8344 | #3B8344 | color.spectrum8_shade70 / color.spectrum8_shade70 |
| actor-ai | #4A50A2 | #4A50A2 | color.primary / color.primary |
| actor-human-bar | #3B8344 | #68A06F | rules.edge_bar_color on rules.actor_color.human / rules.edge_bar_color on rules.actor_color.human |
| actor-ai-bar | #4A50A2 | #8B8FC3 | rules.edge_bar_color on rules.actor_color.ai / rules.edge_bar_color on rules.actor_color.ai |
Type
Open Sans, weights 300, 400, 600, 700, 800 from the token file. The scale is measured on the live site; phone sizes shown, larger from 48rem.
Heading 1: decisions with AI
Heading 2: twelve decision levels
Heading 3: rights and safeguards
Body text. A reference library on designing decisions that involve AI.
Small print: helper text, captions and fine detail.
| Role | Value | Basis |
|---|---|---|
| text-small | 0.9375rem | live site |
| text-body | 1.0625rem | live site |
| text-table | 0.9375rem | application |
| text-h3 | 1.3rem | live site |
| text-h2 | 1.8rem | live site |
| text-h1 | 2.2rem | live site |
| text-h2-wide | 2.6rem | live site |
| text-h1-wide | 3.5rem | live site |
| text-h3-wide | 1.55rem | live site |
| text-eyebrow | 0.84rem | live site |
| text-lead | 1.15rem | application |
| text-lead-wide | 1.4rem | live site |
| text-button | 1.0625rem | live site |
Icons
One filled glyph per noun, so a screen can lead with the picture and keep words short. The first set is the design system's space icons (space-icons-lab, one per space, never per level), copied with the token snapshot. The second covers platform nouns and actions in the same glyph language, drawn for the application. An icon beside text is decorative; alone it carries a label.
From the design system: the spaces
- Start Herestart
- Decision Characteristicsbars
- Decision Rolesactors
- The 12 Decision Levelssteps
- Supporting Capabilitiesblocks
- Augmentation Techniquesspark
- Strategic Framingflag
- Organizational Implementationarrow
- Decision auditcheck
- Compliance guidelinesshield
- Case libraryfolder
- Referencesbook
Application: nouns and actions
- a personmember
- an organizationorganization
- the AI guideguide
- voicevoice
- searchsearch
- a content carddocument
- a tabletable
- emailemail
- send a messagesend
- stop a replystop
- attachattach
- open a listchevron
- homehome
Components and states
Light aesthetic
The page. The header shows the name in text until the logo files arrive; under 48rem the navigation is its own row. The footer shows on public pages only.
As it should appear on your account
Error: Enter an email address, like name@example.com
Anything the guide should know
Card
Text on a panel, in the primary ink.
| Level | Name | Note |
|---|---|---|
| 1 | Pink | Body in the secondary ink |
| 12 | Orange | Scrolls sideways on a phone |
Agent panel
- Human
We want an AI to draft supplier risk summaries. Where do we start?
- AI
Start by deciding who owns the final call. At the level you describe, a person approves each summary before it is used.
Sources: Decision levels, Decision rights
While a reply streams, send becomes stop; while listening, voice is pressed:
- Human
Summarize the audit checklist for level 4.
Dark aesthetic (opt-in)
The page. The header shows the name in text until the logo files arrive; under 48rem the navigation is its own row. The footer shows on public pages only.
As it should appear on your account
Error: Enter an email address, like name@example.com
Anything the guide should know
Card
Text on a panel, in the primary ink.
| Level | Name | Note |
|---|---|---|
| 1 | Pink | Body in the secondary ink |
| 12 | Orange | Scrolls sideways on a phone |
Agent panel
- Human
We want an AI to draft supplier risk summaries. Where do we start?
- AI
Start by deciding who owns the final call. At the level you describe, a person approves each summary before it is used.
Sources: Decision levels, Decision rights
While a reply streams, send becomes stop; while listening, voice is pressed:
- Human
Summarize the audit checklist for level 4.
Measured contrast (WCAG 2.2)
Computed from the resolved role values on every build. The build fails if a gated pair is below its required ratio. Pairs with no requirement are reported with the reason.
| Aesthetic | Pair | Use | Measured | Required | Result |
|---|---|---|---|---|---|
| light | ink on surface | body text on the page (1.4.3) | 17.89:1 | 4.50:1 | pass |
| light | ink on panel | text on a card or table head (1.4.3) | 16.70:1 | 4.50:1 | pass |
| light | ink-secondary on surface | table body and secondary text (1.4.3) | 12.63:1 | 4.50:1 | pass |
| light | ink-secondary on panel | secondary text on a card (1.4.3) | 11.79:1 | 4.50:1 | pass |
| light | action-ink on action | button label (1.4.3) | 7.09:1 | 4.50:1 | pass |
| light | action-ink on action-hover | button label on hover (1.4.3) | 9.96:1 | 4.50:1 | pass |
| light | link on surface | link text on the page (1.4.3) | 7.09:1 | 4.50:1 | pass |
| light | link on panel | link text on a card (1.4.3) | 6.62:1 | 4.50:1 | pass |
| light | link-hover on surface | link text on hover (1.4.3) | 9.96:1 | 4.50:1 | pass |
| light | control-line on surface | field boundary (1.4.11) | 3.40:1 | 3.00:1 | pass |
| light | focus on surface | focus indicator on the page (1.4.11) | 7.09:1 | 3.00:1 | pass |
| light | focus on panel | focus indicator on a card (1.4.11) | 6.62:1 | 3.00:1 | pass |
| light | line on surface | table and card hairline (1.4.11). Ruled by Dan at about 2:1 (line.hairline_on_light). Decorative divider, not the boundary of a control, so 3:1 is not required; reported so the ruling is visible. | 2.05:1 | none | reported |
| dark | ink on surface | body text on the page (1.4.3) | 18.71:1 | 4.50:1 | pass |
| dark | ink on panel | text on a card or table head (1.4.3) | 9.42:1 | 4.50:1 | pass |
| dark | ink-secondary on surface | secondary text (pure white by rules.dark_type) (1.4.3) | 18.71:1 | 4.50:1 | pass |
| dark | action-ink on action | button label (1.4.3) | 7.09:1 | 4.50:1 | pass |
| dark | action-ink on action-hover | button label on hover (1.4.3) | 9.96:1 | 4.50:1 | pass |
| dark | link on surface | link text on the page (1.4.3) | 18.71:1 | 4.50:1 | pass |
| dark | control-line on surface | field boundary (1.4.11) | 5.50:1 | 3.00:1 | pass |
| dark | focus on surface | focus indicator on the page (1.4.11) | 18.71:1 | 3.00:1 | pass |
| dark | focus on panel | focus indicator on a card (1.4.11) | 9.42:1 | 3.00:1 | pass |
| dark | line on panel | table and card hairline (1.4.11). Computed off the panel by the token file's own rule; decorative divider. | 1.88:1 | none | reported |
| dark | action on surface | button fill against the page (1.4.11). Primary indigo on the dark field is below 3:1. The label inside the button carries the meaning (1.4.11 does not require a boundary the text already identifies); reported so the ruling is visible. | 2.64:1 | none | reported |
| light | action-ink on actor-human | Human chip label (rules.actor_color) (1.4.3) | 4.65:1 | 4.50:1 | pass |
| light | action-ink on actor-ai | AI chip label (rules.actor_color) (1.4.3) | 7.09:1 | 4.50:1 | pass |
| light | actor-human-bar on panel | Human edge bar on a message panel (1.4.11) | 4.34:1 | 3.00:1 | pass |
| light | actor-ai-bar on panel | AI edge bar on a message panel (1.4.11) | 6.62:1 | 3.00:1 | pass |
| dark | action-ink on actor-human | Human chip label (rules.actor_color) (1.4.3) | 4.65:1 | 4.50:1 | pass |
| dark | action-ink on actor-ai | AI chip label (rules.actor_color) (1.4.3) | 7.09:1 | 4.50:1 | pass |
| dark | actor-human-bar on panel | Human edge bar on a message panel (1.4.11) | 3.07:1 | 3.00:1 | pass |
| dark | actor-ai-bar on panel | AI edge bar on a message panel (1.4.11) | 3.06:1 | 3.00:1 | pass |
| light | status-ink on error-fill | text on a error notice (1.4.3) | 9.20:1 | 4.50:1 | pass |
| light | error on surface | error text and field border on the page (1.4.3) | 6.27:1 | 4.50:1 | pass |
| light | error on panel | error text on a card (1.4.3) | 5.85:1 | 4.50:1 | pass |
| light | error on error-fill | error edge bar on its notice (1.4.11) | 4.57:1 | 3.00:1 | pass |
| light | status-ink on caution-fill | text on a caution notice (1.4.3) | 10.29:1 | 4.50:1 | pass |
| light | caution on surface | caution text and field border on the page (1.4.3) | 5.60:1 | 4.50:1 | pass |
| light | caution on panel | caution text on a card (1.4.3) | 5.23:1 | 4.50:1 | pass |
| light | caution on caution-fill | caution edge bar on its notice (1.4.11) | 4.56:1 | 3.00:1 | pass |
| light | status-ink on success-fill | text on a success notice (1.4.3) | 10.55:1 | 4.50:1 | pass |
| light | success on surface | success text and field border on the page (1.4.3) | 5.42:1 | 4.50:1 | pass |
| light | success on panel | success text on a card (1.4.3) | 5.06:1 | 4.50:1 | pass |
| light | success on success-fill | success edge bar on its notice (1.4.11) | 4.53:1 | 3.00:1 | pass |
| dark | status-ink on error-fill | text on a error notice (1.4.3) | 7.14:1 | 4.50:1 | pass |
| dark | error on surface | error text and field border on the page (1.4.3) | 8.97:1 | 4.50:1 | pass |
| dark | error on panel | error text on a card (1.4.3) | 4.51:1 | 4.50:1 | pass |
| dark | error on error-fill | error edge bar on its notice (1.4.11) | 3.42:1 | 3.00:1 | pass |
| dark | status-ink on caution-fill | text on a caution notice (1.4.3) | 4.97:1 | 4.50:1 | pass |
| dark | caution on surface | caution text and field border on the page (1.4.3) | 11.38:1 | 4.50:1 | pass |
| dark | caution on panel | caution text on a card (1.4.3) | 5.73:1 | 4.50:1 | pass |
| dark | caution on caution-fill | caution edge bar on its notice (1.4.11) | 3.02:1 | 3.00:1 | pass |
| dark | status-ink on success-fill | text on a success notice (1.4.3) | 4.65:1 | 4.50:1 | pass |
| dark | success on surface | success text and field border on the page (1.4.3) | 12.17:1 | 4.50:1 | pass |
| dark | success on panel | success text on a card (1.4.3) | 6.12:1 | 4.50:1 | pass |
| dark | success on success-fill | success edge bar on its notice (1.4.11) | 3.02:1 | 3.00:1 | pass |
| light | selected on surface | a checked box, radio or switch, and the current-page bar in the navigation (1.4.11) | 7.09:1 | 3.00:1 | pass |
| light | selected on panel | a checked box, radio or switch on a card (1.4.11) | 6.62:1 | 3.00:1 | pass |
| light | selected-ink on selected | the tick in a checked box and the thumb of a switch that is on (1.4.11) | 7.09:1 | 3.00:1 | pass |
| dark | selected on surface | a checked box, radio or switch, and the current-page bar in the navigation (1.4.11) | 18.71:1 | 3.00:1 | pass |
| dark | selected on panel | a checked box, radio or switch on a card (1.4.11) | 9.42:1 | 3.00:1 | pass |
| dark | selected-ink on selected | the tick in a checked box and the thumb of a switch that is on (1.4.11) | 18.71:1 | 3.00:1 | pass |
Each spectrum colour against the surfaces
| Colour | On white | On the dark field |
|---|---|---|
| pink #ED1860 | 4.29:1 | 4.37:1 |
| magenta #C3386C | 5.12:1 | 3.66:1 |
| purple #68318A | 8.77:1 | 2.13:1 |
| indigo #4A50A2 | 7.09:1 | 2.64:1 |
| blue #2590CF | 3.52:1 | 5.32:1 |
| teal #08B5A5 | 2.57:1 | 7.27:1 |
| green #4DB358 | 2.66:1 | 7.04:1 |
| orange #F47521 | 2.83:1 | 6.61:1 |
Decisions
Colour is led by Ross and Dan's design system. The application layer is decided in this package. Full record: packages/brand/DECISIONS.md.
Taken from the design system
| Colour | The spectrum (8 and 12 step), each hue's shade and tint, the fields, inks, hairline and comparison grey, as CSS variables and data. HAI Indigo is the primary. No colour is entered anywhere else; the build fails on a hand-entered one |
|---|---|
| Computed colour rules | Hover is the hue's shade (rules.hover_state). A colour that must carry text or meaning is the hue moved the least that clears its contrast floor (the mechanism of rules.marker_color, edge_bar_color and solid_plate_type) |
| The contrast gate | Every colour pair the application draws is measured on each build against WCAG 2.2 and fails the build below its ratio (rules.contrast_gate) |
| Typeface | Open Sans (type.family, ratified), in the weights the token file lists. The live site uses the same |
| Human and AI colours | Human in shade green, AI in indigo, white type on the chip (rules.actor_color), in the agent panel |
| Status hues | Error, caution and success take Dan's role mapping from rules.worksheet_cell_tint (problem pink, caution orange, aligned green): the hue's tint as the fill on light, its shade on dark |
| Space icons | The twelve space glyphs and their disc-plate form, copied from space-icons-lab at the pinned commit |
| Eight-colour rule | The wordmark's underline order (color.spectrum8_titlebar_order) under the hero and in the working indicator |
Decided for the application
| Type scale | Measured on the live site humansplus.ai: body 17px at 1.65, headings at weight 800 with tight tracking (h1 35px rising to 56px, h2 29px to 42px), h3 at 700, eyebrow and lead styles. Phone sizes first |
|---|---|
| Spacing and layout | Seven spacing steps (0.25rem to 3rem); a 72.5rem page, 5.5rem between sections and 1.875rem card padding from the live site; 48rem breakpoint; 2.75rem minimum touch target |
| Rounded corners | 6px on controls (buttons, fields, icon buttons, chips) and surfaces (cards, notices, tables, the agent panel). The live site rounds its buttons at 6px |
| Focus | A 3px outline, 2px offset: indigo on light, white on dark, measured at 3:1 or better |
| Links | Indigo and underlined on light, hover to indigo shade; white and underlined on dark, because indigo is 2.64:1 on the dark field |
| Buttons | Primary (indigo, white label, bold) and neutral (outlined); icon and icon-only forms; disabled is a quiet panel fill |
| Fields | A 2px boundary in the comparison grey (3.40:1 on white), because the hairline is 2:1 and a control needs 3:1; errors in the error colour with the word Error |
| Notices | Tinted fill, edge bar in the status colour, and the kind always said in a word, never by colour alone |
| Dark aesthetic | Built from field.dark and field.dark_panel, opt-in with data-aesthetic="dark". Light on field.white is the default |
| Agent panel | The person's turn is a bubble, the guide's reply bare text; the composer is one frame of glyph controls (attach, voice, send that becomes stop). Pattern from the Helikona chat reference |
| Icons | The design system's glyph language extended to platform nouns and actions (member, organization, guide, voice, search, content card, table, email, send, stop, attach, open a list, home); three sizes |
| Motion | 120ms transitions on the site's easing curve; the working indicator steps through the eight colours in 1.4s; all motion stops under reduced-motion |
| Tables | Real tables with hairline cells, heads on the panel, sideways scroll on a phone |
| Form controls | Text area and select share the field's label, hint and error. Checkbox, radio and switch are the native inputs restyled, so keyboard and assistive technology behave as standard; the whole row is the touch target; checked is the primary colour on light and white on dark (the primary is 2.64:1 on the dark field), with the design system's tick glyph. An unchecked control keeps the page surface as its fill, so its boundary is 3:1 wherever it sits. Groups are a fieldset with a legend. In a text field the control sits directly under its label, with the hint and error beneath, so controls in neighbouring columns line up; fields are spaced by one even gap (hai-form) |
| Navigation and shell | Sized on the Helikona client: a 56px header that stays at the top, on the page surface with a hairline beneath; 36px controls in it. The name is text until the logo files arrive (M1). Signed out, the right side is a sign-in button; signed in, the member's profile picture as a round button (a grey head-and-shoulders placeholder when there is none) that opens a menu without script. Primary navigation takes a glyph per item and marks the current page with a bar in the selected colour and aria-current; under the breakpoint it is its own row and scrolls sideways. A skip link comes first. The footer shows only on public pages, never once signed in. Single-column form pages such as sign-in are 28rem wide |
Not carried over
| Square corners | geometry.corners is ratified square (Ross, 2026-08-18) for graphics and Circle tiles. In an interactive product it reads as dated, and the live site already rounds its buttons. Derek Laney's instruction, 2026-11-16 |
|---|---|
| Colour only on the edge bar | The Corporate Neutral style keeps colour off panels. Application notices need a status a person sees at once, so they take a tinted fill from the same tokens |
| The hairline as a control boundary | line.hairline_on_light is ruled at about 2:1 for table and panel outlines and stays there; it is too faint for a form field under WCAG 2.2 |
| Graphics type conventions | The frame-class scale, the 1600px master sizes and the 32px content-type tiebreaker are for rendered graphics and do not apply to live text |
| The live site's off-token colours | The site's blue button fill, its greys (#111111, #5C5C66, #E4E4EA, #F6F6FA), header shadow and indigo-to-purple gradient are not in the token file, so they are not used: colour is led by the token file |
Not built yet
| Logo, wordmark and application icons | The files from Ross's team (only a PNG sample is in the repository); then favicon, touch icons and a web manifest |
|---|---|
| Primary navigation and legal pages | The header carries no navigation items yet because the application has no sections to link to; the footer has no terms or privacy links because those pages do not exist |
| Overlays and feedback | Dialog, menu, tabs, toast, empty and loading states |
| An email layout and components on the token data (generated/tokens.json is ready for it) | |
| Elevation | No shadow tokens exist; none are used |
To confirm with Ross and Dan
| Rounded corners (N1) | May the application be rounded, and should geometry.corners record it? Built rounded |
|---|---|
| Neutrals | Should the site's cooler greys become tokens, so the site and the application share them (N5)? Built on the token file's neutrals |
| Dark mode | Does the application ship the dark aesthetic, and follow the device setting? Built opt-in |
| The application's glyphs (A11) | Approve or redraw the thirteen glyphs added here |
| Status colours (S6) | Confirm the worksheet's problem, caution and aligned hues may also mark errors, warnings and success |