• Stars
    star
    311
  • Rank 134,521 (Top 3 %)
  • Language
    Swift
  • License
    MIT License
  • Created over 6 years ago
  • Updated over 6 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Bringing the home button back to iPhone X

Home Button Title Graphic

CI Status Version License Platform iOS Version Xcode Version GitHub top language Code Coverage Tests Passing Code Quality Performance Swift 4.1 Open Source Documentation Demo Gif Haptics Sounds Design Animation Frames Dependencies Gitter Chat App Store Ready Rating Released Badges Star this repo

When Apple released the iPhone X, they removed iPhone's most iconic feature—the home button.

HomeButton is a CocoaPod that brings back the home button. Best part: it actually works.

A Demo of the Working Home Button

Usage

HomeButton can be added to your poject with zero lines of code. Yes, that's right—no code needed. Simply link the framework in your app, and the home button adds itself.

Customization

HomeButton supports four styles: classic, classicWhite, modern, and modernWhite.

Home Button Style Options

The default style is classic. To change the style, add the following line:

HomeButton.style = .modern

This can be placed anywhere in your app, but it probably makes the most sense in your AppDelegate's application(_:didFinishLaunchingWithOptions:) function.

Installation via CocoaPods

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

pod 'HomeButton'

Frequently Asked Questions

Will this cause my app to be rejected from the App Store?

It explicity breaks guideline 5.2.1 due to usage of private API's and probably 5.2.5 as well for mimicking system UI. So honestly it depends on the mood of the reviewer.

Is this a joke?

Because satire is sometimes lost over the internet—yes, this is a joke. It was created as a fun April Fool's project. However, we think it's actually a decent re-creation of the home button, and is valuable as a UI/UX experiment.

Authors

Nathan Gitter and Ian McDowell

License

MIT. See the LICENSE file for more info.