full-stack-design-skills: Skill for Claude Code

CSS Styling & Pixel-Perfect Design

Practical CSS patterns and strategies for building scalable, maintainable, and performant stylesheets.

CSS is often overlooked, but architectural decisions made early determine scalability, maintainability, and performance. Understanding CSS architecture, choosing the right approach (BEM vs Tailwind vs CSS-in-JS), and applying best practices is essential for professional development.

---

Core Principle: Choose an Architecture

CSS Architecture Options

Traditional CSS (BEM, OOCSS):

• Classes and naming conventions
• Organized by specificity
• Pros: Simple, works everywhere
• Cons: Class naming is hard, specificity conflicts

Utility-First (Tailwind):

• Predefined utility classes
• Build custom designs from utilities
• Pros: Fast development, consistent spacing/colors
• Cons: HTML feels cluttered, learning curve

CSS-in-JS (styled-components, emotion):

• Write CSS in JavaScript
• Scoped to component
• Pros: No naming conflicts, dynamic styles
• Cons: Runtime cost, harder to debug

CSS Modules:

• Local-scoped CSS
• Imports into components
• Pros: No naming conflicts, traditional CSS
• Cons: Extra build step, less reusable

---

Architecture Pattern 1: BEM (Block Element Modifier)

Naming convention: .block__element--modifier

/* Block: main component */
.button { ... }

/* Element: part of block */
.button__text { ... }

/* Modifier: state or variation */
.button--primary { ... }
.button--disabled { ... }

/* Usage */
.button--primary.button--large { ... }

HTML:

<button class="button button--primary">
  <span class="button__text">Click me</span>
</button>

Pros:

• Clear structure
• No cascading issues
• Reusable across projects

Cons:

• Verbose class names
• Takes discipline to maintain

---

Architecture Pattern 2: Tailwind CSS (Utility-First)

Apply utility classes to build components:

<!-- Direct in HTML -->
<button class="px-4 py-2 bg-blue-500 text-white rounded hover:bg-blue-600 focus:outline-none focus:ring-2">
  Click me
</button>

<!-- Or extract to component -->
<button class="btn btn-primary">Click me</button>