NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #5639 most downloaded on pub.dev
Haptic feedback, vibration and animated haptic widgets for Flutter on Android and iOS: impact, notification, selection, custom waveforms and Core Haptics patterns.
Latest stable
2.3.1
Last release 19 days ago
03 Nov 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 11 of 11 stable releases
Nothing withdrawn
no release was ever pulled
6 months old
11 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
iOS stops CHHapticEngine when the app is suspended, on audio-session interrupts and on idle timeout. Patterns and waveforms then stayed silent for the
iOS stops CHHapticEngine when the app is suspended, on audio-session interrupts
and on idle timeout. Patterns and waveforms then stayed silent for the rest of
the process, because nothing restarted the engine.
Track the stop and restart the engine before the next play. A failed restart
stays pending, so it is retried instead of silencing haptics for good. The rules
live in EngineRestartTracker, which has no CoreHaptics dependency and is tested
in CI, and CI now also builds a new app with the plugin on iOS and Android.
Co-authored-by: Kayke kaykenogueira7@gmail.com
CHHapticEngine when the app is suspended (and on audio-session
interrupts and idle timeouts), and the handler kept reusing the stopped
instance, so every later start(atTime:) failed inside the swallowed
do/catch. The stop is now tracked in stoppedHandler and the engine is
started again before the next play, and a restart that fails after a
haptic server reset is retried the same way. No API change. Thanks
@Kayke-ns.Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Fully backward compatible: every change is additive or a bug fix. No existing signature, return type or class member changed, no new required paramete
Fully backward compatible: every change is additive or a bug fix. No existing signature, return type or class member changed, no new required parameter was added, and no existing call path throws anything new.
Haptics.semantic(SemanticHaptic): name the UI event (confirm,
reject, toggleOn, toggleOff, gestureStart, gestureEnd,
gestureThresholdActivate, gestureThresholdDeactivate, dragStart,
segmentTick, segmentFrequentTick, longPress) and play each
platform's native signal for it. Android uses View.performHapticFeedback,
which respects the user's touch-feedback setting, with the API 30 and
API 34 HapticFeedbackConstants where available and the closest older
constant below that. iOS maps each value to the closest
UIFeedbackGenerator.HapticComposition and HapticPrimitive: Android 11+ composition
primitives (click, tick, lowTick, quickRise, slowRise,
quickFall, thud, spin) with per-primitive scale and delay. Played
natively when the vibrator supports every primitive in the composition,
otherwise approximated as a whole with intensity and sharpness events
(Core Haptics on iOS, a waveform on Android).HapticComposition.supportedPrimitives(): the primitives the vibrator
renders natively (Android 11+; always empty on iOS). A new static query,
so HapticCapabilities itself is unchanged.VibrationException (no plugin on web or desktop, a native failure, an
unmocked channel in widget tests) is now absorbed and the widget keeps
animating and calling its callbacks. Direct Haptics, Vibration and
HapticPattern calls still throw as before.Vibration.vibrateWaveform with a negative timing no longer
pulls every later event earlier, down to a negative start time. The iOS
waveform now treats negative timings as 0. No new exceptions: the Dart
call does not validate negative timings, so behavior on Android is
exactly as in 2.2.0.HapticBounce,
HapticPulse, HapticCapabilities, HapticEvent and HapticEvent.toMap.^2.3.0.ios/haptic_kit package and duplicated the one
Flutter generates, so flutter build ios failed. It also opts in to SPM in
its own pubspec, since it has no Podfile.flutter pub get no longer leaves the tree dirty.Added HapticSettings, an app-wide switch for every haptic in the package. HapticSettings.enabled = false turns each Haptics, Vibration, VibrationPatte
HapticSettings, an app-wide switch for every haptic in the package.
HapticSettings.enabled = false turns each Haptics, Vibration,
VibrationPatterns and widget call into a no-op without a check at the
call site. Disabled calls are skipped before the method channel, so an app
whose user turned haptics off makes no platform calls at all.Vibration.cancel() and capability queries still reach the platform while
disabled: stopping something already running, or reading what the device
supports, is not playback.HapticSettings.capabilities, a cached read of
HapticCapabilities.query(). A failed query is not cached, so a transient
error cannot pin an "unsupported" answer for the session.
resetCapabilitiesCache() clears it, cachedCapabilities exposes it
synchronously, and HapticCapabilities.query() still bypasses the cache.HapticSettings.isAvailable, covering both the device's vibrator and
the app's own preference in one check.flutter_lints to ^6.0.0.All notable changes to this project will be documented in this file.
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Set the pubspec documentation: field so the pub.dev "Documentation" link points to the hosted docs at codigee.com/open-source/haptic-kit.
documentation: field so the pub.dev "Documentation" link
points to the hosted docs at codigee.com/open-source/haptic-kit.Hosted documentation on the Codigee open-source site — README now links to the overview, animated widgets and patterns & haptics API pages.
Add HapticPulse — a looping breathing-scale pulse that fires a haptic impact on every beat, the attention-getter counterpart to HapticShake. Auto-play
Add HapticPulse — a looping breathing-scale pulse that fires a haptic
impact on every beat, the attention-getter counterpart to HapticShake.
Auto-plays, supports finite pulseCount, and exposes start()/stop() via
GlobalKey. No new native code; composes the existing Haptics.impact
primitive. Includes docs, barrel export, README section and widget tests.
Replace auto-tag.yml with release.yml: pushes to main auto-bump the patch
version (unless already bumped) and tag, with tags pushed via a deploy key
so publish.yml fires.
HapticPulse widget — a looping "breathing" scale pulse that fires a
haptic impact on every beat, the attention-getting counterpart to the
one-shot HapticShake. Auto-plays on mount (autoPlay), loops forever or
for a fixed number of beats (pulseCount), and exposes start() / stop()
/ isPulsing via GlobalKey<HapticPulseState> for manual control.
Configurable minScale, maxScale, period, impactStyle and a
visual-only haptics: false mode. No new native code — composes the
existing Haptics.impact primitive.Swift Package Manager support — added ios/haptic_kit/Package.swift and a ios/haptic_kit/Sources/haptic_kit/ directory holding the plugin's Swift sourc
ios/haptic_kit/Package.swift and a
ios/haptic_kit/Sources/haptic_kit/ directory holding the plugin's Swift
sources (moved from ios/Classes/). Flutter 3.44+ projects can now resolve
this plugin via SPM; CocoaPods continues to work unchanged.1.x or raise their own deployment
target. The plugin's runtime APIs are still guarded for iOS 13.0+ (Core
Haptics), but the SPM tooling and example require iOS 15.0.ios/Classes/ to ios/haptic_kit/Sources/haptic_kit/
and updated the podspec source_files accordingly.IPHONEOS_DEPLOYMENT_TARGET (and Podfile platform) is
15.0 or higher before upgrading to 2.0.0.feat: add VibrationPatterns.doubleTap(); bump to 1.0.1
feat: add VibrationPatterns.doubleTap(); bump to 1.0.1
VibrationPatterns.doubleTap() — two quick equal taps for double-tap
acknowledgement feedback.Promotes haptic_kit to a stable 1.0.0 release. Public API is now considered stable; breaking changes from this point will require a MAJOR version bump…
Promotes haptic_kit to a stable 1.0.0 release. Public API is now considered stable; breaking changes from this point will require a MAJOR version bump per Semantic Versioning.
pub.dev rejected 'flutter_haptics' as too similar to the abandoned 'flutter_haptic' package (last update 4 years ago). Renaming to 'haptic_kit' which
pub.dev rejected 'flutter_haptics' as too similar to the abandoned 'flutter_haptic' package (last update 4 years ago). Renaming to 'haptic_kit' which matches the workspace convention (unity_kit) and is free on pub.dev.
Identifier changes:
Package name: flutter_haptics -> haptic_kit
Import: package:haptic_kit/haptic_kit.dart
Method channel: dev.erykkruk/haptic_kit
Android package + plugin class: dev.erykkruk.haptic_kit.HapticKitPlugin
iOS plugin class: HapticKitPlugin
Dart channel class: HapticKitChannel
Version 0.1.2 (0.1.1 was tagged but never published).
flutter_haptics to haptic_kit because the
former was rejected by pub.dev as too similar to the abandoned
flutter_haptic package. The repository URL is unchanged.HapticKitPlugin (Android Kotlin
HapticKitChannel (Dart), Android package
dev.erykkruk.haptic_kit, method channel dev.erykkruk/haptic_kit.package:haptic_kit/haptic_kit.dart.haptic_kit 0.1.2.