full_swipe_back_gesture

iOS-style full-screen back swipe gesture PageRoute that solves the horizontal scroll conflict problem. Unlike standard Flutter navigation where horizontal scrollables (PageView, ListView) compete with and block back gestures, this package enables seamless back swiping from anywhere on the screen while preserving natural horizontal scroll behavior.

🎬 Live Demo

The following GIFs demonstrate the package in action across different scenarios:

📱 Preview

Scenario Description Demo
Normal Swipe Basic back swipe gesture from anywhere on screen Normal Swipe
PageView Swipe Back swipe works even with horizontal PageView at left edge PageView Swipe
Edge Swipe Edge swipes always trigger back gesture regardless of scrollable state Edge Swipe
Nested Scroll Complex nested scrollable layouts with seamless back navigation Nested Scroll

🎯 Key Scenarios Explained

  • Normal Swipe: Demonstrates the basic full-screen back swipe functionality
  • PageView Swipe: Shows how the package resolves conflicts with horizontal scrollables
  • Edge Swipe: Proves that edge swipes always work regardless of scrollable state
  • Nested Scroll: Handles complex layouts with multiple scrollable widgets

Installation

dependencies:
  full_swipe_back_gesture: ^0.1.0

Usage

import 'package:full_swipe_back_gesture/full_swipe_back_gesture.dart';

Navigator.of(context).push(
  BackSwipePageRoute(
    builder: (_) => const DetailPage(),
  ),
);

Key Features

  • Full-screen swipe: Back gesture works from anywhere on the screen, not just the edge
  • Smart conflict resolution: Automatically detects when horizontal scrollables are at their left boundary
  • iOS-like behavior: Edge swipes always trigger back gesture regardless of scrollable state
  • Customizable: Adjust edge width, transition curves, and durations

Configuration Options

  • edgeStartWidthPx: Width from left edge where back gesture always starts (default: 24.0px)
  • pushCurve / popCurve: Animation curves for push/pop transitions
  • transitionDuration / reverseTransitionDuration: Animation durations

How It Works

  • Edge swipes: Always trigger back gesture regardless of horizontal scrollable state
  • Non-edge swipes: Only trigger back gesture when the topmost horizontal scrollable is at its left boundary
  • Gesture completion: Uses velocity (>900px/s) or distance (>50% screen width) to determine pop action

Examples

Check the example/ app to see the package working with various layouts including PageView, nested scrollables, and long lists.

License

MIT

Libraries

full_swipe_back_gesture