💍Haptic Harmony

Documentation

Installation

The Haptic Harmony Ring doesn't require any software installation to use out of the box — unbox it, charge it, and pair it. Installing the SDK is only necessary if you're building an integration.

Unbox & Charge

  1. Set the ring on its contact dock — connector-free, no cables to align
  2. Wait for the LED to show steady green (full charge, typically 2–4 hours from empty)
  3. A full charge lasts 3–5 days of typical use

Pair the Ring

  1. Enable Bluetooth on your phone or computer
  2. Put the ring in pairing mode (hold the PAD area for 3 seconds until it pulses)
  3. Select "Haptica B1" from your device's Bluetooth list
  4. The ring supports one active connection at a time — see Device Switching to pair with multiple devices

Install the SDK (Developers)

Nothing is published to npm, PyPI, or crates.io yet — build the TypeScript SDK from source:

git clone https://github.com/gestura-ai/gestura-app
cd gestura-app/sdk/typescript
npm install && npm run build

The SDK (@gestura/ring-sdk) wraps a Rust protocol core compiled to WebAssembly. Rust integrations can depend on the gestura-protocol crate directly from the same repository. A Python SDK is planned but has no code yet.

System Requirements

  • Mobile/desktop: Bluetooth Low Energy 6.0 support
  • SDK build: Node.js 18+ and npm; Rust stable toolchain and Cargo for the protocol core

Troubleshooting

  • LED won't turn green: Confirm the ring is seated fully on the contact dock's pins
  • Ring not found while pairing: Move within 1 meter of your device and retry pairing mode
  • Only one device connects: Expected — firmware supports a single active BLE connection at a time

Next Steps

© 2026 Gestura AI LLC. All rights reserved.