applying-web-design-standards
Applies web design standards covering typography systems, color theory, grid layouts, design tokens, component library architecture, responsive CSS, and performance optimization. Activates on: type sc
SKILL.mdplugins/loxihart-design/skills/applying-web-design-standards/SKILL.md
GitHubApplying Web Design Standards
Consolidated reference for typography, color, grid, design tokens, component
architecture, responsive CSS, and performance. Merged from three prior skills:
advanced-visual-design, design-system-builder, professional-web-design.
Domain Routing
| Request type | Reference file |
|---|---|
| Typography scale, font pairing, loading | references/typography-system.md |
| Web-specific type concerns | references/web-typography.md |
| Color systems, HSL, contrast, palettes | references/color-and-grid.md |
| Layout, composition, spatial principles | references/layout-composition.md |
| Design token architecture, Style Dictionary | references/design-tokens.md |
| Responsive tokens, dark mode tokens | references/responsive-tokens.md |
| Component patterns, compound components | references/component-library.md |
| Design system governance, versioning | references/design-system-governance.md |
| Tech stack selection (Storybook, CVA, etc.) | references/tech-stack-comparison.md |
| Core Web Vitals, image opt, critical CSS | references/performance-standards.md |
| CSS Grid, Flexbox, container queries | references/css-techniques.md |
| WCAG 2.2, ARIA, keyboard nav | references/accessibility.md |
Workflow Routing
| Task | Workflow file |
|---|---|
| Starting a new design system from scratch | workflows/new-design-system.md |
| Adding a new component to an existing system | workflows/add-component.md |
| Documenting a design system | workflows/document-system.md |
| Pre-launch quality audit | workflows/pre-launch-audit.md |
| Building a responsive layout | workflows/responsive-build.md |
Scripts
| Script | Purpose |
|---|---|
scripts/contrast-checker.py |
WCAG contrast ratio validation |
scripts/palette-generator.py |
HSL palette generation with lightness steps |
scripts/type-scale.py |
Modular type scale calculator |
scripts/build-tokens.js |
Style Dictionary token compilation |
scripts/generate-component.js |
Component scaffolding with CVA variants |
scripts/a11y-audit.js |
Automated accessibility checks |
scripts/lighthouse-audit.js |
Core Web Vitals measurement |
Visual regression (pre-launch / multi-screen builds):
npm install -D @vizzly-testing/cli
npx vizzly tdd "npx playwright test" # local TDD — no account needed
npx vizzly run "npx playwright test" # CI run with cloud baseline sync
Free tier: 1 private project, local TDD unlimited. See vizzly.dev/pricing.
Core Principles (Quick Reference)
Typography: Scales use ratios (Major Third 1.250, Perfect Fourth 1.333).
See references/typography-system.md for full scale table, pairing rules, and loading patterns.
Color: HSL with consistent lightness steps for palette construction. OKLCH preferred for gradients and perceptual consistency — OKLCH lightness is uniform across hues, preventing muddy gradient midpoints that HSL produces. Minimum contrast 4.5:1 normal text, 3:1 large text.
See references/color-and-grid.md.
OKLCH quick reference:
- Format:
oklch(L% C H)— L=lightness 0–100, C=chroma 0–0.4, H=hue 0–360 - Browser support: Chrome 111+, Firefox 113+, Safari 15.4+ — include hex fallback for older targets
- When to use: gradient generation, new token creation, perceptual contrast checks
- When to keep hex: locked brand profiles (FlashFusion v3, Loxihart) — profiles are the execution SOT
Grid: 8-point spatial system. 12-column layout. Every spacing value is a multiple of 8.
Exceptions require written justification. See references/layout-composition.md.
Design Tokens: Primitive → Semantic → Component three-tier architecture.
Never use primitive tokens directly in components — always via semantic alias.
See references/design-tokens.md.
Responsive: Mobile-first at 320px, scale up via min-width. Standard breakpoints:
768px (tablet), 1024px (desktop), 1440px (large). See workflows/responsive-build.md.
Performance: LCP <2.5s, INP <200ms, CLS <0.1. Inline critical CSS, defer rest,
lazy-load images, set explicit dimensions. See references/performance-standards.md.
Anti-Patterns
See patterns/anti-patterns.md for full catalog. Critical failures:
- Hardcoded hex values instead of token references
- Desktop-first responsive (always mobile-first)
- ARIA added as an afterthought instead of semantic HTML first
- Pixels for spacing instead of the 8-point grid
- Everything bold (destroys hierarchy — size and weight are contrast tools)