This repository is the canonical source of truth for all BSD XR brand assets
and design system specifications. The files below are structured for consumption
by AI agents, LLMs, and automated systems. Download any file to provide brand
context to your agent or workflow.
Brand Guide
Full brand specification — colours, typography, logo rules, component patterns,
UI principles, voice and tone.
branding.md
Download
Brand Voice
Voice and tone guide for AI-generated content — writing rules, do/don't examples,
sector terminology, and a copy checklist.
brand-voice.md
Download
Agent Guide
Instructions for AI agents — repository structure, colour tokens, logo selection,
icon guide, HTML meta tags, and component quick reference.
agent-guide.md
Download
Theme Tokens
Machine-readable colour and typography tokens in JSON format.
Import directly into build tools, design systems, or codegen pipelines.
theme.json
Theme Schema
JSON Schema (2020-12) describing the shape of theme.json.
Wire it up in your editor for validation and autocomplete, or use it
to validate token edits before shipping them.
theme.schema.json
Claude Skill Package
Self-contained Claude Code skill — bundles theme.json,
theme.schema.json, and the logo files. Drop the whole
folder into any project's .claude/skills/ for instant,
offline brand awareness — no need to hunt for this repo first.
.claude/skills/bsd-branding/
View on GitHub
Icon Bundle
Complete icon set — iOS, Android, macOS, watchOS. All density and size
variants. Latest release from GitHub.
AppIcons.zip
Download
1
Using Claude Code? Copy .claude/skills/bsd-branding/ into your project's .claude/skills/ — it's self-contained, so agents get tokens, schema, and logos with no extra setup.
2
Otherwise, download agent-guide.md and include it in your agent's system prompt or context window as the primary technical reference.
3
Download brand-voice.md when the agent will generate copy, marketing text, UI labels, or any written content.
4
Use Copy JSON above to grab theme.json straight to your clipboard, validated against theme.schema.json, for programmatic access to colour tokens.
5
Reference logo files from logos/ and icons from icons/ using the paths specified in agent-guide.md.