repository·main·Indexed 19 days ago
https://github.com/software-mansion/pulsarA high-fidelity, cross-platform haptic feedback SDK providing consistent tactile experiences across iOS, Android, React Native, Flutter, KMP, and Web. It features three trigger methods: Presets for standard effects, PatternComposer for complex custom sequences using amplitude and frequency envelopes, and RealtimeComposer for gesture-driven, interactive feedback.
Pulsar Studio is a visual haptic editor designed for developers to create custom haptic sequences. It allows you to:
Pulsar is a cross-platform haptic feedback SDK designed for iOS, Android, React Native, Kotlin Multiplatform, Flutter, and the Web. It provides a consistent API for delivering rich tactile feedback through three main mechanisms:
hammer, dogBark, buzz, pulse) and system-level feedback styles (impacts, notifications, selection).For React Native users, all preset functions and hook methods are compatible with Reanimated worklets.
The pulsar-haptics skill assists with several haptic development tasks, including:
expo-haptics, Core Haptics, and VibrationEffect.Pulsar is a haptic feedback SDK for React Native with the following key characteristics:
PulsarApp is a Kotlin Multiplatform (KMP) project targeting Android and iOS. The project structure is organized to facilitate code sharing via Compose Multiplatform:
/composeApp: Contains the shared logic and UI code.commonMain: The primary location for code that is shared across all targets.iosMain, jvmMain): Used for code that requires platform-specific APIs (for example, using Apple's CoreCrypto in iosMain)./iosApp: The entry point for the iOS application. This directory is required even when sharing UI via Compose Multiplatform and is the location for adding SwiftUI code.Since Android lacks a native continuous haptic API, RealtimeComposer uses a strategy to simulate continuous haptics. You can set this via pulsar.getRealtimeComposer(strategy: ...) or pulsar.setRealtimeComposerStrategy(...).
Available strategies in RealtimeComposerStrategy:
envelope: Approximation based on the Envelope API (Android API 36+). Allows amplitude/frequency control but may be unstable.primitiveTick: Uses the Composition API TICK primitive at varying intervals. Amplitude is controllable; frequency is simulated by timing. Signal is discrete.primitiveComplex: Uses multiple primitives depending on the requested frequency.envelopeWithDiscretePrimitives (Default): A hybrid strategy using the Envelope API for continuous events (API 36+) and composition primitives for discrete events (API 33+).AdaptiveHaptics allows you to define a single AdaptivePreset that behaves differently on iOS and Android. This is useful for using native system presets on one platform while using custom PatternData on another.
createAdaptiveHaptics is asynchronous because it pre-parses pattern-based configurations to ensure zero-latency playback. Call dispose() when the instance is no longer needed.
AdaptivePresetCallback: Invokes a callback on play(). Best for triggering native/built-in presets (e.g., pulsar.presets.systemNotificationSuccess()).AdaptivePresetPattern: Plays a specific PatternData on each play() call.final adaptivePreset = AdaptivePreset(
ios: AdaptivePresetCallback(() => pulsar.presets.systemNotificationSuccess()),
android: AdaptivePresetPattern(
PatternData(
continuousPattern: const ContinuousPattern(amplitude: [], frequency: []),
discretePattern: const [
DiscretePoint(time: 0, amplitude: 1, frequency: 0.5),
DiscretePoint(time: 150, amplitude: 0.6, frequency: 0.4),
],
),
),
);
final haptics = await pulsar.createAdaptiveHaptics(adaptivePreset);
await haptics.play();import 'package:pulsar_haptics/pulsar.dart';
final pulsar = Pulsar();
final adaptivePreset = AdaptivePreset(
ios: AdaptivePresetCallback(() => pulsar.presets.systemNotificationSuccess()),
android: AdaptivePresetPattern(
PatternData(
continuousPattern: const ContinuousPattern(
amplitude: [],
frequency: [],
),
discretePattern: const [
DiscretePoint(time: 0, amplitude: 1, frequency: 0.5),
DiscretePoint(time: 150, amplitude: 0.6, frequency: 0.4),
],
),
),
);
final haptics = await pulsar.createAdaptiveHaptics(adaptivePreset);
await haptics.play();customPattern object instead of a presetName, it is a legacy custom pattern. Instead of using a named preset call, you must play it as a raw Pattern. In React Native, this is achieved using the usePatternComposer hook.The react-native-pulsar SDK is built around three primary abstractions for delivering haptic feedback:
Presets: Ready-to-use haptic patterns.usePatternComposer: A hook for composing specific haptic patterns.useRealtimeComposer: A hook for real-time haptic composition.Crucially, all preset functions and hook methods are worklet-compatible, meaning they can be safely used within react-native-reanimated worklets for high-performance, synchronized haptics.
The Pulsar Android SDK is built around three primary abstractions, all of which are accessed through the main Pulsar class:
The useRealtimeComposer hook is designed for gesture-driven haptics, providing live control over haptic intensity. It allows you to update the amplitude and frequency of a continuous haptic effect in real-time based on user interaction (like dragging or scrolling).
set(amplitude, frequency): Updates the current haptic output.stop(): Immediately ceases the haptic feedback.import { useRealtimeComposer } from 'react-native-pulsar';
const { set, stop } = useRealtimeComposer();
// Update haptics live (e.g., inside a gesture handler)
set(0.7, 0.5);
// Stop the haptics
stop();The Pulsar iOS SDK provides haptic feedback using three primary abstractions, all managed via the Pulsar class: