Supported Platforms
Backends
iTwin.js backends are built and tested on the following:
- Arch Linux
- Debian 11 "Bullseye"
- Windows 10 version 1803 (or greater)
- MacOS 10.15 (or greater)
They should run on most Windows, Linux and MacOS versions with Tier 1 support from Node.js. However, regular testing only occurs on the platforms listed above.
Supported Node.js Versions
The following Node.js versions are officially supported by the iTwin.js backend code.
The minimum requirements are driven by Node's compatibility with a specific N-API version. iTwin.js currently requires N-API version 8. See the Node compatibility matrix for more details.
| iTwin.js - Node Support | iTwin.js 1.x | iTwin.js 2.x | iTwin.js 3.x | iTwin.js 4.x |
|---|---|---|---|---|
| Node 22 (>=22.11) | ❌ | ❌ | ❌ | ✅ (>= 4.10) |
| Node 20 (>=20.9) | ❌ | ❌ | ❌ | ✅ (>= 4.3) |
| Node 18 (>=18.12) | ❌ | ❌ | ✅ (>= 3.5) | ✅ |
| Node 16 (>=16.13) | ❌ | ❌ | ✅ | ❌ |
| Node 14 (>=14.17) | ❌ | ✅ (>= 2.13) | ✅ | ❌ |
| Node 12 (>=12.22) | ✅ | ✅ | ✅ | ❌ |
| Node 10 | ❌ | ❌ | ❌ | ❌ |
Backend Prerequisites
| Operating System | Architectures | Versions | Notes |
|---|---|---|---|
| Linux | all | GLIBC >= 2.31, GLIBCXX >= 3.4.28 | |
| Windows | all | Visual Studio 2017 C Runtime | |
| macOS | x64 | >= 10.15 | |
| macOS | arm64 | >= 11 | >= iTwin.js 3.3 |
Supported Browsers
iTwin.js strives to support as many modern browsers as possible, though it requires complete JavaScript ES6 support. The quality of the web browser's WebGL implementation has a substantial impact on display performance.
- Chrome (recommended for development)
- Firefox
- Safari
- Opera
- "New" Chromium-based Edge
Note: Internet Explorer and "Old" Edge are not supported
Note: Other Chromium-based browsers will likely work fine, but are untested.
Electron
To enable the development of desktop applications, iTwin.js supports the latest Electron releases. As of iTwin.js 4.0, Electron 23 is the minimum requirement. See Electron platform requirements for supported Windows, Linux and MacOS versions.
Mobile Native
The following minimum versions of mobile operating systems are supported:
Last Updated: 17 December, 2024