Communitygithub.com

hacimertgokhan/geomotion

Crie animações de linhas desenhadas à mão com efeito de 'tinta fervente' e preenchimentos estilo risografia a partir de formas simples, exportando como SVG animado, Lottie JSON, HTML ou links compartilháveis.

O que é geomotion?

Geomotion é uma ferramenta que transforma uma especificação JSON — uma lista de quadros-chave, cada um contendo uma lista de formas — em animações com aparência de desenho à mão. Formas com o mesmo `id` sofrem morfismo entre quadros-chave, enquanto as linhas mantêm um efeito de 'fervura' (re-ink ~12x/s), dando a sensação de terem sido traçadas à mão. A ferramenta suporta múltiplos formatos de exportação, incluindo SVG animado, Lottie JSON e HTML, além de gerar links compartilháveis que podem ser abertos no estúdio online para ajustes adicionais. É especialmente útil para criar ícones animados, carregadores, ilustrações, animações explicativas, vinhetas de logo, animações de estados vazios ou de sucesso, e qualquer animação que precise de um estilo 'rascunhado', 'esboçado' ou 'doodle'. O Geomotion pode ser usado via ferramentas MCP (agentes como Claude Code e Cursor), via CLI (Node 18+) ou diretamente via scripts Python, oferecendo flexibilidade para diferentes fluxos de trabalho de desenvolvimento.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hacimertgokhan/geomotion/tree/HEAD/skills/geomotion

Perguntar na sua IA favorita

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

Documentação

O que geomotion faz?

gemotion transforma uma especificação JSON — uma lista de quadros-chave, cada um contendo uma lista de formas — em uma animação desenhada à mão. Formas com o mesmo id sofrem morfismo entre quadros-chave; as linhas mantêm um efeito de "fervura" (re-ink ~12×/s), dando a sensação de terem sido traçadas à mão.

Site e estúdio: https://hacimertgokhan.github.io/geomotion · Repositório: https://github.com/hacimertgokhan/geomotion

Fluxo de trabalho

  1. Escolha uma rota (use a primeira disponível):
    • Ferramentas MCP (geomotion_guide, geomotion_get_preset, geomotion_render, geomotion_share_link): chame geomotion_guide uma vez, depois renderize.
    • CLI (Node 18+ com rede): npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html
    • Sem ferramentas: escreva a especificação, depois execute python scripts/link.py spec.json (nesta pasta da habilidade) para obter um link do player/estúdio que o usuário pode abrir, editar e exportar.
  2. Comece a partir de um preset quando estiver próximo (veja o catálogo abaixo) e adapte ids, posições, cores.
  3. Escreva a especificação seguindo as regras abaixo. Valide (MCP geomotion_validate ou geomotion check spec.json).
  4. Entregue: caminhos de arquivo e/ou o link do player. Mencione o link do estúdio para que possam ajustá-lo. Ofereça uma versão transparente (transparent: true ou "both") quando a animação for colocada em um site.

Essenciais da especificação

{
  "name": "ideia",
  "size": [1200, 1200],
  "fps": 24, "boil": 12, "loop": true,
  "background": "marfim",
  "hold": 0.7, "duration": 0.9, "ease": "inOutCubic",
  "style": { "width": 24, "wobble": 1, "misregister": [-14, 10] },
  "keyframes": [
    { "shapes": [ { "id": "bulbo", "type": "circle", "cx": 600, "cy": 520, "r": 220, "fill": "aveia" } ] },
    { "hold": 1.2, "shapes": [
      { "id": "bulbo", "type": "circle", "cx": 600, "cy": 520, "r": 240, "fill": "sol" },
      { "id": "raio", "type": "line", "from": [600, 200], "to": [600, 110], "enter": "draw", "delay": 0.3 }
    ] }
  ]
}
  • Quadro-chave: hold (segundos exibidos), duration (morfismo para o próximo quadro-chave), ease.
  • Tipos de forma: circle {cx,cy,r}, ellipse {cx,cy,rx,ry}, rect {x,y,w,h,radius?} ou {cx,cy,w,h}, line {from,to}, polyline {points,closed?}, polygon {points}, regular {cx,cy,r,sides}, triangle {cx,cy,r}, star {cx,cy,r,inner?,points?}, heart {cx,cy,size}, blob {cx,cy,r,seed?}, crescent {cx,cy,r,thickness?,angle?}, wave {from,to,amplitude?,waves?,phase?}, spiral {cx,cy,r,turns?}, arc {cx,cy,r,start,end} (graus, 0 = direita, sentido horário), path {d} (qualquer caminho SVG).
  • Opções de forma: id (corresponder entre quadros-chave — sempre defina), fill, stroke (cor ou false), width, opacity, enter/exit (grow | pop | draw | fade | cut), delay (0–0.95, escalonamento), ease, transform {translate, rotate, scale, origin}, misregister: false para pontinhos sólidos.
  • Nomes de paleta: ink, slate, ivory, paper, oat, kraft, clay, coral, fig, sky, cactus, olive, heather, sun, white (ou qualquer hex).
  • Facilidades: linear, in/out/inOut Quad·Cubic·Sine, inOutQuart, outExpo, inOutExpo, outBack, inOutBack, outElastic, outBounce.

Regras de design para um bom resultado

  1. Tela 1200×1200, margem de ~120 px, 2–5 formas ousadas por pose. Detalhes pequenos são mal vistos.
  2. Tinta para todos os contornos, um ou dois preenchimentos de destaque por pose (aveia, argila, sol, céu, cacto, coral).
  3. Conte uma história através dos ids: o mesmo elemento se transforma (sol → lua, envelope → avião de papel, ponto → coração).
  4. Escalone com delay 0 / 0.15 / 0.3; use "enter": "draw" para linhas que devem parecer escritas, "pop" para chegadas divertidas.
  5. Holds 0.5–1.2 s, morphs 0.5–1.2 s. inOutCubic = calmo, inOutBack/outBack = divertido, outElastic = gelatinoso.
  6. Rotações > 30° entre dois quadros-chave fazem as linhas cortarem cantos — divida grandes rotações em vários quadros-chave (veja os presets spinner, gears, orbit).
  7. Pontinhos sólidos (olhos, pontinhos de digitação): "stroke": false, "fill": "ink", "misregister": false.

Catálogo de presets (pontos de partida)

  • interface: loader, spinner, success, error, toggle, bell, search
  • natureza: sunrise, sprout, rain, night, sea
  • comunicação: chat, send, like, connect
  • ideias: idea, growth, target, gears, house
  • personagens: smile, ghost, sparkle
  • abstrato: drift, orbit, kaleido, pebbles
  • movimento: bounce, pendulum, jelly

Qualquer preset abre diretamente: https://hacimertgokhan.github.io/geomotion/play/#preset=<nome> (adicione &bg=0 para fundo transparente) ou no estúdio: /studio/#preset=<nome>.

Incorporação em um site

<script type="module" src="https://hacimertgokhan.github.io/geomotion/src/embed.js"></script>
<geo-motion preset="success" transparent style="width:160px"></geo-motion>
<geo-motion code="z…"></geo-motion>   <!-- a parte #s=… de um link compartilhável -->

Habilidades Relacionadas