Design Principles
Our core philosophy guides every pixel, interaction, and decision. These principles ensure clarity, consistency, and user-centricity.
Clarity Over Cleverness
Interfaces should communicate their purpose immediately. Avoid decorative elements that obscure functionality or confuse users.
Consistent & Predictable
Reinforce familiarity through reusable patterns. Users should never guess how an interaction behaves if they've seen it before.
Delightful Performance
Subtle animations and micro-interactions provide feedback and guide attention without sacrificing speed or accessibility.
Inclusive by Default
Every design must meet WCAG 2.1 AA standards. Accessibility isn't an afterthought—it's a foundational requirement.
Color System
Our palette is engineered for contrast, brand recognition, and functional hierarchy. Use semantic naming in code.
Typography
We use a dual-font system for optimal readability and modern aesthetics. Headings use Space Grotesk; body and UI use Inter.
Display Heading
Section Title
Card / Feature Title
Subtitle / Label
Body text is set in Inter Regular. Line height is 1.6 for optimal readability across paragraphs and documentation.
Captions, metadata, and helper text use a smaller size with reduced contrast.
Spacing & Grid
We follow an 8pt baseline grid system. All spacing, sizing, and margins should be multiples of 8 to maintain visual rhythm.
| Token | Value (px) | Visual | Usage |
|---|---|---|---|
| --space-xs | 4 | Icon padding, micro gaps | |
| --space-sm | 8 | Form elements, small margins | |
| --space-md | 16 | Card padding, list spacing | |
| --space-lg | 24 | Section gaps, button heights | |
| --space-xl | 32 | Page margins, large blocks | |
| --space-2xl | 48 | Hero sections, major dividers |
UI Components
Standardized components ensure rapid development and consistent user expectations. Always use the design system variants.
Buttons
- Primary: Main conversion goals, limited to 1 per screen
- Secondary: Tertiary actions, back navigation
- Accent: Highlights, promotions, non-critical CTAs
- Min touch target: 44×44px
Inputs & Forms
- Labels always positioned above fields
- Placeholder text is supplementary, never replaces labels
- Error states use red border + inline message
- Focus rings must be visible (2px solid primary)
Cards & Containers
- Radius: 12px standard, 16px for hero cards
- Padding: 24px desktop, 16px mobile
- Shadows replaced with subtle borders for performance
- Hover states: border-color shift + 2px translateY
Accessibility Standards
Every PixelCraft product must comply with WCAG 2.1 AA. These are non-negotiable baseline requirements.
🔍 Contrast Ratios
Minimum 4.5:1 for normal text, 3:1 for large text and UI components. Test with colorblind simulators.
⌨️ Keyboard Navigation
All interactive elements must be reachable via Tab. Logical tab order, visible focus states, and skip links are mandatory.
📝 Semantic HTML & ARIA
Use native elements (
🖥️ Responsive & Zoom
Support 200% zoom without horizontal scrolling. Layout must remain functional on all viewports (320px+).