Guides

Scene-first Design

Understand why the library elevates scenes instead of building a full custom object renderer.

The library is scene-first because Phaser already has a strong scene model. Replacing it with a custom reconciler would make Vue responsible for work Phaser already does well.

What scene-first means here

  • A scene key stays explicit.
  • Scene lifecycle methods stay in Phaser vocabulary.
  • Child primitives wait for scene readiness instead of inventing a new mount graph.
  • Multiple scenes can run in the same game instance.
  • You can always reach the raw scene and use Phaser's own APIs.

That design keeps the abstraction removable. If a scene becomes complex, you can move more logic into raw Phaser without rewriting the host integration.

Copyright © 2026