CYD Hub Brand Guidelines
This page documents how Code Your Dreams shows up in the CYD Hub product. Every swatch, type sample, and component below is rendered with the same design tokens the live app uses, so it stays accurate as the app evolves.
Logo & mark
The CYD wordmark and robot mascot. Maintain clear space equal to the height of the "C" around the logo, and never render the logo smaller than 24px tall.
On background
On card
On cyd-dark
Robot mascot
Used in empty states, onboarding, and playful moments. Pair with warm, encouraging copy. Avoid placing the mascot over busy photography.
Brand palette
The five CYD brand colors, exposed as --cyd-* tokens and Tailwind utilities like bg-cyd-rose.
--cyd-rose: —Donate, calls-to-action, accents
--cyd-blue: —Primary brand color, links, primary buttons
--cyd-light-blue: —Footer text, soft surfaces, dividers
--cyd-purple: —Secondary accent
--cyd-dark: —Footer, dark hero sections
Semantic tokens
Always reference these instead of raw colors. They shift between themes and keep contrast intact.
--background: —Page background
--foreground: —Default body text
--card: —Cards, panels, headers
--primary: —Primary buttons, key actions
--secondary: —Secondary surfaces and buttons
--muted: —Subtle surfaces, helper text
--accent: —Hover states, highlights
--destructive: —Errors, delete actions
--border: —Dividers, input borders
--ring: —Focus indicators
Sidebar tokens
--sidebar-background: —App sidebar surface
--sidebar-primary: —Active sidebar item
--sidebar-accent: —Hover state in sidebar
--sidebar-border: —Sidebar dividers
Theme variants
The same semantic tokens render differently across the three supported themes. Each preview below is scoped, so it shows the theme without changing yours.
.theme-lightbg-backgroundbg-cardbg-primarybg-secondarybg-mutedbg-accentbg-destructivebg-border.theme-mixedbg-backgroundbg-cardbg-primarybg-secondarybg-mutedbg-accentbg-destructivebg-border.theme-darkbg-backgroundbg-cardbg-primarybg-secondarybg-mutedbg-accentbg-destructivebg-borderTypography
Poppins is the only family used across the app, loaded in weights 400, 500, 600, and 700.
Display / H1 — 700
Empowering the next generation
H2 — 700
Programs, clubs, and hackathons
H3 — 600
A section heading
Body — 400
Body text is set in Poppins regular at 16px. Use text-foreground for default copy and text-muted-foreground for secondary copy.
Small / label — 500
Form label or helper text
Radius & elevation
The base radius token is --radius: 0.5rem. Tailwind rounded-sm/md/lg derive from it.
rounded-smrounded-mdrounded-lgrounded-fullshadow-xsshadow-smshadow-lgComponents in use
Live shadcn/ui components styled by the tokens above. Variants here are the ones approved for use across CYD Hub.
Accessibility
The brand must remain usable when accessibility preferences are on. Users can toggle these on the accessibility page and in their account settings.
High-contrast focus
Adds a 3px ring around the focused element using
--ring.Larger text
Scales the root font size to ~18 or ~20px; all Tailwind rem sizes follow.
Reduced motion
Animations and transitions collapse to near-instant.
Always-underline links
All inline links gain an underline regardless of hover state.
Do & Don't
- Use semantic tokens:
bg-primary,text-foreground. - Use brand utilities (
bg-cyd-rose) only for clearly branded moments. - Use Poppins for all UI text.
- Test contrast in all three themes.
- Hard-code hex values in components.
- Use raw Tailwind palette utilities like
bg-blue-500ortext-white. - Introduce additional font families.
- Override focus styles in a way that removes the visible ring.