A page-turning interface for iOS apps
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



Leaves is an animated interface for navigating through a sequence of images using page-turning gestures. As of iOS 5, Leaves is mostly obsoleted by UIPageViewController.

Leaves requires iOS 3.0 or later.


  1. Add the files in the Leaves subdirectory to your Xcode project.
  2. Ensure that your target links against QuartzCore.framework.


Creating a page-turning view controller is as simple as subclassing LeavesViewController:

#import "LeavesViewController.h"

@interface ColorSwatchViewController : LeavesViewController 

...and implementing the LeavesViewDataSource protocol:

@implementation ColorSwatchViewController

- (NSUInteger)numberOfPagesInLeavesView:(LeavesView*)leavesView { 
    return 10;

- (void)renderPageAtIndex:(NSUInteger)index inContext:(CGContextRef)context { 
        [[UIColor colorWithHue:index/10.0 
                         alpha:1.0] CGColor]);
    CGContextFillRect(ctx, CGContextGetClipBoundingBox(ctx));


You may also use LeavesView directly. For more examples, see the included LeavesExamples project.