Documentation and Type Specimens
What you'll learn: How to create clear, visual style guides that showcase every typography choice in your design system with real-world examples.
What Are Type Specimens?
A type specimen is like a menu at a restaurant — it shows all your available typography styles in one place so designers and developers can see exactly what they're working with. Instead of hunting through code or guessing which heading size to use, everyone can reference a single source of truth that displays your complete typography system.
Think of it as a visual catalog: every heading level, body text size, font weight, line height, and spacing variation gets its own labeled example showing what it looks like and when to use it.
Why Documentation Matters
Your carefully crafted type scale, font weight scale, and typographic utility classes mean nothing if your team doesn't know they exist or how to use them. Documentation transforms your CSS variables and classes into a usable, consistent system.
What to Include
Your type specimen should show:
- All heading levels (h1–h6) with actual content, not just "Heading 1"
- Body copy variations at different sizes with sample paragraphs
- Font weight examples using the same text at different weights
- Line height and spacing demonstrated with multiple lines
- Responsive behavior if you're using fluid typography with
clamp() - Use case guidance — when to use each style
- Code snippets — the class names or CSS needed to apply each style
Your specimens should use realistic text (not Lorem Ipsum) so stakeholders can evaluate readability in context.
Key Takeaway: Type specimens turn your typography system from abstract code into a visual, accessible reference guide that ensures consistency across your entire project and team.