Need help with SPStackedNav?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

197 Stars 23 Forks Apache License 2.0 11 Commits 2 Opened issues


[DEPRECATED] Navigation controller which represents its content in stacks of panes, rather than one at a time

Services available


Need anything else?

Contributors list

No Maintenance Intended

:warning: Deprecated :warning:

This library is deprecated.


Joachim Bengtsson [email protected]


SPStackedNavigationController is a UINavigationController drop-in replacement, which represents its content in stacks of panes, rather than one at a time. This interface trend was started by Loren Brichter in Tweetie for iPad, and has spread to many apps in many variations since.

There are two main advantages to this approach:

  • You can display two pieces of main content at once, allowing you to navigate in one while using content in the other.
  • Navigation is direct instead of indirect, which is faster and more intuitive to use. You actually grab the UI and pull it to where you want it. In contrast, a standard navigation controller requires you to find and tap a button with an abstract "back" concept.

The main drawback is that you should no longer use horizontal gestures, as they will interfere with navigation, or the other way around.

At Spotify, we use this style for navigation in our iPad app. We are very proud of the outcome, and are contributing it back to the community, in hopes that others will find it as useful as we do. This code has been used for several years at Spotify and should be very stable.

In our implementation, a page can either be "full size" and thus cover the whole width of the parent container (which we use for the root view controllers in our stacks), or half-size (exactly two will fit in landscape, or one and a half in portrait).


In addition, SPSideTabController is a drop-in replacement for UITabBarController, but with tabs along the left side rather than along the bottom. This is one of the UIs that are commonly combined with a stacked navigation.

Extra tab bar items can be added along the bottom (e g for "Settings"), and the whole bottom of the screen can have an attachment, which we use to show the currently playing track in Spotify.

Usage Instructions

  1. Pull in "include", "Sources" and "Graphics" into your main project.
  2. Go to your project settings, then Build Settings for your app target, and change "Header Search Paths" to include and "{your path to SPStackedNav}/include".
  3. #import either from your prefix header, or the source file where you want to use these classes.

See Examples/StackExample for some example usage.

Version History

1.0: Initial release

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.