Communitygithub.com

CharbelElBateh/personal-website

El enfoque de Apple para el diseño de interfaces y el movimiento físico y fluido, traducido para la web. Úsalo al construir o revisar interfaces impulsadas por gestos, animaciones con resortes, interacciones de arrastre/deslizamiento/paneles, impulso y transiciones interrumpibles, materiales translúcidos y profundidad, tipografía (tamaño óptico, tracking, interlineado), movimiento reducido o los fundamentos de diseño (retroalimentación, coherencia espacial, moderación) detrás de las interfaces al estilo Apple.

¿Qué es personal-website?

Esta habilidad proporciona una guía completa para implementar interfaces de usuario fluidas y físicamente naturales en la web, inspiradas directamente en las charlas de diseño de Apple (principalmente *Designing Fluid Interfaces* de la WWDC 2018). Traduce los principios de diseño de Apple, como la respuesta inmediata, la manipulación directa con seguimiento 1:1, las animaciones interrumpibles con resortes, y la proyección de impulso, en técnicas prácticas para CSS, Pointer Events, `requestAnimationFrame` y bibliotecas de resortes como Motion/Framer Motion. El resumen central es que una interfaz se siente viva cuando el movimiento comienza desde el valor actual en pantalla, hereda la velocidad del usuario, proyecta el impulso hacia adelante y puede ser agarrada e invertida en cualquier instante. Es útil para desarrolladores que desean mejorar la sensación de sus aplicaciones web con animaciones con resortes, gestión de gestos de arrastre y deslizamiento, materiales translúcidos, y una sensación de profundidad y coherencia espacial. La habilidad incluye ejemplos de código, valores de parámetros concretos (como los que Apple usa para paneles o rotación) y técnicas avanzadas como el rubber-banding y la transferencia de velocidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/apple-design

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Diseño Apple

Respuesta Inicial

Cuando esta habilidad se invoca por primera vez sin una pregunta específica, responde solo con:

Estoy listo para ayudarte a construir interfaces fluidas al estilo Apple en la web. Mi conocimiento proviene de las charlas de diseño de WWDC de Apple, traducidas para la web.

No proporciones ninguna otra información hasta que el usuario haga una pregunta.

Principios Fundamentales

Cómo Apple construye interfaces que dejan de sentirse como una computadora y comienzan a sentirse como una extensión de ti. Este conocimiento proviene de las charlas de diseño de la WWDC de Apple — principalmente Designing Fluid Interfaces (WWDC 2018) — destilado y traducido para la plataforma web (CSS, Pointer Events, requestAnimationFrame, bibliotecas de resortes como Motion/Framer Motion).

El hilo conductor: una interfaz se siente viva cuando el movimiento comienza desde el valor actual en pantalla, hereda la velocidad del usuario, proyecta el impulso hacia adelante y puede ser agarrada e invertida en cualquier instante. Los resortes son la herramienta que hace que todo esto sea natural, porque son inherentemente interrumpibles y conscientes de la velocidad.

La Idea Central

"Cuando alineamos la interfaz con la forma en que pensamos y nos movemos, sucede algo mágico: deja de sentirse como una computadora y comienza a sentirse como una extensión perfecta de nosotros mismos."

Una interfaz es fluida cuando se comporta como el mundo físico: las cosas responden al instante, se mueven continuamente, llevan impulso, resisten en los límites y pueden redirigirse a mitad del movimiento. Todo lo siguiente es una forma de acercarse a eso.

Apple enmarca el diseño como el servicio a cuatro necesidades humanas: seguridad/previsibilidad, comprensión, logro y alegría. Cada regla aquí sirve a una de ellas.

1. Respuesta — eliminar la latencia

En el momento en que aparece el retraso, la sensación de inmediatez "cae por un precipicio". La respuesta es la base sobre la que se construye todo lo demás.

  • Responde al presionar, no al soltar. Resalta un botón en el instante en que se presiona. Esperar al click/levantar el dedo para mostrar retroalimentación se siente muerto.
  • Vigila cada latencia. Audita los rebotes, temporizadores artificiales, esperas de transición y el retraso de tap de ~300ms. Cualquier cosa en la ruta de entrada que no sea esencial es una regresión.
  • La retroalimentación debe ser continua durante la interacción, no solo al final. Para un arrastre, deslizador o panel, actualiza la interfaz de usuario 1:1 con el puntero durante todo el proceso — nunca animar solo cuando el gesto se completa.
/* La retroalimentación vive en la pulsación, y es instantánea */
.button:active {
  transform: scale(0.97);
  transition: transform 100ms ease-out;
}

2. Manipulación directa — seguimiento 1:1

"El toque y el contenido deben moverse juntos."

Cuando el usuario arrastra algo, debe permanecer pegado al dedo — y respetar el desplazamiento desde donde lo agarró. Ajustar al centro del elemento al agarrar rompe la ilusión de inmediato.

  • Usa Pointer Events con setPointerCapture para que el seguimiento continúe incluso cuando el puntero sale de los límites del elemento.
  • Mantén un breve historial de velocidad/posición (últimos eventos pointermove), no solo el punto actual — necesitarás la velocidad al soltar.
el.addEventListener('pointerdown', (e) => {
  el.setPointerCapture(e.pointerId);
  const grabOffset = e.clientY - el.getBoundingClientRect().top; // respeta dónde agarraron
  // ...seguimiento de posición + marca de tiempo para la velocidad
});

3. Interrumpibilidad — el principio más importante

"El pensamiento y el gesto ocurren en paralelo."

Cada animación debe ser interrumpible y redirigible en cualquier momento. Un usuario debe poder agarrar un elemento en movimiento a mitad de vuelo e invertirlo sin esperar a que termine la animación. Un modal que se cierra y que el usuario vuelve a agarrar debe seguir al dedo, no terminar de cerrarse primero y luego reabrirse.

  • Nunca bloquees la entrada durante una transición.
  • Siempre anima desde el valor presentación (actual), nunca el valor objetivo. Al interrumpir, lee la transformación en pantalla en vivo del elemento e inicia la nueva animación desde ahí. Comenzar desde el valor lógico/objetivo provoca un salto visible.
  • Evita las transiciones CSS y @keyframes para cualquier cosa impulsada por gestos — no se pueden agarrar e invertir suavemente a mitad de vuelo. Los resortes animan desde el valor actual por defecto, que es exactamente lo que necesita la interrupción.
  • Cuando un gesto se invierte, mezcla la velocidad — no la cortes bruscamente. Reemplazar una animación con otra en una inversión crea una discontinuidad de velocidad, una "pared de ladrillos". Las bibliotecas de resortes que transfieren la velocidad a través de un reobjetivo lo evitan. (Esto es lo que las animaciones aditivas de iOS hacen de forma nativa; en la web, elige una biblioteca de resortes que reobjetive desde la velocidad actual).
  • Descompón el movimiento 2D en resortes X e Y independientes. Un solo resorte en una distancia 2D se desincroniza cuando X e Y tienen velocidades diferentes.

4. Comportamiento sobre animación — usa resortes

"Piensa en la animación como una conversación entre tú y el objeto, no algo prescrito por la interfaz."

Una animación preprogramada de duración fija no puede responder a nuevas entradas. Un resorte sí puede — una nueva entrada solo cambia el objetivo, y el movimiento se mantiene continuo. Recurre a los resortes para cualquier cosa que un usuario pueda tocar.

Apple reemplazó deliberadamente el trío de física (masa/rigidez/amortiguamiento) con dos parámetros amigables para el diseñador. Piensa en estos:

  • Relación de amortiguamiento — controla el rebasamiento. 1.0 = críticamente amortiguado, sin rebote, asentamiento suave. < 1.0 = rebasa y oscila. Más bajo = más elástico.
  • Respuesta — qué tan rápido alcanza el valor el objetivo, en segundos. Más bajo = más rápido. Esto no es "duración" — un resorte no tiene duración fija; su tiempo de asentamiento surge de los parámetros.

Valores predeterminados:

  • Empieza la mayoría de las UI con amortiguamiento 1.0 (críticamente amortiguado) — elegante y no distractivo.
  • Añade rebote (amortiguamiento ~0.8) solo cuando el gesto en sí mismo llevaba impulso (un golpe, un lanzamiento, una liberación de arrastre). Un rebasamiento en un menú que simplemente apareció se siente mal; un rebasamiento en una tarjeta que lanzaste se siente bien.

Valores concretos que Apple envía:

InteracciónAmortiguamientoRespuesta
Mover / reposicionar (ej. PiP)1.00.4
Rotación0.80.4
Panel / hoja0.80.3

Mapeo web (Motion / Framer Motion): la API de resortes bounce + duration se mapea estrechamente con el amortiguamiento y la respuesta de Apple. Un estilo seguro por defecto es usar resortes con damping: 1.0 en todas partes; reserva el rebote para interacciones físicas impulsadas por impulso.

import { animate } from 'motion';

// Predeterminado críticamente amortiguado (sin rebasamiento)
avigate(el, { y: 0 }, { type: 'spring', bounce: 0, duration: 0.4 });

// Interacción con impulso — un poco de rebote, solo porque lo precedió un golpe
animate(el, { y: target }, { type: 'spring', bounce: 0.2, duration: 0.4 });

5. Transferencia de velocidad — la costura entre arrastre y animación

Cuando un gesto termina, la animación debe continuar a la velocidad exacta del dedo, para que no haya una costura visible entre arrastrar y animar. Este es el detalle que más separa "fluido" de "correcto".

Pasa la velocidad de liberación del puntero como la velocidad inicial del resorte. Algunas API de resortes necesitan velocidad relativa — normalízala por la distancia restante al objetivo:

velocidadRelativa = velocidadGesto / (valorObjetivo − valorActual)

Ejemplo: elemento en y=50, objetivo y=150 (100px por recorrer), dedo moviéndose a 50px/s → velocidad inicial del resorte = 50 / 100 = 0.5. Framer Motion / Motion aceptan la velocidad absoluta en px/s directamente (opción velocity), por lo que normalmente le das el valor bruto.

6. Proyección de impulso — anima hacia dónde se dirige el gesto

"Toma una entrada pequeña y haz una salida grande."

No ajustes al límite más cercano desde el punto de liberación. Usa la velocidad para proyectar la posición de reposo — exactamente como la desaceleración de desplazamiento — luego ajusta al objetivo más cercano a ese punto proyectado. Esto es lo que hace que un golpe se sienta como si lanzara el elemento.

La función de proyección exacta de Apple (del código de muestra de Designing Fluid Interfaces):

// decelerationRate ≈ 0.998 para sensación de desplazamiento normal; 0.99 para más rápido
function project(initialVelocity /* px/s */, decelerationRate = 0.998) {
  return (initialVelocity / 1000) * decelerationRate / (1 - decelerationRate);
}

const projectedEndpoint = currentPosition + project(releaseVelocity);
const target = nearestSnapPoint(projectedEndpoint);   // elegir objetivo desde la proyección
animateSpringTo(target, { velocity: releaseVelocity }); // luego transferir velocidad (§5)

Nota: la fórmula física v²/(2·decel) no es lo que Apple envía — usa la forma de decaimiento exponencial anterior. Este es el comportamiento estándar en buenos paneles inferiores y carruseles (Vaul, Embla).

7. Coherencia espacial — caminos simétricos, orígenes anclados

"Si algo desaparece de una manera, esperamos que emerja de donde vino."

  • Entra y sale por el mismo camino. Un panel que se desliza desde la derecha debe cerrarse hacia la derecha. Entrar desde la derecha / salir por abajo se siente inconexo y confuso.
  • Ancla las interacciones a su origen. Un menú, popover o panel debe originarse desde el elemento que lo activó — establece transform-origin al activador, para que la relación espacial entre el botón y el contenido sea obvia. (Este es el mismo punto de conciencia de origen que los popovers escalan desde su activador, no desde su centro).
  • Refleja la aceleración en transiciones reversibles para que el camino de salida coincida con el de retorno (usa puntos de control cúbicos de Bézier inversos para las dos direcciones).

8. Insinúa en la dirección del gesto

Los humanos predicen un estado final a partir de una trayectoria. El movimiento intermedio debe telegrafiar hacia dónde se dirigen las cosas — los módulos del Centro de Control "crecen hacia arriba y hacia afuera, hacia tu dedo." Haz que los fotogramas intermedios apunten al resultado, no solo interpolen ciegamente hacia él.

9. Efecto de goma — límites suaves

En un borde, resiste progresivamente en lugar de detenerte bruscamente. Una parada brusca se lee como "congelado"; una resistencia continua se lee como "responsive, pero no hay nada más aquí". Aplica un amortiguamiento que aumente cuanto más allá del límite arrastre el usuario.

// Cuanto más allá del límite, menos sigue el elemento — las cosas reales se ralentizan antes de detenerse
function rubberband(overshoot, dimension, constant = 0.55) {
  return (overshoot * dimension * constant) / (dimension + constant * Math.abs(overshoot));
}

10. Detalles de diseño de gestos (la lista de verificación de "sensación")

  • Tap: resalta al presionar (instantáneo), confirma al levantar. Añade ~10px de histéresis/relleno de golpe alrededor del objetivo, y permite cancelar arrastrando hacia afuera y de vuelta.
  • Arrastre/deslizamiento: requiere un pequeño umbral de movimiento (histéresis, ~10px) antes de comprometerse con una dirección, luego sigue 1:1.
  • Detecta todos los gestos plausibles en paralelo desde el primer movimiento, luego cancela con confianza los perdedores una vez que la intención esté clara. Evita los reconocedores que solo informan un estado final (eventos tipo swipeleft) — desechan el seguimiento continuo que necesitas para la retroalimentación.
  • Minimiza los retrasos de desambiguación. La detección de doble tap retrasa inevitablemente los taps simples; solo paga ese costo donde realmente existe el doble tap.

11. Suavidad a nivel de fotograma

La suavidad se trata de lo que hay en los fotogramas, no solo de la tasa de fotogramas.

  • Mantén el cambio posicional por fotograma por debajo del umbral de percepción para evitar el efecto estroboscópico.
  • Para movimientos muy rápidos, un sutil desenfoque de movimiento / estiramiento codifica la velocidad y se lee mejor que un trazo duro y nítido.
  • requestAnimationFrame es el reloj sincronizado con la pantalla de la web (Apple usa CADisplayLink). Anima solo propiedades amigables para el compositor — transform y opacity — e insinúa con will-change donde el movimiento sea inminente.

12. Materiales y profundidad — la translucidez transmite jerarquía

Apple usa materiales translúcidos como una capa funcional flotante que aporta estructura sin robar el foco. En la web, aproxima con backdrop-filter.

  • Construye navegación/barras de herramientas/paneles como capas translúcidas (backdrop-filter: blur() + un fondo semitransparente) con contenido desplazándose debajo — no barras opacas que consuman una franja fija.
  • El peso del material codifica la jerarquía: materiales más oscuros/más pesados separan regiones estructurales (barras laterales); materiales más claros atraen la atención hacia elementos interactivos (botones). Nunca apiles una superficie translúcida clara sobre otra — la legibilidad colapsa.
  • Las superficies más grandes deben leerse como más gruesas: un desenfoque más fuerte + una sombra más profunda que las virutas pequeñas. Considera sombras conscientes del contexto: más pesadas sobre contenido ocupado/texto para separación, más ligeras sobre fondos lisos.
  • Atenúa para enfocar, separa para mantener el flujo. Una tarea modal empareja la superficie con un velo de atenuación y empuja el fondo hacia atrás/abajo. Un panel paralelo y no bloqueante usa translucidez y desplazamiento sin un velo para que no se interrumpa el flujo. Para paneles apilados, atenúa progresivamente y empuja hacia atrás cada capa padre.
  • La vibrancia mantiene el texto legible sobre fondos cambiantes. Sobre superficies borrosas/translúcidas, no uses texto gris plano — usa un contraste más alto, un peso ligeramente más pesado y un pequeño aumento de espaciado entre letras. Pon el color en una capa sólida, no en el frente translúcido.
  • Efectos de borde de desplazamiento, no divisores duros. En lugar de un borde de 1px debajo de un encabezado fijo, desvanece una pequeña máscara de desenfoque/gradiente donde el contenido se encuentra con el cromo flotante — solo donde la interfaz de usuario flotante realmente se superpone al contenido.
  • Materializa, no solo desvanezcas. Para superficies de vidrio/desenfoque, anima el radio de desenfoque y la escala juntos al entrar/salir, para que la superficie se lea como un material real que llega, en lugar de un simple desvanecimiento de opacidad.
.toolbar {
  background: rgba(255, 255, 255, 0.6);
  backdrop-filter: blur(20px) saturate(180%);
  border-top: 1px solid rgba(255, 255, 255, 0.4); /* borde superior brillante = luz que atrapa el material */
}

13. Retroalimentación multimodal — movimiento + sonido + háptica

Tres reglas para combinar sentidos (de Designing Audio-Haptic Experiences):

  1. Causalidad — debe ser obvio qué causó la retroalimentación. Actívala en el evento causal real (el interruptor que cambia, el elemento que encaja en su lugar), y haz coincidir su carácter con la fisicalidad de la acción.
  2. Armonía — lo visual, el sonido y lo háptico deben dispararse en el mismo fotograma. La latencia entre ellos destruye la ilusión. No dejes que un...

Individual skills in this repo

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

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Skills relacionados