Communitygithub.com

Design de Interação

Projete e implemente microinterações, motion design, transições e padrões de feedback do usuário. Use ao adicionar polimento às interações da UI, implementar estados de carregamento ou criar experiências de usuário encantadoras.

O que é Design de Interação?

O Design de Interação é uma habilidade focada em criar experiências de usuário envolventes e intuitivas por meio de animações, feedbacks e transições de estado bem pensadas. Ela é essencial para desenvolvedores e designers que desejam adicionar polimento e refinamento às suas interfaces, cobrindo desde microinterações sutis, como hovers e cliques, até transições de página complexas e gestos como arrastar. A habilidade oferece princípios como movimento proposital e diretrizes de temporização, além de padrões práticos para estados de carregamento, notificações, efeitos ripple e gestos em React com Framer Motion e CSS. Ela também inclui considerações de acessibilidade, como suporte à redução de movimento (`prefers-reduced-motion`), e boas práticas de performance focadas em `transform` e `opacity` para animações suaves a 60 fps. Suportada por plataformas como React (com Framer Motion) e CSS puro, esta skill é ideal para projetos que buscam interações fluidas e feedbacks responsivos, melhorando significativamente a experiência do usuário final.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/interaction-design

Perguntar na sua IA favorita

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

Documentação

O que Design de Interação faz?

Crie interações envolventes e intuitivas por meio de movimento, feedback e transições de estado cuidadosas que melhoram a usabilidade e encantam os usuários.

Quando Usar Esta Habilidade

  • Adicionar microinterações para melhorar o feedback do usuário
  • Implementar transições suaves de página e componente
  • Projetar estados de carregamento e telas esqueleto
  • Criar interações baseadas em gestos
  • Construir sistemas de notificação e toast
  • Implementar interfaces de arrastar e soltar
  • Adicionar animações acionadas por rolagem
  • Projetar estados de hover e foco

Princípios Fundamentais

1. Movimento Proposital

O movimento deve comunicar, não decorar:

  • Feedback: Confirmar que as ações do usuário ocorreram
  • Orientação: Mostrar de onde os elementos vêm e para onde vão
  • Foco: Direcionar a atenção para mudanças importantes
  • Continuidade: Manter o contexto durante as transições

2. Diretrizes de Temporização

DuraçãoCaso de Uso
100-150msMicro-feedback (hovers, cliques)
200-300msPequenas transições (alternadores, menus)
300-500msTransições médias (modais, mudanças de página)
500ms+Animações coreografadas complexas

3. Funções de Suavização

/* Suavizações comuns */
--ease-out: cubic-bezier(0.16, 1, 0.3, 1); /* Desacelerar - entrando */
--ease-in: cubic-bezier(0.55, 0, 1, 0.45); /* Acelerar - saindo */
--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1); /* Ambos - movendo entre */
--spring: cubic-bezier(0.34, 1.56, 0.64, 1); /* Ultrapassar - lúdico */

Início Rápido: Microinteração de Botão

import { motion } from "framer-motion";

export function InteractiveButton({ children, onClick }) {
  return (
    <motion.button
      onClick={onClick}
      whileHover={{ scale: 1.02 }}
      whileTap={{ scale: 0.98 }}
      transition={{ type: "spring", stiffness: 400, damping: 17 }}
      className="px-4 py-2 bg-blue-600 text-white rounded-lg"
    >
      {children}
    </motion.button>
  );
}

Padrões de Interação

1. Estados de Carregamento

Telas Esqueleto: Preserve o layout enquanto carrega

function CardSkeleton() {
  return (
    <div className="animate-pulse">
      <div className="h-48 bg-gray-200 rounded-lg" />
      <div className="mt-4 h-4 bg-gray-200 rounded w-3/4" />
      <div className="mt-2 h-4 bg-gray-200 rounded w-1/2" />
    </div>
  );
}

Indicadores de Progresso: Mostre progresso determinado

function ProgressBar({ progress }: { progress: number }) {
  return (
    <div className="h-2 bg-gray-200 rounded-full overflow-hidden">
      <motion.div
        className="h-full bg-blue-600"
        initial={{ width: 0 }}
        animate={{ width: `${progress}%` }}
        transition={{ ease: "easeOut" }}
      />
    </div>
  );
}

2. Transições de Estado

Alternador com transição suave:

function Toggle({ checked, onChange }) {
  return (
    <button
      role="switch"
      aria-checked={checked}
      onClick={() => onChange(!checked)}
      className={`
        relative w-12 h-6 rounded-full transition-colors duration-200
        ${checked ? "bg-blue-600" : "bg-gray-300"}
      `}
    >
      <motion.span
        className="absolute top-1 left-1 w-4 h-4 bg-white rounded-full shadow"
        animate={{ x: checked ? 24 : 0 }}
        transition={{ type: "spring", stiffness: 500, damping: 30 }}
      />
    </button>
  );
}

3. Transições de Página

Animações de layout do Framer Motion:

import { AnimatePresence, motion } from "framer-motion";

function PageTransition({ children, key }) {
  return (
    <AnimatePresence mode="wait">
      <motion.div
        key={key}
        initial={{ opacity: 0, y: 20 }}
        animate={{ opacity: 1, y: 0 }}
        exit={{ opacity: 0, y: -20 }}
        transition={{ duration: 0.3 }}
      >
        {children}
      </motion.div>
    </AnimatePresence>
  );
}

4. Padrões de Feedback

Efeito ripple ao clicar:

function RippleButton({ children, onClick }) {
  const [ripples, setRipples] = useState([]);

  const handleClick = (e) => {
    const rect = e.currentTarget.getBoundingClientRect();
    const ripple = {
      x: e.clientX - rect.left,
      y: e.clientY - rect.top,
      id: Date.now(),
    };
    setRipples((prev) => [...prev, ripple]);
    setTimeout(() => {
      setRipples((prev) => prev.filter((r) => r.id !== ripple.id));
    }, 600);
    onClick?.(e);
  };

  return (
    <button onClick={handleClick} className="relative overflow-hidden">
      {children}
      {ripples.map((ripple) => (
        <span
          key={ripple.id}
          className="absolute bg-white/30 rounded-full animate-ripple"
          style={{ left: ripple.x, top: ripple.y }}
        />
      ))}
    </button>
  );
}

5. Interações por Gesto

Deslizar para dispensar:

function SwipeCard({ children, onDismiss }) {
  return (
    <motion.div
      drag="x"
      dragConstraints={{ left: 0, right: 0 }}
      onDragEnd={(_, info) => {
        if (Math.abs(info.offset.x) > 100) {
          onDismiss();
        }
      }}
      className="cursor-grab active:cursor-grabbing"
    >
      {children}
    </motion.div>
  );
}

Padrões de Animação CSS

Animações com Keyframes

@keyframes fadeIn {
  from {
    opacity: 0;
    transform: translateY(10px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

@keyframes pulse {
  0%,
  100% {
    opacity: 1;
  }
  50% {
    opacity: 0.5;
  }
}

@keyframes spin {
  to {
    transform: rotate(360deg);
  }
}

.animate-fadeIn {
  animation: fadeIn 0.3s ease-out;
}
.animate-pulse {
  animation: pulse 2s ease-in-out infinite;
}
.animate-spin {
  animation: spin 1s linear infinite;
}

Transições CSS

.card {
  transition:
    transform 0.2s ease-out,
    box-shadow 0.2s ease-out;
}

.card:hover {
  transform: translateY(-4px);
  box-shadow: 0 12px 24px rgba(0, 0, 0, 0.1);
}

Considerações de Acessibilidade

/* Respeitar preferências de movimento do usuário */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}
function AnimatedComponent() {
  const prefersReducedMotion = window.matchMedia(
    "(prefers-reduced-motion: reduce)",
  ).matches;

  return (
    <motion.div
      animate={{ opacity: 1 }}
      transition={{ duration: prefersReducedMotion ? 0 : 0.3 }}
    />
  );
}

Melhores Práticas

  1. Performance Primeiro: Use transform e opacity para 60fps suaves
  2. Suporte a Movimento Reduzido: Sempre respeite prefers-reduced-motion
  3. Temporização Consistente: Use uma escala de temporização em todo o aplicativo
  4. Física Natural: Prefira animações spring em vez de lineares
  5. Interruptível: Permita que os usuários cancelem animações longas
  6. Melhoria Progressiva: Funcione sem animações JS
  7. Teste em Dispositivos: O desempenho varia significativamente

Problemas Comuns

  • Animações Trêmulas: Evite animar width, height, top, left
  • Excesso de Animação: Muito movimento causa fadiga
  • Interações Bloqueantes: Nunca impeça a entrada do usuário durante animações
  • Vazamentos de Memória: Limpe os ouvintes de animação ao desmontar
  • Flash de Conteúdo: Use will-change com moderação para otimização

Recursos

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

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 (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Habilidades Relacionadas