cyberneticlibrary

Create brand tokens for apps and documents

brand-ymlskillsetup L2352
posit-dev/skills
What it does

Create and use brand.yml files for consistent app/document branding

Best for

Design system owners ensuring Shiny apps and Quarto documents use consistent brand tokens without duplicating CSS.

Inputs
  • · Brand guidelines: colors (primary, secondary, semantic), fonts (families, sizes), logos, company meta
  • · Existing _brand.yml file path (for modification)
  • · Brand context: company name, links, social
Outputs
  • · YAML _brand.yml file with color palette, typography, logo paths, meta
  • · Specification reference to brand-yml-spec.md
  • · Integration instructions for Shiny (R/Python), Quarto, R Markdown
Requires
  • · YAML-compliant editor
  • · Shiny (R or Python) or Quarto for consumption
Preconditions
  • · Brand guidelines document available
  • · Logo files at known relative paths
  • · Google Fonts or local font sources specified
Failure modes
  • · Hex color format invalid (missing # or uppercase) → parsing silent failure
  • · Font family referenced before defined in palette → undefined color reference
  • · File paths relative instead of absolute → images/fonts not found at runtime
Trust signals
  • · Decision tree with 7 explicit paths
  • · Step-by-step file creation from brand guidelines
  • · Minimum viable YAML example + progressively enhanced versions
  • · Named best practices: hex format, lowercase hyphens, color palette before reference