Skip to documentation
Download SDK 1.1.0 ↗

API stability and 1.0 migration

Self-hosted SDK 1.1.0 · npm / CDN 1.1.0 · MPL-2.0

Core embed API 1.0 is stable. Net selection retains the 3D camera; unrelated geometry fades to translucent gray in Dim mode. The current 1.1.0 SDK adds lower-memory source and zone geometry, reliable saved pad identities and camera-safe linked inspection. It retains stable resizable Properties, linked contextual previews, shared result palettes, explicit text variables, bounded expressions and horizontal tables. Expanded 3D, saved BOM and registered WayriCAD fields remain available. The same release is available through npm/CDN. Release details and downloads ↗

Core embed API 1.0

KiCad WebView 1.0.0 establishes the documented core embed API as version 1.0. Use the package entry points and shipped declarations; internal renderer globals, source-module internals and generated chunk filenames are not public contracts.

Within 1.x, removing or incompatibly changing a documented stable method, option, event or typed core export requires a new major version. Minor releases can add backward-compatible capabilities; patch releases can correct bugs. Rendering fidelity, diagnostics and bounded input validation can improve without preserving an earlier incorrect picture or accepting malformed files.

Upgrading from 0.8.0

Experimental and host-specific surfaces

Altium interoperability and the Slack, Confluence and Notion adapters retain their explicit experimental status. Their external host dependencies, permissions, authentication and client limitations are not certified by the core 1.0 version. In particular, the Forge source has not completed a live Confluence installation check. See application integration limits.

Native file compatibility and numerical visualization remain bounded by their documented formats. Viewing saved PI/SI/thermal results does not run a solver or qualify those results. Missing models, approximate geometry, unsupported files and incomplete stackups stay disclosed. A stable API does not imply KiCad pixel parity, every GPU/device, or maximum-budget 3D performance.

Distribution and licensing

Classic scripts, ES modules, the lightweight entry point, iframes and self-contained HTML remain available. Node.js is a development/build requirement, not a requirement for website visitors. Pin a package version or host an exact reviewed bundle, keep its source revision and legal notices, and verify CDN bytes after publication.

MPL-2.0 permits free use, including commercially. Paid integration, customization, maintenance and support are optional. Hardware examples and third-party model assets retain separate terms and attribution.