Shake to submit a bug report (w/ screenshot) via email.
Swift Ruby Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
BugShaker.xcodeproj
BugShaker.xcworkspace
Example
Screenshots
Sources
Tests
.gitignore
.hound.yml
.swift-version
.swiftlint.yml
.travis.yml
BugShaker.podspec
CHANGELOG.md
LICENSE
Podfile
Podfile.lock
README.md
banner.png
publish-docs.sh

README.md

BugShaker

Shake to send a bug report!

CI Status Version License Platform Swift Version codecov.io Sponsored by Detroit Labs

BugShaker allows your users to simply submit bug reports by shaking the device. When a shake is detected, the current screen state is captured and the user is prompted to submit a bug report via a mail composer with the screenshot attached.

Android developers: If you are looking for an Android library with similar functionality, check out stkent/bugshaker-android.

Screenshots

Report Prompt Report Compose View

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

All you have to do to enable bug reporting is import BugShaker in your AppDelegate and call the configure() method in application:didFinishLaunchingWithOptions, passing in the array of email recipients and an optional custom subject line:

  import BugShaker

  @UIApplicationMain
  class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
      /**
      *  Configure ShakeReport with an array of email recipients (required)
      *  and an optional custom subject line to use for all bug reports.
      */
      BugShaker.configure(to: ["example@email.com"], subject: "Bug Report")

      return true
    }

  }

NOTE: There is a known issue with using a mail compose view controller in a simulator. The mail view will either not display at all, or possibly crash the simulator. You will need to run the example on a device to test out the full report compose view functionality.

Disabling

If you need to disable BugShaker's shake detection for any reason:

BugShaker.enabled = false

Installation

BugShaker is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "BugShaker"

Author

Dan Trenz (@dtrenz) c/o Detroit Labs

License

BugShaker is available under the Apache License, Version 2.0. See the LICENSE file for more info.