Latest 0.0.6
License MIT
Platforms ios 8.0, requires ARC
Frameworks Foundation


iOS watchOS tvOS macOS

Carthage Compatible

Revamped Download Button


  • iOS 8.0+
  • Swift 4.2+
  • Xcode 10.0+



CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

CocoaPods 1.1.0+ is required to build NFDownloadButton 0.0.6+.

To integrate NFDownloadButton into your Xcode project using CocoaPods, specify it in your Podfile:

source ''
platform :ios, '8.0'

pod 'NFDownloadButton', '~> 0.0.6'

Then, run the following command:

$ pod install


Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate NFDownloadButton into your Xcode project using Carthage, specify it in your Cartfile:

github "LeonardoCardoso/NFDownloadButton" ~> 0.0.6


If you prefer not to use either of the aforementioned dependency managers, you can integrate NFDownloadButton into your project manually.


You can use a NFDownloadButton on Storyboards or, if you want to do it programatically, you can create it just like you create a UIButton:

let downloadButton = NFDownloadButton(frame: CGRect(x: 0, y: 0, width: 50, height: 50))

NFDownloadButton has four states:

State 1: To Download State 2: Will Download State 3: Ready to Download State 4: Downloaded
first second third fourth

You can switch between states by just doing as following:

self.downloadButton.downloadState = .toDownload || .willDownload || .readyToDownload || .downloaded

When the button is in .readyToDownload state, the button will wait for your to upload its progress. You can do it like this:

self.downloadButton.downloadPercent = 0.5

When this value reaches 1.0, then downloadState is automatically changed to .downloaded.

Downloaded by default

You can select the button as downloaded by default. All states will be overridden by Downloaded state and no animation will be performed. To do so, just add isDownloaded in its constructor, or set it up whenever you want.

NFDownloadButton(frame: CGRect(x: 0, y: 0, width: 50, height: 50), isDownloaded: true)
downloadButton.isDownloaded = true


NFDownloadButton has four different styles of devices: iOS, watchOS, tvOS, macOS. Thus you can customize your final result. This option is only available on constructor.

NFDownloadButton(frame: CGRect(x: 0, y: 0, width: 50, height: 50), isDownloaded: true,
    style: .iOS)
iOS watchOS tvOS macOS
iOS watchOS tvOS macOS


You also can customize the colors of the button on its constructor.

    frame: wrapView.frame,
    isDownloaded: true,
    style: .iOS,
    palette: Palette(
        initialColor: UIColor?,
        rippleColor: UIColor?,
        buttonBackgroundColor: UIColor?,
        downloadColor: UIColor?,
        deviceColor: UIColor?



You can watch changes of state by implementing the protocol:

protocol NFDownloadButtonDelegate {

    func stateChanged(button: NFDownloadButton, newState: NFDownloadButtonState)



Last but not least, you can customize NFDownloadButton properties right from Interface Builder or Storyboards.



NFDownloadButton is released under the MIT license. See LICENSE for details.

Follow me for the latest updates

Latest podspec

    "name": "NFDownloadButton",
    "version": "0.0.6",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "summary": "Revamped Download Button",
    "homepage": "",
    "social_media_url": "",
    "authors": {
        "Leonardo Cardoso": "[email protected]"
    "source": {
        "git": "",
        "tag": "0.0.6"
    "platforms": {
        "ios": "8.0"
    "requires_arc": true,
    "source_files": "Sources/**/*.swift",
    "frameworks": "Foundation"

Pin It on Pinterest

Share This