name: pixijs-migration-v8 description: "Use for PixiJS v7 to v8 migration: app.init, pixi.js package imports, Graphics fill/stroke/cut, Texture/BaseTexture changes, events, ticker, shaders, filters, adapters." license: MIT
Use this when upgrading v7 code or diagnosing code that broke after moving to PixiJS v8.
First Pass Checklist
- Replace
new Application(options)withnew Application()plusawait app.init(options). - Replace core
@pixi/*package imports withpixi.jsimports. - Replace
app.viewwithapp.canvas. - Convert Graphics to shape-then-style:
rect(...).fill(...),stroke(...),cut(). - Replace
DisplayObjectinheritance withContaineror a concrete renderable type. - Replace
interactive = truewitheventMode = 'static'or'dynamic'. - Update ticker callbacks to receive the
Tickerobject. - Replace old shader/filter constructors with v8
{ gl, gpu, resources }and typed uniforms. - Replace
settings.ADAPTERwithDOMAdapter.set(...). - Audit texture, mesh, text, particle, enum, and culling changes before shipping.
Deep Reads
- Full migration checklist and code examples: references/details.md
- Graphics API:
pixijs-scene-graphics - Application init:
pixijs-application - Events:
pixijs-events - Shaders/filters:
pixijs-custom-rendering,pixijs-filters
Common Fixes
beginFill,drawRect,lineStyle: useGraphicsv8 methods.Texture.from(url): load withAssets.load(url)first.BaseTextureassumptions: inspect v8TextureSourcebehavior.- Old enum constants: use the new string values where v8 expects strings.