Colaberry — Brand Guide
The short, practical guide to using the Colaberry brand. For the full interactive reference,
open design-system.html.
The brand in one line
Colaberry helps people future-proof their careers in data & AI — warm, inclusive, and proven since 2012.
Design principles
Five beliefs that break ties when a decision is ambiguous:
- Inclusive by default — accessibility, plain language, and generous touch targets are requirements, not extras.
- Warm, not loud — soft shapes, gentle motion, friendly copy; confidence without hype.
- Clarity over decoration — we teach data, so content and numbers lead; ornament earns its place.
- One system, many makers — semantic tokens + reusable components let a marketer, a developer, and an AI agent produce the same brand.
- Consistent & constant — the cherry accent never changes; foreground inverts with the background.
Generating with Claude — how to prompt
This whole project is a design system Claude can read. When you start a chat with this project
attached (or invoke the colaberry-design skill), Claude already knows the colors, fonts, logo, voice,
components, and rules below — you don't have to re-explain them. You just describe what you want.
There are two kinds of people who use this, and the way you prompt is a little different for each.
👋 If you're on the Marketing team (non-technical)
You can ask in plain English. Claude will hand you a finished HTML file you can preview and download — a social post, an event flyer, an email header, a one-pager, a slide, an ad. You never touch code.
The recipe — answer these four things in your message:
- What you want (e.g. "an Instagram post", "a webinar flyer", "an email banner").
- Size if it matters (e.g. "square 1080×1080", "story 1080×1920", "letter portrait", "16:9 slide").
- The words — the headline, any subtext, the call-to-action.
- The vibe / which program (e.g. "for the Data Analytics cohort", "celebratory", "urgent — enrollment closes Friday").
Generic starter template (fill in the brackets):
*"Using the Colaberry design system, create a [social post / flyer / email header / slide] at [size] for [topic]. Headline: [your headline]. Add a [call-to-action] button and the logo. Keep it warm and on-brand, no emoji — and give me 3 options."*
More worked examples
"Using the Colaberry design system, make a square Instagram post (1080×1080) announcing our Spring Data Analytics cohort. Headline: 'Your data career starts here.' Add a small 'Apply now' button and our cherry logo. Keep it warm and on-brand."
"Make an event flyer (letter, portrait) for a free Intro to Data Analytics webinar, Thursday 7:30pm CST. Include the date/time, 'Register free', and the Colaberry logo. Give me 3 layout options to choose from."
"Design an email header banner (1200×400) for our scholarship announcement. Big text: 'Veterans: full-tuition scholarships open.' Use the cherry-red accent. No emoji."
Tips that make the result great
- Ask for options: "give me 3 versions" — then tell Claude which one to refine.
- Name the brand color you want to lead with: cherry red (energy), leaf green (growth), berry blue (trust).
- Keep the voice: warm, encouraging, speak to "you", no emoji, lead with proof from the claim registry (1,000+ hires, teaching this since 2012).
- Want to tweak it? Just say so in plain words: "make the headline bigger", "use the green instead", "swap in this photo" (drag a photo in).
- To download what Claude made, use the download / export option on the file it gives you.
💡 You don't need to know hex codes, fonts, or "tokens." Claude pulls all of that from this system automatically. Your job is the message and the format.
🛠️ If you're a Developer
Claude can scaffold production-ready, on-brand UI because the tokens and components are machine-readable.
Hand Claude the contract in your prompt:
- "Link
styles.css" — it imports all tokens (color, type, spacing) + fonts. - "Use the design-system components" —
Button, Badge, Card, Input, Checkbox, Avatar, loaded from_ds_bundle.jsand read offwindow.ColaberryDesignSystem_098454. - "Reference semantic tokens, never raw hex" —
--surface-page,--text-strong,--brand-accent, etc. - "Honor the accessibility rules in BRAND.md" (red-600+/green-700+ for body text, visible focus rings).
Generic starter template (fill in the brackets):
*"Using the Colaberry design system, build [a page / a section / a component] — [describe what it does]. Use the
Button,Card,Badge,Inputcomponents and semantic tokens, linkstyles.css, and support dark mode (data-theme="dark")."*
More worked examples
"Using the Colaberry design system, build a pricing section for the Data Science program. Three plan cards using the
CardandButtoncomponents, cherry-red primary CTA, linkstyles.css, use semantic tokens, supportdata-theme="dark"."
"Recreate the enrollment form as a React component using
Input,Checkbox, andButtonfromwindow.ColaberryDesignSystem_098454. Follow the form patterns inui_kits/marketing-website/."
"Give me a starter HTML page wired to this design system (fonts, tokens, dark-mode toggle) that I can drop a new feature into."
What to reuse
- Foundations:
styles.css→tokens/*.css. Components:components/core/*(props in each.d.ts, usage in each.prompt.md). Full screens to copy from:ui_kits/marketing-website/. - Open
design-system.htmlfor the live token reference, WCAG audit, and the dev hand-off checklist.
📦 Hand-off cheat-sheet — what to give each person
| Hand this to… | What they need | Where they start |
|---|---|---|
| Marketing / non-technical | This project link (or the colaberry-design skill) + the prompt recipe above |
Just describe the artifact — Claude returns a downloadable HTML file |
| A designer | design-system.html (the living guide) + assets/logo/ |
Skim the guide; reuse logos, colors, type |
| A developer | This whole project: styles.css, components/core/, ui_kits/, BRAND.md |
Link styles.css, import the components, follow the rules here |
| Anyone, anywhere | BRAND.md (this file) — it's self-contained |
Read the one-liner, voice, color, and logo rules |
The golden rule for any prompt: start with "Using the Colaberry design system, …" and describe the outcome. The system supplies the rest.
Logo
The mark is two cherries on a shared stem forming the "C" of Colaberry — growth, pairs, collaboration. The wordmark sets "olaberry" in Quicksand with a green→blue gradient.
Files (assets/logo/): colaberry-mark.png, colaberry-horizontal.png, colaberry-app-icon.png,
each with -white / -black mono variants, plus a full export/ set (favicons, app icons, OG cards).
Inversion rule: foreground inverts with the background; the cherry red stays constant.
- Light background → full-color or black mark.
- Dark / photo / cherry background → white mark.
- Never recolor the cherries, add gradients/shadows to the mark, or re-set the wordmark in another font.
Clear space: keep space equal to the cherry-mark height on all sides. Minimum size: 120px wide (horizontal lockup), 24px (mark alone).
Color
| Role | Token | Hex | Notes |
|---|---|---|---|
| Primary / accent | --red-500 |
#FB2832 |
Cherry. The constant. Accent + large text; use --red-600/700 for body text. |
| Secondary | --green-500 |
#77BB4A |
Leaf. Growth. Fill/accent; use --green-700+ for text, white text only on --green-600+. |
| Tertiary | --blue-500 |
#367895 |
Berry. Trust, links, wordmark. AA for white text. |
| Neutrals | --neutral-0…1000 |
#FFF…#000 |
Brand grays #D8D8D8, #4A4A4A, black. |
Always use semantic tokens (--surface-page, --text-strong, --brand-accent, --border-default)
rather than raw ramp values. Dark mode: set data-theme="dark" on <html>.
Data visualization
For charts, use the dedicated palette — never raw brand ramps for series:
- Categorical:
--chart-1…8in order (tuned for adjacent separation + color-blind safety). - Sequential:
--seq-1…6(single-hue berry blue, low→high). - Diverging:
--div-neg-2 … --div-mid … --div-pos-2(cherry ↔ leaf). Both adapt in dark mode (brighter series). See the Color section ofdesign-system.html.
Typography
- Roboto — display (Bold) + body (Regular). H1 48 / H2 36 / H3 28 / H4 22 / body 18 / caption 14.
- Roboto Mono — code, metrics, tabular data.
- Quicksand — logotype only, never for UI.
Iconography
The brand's standard icon set is RemixIcon (Apache-2.0, ~3,000 icons) — loaded automatically via
styles.css (no script needed). Prefer the -line style to match the soft 2px brand look; use
-fill for emphasis. Never use emoji.
Always wrap an icon in the .cb-i primitive — it guarantees a centered 1em box with no baseline
gap (color via currentColor, size via font-size):
<span class="cb-i"><i class="ri-rocket-line"></i></span>For a colored container, use .cb-icon-tile (resize with --tile) — never hand-roll
place-items/sizing, which is how alignment mistakes creep in:
<span class="cb-icon-tile" style="background:var(--red-500)"><span class="cb-i"><i class="ri-award-line"></i></span></span>Both utilities live in the base layer, so correct icon alignment is automatic everywhere. SVG sets
(e.g. Lucide) also work inside .cb-i if a project needs them. Browse icons at remixicon.com.
Shape, space & motion
- 4px spacing grid. Rounded radii: 4 / 8 / 12 / 16 / 24 / 32 / pill.
- Pill buttons & badges. Cards:
--radius-xl, soft shadow, optional colored top accent. - Motion:
--ease-out~220ms; gentle, never showy.
Motion
Motion is functional, not decorative — it confirms an action, guides the eye, or softens a change. Principles: purposeful · quick (140–360ms) · gentle (ease-out) · accessible.
Easing tokens — --ease-out (default: enter, hover, expand) · --ease-emphasized (hero reveals,
big moments) · --ease-spring (confirmations only: a check, a toggle) · --ease-in (exits — accelerate
away) · --ease-in-out (things that move and return) · --ease-standard (Material-style neutral).
Never linear or hard bounces.
Duration tokens — --dur-instant 90ms (tick, ripple) · --dur-fast 140ms (hovers, toggles) ·
--dur-base 220ms (most transitions) · --dur-slow 360ms (entrances, overlays) · --dur-slower 560ms
(hero choreography). Duration scales with travel distance.
Choreography tokens — --motion-rise 14px / --motion-rise-lg 28px (fade-up travel) ·
--stagger 70ms / --stagger-tight 45ms (delay between sequenced items).
Motion recipes (reusable patterns — see the live Motion section):
- Enter — fade & rise: opacity 0→1 + translateY
--motion-rise→0,--dur-slow, ease-out. - Sequence — stagger children
--staggerapart (lists, grids, hero lines). - Overlay — scrim fades + panel scales 0.96→1,
--dur-slow, emphasized. - Confirm — spring pop: scale 0.6→1 with
--ease-spring(checkmarks, toggles only). - Loading — shimmer sweep (~1.4s loop) — the one allowed continuous motion.
- Exit — fade & fall: opacity 1→0 + slight translateY,
--dur-fast, ease-in.
Standard interactions
| Interaction | What changes | Token |
|---|---|---|
| Hover — solid button | Fill steps one shade darker (red-500 → 600) | 140ms · ease-out |
| Hover — ghost / outline | Soft sunken background fills in | 140ms · ease-out |
| Hover — card (clickable) | Lifts 6px, shadow deepens (sm → lg) | 220ms · ease-out |
| Hover — link | Underline wipes in from the left | 220ms · ease-out |
| Press — button | Fill darkens again + translateY(1px) |
140ms · ease-out |
| Focus — any control | 3px berry-blue focus ring appears | instant |
| Enter — content / overlay | Fade up 12–14px, stagger ~70ms | 360ms · ease-out |
Always wrap non-essential motion so it collapses under @media (prefers-reduced-motion: reduce).
No infinite/looping animation on real content. See the live Motion section of design-system.html.
Voice
Warm + credible. Sentence case. Speak to "you." Lead with proof from the claim registry (1,000+ hires, teaching this since 2012). Friendly action CTAs ("Apply now", "Enroll today"). No emoji in product/web. Reinforce inclusivity (no degree/tests required, scholarships, veterans support).
Proof points: use these, and only these
Every outcome figure that leaves the building has to trace to a row in
frontend/src/config/claimsRegistry.ts. These are the approved ones, with the registry key
to cite if anyone asks where a number came from:
| Registry key | Use exactly this wording | Status |
|---|---|---|
trackrecord.students |
8k+ data students | VERIFIED (8,588, rounded down) |
trackrecord.certified |
2,500+ certified | VERIFIED (2,844, rounded down) |
trackrecord.hired |
1,000+ hires | OWNER_ATTESTED (691 recorded + Ali's attestation) |
trackrecord.since2012 |
Teaching this since 2012 | VERIFIED |
Blocked, and why — do not reintroduce these:
<!-- claim-check:allow-blocked-list — the list below NAMES the blocked claims in order to forbid them, so scripts/checkKnowledgeHubClaims.js skips this region. Keep it small, and close it. -->trackrecord.careers— "5,000+ careers launched", in any phrasing: careers built, careers changed, graduates placed, more than 5,000 people into new careers. Superseded, not fixed. "Careers launched" most naturally means hires, which is 691 — so the figure overstated the outcome by roughly an order of magnitude. If you want an outcome number, usetrackrecord.hired. If you want a scale number, usetrackrecord.students; do not swap one for the other to keep the number large.trackrecord.wageimpact— "$100M+ in wage impact generated". No methodology was ever located, and its approved routes list is empty.
This guidance previously told makers to lead with the superseded figure, which
put the design system and the claim registry in direct contradiction: anyone following this
file faithfully reintroduced a blocked claim. scripts/checkKnowledgeHubClaims.js now fails
the build if one reappears anywhere under frontend/public/knowledge/.
Accessibility (WCAG 2.2)
- Body text on white:
--neutral-800(13.6:1) or--text-muted(5.3:1). - Links:
--blue-600(6.0:1). Green text:--green-700+. - Cherry red and leaf green are accent / large-text colors — don't use raw red-500/green-500 for small body text.
- White button text passes on cherry (3.9:1) and green-600 (3.0:1) at large/bold sizes (our buttons are 20px bold).
- Focus: visible 3px berry-blue ring on every interactive element.
Don'ts
- No emoji in the system. · No bluish-purple gradients. · No recoloring the mark. · No Inter/Arial substitutes for Roboto in final work. · No small body text in raw cherry/leaf.
Fonts & licensing
Roboto, Roboto Mono — Apache-2.0. Quicksand — SIL OFL-1.1. Currently loaded via Google Fonts CDN;
self-host for production (see assets/fonts/LICENSES.md).