Use plain Flutter widgets if your game changes only when the player acts. Use Flame if the world keeps moving on its own while the player watches. A card game, quiz or sudoku is widgets. A ball, a runner or a shooter is Flame.

This is for Flutter developers and game makers deciding before the first line of code. It uses Flutter's own guidance and flame 1.38.2, the latest stable version in October 2026.

In short:

  • Ask: does anything move when the player does nothing?
  • Turn-based games rarely need a game loop.
  • Flame plus a full brick-breaker added about 0.8 MB to the main script of a web build.
  • You can mix both: Flame for play, widgets for menus.

One question sorts almost every game

Flutter's Casual Games Toolkit groups casual games in two. Turn-based games respond to simple input like tapping a card, and "are well suited for Flutter". Real-time games need responses to a series of actions, with things like collision detection, camera views and game loops. For those, Flutter's page points to the Flame engine.

So the test is: does the world keep moving while the player watches? A memory game waits for your tap. A brick breaker does not wait.

Twelve game types and the tool for each

Games you play by tapping and waiting are widgets. Anything with a ball, a runner or enemies on the move is Flame.

Game Use
Tic-tac-toe, chess, checkers Widgets
Memory cards, solitaire-like card games Widgets
Quiz, trivia, word puzzle Widgets
Sudoku, crossword Widgets
Match-3 you swap by tapping Widgets
Brick breaker Flame
Platformer, endless runner Flame
Shooter, snake, asteroids Flame
Tower defense Flame
Flappy-style tapper Flame
Physics toy with bouncing or stacking Flame with Forge2D
Drawing pad CustomPainter

The Casual Games Toolkit itself ships a card game template next to its Flame-based endless runner, which matches this split.

Three games sit in the grey zone

Merge and slide puzzles (a 2048 clone, a ball sort) are discrete moves plus animation. Start with widgets such as GridView and AnimatedContainer. Switch to Flame only if pieces must keep moving after you let go.

A single bouncing object with no collisions, camera or input can be an animation. A CustomPainter driven by a Ticker is enough for that demo. It gets awkward once you add a second moving thing that must react to the first.

A card game with drag and drop can stay widgets, since Flutter handles dragging. Flame's docs also have a Klondike solitaire tutorial, so Flame can do cards too. Choose by whether you want a loop and a camera.

What Flame costs you

Flame is a dependency, and it changes how you structure the game. In our measurements on the GrowApps builder, a release web build of our bare project scaffold had a main script of 1.11 MB. The same app with Flame and a complete brick-breaker game had 1.92 MB, and build time was 24 seconds for both.

Learning cost matters more. You work with components, a world and a camera instead of widgets and layouts. Old tutorials use deprecated classes. The beginner's guide lists the traps.

What a hand-made loop costs you

A hand-rolled loop with a Ticker and a CustomPainter is tempting, since it avoids a dependency. You will then write your own hit testing of shapes, your own collision code, your own camera and your own handling of delta time and pausing.

Flame already provides hitboxes, a collision system, a camera, effects and a tested input system. For a real-time game, that is the better use of your week.

GrowApps's builder follows the same rule: 2D real-time games are built on flame, never on a hand-written loop, and turn-based games stay widgets.

Mix both in one app

A Flame game sits inside a widget called GameWidget. Put it inside a normal Flutter app and use ordinary widgets around it: a home screen, settings, a shop, a leaderboard. Inside the game, Flame overlays show widgets over the play field. That split keeps your game code focused on play.

Check your own game in 10 minutes

Write one sentence about your game: "When the player does nothing, ___ happens." If you can fill the blank with "nothing", build with widgets. If the blank has a moving thing, build a dodge game in Flame first and see how it feels.

Sources and further reading