Communitygithub.com

jonas-web-design

Habilidade sistemática de design frontend e engenharia CSS baseada nas Regras de Design Web de Jonas Schmedtmann, estrutura das 7 Personalidades de Sites, 10 Ingredientes de Design e Arquitetura CSS Avançada (Omnifood, Natours, Trillo, Nexter). Fluxo de trabalho OBRIGATÓRIO: sempre começa alinhando a personalidade/estilo do site com o usuário (fornecendo recomendações personalizadas do Agente e receitas visuais antes de escrever código). Use esta habilidade sempre que o usuário pedir para projetar ou construir uma página web, landing page, site de marketing, portfólio, painel ou componente de UI frontend, ou quiser aplicar a estética de design web e metodologia CSS de Jonas.

O que é jonas-web-design?

Esta habilidade sistematiza o currículo frontend completo de Jonas Schmedtmann em um fluxo de trabalho repetível para construir interfaces web responsivas, polidas e focadas em conversão. A filosofia central é que o bom design web não é subjetivo, mas sim um sistema rigoroso baseado em 7 Personalidades de Sites (com mistura de traços) aplicadas consistentemente em 10 Ingredientes de Design, utilizando Unidades Responsivas (`62,5%` `rem`), Flexbox + CSS Grid e Arquitetura Orientada a Componentes. O fluxo começa obrigatoriamente com um alinhamento de estilo, onde o Agente analisa o contexto e recomenda uma combinação de personalidades, fornecendo uma receita visual detalhada (tipografia, paleta de cores, formas, layout). Após a confirmação do usuário, a habilidade aplica os 10 Ingredientes de Design com escalas numéricas exatas (como a escala de tamanho de fonte e espaçamento de Jonas), garantindo consistência visual. Finalmente, executa a página em 7 etapas, combinando HTML5 semântico, nomenclatura BEM, Flexbox e CSS Grid para layouts responsivos e arquitetura CSS avançada. A habilidade inclui guias de referência incorporados para tokens de personalidade, receitas de ingredientes e padrões de layout, suportando plataformas como Claude Code, Cursor e Codex.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zjy-dev/skills/tree/HEAD/skills/jonas-web-design

Perguntar na sua IA favorita

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

Documentação

Habilidade de Design Web e CSS Avançado (Jonas)

Esta habilidade traduz o currículo frontend completo de Jonas Schmedtmann (Regras e Diretrizes de Design Web, Construa Sites Responsivos do Mundo Real com HTML & CSS e CSS Avançado e Sass) em um fluxo de trabalho sistemático e repetível para construir interfaces web responsivas, polidas e focadas em conversão.

Filosofia Central: Bom design web não é um palpite subjetivo. É um sistema rigoroso construído sobre 7 Personalidades de Sites (mais mistura de traços) aplicado consistentemente em 10 Ingredientes de Design, projetado com Unidades Responsivas (62,5% rem), Flexbox + CSS Grid e Arquitetura Orientada a Componentes.


🚦 Fase 1: Alinhamento de Estilo Obrigatório (Com Recomendações do Agente)

REGRRA CRÍTICA: No início de qualquer nova tarefa de design de página web ou UI — antes de escrever código de implementação (a menos que o usuário diga explicitamente "直接写代码/跳过确认") — você DEVE primeiro alinhar o estilo visual com o usuário e fornecer uma Recomendação Proativa do Agente.

Etapa 1.1: Análise Rápida de Contexto (Definir & Planejar)

Inferir silenciosamente a partir da solicitação do usuário:

  • QUEM & O QUÊ: Indústria, público-alvo, objetivo de negócio (ex.: conversão, prestígio de marca, clareza de informação) e objetivo do usuário.
  • Vibe Necessária: Qual das 7 Personalidades de Sites melhor atende a este objetivo e se uma Personalidade Secundária (混搭副风格) deve ser injetada (80% Primária + 20% Secundária).

Etapa 1.2: Apresentar Sua Recomendação do Agente + Opções

Apresentar uma Proposta de Alinhamento de Estilo estruturada e concisa (ou usar a ferramenta ask_question se disponível junto com uma prévia breve da receita visual):

  1. 🎯 Esquema de Recomendação Exclusiva do Agente (Direção Recomendada):
    • Personalidade Principal (Primary Personality) + Injeção de Traço Secundário (Secondary Trait Injection) (ex.: Startup/Upbeat 创业活力 + Calm/Peaceful 温和关怀).
    • Motivo da Recomendação (Por que se encaixa): 1–2 frases ligando os objetivos de negócio/usuário do produto a esta combinação de personalidades.
    • Prévia da Receita Visual (Visual Recipe Preview):
      • Tipografia (Tipografia e Tamanho de Fonte): Combinação de fonte de título e corpo recomendada + escala de manchete (52px+ negrito vs. serifa leve).
      • Paleta de Cores (Sistema de Cores): Cor principal + Cor de destaque + Fundo matizado + Texto cinza escuro (com valores Hex concretos, nunca #000 puro).
      • Forma e Profundidade (Arredondamento e Sombra): Raio da borda (0px nítido vs. 9px–12px amigável vs. 16px+ divertido) e estratégia de sombra (nenhuma vs. Elevação sutil do Flat Design 2.0 vs. brilho colorido).
      • Layout e Padrão de Hero (Layout Principal e Primeira Tela): ex.: Hero de 2 colunas dividido + Faixa de parceiros + Etapas em Z + Cards de 3 colunas + Nível de preços destacado.
  2. 🎨 Direções de Estilo Alternativas (2 Alternativas Contrastantes): Oferecer 2 personalidades alternativas distintas da tabela das 7 Personalidades abaixo (ex.: Opção B: Minimalista/Simples + Ousado/Confiante, Opção C: Sério/Elegante) para que o usuário possa comparar e escolher facilmente.
  3. Aguardar Confirmação do Usuário: Peça ao usuário para confirmar a receita recomendada, escolher a Opção B/C ou ajustar qualquer ingrediente (cores, modo escuro/claro, arredondamento). Uma vez confirmado, prossiga imediatamente para a Fase 2 e Fase 3.

🎭 A Matriz das 7 Personalidades de Sites

Cada ingrediente de design deve se adaptar à Personalidade de Site escolhida. (Para predefinições completas de CSS :root e regras de mistura híbrida, leia references/personalities-and-tokens.md).

#PersonalidadeIndústrias TípicasTipografiaSistema de CoresImagens e ÍconesSombras e RaioTendências de Layout
01Sério/Elegante(严肃/优雅)Luxo, imobiliário (Nexter), alta moda, joias, hotéis boutiqueTítulos Serifa fina/leve (Playfair Display, Cormorant), corpo pequeno (16px)Dourado (#c69963), champanhe/cremes pastel (#f9f7f6), azul marinho profundo (#101d2c), carvãoFotos grandes e de alta resolução de produtos/ambientes; sem ícones ou ícones de linha ultrafinosSem sombras (none)Sem raio (0px)Criativo, assimétrico, sobreposição em CSS Grid, layouts de revista
02Minimalista/Simples(极简/纯粹)Portfólios, estúdios de design, moda minimalista, documentação de desenvolvedoresSans-Serif limpo (Inter, Work Sans), texto pequeno/médioMonocromático (#222/#333 em #fff puro), no máximo 1 cor contidaPoucas fotos selecionadas para adicionar cor; sem ilustrações; mínimo/sem íconesSem sombras (none)Sem raio (0px)Simples, 1 coluna estreita ou grade suíça limpa com bordas finas
03Simples/Neutro(平实/中性)B2B empresarial, finanças, corporações estabelecidas, portais de dadosSans-Serif neutro (Inter, Roboto), texto compacto pequeno (14–16px)Azuis corporativos seguros (#1d4ed8), cinzas ardósia (#334155), nada chamativoFotos funcionais pequenas a médias; ícones de UI simples e rotuladosSem sombrasSem raio (0–4px)Estruturado, linhas condensadas, caixas, barras laterais, padrão F, tabelas
04Ousado/Confiante(大胆/自信)Agências digitais, viagens de aventura (Natours), esportes, tecnologia forteSans-Serif limpo (Montserrat, Lato), maiúsculo grande e negrito (52–98px, 700+)Múltiplas cores saturadas brilhantes; grandes seções de blocos de cores sem margemMuitas fotos grandes de alto impacto ou vídeo de fundo; poucos/sem íconesGeralmente sem sombrasGeralmente raio 0pxSeções diagonais clip-path/inclinadas, grandes blocos de cores, grades ousadas
05Calmo/Pacífico(平静/温和)Saúde, bem-estar, nutrição (Omnifood), cuidados com a pele, marcas ecológicasTítulos Serifa suave (Lora, Merriweather) ou Sans arredondada e quente (Rubik)Tons pastel/terra lavados: creme quente (#fdf2e9), terracota, sálvia, azul suaveFotos humanas quentes e ilustrações combinadas com cores; ícones frequentes em círculos matizadosSombras esparsas/suavesRaio moderado (8–12px)Padrões Z equilibrados, espaços em branco generosos (96–128px), seções quentes
06Startup/Animado(创业/活力)SaaS, produtos de IA, aplicativos modernos (Trillo), fintech, produtividadeSans-Serif limpo (Inter, Rubik, Plus Jakarta Sans), títulos médiosAzuis, verdes, índigos, roxos; fundos cinza claro/matizados + gradientes sutisIlustrações 3D/vetoriais, maquetes de UI de aplicativos, formas sutis; ícones muito frequentesSombras e brilhos sutisRaio comum (9–16px)Linhas de cards, padrões Z, faixas de logotipos, tabelas de preços, movimento 200–400ms
07Divertido/Brincalhão(活泼/趣味)Produtos infantis/pets, comida e bebida, comunidades criativas, jogos casuaisSans-Serif arredondada/criativa (Rubik, Quicksand), texto centralizado comumPaletas vibrantes multicoloridas em fundos, cards e textoIlustrações desenhadas à mão ou 3D, padrões geométricos; ícones desenhados à mão/duotoneSombras sutis ou deslocadasRaio alto (16px–pill)Grades de colagem, interações de hover saltitantes, texto de conversa divertido

💡 Dica Profissional — Injeção de Traço (混搭 de estilo): Combine 1 Personalidade Principal com 1 Personalidade Secundária para criar designs distintos e não genéricos:

  • Startup/Animado + Calmo/Pacífico (ex.: Omnifood: estrutura de conversão SaaS + fundos creme quentes #fdf2e9 e laranja #e67e22).
  • Startup/Animado + Ousado/Confiante (Cards SaaS modernos + tipografia grande 74px e seções escuras de alto contraste).
  • Minimalista/Simples + Ousado/Confiante (Grade monocromática limpa + tipografia gigante e blocos de cores fortes).

📐 Fase 2: Aplicar os 10 Ingredientes de Design e Escalas Quantificadas

Nunca adivinhe tamanhos de fonte, margens ou cores. Aplique as escalas numéricas exatas de Jonas via Propriedades Personalizadas CSS (:root). Para todas as 86 regras nos 10 ingredientes, consulte references/ten-design-ingredients.md.

1. O Sistema Estrito de Escala de Tipo e Espaçamento

Defina html { font-size: 62.5%; } (1rem = 10px) e restrinja todos os tamanhos de fonte e valores de espaçamento a estas duas escalas predefinidas:

  • Escala de Tamanho de Fonte (px): 10 / 12 / 14 / 16 / 18 / 20 / 24 / 30 / 36 / 44 / 52 / 62 / 74 / 86 / 98
  • Escala de Espaçamento (px): 2 / 4 / 8 / 12 / 16 / 24 / 32 / 48 / 64 / 80 / 96 / 128

2. Lista de Verificação de Regras Principais nos 10 Ingredientes

  1. Tipografia:
    • Use 1 tipo de letra (ou no máximo 2: título Serifa + corpo Sans) de famílias selecionadas (Inter, Rubik, Work Sans, Montserrat, Lato, Playfair Display, Merriweather, Lora).
    • Texto do corpo: 16px–20px (20px–24px para artigos longos), peso >= 400, line-height: 1.5–2.0, comprimento da linha < 75ch (65ch–72ch ideal).
    • Manchetes: 44px–86px+, peso 600–700, line-height: 1.05–1.2, letter-spacing negativo -0.5px a -1.5px.
    • Subtítulos de sobrancelha: Pequeno (12px–16px), negrito (600–700), UPPERCASE, espaçado letter-spacing: 0.75px–2px, cor de tom principal.
    • Nunca justifique texto (text-align: justify) e nunca centralize blocos de texto longos (> 3 linhas).
  2. Cores:
    • Construa um sistema de Cor Principal + Escala de Cinza + Cor de Destaque opcional, e gere Matizes (misturados com #fff para fundos de seção/ícones) e Sombras (misturados com #000 para estados de hover e títulos escuros).
    • Nunca use #000000 puro para texto — use cinza escuro suavizado (#333, #444, #555).
    • Em fundos escuros, use um matiz claro dessa cor de fundo para o texto do corpo.
    • Mantenha contraste WCAG: >= 4.5:1 para texto normal, >= 3.0:1 para texto grande (18px+).
  3. Imagens e Ilustrações:
    • Mostre pessoas reais para gerar emoção; garanta que imagens lado a lado compartilhem dimensões idênticas (aspect-ratio + object-fit: cover).
    • Texto em Imagens: Sempre use um dos 3 métodos de Jonas: (1) Escurecer/clarear com sobreposição linear-gradient(rgba(0,0,0,0.6), ...), (2) Colocar texto em uma área de imagem neutra, ou (3) Colocar texto dentro de uma caixa matizada/desfocada.
  4. Ícones:
    • Use um único pacote de ícones SVG (Phosphor, Ionicons, Lucide, Heroicons). Nunca misture pacotes ou use .png/.jpg.
    • Nunca dimensione ícones brutos acima de 24px–32px; se uma âncora de recurso maior (48px–64px) for necessária, envolva o ícone de 24px–32px dentro de um círculo/quadrado matizado (background: var(--color-primary-tint-1); padding: 1.6rem; border-radius: 50%).
  5. Sombras e 6. Raio da Borda:
    • Mantenha as sombras leves (rgba(0,0,0,0.05) a 0.12) e esparsas. Escalone o desfoque da sombra com a elevação (pequeno para cards, grande para modais flutuantes).
    • Mude a sombra + translateY(-2px) em :hover e reduza em :active. Combine border-radius com o arredondamento do tipo de letra e a personalidade.
  6. Espaçamento em Branco (Lei da Proximidade) :
    • Use espaçamento em branco massivo entre seções (80px–128px, ex.: padding: 9.6rem 0) e grupos de elementos (48px–96px).
    • Elementos que pertencem juntos devem estar mais próximos (ex.: título mais próximo de seu parágrafo de corpo do que do elemento acima; rótulo de formulário mais próximo de seu campo de entrada do que do campo anterior). Prefira espaços em branco a linhas divisórias.
  7. Hierarquia Visual:
    • Coloque conteúdo de alta prioridade e CTAs perto do topo.
    • Combine tamanho, peso, cor e espaçamento: desenfatize rótulos/metadados secundários (#767676, 14px) para que títulos e pontos de dados principais (preços, métricas) se destaquem.
    • Desenfatize o Componente B para enfatizar o Componente A (ex.: combine o CTA principal .btn--full com o botão secundário .btn--outline; destaque 1 card de preços "Melhor Valor" com um fundo/faixa matizada, mantendo o outro nível branco simples com uma borda sutil).
  8. Experiência do Usuário (UX):
    • Use padrões de layout familiares; escreva textos de CTA descritivos e baseados em benefícios (ex.: "Comece a comer bem" em vez de "Enviar").
    • Mantenha as animações rápidas e objetivas (200ms–500ms). Reserve texto azul/sublinhado estritamente para links.
    • Divida textos longos com subtítulos, citações em bloco, caixas de recursos e listas com marcadores de ícones.
  9. Montagem de Componentes e Layout:
    • Monte páginas a partir de Elementos Atômicos → Componentes de UI → Componentes de Seção → Padrões de Layout (Linha de cards, Grade de cards, Padrão Z, Padrão F, Coluna Única, Barra Lateral, Revista, Sobreposição Assimétrica).

🏗️ Fase 3: 7 Etapas de Execução e Engenharia CSS Avançada

Siga as 7 Etapas para um Ótimo Site de Jonas e os padrões de engenharia Pensar – Construir – Arquitetar (padrões detalhados em references/css-architecture-and-layouts.md):

  1. Definir e Planejar Seções: Mapeie o fluxo narrativo antes de codificar (ex.: Nav Fixo → Hero Dividido com Prova Social → Faixa de Logotipos Parceiros → Padrão Z "Como Funciona" com números grandes 01/02/03 → Cards de Recursos/Produtos com Tags → Depoimentos + Grade de Galeria de Fotos → Comparação de Preços + Ícones de Recursos → Formulário de CTA Dividido de Alto Contraste → Rodapé Multi-Coluna).
  2. HTML5 Semântico + Nomenclatura BEM Plana:
    • Use <header>, <nav>, <main>, <section class="section-...">, <article>, <figure>, <footer>.
    • Use classes BEM limpas (.meal__content, .btn--full, .pricing-plan--complete) e primitivas de layout reutilizáveis (.container, .grid, .grid--2-cols, .grid--3-cols, .grid--4-cols, .grid--center-v).
  3. Combinar Flexbox (1D) e CSS Grid (2D):
    • Use Flexbox para internos de componentes 1D (barras de navegação, linhas de botões, listas de ícone+rótulo, pilhas verticais de cards).
    • Use CSS Grid para layouts 2D de página e seção, sobreposição assimétrica de mídia (abrangências grid-row / grid-column) e grades de cards auto-responsivas (repeat(auto-fit, minmax(25rem, 1fr))).
  4. Escalonamento Responsivo e Breakpoints:
    • Escalone todo o design sem esforço, diminuindo o html raiz do tamanho da fonte nos breakpoints onde o layout quebra (62,5% → 56,25% em 1200px → 50% em 944px), e colapsando grades multi-coluna para 2 e depois 1 coluna em dispositivos móveis (<= 544px).

📚 Guias de Referência Inclusos

Carregue estes arquivos de referência quando precisar de trechos CSS concretos, predefinições de tokens ou regras aprofundadas:

  • references/personalities-and-tokens.md: Detalhamento completo das 7 Personalidades de Sites, tabela de mistura de Injeção de Traços e predefinições de Propriedades Personalizadas CSS :root copiáveis (Omnifood, Nexter, Natours, SaaS Moderno).
  • references/ten-design-ingredients.md: Todas as 86 regras de design quantificadas nos 10 Ingredientes (escalas de tipo, sistema de cores, receitas de sombra/raio, regras de UX), com exemplos de código.
  • references/css-architecture-and-layouts.md: Padrões de layout responsivo, padrões de componentes, codificação de layout de página inteira e snippets de @media query.

🧰 Ferramentas Técnicas & Stack (Agente: Use Quando Apropriado)

  • Linguagens: HTML5, CSS3, Sass (SCSS)
  • Layout: Flexbox, CSS Grid, Float (raro), Position
  • Pré-processador: Sass (.scss) com @mixin, @include, @extend, variáveis, nesting, @media, @function
  • CSS Moderno: Propriedades Personalizadas (--variable), clamp(), min(), max(), aspect-ratio, object-fit, min-content, max-content, color-mix(), :has(), @container
  • Ícones: Phosphor Icons, Ionicons, Lucide, Heroicons
  • Fontes: Google Fonts (Inter, Rubik, Playfair Display, Merriweather, Lora, Work Sans, Montserrat, Lato, Plus Jakarta Sans, Cormorant, Quicksand)
  • Extensões CSS: BEM (Block Element Modifier), 8-point grid, Component-First Architecture
  • Ambiente de Build: Parcel.js, Vite, npm-scripts (se aplicável)

⚙️ Configuração Rápida (HTML + CSS Puro, Sem Build)

<!DOCTYPE html>
<html lang="pt">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Seu Site</title>
    <!-- Google Fonts -->
    <link rel="preconnect" href="https://fonts.googleapis.com" />
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
    <link href="https://fonts.googleapis.com/css2?family=Rubik:wght@400;500;600;700&display=swap" rel="stylesheet" />
    <link rel="stylesheet" href="style.css" />
  </head>
  <body>
    <!-- Seu conteúdo semântico HTML5 aqui -->
  </body>
</html>
/* ======== GLOBAL RESET & 62.5% TRICK ======== */
* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

html {
  /* 1rem = 10px: 10px / 16px = 62.5% */
  font-size: 62.5%;
  scroll-behavior: smooth;
}

body {
  font-family: "Rubik", sans-serif;
  font-weight: 400;
  line-height: 1.6;
  color: #555;
}

/* ======== REUSABLE CONTAINER & GRID PRIMITIVES ======== */
.container {
  max-width: 120rem;
  margin: 0 auto;
  padding: 0 3.2rem;
}

.grid {
  display: grid;
  gap: 3.2rem;
}

.grid--2-cols { grid-template-columns: repeat(2, 1fr); }
.grid--3-cols { grid-template-columns: repeat(3, 1fr); }
.grid--4-cols { grid-template-columns: repeat(4, 1fr); }
.grid--center-v { align-items: center; }

/* ======== EXAMPLE SECTION SPACING ======== */
.section-hero { padding: 4.8rem 0 9.6rem 0; }
.section-features { padding: 9.6rem 0; }

/* ======== RESPONSIVE: STEP DOWN ROOT FONT-SIZE ======== */
/* Abaixo de 1200px (Tablets paisagem): reduz 62.5% -> 56.25% => 1rem = 9px */
@media (max-width: 75em) {
  html { font-size: 56.25%; }
}

/* Abaixo de 944px (Tablets retrato): 56.25% -> 50% => 1rem = 8px */
@media (max-width: 59em) {
  html { font-size: 50%; }
}

/* Abaixo de 544px (Telefones): colapsar grid para 1 coluna */
@media (max-width: 34em) {
  .grid--2-cols,
  .grid--3-cols,
  .grid--4-cols {
    grid-template-columns: 1fr;
  }
}

⚠️ Aviso: Sempre carregue references/personalities-and-tokens.md ao discutir ou escolher uma Personalidade de Site. Sempre carregue references/ten-design-ingredients.md ao implementar um novo componente de UI para garantir que as escalas e regras de design sejam seguidas.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas