Figma Designer
Estas son las reglas propias del diseñador para trabajar en Figma. Se superponen a las habilidades oficiales de Figma y no las reemplazan.
- Carga
figma-useantes de cualquier llamadause_figma. Contiene las reglas de la API de plugins (rangos de color, carga de fuentes, dimensiones de layout). Esta habilidad solo añade reglas de diseño. - Para pantallas y páginas completas, carga también
figma-generate-design. Para bibliotecas de componentes y tokens, carga tambiénfigma-generate-library. - Los nombres y valores exactos de los tokens están en Referencia de tokens al final de este archigo. Léelo antes de crear o vincular cualquier variable o estilo de texto.
Flujo de trabajo
-
Revisa el archivo primero. Lista las colecciones de variables locales y los estilos de texto, y busca en las bibliotecas del archivo (
search_design_system) variables, estilos y componentes. Reutiliza lo que exista antes de crear algo nuevo. -
Configura las bases si faltan. Crea todo lo siguiente antes de construir cualquier pantalla:
- las variables de
spacingyradius - las dos capas de color (
Core Colors, luegoColor Systemcon modos Claro y Oscuro) - los estilos de texto
Claro y oscuro son modos de variable, nunca dos conjuntos de colores hardcodeados.
- Muestra los tokens en el lienzo. Coloca un frame
Foundationsen la páginaFoundations, de la misma manera que los componentes están en su propio frame. Dentro de él, añade una sección de auto layout para cada colección:Core Colors: una fila por paleta, un color por tonoColor System: una fila por grupo, con los modos Claro y Oscuro lado a lado usando modos de variable explícitos en dos columnasspacing: una barra por token, dimensionada a su valorradius: un cuadrado por token, con ese radio- Estilos de texto: una línea de muestra por estilo
- Vincula las muestras para que se actualicen con los tokens. Cada color de relleno está vinculado a su variable. Cada barra de espaciado y cada muestra de radio está vinculada a su variable. Cada muestra de texto usa su estilo. Cuando el usuario edita un token, el marco se actualiza solo.
- Etiquetas: cada muestra está etiquetada con su nombre de token y, para Color System, su alias (
Surface/Primary → Grayscale/870). El texto no puede vincularse a un valor de color, por lo que las etiquetas hexadecimales no se actualizan solas. Vuelve a sincronizar las etiquetas cada vez que crees, renombres o cambies tokens.
- las variables de
-
Construye sección por sección. Haz primero el hero, luego una sección por paso. Nunca construyas una página completa en una sola pasada. Toma captura de pantalla después de cada sección y corrígela antes de continuar.
-
Usa auto layout en todas partes. Todos los frames con hijos usan auto layout. El padding y el gap están vinculados a variables de espaciado, nunca a números escritos.
-
Vincula, no escribas.
- Vincula cada relleno, trazo, radio, padding y gap a una variable.
- Cada capa de texto utiliza un estilo de texto.
- Vincula los diseños solo a tokens de
Color System, nunca directamente aCore Colors.
-
Autoverificación antes de finalizar. Ejecuta la lista de verificación al final de este archivo, corrige cada fallo, luego informa qué se construyó y qué se omitió.
Tipografía
- Fuentes: cualquier fuente está permitida. Usa la que el usuario o la marca nombre; verifícala con
figma.listAvailableFontsAsync()antes de cargarla. - Una sola tipografía por archivo a menos que el usuario pida un par. Geist Mono está permitida junto a la fuente principal solo para código, datos o números.
- Sin estilos itálicos. Sin pesos por encima de negrita.
- Los tamaños provienen solo de la escala tipográfica de Tailwind: 12, 14, 16, 18, 20, 24, 30, 36, 48, 60, 72, 96, 128. Si un tamaño cae entre pasos, redondea al paso inferior y usa su altura de línea.
- Estilos de texto. Crea los estilos nombrados en Referencia 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). Usa los nombres exactamente, incluyendo mayúsculas.
- Agrúpalos en carpetas por tipo, para que el panel muestre
Heading / Heading 1,Body / Body 4,Button / Button-md. - Cada capa de texto usa uno de estos estilos. Nunca establezcas un tamaño o peso suelto; cambiar el peso en una capa con estilo desvincula el estilo.
- Agrúpalos en carpetas por tipo, para que el panel muestre
- Qué grupo usar:
- Heading: encabezados de página y sección, de mayor a menor. Heading 1 es el hero.
- Title: títulos de tarjetas, títulos de elementos de lista, etiquetas que encabezan un bloque, elementos de navegación.
- Body: texto corrido. Dentro de cada tamaño, 1 es el peso más fuerte y el último es regular.
- Button: texto dentro de botones únicamente. Los botones principales usan Button-md; los botones pequeños de encabezado usan Button-sm.
- Caption: metadatos, texto de ayuda, insignias, marcas de tiempo, letra pequeña.
- Nuevos estilos. Si un proyecto necesita uno, añade el siguiente número en su grupo (por ejemplo Body 7), construido a partir de un paso de escala. Nunca inventes un nombre nuevo o un tamaño fuera de escala.
- Copia:
- Sin guiones dentro del texto.
- Sin una sola palabra sola en la última línea de un encabezado. Divide los encabezados manualmente en puntos significativos (usa un salto de línea en el texto, no un frame más estrecho).
- El encabezado hero (Heading 1) no tiene puntos, ni al final ni entre frases. Separa dos ideas con un salto de línea:
See the slop/Decide what to fix, noSee the slop. Decide what to fix.
Espaciado
- Usa solo las variables numéricas
spacing/*: 0, 2, 4, 8, 12, 16, 24, 32, 40, 48, 64, 80, 96. Nada intermedio. - Vincula
paddingTop/Right/Bottom/LefteitemSpacinga ellas consetBoundVariable. Asigna a las variables de espaciado el ámbitoGAP, que cubre tanto el padding como el gap. - Cuando un valor de diseño caiga entre tokens, redondea al token más cercano y vincúlalo.
- Los botones principales usan 8 de padding vertical (
spacing/75) y 12 horizontal (spacing/100).
Radio de esquina
- Usa solo los valores de radio de Tailwind (0, 2, 4, 6, 8, 12, 16, 24, full), como variables
radius/*con el ámbitoCORNER_RADIUS. Vincula cada esquina (topLeftRadius…). - Regla de radio anidado. Cuando una forma está dentro de otra y el espacio entre ellas es menor de 32:
radio interior = radio exterior − espacioAplícala solo cuando el resultado sea mayor que 2. Ejemplo: una tarjeta con radio 16 y padding 8 da a los elementos interiores un radio 8. - Verifica esto en cada frame anidado: lee el radio y el padding del padre, calcula el radio del hijo y establécela a la variable
radius/*correspondiente.
Color
Estructura de tokens: dos capas, en cada archivo
Los nombres y la estructura son fijos. Los valores hexadecimales siguen la marca del usuario. Lista completa de nombres: Referencia de tokens → Color.
- Colección
Core Colors: paletas en bruto.Primary,Secondary,Accent,Grayscale, y las paletas semánticasRed(error),Green(éxito) yYellow(advertencia).- Cada paleta tiene al menos 10 tonos, desde
00(casi blanco) hasta1000(casi negro).500es el tono base. - Construye los tonos a partir de los colores base de la marca.
- Los colores transparentes también viven aquí, como una paleta
Grayscale-Alpha(700-16…700-80) con la opacidad almacenada en la variable. Un alias no puede añadir opacidad, por lo queOverlay/*alias a estos.
- Cada paleta tiene al menos 10 tonos, desde
- Colección
Color System: tokens semánticos con modosLightyDark. Cada valor es un alias a un Core Color, nunca un hexadecimal en bruto.- Grupos:
Border/,Surface/,Action/,Text/,Icon/,Overlay/. - Cada rol tiene un token base más las variantes que necesita:
-Hover,-Clicko-Selected,-Disabled,-Subtle,-Inverted.
- Grupos:
- Los diseños se vinculan solo a tokens de
Color System. Un cambio de marca entonces solo modificaCore Colors. - Nombra los tokens por rol, nunca por color en bruto (no
Surface/Blue 500). - Limita el ámbito de las variables a lo que colorean:
FRAME_FILL/SHAPE_FILLpara superficies,TEXT_FILLpara texto,STROKE_COLORpara bordes. Nunca dejesALL_SCOPES.
Superficies
-
Fondos en modo oscuro, solo estos:
#000000·#181818·#1F1F1F·#272727·#313131·#131209 -
Sin degradados de fondo. Las superficies son planas. Esto incluye botones y superposiciones de desvanecimiento.
-
El encabezado hero es la única excepción de degradado, solo en el texto, de izquierda a derecha:
- tema oscuro
#FFFFFF→#9B9B9B - tema claro
#000000→#666666
Vincula ambas paradas del degradado a variables de color (
boundVariables.coloren cada parada) para que el degradado cambie con el modo. - tema oscuro
-
Un color de acento, mantenido por debajo del 80% de saturación.
-
Los bordes van completamente alrededor o no van. Nunca un borde de un solo lado en una tarjeta. Para dividir filas, usa un rectángulo de 1 px relleno con un token
Border/*, no un trazo de un solo lado.
Contraste y accesibilidad
- Texto del cuerpo: al menos 4.5:1 contra su fondo.
- Texto grande (24 y más, o 18 negrita y más) y partes de UI (iconos, bordes de entrada, anillos de enfoque): al menos 3:1.
- En encabezados con degradado, verifica el contraste en el extremo más claro del degradado, no en el más oscuro.
- Nunca confíes solo en el color para mostrar el estado. Combínalo con un icono, etiqueta o cambio de peso.
- Los objetivos táctiles tienen al menos 44 × 44 en frames móviles.
- Si un color de marca falla el contraste con texto blanco, usa un tono más oscuro de la misma paleta para el token
Action/*en lugar de cambiar el texto.
Layout
- Ancho máximo del encabezado hero y subtítulo 680.
- Sin etiqueta de ceja (la pequeña píldora o etiqueta sobre un encabezado, como
● Design QA, not a redesign) por defecto. Añádela solo cuando el usuario lo pida, o cuando una imagen de inspiración que el usuario haya subido muestre una. - Los frames de escritorio tienen 1440 de ancho, con un contenedor de contenido centrado de 1200 a 1280.
- Añade frames de 768 y 390 cuando la pantalla necesite versiones responsivas.
- No predetermines tres tarjetas iguales en una fila. Considera un zigzag de dos columnas, una cuadrícula asimétrica o un diseño bento.
- Alinea elementos compartidos en tarjetas lado a lado: títulos, precios, listas y botones comienzan en la misma Y.
Iconos
- Usa Phosphor, Solar o Iconamoon. Nunca Material Icons o Material Symbols.
- Usa un solo grosor de trazo en todo el archivo.
- Importa los iconos como SVG (
createNodeFromSvg) y recoloréalos con un tokenIcon/*vinculado. Nunca redibujes un icono desde primitivas.
Componentes y estados
-
Cualquier cosa que se use más de una vez es un componente. Expón su texto como propiedades del componente.
-
Componentes interactivos obtienen variantes para Default, Hover, Pressed, Focus, Disabled. Las entradas también obtienen Error y Filled.
-
Botones son un conjunto de componentes con estas dos propiedades, cada combinación presente (25 variantes por tamaño):
Type= Primary | Secondary | Tertiary | Error | WarningState= Default | Hover | Pressed | Focus | Disabled
Vincula los rellenos a
Action/*(por ejemploAction/Primary,Action/Primary-Hover,Action/Primary-Click,Action/Primary-Disabled), los bordes aBorder/*y las etiquetas aText/*. Focus añade un anillo visible (trazo exterior de 2 px con una relación de contraste de 3:1 o mejor), no solo un cambio de color. -
Vistas de datos obtienen estados Loading (un esqueleto con la forma del layout real), Empty (una vista de inicio compuesta) y Error.
Movimiento (solo prototipo)
- Usa Smart Animate con el bezier personalizado
0.22, 1, 0.36, 1:- 500 ms para cambios de layout
- 300 ms para color u opacidad
- Nunca uses los ajustes preestablecidos lineales o de facilidad predeterminados de Figma.
Contenido
- Copia real en borrador, nunca texto de relleno.
- Usa nombres, marcas y números creíbles para la industria del producto. Evita cifras sospechosamente redondas y nombres de stock como «Acme».
- Relleno prohibido: «revolucionar», «potenciar», «vanguardia», «sin esfuerzo», «transforma tu flujo de trabajo», «lleva al siguiente nivel», «aprovechar el poder», «de clase mundial».
- Mayúscula inicial para encabezados y botones.
Landing pages
Cuando la tarea sea una landing page, sigue también la habilidad landing-page-design del usuario para la estructura de la página y la copia (preguntas de ingesta, orden de las secciones, reglas de CTA). Eso incluye la gran sección de lema obligatoria con una revelación palabra por palabra, mostrada como una interacción de prototipo. Si esa habilidad no está disponible, pídele al usuario que la proporcione antes de planificar las secciones.
Higiene del archivo
- Nombra cada capa de manera significativa (
Pricing / Card / Pro). Nunca dejesFrame 427,Group 3,VectoroRectangle 1. - Colecciones de variables:
spacing,radius,Core ColorsyColor System, con modosLightyDarkenColor System. - Los estilos de texto usan los nombres anteriores, agrupados en carpetas por tipo.
- Una página por área:
Foundations,Components,Screens. - Coloca los nuevos frames de nivel superior en espacio claro del lienzo, nunca sobre el trabajo existente. No elimines ni muevas las capas existentes del usuario a menos que se te pida.
Lista de verificación (ejecutar antes de informar)
- Cada capa de texto usa un estilo de texto nombrado (Heading, Title, Body, Button, Caption) en la escala Tailwind
- Cada padding y gap está vinculado a una variable de espaciado
- Cada radio está vinculado a una variable de radio, y los radios anidados siguen la fórmula
- Cada relleno y trazo está vinculado a un token de
Color System(nunca un hexadecimal en bruto o un Core Color), y los modos Claro y Oscuro funcionan ambos - Las paletas de Core Colors tienen al menos 10 tonos cada una, y cada token de Color System es un alias
- El frame
Foundationsmuestra cada token y estilo de texto, con muestras vinculadas a sus variables y etiquetas sincronizadas - El contraste pasa 4.5:1 para el cuerpo y 3:1 para texto grande y partes de UI
- Sin degradados de fondo, sin bordes de un solo lado, sin itálicas
- Encabezado hero y subtítulo limitados a 680, el encabezado hero no tiene puntos, y no hay etiquetas de ceja a menos que se pidan o se muestren en una imagen de inspiración subida
- Los componentes interactivos tienen todas las variantes de estado, y los botones tienen todos los 5 tipos × 5 estados
- Iconos de Phosphor, Solar o Iconamoon con un solo grosor de trazo
- Sin copia de relleno, sin capa llamada
FrameoGroup
Referencia de tokens
Los nombres son fijos. Los valores hexadecimales de color siguen la marca del usuario; los valores de espaciado, radio y tipo son fijos.
Espaciado
Colección spacing, un modo, FLOAT, ámbito 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 |
Radio
Colección radius, un modo, FLOAT, ámbito 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
La fuente es la única del archivo, de la escala Tailwind. Los nombres exactos son:
- Heading: Heading 1, Heading 2, Heading 3, Heading 4, Heading 5, Heading 6
- Title: Title 1, Title 2, Title 3, Title 4, Title 5
- Body: Body 1, Body 2, Body 3, Body 4, Body 5, Body 6
- Button: Button-lg, Button-md, Button-sm, Button-Xsm
- Caption: Caption 1, Caption 2, Caption 3, Caption 4, Caption 5
Cada estilo usa el tamaño de fuente de la escala Tailwind correspondiente y la altura de línea predeterminada para ese tamaño. Los Heading y Title usan un peso de fuente más fuerte; Body usa el peso regular (el último de su grupo es regular); Button usa un peso medio o negrita según el tamaño. Las alturas de línea no están tokenizadas, pero deben ser consistentes en todo el archivo para el mismo estilo.
Color
Colección Core Colors, un modo, ámbito ALL_SCOPES (aunque se espera que los tokens se usen con ámbitos específicos en la práctica).
Paletas y tonos mínimos:
- Primary: 00, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
- Secondary: 00, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
- Accent: 00, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
- Grayscale: 00, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
- Red: 100, 200, 300, 400, 500, 600, 700, 800, 900
- Green: 100, 200, 300, 400, 500, 600, 700, 800, 900
- Yellow: 100, 200, 300, 400, 500, 600, 700, 800, 900
- Grayscale-Alpha: 700-16, 700-32, 700-48, 700-64, 700-80
Colección Color System, modos Light y Dark, ámbito según corresponda.
Estructura de grupos (cada grupo tiene tokens base más variantes -Hover, -Click/-Selected, -Disabled, -Subtle, -Inverted según sea necesario):
- Border/
- Border/Primary
- Border/Secondary
- Border/Subtle
- Border/Error
- Border/Disabled
- Surface/
- Surface/Primary
- Surface/Secondary
- Surface/Accent
- Surface/Error
- Surface/Warning
- Surface/Success
- Surface/Disabled
- 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/Accent
- Text/Error
- Text/Warning
- Text/Disabled
- Text/Inverted
- Icon/
- Icon/Primary
- Icon/Secondary
- Icon/Accent
- Icon/Disabled
- Icon/Inverted
- Overlay/
- Overlay/Hover
- Overlay/Click
- Overlay/Dim
Cada token en Color System es un alias a un token en Core Colors (por ejemplo, Surface/Primary puede ser un alias a Grayscale/870 en modo Claro y Grayscale/100 en modo Oscuro).