Halo Brand System

Guidance set

Motion

must

When reduced motion is requested, render the final state immediately and preserve all meaning.

Motion must teach without becoming required for comprehension.

Examples

Use

The complete diagram appears without the connector animation.

Avoid

Critical state remains hidden because its reveal animation is disabled.

halo.accessibility.motion-reduction

must-not

Do not animate large blur filters on mobile.

Imported from the Working rules section of the Halo guidance.

halo.visual.motion.do-not-animate-large-blur-filters-on-mobile

must-not

Do not use the signature as pagination dots, typing indicators, an ellipsis, an overflow menu, generic bullets, or background texture.

Imported from the Working rules section of the Halo guidance.

halo.visual.motion.do-not-use-the-signature-as-pagination-dots-typing-indicators-an-ellipsi

must

Durations: 160–520ms interface response, 900–1600ms editorial narrative, and up to 3600ms for one deliberate teaching sequence; protected VSI owns its internal timeline.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.motion.durations-160-520ms-interface-response-900-1600ms-editorial-narrative-an

must

Easings: cubic-bezier(0.2, 0, 0, 1) standard, cubic-bezier(0.16, 1, 0.3, 1) emphasized, and cubic-bezier(0.32, 0, 0.18, 1) for teaching sequences.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.motion.easings-cubic-bezier-0-2-0-0-1-standard-cubic-bezier-0-16-1-0-3-1-emphas

should

Entrance motion is optional, measured, non-looping, and supported by a static label or accessible name.

Imported from the Working rules section of the Halo guidance.

halo.visual.motion.entrance-motion-is-optional-measured-non-looping-and-supported-by-a-stat

must-not

No scroll-jacking, parallax nausea, perpetual ambient movement, or motion-only meaning.

Imported from the Working rules section of the Halo guidance.

halo.visual.motion.no-scroll-jacking-parallax-nausea-perpetual-ambient-movement-or-motion-o

should

One teaching animation per viewport.

Imported from the Working rules section of the Halo guidance.

halo.visual.motion.one-teaching-animation-per-viewport

must

Page transitions are optional and never block navigation.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.motion.page-transitions-are-optional-and-never-block-navigation

should

Reduced motion renders final states immediately.

Imported from the Working rules section of the Halo guidance.

halo.visual.motion.reduced-motion-renders-final-states-immediately

must

Scroll reveal is opacity plus max 16px movement.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.motion.scroll-reveal-is-opacity-plus-max-16px-movement

should

The complete Motion Signature is used only for movement, progression, confidence, workflow, capture, or completion.

Imported from the Working rules section of the Halo guidance.

halo.visual.motion.the-complete-motion-signature-is-used-only-for-movement-progression-conf

must

The Halo Motion Signature is the official secondary brand asset and always reads Target -> Align -> Capture.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.motion.the-halo-motion-signature-is-the-official-secondary-brand-asset-and-alwa

should

The Halo Target may be used alone for a true destination, guidance point, or capture waypoint.

Imported from the Working rules section of the Halo guidance.

halo.visual.motion.the-halo-target-may-be-used-alone-for-a-true-destination-guidance-point-

must

The progression remains recognizable without colour and never reverses.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.motion.the-progression-remains-recognizable-without-colour-and-never-reverses

must

The signature uses 8px Target, 12px Align, 16px Capture, 16px spacing, a 1.25px target ring, and a 3px centre dot at the reference scale.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.motion.the-signature-uses-8px-target-12px-align-16px-capture-16px-spacing-a-1-2

Guidance set

Components

must

A component variant must solve a recurring semantic need across surfaces rather than a single layout preference.

Imported from the Rules section of the Halo guidance.

halo.visual.components.a-component-variant-must-solve-a-recurring-semantic-need-across-surfaces

must

Catalog cards are reserved for official assets, icons, components, photography, diagrams, motion, and presentation specimens.

Imported from the Rules section of the Halo guidance.

halo.visual.components.catalog-cards-are-reserved-for-official-assets-icons-components-photogra

must-not

Do not add a component without keyboard, screen-reader, reduced-motion, and responsive behaviour where applicable.

Imported from the Red lines section of the Halo guidance.

halo.visual.components.do-not-add-a-component-without-keyboard-screen-reader-reduced-motion-and

must-not

Do not fork a canonical component for one deck, page, campaign, or document.

Imported from the Red lines section of the Halo guidance.

halo.visual.components.do-not-fork-a-canonical-component-for-one-deck-page-campaign-or-document

must-not

Do not place ordinary paragraphs in cards merely to create visual rhythm.

Imported from the Red lines section of the Halo guidance.

halo.visual.components.do-not-place-ordinary-paragraphs-in-cards-merely-to-create-visual-rhythm

must

Empty and loading states communicate system work without decoration, false certainty, or celebratory motion.

Imported from the Rules section of the Halo guidance.

halo.visual.components.empty-and-loading-states-communicate-system-work-without-decoration-fals

must

Every component specification includes purpose, usage, variants, spacing, accessibility, approved examples, rejected examples, and source ownership.

Imported from the Rules section of the Halo guidance.

halo.visual.components.every-component-specification-includes-purpose-usage-variants-spacing-ac

must

Evidence cards show the artifact directly and keep provenance close enough to preserve trust.

Imported from the Rules section of the Halo guidance.

halo.visual.components.evidence-cards-show-the-artifact-directly-and-keep-provenance-close-enou

must

Forms name the current state, the reason, the next action, and any evidence or privacy consequence.

Imported from the Rules section of the Halo guidance.

halo.visual.components.forms-name-the-current-state-the-reason-the-next-action-and-any-evidence

must

Metric cards use one primary number with unit, timeframe, source, and plain-language interpretation.

Imported from the Rules section of the Halo guidance.

halo.visual.components.metric-cards-use-one-primary-number-with-unit-timeframe-source-and-plain

must

Navigation keeps literal labels, stable placement, clear active state, keyboard access, and predictable disclosure.

Imported from the Rules section of the Halo guidance.

halo.visual.components.navigation-keeps-literal-labels-stable-placement-clear-active-state-keyb

must

Section dividers reset attention with short labels, quiet numbering, and measured rules rather than chapter art.

Imported from the Rules section of the Halo guidance.

halo.visual.components.section-dividers-reset-attention-with-short-labels-quiet-numbering-and-m

must

Workflow components use numbered steps, equal geometry, state labels, and explicit inputs and outputs.

Imported from the Rules section of the Halo guidance.

halo.visual.components.workflow-components-use-numbered-steps-equal-geometry-state-labels-and-e

Guidance set

Data Visualization

must

Choose the simplest chart that preserves the relationship and does not hide variance.

Imported from the Rules section of the Halo guidance.

halo.visual.data-visualization.choose-the-simplest-chart-that-preserves-the-relationship-and-does-not-h

must

Confidence and uncertainty are shown when they affect the decision.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.data-visualization.confidence-and-uncertainty-are-shown-when-they-affect-the-decision

must-not

Do not crop axes or manipulate scale to exaggerate change.

Imported from the Red lines section of the Halo guidance.

halo.visual.data-visualization.do-not-crop-axes-or-manipulate-scale-to-exaggerate-change

must-not

Do not use 3D charts, decorative gradients, rainbow palettes, unlabeled percentages, or chart types that hide the point.

Imported from the Red lines section of the Halo guidance.

halo.visual.data-visualization.do-not-use-3d-charts-decorative-gradients-rainbow-palettes-unlabeled-per

must-not

Do not use colour as the only distinction between series or states.

Imported from the Red lines section of the Halo guidance.

halo.visual.data-visualization.do-not-use-colour-as-the-only-distinction-between-series-or-states

must

Keep axes, baselines, intervals, and comparison periods visible enough to audit the claim.

Imported from the Rules section of the Halo guidance.

halo.visual.data-visualization.keep-axes-baselines-intervals-and-comparison-periods-visible-enough-to-a

must

Label directly and avoid legends when the labels fit beside the data.

Imported from the Rules section of the Halo guidance.

halo.visual.data-visualization.label-directly-and-avoid-legends-when-the-labels-fit-beside-the-data

must

Preserve legibility in print, grayscale, reduced colour, zoom, and narrow layouts.

Imported from the Rules section of the Halo guidance.

halo.visual.data-visualization.preserve-legibility-in-print-grayscale-reduced-colour-zoom-and-narrow-la

must

Provide a concise text summary and an accessible data table for interactive or published charts.

Imported from the Rules section of the Halo guidance.

halo.visual.data-visualization.provide-a-concise-text-summary-and-an-accessible-data-table-for-interact

must

Units, timeframes, source, and interpretation remain attached to every chart that leaves its source context.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.data-visualization.units-timeframes-source-and-interpretation-remain-attached-to-every-char

must

Use Carbon, Graphite, Steel, and Fog as the default series palette, with one Halo Magenta highlight.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.data-visualization.use-carbon-graphite-steel-and-fog-as-the-default-series-palette-with-one

must

Use Magenta for only one competing story in a chart.

Imported from the Rules section of the Halo guidance.

halo.visual.data-visualization.use-magenta-for-only-one-competing-story-in-a-chart

must

Use operational status colours only for their documented meanings.

Imported from the Rules section of the Halo guidance.

halo.visual.data-visualization.use-operational-status-colours-only-for-their-documented-meanings

Guidance set

Diagram Language

must

All diagrams start with a concise prose summary.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.diagram-language.all-diagrams-start-with-a-concise-prose-summary

must

Connectors have verbs.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.diagram-language.connectors-have-verbs

must

Current, next, and future use text labels plus line styles.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.diagram-language.current-next-and-future-use-text-labels-plus-line-styles

should

Maximum seven primary nodes per viewport.

Imported from the Working rules section of the Halo guidance.

halo.visual.diagram-language.maximum-seven-primary-nodes-per-viewport

should

Mobile becomes an ordered vertical sequence.

Imported from the Working rules section of the Halo guidance.

halo.visual.diagram-language.mobile-becomes-an-ordered-vertical-sequence

must-not

No 3D isometric infrastructure.

Imported from the Working rules section of the Halo guidance.

halo.visual.diagram-language.no-3d-isometric-infrastructure

must-not

No vendor-logo constellations.

Imported from the Working rules section of the Halo guidance.

halo.visual.diagram-language.no-vendor-logo-constellations

must

Use nodes only for real objects or actors.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.diagram-language.use-nodes-only-for-real-objects-or-actors

Guidance set

Iconography

should

Decorative icons are hidden from assistive technology; meaningful icons have an accessible label or adjacent visible label.

Imported from the Working rules section of the Halo guidance.

halo.visual.iconography.decorative-icons-are-hidden-from-assistive-technology-meaningful-icons-h

must-not

Do not add icons from another library.

Imported from the Red lines section of the Halo guidance.

halo.visual.iconography.do-not-add-icons-from-another-library

must-not

Do not imply legal certification with a trust icon unless the underlying claim is true.

Imported from the Red lines section of the Halo guidance.

halo.visual.iconography.do-not-imply-legal-certification-with-a-trust-icon-unless-the-underlying

must-not

Do not import icons directly from `lucide-react` in Halo artifacts.

Imported from the Red lines section of the Halo guidance.

halo.visual.iconography.do-not-import-icons-directly-from-lucide-react-in-halo-artifacts

must-not

Do not rotate, stretch, edit paths, combine icons into a new mark, or use an icon as wallpaper.

Imported from the Working rules section of the Halo guidance.

halo.visual.iconography.do-not-rotate-stretch-edit-paths-combine-icons-into-a-new-mark-or-use-an

must-not

Do not use proprietary candidate capture icons as generally approved symbols until their construction and meaning pass review.

Imported from the Red lines section of the Halo guidance.

halo.visual.iconography.do-not-use-proprietary-candidate-capture-icons-as-generally-approved-sym

must

Filled, AI-generated, mixed-library, gradient, duotone, and decorative icon sets are prohibited.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.iconography.filled-ai-generated-mixed-library-gradient-duotone-and-decorative-icon-s

should

Icon-only controls use a minimum 44px target even when the drawn icon is smaller.

Imported from the Working rules section of the Halo guidance.

halo.visual.iconography.icon-only-controls-use-a-minimum-44px-target-even-when-the-drawn-icon-is

should

Icons inherit text colour by default; use Magenta only for active focus, capture guidance, source evidence, or selected state.

Imported from the Working rules section of the Halo guidance.

halo.visual.iconography.icons-inherit-text-colour-by-default-use-magenta-only-for-active-focus-c

must

Lucide is the only approved source library for general-purpose Halo icons.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.iconography.lucide-is-the-only-approved-source-library-for-general-purpose-halo-icon

should

Pair an icon with visible text unless the convention is universal and the control has an accessible name.

Imported from the Working rules section of the Halo guidance.

halo.visual.iconography.pair-an-icon-with-visible-text-unless-the-convention-is-universal-and-th

should

Proprietary icon requests must prove a recurring Halo concept that Lucide cannot represent precisely.

Imported from the Working rules section of the Halo guidance.

halo.visual.iconography.proprietary-icon-requests-must-prove-a-recurring-halo-concept-that-lucid

must

Registry names are lowercase kebab-case and describe what the icon means inside Halo.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.iconography.registry-names-are-lowercase-kebab-case-and-describe-what-the-icon-means

should

Use 12px only for dense metadata, 16px for compact controls, 20px for default product UI, 24px for navigation and toolbars, and 32px only for rare feature headers or specimens.

Imported from the Working rules section of the Halo guidance.

halo.visual.iconography.use-12px-only-for-dense-metadata-16px-for-compact-controls-20px-for-defa

must

Use a 24px optical box, 1.5px default stroke, round caps, round joins, and absolute stroke width.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.iconography.use-a-24px-optical-box-1-5px-default-stroke-round-caps-round-joins-and-a

should

Use `arrow-right` for primary progression, `chevron-right` for disclosure, and `move-right` for physical or spatial movement.

Imported from the Approved patterns section of the Halo guidance.

halo.visual.iconography.use-arrow-right-for-primary-progression-chevron-right-for-disclosure-and

should

Use `circle-check` only when a confirmed state must stand alone; do not repeat it beside redundant completion copy.

Imported from the Approved patterns section of the Halo guidance.

halo.visual.iconography.use-circle-check-only-when-a-confirmed-state-must-stand-alone-do-not-rep

should

Use `download` for one file and `archive` for a bundle of files.

Imported from the Approved patterns section of the Halo guidance.

halo.visual.iconography.use-download-for-one-file-and-archive-for-a-bundle-of-files

should

Use `file-check` for a verified evidence record and `shield-check` only for a genuine trust or compliance meaning.

Imported from the Approved patterns section of the Halo guidance.

halo.visual.iconography.use-file-check-for-a-verified-evidence-record-and-shield-check-only-for-

must

Use outline icons only unless a future proprietary Halo icon has a documented and approved exception.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.iconography.use-outline-icons-only-unless-a-future-proprietary-halo-icon-has-a-docum

should

Use `scan-line`, `crosshair`, and `focus` for distinct capture, alignment, and framing meanings.

Imported from the Approved patterns section of the Halo guidance.

halo.visual.iconography.use-scan-line-crosshair-and-focus-for-distinct-capture-alignment-and-fra

should

Use semantic colour only when the icon communicates a real status.

Imported from the Working rules section of the Halo guidance.

halo.visual.iconography.use-semantic-colour-only-when-the-icon-communicates-a-real-status

must

Use the 23-name Halo icon registry rather than importing directly from Lucide or adding one-off SVG files.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.iconography.use-the-23-name-halo-icon-registry-rather-than-importing-directly-from-l

Guidance set

Technical Annotation

must

Annotations never obscure the vehicle.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.technical-annotation.annotations-never-obscure-the-vehicle

must

Annotations use short nouns, thin rules, and fixed anchor points.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.technical-annotation.annotations-use-short-nouns-thin-rules-and-fixed-anchor-points

should

Essential meaning appears in DOM text.

Imported from the Working rules section of the Halo guidance.

halo.visual.technical-annotation.essential-meaning-appears-in-dom-text

must

Magenta is active; green is verified; neutral is descriptive.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.technical-annotation.magenta-is-active-green-is-verified-neutral-is-descriptive

should

Maximum five simultaneous labels in a marketing viewport.

Imported from the Working rules section of the Halo guidance.

halo.visual.technical-annotation.maximum-five-simultaneous-labels-in-a-marketing-viewport

must-not

No blinking.

Imported from the Working rules section of the Halo guidance.

halo.visual.technical-annotation.no-blinking

must-not

No tiny text below 12px rendered size.

Imported from the Working rules section of the Halo guidance.

halo.visual.technical-annotation.no-tiny-text-below-12px-rendered-size

must

Three hierarchy levels: label, value/state, optional explanation.

Imported from the Locked decisions section of the Halo guidance.

halo.visual.technical-annotation.three-hierarchy-levels-label-value-state-optional-explanation