brand-yml

Unified branding with a single YAML file

posit-dev/brand-yml

posit-dev.github.io/brand-yml

97 stars

8 forks

MIT

Python

brand.yml is a portable YAML-based format for codifying company brand guidelines (logos, colors, fonts, typography) that works across Quarto, Python, and R tooling. It enables developers to create consistently branded reports, applications, dashboards, plots, and presentations from a single _brand.yml file.

The package solves the problem of maintaining consistent branding across different output formats and tools by providing a unified specification that integrates with Posit’s open source ecosystem, including Quarto (v1.6+) and Shiny for both Python and R. Python and R packages are available to read and apply brand.yml files programmatically. This eliminates the need to manually configure themes separately for each tool or output type.

Contributors#

Resources featuring brand-yml#

Company-branded reports, apps, and dashboards made easier with brand.yml & Posit

You will learn: How to apply consistent company branding across reports, dashboards, and apps

Key Links:

GitHub Repo for Example: https://github.com/skaltman/brand-yml-demo
brand.yml GitHub repo: https://posit-dev.github.io/brand-yml/
Follow-along blog post: https://posit.co/blog/unified-branding-across-posit-tools-with-brand-yml/
Q&A after the Demo: https://youtube.com/live/kuEbRfmm4G4?feature=share

Additional Resources Mentioned in Q&A:

Quarto specific page on brand: https://quarto.org/docs/authoring/brand.html
Typography: https://posit-dev.github.io/brand-yml/brand/typography.html
brand.yml + pkgdown: https://github.com/rstudio/bslib/tree/main/pkgdown
LLM brand.yml prompt: https://posit-dev.github.io/brand-yml/articles/llm-brand-yml-prompt/
Inspiration/gallery: https://posit-dev.github.io/brand-yml/inspiration/

Why we think this is important: Consistent company branding in your reports and apps (with your logo, colors, and fonts) can help make your work look more professional, but are often tricky to get right.

Common challenges we’ve heard from the community:

Excessive manual effort: Applying colors, fonts, and logos across reports, apps, and dashboards takes time and is prone to errors.
Difficult to update: When brand guidelines change, it’s difficult to update all products consistently.
Team consistency: Ensuring all contributors follow branding guidelines is challenging to manage.

How to join future events: We host workflow demos the last Wednesday of every month. You can add them to your calendar with this link: https://www.addevent.com/event/Eg16505674

Full playlist of workflow demo recordings: https://www.youtube.com/playlist?list=PL9HYL-VRX0oRsUB5AgNMQuKuHPpNDLBVt

Have suggestions? Comment below.

Thank you for joining us!

Communicating insights for impact | Noah Branham | Data Science Hangout

To join future data science hangouts, add it to your calendar here: https://pos.it/dsh - All are welcome! We’d love to see you!

We were recently joined by Noah Branham, senior manager of analytics at DraftKings, to chat about marketing measurement, data science career paths, and communicating analysis to stakeholders.

In this Hangout, one topic we explore is Noah’s three-trimester framework for career development, focusing on how he progressed from developing basic data analytics skills to mastering predictive modeling and optimization problems, and finally transitioning to a management role. He emphasizes the importance of understanding business problems before applying data techniques and how the skills needed for success as an analyst differ from those needed for a manager.

Resources mentioned in the video and zoom chat: Speak at Posit Conf 2025 → https://posit.co/blog/speak-at-posit-conf-2025/ Cascadia R Conf → https://cascadiarconf.com/ Unified Branding with brand.yml → https://posit.co/blog/unified-branding-across-posit-tools-with-brand-yml/ The Motivated Speaker Book → https://www.articulationinc.com/the-motivated-speaker-book/ Model cards for transparent reporting → https://vetiver.posit.co/learn-more/model-card.html Upcoming End-to-End Workflow Demo → https://pos.it/team-demo

If you didn’t join live, one great discussion you missed from the zoom chat was all about running, including marathon advice, favorite races, and being a proud member of the Slow AF Run Club It didn’t have much to do with data, but it was definitely about being a community. You should really join us live to get in on the fun!