ilandahan/AID / skills/atomic-design
atomic-design
VerifiedBuild an Atomic Design system from design spec style guides - extract tokens, create atoms/molecules/organisms/templates/pages as reusable component libraries. Use when building or extending a design system or component library.
| File | Kind | Size |
|---|---|---|
| SKILL.extended.md | markdown | 14.6 KB |
| SKILL.md | skill md | 6.0 KB |
| references/atomic-hierarchy.extended.md | markdown | 15.5 KB |
| references/atomic-hierarchy.md | markdown | 4.2 KB |
| references/component-templates.extended.md | markdown | 23.0 KB |
| references/component-templates.md | markdown | 7.8 KB |
| references/design-deviation-rules.extended.md | markdown | 12.1 KB |
| references/design-deviation-rules.md | markdown | 3.5 KB |
| references/responsive-patterns.extended.md | markdown | 14.3 KB |
| references/responsive-patterns.md | markdown | 4.6 KB |
| tokens/breakpoints.json | config | 659 B |
| tokens/colors.json | config | 1.6 KB |
| tokens/components.json | config | 3.1 KB |
| tokens/spacing.json | config | 1.4 KB |
| tokens/typography.json | config | 1.8 KB |
references/responsive-patterns.extended.md
View on GitHub# Responsive Design Patterns
Mobile-first responsive patterns for Atomic Design components.
## ⚠️ CRITICAL: Extract Responsive Values from design spec Frames
```
┌─────────────────────────────────────────────────────────────────────┐
│ 🚨 BEFORE IMPLEMENTING RESPONSIVE STYLES: │
│ │
│ 1. Check design spec for ALL frame variations: │
│ • Mobile frame (320px - 480px) │
│ • Tablet frame (768px - 1024px) │
│ • Desktop frame (1280px+) │
│ │
│ 2. Extract EXACT values from each frame │
│ 3. DO NOT invent breakpoint behavior - use design spec frames │
│ │
│ ❌ "במובייל זה ייראה יותר טוב עם padding קטן יותר" = FORBIDDEN │
│ ✅ "ב-design spec Mobile frame ה-padding הוא 16px" = CORRECT │
└─────────────────────────────────────────────────────────────────────┘
```
**Related documents:**
- `design-deviation-rules.md` - Complete extraction workflow
- `design-deviation-rules.md` - Zero deviation policy
- `design-deviation-rules.md` - Specification fidelity rules
## Breakpoint System
**Standard breakpoints (mobile-first):**
⚠️ **IMPORTANT:** Check your design spec Style Guide for the actual breakpoints used. The values below are examples - replace with your design spec values.
| Name | Size | Target Device | design spec Frame |
|------|------|---------------|-------------|
| `xs` | 320px | Small mobile (iPhone SE) | Check design spec |
| `sm` | 480px | Mobile landscape | Check design spec |
| `md` | 768px | Tablet portrait (iPad) | Check design spec |
| `lg` | 1024px | Tablet landscape / Small laptop | Check design spec |
| `xl` | 1280px | Desktop | Check design spec |
| `2xl` | 1440px | Large desktop | Check design spec |
| `3xl` | 1920px | Full HD / Wide screens | Check design spec |
```css
/* CSS Custom Properties for breakpoints */
:root {
--breakpoint-xs: 320px;
--breakpoint-sm: 480px;
--breakpoint-md: 768px;
--breakpoint-lg: 1024px;
--breakpoint-xl: 1280px;
--breakpoint-2xl: 1440px;
--breakpoint-3xl: 1920px;
}
```
```typescript
// TypeScript breakpoints
const breakpoints = {
xs: '320px', // Small mobile (iPhone SE)
sm: '480px', // Mobile landscape
md: '768px', // Tablet portrait (iPad)
lg: '1024px', // Tablet landscape / Small laptop
xl: '1280px', // Desktop
'2xl': '1440px', // Large desktop
'3xl': '1920px', // Full HD / Wide screens
} as const;
```
## Core Principle: Mobile-First
**Always start with mobile styles, then enhance for larger screens.**
⚠️ **CRITICAL:** The values in each breakpoint must come from the corresponding design spec frame.
```css
/**
* Responsive Button Example
*
* ⚠️ ALL values from design spec frames - DO NOT INVENT
* Mobile: design spec Mobile frame
* Tablet: design spec Tablet frame
* Desktop: desktop design frame
*/
/* CORRECT - Mobile first with design spec values */
.button {
width: 100%; /* From design spec Mobile */
padding: var(--spacing-3) var(--spacing-4); /* From design spec Mobile */
font-size: var(--font-size-sm); /* From design spec Mobile */
}
@media (min-width: 480px) {
.button {
width: auto; /* From design spec Mobile Landscape */
}
}
@media (min-width: 768px) {
.button {
padding: var(--spacing-3) var(--spacing-6); /* From design spec Tablet */
font-size: var(--font-size-base); /* From design spec Tablet */
}
}
/* WRONG - Desktop first (avoid this pattern) */
.button {
width: auto;
padding: var(--spacing-3) var(--spacing-6);
}
@media (max-width: 767px) {
.button {
width: 100%;
padding: var(--spacing-3) var(--spacing-4);
}
}
```
## Responsive Token Patterns
### Container Width
⚠️ **Extract from design spec:** Check container padding at each breakpoint in your design spec frames.
```css
/**
* Container - Responsive Padding
*
* ⚠️ ALL values from design spec frames
* Extract container padding from each design spec breakpoint frame
*/
.container {
width: 100%;
padding-inline: var(--spacing-4); /* From design spec Mobile */
margin-inline: auto;
}
@media (min-width: 480px) {
.container {
padding-inline: var(--spacing-5);
}
}
@media (min-width: 768px) {
.container {
padding-inline: var(--spacing-6);
}
}
@media (min-width: 1024px) {
.container {
max-width: 960px;
padding-inline: var(--spacing-8);
}
}
@media (min-width: 1280px) {
.container {
max-width: 1200px;
}
}
@media (min-width: 1440px) {
.container {
max-width: 1320px;
}
}
@media (min-width: 1920px) {
.container {
max-width: 1600px;
}
}
```
### Typography Scale
⚠️ **Extract from design spec:** Check heading sizes in each design spec breakpoint frame.
```css
/**
* Typography - Responsive Sizes
*
* ⚠️ ALL font-size values from design spec frames
* Check: Mobile frame, Tablet frame, Desktop frame
*/
/* Heading scales down on mobile */
.h1 {
font-size: var(--font-size-2xl); /* From design spec Mobile */
line-height: var(--line-height-tight);
}
@media (min-width: 480px) {
.h1 {
font-size: var(--font-size-3xl); /* From design spec Mobile Landscape */
}
}
@media (min-width: 1024px) {
.h1 {
font-size: var(--font-size-4xl); /* From desktop design */
}
}
@media (min-width: 1440px) {
.h1 {
font-size: var(--font-size-5xl); /* From design spec Large Desktop */
}
}
/* Body text slightly smaller on mobile */
.body {
font-size: var(--font-size-sm); /* From design spec Mobile */
}
@media (min-width: 768px) {
.body {
font-size: var(--font-size-base); /* From design spec Tablet */
}
}
```
## Component Responsive Patterns
### Button
⚠️ **Check design spec:** Verify button sizing at each breakpoint in your design spec frames.
```css
/**
* Button - Responsive Sizing
*
* ⚠️ ALL values from design spec frames
* Mobile: Check design spec Mobile frame for button specs
* Tablet: Check design spec Tablet frame for button specs
* Desktop: Check desktop design frame for button specs
*/
.button {
/* Mobile: Full width, stacked - FROM design spec MOBILE */
display: flex;
justify-content: center;
align-items: center;
gap: var(--spacing-2);
width: 100%;
min-height: 44px; /* Touch target */
padding: var(--spacing-3) var(--spacing-4);
font-size: var(--font-size-sm);
}
@media (min-width: 480px) {
.button {
/* Mobile landscape: Auto width */
width: auto;
}
}
@media (min-width: 768px) {
.button {
/* Tablet+: Standard sizing */
min-height: 40px;
padding: var(--spacing-2) var(--spacing-4);
}
}
@media (min-width: 1024px) {
.button {
/* Desktop: Standard sizing */
padding: var(--spacing-2) var(--spacing-5);
font-size: var(--font-size-base);
}
}
/* Size variants also respond */
.button.lg {
min-height: 52px;
padding: var(--spacing-4) var(--spacing-5);
}
@media (min-width: 768px) {
.button.lg {
min-height: 48px;
padding: var(--spacing-3) var(--spacing-6);
}
}
```
### Card Grid
⚠️ **Check design spec:** Verify grid columns and gap at each breakpoint in your design spec frames.
```css
/**
* Card Grid - Responsive Layout
*
* ⚠️ ALL column and gap values from design spec frames
* Check each design spec breakpoint frame for grid layout
*/
.cardGrid {
display: grid;
gap: var(--spacing-4); /* From design spec Mobile */
/* Mobile: Single column - FROM design spec MOBILE */
grid-template-columns: 1fr;
}
@media (min-width: 480px) {
.cardGrid {
/* Mobile landscape: 2 columns */
grid-template-columns: repeat(2, 1fr);
}
}
@media (min-width: 768px) {
.cardGrid {
/* Tablet: 2 columns with larger gap */
gap: var(--spacing-5);
}
}
@media (min-width: 1024px) {
.cardGrid {
/* Desktop: 3 columns */
grid-template-columns: repeat(3, 1fr);
gap: var(--spacing-6);
}
}
@media (min-width: 1440px) {
.cardGrid {
/* Large desktop: 4 columns */
grid-template-columns: repeat(4, 1fr);
}
}
@media (min-width: 1920px) {
.cardGrid {
/* Wide screens: 5 columns */
grid-template-columns: repeat(5, 1fr);
gap: var(--spacing-8);
}
}
```
### Form Layout
```css
.form {
display: flex;
flex-direction: column;
gap: var(--spacing-4);
}
.formRow {
/* Mobile: Stack fields vertically */
display: flex;
flex-direction: column;
gap: var(--spacing-4);
}
@media (min-width: 768px) {
.formRow {
/* Tablet+: Side by side */
flex-direction: row;
gap: var(--spacing-5);
}
.formRow > * {
flex: 1;
}
}
.formActions {
/* Mobile: Stack buttons, full width */
display: flex;
flex-direction: column-reverse;
gap: var(--spacing-3);
}
@media (min-width: 480px) {
.formActions {
/* Mobile landscape+: Inline buttons */
flex-direction: row;
justify-content: flex-end;
gap: var(--spacing-4);
}
}
```
### Navigation
```css
.nav {
/* Mobile: Hidden, show hamburger */
display: none;
}
.mobileMenuButton {
display: flex;
}
@media (min-width: 768px) {
.nav {
/* Tablet+: Show nav */
display: flex;
align-items: center;
gap: var(--spacing-6);
}
.mobileMenuButton {
display: none;
}
}
/* Mobile menu overlay */
.mobileMenu {
position: fixed;
inset: 0;
background: var(--color-surface);
padding: var(--spacing-6);
z-index: 50;
}
@media (min-width: 768px) {
.mobileMenu {
display: none;
}
}
```
### Modal / Dialog
```css
.modal {
/* Mobile: Full screen */
position: fixed;
inset: 0;
display: flex;
flex-direction: column;
}
.modalContent {
flex: 1;
overflow-y: auto;
padding: var(--spacing-4);
}
@media (min-width: 480px) {
.modal {
/* Mobile landscape: Centered with some margin */
inset: var(--spacing-4);
border-radius: var(--radius-lg);
}
}
@media (min-width: 768px) {
.modal {
/* Tablet+: Centered overlay */
inset: unset;
top: 50%;
left: 50%;
transform: translate(-50%, -50%);
max-width: 500px;
max-height: 90vh;
border-radius: var(--radius-xl);
}
.modalContent {
padding: var(--spacing-6);
}
}
@media (min-width: 1024px) {
.modal {
max-width: 600px;
}
}
```
### Table to Cards
```css
/* Mobile: Show as cards */
.table {
display: block;
}
.tableHeader {
display: none;
}
.tableRow {
display: flex;
flex-direction: column;
padding: var(--spacing-4);
border-bottom: 1px solid var(--color-border);
}
.tableCell {
display: flex;
justify-content: space-between;
padding: var(--spacing-2) 0;
}
.tableCell::before {
content: attr(data-label);
font-weight: var(--font-weight-medium);
color: var(--color-text-secondary);
}
@media (min-width: 768px) {
/* Tablet+: Show as table */
.table {
display: table;
width: 100%;
}
.tableHeader {
display: table-header-group;
}
.tableRow {
display: table-row;
}
.tableCell {
display: table-cell;
padding: var(--spacing-3) var(--spacing-4);
}
.tableCell::before {
display: none;
}
}
```
## Layout Templates
### Dashboard Layout
```css
.dashboardLayout {
display: flex;
flex-direction: column;
min-height: 100vh;
}
.sidebar {
/* Mobile: Hidden or bottom nav */
display: none;
}
.mainContent {
flex: 1;
padding: var(--spacing-4);
}
@media (min-width: 1024px) {
.dashboardLayout {
display: grid;
grid-template-columns: 250px 1fr;
grid-template-rows: auto 1fr;
}
.header {
grid-column: 1 / -1;
}
.sidebar {
display: flex;
flex-direction: column;
border-right: 1px solid var(--color-border);
padding: var(--spacing-4);
}
.mainContent {
padding: var(--spacing-6);
}
}
@media (min-width: 1440px) {
.dashboardLayout {
grid-template-columns: 280px 1fr;
}
.mainContent {
padding: var(--spacing-8);
}
}
@media (min-width: 1920px) {
.dashboardLayout {
grid-template-columns: 320px 1fr;
}
.mainContent {
padding: var(--spacing-10);
max-width: 1600px;
}
}
```
### Auth Layout
```css
.authLayout {
min-height: 100vh;
display: flex;
flex-direction: column;
padding: var(--spacing-4);
}
.authForm {
width: 100%;
margin-top: auto;
margin-bottom: auto;
}
@media (min-width: 480px) {
.authLayout {
align-items: center;
justify-content: center;
}
.authForm {
max-width: 400px;
padding: var(--spacing-6);
background: var(--color-surface);
border-radius: var(--radius-xl);
box-shadow: var(--shadow-lg);
}
}
@media (min-width: 768px) {
.authForm {
padding: var(--spacing-8);
}
}
```
## Touch Target Guidelines
**Minimum touch targets:**
- Mobile: 44px x 44px
- Desktop: Can be smaller (36px minimum recommended)
```css
.interactiveElement {
min-height: 44px;
min-width: 44px;
/* Or use padding to achieve size */
padding: var(--spacing-3);
}
@media (min-width: 1024px) {
.interactiveElement {
min-height: 36px;
min-width: 36px;
padding: var(--spacing-2);
}
}
```
## Spacing Adjustments
```css
:root {
/* Base spacing tokens - Mobile */
--section-gap: var(--spacing-8);
--component-gap: var(--spacing-4);
--content-padding: var(--spacing-4);
}
@media (min-width: 768px) {
:root {
--section-gap: var(--spacing-12);
--component-gap: var(--spacing-5);
--content-padding: var(--spacing-6);
}
}
@media (min-width: 1024px) {
:root {
--section-gap: var(--spacing-16);
--component-gap: var(--spacing-6);
--content-padding: var(--spacing-8);
}
}
@media (min-width: 1440px) {
:root {
--section-gap: var(--spacing-20);
--component-gap: var(--spacing-8);
--content-padding: var(--spacing-10);
}
}
@media (min-width: 1920px) {
:root {
--section-gap: var(--spacing-24);
--component-gap: var(--spacing-10);
--content-padding: var(--spacing-12);
}
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |