Skip to content

lightweight-3d-effects

  • Group: 3D / WebGL
  • When it activates: Lightweight decorative 3D effects (Zdog, Vanta, tilt)
  • Installed: Optional: comes with a skill bundle.

Full upstream documentation (English): SKILL.upstream.md (1091 lines). Do not read all of it: use the map and read only the section you need (Read with offset/limit or Grep).

  • Use: animated hero/section background (Vanta WAVES, NET, FOG, CLOUDS, BIRDS…) without setting up Three.js by hand.
  • Use: vector pseudo-3D illustrations or icons with Zdog (canvas/SVG, ~28 kB, dragRotate).
  • Use: cards with tilt parallax, glare and translateZ layers with Vanilla-Tilt (data-attributes or API).
  • Do NOT use: 3D scenes with models, lights or physics → threejs-webgl / react-three-fiber; Spline scenes → spline-interactive.
  • Do NOT use: general DOM or scroll animation → gsap-scrolltrigger; declarative React animations → motion-framer.
Task Read only
Start a project/starter SKILL.upstream.md L716-926 (§Common Patterns) + assets/starter_lightweight/
Vanta animated background (choose effect, options, React) L270-516 (§Vanta.js) + references/vantajs_effects.md
Zdog illustration/icon (shapes, groups, animation) L22-268 (§Zdog) + references/zdog_api.md
Tilt on cards (options, glare, layers, React) L518-714 (§Vanilla-Tilt.js) + references/tilt_patterns.md
Debugging / performance L928-1068 (§Performance Best Practices + §Common Pitfalls)
Lines Section What for
8-21 Overview / When to Use This Skill What each library covers and use cases
22-268 Zdog - Pseudo-3D Illustrations Setup (35), Shapes (96), Groups (170), Animation (229)
270-516 Vanta.js - Animated 3D Backgrounds Setup (283), Available Effects (338), Config (429), Methods destroy/setOptions (454), React (476)
518-714 Vanilla-Tilt.js - Parallax Tilt Effects Setup (531), Config Options (567), Advanced glare/layers/API (607), React (676)
716-926 Common Patterns Vanta hero (718), Zdog icon grid (761), tilt gallery (826), Vanta + tilt combined (877)
928-971 Performance Best Practices Limits per library, mobile fallback, will-change
973-1068 Common Pitfalls Multiple Vanta (975), leaks in SPA (997), blank Zdog (1014), mobile tilt (1040), Vanta colors (1054)
1070-1091 Resources / Related Skills Official links and related skills
  • references/zdog_api.md — Full Zdog API: Illustration, Anchor, shapes, properties, animation.
  • references/vantajs_effects.md — Catalog of Vanta effects with all their options and dependencies (Three.js / p5.js).
  • references/tilt_patterns.md — Patterns and advanced options for Vanilla-Tilt (gyroscope, glare, layers).
  • scripts/generate_zdog.py — Generates Zdog illustrations by type: py -3 scripts/generate_zdog.py --type cube (--list to see types; no args = interactive).
  • scripts/setup_vanta.py — Generates the HTML/JS for a Vanta background: py -3 scripts/setup_vanta.py --effect waves (--list for effects).
  • assets/starter_lightweight/ — Vanilla starter (index.html, main.js, style.css, README) with the three libraries.
  • assets/examples/README.md — Production examples: heros, product cards, portfolios, dashboards.
  • At most 1-2 Vanta instances per page; lazy load with IntersectionObserver and fall back to a static gradient on mobile.
  • In SPA/React always call vantaEffect.destroy() and element.vanillaTilt.destroy() in the effect’s cleanup.
  • Vanta takes colors as a hex number (0x23153c), never strings "#23153c".
  • Zdog: call illo.updateRenderGraph() after every change; canvas with explicit width/height; < 100 shapes for 60 fps; canvas for animation, SVG for static.
  • Respect prefers-reduced-motion: disable animated backgrounds and tilt (upstream does not cover this; it is a project rule).
  • Detect the stack as the front-activation/skill-router skill indicates (senzu/senzu.json → package.json).
  • The three libraries are vanilla (they work in Vue, Astro, plain HTML); upstream includes React wrappers for Vanta (L476) and Tilt (L676). In SSR (Next/Astro) initialize only on the client (useEffect / client:only); Vanta needs window.