explaingit

forkingdog/fdfullscreenpopgesture

★ 5,892Objective-CAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A small iOS library that lets users swipe back from anywhere on the screen, not just the left edge, to navigate to the previous screen.

Mindmap

mindmap
  root((repo))
    What it does
      Full screen swipe back
      Replaces edge-only gesture
    How it works
      UINavigationController add-on
      AOP auto-activation
    Customization
      Disable per screen
      Scroll view support
    Setup
      CocoaPods install
      iOS 7 minimum
    License
      MIT
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Add a full-screen swipe-back gesture to any iOS app with minimal code changes.

USE CASE 2

Improve navigation feel in apps where users expect to swipe anywhere to go back.

USE CASE 3

Selectively disable the gesture on specific screens that have horizontal scroll views.

Tech stack

Objective-CiOSUIKitCocoaPodsAOP

Getting it running

Difficulty · easy Time to first run · 5min

Install via CocoaPods. Drop in two files and it activates automatically. Requires iOS 7.0+. Extra step needed if screens contain horizontal scroll views.

MIT license, use freely in any project, personal or commercial, with no restrictions beyond keeping the copyright notice.

In plain English

FDFullscreenPopGesture is a small add-on for iOS app developers that makes it possible to swipe back from anywhere on the screen, not just the left edge. On iPhones running iOS 7 or later, Apple ships a built-in swipe-from-the-left-edge gesture that lets users go back to the previous screen. This library expands that zone to the full width of the display, matching the behavior many users expect after using apps that offer it natively. The library is written in Objective-C and works as a category on UINavigationController, which is the standard iOS component that manages a stack of screens. Because it uses a technique called AOP (aspect-oriented programming), you drop in two files and the feature activates across every navigation controller in the app automatically, with no extra wiring needed in your existing code. If a particular screen or controller should not respond to the fullscreen swipe, one-line properties let you turn it off selectively. The library also handles a tricky visual detail: when swiping between screens that have different navigation bar visibility states, say from a screen with a bar to one without, the transition animates correctly rather than snapping or flashing. There is one extra step required if a screen contains a scrollable list or any view that itself responds to horizontal swipes. In that case you need to tell the scroll view to cooperate with the gesture when the content is already scrolled to the left edge. The README includes the exact code block for that. Installation is through CocoaPods, a standard dependency manager for iOS projects. The library requires iOS 7.0 at minimum and is released under the MIT license.

Copy-paste prompts

Prompt 1
How do I add FDFullscreenPopGesture to my iOS project using CocoaPods?
Prompt 2
Show me how to disable the fullscreen pop gesture on a specific view controller using FDFullscreenPopGesture.
Prompt 3
How do I make a UIScrollView cooperate with FDFullscreenPopGesture when the list is scrolled to the left edge?
Prompt 4
Explain how FDFullscreenPopGesture activates automatically across all navigation controllers in my app.
Open on GitHub → Explain another repo

← forkingdog on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.