How do I add a ViewDeck side menu to my existing UINavigationController?

Wrap your UINavigationController as the center view controller in an IIViewDeckController. In your app delegate, set the view deck controller as the root with your navigation controller as the center and a side view controller for the menu, similar to the example in the README.

ViewDeck vs SWRevealViewController: which is better for side menus?

ViewDeck is more modern and integrates better with UIKit conventions, offering customizable animations and dynamic controller switching. SWRevealViewController might be simpler but less flexible, so choose ViewDeck if you need more control and compatibility with standard iOS patterns.

Can I use ViewDeck with SwiftUI in my iOS app?

Yes, but it requires bridging since ViewDeck is built for UIKit. You'll need to use UIViewControllerRepresentable to wrap ViewDeck controllers in SwiftUI, which adds complexity and might not feel as native as SwiftUI-based solutions.

How to customize the swipe gesture sensitivity in ViewDeck?

ViewDeck provides gesture recognizers that can be configured through properties like `panningMode` or delegate methods. Check the documentation or source code for details on adjusting interactive behavior, though it's not explicitly detailed in the README.

Is ViewDeck still actively maintained in 2024?

The README mentions the original maintainer has left, but the project has recent releases and CocoaPods updates. However, active development might be slower, so it's wise to check the GitHub repository for the latest commits and issue resolutions.

How to dynamically change the content of a side menu in ViewDeck?

Assign a new view controller to the `leftController` or `rightController` properties at runtime. ViewDeck will handle the transition and update the view hierarchy, as shown in the 'Switching controllers' example in the README.

Open-Awesome

ViewDeck

Objective-C3.1.0

An iOS framework for implementing sliding side menus with programmatic and gesture-based controls.

GitHub

5.3k stars950 forks0 contributors

What is ViewDeck?

ViewDeck is an iOS framework that implements sliding side menus, similar to those found in many popular iOS apps. It provides a container view controller (`IIViewDeckController`) that manages the presentation of left and right side view controllers, handling both programmatic control and user swipe gestures. The framework solves the problem of building consistent, interactive side navigation without dictating the design of the menus themselves.

Target Audience

iOS developers building applications that require side navigation menus, such as those using a hamburger menu pattern. It is particularly useful for developers who want a robust, gesture-integrated solution that works with standard UIKit components.

Value Proposition

Developers choose ViewDeck because it offers a mature, well-integrated solution for side menus that respects UIKit conventions. Its flexibility in allowing custom menu designs, combined with built-in gesture support and easy programmatic control, makes it a reliable choice over rolling a custom implementation.

Overview

An implementation of the sliding menu found in various iOS apps.

Use Cases

Best For

Implementing hamburger-style navigation menus in iOS apps
Adding interactive side panels that respond to swipe gestures
Building apps that require dynamic switching of side view controllers
Creating iPad-optimized layouts with sidebars
Integrating side menus with existing UINavigationController or UITabBarController setups
Projects needing customizable side menu animations and transitions

Not Ideal For

Apps built entirely with SwiftUI that prefer a pure SwiftUI architecture
Projects needing out-of-the-box, pre-styled menu components without custom UI work
Use cases requiring side menus from directions other than left or right (e.g., top or bottom)
Teams seeking a lightweight solution with minimal dependencies and setup overhead

Pros & Cons

Pros

Seamless UIKit Integration

Leverages standard UIKit components like UINavigationController and UITabBarController, making it easy to drop into existing iOS projects without major restructuring.

Flexible Programmatic Control

Allows opening and closing side menus via code, such as in response to button taps, and supports dynamic switching of view controllers at runtime.

Interactive Gesture Support

Includes default swipe gestures for user interaction, enhancing the native feel and accessibility of side menus without additional setup.

Customizable Animations

Provides hooks like `animatorForTransitionWithContext:` for developers to tailor the appearance and transitions of side menus, as mentioned in the README.

Cons

UIKit-Only Limitation

Built exclusively for UIKit, making it incompatible with SwiftUI projects without complex bridging, which adds overhead for modern iOS development.

No Pre-Designed Menus

Leaves all menu design and content creation to the developer, requiring significant UI work compared to libraries with built-in, styled components.

Limited Direction Support

Only supports left and right side menus, lacking options for top or bottom presentations that might be needed for certain app layouts or UX patterns.

Maintenance Uncertainty

The original creator has stepped down from maintenance, as noted in the README, which could lead to slower updates or reduced long-term support.

Frequently Asked Questions

Related Projects

RESideMenu

iOS 7/8 style side menu with parallax effect.

Stars7,032

Forks1,312

Last commit9 years ago

SideMenu

Simple side/slide menu control for iOS, no code necessary! Lots of customization. Add it to your project in 5 minutes or less.

Stars5,818

Forks695

Last commit3 years ago

PageMenu

A paging menu controller built from other view controllers placed inside a scroll view (like Spotify, Windows Phone, Instagram)

Stars5,212

Forks871

Last commit5 years ago

Parchment

A paging view with a highly customizable menu ✨

Stars3,463

Forks428

Last commit2 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub