/applying-bitwarden-branding

Applying Bitwarden Branding

This skill grounds brand-application decisions in Bitwarden's two canonical sources:

• bitwarden.com/brand — the brand guidelines hub, including logo lockups, the radius system, social-post framing, product images, and B-roll.
• github.com/bitwarden/brand — the source-of-truth repository for SVG logos, PNG product icons (multiple sizes), the shield mark, color palette in multiple formats (HEX, HSL, SCSS), screenshots, and media assets.

When applying brand in real work, treat the repo as canonical for assets and the brand site as canonical for usage rules. Detailed reference material lives in references/brand-assets.md (asset inventory and file paths) and references/color-palette.md (full palette with usage notes and SCSS variable names).

The five rules that catch the most mistakes

1. Capitalize the B in Bitwarden. Always. The W is never capitalized. The only place "bitwarden" appears lowercase is inside the official logo lockup — not in body copy, not in headlines, not in handles or URLs.
2. Primary palette before tertiary palette. Green, Yellow, and Red are tertiary — use them sparingly, primarily in product graphics and for success / warning / error communications. They are not headline colors.
3. Inter for everything. Product and website. The available weights are 300 (light), 400 (regular), 500 (medium), 600 (semi-bold), and 700 (bold).
4. Logo safe-area is non-negotiable. Horizontal lockup needs one Bitwarden-shield width of clear space on every side. Vertical lockup uses the height of the "X" in the logotype. Cramped logos break the lockup.
5. 36px radius system, but buttons are the exception. Rounded corners follow a 36px radius across primary brand surfaces. Buttons sit outside that system — don't apply 36px to buttons.

Logo usage

• Default mark. /logos/logo-horizontal-blue.svg from the brand repo. Horizontal is the primary/preferred lockup.
• Inverse (for dark backgrounds). /logos/logo-horizontal-white.svg.
• Vertical lockup. Available for use cases where horizontal doesn't fit; the safe area uses the height of the "X" in the logotype.
• Product icon (the shield). Available rounded and square, at 16/32/64/128/256 px PNG plus SVG (/logos/icon.svg, /logos/icon-inverse.svg, /icons/*.png). The shield itself lives at /shield/.
• Product logos. Unique lockups exist for individual Bitwarden products (Password Manager, Secrets Manager, etc.). Use these "primarily for use in-product."

Don't recolor, distort, rotate, or recompose the logo. If the supplied SVG doesn't fit the need, reach out to the brand owners rather than improvising a variant.

Color palette quick reference

Full palette with all variable names is in references/color-palette.md. Five colors carry most of the work:

Tertiary palette (Green #7BF1A8, Yellow #FDC700, Red #FF6550) is sparingly applied for product graphics and success/warning/error states. The brand site is explicit on this.

SCSS variable names (from the brand repo's brand-colors/palette.scss):

• $bitwarden-blue, $deep-blue, $off-white, $true-white, $true-black, $light-grey, $teal-highlight, $light-teal-highlight, $tertiary-green, $tertiary-yellow, $tertiary-red.

Typography

• Typeface: Inter (open-source, Google Fonts).
• Weights available: 300 (light), 400 (regular), 500 (medium), 600 (semi-bold), 700 (bold).
• Use: product UI and website body / headline copy. The brand site doesn't enumerate weight-per-context rules; defer to product or marketing leads when an unusual case comes up.

Iconography

• Web icons. Designed for a wide range of uses with more detail than the product icon.
• Product icon (shield). Available rounded and square at multiple sizes from the brand repo's /icons/ directory.

Asset paths and full sizing tables are in references/brand-assets.md.

Capitalization and trademark

• The "B" in Bitwarden is capitalized in all copy text.
• The "W" is never capitalized — neither BITWARDEN (in body copy) nor bitWarden.
• The only place "bitwarden" appears in lowercase is inside the official logo lockup itself.
• "Bitwarden" is a registered trademark of Bitwarden Inc. — surface this when content is external-facing and trademark attribution is appropriate.

Composing with other skills

• content-style-guide. Brand sits alongside content style. When reviewing user-visible surfaces, walk both: this skill catches color, logo, and capitalization issues; the content style guide catches voice, tone, sentence case, and accessibility.
• using-figma. Use get_variable_defs to check whether a design's colors are library-bound and aligned to the brand palette; use get_libraries to confirm the right design library is loaded before claiming a design is on-brand.
• preparing-design-handoff. Surface brand findings as part of the handoff gate — flag them as Figma annotations or as open questions in the Epic when something is off-brand at handoff time. Don't quietly fix.
• evolving-design-system-components. New patterns must respect the brand palette and the 36px radius system (with the button exception). The Component Library governance review catches obvious violations, but raise them explicitly when sponsoring a pattern.

Output format for brand checks

When asked "is this on-brand?", structure the response as:

1. What's checked — which brand surfaces this design touches (logo, color, typography, iconography, capitalization).
2. What's on-brand — what's working and should stay.
3. What's off-brand — each finding tied to the specific brand rule it violates (cite the section, e.g., "Tertiary palette overused — Green appears in three non-state surfaces, per the bitwarden.com/brand tertiary-usage rule").
4. Proposed corrections — concrete swaps the designer can apply, sourced from the canonical palette or asset.

Keep findings specific. "The headline uses #7BF1A8 (tertiary green) where Bitwarden Blue (#175DDC) is the brand-primary color" beats "the color is wrong."

Additional resources

• references/brand-assets.md — full inventory of brand repo assets with file paths (logos, icons, shield, screenshots, media assets).
• references/color-palette.md — full palette with HEX, HSL, SCSS variable names, and per-color usage notes.