Skip to main content
    Living style guide

    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.

    CYD logo on a light backgroundOn background
    CYD logo on a card surfaceOn card
    CYD logo on a dark backgroundOn cyd-dark
    CYD robot mascot

    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—
    --cyd-rose: —

    Donate, calls-to-action, accents

    CYD Blue—
    --cyd-blue: —

    Primary brand color, links, primary buttons

    CYD Light Blue—
    --cyd-light-blue: —

    Footer text, soft surfaces, dividers

    CYD Purple—
    --cyd-purple: —

    Secondary accent

    CYD Dark—
    --cyd-dark: —

    Footer, dark hero sections

    Semantic tokens

    Always reference these instead of raw colors. They shift between themes and keep contrast intact.

    Background—
    --background: —

    Page background

    Foreground—
    --foreground: —

    Default body text

    Card—
    --card: —

    Cards, panels, headers

    Primary—
    --primary: —

    Primary buttons, key actions

    Secondary—
    --secondary: —

    Secondary surfaces and buttons

    Muted—
    --muted: —

    Subtle surfaces, helper text

    Accent—
    --accent: —

    Hover states, highlights

    Destructive—
    --destructive: —

    Errors, delete actions

    Border—
    --border: —

    Dividers, input borders

    Ring—
    --ring: —

    Focus indicators

    Sidebar tokens

    Sidebar background—
    --sidebar-background: —

    App sidebar surface

    Sidebar primary—
    --sidebar-primary: —

    Active sidebar item

    Sidebar accent—
    --sidebar-accent: —

    Hover state in sidebar

    Sidebar border—
    --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.

    Light (warm).theme-light
    bg-background
    bg-card
    bg-primary
    bg-secondary
    bg-muted
    bg-accent
    bg-destructive
    bg-border
    Mixed (light + dark sidebar).theme-mixed
    bg-background
    bg-card
    bg-primary
    bg-secondary
    bg-muted
    bg-accent
    bg-destructive
    bg-border
    Dark.theme-dark
    bg-background
    bg-card
    bg-primary
    bg-secondary
    bg-muted
    bg-accent
    bg-destructive
    bg-border

    Typography

    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-sm
    rounded-md
    rounded-lg
    rounded-full
    shadow-xs
    shadow-sm
    shadow-lg

    Components 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

    Do
    • 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.
    Don't
    • Hard-code hex values in components.
    • Use raw Tailwind palette utilities like bg-blue-500 or text-white.
    • Introduce additional font families.
    • Override focus styles in a way that removes the visible ring.