--- version: alpha name: MyBrand description: One-sentence description of the visual identity. colors: primary: "#0F172A" secondary: "#64748B" tertiary: "#2563EB" neutral: "#F8FAFC" on-primary: "#FFFFFF" on-tertiary: "#FFFFFF" typography: h1: fontFamily: Inter fontSize: 3rem fontWeight: 700 lineHeight: 1.1 letterSpacing: "-0.02em" h2: fontFamily: Inter fontSize: 2rem fontWeight: 600 lineHeight: 1.2 body-md: fontFamily: Inter fontSize: 1rem lineHeight: 1.5 label-caps: fontFamily: Inter fontSize: 0.75rem fontWeight: 600 letterSpacing: "0.08em" rounded: sm: 4px md: 8px lg: 16px full: 9999px spacing: xs: 4px sm: 8px md: 16px lg: 24px xl: 48px components: button-primary: backgroundColor: "{colors.tertiary}" textColor: "{colors.on-tertiary}" rounded: "{rounded.sm}" padding: 12px button-primary-hover: backgroundColor: "{colors.primary}" textColor: "{colors.on-primary}" card: backgroundColor: "{colors.neutral}" textColor: "{colors.primary}" rounded: "{rounded.md}" padding: 24px --- ## Overview Describe the voice and feel of the brand in one or two paragraphs. What mood does it evoke? What emotional response should a user have on first impression? ## Colors - **Primary ({colors.primary}):** Core text, headlines, high-emphasis surfaces. - **Secondary ({colors.secondary}):** Supporting text, borders, metadata. - **Tertiary ({colors.tertiary}):** Interaction driver — buttons, links, selected states. Use sparingly to preserve its signal. - **Neutral ({colors.neutral}):** Page background and surface fills. ## Typography Inter for everything. Weight and size carry hierarchy, not font family. Tight letter-spacing on display sizes; default tracking on body. ## Layout Spacing scale is a 4px baseline. Use `md` (16px) for intra-component gaps, `lg` (24px) for inter-component gaps, `xl` (48px) for section breaks. ## Shapes Rounded corners are modest — `sm` on interactive elements, `md` on cards. `full` is reserved for avatars and pill badges. ## Components - `button-primary` is the only high-emphasis action per screen. - `card` is the default surface for grouped content. No shadow by default. ## Do's and Don'ts - **Do** use token references (`{colors.primary}`) instead of literal hex in component definitions. - **Don't** introduce colors outside the palette — extend the palette first. - **Don't** nest component variants. `button-primary-hover` is a sibling, not a child.