pub.dev · #2853 most downloaded on pub.dev

flutter_tilt

4.1.012K downloads/mofluttercandies/flutter_tilt ↗New releases in your daily digest, changelog included.

Easily apply tilt parallax hover effects for Flutter, which supports tilt, light, shadow effects, gyroscope sensors and many custom parameters.

Last release 2 months ago
29 Jul 2026
Release timing varies
gaps range from 8 days to 6 months
Nearly every release is documented
notes for 59 of 59 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
72 releases · first in 2023

Release timeline

72 releases since 2023

2023202420252026

Releases

4.1.029 Jul 20262 sources agree
TiltConfig.perspectiveIntensity: Custom perspective intensity (near-large, far-small). Defaults to a size-adaptive value when null.
New features

TiltConfig.perspectiveIntensity: Custom perspective intensity (near-large, far-small). Defaults to a size-adaptive value when null. (#63)

TiltConfig.zOffset: Offsets the rotation pivot along the Z-axis, creating a subtle tilting and swinging effect. Defaults to 0 (no offset). (#63)
Open source →
4.0.410 Jun 20262 sources agree
Fix copyWith not being able to explicitly set nullable fields to null, e.g. TiltConfig.direction, LightConfig.enableReverse, ShadowConfig.direction /
Fixes

Fix copyWith not being able to explicitly set nullable fields to null, e.g. TiltConfig.direction, LightConfig.enableReverse, ShadowConfig.direction / enableReverse.

One column per quarter.

4.0.39 Jun 20262 sources agree

Fix shadow blur and spread appearing at full strength when centered or at small tilt angles.

Fixes

Fix shadow blur and spread appearing at full strength when centered or at small tilt angles.

Open source →

4.0.24 Jun 20262 sources agree

Fix light/shadow not reaching maxIntensity for the LightDirection.around and LightDirection.all directions. (#42) Now that it is fixed, if the effect

Fixes

Fix light/shadow not reaching maxIntensity for the LightDirection.around and LightDirection.all directions. (#42)
Now that it is fixed, if the effect looks too strong, set maxIntensity to the square of its previous value (e.g. 0.5 → 0.25, 0.6 → 0.36).

Open source →

4.0.14 Jun 20262 sources agree

Isolate tilt repaints with a RepaintBoundary to avoid repainting the parent subtree during animation.

Improvements

Isolate tilt repaints with a RepaintBoundary to avoid repainting the parent subtree during animation. (#41)
Avoid redundant calculations and optimize performance. (#41)

Open source →

4.0.012 May 2026Deprecated2 sources agree

The lightConfig of TiltProjectorContainer is now deprecated. Because the current simulated light effect is not suitable for Projector, it is now disab…

Migration Guide: English | 中文

Breaking changes

Tilt widget now only manages gesture, sensor, and animation state (no UI rendering).
To reproduce the previous default style, you need to compose TiltBaseContainer with Tilt, or use the built-in Tilt.base.
Replace Tilt.TiltStreamController with Tilt.TiltController to unify input stream management.
The previous Tilt.lightShadowMode parameter has been split into the independent widgets TiltBaseContainer and TiltProjectorContainer.
To reproduce the previous style, you need to compose them inside the Tilt widget,
or use Tilt.base and Tilt.projector directly.
ShadowConfig has been split into ShadowBaseConfig and ShadowProjectorConfig.
Rename TiltParallax parameter size to offset.

Deprecations

The lightConfig of TiltProjectorContainer is now deprecated.
Because the current simulated light effect is not suitable for Projector,
it is now disabled by default and will be removed in a future release.

New features

Add TiltAnimatedBuilder to help implement custom tilt logic.

PR #34

Open source →

4.0.0-rc.211 May 2026pre-release

Nothing published for this version

4.0.0-rc.17 May 2026pre-release

Nothing published for this version

3.3.528 Apr 20262 sources agree

Improvements - Updated README.md

Improvements

Updated README.md

Open source →

3.3.48 Apr 20262 sources agree

Simulated light reflection is more natural.

Improvements

Simulated light reflection is more natural.
Avoid redundant calculations and optimize performance.

Fixes

Return moveDuration when enterToMove animation progress >= 1

Open source →

3.3.31 Apr 20262 sources agree

Remove stream_transform package.

Improvements

Remove stream_transform package.

Open source →

3.3.217 Sept 20252 sources agree

Bump sensors_plus package to '>=6.1.0 <8.0.0'.

Improvements

Bump sensors_plus package to '>=6.1.0 <8.0.0'.

Open source →

3.3.128 Aug 20252 sources agree

Reduce unnecessary animation controllers (multiple TiltParallax widgets share the same controller).

Improvements

Reduce unnecessary animation controllers (multiple TiltParallax widgets share the same controller). (#30)

Open source →

3.3.026 Aug 20252 sources agree

By default, add a smooth transition effect when gestures (hover and touch) enter.

New features

By default, add a smooth transition effect when gestures (hover and touch) enter. (#29)
- Configurable via:
  - TiltConfig.enterDuration
  - TiltConfig.moveDuration
  - TiltConfig.enterToMoveDuration
  - TiltConfig.enterToMoveCurve
If you prefer to disable this effect:
```
Tilt(
  tiltConfig: TiltConfig(
    enterToMoveDuration: Duration.zero,
    ...
  )
  ...
)
```

Open source →

3.2.314 Aug 20252 sources agree

Improve performance (e.g. avoid unnecessary variable assignments, ...).

Improvements

Improve performance (e.g. avoid unnecessary variable assignments, ...). (#27)
Refactor code structures. (#27)
The Tilt.fps default value has been changed from 60 to 120. (#27)

Open source →

3.2.231 Jul 20252 sources agree

Improvements - Update example and docs.

Improvements

Update example and docs.

Open source →

3.2.112 Mar 20252 sources agree

Improvements - Bump example to Flutter 3.29 (#24) - Refactor code structures.

Improvements

Bump example to Flutter 3.29 (#24)
Refactor code structures. (#23)

Open source →

3.2.013 Dec 20242 sources agree

Add Tilt.lightShadowMode and configuration.

New features

Add Tilt.lightShadowMode and configuration. (#12)

Improvements

Migrate from withOpacity to withAlpha.

Open source →

3.2.0-rc.211 Dec 2024pre-release

Nothing published for this version

3.2.0-rc.110 Dec 2024pre-release

Nothing published for this version

3.1.021 Oct 20242 sources agree

Bump sensors_plus package from 6.0.0 to 6.1.0.

Improvements

Bump sensors_plus package from 6.0.0 to 6.1.0. (#20)
Migrate the example to Android Studio Ladybug (JDK 21). (#19)

Open source →

3.0.66 Sept 20242 sources agree

Replace Platform (dart:io) with TargetPlatform (flutter/foundation.dart).

Improvements

Replace Platform (dart:io) with TargetPlatform (flutter/foundation.dart). (#18)
Handling when the platform has no available sensors. (#18)

Open source →

3.0.514 Aug 20242 sources agree

Fix Tilt.disable: true still prevents scrolling.

Fixes

Fix Tilt.disable: true still prevents scrolling. (#16)

Open source →

3.0.414 Aug 20242 sources agree

Fix tiltConfig.enableGestureTouch still prevents scrolling when disabled.

Fixes

Fix tiltConfig.enableGestureTouch still prevents scrolling when disabled. (#15)

Improvements

Improve example (Flutter v3.24.0)

Open source →

3.0.330 Jul 20242 sources agree

Bump sensors_plus package from 5.0.1 to 6.0.0.

Improvements

Bump sensors_plus package from 5.0.1 to 6.0.0.

Open source →

3.0.26 Jun 20242 sources agree

Improvements - Improve linter.

Improvements

Improve linter.

Open source →

3.0.111 Apr 20242 sources agree

Upgrade sensors_plus package to 5.0.1.

Improvements

Upgrade sensors_plus package to 5.0.1.
Update Doc.

Open source →

3.0.020 Mar 20242 sources agree

Bumping Flutter SDK minimum version to 3.19.0.

Breaking changes

Bumping Flutter SDK minimum version to 3.19.0.

Improvements

Upgrade sensors_plus package to 5.0.0.

Open source →

2.4.113 Mar 20242 sources agree

Improvements - dart doc.

Improvements

dart doc.

Open source →

2.4.020 Feb 20242 sources agree

Add Tilt.tiltStreamController to provide custom control of the tilt.

New features

Add Tilt.tiltStreamController to provide custom control of the tilt.
Add TiltConfig.controllerMoveDuration, TiltConfig.controllerLeaveDuration.

Improvements

Improve gesture priority logic.
dart doc.

Fixes

Fix assignment usage logic in Tilt.tiltStreamController.
Fix Tilt.tiltStreamController closes prematurely.
Fix sensor listening not closed.

Open source →

2.4.0-beta.318 Feb 2024pre-release

Nothing published for this version

2.4.0-beta.214 Feb 2024pre-release

Nothing published for this version

2.4.0-beta.114 Feb 2024pre-release

Nothing published for this version

2.3.08 Feb 20242 sources agree

Bumping Flutter SDK minimum version to 3.10.0.

Breaking changes

Bumping Flutter SDK minimum version to 3.10.0.

Improvements

Update Versions Compatibility. (Sensors are not supported on the web platform until Flutter version 3.10)

Open source →

2.2.114 Dec 20232 sources agree

Upgrade sensors_plus to version 4.0.2.

Improvements

Upgrade sensors_plus to version 4.0.2.
Improve code structure.

Fixes

Fix onGesturesRevert being called repeatedly after a move has ended.

Open source →

2.2.027 Nov 20232 sources agree

Migrate to Flutter 3.7 and drop support for previous Flutter versions.

Breaking changes

Migrate to Flutter 3.7 and drop support for previous Flutter versions.
Upgrade sensors_plus to v4.x.x. (#6)

Improvements

Improve example (Flutter v3.16.0)

Open source →

2.1.220 Nov 20232 sources agree

Improvements - Improve high energy impact.

Improvements

Improve high energy impact.

Open source →

2.1.116 Nov 20232 sources agree

Update the example to Flutter 3.16.0 and use Material3.

Improvements

Update the example to Flutter 3.16.0 and use Material3.

Open source →

2.1.09 Nov 20232 sources agree

Add spreadFactor to LightConfig.

New features

Add spreadFactor to LightConfig.

Open source →

2.0.1030 Oct 20232 sources agree

Fixes - Fix undetermined mounted.

Fixes

Fix undetermined mounted.

Open source →

2.0.929 Oct 20232 sources agree

Fix device orientation does not match sensor orientation.

Fixes

Fix device orientation does not match sensor orientation.

Open source →

2.0.823 Oct 20232 sources agree

Improvements - Improve README docs

Improvements

Improve README docs

Open source →

2.0.722 Oct 20232 sources agree

Upgrade sensors_plus to version 3.1.0

Improvements

Upgrade sensors_plus to version 3.1.0

Open source →

2.0.62 Oct 20232 sources agree

Improve light above childLayout.inner.

Improvements

Improve light above childLayout.inner.

Fixes

Fix incorrect initialization sizes in some cases (e.g. image with unspecified sizes).

Open source →

2.0.527 Sept 20232 sources agree

Improvements - Improve code structure.

Improvements

Improve code structure.

Open source →

2.0.420 Sept 20232 sources agree

Fix tapping on content causes tilt when enableRevert or enableSensorRevert is false.

Fixes

Fix tapping on content causes tilt when enableRevert or enableSensorRevert is false.

Open source →

2.0.319 Sept 20232 sources agree

Fix device landscape mode not match sensor orientation.

Fixes

Fix device landscape mode not match sensor orientation.

Open source →

2.0.215 Sept 20232 sources agree

Improvements - Config copyWith().

Improvements

Config copyWith().

Open source →

2.0.111 Sept 20232 sources agree

Fixes - Fix initial has no effect.

Fixes

Fix initial has no effect.

Open source →

2.0.07 Sept 20232 sources agree

Bumping Flutter SDK minimum version to 3.3.0.

Breaking changes

Bumping Flutter SDK minimum version to 3.3.0.
Changed enableMouseHover in TiltConfig to enableGestureHover.
To keep the tilt, you need to configure TiltConfig(enableRevert: false, enableSensorRevert: false,).

New features

Add sensor gesture (configuration: enableGestureSensors, sensorFactor, enableSensorRevert, sensorRevertFactor, sensorMoveDuration), default configuration is TiltConfig(enableGestureSensors = true).
Add touch gesture configuration, default is TiltConfig(enableGestureTouch = true).

Improvements