cupertino_onboarding 1.1.1 icon indicating copy to clipboard operation
cupertino_onboarding: ^1.1.1 copied to clipboard

Flutter package that provides an iOS-style onboarding experience.

cupertino_onboarding #

style: very good analysis badge GitHub build status License: MIT

Flutter package that provides a beautiful, iOS-like, easy onboarding experience with minimal code.

It's designed to easily showcase your app's features and provide a simple way for users to learn about your app.

onboarding example

Getting Started #

Add the package to your pubspec.yaml file:

cupertino_onboarding: ^1.1.1

Import the library:

import 'package:cupertino_onboarding/cupertino_onboarding.dart';

Create CupertinoOnboarding widget and pass your pages as parameter:

Widget build(BuildContext context) {
  return CupertinoOnboarding(
    onPressedOnLastPage: () => Navigator.pop(context),
    pages: [
      // To create What's New page like Calendar or Translator
      // examples in the readme, use `WhatsNewPage` widget:

      // Actual code from the Calendar example:
        title: const Text("What's New in Calendar"),
        features: [
          // Feature's type must be `WhatsNewFeature`
            icon: Icon(
              color: CupertinoColors.systemRed.resolveFrom(context),
            title: const Text('Found Events'),
            description: const Text(
              'Siri suggests events found in Mail, Messages, and Safari, so you can add them easily, such as flight reservations and hotel bookings.',
            icon: Icon(
              color: CupertinoColors.systemRed.resolveFrom(context),
            title: const Text('Time to Leave'),
            description: const Text(
              "Calendar uses Apple Maps to look up locations, traffic conditions, and transit options to tell you when it's time to leave.",

      // To create custom onboarding page, use
      // `CupertinoOnboardingPage` widget:

      // Actual code from the GIF example:
      const CupertinoOnboardingPage(
        title: Text('Support For Multiple Pages'),
        body: Icon(
          size: 200,
      const CupertinoOnboardingPage(
        title: Text('Great Look in Light and Dark Mode'),
        body: Icon(
          size: 200,

CupertinoOnboarding can be shown as any other widget, but to match native feel, consider using modal_bottom_sheet package or other modal view.

See API reference for more information about customizing look and feel of the onboarding.

Examples #

calendar example translator example

Features, bugs and contributions #

Feel free to contribute to this project.

Please file feature requests and bugs at the issue tracker.
If you fixed a bug or implemented a feature by yourself, feel free to send a pull request.

Sponsoring #

I am working on my packages in my free time.

If this package is helping you, please consider buying me a coffee, so I can keep updating and maintaining this package.

pub points


verified publisher

Flutter package that provides an iOS-style onboarding experience.

Repository (GitHub)


API reference


Icon for licenses.MIT (LICENSE)


dots_indicator, flutter


Packages that depend on cupertino_onboarding