¿Qué hace geomotion?
gemotion convierte un spec JSON (una lista de keyframes, cada uno con una lista de formas) en una animación dibujada a mano. Las formas con el mismo id se transforman entre keyframes; las líneas mantienen un efecto de "ebullición" (re-ink ~12×/s), dando la sensación de estar trazadas a mano.
Sitio y estudio: https://hacimertgokhan.github.io/geomotion · Repo: https://github.com/hacimertgokhan/geomotion
Flujo de trabajo
- Elige una ruta (usa la primera disponible):
- Herramientas MCP (
geomotion_guide,geomotion_get_preset,geomotion_render,geomotion_share_link): llama ageomotion_guideuna vez, luego renderiza. - CLI (Node 18+ con red):
npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html - Sin herramientas: escribe el spec, luego ejecuta
python scripts/link.py spec.json(en esta carpeta de skill) para obtener un enlace al reproductor/studio que el usuario puede abrir, editar y exportar.
- Herramientas MCP (
- Empieza desde un preset cuando uno se acerque (ver catálogo abajo) y adapta ids, posiciones, colores.
- Escribe el spec siguiendo las reglas de abajo. Valida (MCP
geomotion_validateogeomotion check spec.json). - Entrega: rutas de archivo y/o el enlace del reproductor. Menciona el enlace del estudio para que puedan ajustarlo. Ofrece una versión transparente (
transparent: trueo"both") si la animación irá en un sitio web.
Elementos esenciales del spec
{
"name": "idea",
"size": [1200, 1200],
"fps": 24, "boil": 12, "loop": true,
"background": "ivory",
"hold": 0.7, "duration": 0.9, "ease": "inOutCubic",
"style": { "width": 24, "wobble": 1, "misregister": [-14, 10] },
"keyframes": [
{ "shapes": [ { "id": "bulb", "type": "circle", "cx": 600, "cy": 520, "r": 220, "fill": "oat" } ] },
{ "hold": 1.2, "shapes": [
{ "id": "bulb", "type": "circle", "cx": 600, "cy": 520, "r": 240, "fill": "sun" },
{ "id": "ray", "type": "line", "from": [600, 200], "to": [600, 110], "enter": "draw", "delay": 0.3 }
] }
]
}
- Keyframe:
hold(segundos que se muestra),duration(morph al siguiente keyframe),ease. - Tipos de forma:
circle {cx,cy,r},ellipse {cx,cy,rx,ry},rect {x,y,w,h,radius?}o{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}(grados, 0 = derecha, sentido horario),path {d}(cualquier path SVG). - Opciones de forma:
id(coincide entre keyframes —siempre establecerlo),fill,stroke(color ofalse),width,opacity,enter/exit(grow|pop|draw|fade|cut),delay(0–0.95, escalonado),ease,transform {translate, rotate, scale, origin},misregister: falsepara puntos sólidos pequeños. - Nombres de paleta: ink, slate, ivory, paper, oat, kraft, clay, coral, fig, sky, cactus, olive, heather, sun, white (o cualquier hex).
- Easings: linear, in/out/inOut Quad·Cubic·Sine, inOutQuart, outExpo, inOutExpo, outBack, inOutBack, outElastic, outBounce.
Reglas de diseño para que se vea bien
- Lienzo de 1200×1200, margen ~120 px, 2–5 formas en negrita por pose. Los detalles pequeños se ven mal.
- Tinta para todos los contornos, uno o dos colores de relleno de acento por pose (oat, clay, sun, sky, cactus, coral).
- Cuenta una historia a través de los ids: el mismo elemento se transforma (sun → moon, envelope → paper plane, dot → heart).
- Escalona con
delay0 / 0.15 / 0.3; usa"enter": "draw"para líneas que deban sentirse escritas,"pop"para llegadas divertidas. - Holds 0.5–1.2 s, morphs 0.5–1.2 s.
inOutCubic= tranquilo,inOutBack/outBack= divertido,outElastic= gelatinoso. - Rotaciones > 30° entre dos keyframes hacen que las líneas corten esquinas — divide rotaciones grandes en varios keyframes (ver los presets
spinner,gears,orbit). - Puntos sólidos (ojos, puntos de escritura):
"stroke": false, "fill": "ink", "misregister": false.
Catálogo de presets (puntos de partida)
- interfaz: loader, spinner, success, error, toggle, bell, search
- naturaleza: sunrise, sprout, rain, night, sea
- comunicación: chat, send, like, connect
- ideas: idea, growth, target, gears, house
- personajes: smile, ghost, sparkle
- abstracto: drift, orbit, kaleido, pebbles
- movimiento: bounce, pendulum, jelly
Cualquier preset se abre directamente: https://hacimertgokhan.github.io/geomotion/play/#preset=<nombre>
(añade &bg=0 para fondo transparente) o en el estudio: /studio/#preset=<nombre>.
Incrustar en un sitio web
<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> <!-- la parte #s=… de un enlace compartido -->