Help Scout's Beacon SDK allows you to embed the same Beacon functionality we have for the web inside your iOS app. Beacons provide a quick and straightforward way for customers to flip through your knowledge base or reach out to your team.
The Beacon SDK 2.0 requires iOS 11.0+.
As of Beacon 2.1.0 Xcode 12 is required to build with the Beacon SDK. Beacon 2.0.x requires Xcode 11.4
Supported platform and language versions
- iOS 11 to 14
- Swift 5
- Xcode 12
Beacon is available through CocoaPods. To install it, add the following line to your
Beacon is currently distributed as a dynamic framework so the
use_frameworks! flag will also need to be present in your Podfile.
Swift Package Manager
As of Beacon 2.1.0, Beacon is (temporarily
Beacons up to version 2.0.2 can be installed using Carthage by adding the following line to your
Cartfile and then following the Carthage installation instructions:
Because of the way Beacon is distributed, attempting to use the
--no-use-binaries flag when building will fail.
Our developer site has information on configuring up your application to work with Beacon's email attachments and push notifications.
This repository includes two sample applications, one written in Objective-C and one written with SwiftUI.
To run the Objective-C example you can cd into the Examples/Obj-C Example directory
cd Examples/Obj-C\ Example, open
Beacon Example.xcodeproj and run the
To run the SwiftUI example you can cd into the Examples/SwiftUI Example directory
cd Examples/SwiftUI\ Example, open
Beacon SwiftUI Example.xcodeproj and run the
Beacon SwiftUI Example scheme. For it to run properly you'll need to provide a valid Beacon identifer on Line 10 of
See our developer site for more customization options available through the SDK.