ALLPERSONAS / DEVELOPERS
Compatibility
Browser capabilities, framework support, and Node requirements.
Browser and framework support
The SDK targets modern browsers with ES2022, SVG, requestAnimationFrame, matchMedia, and AbortController. Use current Chrome, Edge, Firefox, or Safari. The following is a capability guide, not a claim that every browser/version has been tested.
| Capability | Support and limits |
|---|---|
| Face rendering | Modern desktop and mobile browsers. No API key or React dependency. |
| Browser speech | Requires speechSynthesis and a user gesture. Voice availability and word events vary by browser and operating system. |
| External audio | Requires HTMLAudioElement; measured mouth motion uses Web Audio and appropriate CORS headers. |
| Web Component | Requires Custom Elements and Shadow DOM. Register in the browser entry point. |
| React / Vue / Svelte / Angular | Use the native controller and each framework’s mount, update, and cleanup hooks. |
| SSR / edge runtimes | Import core and call renderFace without a DOM. createFace requires a browser document. |
Node and module support
Repository development requires Node 22.13 or newer and npm. The package exports ESM and TypeScript declarations. CommonJS consumers should use dynamic import(). CI runs the documented minimum and current Node versions; speech itself remains a browser capability.