# physx-js-webidl

> Javascript/WASM bindings for Nvidia PhysX 5.6.1

Latest version **2.7.3** (published 2026-04-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install physx-js-webidl
pnpm add physx-js-webidl
yarn add physx-js-webidl
bun add physx-js-webidl
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance.

Warnings: low downloads; large bundle.

## Facts

| | |
|---|---|
| Version | 2.7.3 |
| Published | 2026-04-15 |
| First published | 2021-02-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 9.8 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 181 |
| Author | fabmax |
| Maintainers | fabmax |
| Keywords | physics, emscripten, WebIDL, webassembly, PhysX |

## Links

- npm: https://www.npmjs.com/package/physx-js-webidl
- Repository: https://github.com/fabmax/physx-js-webidl
- Homepage: https://github.com/fabmax/physx-js-webidl#readme
- Issues: https://github.com/fabmax/physx-js-webidl/issues
- npm.io page: https://npm.io/package/physx-js-webidl

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 2.7.3 (latest) — 2026-04-15
- 2.7.2 — 2026-02-25
- 2.7.1 — 2025-12-09
- 2.7.0 — 2025-11-10
- 2.6.2 — 2025-09-21
- 2.6.1 — 2025-03-26
- 2.6.0-1 — 2025-03-25
- 2.6.0 — 2025-03-25
- 2.5.1 — 2025-02-16
- 2.5.0 — 2025-01-05
- 2.4.2 — 2024-11-02
- 2.4.1 — 2024-08-18
- 2.4.0 — 2024-06-03
- 2.3.1 — 2024-01-04
- 2.3.0 — 2023-10-02
- … 25 more at https://npm.io/package/physx-js-webidl/versions

## README

# physx-js-webidl
Javascript/WASM bindings for Nvidia PhysX 5.6.1.

Looking for pre-built binaries / build instructions? See [below](#pre-built-binaries)

## Library coverage

The bindings include most major parts of the PhysX SDK (excluding CUDA stuff, which is not possible with WASM):
- [x] Basics
    - Static and dynamic actors
    - All geometry types (box, capsule, sphere, plane, convex mesh, triangle mesh and height field)
- [x] All joint types (revolute, spherical, prismatic, fixed, distance and D6)
- [x] Articulations
- [x] Vehicles
- [x] Character controllers
- [x] Scene serialization

## Getting started
There is a basic [hello world example](dist/helloworld.html): 10 boxes falling on the ground (drawn as wireframe on a plain canvas).

## Documentation
The API is very close to the original PhysX C++ API, so you can simply use the official
[PhysX API documentation](https://nvidia-omniverse.github.io/PhysX/physx/5.6.1/index.html)

However, in order to make the bindings work with emscripten a few additional wrappers are needed here and there. So it might
make sense to also take a look into the [PhysXWasm.idl](https://github.com/fabmax/PhysX/blob/webidl-bindings/physx/source/webidlbindings/src/wasm/PhysXWasm.idl)
interface definiton file.

Update as of `v2.2.0`: Thanks to Shannon Poole, PhysX enums can now be accessed by their qualified names (e.g. `PhysX.PxIDENTITYEnum.PxIdentity`,
see also the hello world demo mentioned above).

## Demos
I use this library in my engine [kool](https://github.com/fabmax/kool) and have a few demos in place:
- [Vehicle](https://fabmax.github.io/kool/kool-js/?demo=phys-vehicle): Basic vehicle demo with a few obstacles.
- [Character](https://fabmax.github.io/kool/kool-js/?demo=phys-terrain): 3rd person character demo on an island.
- [Ragdolls](https://fabmax.github.io/kool/kool-js/?demo=phys-ragdoll): A simple ragdoll demo.
- [Joints](https://fabmax.github.io/kool/kool-js/?demo=phys-joints): A chain running over two gears.
- [Collision](https://fabmax.github.io/kool/kool-js/?demo=physics): The obligatory box (and other shapes) collision physics demo.

However, the demos are written in kotlin, not javascript.

## Pre-built binaries
This library is published as a [npm package](https://www.npmjs.com/package/physx-js-webidl):
```
npm i physx-js-webidl
```
Alternatively you can grab the pre-built binaries (`.wasm` + support `.mjs`) from the latest [Release](https://github.com/fabmax/physx-js-webidl/releases).

## Building
In order to build the library you need a recent version of the [emscripten SDK](https://emscripten.org/docs/getting_started/downloads.html) - I'm
using version `4.0.19`. Alternatively, you can use docker as described below.
After successful build, the binaries (`.wasm` + support `.mjs`) will appear in the `dist` directory.

```
# Clone this repo
git clone https://github.com/fabmax/physx-js-webidl

# Enter that directory
cd physx-js-webidl

# Download submodule containing the PhysX code
git submodule update --init

# Generate build-scripts
./generate.sh

# Build
./make.sh
```

To add bindings to additional PhysX interfaces you only have to edit the
[PhysXJs.idl](https://github.com/fabmax/PhysX/blob/webidl-bindings/physx/source/webidlbindings/src/wasm/PhysXWasm.idl)
file located in `PhysX/physx/source/webidlbindings/src/wasm/` and recompile the library.

### Build with Docker

The docker build also generates typescript definitions.

```
# Build the image
docker compose up

# Build Release
docker compose run --rm builder ./make.sh

# Build Profile
docker compose run --rm builder ./make-profile.sh

# Build Debug
docker compose run --rm builder ./make-debug.sh
```

---
_Source: https://npm.io/package/physx-js-webidl · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._