convez.ai
SkillDesign & UIIntermediário
OtherdaysStudio

Springy Motion

OtherdaysStudio/springy-motion

Animações springy e gestos interruptíveis para web e SwiftUI

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill Claude para projetar e implementar animações fisicamente fundamentadas com spring em web (Motion, Framer Motion, CSS) e nativo (SwiftUI). Tanto constrói animações quanto revisa existentes com rubrica de qualidade (performance, continuidade, acessibilidade).

Instalação

$npx convez-ai OtherdaysStudio/springy-motion

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar transições spring, pop-ins e morphs de elementos compartilhados
  • Implementar gestos interruptíveis: swipe-to-dismiss, drag-to-reorder, momentum tracking
  • Micro-interações: feedback de press/hover/tap, tickers de números, staggers
  • Revisar e corrigir animações que sentem-se janky ou sem polish
  • Portar modelos de spring consistentes entre plataformas (duration + bounce)

Veredito

Ferramenta técnica sólida com base em pesquisa (WWDC, Nielsen, RAIL). Excelente para times que querem animações premium e interruptíveis; requer compreensão de spring physics, mas a rubrica de review torna-a acessível até para iniciantes em motion design.

README

A tradução para o português deste README ainda está na fila.

springy-motion

A Claude Code / agent skill for designing and implementing beautiful, springy, physically-grounded motion across web (Motion / Framer Motion + CSS/WAAPI) and native (SwiftUI). It both builds animations and reviews existing ones.

npx skills add OtherdaysStudio/springy-motion

That installs the skill into your project (or ~/.claude/skills/ for global use). Claude picks it up automatically the next session, or invoke it as /springy-motion.

What it does

Give it a motion task and it reaches for the right technique instead of guessing:

  • Spring transitions, pop-in entrances, sheets / trays / drawers, shared-element morphs — physically grounded, interruptible, reduced-motion aware.
  • Gestures — swipe-to-dismiss, drag-to-reorder, rubber-band overscroll, momentum with 1:1 tracking before threshold.
  • Micro-interactions — press/hover/tap feedback, number tickers, hold-to-confirm, direction-aware tabs/routes, text morphs, staggers.
  • Review mode — paste in an animation that "feels off / janky / not premium" and it runs a critique rubric (perf, continuity, interruptibility, frequency, a11y) and returns concrete fixes.

The core idea: one perceptual spring, every platform

Every spring is parameterized by (duration, bounce) — a perceptual model that ports cleanly across:

  • Motion (web): visualDuration + bounce
  • SwiftUI: .spring(duration:bounce:)
  • CSS: a generated linear() easing

Five tuned presets — Snap (0.2/0), Glide (0.5/0), Pop (0.4/0.4), Lively (0.45/0.5), Track (0.35/0.18, gesture release) — tuned empirically in the gallery, not guessed.

Note: the WWDC23 damping formula that circulates online is garbled. The correct conversion is damping = 4π(1−bounce)/duration, stiffness = (2π/duration)², ζ = 1−bounce — verified against Apple's published values.

What's inside

skills/springy-motion/
├── SKILL.md                  # the hub: rules engine, preset table, reference map
├── SOURCES.md                # credits to the source essays (read them)
├── references/               # the knowledge base
│   ├── principles.md         # the motion philosophy + hard-won rules
│   ├── spring-system.md      # the (duration, bounce) model + presets
│   ├── easing.md             # easing curves, when to use which
│   ├── gestures.md           # interruptible gestures, momentum, thresholds
│   ├── timing.md             # verified perceptual thresholds (Nielsen/Doherty/RAIL…)
│   ├── recipes-web.md        # Motion + CSS recipes (morphing, proximity, carousels…)
│   ├── recipes-swiftui.md    # SwiftUI recipes
│   ├── review-checklist.md   # the critique rubric for review mode
│   └── accessibility-perf.md # reduced motion, GPU, backdrop-blur-on-scroll
├── examples/
│   ├── gallery/              # Vite + React + Motion demo gallery
│   └── swiftui/              # SwiftUI spring presets + filmstrip harness
└── assets/                   # verification screenshots

Run the demo gallery

The gallery is the runnable proof — Dynamic Island, wallet stack, a send flow, a proximity dock, hold-to-confirm, springy toggles, and more, plus a spring-verification filmstrip.

cd skills/springy-motion/examples/gallery
npm install
npm run dev

SwiftUI examples run standalone on macOS (no simulator):

cd skills/springy-motion/examples/swiftui
swift SpringFilmstrip.swift

Credits

This skill synthesizes three essays — read them, they're the soul of the craft. Full credits and foundational references are in skills/springy-motion/SOURCES.md:

The essays themselves are not redistributed here — only linked.

License

MIT © Otherdays Studio. Covers the skill's code and documentation; the linked source essays remain the property of their authors.

Ver o original no GitHub

Bom para

Relacionados