core-bluetooth

Implement Core Bluetooth workflows to scan, connect, and interact with BLE peripherals.

Updated Apr 19, 2026

Search Tags:#ios #macos #core-bluetooth #bluetooth #ble #central-manager

Ready to run

npx skills add https://github.com/femitz/flyby --skill core-bluetooth-femitz

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: core-bluetooth
Source: https://github.com/femitz/flyby/tree/main/.agents/skills/core-bluetooth
Command: npx skills add https://github.com/femitz/flyby --skill core-bluetooth-femitz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps developers implement Bluetooth Low Energy workflows by providing guidance to scan for devices, establish connections, discover services and characteristics, and manage background modes and state restoration.

Core Features & Use Cases

Central and Peripheral roles: scanning, connecting, discovering services/ characteristics, and exchanging data with BLE devices.
Background BLE and state restoration: ensures connectivity and data flow across app relaunches.
Practical patterns: recommended error handling, discovery callbacks, and common pitfalls with CBCentralManager and CBPeripheral.

Quick Start

Launch the Core Bluetooth skill and start scanning for nearby BLE devices, then connect and discover services to begin interaction.

Frequently Asked Questions about core-bluetooth

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I scan and connect to BLE peripherals on iOS?▼

To scan and connect to BLE peripherals on iOS, initialize a CBCentralManager to discover nearby devices, then connect to the desired CBPeripheral to discover its services and characteristics for data exchange.

How does Core Bluetooth state restoration work across app relaunches?▼

Core Bluetooth state restoration preserves BLE connectivity and data flow across app relaunches by using the CBCentralManagerOptionRestoreIdentifierKey to re-establish central and peripheral roles without dropping active sessions.

Can I run Core Bluetooth in the background on macOS and iOS?▼

Yes, Core Bluetooth supports background modes on iOS and macOS, allowing your app to scan, connect, and exchange data with BLE peripherals while running in the background.

What is the difference between central and peripheral roles in BLE development?▼

In BLE development, the central role uses CBCentralManager to scan and connect to devices, while the peripheral role uses CBPeripheralManager to publish services and characteristics for other centrals to discover.

Why is my CBCentralManager not discovering nearby Bluetooth devices?▼

If CBCentralManager is not discovering Bluetooth devices, check for common pitfalls like missing background modes, incorrect state restoration handling, or failing to properly implement discovery callbacks for services and characteristics.