FrameTickMsg class

Message sent automatically by the TUI runtime every frame.

When ProgramOptions.frameTick is enabled (default), the runtime sends this message at the configured ProgramOptions.fps rate. This drives animations and continuous updates without requiring each application to set up its own tick loop.

The message contains:

• time - When the frame tick occurred
• frameNumber - Monotonically increasing frame counter
• delta - Time since the last frame (useful for smooth animations)

Example

@override
(Model, Cmd?) update(Msg msg) {
  return switch (msg) {
    FrameTickMsg(:final time, :final delta) => (
      copyWith(
        animationProgress: animationProgress + delta.inMilliseconds / 1000.0,
        lastFrameTime: time,
      ),
      null,
    ),
    _ => (this, null),
  };
}

Disabling Frame Ticks

For static UIs that don't need continuous updates, disable frame ticks:

final program = Program(
  MyModel(),
  options: ProgramOptions(frameTick: false),
);