Chapter 27 — Installing Flame and Your First FlameGame

Flame version used in this chapter: flame 1.38.0 (published July 19, 2026). API verification date: August 8, 2026, against https://docs.flame-engine.org/latest/, https://pub.dev/packages/flame, and the flame-engine/flame repository (main branch). SDK constraints declared by the package: sdk: ">=3.12.0 <4.0.0", flutter: ">=3.44.0".

Level: intermediate Estimated time: 7 h Prerequisites: Chapter 19 (Flutter, runApp, widgets), Chapter 20 (game loop and dt), Chapter 21 (Canvas), Chapter 23 (vectors), Chapter 26 (architecture), and on the Dart side Chapters 12 (null safety) and 15 (asynchronous programming). What you will be able to do by the end: create a Flutter project, install Flame, write a complete FlameGame with onLoad, update, and render, display it in a GameWidget, work with Vector2 without falling into traps, and run the whole thing on Web, Android, and Windows.

27.0 — Chapter Objectives

By the end of this chapter, you will be able to: