design-brand-guardian
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.