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
- Escolha uma rota (use a primeira disponível):
- Ferramentas MCP (
geomotion_guide,geomotion_get_preset,geomotion_render,geomotion_share_link): chamegeomotion_guideuma 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.
- Ferramentas MCP (
- Comece a partir de um preset quando estiver próximo (veja o catálogo abaixo) e adapte ids, posições, cores.
- Escreva a especificação seguindo as regras abaixo. Valide (MCP
geomotion_validateougeomotion check spec.json). - 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: trueou"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 oufalse),width,opacity,enter/exit(grow|pop|draw|fade|cut),delay(0–0.95, escalonamento),ease,transform {translate, rotate, scale, origin},misregister: falsepara 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
- Tela 1200×1200, margem de ~120 px, 2–5 formas ousadas por pose. Detalhes pequenos são mal vistos.
- Tinta para todos os contornos, um ou dois preenchimentos de destaque por pose (aveia, argila, sol, céu, cacto, coral).
- Conte uma história através dos ids: o mesmo elemento se transforma (sol → lua, envelope → avião de papel, ponto → coração).
- Escalone com
delay0 / 0.15 / 0.3; use"enter": "draw"para linhas que devem parecer escritas,"pop"para chegadas divertidas. - Holds 0.5–1.2 s, morphs 0.5–1.2 s.
inOutCubic= calmo,inOutBack/outBack= divertido,outElastic= gelatinoso. - 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). - 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 -->