SuperIslandSuperIsland
API Reference

Feedback & Navigation

Haptic feedback, audio, and URL navigation APIs.

Feedback & Navigation

DynamicIsland.playFeedback(type)

Plays haptic feedback and/or an audio cue. On MacBooks with a Force Touch trackpad, this triggers a haptic vibration.

DynamicIsland.playFeedback("success");

Feedback types

TypeHapticSoundUse when
"success"Light tapSoft chimeTask completed, timer done
"warning"Medium tapAlert toneLow battery, approaching deadline
"error"Heavy tapError toneSomething failed
"selection"Subtle clickNoneButton press, toggle change

Examples

// After successfully fetching data
DynamicIsland.playFeedback("success");

// When a timer expires
DynamicIsland.playFeedback("warning");

// When an action fails
if (res.error) {
  DynamicIsland.playFeedback("error");
}

// On button tap
onAction(id) {
  if (id === "toggle") {
    DynamicIsland.playFeedback("selection");
  }
}

DynamicIsland.openURL(url)

Opens a URL in the user's default browser. Use for deep links, web dashboards, or app URLs.

DynamicIsland.openURL("https://example.com/dashboard");

// Open a Zoom meeting
DynamicIsland.openURL("zoommtg://zoom.us/join?confno=123456789");

// Open in a specific app
DynamicIsland.openURL("spotify://track/4iV5W9uYEdYUVa79Axb7Rh");

The user's default browser or associated app handles the URL. This does not open a webview inside the island.

On this page