Cupertino Route #

A Flutter package that enhances navigation with a customizable drag-to-go-back gesture that works from anywhere on the screen, providing a more intuitive and iOS-like navigation experience.

Features #

• 🔙 Drag from Anywhere: Navigate back by dragging from anywhere on the screen, not just from the edge
• ➡️ Drag Right to New Widget: Swipe right to reveal additional content or widgets
• 🎨 Beautiful Animations: Smooth parallax animations for both push and pop transitions
• 📐 Flexible Integration: Works with existing navigation systems and state management solutions
• 📱 Native Feel: Provides an iOS-like experience on any platform

Demo! #

Horizontal ListView	Tabbar View	Swipeable

Usage #

import 'package:cupertino_route/cupertino_route.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      // Wrap your route in CupertinoRoute to enable drag-from-anywhere feature
      onGenerateRoute: (settings) {
        return CupertinoRoute(
          settings: settings,
          builder: (context) {
            // Your page content
            return YourPage();
          },
          // Optional: Add swipeable content that appears when dragging right
          swipeableBuilder: (context) => YourSwipeableWidget(),
        );
      },
      home: HomePage(),
    );
  }
}

Features in Detail #

Drag Right to New Widget #

The swipeableBuilder parameter allows you to define content that appears when users swipe right. This feature is perfect for:

• Side menus
• Additional information panels
• Quick actions
• Contextual content

Parallax Animation #

Requirements:

• The initial route, current route, and previous route must be either CupertinoRoute or CupertinoPageRoute
• You must customize the pageTransitionsTheme to enable the effect across all platforms

MaterialApp(
  title: 'Cupertino Route',
  onGenerateRoute: (settings) {
    return CupertinoRoute(
      builder: (context) => YourPage(),
    );
  },
  onGenerateInitialRoutes: (settings) {
    return [
      CupertinoRoute(
        builder: (context) => const MyHomePage(),
      )
    ];
  },
  theme: ThemeData(
    ///...
    pageTransitionsTheme: PageTransitionsTheme(
      builders: {
        for (final platform in TargetPlatform.values)
          platform: const CupertinoPageTransitionsBuilder(),
      },
    ),
  ),
)

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

License #

This project is licensed under the MIT License - see the LICENSE file for details.