# Platform support Stable v1 supports Node.js 22 and 24 with Node-API 8. | Platform | Architecture | Prebuilt | | --- | --- | --- | | Linux glibc | x64 | Yes | | Linux glibc | arm64 | Yes | | macOS | x64 | Yes | | macOS | arm64 | Yes | | Windows | x64 | Yes | Linux prebuilds are compiled in a `node:24-bullseye` (Debian 11, glibc 2.31) container and require glibc 2.31 or newer, which covers Amazon Linux 2023 (glibc 2.34, the Node.js 22/24 Lambda runtime), Ubuntu 20.04+, and Debian 11+. CI asserts this floor automatically (`scripts/check-glibc-floor.js`) and installs the packaged tarball with lifecycle scripts disabled inside the official `public.ecr.aws/lambda/nodejs:22` and `:24` images on both x64 and arm64 as a regression check for [issue #8](https://github.com/unique01082/lightdrift-libraw/issues/8). ## AWS Lambda Use version 1.0.1 or newer for Lambda Node.js 22/24 on Amazon Linux 2023. Install the package for the same architecture as the deployed function: ```bash npm install lightdrift-libraw@^1.0.1 ``` For an arm64 container deployment, build the application image with `--platform linux/arm64`; use `linux/amd64` for x64. Install dependencies inside that target image so npm selects the matching Sharp dependencies as well as the SDK prebuild. Copying an x64 or macOS `node_modules` directory to an arm64 Lambda function will not work. No compiler or system LibRaw is required for supported prebuilds. See the [AWS container deployment guide](https://docs.aws.amazon.com/lambda/latest/dg/nodejs-image.html). CI runtime-tests prebuilds, source fallback, real RAW fixtures, queue behavior, cancellation, malformed inputs, and ESM/CommonJS tarball consumers. Linux native jobs additionally run ASan and UBSan. Node.js 20, Alpine/musl, browsers, WASM, and system LibRaw are not supported in v1. LibRaw's default resource limits remain unchanged. ## Electron Electron 36 is supported in Node-enabled main and utility processes on the platforms above. CI installs the complete npm tarball with lifecycle scripts disabled and loads its shipped Node-API prebuild in Electron 36.9.5 on Windows x64, the environment originally reported in GitHub issue #2. The addon does not need `@electron/rebuild` because it targets Node-API 8 instead of an Electron-specific V8 ABI. Packaged applications must keep `dist/` and the matching `prebuilds/-/lightdrift-libraw.node` file. Configure the packager to unpack `.node` files from ASAR when it does not do so automatically. Renderer processes without Node integration are not supported; expose the SDK from a preload, main, or utility process through the application's IPC boundary. On Windows, `openFile`, `loadFile`, `loadBayerData`, and all Sharp-based convenience writers accept Unicode paths. LibRaw's direct native writer methods (`dcrawPpmTiffWriter`, `dcrawThumbWriter`, `writePPM`, `writeTIFF`, and `writeThumbnail`) and native profile-file parameters remain limited to paths representable by the active Windows code page. ## Related - [Source builds](source-build.md) - Fallback prerequisites. - [1.0.1 release notes](releases/1.0.1.md) - Lambda compatibility fix. - [1.0.0-rc.1 release notes](releases/1.0.0-rc.1.md) - Release target matrix and known limits. - [Project README](../README.md) - Installation.