SDKsWeb
Versioning
CDN channels and the backwards-compatibility contract for the web SDK.
CDN channels
| Channel | URL | Behavior |
|---|---|---|
| Stable (v1) | https://motisig.ai/cdn/web/v1/motisig.js | Always the latest v1 build |
| Pinned | https://motisig.ai/cdn/web/<version>/motisig.js | Immutable build for a specific version |
Most sites should use the stable channel so they receive backwards-compatible fixes automatically. Pin a version when you need a reproducible, immutable build.
Compatibility contract
The hosted CDN script is served to every customer website, so its surface is treated as a public API contract:
- Updates within a channel are strictly backwards-compatible (additive only).
- Public methods, the
window.motisigshape,data-*attributes, and storage keys are never renamed or removed within a version. - Breaking changes ship under a new versioned path (for example
web/v2/) rather than changingweb/v1/.