Las reglas de diseño de Apple, para tu IA

Guía · @vanlookeren

Las reglas de diseño de Apple, para tu IA

Apple publica las reglas y los recursos con que diseña sus apps. Hay una skill para Claude que se los enseña a tu IA, con los números sacados de las tablas de Apple. Qué trae, cómo instalarla y todos los links.

La skill y los recursos, gratis github.com/fvanlookeren-bit/apple-design-resources → Licencia MIT. Instrucciones de instalación abajo.

Lo que Apple publica

Dos lugares. Las reglas están en la Human Interface Guidelines (la HIG). Los archivos para diseñar, en Apple Design Resources:

Ojo con las licencias

Las fuentes de Apple solo se pueden usar para maquetas de apps de sus plataformas: no se sirven como fuente web. Los marcos de dispositivos tienen sus propias reglas de marketing. Lee la licencia de cada archivo antes de usarlo.

Qué le enseña la skill a tu IA

Una skill es un archivo de instrucciones que Claude Code carga cuando trabaja en algo relacionado. Esta junta, en 20 secciones, lo que Apple enseña en sus charlas de diseño y en la HIG, traducido a la web:

Algunos números que trae
Resorte por defecto
damping 1.0 · response 0,3–0,4 s
Control en iOS (por defecto / mínimo)
44 × 44 / 28 × 28 pt
Texto en iOS (por defecto / mínimo)
17 / 11 pt
Contraste de texto hasta 17 pt
4,5:1

Los números no los inventa

La skill trae los valores de la HIG como 144 variables de CSS, más las mismas para Tailwind v3 y v4. Un script las genera leyendo las tablas de Apple, así que ningún valor está escrito a mano:

Paso a paso

  1. Baja la skill

    git clone https://github.com/fvanlookeren-bit/apple-design-resources.git
    mkdir -p ~/.claude/skills
    cp -R apple-design-resources/apple-design ~/.claude/skills/
  2. Úsala en Claude Code

    Claude Code la carga solo cuando trabajas en una interfaz. También la puedes llamar con /apple-design, por ejemplo para revisar una pantalla que ya tienes.

  3. Suma los tokens a tu web

    @import "./apple-hig-tokens.css";
    
    .titulo {
      font-size: var(--hig-ios-title-1-size);
      letter-spacing: var(--hig-ios-title-1-tracking);
    }
    .boton { background: rgb(var(--hig-blue)); }

    Son opcionales: no cambian nada de tu diseño hasta que los usas.

  4. Actualízalos cuando Apple cambie la HIG

    El repo trae el comando que baja las tablas de nuevo y el script que regenera los tres archivos. Están en el README.

Lo que aprendí usándola

Los tokens están en producción en vanlookstudio.com y en el dashboard que uso con mis clientes. Tres cosas que te ahorran errores:

01 · El espaciado de letras es el de SF

Los valores de espaciado de la HIG son para la fuente del sistema de Apple. Con Inter, Geist u otra fuente no sirven: úsalos solo con system-ui.

02 · En SF, los títulos grandes no se aprietan

El consejo de siempre es achicar el espaciado en los títulos grandes. Las tablas de Apple dicen lo contrario para SF: desde 24 pt vuelve a ser positivo. La skill lo trae corregido.

03 · Todo botón necesita estado de presión

La HIG pide que cada botón reaccione al apretarlo. Un botón sin estado de presión es la razón más común de que una web se sienta muerta.