Figma Designer
Estas são as regras do próprio designer para trabalhar no Figma. Elas se sobrepõem às habilidades oficiais do Figma e não as substituem.
- Carregue
figma-useantes de qualquer chamadause_figma. Ela contém as regras da API de Plugin (faixas de cores, carregamento de fontes, dimensionamento de layout). Esta skill adiciona apenas regras de design. - Para telas e páginas completas, carregue também
figma-generate-design. Para bibliotecas de componentes e tokens, carregue tambémfigma-generate-library. - Os nomes e valores exatos dos tokens estão na Referência de tokens no final deste arquivo. Leia-a antes de criar ou vincular qualquer variável ou estilo de texto.
Fluxo de trabalho
-
Verifique o arquivo primeiro. Liste as coleções de variáveis locais e estilos de texto, e pesquise nas bibliotecas do arquivo (
search_design_system) por variáveis, estilos e componentes. Reutilize o que existe antes de criar algo. -
Configure as fundações se estiverem faltando. Crie tudo abaixo antes de construir qualquer tela:
- as variáveis
spacingeradius - as duas camadas de cor (
Core Colors, depoisColor Systemcom modos Claro e Escuro) - os estilos de texto
Claro e escuro são modos de variável, nunca dois conjuntos de cores fixas.
- Mostre os tokens na tela. Coloque um frame
Foundationsna páginaFoundations, da mesma forma que os componentes ficam em seu próprio frame. Dentro dele, adicione uma seção de layout automático para cada coleção:Core Colors: uma linha por paleta, uma amostra por tomColor System: uma linha por grupo, com os modos Claro e Escuro lado a lado usando modos de variável explícitos em duas colunasspacing: uma barra por token, dimensionada ao seu valorradius: um quadrado por token, com esse raio- Estilos de texto: uma linha de amostra por estilo
- Vincule as amostras para que elas atualizem com os tokens. Cada preenchimento de amostra está vinculado à sua variável. Cada barra de espaçamento e amostra de raio está vinculada à sua variável. Cada amostra de texto usa seu estilo. Quando o usuário edita um token, o frame se atualiza sozinho.
- Rótulos: cada amostra é rotulada com seu nome de token e, para Color System, seu alias (
Surface/Primary → Grayscale/870). O texto não pode se vincular a um valor de cor, então os rótulos hex não se atualizam sozinhos. Ressincronize os rótulos sempre que criar, renomear ou alterar tokens.
- as variáveis
-
Construa seção por seção. Faça o hero primeiro, depois uma seção por etapa. Nunca construa uma página inteira de uma só vez. Faça uma captura de tela após cada seção e corrija-a antes de prosseguir.
-
Use layout automático em todos os lugares. Todo frame com filhos usa layout automático. Preenchimento e espaçamento são vinculados a variáveis de espaçamento, nunca a números digitados.
-
Vincule, não digite.
- Vincule cada preenchimento, traço, raio, preenchimento e espaçamento a uma variável.
- Cada camada de texto usa um estilo de texto.
- Vincule designs apenas a tokens do
Color System, nunca diretamente aCore Colors.
-
Auto-verifique antes de finalizar. Execute a checklist no final deste arquivo, corrija cada falha e depois relate o que foi construído e o que foi pulado.
Tipografia
- Fontes: qualquer fonte é permitida. Use a que o usuário ou a marca nomear; verifique-a com
figma.listAvailableFontsAsync()antes de carregar. - Uma única família tipográfica por arquivo, a menos que o usuário peça um par. Geist Mono é permitida ao lado da fonte principal apenas para código, dados ou números.
- Sem estilos itálicos. Sem pesos acima de bold.
- Os tamanhos vêm apenas da escala de tipo do Tailwind: 12, 14, 16, 18, 20, 24, 30, 36, 48, 60, 72, 96, 128. Se um tamanho cair entre os degraus, arredonde para o degrau abaixo e use sua altura de linha.
- Estilos de texto. Crie os estilos nomeados na Referência de tokens → Estilos de texto (Heading 1 a 6, Title 1 a 5, Body 1 a 6, Button-lg/md/sm/Xsm, Caption 1 a 5). Use os nomes exatamente, incluindo capitalização.
- Agrupe-os em pastas por tipo, para que o painel leia
Heading / Heading 1,Body / Body 4,Button / Button-md. - Cada camada de texto usa um desses estilos. Nunca defina um tamanho ou peso solto; alterar o peso em uma camada com estilo desvincula o estilo.
- Agrupe-os em pastas por tipo, para que o painel leia
- Qual grupo usar:
- Heading: cabeçalhos de página e seção, do maior ao menor. Heading 1 é o hero.
- Title: títulos de cartão, títulos de itens de lista, rótulos que lideram um bloco, itens de navegação.
- Body: texto corrido. Dentro de cada tamanho, 1 é o peso mais forte e o último é regular.
- Button: texto dentro de botões apenas. Botões principais usam Button-md; botões pequenos de cabeçalho usam Button-sm.
- Caption: metadados, texto de ajuda, badges, timestamps, letras miúdas.
- Novos estilos. Se um projeto precisar de um, adicione o próximo número em seu grupo (por exemplo Body 7), construído a partir de um degrau da escala. Nunca invente um novo nome ou um tamanho fora da escala.
- Cópia:
- Sem hífens dentro do texto.
- Nenhuma palavra sozinha na última linha de um cabeçalho. Quebre os cabeçalhos manualmente em pontos significativos (use uma quebra de linha no texto, não um frame mais estreito).
- O cabeçalho hero (Heading 1) não tem pontos finais, nem no final nem entre frases. Separe duas ideias com uma quebra de linha:
Veja a bagunça/Decida o que consertar, nãoVeja a bagunça. Decida o que consertar.
Espaçamento
- Use apenas as variáveis numéricas
spacing/*: 0, 2, 4, 8, 12, 16, 24, 32, 40, 48, 64, 80, 96. Nada no meio. - Vincule
paddingTop/Right/Bottom/LefteitemSpacinga elas comsetBoundVariable. Dê às variáveis de espaçamento o escopoGAP, que cobre tanto preenchimento quanto espaçamento. - Quando um valor de design cair entre tokens, arredonde para o token mais próximo e vincule-o.
- Botões principais usam 8 de preenchimento vertical (
spacing/75) e 12 horizontal (spacing/100).
Raio de canto
- Use apenas valores de raio do Tailwind (0, 2, 4, 6, 8, 12, 16, 24, full), como variáveis
radius/*com o escopoCORNER_RADIUS. Vincule cada canto (topLeftRadius…). - Regra de raio aninhado. Quando uma forma está dentro de outra e o espaçamento entre elas é inferior a 32:
raio interno = raio externo − espaçamentoAplique-a apenas quando o resultado for maior que 2. Exemplo: um cartão com 16 de raio e 8 de preenchimento dá aos elementos internos 8. - Verifique isso em cada frame aninhado: leia o raio e o preenchimento do pai, calcule o raio do filho e defina-o para a variável
radius/*correspondente.
Cor
Estrutura de token: duas camadas, em todos os arquivos
Os nomes e a estrutura são fixos. Os valores hex seguem a marca do usuário. Lista completa de nomes: Referência de tokens → Cor.
- Coleção
Core Colors: paletas brutas.Primary,Secondary,Accent,Grayscale, e paletas semânticasRed(erro),Green(sucesso) eYellow(aviso).- Cada paleta tem pelo menos 10 tons, de
00(quase branco) a1000(quase preto).500é o matiz base. - Construa os tons a partir das cores base da marca.
- Cores transparentes também ficam aqui, como uma paleta
Grayscale-Alpha(700-16…700-80) com a opacidade armazenada na variável. Um alias não pode adicionar opacidade, entãoOverlay/*cria alias destes.
- Cada paleta tem pelo menos 10 tons, de
- Coleção
Color System: tokens semânticos com modosLighteDark. Cada valor é um alias para uma Core Color, nunca um hex bruto.- Grupos:
Border/,Surface/,Action/,Text/,Icon/,Overlay/. - Cada função tem um token base mais as variantes que precisa:
-Hover,-Clickou-Selected,-Disabled,-Subtle,-Inverted.
- Grupos:
- Designs vinculam-se apenas a tokens do
Color System. Uma reformulação de marca então muda apenasCore Colors. - Nomeie tokens pela função, nunca pela cor bruta (sem
Surface/Blue 500). - Escopo das variáveis para o que elas colorem:
FRAME_FILL/SHAPE_FILLpara superfícies,TEXT_FILLpara texto,STROKE_COLORpara bordas. Nunca deixeALL_SCOPES.
Superfícies
-
Fundos do modo escuro, apenas estes:
#000000·#181818·#1F1F1F·#272727·#313131·#131209 -
Sem gradientes de fundo. As superfícies são planas. Isso inclui botões e sobreposições de fade.
-
O cabeçalho hero é a única exceção de gradiente, no texto apenas, da esquerda para a direita:
- tema escuro
#FFFFFF→#9B9B9B - tema claro
#000000→#666666
Vincule ambas as paradas do gradiente a variáveis de cor (
boundVariables.colorem cada parada) para que o gradiente alterne com o modo. - tema escuro
-
Uma cor de destaque, mantida abaixo de 80% de saturação.
-
As bordas vão ao redor de todo o elemento ou não vão. Nunca uma borda de um único lado em um cartão. Para dividir linhas, use um retângulo de 1px preenchido com um token
Border/*, não um traço de um lado.
Contraste e acessibilidade
- Texto do corpo: pelo menos 4.5:1 contra seu fundo.
- Texto grande (24 e acima, ou 18 negrito e acima) e partes da UI (ícones, bordas de entrada, anéis de foco): pelo menos 3:1.
- Em cabeçalhos com gradiente, verifique o contraste na extremidade mais clara do gradiente, não na mais escura.
- Nunca confie apenas na cor para mostrar o estado. Combine-a com um ícone, rótulo ou mudança de peso.
- Alvos de toque têm pelo menos 44 × 44 em frames móveis.
- Se uma cor da marca falhar no contraste com o texto branco, use um tom mais escuro da mesma paleta para o token
Action/*em vez de alterar o texto.
Layout
- Largura máxima do cabeçalho hero e subtítulo 680.
- Sem tag de sobrancelha (a pequena pílula ou rótulo acima de um cabeçalho, como
● Design QA, não um redesign) por padrão. Adicione uma apenas quando o usuário pedir, ou quando uma imagem de inspiração que o usuário enviou mostrar uma. - Frames desktop têm 1440 de largura, com um contêiner de conteúdo centralizado de 1200 a 1280.
- Adicione frames de 768 e 390 quando a tela precisar de versões responsivas.
- Não padronize três cartões iguais em uma linha. Considere um zigue-zague de duas colunas, uma grade assimétrica ou um layout bento.
- Alinhe elementos compartilhados entre cartões lado a lado: títulos, preços, listas e botões começam no mesmo Y.
Ícones
- Use Phosphor, Solar ou Iconamoon. Nunca Material Icons ou Material Symbols.
- Use um peso de traço em todo o arquivo.
- Importe ícones como SVG (
createNodeFromSvg) e recolorir-os com um tokenIcon/*vinculado. Nunca redesenhe um ícone a partir de primitivas.
Componentes e estados
-
Qualquer coisa usada mais de uma vez é um componente. Exponha seu texto como propriedades de componente.
-
Componentes interativos obtêm variantes para Default, Hover, Pressed, Focus, Disabled. Campos de entrada também obtêm Error e Filled.
-
Botões são um conjunto de componentes com estas duas propriedades, todas as combinações presentes (25 variantes por tamanho):
Type= Primary | Secondary | Tertiary | Error | WarningState= Default | Hover | Pressed | Focus | Disabled
Vincule preenchimentos a
Action/*(por exemploAction/Primary,Action/Primary-Hover,Action/Primary-Click,Action/Primary-Disabled), bordas aBorder/*e rótulos aText/*. Focus adiciona um anel visível (traço externo de 2px com contraste 3:1 ou melhor), não apenas uma mudança de cor. -
Visualizações de dados obtêm estados Loading (um esqueleto com a forma do layout real), Empty (uma visualização de introdução composta) e Error.
Movimento (apenas protótipo)
- Use Smart Animate com a bezier personalizada
0.22, 1, 0.36, 1:- 500ms para mudanças de layout
- 300ms para cor ou opacidade
- Nunca use as predefinições lineares ou de facilitação padrão do Figma.
Conteúdo
- Cópia de rascunho real, nunca texto de espaço reservado.
- Use nomes, marcas e números críveis para a indústria do produto. Evite números suspeitamente redondos e nomes genéricos como "Acme".
- Preenchimento proibido: "revolucionário", "potencializar", "vanguarda", "sem esforço", "transforme seu fluxo de trabalho", "leve ao próximo nível", "aproveite o poder", "classe mundial".
- Uso de letra minúscula para cabeçalhos e botões.
Landing pages
Quando a tarefa for uma landing page, siga também a habilidade landing-page-design do usuário para estrutura de página e cópia (perguntas iniciais, ordem das seções, regras de CTA). Isso inclui a seção obrigatória de tagline grande com uma revelação palavra por palavra, mostrada como uma interação de protótipo. Se essa habilidade não estiver disponível, peça ao usuário por ela antes de planejar as seções.
Higiene do arquivo
- Nomeie cada camada de forma significativa (
Pricing / Card / Pro). Nunca deixeFrame 427,Group 3,VectorouRectangle 1. - Coleções de variáveis:
spacing,radius,Core ColorseColor System, com modosLighteDarkemColor System. - Estilos de texto usam os nomes acima, agrupados em pastas por tipo.
- Uma página por área:
Foundations,Components,Screens. - Coloque novos frames de nível superior em espaço claro da tela, nunca sobre o trabalho existente. Não exclua ou mova as camadas existentes do usuário, a menos que solicitado.
Checklist (execute antes de relatar)
- Cada camada de texto usa um estilo de texto nomeado (Heading, Title, Body, Button, Caption) na escala do Tailwind
- Cada preenchimento e espaçamento está vinculado a uma variável de espaçamento
- Cada raio está vinculado a uma variável de raio, e raios aninhados seguem a fórmula
- Cada preenchimento e traço está vinculado a um token do
Color System(nunca a um hex bruto ou Core Color), e os modos Claro e Escuro funcionam ambos - As paletas Core Colors têm pelo menos 10 tons cada, e cada token do Color System é um alias
- O frame
Foundationsmostra cada token e estilo de texto, com amostras vinculadas às suas variáveis e rótulos sincronizados - O contraste passa 4.5:1 para o corpo e 3:1 para texto grande e partes da UI
- Sem gradientes de fundo, sem bordas de um lado, sem itálico
- Cabeçalho hero e subtítulo limitados a 680, o cabeçalho hero não tem pontos finais, e não há tags de sobrancelha, a menos que solicitado ou mostrado em uma imagem de inspiração enviada
- Componentes interativos têm todas as variantes de estado, e botões têm todos os 5 tipos × 5 estados
- Ícones de Phosphor, Solar ou Iconamoon com um peso de traço
- Sem cópia de espaço reservado, sem camada nomeada
FrameouGroup
Referência de tokens
Os nomes são fixos. Os valores hex de cor seguem a marca do usuário; os valores de espaçamento, raio e tipo são fixos.
Espaçamento
Coleção spacing, um modo, FLOAT, escopo GAP.
| Token | Valor |
|---|---|
| spacing/0 | 0 |
| spacing/25 | 2 |
| spacing/50 | 4 |
| spacing/75 | 8 |
| spacing/100 | 12 |
| spacing/200 | 16 |
| spacing/300 | 24 |
| spacing/400 | 32 |
| spacing/500 | 40 |
| spacing/600 | 48 |
| spacing/700 | 64 |
| spacing/800 | 80 |
| spacing/900 | 96 |
Raio
Coleção radius, um modo, FLOAT, escopo CORNER_RADIUS.
| Token | Valor |
|---|---|
| radius/0 | 0 |
| radius/2 | 2 |
| radius/4 | 4 |
| radius/6 | 6 |
| radius/8 | 8 |
| radius/12 | 12 |
| radius/16 | 16 |
| radius/24 | 24 |
| radius/full | 9999 |
Estilos de texto
A fonte é a única do arquivo.
Heading
| Nome | Tamanho | Peso | Altura da linha |
|---|---|---|---|
| Heading 1 | 72 | Bold | 80 |
| Heading 2 | 60 | Bold | 68 |
| Heading 3 | 48 | Bold | 56 |
| Heading 4 | 36 | Bold | 44 |
| Heading 5 | 30 | Bold | 38 |
| Heading 6 | 24 | Bold | 32 |
Title
| Nome | Tamanho | Peso | Altura da linha |
|---|---|---|---|
| Title 1 | 20 | Bold | 28 |
| Title 2 | 20 | Medium | 28 |
| Title 3 | 18 | Bold | 26 |
| Title 4 | 18 | Medium | 26 |
| Title 5 | 16 | Bold | 24 |
Body
| Nome | Tamanho | Peso | Altura da linha |
|---|---|---|---|
| Body 1 | 16 | Bold | 24 |
| Body 2 | 16 | Medium | 24 |
| Body 3 | 16 | Regular | 24 |
| Body 4 | 14 | Bold | 20 |
| Body 5 | 14 | Medium | 20 |
| Body 6 | 14 | Regular | 20 |
Button
| Nome | Tamanho | Peso | Altura da linha |
|---|---|---|---|
| Button-lg | 18 | Medium | 26 |
| Button-md | 16 | Medium | 24 |
| Button-sm | 14 | Medium | 20 |
| Button-Xsm | 12 | Medium | 16 |
Caption
| Nome | Tamanho | Peso | Altura da linha |
|---|---|---|---|
| Caption 1 | 12 | Bold | 16 |
| Caption 2 | 12 | Medium | 16 |
| Caption 3 | 12 | Regular | 16 |
| Caption 4 | 10 | Medium | 14 |
| Caption 5 | 10 | Regular | 14 |
Cor
Core Colors
Coleção Core Colors, com um modo.
Primary (Primary/00 … Primary/1000)
Secondary (Secondary/00 … Secondary/1000)
Accent (Accent/00 … Accent/1000)
Grayscale (Grayscale/00 … Grayscale/1000)
Red (Red/00 … Red/1000)
Green (Green/00 … Green/1000)
Yellow (Yellow/00 … Yellow/1000)
Grayscale-Alpha (Grayscale-Alpha/700-16 … Grayscale-Alpha/700-80)
Color System
Coleção Color System, com modos Light e Dark.
Border/ — Border/Primary, Border/Secondary, Border/Subtle, Border/Hover, Border/Disabled, Border/Error
Surface/ — Surface/Primary, Surface/Secondary, Surface/Tertiary, Surface/Subtle, Surface/Inverted, Surface/Hover, Surface/Click
Action/ — Action/Primary, Action/Primary-Hover, Action/Primary-Click, Action/Primary-Disabled, Action/Secondary, Action/Secondary-Hover, Action/Secondary-Click, Action/Secondary-Disabled, Action/Tertiary, Action/Tertiary-Hover, Action/Tertiary-Click, Action/Tertiary-Disabled, Action/Error, Action/Error-Hover, Action/Error-Click, Action/Error-Disabled, Action/Warning, Action/Warning-Hover, Action/Warning-Click, Action/Warning-Disabled
Text/ — Text/Primary, Text/Secondary, Text/Subtle, Text/Inverted, Text/Disabled, Text/Link, Text/Error, Text/Warning, Text/Success
Icon/ — Icon/Primary, Icon/Secondary, Icon/Subtle, Icon/Inverted, Icon/Disabled, Icon/Accent, Icon/Error, Icon/Warning, Icon/Success
Overlay/ — Overlay/Subtle, Overlay/Medium, Overlay/Heavy