Component Spec vs Typography Scale

Component Spec

By JR Brugger (Design Workflow)

Write complete design system specs covering variants, states, accessibility, and usage.

Typography Scale

By JR Brugger (Design Workflow)

Build a professional text sizing system for websites and apps with consistent headings and body copy.

Component Spec

• Generates structured component specifications with anatomy breakdowns, variants, and props
• Documents all component states (hover, focus, disabled, loading, error) with clear descriptions
• Includes accessibility requirements like ARIA roles, keyboard navigation, and screen reader support
• Provides usage guidelines with do/don't examples and content rules
• Covers behavior details like interactions, animations, and responsive breakpoints

Typography Scale

• Generates a mathematical scale of text sizes from captions to large headings
• Defines line heights and letter spacing for optimal readability
• Provides font weight and pairing recommendations
• Creates responsive rules so text scales gracefully on mobile devices
• Documents usage guidelines for each text style

Reach for Component Spec when…

• You're building a design system and need to document components thoroughly
• Your team needs shared specs so designers and developers stay aligned
• You're onboarding someone and want clear component documentation to reference
• You need to ensure accessibility is baked into every component from the start

Reach for Typography Scale when…

• You're designing a website, app, or marketing site and need consistent text sizing
• You want your headings and body copy to look harmonious without manual tweaking
• You're building a design system or brand guide
• You need typography rules that work across desktop and mobile