Can I use custom fonts with this skill?

Absolutely. The skill supports defining fonts from Google Fonts, Bunny Fonts, or local files within the typography section of the YAML file.

How does automatic discovery work?

By naming your file '_brand.yml' and placing it in your project root, Shiny and Quarto will automatically detect and apply your styles without explicit paths.

Does this skill work with both R and Python?

Yes, it provides specific integration guides and implementation patterns for using brand.yml in both Shiny for R (via bslib) and Shiny for Python.

What is a brand.yml file?

It is a standardized YAML-based format that translates brand guidelines into a machine-readable file usable across Shiny applications and Quarto documents.

Can I manage light and dark modes?

Yes, the brand.yml specification allows for defining specific light and dark variants for colors and logos to support modern UI requirements.

Brand.yml Configurator

Name: Brand.yml Configurator
Author: posit-dev

byposit-dev

•

Design Tools

Standardizes visual identity across Shiny applications and Quarto documents using machine-readable YAML brand specifications.

The brand-yml skill enables developers to implement and maintain consistent brand guidelines across the entire Posit ecosystem. By leveraging the _brand.yml specification, it automates the translation of corporate identity elements—including custom color palettes, Google/local fonts, and multi-variant logos—into production-ready styling for Shiny (R and Python) and Quarto. It provides a structured workflow for creating, modifying, and troubleshooting brand definitions, ensuring a unified visual experience across dashboards, reports, and web apps without manual CSS overrides.

Key Features

01Automated generation of _brand.yml files from design guidelines

02Framework-specific troubleshooting and validation for YAML syntax

03Unified branding for Quarto documents, presentations, and dashboards

04Deep integration with Shiny for R (bslib) and Shiny for Python (ui.Theme)

0510 GitHub stars

06Support for complex typography, color aliasing, and multi-size logos

Use Cases

01Managing light and dark mode variants for technical documentation and reports

02Enforcing corporate design standards across a suite of data science dashboards

03Rapidly porting brand identity from marketing specs to functional web applications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add posit-dev/skills brand-yml

For use in Claude.ai and ChatGPT

Download Skill