@wklm/detect

@wklm/detect

Detect the iOSWebBLE Safari extension on iOS. Auto-show an install banner when the extension is not found. No-op on all other platforms.

Install

npm install @wklm/detect

Usage

import { initIOSWebBLE } from '@wklm/detect';

await initIOSWebBLE({
  operatorName: 'FitTracker',
  banner: { mode: 'sheet', dismissDays: 14 },
  onReady: () => console.log('Extension active'),
  onNotInstalled: () => console.log('Prompting install'),
});

For React/Next.js:

import { IOSWebBLEProvider } from '@wklm/detect/react';

export default function Layout({ children }) {
  return <IOSWebBLEProvider>{children}</IOSWebBLEProvider>;
}

For plain HTML (no bundler):

<script src="https://ioswebble.com/webble.js"></script>

API

• initIOSWebBLE(options) -- detect extension, show banner, fire callbacks
• isIOSSafari() -- returns true on iOS Safari
• isExtensionInstalled() -- async check for the extension marker
• showInstallBanner(options) / removeInstallBanner() -- manual banner control

AI agent integration

MCP server for coding agents (Claude Code, Cursor, Copilot):

npx -y @wklm/mcp

Full SDK reference for LLM context: https://ioswebble.com/llms-full.txt

Two scopes

The @wklm/* packages (core, profiles, react) are the cross-browser BLE SDK -- they work on any platform with Web Bluetooth support (Chrome, Edge, iOS Safari via the extension). The @wklm/* packages (detect, cli, mcp, skill) handle iOS-specific extension detection, install prompts, and agent tooling. Use both together for full iOS Safari coverage.