tailwind-responsive-ui
Community Responsive UI Tailwind CSS Best Practices
Comprehensive responsive transformation guide for Tailwind CSS applications, based on Refactoring UI by Adam Wathan & Steve Schoger and modern responsive design patterns. Contains 49 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
When to Apply
Reference these guidelines when:
- Making an existing UI responsive across screen sizes
- Building new responsive layouts with Tailwind CSS
- Refactoring desktop-only interfaces for mobile support
- Reviewing responsive code for breakpoint, spacing, and typography issues
- Adapting navigation, forms, and data tables for touch devices
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Breakpoint Strategy | CRITICAL | bp- |
| 2 | Layout Transformation | CRITICAL | layout- |
| 3 | Responsive Spacing | HIGH | rspac- |
| 4 | Fluid Typography | HIGH | fluid- |
| 5 | Navigation Patterns | MEDIUM-HIGH | nav- |
| 6 | Touch & Interaction | MEDIUM | touch- |
| 7 | Responsive Media | MEDIUM | rmedia- |
| 8 | Data Adaptation | LOW-MEDIUM | data- |
Quick Reference
1. Breakpoint Strategy (CRITICAL)
bp-mobile-first-default- Use Mobile-First Breakpoint Directionbp-content-driven-breakpoints- Set Breakpoints Where Content Breaksbp-avoid-device-widths- Avoid Device-Specific Breakpoint Valuesbp-consolidate-breakpoints- Consolidate Breakpoints to Three or Fourbp-min-width-over-max- Use min-width Over max-width for Breakpointsbp-debug-breakpoints- Use Visual Breakpoint Indicators During Development
2. Layout Transformation (CRITICAL)
layout-stack-to-row- Stack Elements on Mobile, Row on Desktoplayout-sidebar-collapse- Collapse Sidebar to Top or Bottom on Mobilelayout-grid-column-reduction- Reduce Grid Columns at Narrower Breakpointslayout-holy-grail-responsive- Use Responsive Holy Grail Layout with Gridlayout-sticky-to-static- Convert Sticky Elements to Static on Mobilelayout-fixed-to-relative- Replace Fixed Positioning with Relative on Mobilelayout-aspect-ratio-containers- Use Aspect Ratio for Responsive Containers
3. Responsive Spacing (HIGH)
rspac-scale-padding-per-bp- Scale Padding Independently Per Breakpointrspac-responsive-gap- Use Responsive Gap for Grid and Flex Spacingrspac-compact-mobile-generous-desktop- Use Compact Spacing on Mobile, Generous on Desktoprspac-section-spacing- Scale Section Dividers with Viewportrspac-inline-to-stack-spacing- Convert Inline Spacing to Stack Spacing on Mobilerspac-container-padding- Use Responsive Container Padding
4. Fluid Typography (HIGH)
fluid-clamp-font-size- Use clamp() for Fluid Font Sizingfluid-responsive-line-height- Tighten Line Height as Font Size Increasesfluid-responsive-measure- Constrain Line Length to 45-75 Charactersfluid-scale-headings-independently- Scale Heading Sizes Independently Across Breakpointsfluid-responsive-letter-spacing- Adjust Letter Spacing for Responsive Headlinesfluid-type-scale- Use a Responsive Type Scale
5. Navigation Patterns (MEDIUM-HIGH)
nav-horizontal-to-hamburger- Collapse Horizontal Nav to Hamburger on Mobilenav-tab-bar-mobile- Use Bottom Tab Bar for Primary Mobile Navigationnav-breadcrumb-collapse- Truncate Breadcrumbs on Mobilenav-sidebar-drawer- Convert Sidebar Nav to Off-Canvas Drawer on Mobilenav-dropdown-to-fullscreen- Expand Dropdown Menus to Full-Width on Mobilenav-sticky-header-compact- Compact the Header on Scroll for Mobile
6. Touch & Interaction (MEDIUM)
touch-min-touch-target- Ensure Minimum 44px Touch Targets on Mobiletouch-hover-to-tap- Replace Hover Interactions with Tap-Friendly Alternativestouch-swipe-affordance- Add Visual Swipe Affordances for Horizontal Scrollingtouch-scroll-snap-mobile- Use Scroll Snap for Carousel-Like Mobile Interfacestouch-input-sizing-mobile- Size Form Inputs to Prevent iOS Zoomtouch-focus-visible-touch- Use focus-visible for Touch-Friendly Focus Styles
7. Responsive Media (MEDIUM)
rmedia-responsive-images- Use Responsive Image Sizing with Object-Fitrmedia-video-aspect-ratio- Maintain Video Aspect Ratio Across Breakpointsrmedia-icon-size-scaling- Scale Icons Per Breakpoint, Not with Font Sizermedia-avatar-responsive- Scale Avatar Sizes Per Context and Breakpointrmedia-background-image-bp- Swap Background Images at Breakpointsrmedia-embed-responsive- Make Embedded Content Responsive with Container Constraints
8. Data Adaptation (LOW-MEDIUM)
data-table-to-cards- Transform Tables to Cards on Mobiledata-horizontal-scroll-table- Use Horizontal Scroll for Dense Data Tablesdata-responsive-data-grid- Adapt Data Grid Density for Screen Sizedata-list-density-mobile- Increase List Item Density on Mobiledata-truncate-overflow- Truncate Overflowing Text on Mobiledata-responsive-form-layout- Stack Form Fields on Mobile, Use Grid on Desktop
How to Use
Read individual reference files for detailed explanations and code examples:
- Section definitions - Category structure and impact levels
- Rule template - Template for adding new rules
Reference Files
| File | Description |
|---|---|
| references/_sections.md | Category definitions and ordering |
| assets/templates/_template.md | Template for new rules |
| metadata.json | Version and reference information |
More from pproenca/dot-skills
zod
Zod schema validation best practices for type safety, parsing, and error handling. This skill should be used when defining z.object schemas, using z.string validations, safeParse, or z.infer. This skill does NOT cover React Hook Form integration patterns (use react-hook-form skill) or OpenAPI client generation (use orval skill).
2.0Kclean-architecture
Clean Architecture principles and best practices from Robert C. Martin's book. This skill should be used when designing software systems, reviewing code structure, or refactoring applications to achieve better separation of concerns. Triggers on tasks involving layers, boundaries, dependency direction, entities, use cases, or system architecture.
1.4Kemilkowal-animations
Emil Kowalski's animation best practices for web interfaces. Use when writing, reviewing, or implementing animations in React, CSS, or Framer Motion. Triggers on tasks involving transitions, easing, gestures, toasts, drawers, or motion.
923vitest
Vitest testing framework patterns for test setup, async testing, mocking with vi.*, snapshots, and test performance (formerly test-vitest). This skill should be used when writing or debugging Vitest tests. This skill does NOT cover TDD methodology (use test-tdd skill), API mocking with MSW (use test-msw skill), or Jest-specific APIs.
909typescript
This skill should be used when the user asks to "optimize TypeScript performance", "speed up tsc compilation", "configure tsconfig.json", "fix type errors", "improve async patterns", or encounters TS errors (TS2322, TS2339, "is not assignable to"). Also triggers on .ts, .tsx, .d.ts file work involving type definitions, module organization, or memory management. Does NOT cover TypeScript basics, framework-specific patterns, or testing.
824nuqs
nuqs (type-safe URL query state) best practices for Next.js applications. This skill should be used when writing, reviewing, or refactoring code that uses nuqs for URL state management. Triggers on tasks involving useQueryState, useQueryStates, search params, URL state, query parameters, nuqs parsers, or Next.js routing with state.
737