interactor
Installation
SKILL.md
Interactor — build interactions with @wix/interact
This skill installs, wires up, and configures motion interactions so you can add or edit interactions on any webpage or web app. It is interact-first: you describe what should animate and when as a declarative JSON config, and the library does the DOM wiring. You almost never call the motion engine directly.
Mental model — packages and one config
| Package | Role | You touch it… |
|---|---|---|
@wix/interact |
Declarative layer. Binds triggers → effects via an InteractConfig. Ships vanilla / React / Web-Component entry points. |
Always. This is the API. |
@wix/motion-presets |
Ready-made named effects (entrance, scroll, ongoing, mouse). Referenced as namedEffect: { type: 'FadeIn' }. |
When you want a prebuilt effect (the common case). |
@wix/motion |
The engine (WAAPI, CSS, ViewTimeline, fastdom). Bundled inside interact. | Rarely — only for programmatic/escape-hatch animation. See references/motion-engine.md. |
@wix/interact-validate |
Static validator for InteractConfig shape (schema + referential checks). No DOM. |
Agent-side validation always; optional dev/CI guard in user projects. See references/validate.md. |
The whole job is: pick a trigger, pick an effect, bind it to an element with a key. Everything else is detail.