• 8c487a1: update CHANGELOG with new version (Anton Lavrevov)
• 46ac72c: build for 10.2.3 (Anton Lavrevov)
• 811d62a: update cdn link (Anton Lavrevov)
• 2528fb0: fixed fire execution order (Anton Lavrevov)
• 7d704c0: update CHANGELOG with new version (Anton Lavrevov)
• d69786e: build for 10.2.4 (Anton Lavrevov)
• 5193253: update cdn link (Anton Lavrevov)

After years of development, Phaser 4 is here. This is the biggest release in Phaser's history - a ground-up rebuild of the WebGL renderer with a completely new architecture, while keeping the API you know and love.

• New Render Node Architecture - The v3 pipeline system has been replaced with a clean, node-based renderer. Each render node handles a single task, WebGL state is fully managed, and context restoration is built in. Faster, more reliable, and much easier to extend.
• Unified Filter System - FX and Masks from v3 are now a single, powerful Filter system. Apply filters to any game object or camera with no restrictions. Ships with Blur, Glow, Shadow, Pixelate, ColorMatrix, Bloom, Vignette, Wipe, ImageLight, GradientMap, Quantize, Blend, and many more.
• SpriteGPULayer - Render a million sprites in a single draw call, up to 100x faster than standard rendering. GPU-driven animations on position, rotation, scale, alpha, tint, and frame.
• TilemapGPULayer - Render an entire tilemap layer as a single quad. Per-pixel shader cost means up to 4096 x 4096 tiles with no performance penalty. Perfect texture filtering with no seams.
• Overhauled Tint System - Six tint modes: MULTIPLY, FILL, ADD, SCREEN, OVERLAY, HARD_LIGHT. Color and mode are now separate concerns.
• New Game Objects - Gradient, Noise (Cell 2D/3D/4D, Simplex 2D/3D), CaptureFrame, and Stamp.
• Improved Lighting - As simple as sprite.setLighting(true). Self-shadows, explicit light height, works across most game objects.
• Shader and TileSprite Improvements - Cleaner config-based Shader API, #pragma GLSL directives, TileSprite now supports atlas frames and tile rotation.
• AI Agent Skills - 28 comprehensive skill files included in the repository covering every major Phaser subsystem, plus a dedicated v3 to v4 migration skill. Point your AI coding agent at the skills/ folder for deep Phaser 4 knowledge.

npm install phaser

• 📖 Full Changelog
• 🔄 Migration Guide (v3 to v4)
• 📚 API Documentation](https://docs.phaser.io)
• 🎮 Examples
• 💬 Discord

Phaser wouldn't have been possible without the fantastic support of the community. Thank you to everyone who supports our work, who shares our belief in the future of HTML5 gaming, and Phaser's role in that.

Happy coding everyone!

Rich and the whole team at Phaser Studio

2026-04-10

• Components [input] add count-graphemes (#12041 by @btea)
• Components [dialog] bring clicked dialog to front (#23863 by @snowbitx)
• Components [input] expose passwordVisible (#23921 by @snowbitx)
• Components [button] support custom color with link/text (#24005 by @LostElkByte)

• Using csstype type ts error (#23887 by @btea)
• Components [checkbox] reset selection state when model is null (#23856 by @zuwenyin)
• Hooks [use-timeout] avoid window usage in SSR (#23907 by @iml885203)
• Components [time-picker] allow clearing time via keyboard when using is-range (#23878 by @IceMooncake)
• Components [cascader] trigger before-filter on empty query (#23898 by @snowbitx)
• Components [form] reset stale props on dynamic fields (#23706 by @l246804)
• Components [scrollbar] sync offsets while resize (#23853 by @ZacharyBear)
• Components [table-v2] add slot typings (#23948 by @DDDDD12138)
• Components [table] lingering row background when layout changes (#23961 by @rzzf)
• Build compatible with generic components (#23968 by @btea)
• Components [cascader] prevent selecting first leaf node on ArrowDown (#23954 by @lw56777)
• Components [scrollbar] incorrect boundary detection float number (#23971 by @btea)
• Deps update dependency @eslint/markdown to v8 (#23985 by @renovate[bot])
• Components [select/v2] prevent blur close on modified mousedown (#23969 by @rzzf)
• Components [message] fix offset position anomaly (#23988 by @qeTM)
• Deps update dependency globals to v17 (#23992 by @renovate[bot])
• Deps update dependency eslint-plugin-jsonc to v3 (#23991 by @renovate[bot])
• Deps update dependency consola to v3 (#23997 by @renovate[bot])
• Deps update dependency eslint-plugin-unicorn to v64 (#23998 by @renovate[bot])
• Deps update dependency @pnpm/logger to v5 (#23987 by @renovate[bot])
• Deps update eslint monorepo to v10 (major) (#24002 by @renovate[bot])

• Components [calendar,data-picker] unify using constants (#23868 by @micaiguai)
• Components [mention] make component generic (#23926 by @rzzf)
• Components [transfer] make component generic (#23666 by @Dsaquel)
• Components cleanup defineProps types (#23934 by @rzzf)
• Components [autocomplete] make component generic (#23927 by @snowbitx)
• Components [mention/autocomplete] remove references marked as deprecated (#23970 by @rzzf)

• HeadMenu: 支持横向菜单过多时自动折叠隐藏并展示更多按钮的效果。⚠️存在顶部菜单过多场景的业务请注意此变更 @Wesley-0808 @uyarn (#6530)
• RadioGroup: 新增 direction API，支持添加垂直排列特性。⚠️请注意，目前该属性仅在 theme 为 radio 时完整生效 @JefferyHcool (#6568)

• DateRangePicker: 修复在值未变化时错误触发 onChange 回调的问题 @JefferyHcool (#6551)
• EnhancedTable: 修复树状表格的列配置在 computed/ref 场景下无响应式的问题 @JefferyHcool (#6578)
• InputNumber: 修复失焦时，空值被错误回填为最小值的问题 @JefferyHcool (#6582)
• Select: 修复在 onSearch 中更新相同的选项，没有正常更新 UI 展示内容的问题 @LavenderDuskGlow (#6535)
• Table: 修复在弹窗内的分页表格滚动条错位的问题 @LavenderDuskGlow (#6536)
• Tag: 修复 icon 的尺寸大小,对齐设计稿，大尺寸是16px, 中小尺寸是14px @liweijie0812 (#6589)
• TagInput: 修复 excessTagsDisplayType="break-line" 时，suffix 没有固定在右侧的问题 @RylanBot (#6585)
• Transfer: 修复选项内容为对象时选中异常的问题 @hobostay (#6587)

• HeadMenu: Supports automatic folding and hiding when there are too many horizontal menu items, allowing more buttons to be displayed. @Wesley-0808 @uyarn (#6530)
• RadioGroup: Added the direction API to support vertical layout configuration. Please note that this feature currently works in conjunction with the radio theme only. @JefferyHcool (#6568)

• DateRangePicker: Fixed an issue where the onChange callback was triggered unnecessarily when the value didn’t change. @JefferyHcool (#6551)
• EnhancedTable: Fixed a problem where column configurations in tree-based tables weren’t responsive when used with computed/ref. @JefferyHcool (#6578)
• InputNumber: Fixed an issue where the field became empty after losing focus, but was incorrectly reset to its minimum value. @JefferyHcool (#6582)
• Select: Fixed an issue where updating the same option in onSearch didn’t update the UI properly. @LavenderDuskGlow (#6535)
• Table: Fixed an issue where the scroll bars in pagination tables within pop-ups were misaligned. @LavenderDuskGlow (#6536)
• Tag: Fixed the icon size to match the design specifications: 16px for large icons and 14px for small icons. @liweijie0812 (#6589)
• TagInput: Fixed an issue where the suffix wasn’t displayed on the right side when excessTagsDisplayType="break-line" was set. @RylanBot (#6585)
• Transfer: Fixed an issue related to selection behavior when the option value was an object. @hobostay (#6587)

• Fix two ES5-environment regressions in the anonymous default export .name fix-up: the generated code referenced an undeclared __WEBPACK_DEFAULT_EXPORT__ binding causing ReferenceError, and used Reflect.defineProperty which is not available in pre-ES2015 runtimes. The fix-up now references the real assignment target and uses Object.defineProperty / Object.getOwnPropertyDescriptor. (by @xiaoxiaojx in #20796)

• Prevent !important from being renamed as a local identifier in CSS modules. (by @xiaoxiaojx in #20798)

• Use compiler context instead of module context for CSS modules local ident hashing to avoid hash collisions when files with the same name exist in different directories. (by @xiaoxiaojx in #20799)

• Don't swallow strings thrown in Server Components: #92592

Huge thanks to @eps1lon for helping!

• Add next internal upload-trace: #92191
• Perf: Add fast path to isAbsoluteUrl: #91389
• Perf: Don't require watchpack in production: #91387
• Request logging: Fix generate-params time being included in next.js time: #91386
• Perf: Use charCodeAt in removeTrailingSlash: #91384
• Perf: Cache regex in shouldServeStreamingMetadata: #91388
• fix: scope "Pages Router only" comment to default export in next/error: #92566
• Turbopack Build: Remove dev fouc from production bundle: #80935
• fix(hmr): reconnect WebSocket after sleep/wake: #91416
• Handle target option in React Compiler for Pages + React 18: #91500
• [turbopack] Rust dependency caching via sccache: #91873
• trace: detect rage restarts and deleted .next dirs: #92489

• turbo-tasks-backend: prevent duplicate task restores with restoring bits: #92389
• docs: update details about unstable_retry() behavior: #91827
• docs: link updateTag from cacheTag reference: #92379
• [test] Stop using deprecated target: "es5" TypeScript compiler option: #92458
• Docs: Instant docs updates: #92515
• Turbopack: Improve unable to resolve next error: #91394
• [test] Ensure incomplete minimum release age isn't propagated to fixture installs: #92568
• test: skip .next and other build artifacts in writeFiles filter: #92578
• Replace wasmer with wasmtime for SWC plugin WASM engine: #91533
• docs: native db drivers with sync queries: #92572
• turbopack: fix incremental build when module factories are restored from persistent cache: #92569
• CI: Another attempt to fix pnpm versions for next-stats-action on canary: #92550
• [turbopack] fix a debug_assert failure: #92581

Huge thanks to @sokra, @timneutkens, @devjiwonchoi, @aurorascharff, @eps1lon, @lukesandberg, @icyJoseph, @bgw, @mmastrac, and @wbinnssmith for helping!

Release 2026-04-09 19:33

• transformAssets (#7023) (d81d21ad05) by @birkskyum
• transformAssets (#7009) (6164816414) by @schiller-manuel

• adjust pre-release ranges to use caret (#7130) (72ebb55236) by @birkskyum
• preserve render-thrown notFound errors (#7077) (796406da66) by @schiller-manuel
• router-core: stop preload after beforeLoad errors (#7075) (2d1ec865a4) by @schiller-manuel
• initialize import.meta.hot.data before storing stable split componts (#7074) (f8351a8d7a) by @schiller-manuel
• router-core: align calculation of publicHref in parseLocation and buildLocation (#7069) (30835cb8e9) by @nlynzaad
• preserve scroll position after SSR hash hydration (#7066) (6ee0e795b0) by @schiller-manuel
• scroll restoration upon browser forward navigation (#7055) (42c3f3b3a3) by @schiller-manuel
• dont use script tag for OnRendered (#7054) (5ca661c2f8) by @schiller-manuel
• Fix file-based route generation when custom routeToken or `ind… (#7048) (70b2225137) by @schiller-manuel
• unexported ShouldBlockFnLocation interface causes TS4023 (#7037) (a1ab264634) by @six-standard
• scroll restorating without throttling (#7042) (cf5f554247) by @schiller-manuel
• add tsconfig.server-entry.json to fix missing declaration files … (#7035) (5016e4e4c7) by @dgreif
• dedupe repeated css assets in the start manifest (#7030) (ed9c43df7a) by @schiller-manuel
• vite preview streaming (#6828) (6077120efa) by @huseeiin
• strip invariant and warning strings from prod bundles (#7007) (c9e18555f3) by @Sheraff
• better react HMR (#7005) (d7445e048d) by @schiller-manuel
• solid-router: avoid HeadContent remounts on history.replaceState (#6998) (0d11d5e494) by @Sheraff
• Fix React Fast Refresh state preservation for auto code-split ro… (#7000) (9351e99796) by @schiller-manuel
• start-plugin-core: improve rollupOptions/rolldownOptions handling (#6985) (0f585d5289) by @birkskyum
• router-cli: pass process.argv to yargs to fix silent CLI failure (#6981) (e5d23ecd5c) by @birkskyum

• router: remove global file route helpers (#7026) (7640f6e3f5) by @Sheraff
• signal based reactivity (#6704) (054523900b) by @Sheraff

• update TanStack Store to 0.9.3 (#7041) (71a8b684c8) by @Sheraff
• upgrade tooling to typescript 6 (#7024) (b1c0f4602d) by @birkskyum
• update TanStack store packages to 0.9.2 (#6993) (91cc62899b) by @Sheraff
• migrate benchmarks to Vite 8 (#6986) (7f38aac99b) by @Sheraff

• @tanstack/solid-router@2.0.0-beta.11
• @tanstack/solid-router-devtools@2.0.0-beta.8
• @tanstack/solid-router-ssr-query@2.0.0-beta.13
• @tanstack/solid-start@2.0.0-beta.12
• @tanstack/solid-start-client@2.0.0-beta.11
• @tanstack/solid-start-server@2.0.0-beta.11

• Ads: Fix playback of X-ASSET-LIST with X-PLAYOUT-LIMIT on Live (#9915) (db347c4)
• Correctly extract file extension from URLs with dots in query params (#9946) (82f8c7a)
• Include isSwitchingContent in UnloadingEvent when load replaces existing content (#9934) (c6fbd49)
• Properly clone nested cues and CueRegion in Cue.clone() (#9940) (7a34733)
• StreamingEngine: correct variable reference in discardReferenceByBoundary_() (#9943) (8686858)
• TTML: sanitize backgroundImage URL to prevent CSS injection (#9929) (37dc7e7)
• UI: Fix seek using keyboard when the UI is hidden (#9933) (34dd855)
• UI: Improve touch handling for single and double tap actions (#9937) (22322ea)
• UI: Improve touch handling for single and double tap actions (#9944) (0578325)
• wrong variable reference in discardReferenceByBoundary_() causing (8686858)

• MSF: Reduce live latency to one segment (#9947) (2fa803f)
• replace shift lpop with binary search (#9936) (bab2b25)

• Correctly extract file extension from URLs with dots in query params (#9946) (f91692c)
• StreamingEngine: correct variable reference in discardReferenceByBoundary_() (#9943) (69636ef)
• TTML: sanitize backgroundImage URL to prevent CSS injection (#9929) (f18d2b1)
• wrong variable reference in discardReferenceByBoundary_() causing (69636ef)

• replace shift lpop with binary search (#9936) (1d2129e)