Brand Identity Guide

Overview

This guide covers the end-to-end process of building and enforcing a brand identity system: from strategic positioning through visual tokens, voice guidelines, logo rules, and accessibility compliance. All outputs should be developer-ready with real values, not placeholders.

Brand Foundation Process

1. Discovery

• Identify target audience, competitive landscape, and business objectives.

• Audit existing brand assets (if any) for consistency gaps.

• When creating a brand from scratch, start with positioning (audience, differentiator, personality) before any visual work.

2. Foundation

• Define positioning, values, and personality before any visual work.

• Write voice guidelines with a tone table and vocabulary lists.

• Voice guidelines must include do/don't examples for each tone variation.

3. Visual System

• Create color tokens with real hex values, not placeholders.

• Define typography stack with web-safe fallbacks. Typography stacks should include at least two fallback fonts.

• Specify logo usage rules with minimum sizes and clear-space ratios.

• Verify every text/background pairing against WCAG AA (4.5:1 for normal text, 3:1 for large text).

• Every brand element should reinforce the positioning strategy.

4. Enforcement

• Review new assets against the brand guide checklist: palette, typography, voice, logo rules.

• Flag deviations with the specific rule violated and a compliant alternative.

• When a stakeholder requests an off-brand element, explain the brand rationale and offer a compliant alternative.

How to Handle Brand Evolution

• When a brand needs to evolve, change the minimum number of tokens required to achieve the new positioning. Avoid full redesigns unless the current system cannot express the new direction.

• When extending a brand to a new product line, reuse the core palette and voice but allow a unique accent color and sub-personality within the defined spectrum.

How to Audit an Asset for Brand Compliance

Check the following in order:

• Colors are within the defined palette.

• Typography uses approved families.

• Voice matches the context-appropriate tone.

• Logo usage falls within clear-space rules.

When brand guidelines conflict with usability, propose a solution that satisfies both before compromising either.

Scripts

The following scripts are available in the scripts/ directory for automated brand work:

scripts/check_contrast.py

WCAG 2.1 contrast ratio checker. Validates foreground/background color pairs against AA and AAA criteria for normal and large text.

python scripts/check_contrast.py --fg "#0F172A" --bg "#FFFFFF" python scripts/check_contrast.py --file color_pairs.json --json

scripts/generate_tokens.py

Generates a full design token color scale (50-900), neutral scale, and semantic colors (success, warning, error, info) from a single primary hex color. Outputs CSS custom properties or JSON.

python scripts/generate_tokens.py "#3B82F6" python scripts/generate_tokens.py "#3B82F6" --format json

See Meridian Analytics Example for a complete, production-ready brand guide demonstrating the expected structure and level of detail for all brand work.