Responsive Patterns
Modern responsive design patterns using Container Queries, fluid typography, and mobile-first strategies for React applications (2026 best practices).
Overview
- Building reusable components that adapt to their container
- Implementing fluid typography that scales smoothly
- Creating responsive layouts without media query overload
- Building design system components for multiple contexts
- Optimizing for variable container sizes (sidebars, modals, grids)
Core Concepts
Container Queries vs Media Queries
| Feature |
Media Queries |
Container Queries |
| Responds to |
Viewport size |
Container size |
| Component reuse |
Context-dependent |
Truly portable |
| Browser support |
Universal |
Baseline 2023+ |
| Use case |
Page layouts |
Component layouts |
Modern CSS Layout
Load Read("rules/css-subgrid.md") for CSS Subgrid patterns: nested grid alignment, card layouts with aligned titles/content/actions, two-dimensional subgrid.
Load Read("rules/css-intrinsic-responsive.md") for intrinsically responsive layouts: auto-fit/minmax grids, clamp() for fluid everything, container queries for component logic, zero media query patterns.
Load Read("rules/responsive-foldables.md") for foldable/multi-screen device support: env(safe-area-inset-*), viewport segment queries, dual-screen layouts, progressive enhancement.
Key patterns covered: CSS Subgrid alignment, intrinsic responsive grids (auto-fit + minmax), fluid clamp() scales, foldable device layouts, safe area insets, viewport segment queries.
CSS Patterns
Load Read("rules/css-patterns.md") for complete CSS examples: container queries, cqi/cqb units, fluid typography with clamp(), mobile-first breakpoints, CSS Grid patterns, and scroll-queries.
Key patterns covered: Container Query basics, Container Query Units (cqi/cqb), Fluid Typography with clamp(), Container-Based Fluid Typography, Mobile-First Breakpoints, CSS Grid Responsive Patterns, Container Scroll-Queries (Chrome 126+).
React Patterns
Load Read("rules/react-patterns.md") for complete React examples: ResponsiveCard component, Tailwind container queries, useContainerQuery hook, and responsive images.
Key patterns covered: Responsive Component with Container Queries, Tailwind CSS Container Queries, useContainerQuery Hook, Responsive Images Pattern.
Accessibility Considerations
/* IMPORTANT: Always include rem in fluid typography */
/* This ensures user font preferences are respected */
/* ❌ WRONG: Viewport-only ignores user preferences */
font-size: 5vw;
/* ✅ CORRECT: Include rem to respect user settings */
font-size: clamp(1rem, 0.5rem + 2vw, 2rem);
/* User zooming must still work */
@media (min-width: 768px) {
/* Use em/rem, not px, for breakpoints in ideal world */
/* (browsers still use px, but consider user zoom) */
}
Anti-Patterns (FORBIDDEN)
/* ❌ NEVER: Use only viewport units for text */
.title {
font-size: 5vw; /* Ignores user font preferences! */
}
/* ❌ NEVER: Use cqw/cqh (use cqi/cqb instead) */
.card {
padding: 5cqw; /* cqw = container width, not logical */
}
/* ✅ CORRECT: Use logical units */
.card {
padding: 5cqi; /* Container inline = logical direction */
}
/* ❌ NEVER: Container queries without container-type */
@container (min-width: 400px) {
/* Won't work without container-type on parent! */
}
/* ❌ NEVER: Desktop-first media queries */
.element {
display: grid;
grid-template-columns: repeat(4, 1fr);
}
@media (max-width: 768px) {
.element {
grid-template-columns: 1fr; /* Overriding = more CSS */
}
}
/* ❌ NEVER: Fixed pixel breakpoints for text */
@media (min-width: 768px) {
body { font-size: 18px; } /* Use rem! */
}
/* ❌ NEVER: Over-nesting container queries */
@container a {
@container b {
@container c {
/* Too complex, reconsider architecture */
}
}
}
Browser Support
| Feature |
Chrome |
Safari |
Firefox |
Edge |
| Container Size Queries |
105+ |
16+ |
110+ |
105+ |
| Container Style Queries |
111+ |
❌ |
❌ |
111+ |
| Container Scroll-State |
126+ |
❌ |
❌ |
126+ |
| cqi/cqb units |
105+ |
16+ |
110+ |
105+ |
| clamp() |
79+ |
13.1+ |
75+ |
79+ |
| Subgrid |
117+ |
16+ |
71+ |
117+ |
Rules
Each category has individual rule files in rules/ loaded on-demand:
| Category |
Rule |
Impact |
Key Pattern |
| Modern CSS Layout |
rules/css-subgrid.md |
HIGH |
CSS Subgrid for nested grid alignment, card layouts |
| Modern CSS Layout |
rules/css-intrinsic-responsive.md |
HIGH |
Intrinsic responsive layouts, auto-fit/minmax, clamp(), zero breakpoints |
| Modern CSS Layout |
rules/responsive-foldables.md |
MEDIUM |
Foldable devices, safe area insets, viewport segments |
| CSS |
rules/css-patterns.md |
HIGH |
Container queries, cqi/cqb, fluid typography, grid, scroll-queries |
| React |
rules/react-patterns.md |
HIGH |
Container query components, Tailwind, useContainerQuery, responsive images |
| PWA |
rules/pwa-service-worker.md |
HIGH |
Workbox caching strategies, VitePWA, update management |
| PWA |
rules/pwa-offline.md |
HIGH |
Offline hooks, background sync, install prompts |
| Animation |
rules/animation-motion.md |
HIGH |
Motion presets, AnimatePresence, View Transitions |
| Animation |
rules/animation-scroll.md |
MEDIUM |
CSS scroll-driven animations, parallax, progressive enhancement |
| Touch & Mobile |
rules/touch-interaction.md |
HIGH |
Touch targets (44px min), thumb zones, pinch-to-zoom, safe areas, gestures |
Total: 10 rules across 6 categories
Key Decisions
| Decision |
Option A |
Option B |
Recommendation |
| Query type |
Media queries |
Container queries |
Container for components, Media for layout |
| Container units |
cqw/cqh |
cqi/cqb |
cqi/cqb (logical, i18n-ready) |
| Fluid type base |
vw only |
rem + vw |
rem + vw (accessibility) |
| Mobile-first |
Yes |
Desktop-first |
Mobile-first (less CSS, progressive) |
| Grid pattern |
auto-fit |
auto-fill |
auto-fit for cards, auto-fill for icons |
Related Skills
design-system-starter - Building responsive design systems
ork:performance - CLS, responsive images, and image optimization
ork-extras:i18n-date-patterns - RTL/LTR responsive considerations
Capability Details
container-queries
Keywords: @container, container-type, inline-size, container-name
Solves: Component-level responsive design
fluid-typography
Keywords: clamp(), fluid, vw, rem, scale, typography
Solves: Smooth font scaling without breakpoints
responsive-images
Keywords: srcset, sizes, picture, art direction
Solves: Responsive images for different viewports
mobile-first-strategy
Keywords: min-width, mobile, progressive, breakpoints
Solves: Efficient responsive CSS architecture
grid-flexbox-patterns
Keywords: auto-fit, auto-fill, subgrid, minmax
Solves: Responsive grid and flexbox layouts
container-units
Keywords: cqi, cqb, container width, container height
Solves: Sizing relative to container dimensions
References
Load on demand with Read("references/<file>"):
| File |
Content |
container-queries.md |
Container query patterns |
fluid-typography.md |
Accessible fluid type scales |
1---2name: responsive-patterns3license: MIT4compatibility: "Claude Code 2.1.277+."5description: Responsive design with Container Queries, fluid typography, cqi/cqb units, subgrid, intrinsic layouts, foldable devices, and mobile-first patterns for React applications. Use when building responsive layouts or container queries.6user-invocable: false7metadata:8 source: https://skillmd.com/skills/yonatangross/responsive-patterns9 owner-agent: "frontend-ui-developer"10 category: document-asset-creation11 version: "1.1.0"12 author: "OrchestKit"13 complexity: "medium"14 tags: "responsive, container-queries, fluid-typography, mobile-first, css-grid, clamp, cqi, breakpoints, pwa, service-worker, workbox, offline-first, animation, motion, framer-motion, scroll-driven, view-transitions, subgrid, intrinsic-layout, foldable, dual-screen, safe-area"15allowed-tools: "Read Glob Grep WebFetch WebSearch"16---1718# Responsive Patterns1920Modern responsive design patterns using Container Queries, fluid typography, and mobile-first strategies for React applications (2026 best practices).2122## Overview2324- Building reusable components that adapt to their container25- Implementing fluid typography that scales smoothly26- Creating responsive layouts without media query overload27- Building design system components for multiple contexts28- Optimizing for variable container sizes (sidebars, modals, grids)2930## Core Concepts3132### Container Queries vs Media Queries3334| Feature | Media Queries | Container Queries |35|---------|---------------|-------------------|36| Responds to | Viewport size | Container size |37| Component reuse | Context-dependent | Truly portable |38| Browser support | Universal | Baseline 2023+ |39| Use case | Page layouts | Component layouts |4041## Modern CSS Layout4243> Load `Read("rules/css-subgrid.md")` for CSS Subgrid patterns: nested grid alignment, card layouts with aligned titles/content/actions, two-dimensional subgrid.4445> Load `Read("rules/css-intrinsic-responsive.md")` for intrinsically responsive layouts: auto-fit/minmax grids, clamp() for fluid everything, container queries for component logic, zero media query patterns.4647> Load `Read("rules/responsive-foldables.md")` for foldable/multi-screen device support: env(safe-area-inset-*), viewport segment queries, dual-screen layouts, progressive enhancement.4849**Key patterns covered:** CSS Subgrid alignment, intrinsic responsive grids (auto-fit + minmax), fluid clamp() scales, foldable device layouts, safe area insets, viewport segment queries.5051## CSS Patterns5253> Load `Read("rules/css-patterns.md")` for complete CSS examples: container queries, cqi/cqb units, fluid typography with clamp(), mobile-first breakpoints, CSS Grid patterns, and scroll-queries.5455**Key patterns covered:** Container Query basics, Container Query Units (cqi/cqb), Fluid Typography with clamp(), Container-Based Fluid Typography, Mobile-First Breakpoints, CSS Grid Responsive Patterns, Container Scroll-Queries (Chrome 126+).5657## React Patterns5859> Load `Read("rules/react-patterns.md")` for complete React examples: ResponsiveCard component, Tailwind container queries, useContainerQuery hook, and responsive images.6061**Key patterns covered:** Responsive Component with Container Queries, Tailwind CSS Container Queries, useContainerQuery Hook, Responsive Images Pattern.6263## Accessibility Considerations6465```css66/* IMPORTANT: Always include rem in fluid typography */67/* This ensures user font preferences are respected */6869/* ❌ WRONG: Viewport-only ignores user preferences */70font-size: 5vw;7172/* ✅ CORRECT: Include rem to respect user settings */73font-size: clamp(1rem, 0.5rem + 2vw, 2rem);7475/* User zooming must still work */76@media (min-width: 768px) {77 /* Use em/rem, not px, for breakpoints in ideal world */78 /* (browsers still use px, but consider user zoom) */79}80```8182## Anti-Patterns (FORBIDDEN)8384```css85/* ❌ NEVER: Use only viewport units for text */86.title {87 font-size: 5vw; /* Ignores user font preferences! */88}8990/* ❌ NEVER: Use cqw/cqh (use cqi/cqb instead) */91.card {92 padding: 5cqw; /* cqw = container width, not logical */93}94/* ✅ CORRECT: Use logical units */95.card {96 padding: 5cqi; /* Container inline = logical direction */97}9899/* ❌ NEVER: Container queries without container-type */100@container (min-width: 400px) {101 /* Won't work without container-type on parent! */102}103104/* ❌ NEVER: Desktop-first media queries */105.element {106 display: grid;107 grid-template-columns: repeat(4, 1fr);108}109@media (max-width: 768px) {110 .element {111 grid-template-columns: 1fr; /* Overriding = more CSS */112 }113}114115/* ❌ NEVER: Fixed pixel breakpoints for text */116@media (min-width: 768px) {117 body { font-size: 18px; } /* Use rem! */118}119120/* ❌ NEVER: Over-nesting container queries */121@container a {122 @container b {123 @container c {124 /* Too complex, reconsider architecture */125 }126 }127}128```129130## Browser Support131132| Feature | Chrome | Safari | Firefox | Edge |133|---------|--------|--------|---------|------|134| Container Size Queries | 105+ | 16+ | 110+ | 105+ |135| Container Style Queries | 111+ | ❌ | ❌ | 111+ |136| Container Scroll-State | 126+ | ❌ | ❌ | 126+ |137| cqi/cqb units | 105+ | 16+ | 110+ | 105+ |138| clamp() | 79+ | 13.1+ | 75+ | 79+ |139| Subgrid | 117+ | 16+ | 71+ | 117+ |140141## Rules142143Each category has individual rule files in `rules/` loaded on-demand:144145| Category | Rule | Impact | Key Pattern |146|----------|------|--------|-------------|147| Modern CSS Layout | `rules/css-subgrid.md` | HIGH | CSS Subgrid for nested grid alignment, card layouts |148| Modern CSS Layout | `rules/css-intrinsic-responsive.md` | HIGH | Intrinsic responsive layouts, auto-fit/minmax, clamp(), zero breakpoints |149| Modern CSS Layout | `rules/responsive-foldables.md` | MEDIUM | Foldable devices, safe area insets, viewport segments |150| CSS | `rules/css-patterns.md` | HIGH | Container queries, cqi/cqb, fluid typography, grid, scroll-queries |151| React | `rules/react-patterns.md` | HIGH | Container query components, Tailwind, useContainerQuery, responsive images |152| PWA | `rules/pwa-service-worker.md` | HIGH | Workbox caching strategies, VitePWA, update management |153| PWA | `rules/pwa-offline.md` | HIGH | Offline hooks, background sync, install prompts |154| Animation | `rules/animation-motion.md` | HIGH | Motion presets, AnimatePresence, View Transitions |155| Animation | `rules/animation-scroll.md` | MEDIUM | CSS scroll-driven animations, parallax, progressive enhancement |156| Touch & Mobile | `rules/touch-interaction.md` | HIGH | Touch targets (44px min), thumb zones, pinch-to-zoom, safe areas, gestures |157158**Total: 10 rules across 6 categories**159160## Key Decisions161162| Decision | Option A | Option B | Recommendation |163|----------|----------|----------|----------------|164| Query type | Media queries | Container queries | **Container** for components, **Media** for layout |165| Container units | cqw/cqh | cqi/cqb | **cqi/cqb** (logical, i18n-ready) |166| Fluid type base | vw only | rem + vw | **rem + vw** (accessibility) |167| Mobile-first | Yes | Desktop-first | **Mobile-first** (less CSS, progressive) |168| Grid pattern | auto-fit | auto-fill | **auto-fit** for cards, **auto-fill** for icons |169170## Related Skills171172- `design-system-starter` - Building responsive design systems173- `ork:performance` - CLS, responsive images, and image optimization174- `ork-extras:i18n-date-patterns` - RTL/LTR responsive considerations175176## Capability Details177178### container-queries179**Keywords**: @container, container-type, inline-size, container-name180**Solves**: Component-level responsive design181182### fluid-typography183**Keywords**: clamp(), fluid, vw, rem, scale, typography184**Solves**: Smooth font scaling without breakpoints185186### responsive-images187**Keywords**: srcset, sizes, picture, art direction188**Solves**: Responsive images for different viewports189190### mobile-first-strategy191**Keywords**: min-width, mobile, progressive, breakpoints192**Solves**: Efficient responsive CSS architecture193194### grid-flexbox-patterns195**Keywords**: auto-fit, auto-fill, subgrid, minmax196**Solves**: Responsive grid and flexbox layouts197198### container-units199**Keywords**: cqi, cqb, container width, container height200**Solves**: Sizing relative to container dimensions201202## References203204Load on demand with `Read("references/<file>")`:205| File | Content |206|------|---------|207| `container-queries.md` | Container query patterns |208| `fluid-typography.md` | Accessible fluid type scales |