Communitygithub.com

Sistema de Movimento v4.2

Sistema de movimento de UI pronto para produção para React/Next.js. Use ao implementar animações, transições ou padrões de movimento.

O que é Sistema de Movimento v4.2?

Este skill fornece um sistema de movimento de UI completo e pronto para produção para React e Next.js, focado em desempenho, acessibilidade e usabilidade, em vez de decoração. Ele orienta os desenvolvedores sobre quando e como usar animações para guiar a atenção, comunicar estados e preservar a continuidade espacial, com diretrizes claras para evitar movimentos puramente decorativos ou que prejudiquem a usabilidade. O sistema oferece tokens de movimento reutilizáveis (durações, curvas de easing, distâncias), regras de desempenho (animar apenas transform e opacity), detecção de dispositivos de baixo desempenho e suporte a acessibilidade via `useReducedMotion` e CSS. Inclui padrões essenciais para hover, tap, scroll e transições de layout com `AnimatePresence`, além de explicar como configurar modais com foco, escape e bloqueio de rolagem. Suporta projetos modernos (`motion/react`) e legados (`framer-motion`), com instruções claras para evitar a mistura dos pacotes. O skill também aborda segurança SSR, depuração de problemas comuns (importação errada, falta de `"use client"`, hidratação) e anti-padrões, garantindo que as animações sejam sempre funcionais e acessíveis. Projetado para agentes de IA como Claude Code, Cursor e Codex, este skill (da coleção Cody-W-Tucker/skills) fornece um guia prático e opinativo para implementar movimento de alta qualidade em aplicações React/Next.js, com exemplos de código completos e prontos para uso.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cody-W-Tucker/skills/tree/HEAD/skills/motion-ui

Perguntar na sua IA favorita

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

Documentação

O que Sistema de Movimento v4.2 faz?

Sistema de movimento de UI pronto para produção para React / Next.js.

Focado em desempenho, acessibilidade e usabilidade — não em decoração.

Quando Usar

Use este sistema de movimento quando o movimento:

  • Guia a atenção (ex.: onboarding, ações principais)
  • Comunica estado (carregamento, sucesso, erro, transições)
  • Preserva a continuidade espacial (mudanças de layout, navegação)

Cenários Apropriados

  • Componentes interativos (botões, modais, menus)
  • Transições de estado (carregando → carregado, aberto → fechado)
  • Navegação e continuidade de layout (elementos compartilhados, crossfade)

Considerações

  • Acessibilidade: Sempre suportar movimento reduzido
  • Adaptação de dispositivo: Ajustar para dispositivos de baixo desempenho
  • Compensações de desempenho: Preferir responsividade em vez de suavidade visual

Evite Usar Movimento Quando

  • É puramente decorativo
  • Reduz a usabilidade ou clareza
  • Impacta o desempenho negativamente

Como Funciona

Princípio Central

O movimento deve:

  • Guiar a atenção
  • Comunicar estado
  • Preservar a continuidade espacial

Se não fizer nada disso → remova-o.


Instalação

npm install motion

Versão

  • motion/react - padrão para projetos Motion for React atuais (pacote: motion)
  • framer-motion - caminho de importação legado para projetos que ainda dependem do Framer Motion

Não misture. Misturar causa conflitos internos de agendadores e contextos AnimatePresence quebrados — componentes de um pacote não coordenarão animações de saída com componentes do outro.

Para verificar qual versão seu projeto usa:

cat package.json | grep -E '"motion"|"framer-motion"'

Sempre importe de uma única fonte de forma consistente:

// Correto (moderno)
import { motion, AnimatePresence } from "motion/react"

// Correto (legado)
import { motion, AnimatePresence } from "framer-motion"

// Nunca misture ambos no mesmo projeto

Tokens de Movimento

// motionTokens.ts
export const motionTokens = {
  duration: {
    fast: 0.18,
    normal: 0.35,
    slow: 0.6
  },
  // Use estes como valor `ease` dentro de um objeto `transition`:
  // transition={{ duration: motionTokens.duration.normal, ease: motionTokens.easing.smooth }}
  easing: {
    smooth: [0.22, 1, 0.36, 1] as [number, number, number, number],
    sharp:  [0.4,  0, 0.2, 1] as [number, number, number, number]
  },
  distance: {
    sm: 8,
    md: 16,
    lg: 24
  }
}

Exemplo de uso:

import { motionTokens } from "@/lib/motionTokens"

<motion.div
  initial={{ opacity: 0, y: motionTokens.distance.md }}
  animate={{ opacity: 1, y: 0 }}
  transition={{
    duration: motionTokens.duration.normal,
    ease: motionTokens.easing.smooth
  }}
/>

Regras de Desempenho

Seguro

  • transform
  • opacity

Evite

  • width / height
  • top / left

Regra: responsividade > suavidade


Adaptação de Dispositivo

A heurística combina a contagem de núcleos da CPU e a memória disponível para um sinal mais confiável. deviceMemory está disponível no Chrome/Android; o fallback cobre Safari e Firefox.

const isLowEnd =
  typeof navigator !== "undefined" && (
    // Pouca memória (Chrome/Android apenas; undefined em outros lugares → tratar como capaz)
    (navigator.deviceMemory !== undefined && navigator.deviceMemory <= 2) ||
    // Poucos núcleos E sem API de memória (cobre Safari/Firefox em hardware fraco)
    (navigator.deviceMemory === undefined && navigator.hardwareConcurrency <= 4)
  )

const duration = isLowEnd ? 0.2 : 0.4

Acessibilidade

JS (useReducedMotion)

import { motion, useReducedMotion } from "motion/react"

export function FadeIn() {
  const reduce = useReducedMotion()

  return (
    <motion.div
      initial={{ opacity: 0, y: reduce ? 0 : 24 }}
      animate={{ opacity: 1, y: 0 }}
    />
  )
}

CSS

@media (prefers-reduced-motion: reduce) {
  .motion-safe-transition {
    transition: opacity 0.2s;
  }

  .motion-reduce-transform {
    transform: none !important;
  }
}

Tailwind

<div class="motion-safe:animate-fade motion-reduce:opacity-100"></div>

Arquitetura e Padrões

Padrões Centrais

CenárioPadrão
Feedback de hoverwhileHover
Feedback de toque/pressionarwhileTap
Revelar ao scrollwhileInView
Valor vinculado ao scrolluseScroll + useTransform
Montagem/desmontagem condicionalAnimatePresence
Pequenas mudanças de layout (elemento único, < ~300px de alteração)Propriedade layout
Grandes mudanças de layout ou reflow de página inteiraEvite layout; use transições CSS ou roteamento a nível de página
Sequências imperativas complexasuseAnimate

Por que evitar layout em contêineres grandes? A animação de layout do Framer usa transform para reconciliar posições, mas em elementos que abrangem toda a viewport ou acionam reflow profundo, o custo de medição causa jank visível e CLS. Prefira transições CSS Grid/Flexbox ou coordene com layoutId apenas em elementos filhos específicos.

Layout e Transições

  • Transições de elemento compartilhado → layoutId (deve ser único por instância montada)
  • Transições de entrada/saída → AnimatePresence (veja orientação mode abaixo)

Modo mode do AnimatePresence

Sempre especifique mode explicitamente — o padrão ("sync") executa entrada e saída simultaneamente, o que causa sobreposição visual na maioria dos padrões de UI.

modeQuando usar
"wait"A saída termina antes da entrada começar. Use para modais, toasts, transições de página.
"sync" (padrão)Entrada e saída se sobrepõem. Use apenas quando a sobreposição for intencional (ex.: carrosséis crossfade).
"popLayout"O elemento de saída é removido do fluxo imediatamente; os itens restantes animam para preencher o espaço. Use para listas, abas, cartões descartáveis.
// Modal — sempre use "wait"
<AnimatePresence mode="wait">
  {open && <Modal key="modal" />}
</AnimatePresence>

// Item de lista descartável — use "popLayout"
<AnimatePresence mode="popLayout">
  {items.map(item => <Card key={item.id} />)}
</AnimatePresence>

Padrões Avançados (Conceitos)

  • Parallax (transformações vinculadas ao scroll)
  • Contação de histórias com scroll (seções fixas)
  • Inclinação 3D (transformações baseadas no ponteiro)
  • Crossfade (layoutId compartilhado)
  • Revelação progressiva (clip-path)
  • Carregamento skeleton (opacidade em loop)
  • Micro-interações (feedback de hover/toque)
  • Sistema de mola (movimento baseado em física)

Essenciais de Modal

  • Foco armadilhado (focus trap)
  • Fechar com Escape
  • Bloqueio de rolagem
  • Papéis ARIA
  • Use AnimatePresence mode="wait" para que a animação de saída termine antes da próxima modal entrar

Exemplo Completo

import React, { useEffect, useRef, useState } from "react"
import { motion, AnimatePresence } from "motion/react"

function useFocusTrap(ref: React.RefObject<HTMLDivElement | null>, active: boolean) {
  useEffect(() => {
    if (!active || !ref.current) return
    const el = ref.current
    const focusable = el.querySelectorAll<HTMLElement>(
      'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'
    )
    const first = focusable[0]
    const last  = focusable[focusable.length - 1]

    function handleKey(e: KeyboardEvent) {
      if (e.key !== "Tab") return
      if (e.shiftKey && document.activeElement === first) {
        e.preventDefault()
        last?.focus()
      } else if (!e.shiftKey && document.activeElement === last) {
        e.preventDefault()
        first?.focus()
      }
    }

    el.addEventListener("keydown", handleKey)
    first?.focus()
    return () => el.removeEventListener("keydown", handleKey)
  }, [active, ref])
}

function useScrollLock(active: boolean) {
  useEffect(() => {
    if (!active) return
    const prev = document.body.style.overflow
    document.body.style.overflow = "hidden"
    return () => { document.body.style.overflow = prev }
  }, [active])
}

function Modal({ open, closeModal }: { open: boolean; closeModal: () => void }) {
  const ref = useRef<HTMLDivElement>(null)

  useFocusTrap(ref, open)
  useScrollLock(open)

  useEffect(() => {
    function onKey(e: KeyboardEvent) {
      if (e.key === "Escape") closeModal()
    }
    if (open) window.addEventListener("keydown", onKey)
    return () => window.removeEventListener("keydown", onKey)
  }, [open, closeModal])

  return (
    // mode="wait" garante que a animação de saída termine antes de qualquer nova modal entrar
    <AnimatePresence mode="wait">
      {open && (
        <motion.div
          role="dialog"
          aria-modal="true"
          aria-labelledby="modal-title"
          initial={{ opacity: 0 }}
          animate={{ opacity: 1 }}
          exit={{ opacity: 0 }}
          transition={{ duration: 0.2 }}
          className="fixed inset-0 flex items-center justify-center bg-black/40"
        >
          <motion.div
            ref={ref}
            initial={{ scale: 0.95, opacity: 0 }}
            animate={{ scale: 1,    opacity: 1 }}
            exit={{    scale: 0.95, opacity: 0 }}
            transition={{ duration: 0.2, ease: [0.22, 1, 0.36, 1] }}
            className="bg-white p-6 rounded"
          >
            <h2 id="modal-title">Título do Diálogo</h2>
            <button onClick={closeModal}>Fechar</button>
          </motion.div>
        </motion.div>
      )}
    </AnimatePresence>
  )
}

export function Example() {
  const [open, setOpen] = useState(false)

  return (
    <>
      <button onClick={() => setOpen(true)}>Abrir</button>
      <Modal open={open} closeModal={() => setOpen(false)} />
    </>
  )
}

Segurança SSR

  • Corresponder estados iniciais entre renderizações do servidor e do cliente
  • Evitar origens de animação implícitas (sempre defina initial explicitamente)
  • Envolver componentes motion em "use client" no Next.js App Router

Depuração

Verifique:

  • Importação errada (misturando motion/react e framer-motion)
  • Diretiva "use client" ausente no Next.js App Router
  • Propriedade key ausente nos filhos de AnimatePresence
  • Incompatibilidade de hidratação (estado inicial difere entre SSR e cliente)
  • Uso indevido da propriedade layout em contêineres grandes causando jank de reflow
  • Animação orientada por estado não acionando (verifique arrays de dependência)

QA

  • Sem CLS
  • Teclado funciona
  • Foco preso em modais
  • Papéis ARIA corretos (role="dialog", aria-modal="true")
  • Movimento reduzido respeitado (useReducedMotion + media query CSS)
  • Sem avisos de hidratação no Next.js
  • Animações param limpa e suavemente ao desmontar (sem vazamentos de memória)
  • mode do AnimatePresence definido explicitamente em todos os locais de uso

Anti-Padrões

  • Animar propriedades de layout (width, height, top, left)
  • Animações infinitas sem propósito (sempre pergunte: que estado isso comunica?)
  • Escalonamento excessivo de listas (mantenha staggerChildren ≤ 0.1s; além disso parece lento)
  • Ignorar preferências de movimento reduzido
  • Usar layout em contêineres grandes ou de viewport inteira
  • Omitir mode em AnimatePresence (padrão "sync" causa sobreposição visual)
  • Usar movimento puramente para decoração

Filosofia

Movimento é design de interação.


Regra Final

Se o movimento não melhorar a UX → remova-o.


Exemplos

Interação de Botão

import { motion } from "motion/react"

export function Button() {
  return (
    <motion.button
      whileHover={{ scale: 1.02 }}
      whileTap={{ scale: 0.97 }}
      transition={{ duration: 0.15, ease: [0.4, 0, 0.2, 1] }}
    >
      Clique aqui
    </motion.button>
  )
}

Exemplo com Movimento Reduzido

import { motion, useReducedMotion } from "motion/react"

export function FadeIn() {
  const reduce = useReducedMotion()

  return (
    <motion.div
      initial={{ opacity: 0, y: reduce ? 0 : 24 }}
      animate={{ opacity: 1, y: 0 }}
      transition={{ duration: reduce ? 0.1 : 0.35, ease: [0.22, 1, 0.36, 1] }}
    />
  )
}

Lista com Escalonamento

import { motion } from "motion/react"

const container = {
  hidden: {},
  visible: {
    transition: { staggerChildren: 0.08 } // mantenha ≤ 0.1s para evitar lentidão
  }
}

const item = {
  hidden:  { opacity: 0, y: 10 },
  visible: { opacity: 1, y: 0,  transition: { duration: 0.3, ease: [0.22, 1, 0.36, 1] } }
}

export function List() {
  return (
    <motion.ul variants={container} initial="hidden" animate="visible">
      {[1, 2, 3].map(i => (
        <motion.li key={i} variants={item}>Item {i}</motion.li>
      ))}
    </motion.ul>
  )
}

Modal com AnimatePresence

import { motion, AnimatePresence } from "motion/react"

export function Modal({ open }: { open: boolean }) {
  return (
    <AnimatePresence mode="wait">
      {open && (
        <motion.div
          initial={{ opacity: 0, scale: 0.95 }}
          animate={{ opacity: 1, scale: 1    }}
          exit={{    opacity: 0, scale: 0.95 }}
          transition={{ duration: 0.2, ease: [0.22, 1, 0.36, 1] }}
        />
      )}
    </AnimatePresence>
  )
}

Parallax com Scroll

import { useScroll, useTransform, motion } from "motion/react"

export function Parallax() {
  const { scrollYProgress } = useScroll()
  const y = useTransform(scrollYProgress, [0, 1], [0, -80])

  return <motion.div style={{ y }} />
}

Carregamento Skeleton

import { motion } from "motion/react"

export function Skeleton() {
  return (
    <motion.div
      className="bg-gray-200 h-6 w-full rounded"
      animate={{ opacity: [0.5, 1, 0.5] }}
      transition={{
        duration: 1.5,       // pulsação confortável — estava faltando, causava flash rápido
        repeat: Infinity,
        ease: "easeInOut"
      }}
    />
  )
}

Layout Compartilhado (Crossfade)

import { motion } from "motion/react"

// layoutId deve ser único por instância montada.
// Se várias instâncias podem existir simultaneamente, anexe um id único:
// layoutId={`shared-${item.id}`}
export function Shared() {
  return <motion.div layoutId="shared" />
}

Individual skills in this repo

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

Cody-W-Tucker/skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says landing page, post-click experience, landing page audit, conversion rate, or landing page optimization.

Cody-W-Tucker/skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 28 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says TikTok Ads, TikTok marketing, TikTok Shop, Spark Ads, Smart+, or TikTok campaign.

Cody-W-Tucker/skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, Demand Gen, and Connected TV formats. Covers VAC→Demand Gen migration, Shorts creative requirements, and CTV shoppable ads. Use when user says YouTube Ads, video ads, pre-roll, bumper ads, YouTube campaign, Shorts ads, or CTV ads.

Cody-W-Tucker/skills

Craft the story that makes investors say \"I want in.\" Master the narrative structure that Reid Hoffman, Sequoia, and top founders use to raise capital. Use when: **Preparing to fundraise** to develop your story before the deck; **Investor meetings** to structure conversations that convert; **Pitch practice** to refine your narrative arc; **Cold outreach** to write compelling investor emails; **Pivoting** to reframe your story after a change

Cody-W-Tucker/skills

Identify the best GTM motions and tools across 7 motion types: Inbound, Outbound, Paid Digital, Community, Partners, ABM, and PLG. Use when selecting marketing channels, choosing between inbound and outbound strategy, or planning cross-channel campaigns.

Cody-W-Tucker/skills

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

Cody-W-Tucker/skills

Optimize landing pages for maximum conversions using proven frameworks from Unbounce and Oli Gardner—apply the \"one goal, one message, one action\" principle with data-driven design, copy, and CTA best practices. Use when: **Create a new landing page** for a campaign; **Optimize an existing landing page** that isn't converting; **Review landing page design** before launch; **Improve form conversion rates** on lead gen pages; **A/B test landing page elements** systematically

Cody-W-Tucker/skills

Advanced motion patterns for React / Next.js — drag & drop, gestures, text animations, SVG path drawing, custom hooks, imperative sequences (useAnimate), loaders, and the full API decision tree. Requires motion-foundations.

Cody-W-Tucker/skills

Motion tokens, spring presets, performance rules, device adaptation, accessibility enforcement, and SSR safety for React / Next.js using motion/react. Foundation layer — all other motion skills depend on this.

Cody-W-Tucker/skills

A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video poster", "title card", or pairs Open Claude Design with HyperFrames for a kinetic export.

Cody-W-Tucker/skills

Production-ready animation patterns for React / Next.js — button, modal, toast, stagger, page transitions, exit animations, scroll, and layout — built on motion-foundations tokens and springs.

Cody-W-Tucker/skills

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

Cody-W-Tucker/skills

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

Cody-W-Tucker/skills

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Master April Dunford's 8-step sales narrative from \"Sales Pitch\" (2023). Transform your positioning into a compelling story that wins enterprise deals. Use when: Structuring B2B sales presentations and demos; Creating pitch decks for complex products; Training sales teams on narrative-driven selling; Converting positioning strategy into sales conversations; Winning against entrenched competitors

Cody-W-Tucker/skills

Swiss-style user-research narrative template in warm-paper editorial aesthetics. Use when users ask for a premium research deck or story-first live artifact with minimalist typography, high-clarity layout, subtle motion, donut breakdowns, and keyboard/click navigation across slides in a single HTML file.

Cody-W-Tucker/skills

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

Cody-W-Tucker/skills

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

Habilidades Relacionadas