Communitygithub.com

Sistema de Espaçamento Fluido

Projete e implemente uma escala de espaçamento fluida usando a função CSS clamp() para garantir espaços em branco e ritmo vertical consistentes em todos os dispositivos. Ative esta skill ao solicitar definição de sistemas de espaçamento, margens, paddings ou gaps de layout.

O que é Sistema de Espaçamento Fluido?

Esta skill fornece uma metodologia para criar uma escala responsiva de espaços em branco (margens, paddings, gaps) que se adapta suavemente à viewport do usuário. Utilizando a função CSS `clamp()`, o espaçamento escala linearmente entre valores mínimo e máximo definidos, mantendo a harmonia visual e proporções consistentes sem a necessidade excessiva de media queries. É útil para estabelecer uma escala de espaçamento fundamental para um novo sistema de design, modernizar um site para melhor consistência visual entre dispositivos, ou projetar layouts de alta qualidade onde o espaçamento precisa respirar em telas grandes, mas permanecer compacto em telas pequenas. A skill define parâmetros de viewport, unidade base de espaçamento e uma proporção de escala, gerando um conjunto de variáveis CSS que usam `clamp()` para valores que vão de 'minúsculo' a 'enorme', além de fornecer mapeamento semântico e documentação de uso. A abordagem é compatível com qualquer projeto web moderno que utilize CSS, independentemente da plataforma específica do agente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/fluid-spacing-system

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Sistema de Espaçamento Fluido faz?

Propósito

A habilidade Sistema de Espaçamento Fluido fornece uma metodologia para criar uma escala responsiva de espaços em branco (margens, paddings, gaps) que se adapta suavemente à viewport do usuário. Usando a função CSS clamp(), o espaçamento escala linearmente entre valores mínimo e máximo definidos, mantendo a harmonia visual e proporções consistentes sem a necessidade de media queries excessivas.

Casos de Uso

  • Estabelecer uma escala de espaçamento fundamental para um novo sistema de design.
  • Modernizar um site para melhorar a consistência visual em dispositivos móveis, tablets e desktops.
  • Projetar layouts de alta qualidade onde o espaçamento precisa respirar em telas grandes, mas permanecer compacto em telas pequenas.
  • Substituir o espaçamento fixo baseado em pixels por um sistema mais flexível e consciente da implementação.

Quando NÃO Usar

  • Páginas Simples e Não Responsivas: Se o layout for extremamente básico ou não tiver requisitos de responsividade.
  • Layouts Estritamente Fixos: Quando as especificações de design exigem valores exatos de pixel inegociáveis em todas as resoluções.
  • Suporte a Navegadores Antigos: Se o público-alvo utiliza principalmente navegadores que não suportam CSS clamp() (ex.: Internet Explorer).

Entradas

Para gerar um sistema de espaçamento fluido, você precisa:

  1. Faixa de Viewport:
    • min-width: A largura da tela onde a escala começa (ex.: 320px).
    • max-width: A largura da tela onde a escala para (ex.: 1280px).
  2. Unidade Base de Espaçamento:
    • min-size: A unidade base (ex.: 16px) em min-width.
    • max-size: A unidade base (ex.: 20px) em max-width.
  3. Proporção de Escala:
    • Um multiplicador para determinar os passos na escala (ex.: 1,25 para uma escala de Terça Maior, ou uma progressão linear 2x/3x/4x).

Saídas

  1. Escala de Espaçamento Fluida: Um conjunto de variáveis CSS definindo valores de "minúsculo" a "enorme" usando clamp().
  2. Mapeamento Semântico: Diretrizes sobre como aplicar esses tokens (ex.: --space-m para padding de componente, --space-xl para margens de seção).
  3. Documentação de Uso: Regras para combinar unidades para manter o ritmo vertical e o alinhamento horizontal.

Fluxo de Trabalho

1. Definir os Parâmetros da Escala

Defina os limites do seu sistema fluido com base nos dispositivos alvo do projeto. Exemplo: 320px (Mobile) a 1440px (Desktop), com uma unidade base escalando de 16px a 24px.

2. Escolher uma Proporção de Espaçamento

Decida como os passos de espaçamento devem crescer.

  • Linear/Multiplicativo: Os passos são múltiplos da unidade base (ex.: 0,5x, 1x, 1,5x, 2x, 4x, 8x). Melhor para alinhamento previsível.
  • Escala Geométrica: Cada passo é o anterior multiplicado por uma proporção (ex.: 1,25). Melhor para layouts artísticos de alto contraste.

3. Calcular os Passos da Escala

Crie uma faixa de tamanhos. Uma escala típica inclui:

  • 3XS a XS: Para detalhes minúsculos, listas compactas e padding interno de botões.
  • S a M: Para espaçamento padrão de componentes e calhas (gutters).
  • L a 3XL: Para margens de seção, espaçamento de herói (hero) e grandes gaps de layout.

4. Gerar Fórmulas CSS clamp()

Converta valores de pixel em fórmulas fluidas. clamp(min_rem, intercept_rem + slope_vw, max_rem)

Cálculo da inclinação: (max_px - min_px) / (max_viewport - min_viewport) * 100

5. Atribuir Papéis Semânticos

Mapeie a escala abstrata para papéis funcionais para garantir consistência na equipe.

  • space-component: --space-s
  • space-layout-gutter: --space-m
  • space-section: --space-xl

Regras de Decisão

  • Princípio da Grade 8pt: Sempre que possível, garanta que seus valores mínimos e máximos sejam múltiplos de 4 ou 8 para alinhar com padrões de UI comuns.
  • Princípio da Proximidade: Elementos relacionados devem ter menos espaço entre si do que elementos não relacionados.
  • Compressão Mobile: Mantenha unidades de espaçamento menores (3XS-S) relativamente estáveis; apenas unidades maiores (L-3XL) devem escalar agressivamente para evitar que layouts mobile pareçam "explodidos".
  • Acessibilidade: Garanta que, mesmo na menor escala, os elementos interativos mantenham uma área de toque suficientemente grande (mínimo 24x24px por WCAG 2.2 SC 2.5.8, incluindo padding; 44x44px preferido para ações primárias).
  • Espaçamento Relativo ao Contêiner: Para espaçamento que deve responder ao contêiner de um componente em vez da viewport (ex.: um card que pode estar em uma barra lateral estreita ou em uma coluna principal larga), use unidades de comprimento de container query (cqi/cqw) dentro da fórmula clamp() em vez de vw.

Restrições

  • Responsividade: O espaçamento nunca deve causar estouro horizontal (horizontal overflow).
  • Consistência: Uma vez definida a escala, não use valores de pixel "avulsos".
  • Hierarquia: Espaçamentos maiores devem sempre ser usados para separar blocos maiores de conteúdo (ex.: seções), enquanto espaçamentos menores são para detalhes internos de componentes.
  • Escopo: Esta skill cobre apenas valores de espaçamento — ela não cria uma grade de layout (use responsive-grid-system), define tamanhos de tipografia (use fluid-typography-system) ou gerencia z-index/camadas.

Padrões Comuns de Falha

  • Escalar Tudo Igualmente: Escalar pequenos paddings (como 4px) demais pode fazer os componentes parecerem distorcidos no desktop.
  • Ignorar Calhas de Layout: Ter espaçamento de componente fluido, mas calhas de grade fixas, levando a um "desalinhamento" progressivo.
  • Escala Exagerada: Ter 20+ passos de espaçamento diferentes torna o sistema difícil de usar e manter. Mire em 7-9 passos.
  • Passos Sem Lógica: Usar números arbitrários em vez de uma escala ou proporção consistente.

Critérios de Validação

  • O espaçamento escala suavemente quando a viewport é redimensionada.
  • O ritmo vertical é mantido em todos os breakpoints principais.
  • Nenhum valor de pixel "avulso" é usado na implementação; todo espaçamento usa as variáveis definidas.
  • O sistema usa unidades rem para os limites mínimo e máximo da função clamp().
  • A proximidade e a hierarquia são reforçadas pelas escolhas de espaçamento.
  • Elementos interativos mantêm pelo menos uma área de toque de 24x24px (WCAG 2.2 SC 2.5.8) em cada ponto da escala fluida, incluindo a menor viewport.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas