Guides
Performance
Keep Vue away from the hot loop and use the primitive layer honestly.
Performance in this library comes from restraint. Vue is excellent at setup, orchestration, and UI. Phaser is excellent at scene graphs, input, animation, and per-frame updates.
Performance rules
- Do not drive movement or physics from reactive props every frame.
- Prefer scene code, tweens, and raw Phaser APIs for hot-path behavior.
- Keep bridge traffic low-frequency and intent-driven.
- Treat host props as structural configuration, not animation inputs.
- Use object refs and raw scene access when the declarative path starts fighting the runtime.
If a value changes every frame, it probably does not belong in Vue state. Keep the authoritative state inside the scene and project low-frequency snapshots outward.