Swiftpack.co - kukushi/SideMenu as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by kukushi.
kukushi/SideMenu v2.0.9
An interactive iOS side menu with rich features.
⭐️ 678
🕓 1 year ago
.package(url: "https://github.com/kukushi/SideMenu.git", from: "v2.0.9")

Version Swift5 Carthage compatible License Platform


SideMenu is an easy-to-use side menu container controller written in Swift 5.

Besides all the features a Side Menu should have, it supports:

  • Four kinds of status bar behaviors (iOS 12 only)
  • Three different menu position
  • Both storyboard and programmatically
  • Caching the content view controller and lazy initialization
  • Rubber band effect while panning
  • Custom transition animation
  • RTL supports
  • API References


Menu Position / Status Menu Behavior

Above + None Below + Slide
SideBySide + Fade SideBySide + HideOnMenu

We call the left/right view controller as the menu view controller, the central view controller as content view controller.


For Swift 5.0 and later, please use 2.0.0 or later version.


To install SideMenu with CocoaPods, add the below line in your Podfile:

pod 'SideMenuSwift'
# Note it's NOT 'SideMenu'


To install SideMenu with Carthage, add the below line in your Cartfile:

github "kukushi/SideMenu" "master"

Swift Package Manager

  1. In your project's Package Description, click the + to add a new package.
  2. Paste https://github.com/kukushi/SideMenu.git into the search field.
  3. Choose the project to integrate in the Add to Project selection box.
  4. Click Add Package.
  5. Note that you should use import SideMenu to import SideMenu.



To set up `SideMenu` in storyboard:
  1. Open the view controller's Identity inspector. Change its Class to SideMenuController and Module to SideMenuSwift.
  2. Set up the menu view controller and the initial content view controller in your Storyboard. Add a Custom segue from the SideMenuController to each of them.
    • Change the menu segue's identifier to SideMenu.Menu, Class to SideMenuSegue and Module to SideMenuSwift.
    • Change the content segue's identifier to SideMenu.Content, Class to SideMenuSegue and Module to SideMenuSwift.
  3. (Optional) If you want to use custom segue identifier:
    • Open the SideMenuController's Attribute inspector.
    • In the Side Menu Controller section, modify the Content SegueID/Menu SegueID to the desired value and change the corresponding segue's identifier.
  4. It's done. Check this screenshot a for clear view.


To start the app with `SideMenu` programmatically:
import UIKit
import SideMenuSwift
// If you are using Carthage, uses `import SideMenu`

class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    @objc func applicationDidFinishLaunching(_ application: UIApplication) {
        let contentViewController = ...
        let menuViewController = ...

        window = UIWindow(frame: UIScreen.main.bounds)
        window?.rootViewController = SideMenuController(contentViewController: contentViewController, 
        menuViewController: menuViewController)
        return true

Use the sideMenuController method which provided in UIViewController's extension to get the parent SideMenuController:



All the preferences of SideMenu can be found in SideMenuController.preferences. It's recommend to check out the Example to see how those options will take effect.

SideMenuController.preferences.basic.menuWidth = 240
SideMenuController.preferences.basic.statusBarBehavior = .hideOnMenu
SideMenuController.preferences.basic.position = .below
SideMenuController.preferences.basic.direction = .left
SideMenuController.preferences.basic.enablePanGesture = true
SideMenuController.preferences.basic.supportedOrientations = .portrait
SideMenuController.preferences.basic.shouldRespectLanguageDirection = true

// See a lot more options on `Preferences.swift`.

Caching the Content

One of the coolest features of SideMenu is caching.

// Cache the view controllers somewhere in your code
sideMenuController?.cache(viewController: secondViewController, with: "second")
sideMenuController?.cache(viewController: thirdViewController, with: "third")

// Switch to it when needed
sideMenuController?.setContentViewController(with: "second")

What about the content view controller initialized from the Storyboard? We can use the preferences to apply a default key for it!

SideMenuController.preferences.basic.defaultCacheKey = "default"

What if we can't want to load all the content view controllers so early? We can use lazy caching:

sideMenuController?.cache(viewControllerGenerator: { self.storyboard?.instantiateViewController(withIdentifier: "SecondViewController") }, with: "second")
sideMenuController?.cache(viewControllerGenerator: { self.storyboard?.instantiateViewController(withIdentifier: "ThirdViewController") }, with: "third")


  • Xcode 13 or later
  • iOS 12.0 or later


SideMenu is available under the MIT license. See the LICENSE file for more info.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics