Skip to content
pubscout

dpad

3.3.0, released 3 weeks ago by fluttercandies.com

D-pad navigation and focus management for Flutter TV apps.

WASM-ready
$ flutter pub add dpad
Source repository

What it does

Provides production-grade D-pad navigation, focus regions with memory, TV-correct directional traversal, and remote-key handling for Flutter applications targeting TV platforms. It replaces Flutter's default focus engine to properly support regions, beam-based traversal, edge controls, and remote semantics.

AI-written summary of version 3.3.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • Building an app for Android TV, Fire TV, or Apple TV using Flutter.
  • Needing memory inside focus regions so returning to a row restores the previously selected item.
  • Managing complex spatial directional navigation and remote control inputs.

Skip it when

  • Building standard mobile or desktop applications that do not rely on remote control or D-pad input.
  • Needing advanced non-TV gamepad mechanics unrelated to spatial focus management.

Strengths

  • Regions with memory that survive rebuilds and lazy lists.
  • Beam-based traversal mimicking real TV platforms like Android Leanback.
  • Built-in visual effects including animated flying highlights and custom focus states.

Weaknesses

  • Specific to TV and D-pad/remote-controlled interfaces, rendering it largely irrelevant for typical touch-first mobile designs.
  • Requires wrapping the app and managing custom region components instead of relying purely on default Flutter focus nodes.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
1

Wrap the root MaterialApp builder with Dpad.wrap().

MaterialApp(
  builder: Dpad.wrap(),
  home: const HomePage(),
)

Alternatives

Packages that do the same job and could replace dpad.