Communitygithub.com

xzedm/clipplic-landing

Guía para implementar animaciones suaves y con sensación nativa usando la API View Transition de React (componente `ViewTransition`, `addTransitionType`, y pseudo-elementos CSS de view transitions).

¿Qué es clipplic-landing?

Este skill proporciona una guía completa para implementar la API View Transition nativa del navegador (`document.startViewTransition`) en aplicaciones React, incluyendo Next.js. Explica cómo declarar qué animar con el componente `<ViewTransition>`, cuándo activarlo con `startTransition`, `useDeferredValue` o `Suspense`, y cómo controlar el estilo con clases CSS. Cubre patrones como elementos compartidos, transiciones de ruta, reordenación de listas, revelación de Suspense y animaciones direccionales para navegación jerárquica. El skill enfatiza no depender de librerías de animación de terceros, aprovecha las capacidades nativas del navegador y ofrece degradación suave en navegadores no compatibles. También incluye reglas de accesibilidad, como la animación de movimiento reducido, y enlaces a archivos de referencia detallados para implementación paso a paso, recetas CSS y patrones avanzados.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/vercel-react-view-transitions

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

clipplic-landing preview
clipplic-landing preview

Documentación

Transiciones de Vista en React

Anima entre estados de la interfaz usando la API nativa del navegador document.startViewTransition. Declara qué con <ViewTransition>, activa cuándo con startTransition / useDeferredValue / Suspense, controla cómo con clases CSS. Los navegadores no compatibles omiten las animaciones elegantemente.

Cuándo Animar

Cada <ViewTransition> debe comunicar una relación espacial o continuidad. Si no puedes articular qué comunica, no lo añadas.

Implementa todos los patrones aplicables de esta lista, en este orden:

PrioridadPatrónQué comunica
1Elemento compartido (name)"Lo mismo, yendo más profundo"
2Revelación de Suspense"Datos cargados"
3Identidad de lista (key por elemento)"Mismos elementos, nueva disposición"
4Cambio de estado (enter/exit)"Algo apareció/desapareció"
5Cambio de ruta (a nivel de layout)"Yendo a un nuevo lugar"

Este es un orden de implementación, no una lista de "elige uno". Implementa cada patrón que se ajuste a la aplicación. Solo omite un patrón si la aplicación no tiene caso de uso para él.

Elegir el Estilo de Animación

ContextoAnimaciónPor qué
Navegación jerárquica (lista → detalle)Tipo-clave nav-forward / nav-backComunica profundidad espacial
Navegación lateral (pestaña a pestaña)<ViewTransition> simple (fundido) o default="none"Sin profundidad que comunicar
Revelación de SuspenseProps de cadena enter/exitContenido que llega
Revalidación / actualización en segundo planodefault="none"Silencioso, sin animación necesaria

Reserva los deslizamientos direccionales para navegación jerárquica (lista → detalle) y secuencias ordenadas (foto anterior/siguiente, carrusel, resultados paginados). Para secuencias ordenadas, la dirección comunica la posición: "siguiente" desliza desde la derecha, "anterior" desde la izquierda. La navegación lateral/desordenada (pestaña a pestaña) no debe usar deslizamientos direccionales. Falsamente implica profundidad espacial.


Disponibilidad

  • Next.js: No instales react@canary: el App Router ya incluye React canary internamente. ViewTransition funciona directamente. npm ls react puede mostrar una versión de apariencia estable; esto es esperado.
  • Sin Next.js: Instala react@canary react-dom@canary (ViewTransition no está en React estable).
  • Soporte de navegadores: Chromium 111+, Firefox 144+, Safari 18.2+. Degradación elegante en navegadores no compatibles.

Flujo de Trabajo de Implementación

Al añadir view transitions a una aplicación existente, sigue references/implementation.md paso a paso. Comienza con la auditoría, no la omitas. Copia las recetas CSS de references/css-recipes.md en la hoja de estilos global, no escribas tu propio CSS de animación.


Conceptos Clave

El Componente <ViewTransition>

import { ViewTransition } from 'react';

<ViewTransition>
  <Component />
</ViewTransition>

React asigna automáticamente un view-transition-name único y llama a document.startViewTransition internamente. Nunca llames a startViewTransition tú mismo.

Disparadores de Animación

DisparadorCuándo se activa
enterEl <ViewTransition> se inserta por primera vez durante una Transición
exitEl <ViewTransition> se elimina por primera vez durante una Transición
updateMutaciones del DOM dentro de un <ViewTransition>. Con VTs anidados, la mutación se aplica al más interno
shareUn VT nombrado se desmonta y otro con el mismo name se monta en la misma Transición

Solo startTransition, useDeferredValue o Suspense activan los VTs. Un setState regular no anima.

Regla Crítica de Colocación

<ViewTransition> solo activa enter/exit si aparece antes de cualquier nodo del DOM:

// Funciona
<ViewTransition enter="auto" exit="auto">
  <div>Contenido</div>
</ViewTransition>

// Roto, el div envuelve al VT, suprimiendo enter/exit
<div>
  <ViewTransition enter="auto" exit="auto">
    <div>Contenido</div>
  </ViewTransition>
</div>

Estilizado con Clases de View Transition

Props

Valores: "auto" (fundido cruzado del navegador), "none" (desactivado), "nombre-clase" (CSS personalizado), o { [tipo]: valor } para animaciones específicas por tipo.

<ViewTransition default="none" enter="slide-in" exit="slide-out" share="morph" />

Si default es "none", todos los disparadores están desactivados a menos que se listen explícitamente.

Pseudo-Elementos CSS

  • ::view-transition-old(.clase): instantánea saliente
  • ::view-transition-new(.clase): instantánea entrante
  • ::view-transition-group(.clase): contenedor
  • ::view-transition-image-pair(.clase): par antiguo + nuevo

Consulta references/css-recipes.md para recetas de animación listas para usar.


Tipos de Transición

Etiqueta las transiciones con addTransitionType para que los VTs puedan elegir diferentes animaciones según el contexto. Llámalo varias veces para apilar tipos; diferentes VTs en el árbol reaccionan a diferentes tipos:

startTransition(() => {
  addTransitionType('nav-forward');
  addTransitionType('select-item');
  router.push('/detail/1');
});

Pasa un objeto para mapear tipos a clases CSS. Funciona en enter, exit y share:

<ViewTransition
  enter={{ 'nav-forward': 'slide-from-right', 'nav-back': 'slide-from-left', default: 'none' }}
  exit={{ 'nav-forward': 'slide-to-left', 'nav-back': 'slide-to-right', default: 'none' }}
  share={{ 'nav-forward': 'morph-forward', 'nav-back': 'morph-back', default: 'morph' }}
  default="none"
>
  <Page />
</ViewTransition>

enter y exit no tienen por qué ser simétricos. Por ejemplo, fundido al entrar pero deslizamiento direccional al salir:

<ViewTransition
  enter={{ 'nav-forward': 'fade-in', 'nav-back': 'fade-in', default: 'none' }}
  exit={{ 'nav-forward': 'nav-forward', 'nav-back': 'nav-back', default: 'none' }}
  default="none"
>

TypeScript: ViewTransitionClassPerType requiere una clave default en el objeto.

Para aplicaciones con múltiples páginas, extrae el VT con clave de tipo en un envoltorio reutilizable:

export function DirectionalTransition({ children }: { children: React.ReactNode }) {
  return (
    <ViewTransition
      enter={{ 'nav-forward': 'nav-forward', 'nav-back': 'nav-back', default: 'none' }}
      exit={{ 'nav-forward': 'nav-forward', 'nav-back': 'nav-back', default: 'none' }}
      default="none"
    >
      {children}
    </ViewTransition>
  );
}

router.back() y Botón de Atrás del Navegador

router.back() y los botones de atrás/adelante del navegador no activan view transitions (popstate es síncrono, incompatible con startViewTransition). Usa router.push() con una URL explícita en su lugar.

Tipos y Suspense

Los tipos están disponibles durante la navegación pero no durante revelaciones posteriores de Suspense (transiciones separadas, sin tipo). Usa mapas de tipos para enter/exit a nivel de página; usa props de cadena simples para revelaciones de Suspense.


Transiciones de Elementos Compartidos

El mismo name en dos VTs, uno desmontándose y otro montándose, crea una transformación de elemento compartido:

<ViewTransition name="hero-image">
  <img src="/thumb.jpg" onClick={() => startTransition(() => onSelect())} />
</ViewTransition>

// En la otra vista, mismo nombre
<ViewTransition name="hero-image">
  <img src="/full.jpg" />
</ViewTransition>
  • Solo un VT con un name dado puede estar montado a la vez. Usa nombres únicos (photo-${id}). Cuidado con componentes reutilizables: si un componente con un VT nombrado se renderiza tanto en un modal/popover como en una página, ambos se montan simultáneamente y rompen la transformación. Haz que el nombre sea condicional (mediante una prop) o mueve el VT nombrado fuera del componente compartido al consumidor específico.
  • share tiene prioridad sobre enter/exit. Piensa en cada ruta de navegación: cuando no se forma un par coincidente (por ejemplo, la página de destino no tiene el mismo nombre), se activa enter/exit en su lugar. Considera si el elemento necesita una animación de respaldo para esas rutas.
  • Nunca uses una salida con fundido de desaparición en páginas con transformaciones compartidas. Usa un deslizamiento direccional en su lugar.

Patrones Comunes

Entrar/Salir

{show && (
  <ViewTransition enter="fade-in" exit="fade-out"><Panel /></ViewTransition>
)}

Reordenación de Lista

{items.map(item => (
  <ViewTransition key={item.id}><ItemCard item={item} /></ViewTransition>
))}

Actívalo dentro de startTransition. Evita <div>s envoltorios entre la lista y el VT.

Componer Elementos Compartidos con Identidad de Lista

Los elementos compartidos y la identidad de lista son preocupaciones independientes, no confundas uno con el otro. Cuando un elemento de lista contiene un elemento compartido (por ejemplo, una imagen que se transforma en una vista de detalle), usa dos límites <ViewTransition> anidados:

{items.map(item => (
  <ViewTransition key={item.id}>                                      {/* identidad de lista */}
    <Link href={`/items/${item.id}`}>
      <ViewTransition name={`item-image-${item.id}`} share="morph">   {/* elemento compartido */}
        <Image src={item.image} />
      </ViewTransition>
      <p>{item.name}</p>
    </Link>
  </ViewTransition>
))}

El VT exterior maneja la reordenación de lista/animaciones de entrada. El VT interior maneja la transformación del elemento compartido entre rutas. Si falta cualquiera de las capas, esa animación simplemente no ocurre.

Forzar Re-Entrada con key

<ViewTransition key={searchParams.toString()} enter="slide-up" default="none">
  <ResultsGrid />
</ViewTransition>

Precaución: Si envuelve <Suspense>, cambiar key vuelve a montar el límite y vuelve a obtener datos.

De Fallback de Suspense a Contenido

Fundido cruzado simple:

<ViewTransition>
  <Suspense fallback={<Skeleton />}><Content /></Suspense>
</ViewTransition>

Revelación direccional:

<Suspense fallback={<ViewTransition exit="slide-down"><Skeleton /></ViewTransition>}>
  <ViewTransition enter="slide-up" default="none"><Content /></ViewTransition>
</Suspense>

Para más patrones, consulta references/patterns.md.


Cómo Interactúan Múltiples VTs

Cada VT que coincida con el disparador se activa simultáneamente en un solo document.startViewTransition. Los VTs en diferentes transiciones (navegación vs resolución posterior de Suspense) no compiten.

Usa default="none" Liberalmente

Sin él, cada VT activa el fundido cruzado del navegador en cada transición. Resoluciones de Suspense, actualizaciones de useDeferredValue, revalidaciones en segundo plano. Siempre usa default="none" y habilita explícitamente solo los disparadores deseados.

Dos Patrones Coexisten

Patrón A. Deslizamientos direccionales: VT con clave de tipo en cada página, se activa durante la navegación. Patrón B. Revelaciones de Suspense: Props de cadena simples, se activan cuando los datos cargan (sin tipo).

Coexisten porque se activan en momentos diferentes. default="none" en ambos evita la interferencia cruzada. Siempre empareja enter con exit. Coloca los VTs direccionales en componentes de página, no en layouts.

Limitación de VTs Anidados

Cuando un VT padre sale, los VTs anidados dentro de él no activan su propio enter/exit, solo el VT más externo anima. Las animaciones escalonadas por elemento durante la navegación de página no son posibles hoy. Consulta react#36135 para una corrección experimental opt-in.


Integración con Next.js

Para la configuración de Next.js (bandera experimental.viewTransition, prop transitionTypes en next/link, patrones del App Router, Componentes de Servidor), consulta references/nextjs.md.


Accesibilidad

Siempre añade el CSS de movimiento reducido de references/css-recipes.md a tu hoja de estilos global.


Archivos de Referencia

  • references/implementation.md: Flujo de trabajo de implementación paso a paso.
  • references/patterns.md: Patrones, sincronización de animaciones, API de eventos, solución de problemas.
  • references/css-recipes.md: Recetas CSS de animación listas para usar.
  • references/nextjs.md: Patrones del App Router de Next.js y detalles de Componentes de Servidor.

Documento Completo Compilado

Para la guía completa con todos los archivos de referencia expandidos: AGENTS.md

Individual skills in this repo

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

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

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

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

Skills relacionados