Communitygithub.com

xzedm/clipplic-landing

Guia para implementar animações suaves e com sensação nativa usando a View Transition API do React (componente `<ViewTransition>`, `addTransitionType` e pseudo-elementos CSS de view transition). Use esta skill sempre que o usuário quiser adicionar transições de página, animar mudanças de rota, criar animações de elementos compartilhados, animar entrada/saída de componentes, reorganizar listas, implementar animações direcionais (para frente/voltar) ou integrar view transitions no Next.js. Use também quando o usuário mencionar view transitions, `startViewTransition`, `ViewTransition`, tipos de transição ou perguntar sobre animação entre estados de UI no React sem bibliotecas de animação de terceiros.

O que é clipplic-landing?

Esta skill ensina a implementar animações nativas e suaves entre estados de UI no React usando a View Transition API do navegador (`document.startViewTransition`), sem necessidade de bibliotecas de terceiros. O guia cobre desde conceitos fundamentais, como o componente `<ViewTransition>` e seus gatilhos de animação (enter, exit, update, share), até padrões avançados como transições de elementos compartilhados, reorganização de listas, animações direcionais e integração com Next.js (incluindo Server Components). A skill prioriza uma abordagem criteriosa: cada animação deve comunicar uma relação espacial ou continuidade, seguindo uma ordem de implementação que vai de elementos compartilhados a mudanças de rota. Suporta navegadores Chromium 111+, Firefox 144+ e Safari 18.2+, com degradação suave. Inclui referências práticas (CSS recipes, padrões, workflow de implementação) e dicas de acessibilidade com motion reduction.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

clipplic-landing preview
clipplic-landing preview

Documentação

View Transitions no React

Anime entre estados de UI usando a API nativa document.startViewTransition do navegador. Declare o que com <ViewTransition>, dispare quando com startTransition / useDeferredValue / Suspense, controle como com classes CSS. Navegadores sem suporte ignoram animações graciosamente.

Quando Animar

Cada <ViewTransition> deve comunicar uma relação espacial ou continuidade. Se você não consegue articular o que ela comunica, não a adicione.

Implemente todos os padrões aplicáveis desta lista, nesta ordem:

PrioridadePadrãoO que comunica
1Elemento compartilhado (name)"Mesma coisa, indo mais fundo"
2Revelação de Suspense"Dados carregados"
3Identidade de lista (key por item)"Mesmos itens, novo arranjo"
4Mudança de estado (enter/exit)"Algo apareceu/desapareceu"
5Mudança de rota (nível de layout)"Indo para um novo lugar"

Esta é uma ordem de implementação, não uma lista de "escolha um". Implemente todo padrão que se encaixar no aplicativo. Só pule um padrão se o aplicativo não tiver caso de uso para ele.

Escolhendo o Estilo de Animação

ContextoAnimaçãoPor quê
Navegação hierárquica (lista → detalhe)nav-forward / nav-back com tipoComunica profundidade espacial
Navegação lateral (aba para aba)<ViewTransition> simples (fade) ou default="none"Sem profundidade a comunicar
Revelação de SuspensePropriedades string enter/exitConteúdo chegando
Revalidação / atualização em segundo planodefault="none"Silenciosa, sem animação necessária

Reserve slides direcionais para navegação hierárquica (lista → detalhe) e sequências ordenadas (foto anterior/próxima, carrossel, resultados paginados). Para sequências ordenadas, a direção comunica posição: "próximo" desliza da direita, "anterior" da esquerda. Navegação lateral/não ordenada (aba para aba) não deve usar slides direcionais. Isso implica falsamente profundidade espacial.


Disponibilidade

  • Next.js: Não instale react@canary: o App Router já inclui React canary internamente. ViewTransition funciona de imediato. npm ls react pode mostrar uma versão aparentemente estável; isso é esperado.
  • Sem Next.js: Instale react@canary react-dom@canary (ViewTransition não está no React estável).
  • Suporte de navegadores: Chromium 111+, Firefox 144+, Safari 18.2+. Degradação graciosa em navegadores sem suporte.

Fluxo de Trabalho de Implementação

Ao adicionar view transitions a um aplicativo existente, siga references/implementation.md passo a passo. Comece pela auditoria, não a pule. Copie as receitas CSS de references/css-recipes.md para a folha de estilos global, não escreva seu próprio CSS de animação.


Conceitos Principais

O Componente <ViewTransition>

import { ViewTransition } from 'react';

<ViewTransition>
  <Component />
</ViewTransition>

O React atribui automaticamente um view-transition-name único e chama document.startViewTransition nos bastidores. Nunca chame startViewTransition manualmente.

Gatilhos de Animação

GatilhoQuando dispara
enter<ViewTransition> é inserido pela primeira vez durante uma Transição
exit<ViewTransition> é removido pela primeira vez durante uma Transição
updateMutações no DOM dentro de um <ViewTransition>. Com VTs aninhados, a mutação se aplica ao mais interno
shareUm VT nomeado desmonta e outro com o mesmo name monta na mesma Transição

Apenas startTransition, useDeferredValue ou Suspense ativam VTs. setState comum não anima.

Regra Crítica de Posicionamento

<ViewTransition> só ativa enter/exit se aparecer antes de qualquer nó DOM:

// Funciona
<ViewTransition enter="auto" exit="auto">
  <div>Conteúdo</div>
</ViewTransition>

// Quebrado: div envolve o VT, suprimindo enter/exit
<div>
  <ViewTransition enter="auto" exit="auto">
    <div>Conteúdo</div>
  </ViewTransition>
</div>

Estilizando com Classes de View Transition

Props

Valores: "auto" (cross-fade do navegador), "none" (desabilitado), "nome-da-classe" (CSS personalizado), ou { [tipo]: valor } para animações específicas por tipo.

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

Se default for "none", todos os gatilhos estão desligados a menos que explicitamente listados.

Pseudo-Elementos CSS

  • ::view-transition-old(.class): snapshot de saída
  • ::view-transition-new(.class): snapshot de entrada
  • ::view-transition-group(.class): contêiner
  • ::view-transition-image-pair(.class): par antigo + novo

Veja references/css-recipes.md para receitas de animação prontas para uso.


Tipos de Transição

Marque transições com addTransitionType para que VTs possam escolher animações diferentes baseadas no contexto. Chame várias vezes para empilhar tipos; VTs diferentes na árvore reagem a tipos diferentes:

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

Passe um objeto para mapear tipos a classes CSS. Funciona em enter, exit e 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 e exit não precisam ser simétricos. Por exemplo, fade in mas slide out direcionalmente:

<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 exige uma chave default no objeto.

Para aplicativos com várias páginas, extraia o VT tipado em um wrapper reutilizável:

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() e Botão Voltar do Navegador

router.back() e os botões voltar/avançar do navegador não disparam view transitions (popstate é síncrono, incompatível com startViewTransition). Use router.push() com uma URL explícita.

Tipos e Suspense

Tipos estão disponíveis durante navegação, mas não durante revelações subsequentes de Suspense (transições separadas, sem tipo). Use mapas de tipo para enter/exit no nível da página; use props string simples para revelações de Suspense.


Transições de Elemento Compartilhado

Mesmo name em dois VTs, um desmontando e outro montando, cria uma transformação de elemento compartilhado:

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

// Na outra view, mesmo nome
<ViewTransition name="hero-image">
  <img src="/full.jpg" />
</ViewTransition>
  • Apenas um VT com um dado name pode estar montado por vez. Use nomes únicos (photo-${id}). Cuidado com componentes reutilizáveis: se um componente com um VT nomeado é renderizado tanto em um modal/popover quanto em uma página, ambos montam simultaneamente e quebram a transformação. Torne o nome condicional (via prop) ou mova o VT nomeado para fora do componente compartilhado para o consumidor específico.
  • share tem precedência sobre enter/exit. Pense em cada caminho de navegação: quando nenhum par correspondente é formado (ex.: a página de destino não tem o mesmo name), enter/exit dispara em vez disso. Considere se o elemento precisa de uma animação de fallback para esses caminhos.
  • Nunca use uma saída fade-out em páginas com transformações compartilhadas. Use um slide direcional.

Padrões Comuns

Entrada/Saída

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

Reorganização de Lista

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

Dispara dentro de startTransition. Evite <div>s wrapper entre a lista e o VT.

Compondo Elementos Compartilhados com Identidade de Lista

Elementos compartilhados e identidade de lista são preocupações independentes, não confunda um com o outro. Quando um item de lista contém um elemento compartilhado (ex.: uma imagem que se transforma em uma view de detalhe), use dois limites <ViewTransition> aninhados:

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

O VT externo lida com a reorganização de lista/entrada. O VT interno lida com a transformação de elemento compartilhado entre rotas. Faltar qualquer camada significa que essa animação silenciosamente não acontece.

Forçar Reentrada com key

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

Cuidado: Se envolver <Suspense>, mudar a key remonta o limite e refaz a busca.

Fallback de Suspense para Conteúdo

Cross-fade simples:

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

Revelação direcional:

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

Para mais padrões, veja references/patterns.md.


Como Múltiplos VTs Interagem

Todo VT que corresponde ao gatilho dispara simultaneamente em um único document.startViewTransition. VTs em diferentes transições (navegação vs resolução posterior de Suspense) não competem.

Use default="none" Generosamente

Sem ele, todo VT dispara o cross-fade do navegador em toda transição. Resolução de Suspense, atualizações de useDeferredValue, revalidações em segundo plano. Sempre use default="none" e habilite explicitamente apenas os gatilhos desejados.

Dois Padrões Coexistem

Padrão A. Slides direcionais: VT tipado em cada página, dispara durante navegação. Padrão B. Revelações de Suspense: Props string simples, dispara quando dados carregam (sem tipo).

Eles coexistem porque disparam em momentos diferentes. default="none" em ambos evita interferência cruzada. Sempre emparelhe enter com exit. Coloque VTs direcionais em componentes de página, não em layouts.

Limitação de VT Aninhado

Quando um VT pai sai, VTs aninhados dentro dele não disparam seus próprios enter/exit; apenas o VT mais externo anima. Animações escalonadas por item durante navegação de página não são possíveis atualmente. Veja react#36135 para uma correção experimental opcional.


Integração com Next.js

Para configuração do Next.js (flag experimental.viewTransition, prop transitionTypes em next/link, padrões do App Router, Server Components), veja references/nextjs.md.


Acessibilidade

Sempre adicione o CSS de movimento reduzido de references/css-recipes.md à sua folha de estilos global.


Arquivos de Referência

  • references/implementation.md: Fluxo de trabalho de implementação passo a passo.
  • references/patterns.md: Padrões, temporização de animação, API de eventos, solução de problemas.
  • references/css-recipes.md: Receitas de animação CSS prontas para uso.
  • references/nextjs.md: Padrões do Next.js App Router e detalhes de Server Component.

Documento Completo Compilado

Para o guia completo com todos os arquivos de referência 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)

Habilidades Relacionadas