Communitygithub.com

xzedm/clipplic-landing

Guide pour implémenter des animations fluides et naturelles avec l'API View Transition de React (composant `<ViewTransition>`, `addTransitionType` et pseudo-éléments CSS de transition de vue). Utilisez cette compétence chaque fois que l'utilisateur souhaite ajouter des transitions de page, animer des changements de route, créer des animations d'éléments partagés, animer l'entrée/sortie de composants, réorganiser des listes, implémenter des animations de navigation directionnelle (avant/arrière) ou intégrer des transitions de vue dans Next.js.

Qu'est-ce que clipplic-landing ?

Cette compétence fournit un guide complet pour utiliser l'API View Transition native du navigateur (`document.startViewTransition`) dans React, sans bibliothèques tierces. Elle explique comment déclarer ce qui doit être animé avec le composant `<ViewTransition>`, déclencher les animations avec `startTransition`/`useDeferredValue`/`Suspense`, et contrôler le rendu avec des classes CSS personnalisées. Le guide couvre plusieurs plateformes : Next.js (App Router) intègre nativement React canary, tandis que les autres environnements nécessitent `react@canary`. Un navigateur compatible (Chromium 111+, Firefox 144+, Safari 18.2+) est requis, avec dégradation élégante pour les autres. La compétence définit cinq motifs d'animation prioritaires (élément partagé, révélation Suspense, identité de liste, changement d'état, changement de route) et explique comment les combiner. Elle détaille l'utilisation des types de transition via `addTransitionType` pour des animations contextuelles (navigation avant/arrière, sélection), les règles de placement critique du composant, et l'interaction entre plusieurs `<ViewTransition>` simultanés. Une attention particulière est portée à l'accessibilité (mouvement réduit) et à la non-symétrie des animations d'entrée et de sortie.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

clipplic-landing preview
clipplic-landing preview

Documentation

Transitions de Vue React

Animez entre les états d'interface en utilisant le document.startViewTransition natif du navigateur. Déclarez quoi avec <ViewTransition>, déclenchez quand avec startTransition / useDeferredValue / Suspense, contrôlez comment avec des classes CSS. Les navigateurs non pris en charge ignorent les animations avec élégance.

Quand Animer

Chaque <ViewTransition> doit communiquer une relation spatiale ou une continuité. Si vous ne pouvez pas articuler ce qu'il communique, ne l'ajoutez pas.

Implémentez tous les motifs applicables de cette liste, dans cet ordre :

PrioritéMotifCe qu'il communique
1Élément partagé (name)"Même chose, plus en profondeur"
2Révélation Suspense"Données chargées"
3Identité de liste (key par élément)"Mêmes éléments, nouvel agencement"
4Changement d'état (enter/exit)"Quelque chose est apparu/disparu"
5Changement de route (au niveau de la mise en page)"Aller vers un nouvel endroit"

C'est un ordre d'implémentation, pas une liste "choisissez-en un". Implémentez chaque motif qui correspond à l'application. Ne sautez un motif que si l'application n'a aucun cas d'usage pour celui-ci.

Choix du Style d'Animation

ContexteAnimationPourquoi
Navigation hiérarchique (liste → détail)Type-clé nav-forward / nav-backCommunique la profondeur spatiale
Navigation latérale (onglet à onglet)<ViewTransition> simple (fondu) ou default="none"Pas de profondeur à communiquer
Révélation SuspenseProps de chaîne enter/exitContenu arrivant
Revalidation / rafraîchissement en arrière-plandefault="none"Silencieux, aucune animation nécessaire

Réservez les glissements directionnels pour la navigation hiérarchique (liste → détail) et les séquences ordonnées (photo précédente/suivante, carrousel, résultats paginés). Pour les séquences ordonnées, la direction communique la position : "suivant" glisse depuis la droite, "précédent" depuis la gauche. La navigation latérale/non ordonnée (onglet à onglet) ne doit pas utiliser de glissements directionnels. Cela suggère faussement une profondeur spatiale.


Disponibilité

  • Next.js : N'installez pas react@canary : l'App Router inclut déjà React canary en interne. ViewTransition fonctionne directement. npm ls react peut afficher une version stable ; c'est normal.
  • Sans Next.js : Installez react@canary react-dom@canary (ViewTransition n'est pas dans la version stable de React).
  • Support navigateur : Chromium 111+, Firefox 144+, Safari 18.2+. Dégradation élégante sur les navigateurs non pris en charge.

Flux de Travail d'Implémentation

Lors de l'ajout de transitions de vue à une application existante, suivez references/implementation.md étape par étape. Commencez par l'audit, ne le sautez pas. Copiez les recettes CSS de references/css-recipes.md dans la feuille de style globale, n'écrivez pas votre propre CSS d'animation.


Concepts Fondamentaux

Le Composant <ViewTransition>

import { ViewTransition } from 'react';

<ViewTransition>
  <Component />
</ViewTransition>

React attribue automatiquement un view-transition-name unique et appelle document.startViewTransition en coulisses. N'appelez jamais startViewTransition vous-même.

Déclencheurs d'Animation

DéclencheurQuand il se déclenche
enter<ViewTransition> inséré pour la première fois lors d'une Transition
exit<ViewTransition> supprimé pour la première fois lors d'une Transition
updateMutations DOM à l'intérieur d'un <ViewTransition>. Avec des VT imbriqués, la mutation s'applique au plus profond
shareVT nommé démonté et un autre avec le même name monté dans la même Transition

Seuls startTransition, useDeferredValue, ou Suspense activent les VT. Les setState réguliers n'animent pas.

Règle de Placement Critique

<ViewTransition> n'active l'entrée/sortie que s'il apparaît avant tout nœud DOM :

// Fonctionne
<ViewTransition enter="auto" exit="auto">
  <div>Contenu</div>
</ViewTransition>

// Cassé, div enveloppe le VT, supprimant l'entrée/sortie
<div>
  <ViewTransition enter="auto" exit="auto">
    <div>Contenu</div>
  </ViewTransition>
</div>

Stylisation avec les Classes de Transition de Vue

Props

Valeurs : "auto" (fondu croisé du navigateur), "none" (désactivé), "nom-classe" (CSS personnalisé), ou { [type]: valeur } pour des animations spécifiques au type.

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

Si default est "none", tous les déclencheurs sont désactivés sauf s'ils sont explicitement listés.

Pseudo-Éléments CSS

  • ::view-transition-old(.class) : instantané sortant
  • ::view-transition-new(.class) : instantané entrant
  • ::view-transition-group(.class) : conteneur
  • ::view-transition-image-pair(.class) : paire ancien + nouveau

Voir references/css-recipes.md pour des recettes d'animation prêtes à l'emploi.


Types de Transition

Taguez les transitions avec addTransitionType afin que les VT puissent choisir différentes animations selon le contexte. Appelez-le plusieurs fois pour empiler les types, différents VT dans l'arbre réagissent à différents types :

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

Passez un objet pour mapper les types aux classes CSS. Fonctionne sur enter, exit, et 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 et exit n'ont pas à être symétriques. Par exemple, fondu à l'entrée mais glissement directionnel à la sortie :

<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 nécessite une clé default dans l'objet.

Pour les applications avec plusieurs pages, extrayez le VT typé-clé dans un wrapper réutilisable :

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() et le Bouton Retour du Navigateur

router.back() et les boutons retour/avant du navigateur ne déclenchent pas les transitions de vue (popstate est synchrone, incompatible avec startViewTransition). Utilisez plutôt router.push() avec une URL explicite.

Types et Suspense

Les types sont disponibles pendant la navigation mais pas pendant les révélations Suspense ultérieures (transitions séparées, pas de type). Utilisez les mappages de types pour les entrées/sorties au niveau de la page ; utilisez des props de chaîne simples pour les révélations Suspense.


Transitions d'Éléments Partagés

Même name sur deux VT, l'un se démontant, l'autre se montant, crée un morphing d'élément partagé :

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

// Sur l'autre vue, même nom
<ViewTransition name="hero-image">
  <img src="/full.jpg" />
</ViewTransition>
  • Un seul VT avec un name donné peut être monté à la fois. Utilisez des noms uniques (photo-${id}). Attention aux composants réutilisables : si un composant avec un VT nommé est rendu à la fois dans une modale/popover et une page, les deux se montent simultanément et cassent le morphing. Soit rendez le nom conditionnel (via une prop), soit déplacez le VT nommé hors du composant partagé vers le consommateur spécifique.
  • share a priorité sur enter/exit. Réfléchissez à chaque chemin de navigation : lorsqu'aucune paire correspondante ne se forme (par exemple, la page cible n'a pas le même nom), enter/exit se déclenche à la place. Considérez si l'élément a besoin d'une animation de repli pour ces chemins.
  • N'utilisez jamais une sortie avec fondu disparaissant sur des pages avec des morphings partagés. Utilisez plutôt un glissement directionnel.

Motifs Courants

Entrée/Sortie

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

Réorganisation de Liste

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

Déclenchez à l'intérieur de startTransition. Évitez les <div> enveloppes entre la liste et le VT.

Composition d'Éléments Partagés avec Identité de Liste

Les éléments partagés et l'identité de liste sont des préoccupations indépendantes, ne confondez pas l'un pour l'autre. Lorsqu'un élément de liste contient un élément partagé (par exemple, une image qui se transforme en vue détaillée), utilisez deux limites <ViewTransition> imbriquées :

{items.map(item => (
  <ViewTransition key={item.id}>                                      {/* identité de liste */}
    <Link href={`/items/${item.id}`}>
      <ViewTransition name={`item-image-${item.id}`} share="morph">   {/* élément partagé */}
        <Image src={item.image} />
      </ViewTransition>
      <p>{item.name}</p>
    </Link>
  </ViewTransition>
))}

Le VT externe gère la réorganisation de liste/les animations d'entrée. Le VT interne gère le morphing d'élément partagé inter-route. L'absence de l'une ou l'autre couche signifie que cette animation ne se produit pas silencieusement.

Forcer la Ré-entrée avec key

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

Prudence : Si vous enveloppez <Suspense>, changer key remonte la limite et relance le chargement.

Suspense du Fallback au Contenu

Fondu croisé simple :

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

Révélation directionnelle :

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

Pour plus de motifs, voir references/patterns.md.


Comment Plusieurs VT Interagissent

Chaque VT correspondant au déclencheur se déclenche simultanément dans un seul document.startViewTransition. Les VT dans des transitions différentes (navigation vs résolution Suspense ultérieure) ne sont pas en concurrence.

Utilisez default="none" Libéralement

Sans cela, chaque VT déclenche le fondu croisé du navigateur sur chaque transition. Résolution Suspense, mises à jour useDeferredValue, revalidations en arrière-plan. Utilisez toujours default="none" et activez explicitement uniquement les déclencheurs souhaités.

Deux Motifs Coexistent

Motif A. Glissements directionnels : VT typé-clé sur chaque page, se déclenche pendant la navigation. Motif B. Révélations Suspense : Props de chaîne simples, se déclenche lorsque les données sont chargées (pas de type).

Ils coexistent car ils se déclenchent à des moments différents. default="none" sur les deux empêche les interférences croisées. Associez toujours enter avec exit. Placez les VT directionnels dans les composants de page, pas dans les mises en page.

Limitation des VT Imbriqués

Lorsqu'un VT parent sort, les VT imbriqués à l'intérieur ne déclenchent pas leur propre entrée/sortie, seul le VT le plus externe anime. Les animations décalées par élément pendant la navigation de page ne sont pas possibles aujourd'hui. Voir react#36135 pour un correctif expérimental.


Intégration Next.js

Pour la configuration Next.js (drapeau experimental.viewTransition, prop transitionTypes sur next/link, motifs App Router, Server Components), voir references/nextjs.md.


Accessibilité

Ajoutez toujours le CSS de mouvement réduit de references/css-recipes.md à votre feuille de style globale.


Fichiers de Référence

  • references/implementation.md : Flux de travail d'implémentation étape par étape.
  • references/patterns.md : Motifs, timing d'animation, API d'événements, dépannage.
  • references/css-recipes.md : Recettes CSS d'animation prêtes à l'emploi.
  • references/nextjs.md : Motifs de l'App Router Next.js et détails des Server Components.

Document Complet Compilé

Pour le guide complet avec tous les fichiers de référence développés : 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 associés