This document defines the official branding, logo assets, color palette, typography guidelines, and design tokens for the SupportUsButton project by AOSSIE.
SupportUsButton is an open-source, customizable, tier-based React component package designed to display donation and sponsorship options cleanly on web applications while seamlessly adapting to any host site's visual theme.
All official brand assets are located inside the brand/ directory.
- Primary Logo (SVG):
logo.svg - Favicon / Logomark (SVG):
favicon.svg
- Always maintain aspect ratios when displaying the SVG logo.
- On dark backgrounds, use the primary logo or inverted contrast version (
brightness-0 invert). - On light host backgrounds, use dark contrast text and borders (
brightness-0).
The SupportUsButton brand palette balances modern dark UI elements with high-contrast accent highlights.
| Token | Hex Value | RGB / HSL | Usage |
|---|---|---|---|
| Accent Primary | #ffd700 |
rgb(255, 215, 0) |
Hover highlights, primary CTA accents, gold tier badges |
| Dark Background | #191919 |
rgb(25, 25, 25) |
Predefined dark theme container background |
| Dark Surface | #111111 |
rgb(17, 17, 17) |
Surface containers and card backgrounds |
| Light Background | #F4F4F4 |
rgb(244, 244, 244) |
Predefined light theme container background |
| Text Dark | #191919 |
rgb(25, 25, 25) |
Text on light backgrounds |
| Text Light | #F4F4F4 |
rgb(244, 244, 244) |
Text on dark backgrounds |
SupportUsButton is designed with automatic font-family inheritance so that it matches the host website typography natively out-of-the-box.
- Primary (Inherited):
font-family: inherit(Default forTheme="auto") - Fallback Stack:
system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif - Heading Sizes:
- Hero Title:
text-3xl sm:text-3xl md:text-5xl(font-medium) - Section Headers:
text-xl sm:text-2xl lg:text-3xl(font-medium) - CTA Button Text:
text-[18px](font-semibold)
- Hero Title:
Host applications can override custom CSS variables if explicit theme control is needed:
:root {
--color-primary: #ffd700;
--color-background-light: #f4f4f4;
--color-background-dark: #191919;
}