{"id":2464,"url":"https://github.com/xmartlabs/XLActionController","last_synced_at":"2025-08-06T16:31:18.088Z","repository":{"id":46343534,"uuid":"47781142","full_name":"xmartlabs/XLActionController","owner":"xmartlabs","description":"Fully customizable and extensible action sheet controller written in Swift","archived":false,"fork":false,"pushed_at":"2023-03-17T21:29:18.000Z","size":8991,"stargazers_count":3325,"open_issues_count":26,"forks_count":317,"subscribers_count":77,"default_branch":"master","last_synced_at":"2024-10-29T15:34:18.492Z","etag":null,"topics":["carthage","cocoapods","ios","ios-ui","swift","swift-library","uialertcontroller"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xmartlabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":"xmartlabs","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2015-12-10T18:54:00.000Z","updated_at":"2024-10-29T07:13:06.000Z","dependencies_parsed_at":"2022-08-12T12:50:46.518Z","dependency_job_id":"8b74efc6-6913-44d6-a9a0-62448deee672","html_url":"https://github.com/xmartlabs/XLActionController","commit_stats":{"total_commits":87,"total_committers":19,"mean_commits":4.578947368421052,"dds":0.632183908045977,"last_synced_commit":"c688f2606665cd1aa14a297ae3353f20b3a8ef86"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmartlabs%2FXLActionController","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmartlabs%2FXLActionController/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmartlabs%2FXLActionController/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xmartlabs%2FXLActionController/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xmartlabs","download_url":"https://codeload.github.com/xmartlabs/XLActionController/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228923687,"owners_count":17992566,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carthage","cocoapods","ios","ios-ui","swift","swift-library","uialertcontroller"],"created_at":"2024-01-05T20:16:14.390Z","updated_at":"2024-12-09T16:31:01.467Z","avatar_url":"https://github.com/xmartlabs.png","language":"Swift","funding_links":["https://github.com/sponsors/xmartlabs"],"categories":["UI","Libs","Menu","Swift","Popups \u0026 Dialogs","UI and SwiftUI","UI [🔝](#readme)"],"sub_categories":["Alert \u0026 Action Sheet","UI","Other free courses","Others"],"readme":"![XLActionController](https://raw.githubusercontent.com/xmartlabs/XLActionController/master/XLActionController.png)\n\n\u003cp align=\"left\"\u003e\n\u003ca href=\"https://travis-ci.org/xmartlabs/XLActionController\"\u003e\u003cimg src=\"https://travis-ci.org/xmartlabs/XLActionController.svg?branch=master\" alt=\"Build status\" /\u003e\u003c/a\u003e\n\u003cimg src=\"https://img.shields.io/badge/platform-iOS-blue.svg?style=flat\" alt=\"Platform iOS\" /\u003e\n\u003ca href=\"https://developer.apple.com/swift\"\u003e\u003cimg src=\"https://img.shields.io/badge/swift5-compatible-4BC51D.svg?style=flat\" alt=\"Swift 5 compatible\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Carthage/Carthage\"\u003e\u003cimg src=\"https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat\" alt=\"Carthage compatible\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://cocoapods.org/pods/XLActionController\"\u003e\u003cimg src=\"https://img.shields.io/cocoapods/v/XLActionController.svg\" alt=\"CocoaPods compatible\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://raw.githubusercontent.com/xmartlabs/XLActionController/master/LICENSE\"\u003e\u003cimg src=\"http://img.shields.io/badge/license-MIT-blue.svg?style=flat\" alt=\"License: MIT\" /\u003e\u003c/a\u003e\n\u003c!-- \u003ca href=\"https://codebeat.co/projects/github-com-xmartlabs-xlactioncontroller\"\u003e\u003cimg alt=\"codebeat badge\" src=\"https://codebeat.co/badges/24f48197-136d-44cc-b072-6703644d13b6\" /\u003e\u003c/a\u003e --\u003e\n\u003c/p\u003e\n\nBy [XMARTLABS](http://xmartlabs.com).\n\n**XLActionController** is an extensible library to quickly create any custom action sheet controller.\n\n## Examples\n\n\u003ctable\u003e\n \u003ctr\u003e\n  \u003ctd\u003e\n    \u003cimg src=\"Media/demo_spotify.gif\" width=\"300\"/\u003e\n  \u003c/td\u003e\n  \u003ctd\u003e\n    \u003cimg src=\"Media/demo_twitter.gif\" width=\"300\"/\u003e\n  \u003c/td\u003e\n  \u003ctd\u003e\n    \u003cimg src=\"Media/demo_tweetbot.gif\" width=\"300\"/\u003e\n  \u003c/td\u003e\n \u003c/tr\u003e\n \u003ctr\u003e\n  \u003ctd\u003e\n    \u003cimg src=\"Media/demo_periscope.gif\" width=\"300\"/\u003e\n  \u003c/td\u003e\n  \u003ctd\u003e\n    \u003cimg src=\"Media/demo_youtube.gif\" width=\"300\"/\u003e\n  \u003c/td\u003e\n  \u003ctd\u003e\n    \u003cimg src=\"Media/demo_skype.gif\" width=\"300\"/\u003e\n  \u003c/td\u003e\n \u003c/tr\u003e\n \u003c/table\u003e\n\nThe action sheet controllers shown above were entirely created using XLActionController and are included in the [Examples](/Example/CustomActionControllers).\nTo run the Example project: clone XLActionController repository, open XLActionController workspace and run the Example project.\n\nThe code snippet below shows how to present the Tweetbot action sheet controller:\n\n```swift\nlet actionController = TweetbotActionController()\n\nactionController.addAction(Action(\"View Details\", style: .default, handler: { action in\n  // do something useful\n}))\nactionController.addAction(Action(\"View Retweets\", style: .default, handler: { action in\n  // do something useful\n}))\nactionController.addAction(Action(\"View in Favstar\", style: .default, handler: { action in\n  // do something useful\n}))\nactionController.addAction(Action(\"Translate\", style: .default, executeImmediatelyOnTouch: true, handler: { action in\n  // do something useful\n}))\n\nactionController.addSection(Section())\nactionController.addAction(Action(\"Cancel\", style: .cancel, handler:nil))\n\npresent(actionController, animated: true, completion: nil)\n```\n\nAs you may have noticed, the library usage looks pretty similar to UIAlertController.\n\nActions' handlers are executed after the alert controller is dismissed from screen. If you want, you can change this passing `true` to the action's constructor to the argument `executeImmediatelyOnTouch`.\n\n\u003e Behind the scenes XLActionController uses a UICollectionView to display the action sheet.\n\n## Usage\n\nFirst create a custom action sheet view controller by extending from the `ActionController` generic class. For details on how to create a custom action sheet controller look at the [Extensibility](#extensibility) section.\n\nFor instance, let's suppose we've already created [`TwitterActionController`](Example/CustomActionControllers/Twitter.swift).\n\n```swift\n// Instantiate custom action sheet controller\nlet actionSheet = TwitterActionController()\n// set up a header title\nactionSheet.headerData = \"Accounts\"\n// Add some actions, note that the first parameter of `Action` initializer is `ActionData`.\nactionSheet.addAction(Action(ActionData(title: \"Xmartlabs\", subtitle: \"@xmartlabs\", image: UIImage(named: \"tw-xmartlabs\")!), style: .default, handler: { action in\n   // do something useful\n}))\nactionSheet.addAction(Action(ActionData(title: \"Miguel\", subtitle: \"@remer88\", image: UIImage(named: \"tw-remer\")!), style: .default, handler: { action in\n   // do something useful\n}))\n// present actionSheet like any other view controller\npresent(actionSheet, animated: true, completion: nil)\n```\n\u003cimg src=\"Media/demo_twitter.gif\" width=\"200\"/\u003e\n\nAs the code above illustrates, there are no relevant differences compared to the UIAlertController API.\n\nThe main difference is that XLActionController works with any header data type and not only the standard UIAlertController `title` and `message` properties.\nSimilarly XLActionController's Action works with any data Type and not only the `title` string.\n\n```swift\n// XLActionController:\nxlActionController.headerData = SpotifyHeaderData(title: \"The Fast And The Furious Soundtrack Collection\", subtitle: \"Various Artists\", image: UIImage(named: \"sp-header-icon\")!)\n\n// vs UIAlertController:\nuiActionController.title = \"The Fast And The Furious Soundtrack Collection\" // no way to pass an image\nuiActionController.message = \"Various Artists\"\n```\n\n```swift\n// XLActionController:\nlet xlAction = Action(ActionData(title: \"Save Full Album\", image: UIImage(named: \"sp-add-icon\")!), style: .default, handler: { action in })\n// notice that we are able to pass an image in addition to the title\nxlActionController.addAction(xlAction)\n\n// vs UIAlertController:\nlet uiAction = UIAlertAction(title: \"Xmartlabs\", style: .default, handler: { action in }))\nuiActionController.addAction(uiAction)\n```\n\n\u003e This can be accomplished because XLActionController is a generic type.\n\nAnother important difference is that XLActionController provides a way to add action sections as illustrated in the code below:\n\n```swift\n  actionController.addSection(Section())\n```\n\nand also each section has a `data` property. This property is generic, so that it can hold any type. This data will be used to create this section's header view.\n\n```swift\nlet section = actionController.addSection(Section())\nsection.data = \"String\" // assuming section data Type is String\n```\n\n\u003e Each section contains a set of actions. We typically use sections to show a header view above a set of actions.\n\n\n## Extensibility\n\nActionController uses a UICollectionView to show actions and headers on screen. Actions will be rendered as instances of UICollectionViewCell. You can use\nyour own subclass of UICollectionViewCell by specifying it in the action controller declaration. Additionally, ActionController allows you to specify a global header and a section header. Headers are shown as collection view's supplementary views.\n\nThe `ActionController` class is a generic type that works with any cell, header, section header type and its associated data types.\n\n### Create your custom action sheet controller\n\nXLActionController provides extension points to specify a whole new look and feel to our custom sheet controller and to tweak present and dismiss animations. Let's see an example:\n\n```swift\n// As first step we should extend the ActionController generic type\npublic class PeriscopeActionController: ActionController\u003cPeriscopeCell, String, PeriscopeHeader, String, UICollectionReusableView, Void\u003e {\n\n    // override init in order to customize behavior and animations\n    public override init(nibName nibNameOrNil: String? = nil, bundle nibBundleOrNil: Bundle? = nil) {\n        super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)\n        // customizing behavior and present/dismiss animations\n        settings.behavior.hideOnScrollDown = false\n        settings.animation.scale = nil\n        settings.animation.present.duration = 0.6\n        settings.animation.dismiss.duration = 0.5\n        settings.animation.dismiss.options = .curveEaseIn\n        settings.animation.dismiss.offset = 30\n\n        // providing a specific collection view cell which will be used to display each action, height parameter expects a block that returns the cell height for a particular action.\n        cellSpec = .nibFile(nibName: \"PeriscopeCell\", bundle: Bundle(for: PeriscopeCell.self), height: { _ in 60})\n        // providing a specific view that will render each section header.\n        sectionHeaderSpec = .cellClass(height: { _ in 5 })\n        // providing a specific view that will render the action sheet header. We calculate its height according the text that should be displayed.\n        headerSpec = .cellClass(height: { [weak self] (headerData: String) in\n            guard let me = self else { return 0 }\n            let label = UILabel(frame: CGRect(x: 0, y: 0, width: me.view.frame.width - 40, height: CGFloat.greatestFiniteMagnitude))\n            label.numberOfLines = 0\n            label.font = .systemFontOfSize(17.0)\n            label.text = headerData\n            label.sizeToFit()\n            return label.frame.size.height + 20\n        })\n\n        // once we specify the views, we have to provide three blocks that will be used to set up these views.\n        // block used to setup the header. Header view and the header are passed as block parameters\n        onConfigureHeader = { [weak self] header, headerData in\n            guard let me = self else { return }\n            header.label.frame = CGRect(x: 0, y: 0, width: me.view.frame.size.width - 40, height: CGFloat.greatestFiniteMagnitude)\n            header.label.text = headerData\n            header.label.sizeToFit()\n            header.label.center = CGPoint(x: header.frame.size.width  / 2, y: header.frame.size.height / 2)\n        }\n        // block used to setup the section header\n        onConfigureSectionHeader = { sectionHeader, sectionHeaderData in\n            sectionHeader.backgroundColor = UIColor(white: 0.95, alpha: 1.0)\n        }\n        // block used to setup the collection view cell\n        onConfigureCellForAction = { [weak self] cell, action, indexPath in\n            cell.setup(action.data, detail: nil, image: nil)\n            cell.separatorView?.isHidden = indexPath.item == self!.collectionView.numberOfItems(inSection: indexPath.section) - 1\n            cell.alpha = action.enabled ? 1.0 : 0.5\n            cell.actionTitleLabel?.textColor = action.style == .destructive ? UIColor(red: 210/255.0, green: 77/255.0, blue: 56/255.0, alpha: 1.0) : UIColor(red: 0.28, green: 0.64, blue: 0.76, alpha: 1.0)\n        }\n    }\n}\n```\n\nActionController type declaration:\n```swift\npublic class ActionController\u003cActionViewType: UICollectionViewCell, ActionDataType, HeaderViewType: UICollectionReusableView, HeaderDataType, SectionHeaderViewType: UICollectionReusableView, SectionHeaderDataType\u003e\n```\n\nWhen extending ActionController we must specify the following view types ActionViewType, HeaderViewType, SectionHeaderViewType. These types are the cell type used to render an action, the view used to render the action sheet header and the view used to render the section header.\n\nEach view type has its associated data: ActionDataType, HeaderDataType, SectionHeaderDataType respectively.\n\n\u003e If your custom action sheet doesn't have a header view we can use `UICollectionReusableView` as `HeaderViewType` and `Void` as `HeaderDataType`.\n\u003e If it doesn't have a section header view you can use `UICollectionReusableView` as `SectionHeaderViewType` and `Void` as `SectionHeaderDataType`.\n\nThe code below shows how we specify these types for the action controllers provided in the example project:\n```swift\nclass PeriscopeActionController: ActionController\u003cPeriscopeCell, String, PeriscopeHeader, String, UICollectionReusableView, Void\u003e { ... } // doesn't need to show a section header\nclass SpotifyActionController: ActionController\u003cSpotifyCell, ActionData, SpotifyHeaderView, SpotifyHeaderData, UICollectionReusableView, Void\u003e { ... } // doesn't need to show a section header\nclass TwitterActionController: ActionController\u003cTwitterCell, ActionData, TwitterActionControllerHeader, String, UICollectionReusableView, Void\u003e { ... } // doesn't need to show a section header\nclass YoutubeActionController: ActionController\u003cYoutubeCell, ActionData, UICollectionReusableView, Void, UICollectionReusableView, Void\u003e\n```\n\n### Tweaking default style and animation parameters\n\nBy following the previous section steps you should already be able to play with your custom action controller.\nIt happens quite often that we need some other customization such as zooming out the presenting view, changing the status bar color or customizing the default present and dismiss animation.\n\n`ActionController` class defines the `settings` property of type `ActionSheetControllerSettings` to tweak all these.\n\n#### UICollectionView's behavior\n```swift\n// Indicates if the action controller must be dismissed when the user taps the background view. `true` by default.\nsettings.behavior.hideOnTap: Bool\n// Indicates if the action controller must be dismissed when the user scrolls down the collection view. `true` by default.\nsettings.behavior.hideOnScrollDown: Bool\n// Indicates if the collectionView's scroll is enabled. `false` by default.\nsettings.behavior.scrollEnabled: Bool\n// Controls whether the collection view scroll bounces past the edge of content and back again. `false` by default.\nsettings.behavior.bounces: Bool\n// Indicates if the collection view layout will use UIDynamics to animate its items. `false` by default.\nsettings.behavior.useDynamics: Bool\n// Determines whether the navigation bar is hidden when action controller is being presented. `true` by default\nsettings.hideCollectionViewBehindCancelView: Bool\n```\n\n#### UICollectionView Style\n\n```swift\n// Margins between the collection view and the container view's margins. `0` by default\nsettings.collectionView.lateralMargin: CGFloat\n// Cells height when UIDynamics is used to animate items. `50` by default.\nsettings.collectionView.cellHeightWhenDynamicsIsUsed: CGFloat\n```\n\n#### Animation settings\nStruct that contains all properties related to presentation \u0026 dismissal animations\n\n```swift\n// Used to scale the presenting view controller when the action controller is being presented. If `nil` is set, then the presenting view controller won't be scaled. `(0.9, 0.9)` by default.\nsettings.animation.scale: CGSize? = CGSize(width: 0.9, height: 0.9)\n```\n\n#### Present animation settings\n\n```swift\n// damping value for the animation block. `1.0` by default.\nsettings.animation.present.damping: CGFloat\n// delay for the animation block. `0.0` by default.\nsettings.animation.present.delay: TimeInterval\n// Indicates the animation duration. `0.7` by default.\nsettings.animation.present.duration: TimeInterval\n// Used as `springVelocity` for the animation block. `0.0` by default.\nsettings.animation.present.springVelocity: CGFloat\n// Present animation options. `UIViewAnimationOptions.curveEaseOut` by default.\nsettings.animation.present.options: UIViewAnimationOptions\n```\n\n#### Dismiss animation settings\n\n```swift\n// damping value for the animation block. `1.0` by default.\nsettings.animation.dismiss.damping: CGFloat\n// Used as delay for the animation block. `0.0` by default.\nsettings.animation.dismiss.delay: TimeInterval\n// animation duration. `0.7` by default.\nsettings.animation.dismiss.duration: TimeInterval\n// springVelocity for the animation block. `0.0` by default\nsettings.animation.dismiss.springVelocity: CGFloat\n// dismiss animation options. `UIViewAnimationOptions.curveEaseIn` by default\nsettings.animation.dismiss.options: UIViewAnimationOptions\n```\n\n#### StatusBar Style\n\n```swift\n// Indicates if the status bar should be visible or hidden when the action controller is visible. Its default value is `true`\nsettings.statusBar.showStatusBar: Bool\n// Determines the style of the device’s status bar when the action controller is visible. `UIStatusBarStyle.LightContent` by default.\nsettings.statusBar.style: UIStatusBarStyle\n// Determines whether the action controller takes over control of status bar appearance from the presenting view controller. `true` by default.\nsettings.statusBar.modalPresentationCapturesStatusBarAppearance: Bool\n```\n\n#### Cancel view style\n\nSometimes we need to show a cancel view below the collection view. This is the case of the `SpotifyActionController`.\nThese properties have nothing to do with the actions added to an action Controller nor with the actions with .Cancel as style value.\n\n```swift\n // Indicates if the cancel view is shown. `false` by default.\nsettings.cancelView.showCancel: Bool\n // Cancel view's title. \"Cancel\" by default.\nsettings.cancelView.title: String?\n // Cancel view's height. `60` by default.\nsettings.cancelView.height: CGFloat\n // Cancel view's background color. `UIColor.black.withAlphaComponent(0.8)` by default.\nsettings.cancelView.backgroundColor: UIColor\n// Indicates if the collection view is partially hidden by the cancelView when it is pulled down.\nsettings.cancelView.hideCollectionViewBehindCancelView: Bool\n```\n\n### Advanced animations\n\nIf tweaking previous settings is not enough to make the animations work like you want, XLActionController allows you to change the present/dismiss animation by overriding some functions.\n\n#### Presentation\n\n```swift\nopen func presentView(_ presentedView: UIView, presentingView: UIView, animationDuration: Double, completion: ((_ completed: Bool) -\u003e Void)?)\n```\nThe function above is responsible for making the present animation. It encapsulates how the presentation is performed and invokes `onWillPresentView`, `performCustomPresentationAnimation` and `onDidPresentView` to allow you to change a specific point of the animation.\n\n\u003eTypically we don't need to override `presentView` function because overriding either `onWillPresentView`, `performCustomPresentationAnimation` or `onDidPresentView` is enough.\n\n```swift\nopen func onWillPresentView()\n```\n`onWillPresentView` is called before the animation block starts. Any change here won't be animated. It's intended to set the initial animated properties values.\n\n```swift\nopen func performCustomPresentationAnimation(_ presentedView: UIView, presentingView: UIView)\n```\n`performCustomPresentationAnimation` is called from within the main animation block.\n\n```swift\nopen func onDidPresentView()\n```\nAfter the present animation is completed, `presentView` calls `onDidPresentView` from within completion callback.\n\n\u003e `onWillPresentView`, `performCustomPresentationAnimation`, `onDidPresentView` won't be invoked if you override `presentView` implementation.\n\n#### Dismissal\n\nDismissal animation can be customized in the same way as presentation animation.\n\n```swift\nopen func dismissView(_ presentedView: UIView, presentingView: UIView, animationDuration: Double, completion: ((_ completed: Bool) -\u003e Void)?)\n```\n\nThe function above is responsible for making the dismissal animation. It encapsulates how the dismissal animation is performed and invokes `onWillDismissView`, `performCustomDismissingAnimation` and `onDidDismissView` to allow you to change an specific point of the animation.\n\n\u003eTypically we don't need to override `dismissView` method because overriding either onWillDismissView`, `performCustomDismissingAnimation` or `onDidDismissView` is enough.\n\n```swift\nopen func onWillDismissView()\n```\nOverrides `onWillDismissView` to perform any set up before the animation begins.\n\n```swift\nopen func performCustomDismissingAnimation(_ presentedView: UIView, presentingView: UIView)\n```\n`performCustomDismissingAnimation` function is invoked from within the main animation block.\n\n```swift\nopen func onDidDismissView()\n```\nAfter the dismissal animation completes, `dismissView` calls `onDidDismissView` from within completion callback.\n\n\u003e `onWillDismissView`, `performCustomDismissingAnimation`, `onDidDismissView` won't be invoked if you override `dismissView` implementation.\n\n\n**To show how simple and powerful XLActionController is and give several examples of how to extend ActionController we have mimicked the [Skype](Example/CustomActionControllers/Skype.swift), [Tweetbot](Example/CustomActionControllers/Tweetbot.swift), [Twitter](Example/CustomActionControllers/Twitter.swift), [Youtube](Example/CustomActionControllers/Youtube.swift), [Periscope](Example/CustomActionControllers/Periscope.swift) and [Spotify](Example/CustomActionControllers/Spotify.swift)  action controllers.**\n\n\n## Requirements\n\n* iOS 9.3+\n* Xcode 10.2+\n* Swift 5.0+\n\n## Getting involved\n\n* If you **want to contribute** please feel free to **submit pull requests**.\n* If you **have a feature request** please **open an issue**.\n* If you **found a bug** or **need help** please **check older issues before submitting an issue**.\n\nIf you use **XLActionController** in your app we would love to hear about it!\nDrop us a line on [twitter](https://twitter.com/xmartlabs).\n\n## Installation\n\n### CocoaPods\n\n[CocoaPods](https://cocoapods.org/) is a dependency manager for Cocoa projects.\n\nSpecify XLActionController into your project's Podfile:\n\n```ruby\nsource 'https://github.com/CocoaPods/Specs.git'\nuse_frameworks!\n\ntarget '\u003cYour App Target\u003e' do\n  # This will install just the library's core, won't include any examples\n  pod 'XLActionController'\n\n  # Uncomment depending on the examples that you want to install\n  #pod 'XLActionController/Periscope'\n  #pod 'XLActionController/Skype'\n  #pod 'XLActionController/Spotify'\n  #pod 'XLActionController/Tweetbot'\n  #pod 'XLActionController/Twitter'\n  #pod 'XLActionController/Youtube'\nend\n```\n\nThen run the following command:\n\n```sh\n$ pod install\n```\n\n### Carthage\n\n[Carthage](https://github.com/Carthage/Carthage) is a simple, decentralized\ndependency manager for Cocoa.\n\nSpecify XLActionController into your project's Carthage:\n\n```\ngithub \"xmartlabs/XLActionController\" ~\u003e 5.1.0\n```\n\n### Manually as Embedded Framework\n\nClone XLActionController as a git [submodule](http://git-scm.com/docs/git-submodule) by\nrunning the following command from your project root git folder.\n\n```sh\n$ git submodule add https://github.com/xmartlabs/XLActionController.git\n```\n\nOpen XLActionController folder that was created by the previous git submodule\ncommand and drag the XLActionController.xcodeproj into the Project Navigator\nof your application's Xcode project.\n\nSelect the XLActionController.xcodeproj in the Project Navigator and verify the deployment\ntarget matches with your application deployment target.\n\nSelect your project in the Xcode Navigation and then select your application\ntarget from the sidebar. Next select the \"General\" tab and click on the + button\nunder the \"Embedded Binaries\" section.\n\nSelect XLActionController.framework and we are done!\n\n## Authors\n\n* [Miguel Revetria](https://www.github.com/m-revetria \"Miguel Revetria Github\")\n* [Martin Barreto](https://www.github.com/mtnBarreto \"Martin Barreto Github\")\n\n## License\n\nXLActionController is released under [MIT license](https://raw.githubusercontent.com/xmartlabs/XLActionController/master/LICENSE) and copyrighted by Xmartlabs SRL.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxmartlabs%2FXLActionController","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxmartlabs%2FXLActionController","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxmartlabs%2FXLActionController/lists"}