feature_discovery
A Flutter package that implements Material Design Feature discovery to show a description of specific features to new users. See https://tinyurl.com/FeatureDiscovery
0.14.2
3.1K downloads/mo
#4614 most downloaded on pub.dev
ayalma/feature_discovery
What this package is like to depend on
Last release 2 years ago
no release in 18 months
Ships unpredictably
gaps range from 2 weeks to 3.0 years
Nearly every release is documented
notes for 22 of 24 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
24 releases · first in 2019
0 releases in the last 12 months
see the full history below
Release timeline
24 releases · Jun 2019 to Dec 2024Releases
latest 24-
0.14.207 Dec 2024Release notes
Open source →- Updated All Dependencies versions
- Updated To Flutter version 3.24.3
Changelog
-
0.14.105 Dec 2021 -
0.14.003 Apr 2021 -
0.13.020 Dec 2020Release notes
Open source →- Introduce a PersistenceProvider interface for storing step completion in any mechanism the user wants.
- Fully backward compatible, no need to change your code.
- All historic steps are honored and will not show again, just as you’d expect.
-
0.13.0+118 Jan 2021 -
0.13.0+218 Jan 2021Nothing published for this version
-
0.12.108 Oct 2020Nothing published for this version
-
0.12.001 Jul 2020Release notes
Open source →- Breaking change:
isDisplayedis replaced byhasPreviouslyCompleted. - Fix: the
onCompletereturned value will no longer be ignored, and the next overlay won't show if this function returnsfalse. FeatureDiscovery.completeCurrentStepwill force complete the current step and not execute theonCompletefunction.- Deprecated methods in
FeatureDiscoveryhave been removed. - New parameter
recordStepsInSharedPreferencesinFeatureDiscoveryto prevent step completions to be recorded in Shared Preferences. - New parameter
sharedPreferencesPrefixinFeatureDiscovery.
- Breaking change:
-
0.12.0+107 Jul 2020 -
0.12.0+214 Jul 2020 -
0.10.020 May 2020Release notes
Open source →- Added
FeatureDiscovery.isDisplayedmethod to check status of feature - Added Feature/animation durations customization
- Added
openDurationflag that controls open animation duration. - Added
pulseDurationflag that controls tap target pulse animation duration. - Added
completeDurationflag that controls complete animation duration. - Added
dismissDurationflag that controls dismiss animation duration.
- Added
-
0.9.017 May 2020Release notes
Open source →- Added
barrierDismissibleflag which decides whether the overlay should dismiss on touching outside or not.
- Added
-
0.8.019 Feb 2020Release notes
Open source →- Breaking change:
FeatureDiscovery.completeCurrentStepis async now. - Added preferences for each feature to show is understood by user or not
- Library will not show understood feature
- Added method for reset all preferences of features
FeatureDiscovery.clearPreferences
- Breaking change:
-
0.7.019 Feb 2020Release notes
Open source →- Breaking change: removed deprecated static methods in
FeatureDiscovery. - Breaking change: removed deprecated parameters in the
EnsureVisibleconstructor. - Breaking change: overlays will always be dismissed when calling
FeatureDiscovery.dismissAll. - Deprecated
activeFeatureId; replaced bycurrentFeatureIdOfto emphasize that this is a getter. - Deprecated
FeatureDiscovery.dismiss; replaced bydismissAllto indicate that no next step will be shown. - Added
assertto require at least one step to be passed toFeatureDiscovery.discoverFeatures. - Incorrect documentation of some static methods in
FeatureDiscoveryhas been updated. - Error messages have been improved : the error thrown when the widget tree isn't wrapped in
a
FeatureDiscoverywidget is clearer. - Incorrect behavior when
onDismissreturnedFuture<false>has been fixed.
- Breaking change: removed deprecated static methods in
-
0.6.119 Jan 2020 -
0.6.003 Nov 2019Release notes
Open source →- Breaking change: Renamed
ContentOrientationtoContentLocation. - Breaking change: Made
onCompleteof typeFuture<bool> Function()to matchonOpenandonDismiss. - Methods
completeStepandmarkStepCompletehave been deprecated andcompleteCurrentStepshould now be used. - Method
clearis deprecated anddismissshould now be used. - Added an
OverflowModeenum and theoverflowModeparameter toDescribedFeatureOverlayto control how the overlay should handle content that exceeds the background's boundaries. - Added
FeatureDiscovery.activeFeatureId, which allows you to get the feature id of the current feature discovery step. - Added
duration,curve, andpreciseAligmentparameters toEnsureVisibleState.ensureVisible. - Deprecated
EnsureVisible.durationandEnsureVisible.curveas parameters because they should be passed when callingEnsureVisibleState.ensureVisible. This is not a breaking change. - Made the return type of
EnsureVisibleState.ensureVisiblebeFuture<void>. This is not a breaking change because the previous return type wasvoid, which you cannot work with. - Made the
enablePulsingAnimationrespond to rebuilds, allowing to change it after the overlay has been shown. - Added GIF demo of the package to the
README.mdfile of the package and the example. - Updated example.
- Added
OverflowModetoREADME.md. - Added
CONTRIBUTING.mdand mentioned it inREADME.md.
- Breaking change: Renamed
-
0.5.014 Sep 2019Release notes
Open source →- Breaking change: Instead of the
iconparameter, you now need to use thetapTargetparameter, which takes aWidgetinstead ofIconData. Before:DescribedFeatureOverlay(icon: Icons.add, ..)After:DescribedFeatureOverlay(tapTarget: const Icon(Icons.add), ..) - Breaking change:
titleanddescriptionparameters now take aWidget. - Breaking change: Callbacks are now
onOpen,onDismiss, andonComplete.onOpenandonDismissneed to returnFuture<bool>when specified to decide if the step should be open or dismissed respectively. - Fixed
DescribedFeatureOverlay's constantly rebuilding even if they were never displayed. - Fixed
DescribedFeatureOverlay's rebuilding after dismissing them. - Warning:
Theme.of(context)is now used to determine text styles - Title and description can now be null.
- Added option to disable pulsing animation.
- Added parameter that is called when the overlay is dismissed.
- Added parameters to change text color, target color, and icon color.
- Added possibility to pass any
Iterablefor the steps toFeatureDiscovery.discoverFeatures. - Added the
@requiredannotation to parameters that cannot be null. - Ensured that overlay for each step is only shown once at a time.
- Removed unnecessary files.
- Formatted files.
- Updated the plugin description.
- Breaking change: Instead of the
-
0.4.122 Jun 2019 -
0.4.022 Jun 2019 -
0.3.022 Jun 2019Release notes
Open source →- Consider landscape and portrait orientation in
DescribedFeatureDiscoveryWidget.
- Consider landscape and portrait orientation in
-
0.2.019 Jun 2019Release notes
Open source →- Add
EnsureVisiblewidget to scroll to target when it is in a scrollable container.
- Add
-
0.1.118 Jun 2019 -
0.1.018 Jun 2019 -
0.0.117 Jun 2019