flutter_hooks changelog | Flutter package

0.21.3+1 - 2025-08-19 #

Updated Discord link

0.21.3 - 2025-08-12 #

Deprecated useExpansionTileController in favor of useExpansibleController.
Added useCupertinoTabController thanks to @Erengun
Added useSnapshotController thanks to @benthillerkus
Added descendantsAreTraversable to useFocusNode thanks to @gabber235

0.21.2 - 2025-02-23 #

Add useCarouselController (thanks to @riscait)
Add useTreeSliverController (thanks to @benthillerkus)
Added useOverlayPortalController (thanks to @offich)
Add animationDuration property to useTabController hook (thanks to @d-polikhranidi)

0.21.1-pre.4 - 2024-08-01 #

Added useFixedExtentScrollController (thanks to @whynotmake-it)

0.21.1-pre.3 - 2024-07-30 #

Added useOnListenableChange (thanks to @whynotmake-it)

0.21.1-pre.2 - 2024-07-22 #

Added onAttach and onDetach to useScrollController and usePageController (thanks to @whynotmake-it)

0.21.1-pre.1 - 2024-07-08 #

Added useDraggableScrollableController (thanks to @dickermoshe)
Fix TickerMode not getting muted by hooks (thanks to @dev-tatsuya)

0.21.1-pre.0 #

Bump minimum Flutter SDK to 3.21.0-13.0.pre.4

0.21.0 - 2024-03-22 (retracted) #

Renamed useMaterialStatesController to useWidgetStatesController to follow the rename in Flutter.

0.20.5 - 2024-02-05 #

Deprecate the useIsMounted hook as you should use BuildContext.mounted instead if you're on Flutter 3.7.0 or greater

0.20.4 - 2023-12-29 #

Added useDebounced (thanks to @itisnajim)
Removed @visibleForTesting on HookMixin

0.20.3 - 2023-10-10 #

Added useExpansionTileController (thanks to @droidbg)
Added useMaterialStatesController (thanks to @AdamHavlicek)

0.20.2 - 2023-10-02 #

Fixed key matching algorithm incorrectly not checking all keys if a 0 or a NaN is present (thanks to @AlexDochioiu)

0.20.1 - 2023-08-29 #

useListenableSelector now supports null listeners (thanks to @JWo1F)

0.20.0 - 2023-07-25 #

Breaking: keys comparison has changed under the following conditions:
- Change from double.nan to double.nan preserves the state.
- Change from 0.0 to -0.0 or vice versa does NOT preserve the state.
Added useOnStreamChange (thanks to @jezsung)

0.19.0 - 2023-07-10 #

Added useSearchController (thanks to @snapsl)
Keys on useCallback are now optional, to match useMemoized (thanks to @jezsung)
Update usePlatformBrightness to stop relying on deprecated code

0.18.6 #

Added korean translation (thanks to @sejun2)
Add useFocusScopeNode hook (thanks to @iamsahilsonawane)

0.18.5+1 #

Update links to the repository

0.18.5 #

Added useListenableSelector, similar to useListenable, for listening to a Listenable but rebuilding the widget only if a certain data has changed (thanks to @ronnieeeeee)
Added useAutomaticKeepAlive (thanks to @DevNico)
Added usePlatformBrightness and useOnPlatformBrightnessChange to interact with platform Brightness (thanks to @AhmedLSayed9)

0.18.4 #

Upgrade to Flutter 3.0.0

0.18.3 #

Added onKeyEvent to useFocusNode (thanks to @kdelorey)

0.18.2+1 #

Improved the documentation (thanks to @Renni771)

0.18.2 #

Allow null in useListenable

0.18.1 #

Added useTransformationController, to create a TransformationController (thanks to @shrouxm)
Added useAppLifecycleState and useOnAppLifecycleStateChange to interact with AppLifecycleState (thanks to @francipvb)

0.18.0 #

Breaking: useRef now receive an initial value as parameter. To migrate, you can change:
```
ObjectRef<int> ref = useRef<int>();
```
to:
```
ObjectRef<int?> ref = useRef<int?>(null);
```
Updated useStream/useFuture to match the behavior of StreamBuilder/FutureBuilder regarding initial values.
Added a reverseDuration parameter to useAnimationController

0.17.0 #

useFuture/useStream's AsynsSnapshot now correctly expose the StackTrace when there is an error.
added useRef and useCallback, similar to the React equivalents.
initialData of useStream and useFuture is now optional.

0.16.0 #

Stable null-safety release

0.16.0-nullsafety.0 #

Migrated flutter_hooks to null-safety (special thanks to @DevNico for the help!)

0.15.0 #

Added usePageController to create a PageController

0.14.1 #

Increased the minimum version of the Flutter SDK required to match changes on useFocusNode

The minimum required is now 1.20.0 (the stable channel is at 1.20.4)

0.14.0 #

added all FocusNode parameters to useFocusNode
Fixed a bug where on hot-reload, a HookWidget could potentially not rebuild
Allow hooks to integrate with the devtool using the Diagnosticable API, and implement it for all built-in hooks.

0.13.1 #

useIsMounted now returns a function instead of a callable class.

0.13.0 #

Added useIsMounted to determine whether a widget was destroyed or not (thanks to @davidmartos96)

0.12.0 #

Added useScrollController to create a ScrollController
added useTabController to create a TabController (thanks to @Albert221)

0.11.0 #

Breaking change:

Removed HookState.didBuild. If you still need it, use addPostFrameCallback or Future.microtask.

Non-breaking changes:

Fix a bug where the order in which hooks are disposed is incorrect.

It is now allowed to rebuild a HookWidget with more/less hooks than previously. Example:

Widget build(context) {
  useSomething();
  if (condition) {
    return Container();
  }
  useSomething()
  return Container();
}

Deprecated Hook.use in favor of a new short-hand use. Before:
```
Hook.use(MyHook());
```
After:
```
use(MyHook());
```

0.10.0 #