design-conventions
Golden Anniversary design system with OKLCH color palette, typography (Inter, Playfair Display, Dancing Script), component states, Framer Motion patterns, and accessibility requirements. Use when working on styling, UI components, or visual changes.
When & Why to Use This Skill
This Claude skill functions as a comprehensive design system and technical style guide for the 'Golden Anniversary' project. It streamlines the front-end development process by providing standardized OKLCH color palettes, typography configurations (Inter, Playfair Display, Dancing Script), and accessible component states. By centralizing design tokens and Framer Motion animation patterns, it ensures visual consistency, WCAG-compliant accessibility, and high-performance UI interactions across all web interfaces.
Use Cases
- Case 1: Implementing consistent UI components using the Golden Anniversary brand identity and OKLCH color tokens.
- Case 2: Ensuring web accessibility compliance by utilizing validated color contrast combinations and minimum touch target requirements.
- Case 3: Developing responsive layouts with mobile-first breakpoints and standardized typography for section titles and body text.
- Case 4: Applying advanced Framer Motion patterns for scroll animations, hover effects, and loading states to enhance user engagement.
- Case 5: Rapidly building complex UI elements like TimeCards and PhotoCarousels using integrated Shadcn/ui component specifications.
| name | design-conventions |
|---|---|
| description | Golden Anniversary design system with OKLCH color palette, typography (Inter, Playfair Display, Dancing Script), component states, Framer Motion patterns, and accessibility requirements. Use when working on styling, UI components, or visual changes. |
Design Conventions
Golden Colors (OKLCH)
:root {
--gold-50: oklch(98% 0.02 85);
--gold-100: oklch(95% 0.04 85);
--gold-200: oklch(88% 0.08 85);
--gold-300: oklch(82% 0.12 85);
--gold-400: oklch(75% 0.15 85);
--gold-500: oklch(68% 0.18 85);
--gold-600: oklch(60% 0.15 85);
--gold-700: oklch(52% 0.12 85);
--gold-800: oklch(44% 0.09 85);
--gold-900: oklch(36% 0.06 85);
--gold-950: oklch(28% 0.04 85);
}
Validated contrast combinations (>= 4.5:1):
- gold-600 + white (4.8:1)
- gold-700 + white (6.2:1)
- gold-800 + gold-50 (4.6:1)
- Avoid: gold-400 + white (3.8:1)
Typography
// Inter - Body text, UI elements
const inter = Inter({ subsets: ["latin"], variable: "--font-sans" });
// Playfair Display - Section titles
const playfair = Playfair_Display({ subsets: ["latin"], variable: "--font-serif" });
// Dancing Script - Couple names, special text
const dancingScript = Dancing_Script({ subsets: ["latin"], variable: "--font-script" });
Usage:
<h1 className="font-script text-gold-500">Iria e Ari</h1>
<h2 className="font-heading text-gold-700">Golden Anniversary</h2>
<p className="font-body text-muted-foreground">Body text</p>
Breakpoints (mobile-first)
- Mobile: 375px+ (base)
- Tablet: 768px+ (md:)
- Desktop: 1024px+ (lg:)
Component States
Buttons:
bg-primary → bg-primary/90 + scale-105 → bg-primary/80 → bg-muted
// Default → Hover → Active → Disabled
Cards:
border-border → border-gold-200 + shadow-lg → ring-2 ring-ring
// Default → Hover → Focus
Images:
skeleton gold-100 → normal → scale-105 + brightness-110 → bg-muted + icon
// Loading → Default → Hover → Error
Framer Motion Patterns
- Scroll animations:
useInViewfor gradual appearance - Hover effects:
whileHover={{ y: -4, scale: 1.02 }} - Loading states: Pulse animation on skeletons
- Success feedback: Checkmark animation
Accessibility Requirements
- Touch targets: min 44px (
min-h-11) - Focus visible:
ring-2 ring-ring - Contrast: >= 4.5:1
- Keyboard navigation: logical tab order
- Text scaling: functional up to 200% zoom
Shadcn/ui Components Used
Base: Button, Card, Input, Textarea, Badge, Dialog, Tabs, Tooltip, Select, Checkbox, Avatar
Custom: TimeCard, PhotoCarousel, MessageCard, TimelineItem