🎡 Flutter Feature Tour #

A powerful and customizable feature tour package for Flutter applications, designed to create engaging onboarding experiences and highlight key features of your app.

Demo #

 USimulator Screenshot - iPhone 16 Pro - 2024-11-11 at 21.54.38

 USimulator Screenshot - iPhone 16 Pro - 2024-11-11 at 21.54.46

 USimulator Screenshot - iPhone 16 Pro - 2024-11-11 at 21.54.52

 USimulator Screenshot - iPhone 16 Pro - 2024-11-11 at 21.55.03

 USimulator Screenshot - iPhone 16 Pro - 2024-11-11 at 21.55.30

Ufeatur 4

Ufeature-mac

Ufeature 2

Ufeature 3

📋 Table of Contents #

• Features
• Installation
• Usage
• Customization
• Analytics
• Interactive Elements
• Animations and Transitions
• Persistence
• Accessibility
• Testing
• Features in Development
• Contributing
• License

✨ Features #

• 🎨 Customizable styling with FeatureTourTheme
• 🔦 Multiple highlight shapes (circle, rectangle, custom path)
• 📊 Analytics integration
• 🖼️ Interactive elements within tour steps
• 🎭 Smooth animations and transitions
• 💾 Persistence and state management
• ♿ Accessibility features
• 🧪 Testing utilities

📥 Installation #

Add the following to your pubspec.yaml file:

dependencies:
  flutter_feature_tour: ^1.0.0

Then run:

flutter pub get

🚀 Usage #

Basic Setup #

1. Import the package:

import 'package:flutter_feature_tour/flutter_feature_tour.dart';

2. Create an instance of OnboardingService:

final OnboardingService _onboardingService = OnboardingService();

3. Set up your feature highlights:

void _setupOnboarding() {
  _onboardingService.addFeatureHighlightStep([
    FeatureHighlight(
      targetKey: _searchKey,
      title: 'Search',
      description: 'Quickly find what you need using our powerful search feature.',
      icon: Icons.search,
      shape: HighlightShape.circle,
    ),
  ]);

  _onboardingService.addFeatureHighlightStep([
    FeatureHighlight(
      targetKey: _profileKey,
      title: 'Profile',
      description: 'View and edit your profile information here.',
      icon: Icons.person,
      shape: HighlightShape.rectangle,
    ),
  ]);
}

4. Start the onboarding process:

_onboardingService.startOnboarding(context);

🎨 Customization #

Customize the appearance of your feature tour using FeatureTourTheme:

_onboardingService.setTheme(FeatureTourTheme(
  overlayColor: Colors.black87,
  highlightColor: Colors.amber,
  cardColor: Colors.grey[900]!,
  textColor: Colors.white,
  primaryColor: Colors.amber,
  titleStyle: const TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
  bodyStyle: const TextStyle(fontSize: 16),
  buttonStyle: const TextStyle(fontSize: 14, fontWeight: FontWeight.w500),
  cornerRadius: 12.0,
  highlightBorderWidth: 3.0,
));

You can also use the theme from your app:

_onboardingService.setTheme(FeatureTourTheme.fromTheme(Theme.of(context)));

📊 Analytics #

Integrate analytics to track user engagement:

_onboardingService.setAnalyticsCallback((String event, Map<String, dynamic> properties) {
  // Implement your analytics tracking here
  print('Analytics Event: $event, Properties: $properties');
});

The package tracks the following events:

• onboarding_started
• onboarding_restarted
• step_viewed
• step_completed
• onboarding_completed

🖼️ Interactive Elements #

Add interactive elements to your tour steps:

_onboardingService.setInteractiveWidgetBuilder((BuildContext context, VoidCallback onComplete) {
  return ElevatedButton(
    child: Text('Try it out!'),
    onPressed: () {
      // Simulate an action
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('You tried the feature!')),
      );
      onComplete();
    },
  );
});

🎭 Animations and Transitions #

The package includes smooth animations for the overlay appearance and highlight transitions. These are handled automatically by the FeatureHighlightOverlay widget.

💾 Persistence #

The onboarding progress is automatically saved using Hive. To check if onboarding is completed:

bool onboardingCompleted = await _onboardingService.isOnboardingCompleted();

To restart the onboarding process:

_onboardingService.restartOnboarding(context);

♿ Accessibility #

The package includes basic accessibility features:

• Semantic labels for the overlay and buttons
• Keyboard navigation support (Tab, Shift+Tab, Enter, Space)

🧪 Testing #

To facilitate testing, you can use the following methods:

testWidgets('Feature tour test', (WidgetTester tester) async {
  await tester.pumpWidget(MyApp());
  
  // Start onboarding
  await tester.tap(find.byType(StartOnboardingButton));
  await tester.pumpAndSettle();

  expect(find.byType(FeatureHighlightOverlay), findsOneWidget);
  expect(find.text('Search'), findsOneWidget);

  // Tap next button
  await tester.tap(find.text('Next'));
  await tester.pumpAndSettle();

  expect(find.text('Profile'), findsOneWidget);
});

🚧 Features in Development #

The following features are currently in development:

• 🔄 Advanced Navigation: Custom navigation paths and conditional steps
• 🌐 Localization: Built-in support for easy localization of tour content
• 🎯 Multiple Simultaneous Highlights: Ability to highlight multiple elements at once

🤝 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.## Demo

Below are demonstrations of the Feature Tour in action: