stack.pulse
#stacks/threejs/library

Three.js release notes, breaking changes, and upgrade notes.

JavaScript 3D library StackPulse turns upstream changelogs into scannable summaries with risky changes, deprecations, migration notes, and source links.

source repo$track this stackplan upgraderss
releases
6
breaking
6
security
1
deprecated
4
migrations
5

Get source-linked upgrade notes and occasional sponsor recommendations. No GitHub login required.

what stackpulse tracks

Three.js releases from GitHub

StackPulse watches Three.js release notes and keeps the original source link close to every summary.

upgrade risk

Breaking changes and deprecations

Risky changes are separated from normal feature notes so you can scan upgrade impact before changing production dependencies.

migration notes

Source-backed next steps

Migration steps and recommended actions are only shown when the upstream release notes support them.

# latest_releases

source-backed
allbreakingdeprecationmigrationsecurity
r185highbreakingdeprecationmigrationfeatureJun 25, 2026

r185

This release focuses on performance optimizations, bug fixes, and deprecations. Key changes include improvements to rendering, matrix operations, and TSL (Three.js Shader Language) enhancements.

affected

Developers using deprecated Matrix3 methods, custom shaders, or TSL functionality will be most affected by these changes.

action

Review the migration guide and update code to replace deprecated APIs and accommodate breaking changes.

release_signals
-Matrix3 methods `.scale()`, `.rotate()`, and `.translate()` are now deprecated
-Renamed `Matrix4.determinant3x3()` to `determinantAffine()`
-Removed deprecated code across the codebase (unspecified which APIs)
-TSL: Removed `string` and `arrayBuffer` definitions
-Renamed `directionToFaceDirection` to `negateOnBackSide` in TSL
!Matrix3 methods `.scale()`, `.rotate()`, and `.translate()` are deprecated
!Some shader-related functionality marked with deprecation notes (unspecified)
!Removed various deprecated code throughout the codebase
+Added `Material.registerMaterial()` and `Material.fromJSON()` for better material management
+Introduced `transformNormalByInverseViewMatrix()` in WebGLRenderer shaders
+Support for new WICG HTML-in-Canvas API signatures in HTMLTexture
+Added `max()` function for outputs in ColorAdjustment
+Introduced `storageTexture3D` and textureGather support in TSL
migration_steps5 steps
  1. 01Refer to migration guide for changes from r184 to r185: https://github.com/mrdoob/three.js/wiki/Migration-Guide#184--185
  2. 02Replace usage of Matrix3's deprecated methods with alternative approaches
  3. 03Update code using `determinant3x3()` to use `determinantAffine()` instead
  4. 04Update TSL code to use new API signatures and removed definitions
  5. 05Check for any usage of removed deprecated APIs throughout the codebase
view source on github->
r184mediumbreakingfeaturesecurityApr 16, 2026

r184

This release introduces HTMLTexture support, improves rendering consistency, and fixes several bugs across the library. Notable updates include enhancements to WebGPU rendering, animation modules, and material handling.

affected

Developers using deprecated instancing render paths or relying on default Texture setter parameters will need to update their code.

action

Review the migration guide for changes related to deprecated features and update your code accordingly.

release_signals
-Removed deprecated instancing render paths in BatchedMesh
-Simplified bool check in MaterialLoader
-Removed default setter parameter in Texture
!Fixed vulnerabilities in Dev
!Executed `npm audit fix`
+Added HTMLTexture support
+Position-dependent diffuse Global Illumination in LightProbeGrid
+Support for EXT_texture_norm16 formats in Renderers
+Improved WebGPU rendering compatibility and performance
+Added hyperbolic math nodes in TSL
view source on github->
r183highbreakingdeprecationmigrationfeatureFeb 20, 2026

r183

This release focuses on removing deprecated code, improving shadow mapping, and introducing new features like BezierInterpolant and support for scene.environment IBL in materials.

affected

Developers using deprecated features or relying on the `Clock` module will need to update their code.

action

Review the migration guide and update your code to replace deprecated features and modules.

release_signals
-Remove deprecated code globally
-Rename `shadowMap.color` to `shadowMap.colored` and then to `shadowMap.transmitted`
-Deprecate `Clock` module
-Remove `bindingsReference` in BindGroup
-Remove `scriptable` node in TSL
!Deprecate `Clock` module
!Remove `bindingsReference` in BindGroup
!Remove `scriptable` node in TSL
+Add BezierInterpolant for smoother animations
+Add support for scene.environment IBL in MeshLambertMaterial and MeshPhongMaterial
+Enable per-instance opacity in BatchedMesh
+Add support for wireframe materials in BatchedMesh
+Introduce `clipSpace` in TSL for better rendering control
migration_steps4 steps
  1. 01Update references from `shadowMap.color` to `shadowMap.transmitted`
  2. 02Replace deprecated `Clock` module usage with alternative timing mechanisms
  3. 03Remove any usage of `bindingsReference` in BindGroup
  4. 04Update TSL scripts to remove `scriptable` node references
view source on github->
r182highbreakingmigrationfeatureDec 10, 2025

r182

This release introduces significant improvements to WebGL and WebGPU renderers, including modernized shadow mapping, enhanced material accuracy, and new TSL features. It also includes optimizations, bug fixes, and documentation updates.

affected

Developers using WebGLRenderer, WebGPURenderer, or TSL will be affected by breaking changes and new features.

action

Review the migration guide and update your code to accommodate breaking changes and new features.

release_signals
-Removed `fromJSON()` from LightProbe
-Renamed `DFGApprox` to `DFGLUT` in TSL
-Removed `nodeObject()` for Node classes in TSL
-Removed `SUPPORTS_VERTEX_TEXTURES` from WebGLRenderer
-Renamed `getColorBufferType()` to `getOutputBufferType()` in WebGPURenderer
+Added `indirectOffset` parameter for indirect drawing in BufferGeometry
+Improved GGX VNDF accuracy in PMREMGenerator to match Blender roughness
+Added support for `StorageInstancedBufferAttribute` in InstanceNode
+Introduced `builtinShadowContext()` and `builtinAOContext()` in TSL
+Added `outputBufferType` and `setEffects()` to WebGLRenderer
migration_steps5 steps
  1. 01Migrate to ESLint 9 with flat config
  2. 02Update WebGLRenderer to use `outputBufferType` and `setEffects()`
  3. 03Replace `DFGApprox` with `DFGLUT` in TSL
  4. 04Remove `nodeObject()` usage in TSL
  5. 05Update WebGPURenderer to use `getOutputBufferType()`
view source on github->
r181highbreakingdeprecationmigrationfeatureNov 19, 2025

r181

This release introduces several improvements and fixes across the library, including updates to WebGLRenderer, WebGPURenderer, and various material and node enhancements. Notable changes include the removal of WebGL 1.0 compatibility code and the introduction of multi-scattering energy compensation for direct lighting.

affected

Developers using WebGL 1.0 or async methods in WebGPURenderer will need to migrate to newer APIs.

action

Update your code to remove WebGL 1.0 compatibility and replace deprecated async methods in WebGPURenderer.

release_signals
-WebGL 1.0 compatibility code has been removed.
-Deprecation of `renderAsync()`, `computeAsync()`, and related async methods in WebGPURenderer.
!`renderAsync()`, `computeAsync()`, and related async methods in WebGPURenderer are deprecated.
!`waitForGPU()` method in WebGPURenderer has been removed.
+MeshMatcapMaterial now supports wireframe.
+PMREMGenerator implements GGX VNDF importance sampling.
+WebGLRenderer uses DFG LUT instead of analytical approximation.
+WebGPURenderer introduces `CanvasTarget` and `Inspector`.
+Multi-scattering energy compensation for direct lighting in WebGLRenderer and WebGPURenderer.
migration_steps2 steps
  1. 01Migrate from WebGL 1.0 compatibility code to WebGL 2.0 or WebGPU.
  2. 02Replace deprecated async methods in WebGPURenderer with synchronous alternatives.
view source on github->
r180mediumbreakingdeprecationmigrationfeatureSep 3, 2025

r180

This release focuses on cleanup, bug fixes, and improvements across various modules, including WebGPU, TSL, and material handling. Notable additions include HDR support and texture offset features.

affected

Users relying on deprecated APIs or RGBMLoader will need to update their code.

action

Review the migration guide and update deprecated code.

release_signals
-Removed deprecated code globally
-Deprecated `premultipliedGaussianBlur()` in TSL
!Deprecated `premultipliedGaussianBlur()` in TSL
!Removed RGBMLoader
+Added HDR support in WebGPURenderer
+Introduce `uniformFlow()` in TSL
+Add `SubgroupFunctionNode` with compute reduction demo
+Support `ExternalTexture` with `GPUTexture` in WebGPURenderer
+Add texture offset feature in TSL
migration_steps1 steps
  1. 01Refer to the migration guide for changes from r179 to r180
view source on github->