Merge pull request #359 from BrawlerXull/tour

Provide Detailed Tour for the entire Application for new users

Author: Pavel401

lib/app/modules/about/views/about_page_body.dart

@@ -11,7 +11,7 @@ import 'package:url_launcher/url_launcher.dart';
 
 import 'package:taskwarrior/app/utils/constants/taskwarrior_colors.dart';
 import 'package:taskwarrior/app/utils/constants/taskwarrior_fonts.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 
 class AboutPageBody extends StatelessWidget {
   final AboutController aboutController;

lib/app/modules/about/views/about_view.dart

@@ -7,7 +7,7 @@ import 'package:taskwarrior/app/modules/about/views/about_page_body.dart';
 
 import '../controllers/about_controller.dart';
 import 'package:taskwarrior/app/utils/constants/taskwarrior_colors.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 
 class AboutView extends GetView<AboutController> {
   const AboutView({super.key});

lib/app/modules/detailRoute/controllers/detail_route_controller.dart

@@ -1,10 +1,15 @@
 // ignore_for_file: depend_on_referenced_packages
 
 import 'package:built_collection/built_collection.dart';
+import 'package:flutter/material.dart';
 import 'package:get/get.dart';
 import 'package:taskwarrior/app/modules/home/controllers/home_controller.dart';
+import 'package:taskwarrior/app/tour/details_page_tour.dart';
+import 'package:taskwarrior/app/utils/constants/taskwarrior_colors.dart';
 import 'package:taskwarrior/app/utils/taskfunctions/modify.dart';
 import 'package:taskwarrior/app/utils/taskfunctions/urgency.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
+import 'package:tutorial_coach_mark/tutorial_coach_mark.dart';
 
 class DetailRouteController extends GetxController {
   late String uuid;
@@ -87,4 +92,49 @@ class DetailRouteController extends GetxController {
     tagsValue?.value = modify.draft.tags;
     urgencyValue.value = urgency(modify.draft);
   }
+
+  late TutorialCoachMark tutorialCoachMark;
+
+  final GlobalKey dueKey = GlobalKey();
+  final GlobalKey untilKey = GlobalKey();
+
+  final GlobalKey waitKey = GlobalKey();
+  final GlobalKey priorityKey = GlobalKey();
+
+  void initDetailsPageTour() {
+    tutorialCoachMark = TutorialCoachMark(
+      targets: addDetailsPage(
+        dueKey: dueKey,
+        waitKey: waitKey,
+        untilKey: untilKey,
+        priorityKey: priorityKey,
+      ),
+      colorShadow: TaskWarriorColors.black,
+      paddingFocus: 10,
+      opacityShadow: 1.00,
+      hideSkip: true,
+      onFinish: () {
+        SaveTourStatus.saveDetailsTourStatus(true);
+      },
+    );
+  }
+
+  void showDetailsPageTour(BuildContext context) {
+    Future.delayed(
+      const Duration(milliseconds: 500),
+      () {
+        SaveTourStatus.getDetailsTourStatus().then((value) => {
+              if (value == false)
+                {
+                  tutorialCoachMark.show(context: context),
+                }
+              else
+                {
+                  // ignore: avoid_print
+                  print('User has seen this page'),
+                }
+            });
+      },
+    );
+  }
 }

lib/app/modules/detailRoute/views/dateTimePicker.dart

@@ -6,24 +6,27 @@ import 'package:intl/intl.dart';
 
 import 'package:taskwarrior/app/utils/constants/constants.dart';
 import 'package:taskwarrior/app/utils/gen/fonts.gen.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 
 class DateTimeWidget extends StatelessWidget {
   const DateTimeWidget({
     super.key,
     required this.name,
     required this.value,
     required this.callback,
+    required this.globalKey,
   });
 
   final String name;
 
   final dynamic value;
   final void Function(dynamic) callback;
+  final GlobalKey globalKey;
 
   @override
   Widget build(BuildContext context) {
     return Card(
+      key: globalKey,
       color: AppSettings.isDarkMode
           ? const Color.fromARGB(255, 57, 57, 57)
           : Colors.white,

lib/app/modules/detailRoute/views/description_widget.dart

@@ -5,7 +5,7 @@ import 'package:loggy/loggy.dart';
 import 'package:taskwarrior/app/utils/constants/constants.dart';
 import 'package:taskwarrior/app/utils/constants/utilites.dart';
 import 'package:taskwarrior/app/utils/gen/fonts.gen.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 
 class DescriptionWidget extends StatelessWidget {
   const DescriptionWidget(

lib/app/modules/detailRoute/views/detail_route_view.dart

@@ -13,13 +13,15 @@ import 'package:taskwarrior/app/modules/detailRoute/views/tags_widget.dart';
 import 'package:taskwarrior/app/utils/constants/constants.dart';
 import 'package:taskwarrior/app/utils/gen/fonts.gen.dart';
 import 'package:taskwarrior/app/utils/language/sentence_manager.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 
 class DetailRouteView extends GetView<DetailRouteController> {
   const DetailRouteView({super.key});
 
   @override
   Widget build(BuildContext context) {
+    controller.initDetailsPageTour();
+    controller.showDetailsPageTour(context);
     return WillPopScope(
       onWillPop: () async {
         if (!controller.onEdit.value) {
@@ -135,6 +137,10 @@ class DetailRouteView extends GetView<DetailRouteController> {
                         value: entry.value,
                         callback: (newValue) =>
                             controller.setAttribute(entry.key, newValue),
+                        waitKey: controller.waitKey,
+                        dueKey: controller.dueKey,
+                        untilKey: controller.untilKey,
+                        priorityKey: controller.priorityKey,
                       ),
                   ],
                 ),
@@ -225,12 +231,20 @@ class AttributeWidget extends StatelessWidget {
     required this.name,
     required this.value,
     required this.callback,
+    required this.waitKey,
+    required this.dueKey,
+    required this.priorityKey,
+    required this.untilKey,
     super.key,
   });
 
   final String name;
   final dynamic value;
   final void Function(dynamic) callback;
+  final GlobalKey waitKey;
+  final GlobalKey dueKey;
+  final GlobalKey untilKey;
+  final GlobalKey priorityKey;
 
   @override
   Widget build(BuildContext context) {
@@ -262,24 +276,28 @@ class AttributeWidget extends StatelessWidget {
           name: name,
           value: localValue,
           callback: callback,
+          globalKey: dueKey,
         );
       case 'wait':
         return DateTimeWidget(
           name: name,
           value: localValue,
           callback: callback,
+          globalKey: waitKey,
         );
       case 'until':
         return DateTimeWidget(
           name: name,
           value: localValue,
           callback: callback,
+          globalKey: untilKey,
         );
       case 'priority':
         return PriorityWidget(
           name: name,
           value: localValue,
           callback: callback,
+          globalKey: priorityKey,
         );
       case 'project':
         return ProjectWidget(

lib/app/modules/detailRoute/views/priority_widget.dart

@@ -1,22 +1,25 @@
 import 'package:flutter/material.dart';
 import 'package:google_fonts/google_fonts.dart';
 import 'package:taskwarrior/app/utils/constants/constants.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 
 class PriorityWidget extends StatelessWidget {
   const PriorityWidget(
       {required this.name,
       required this.value,
       required this.callback,
+      required this.globalKey,
       super.key});
 
   final String name;
   final dynamic value;
   final void Function(dynamic) callback;
+  final GlobalKey globalKey;
 
   @override
   Widget build(BuildContext context) {
     return Card(
+      key: globalKey,
       color: AppSettings.isDarkMode
           ? const Color.fromARGB(255, 57, 57, 57)
           : Colors.white,

lib/app/modules/detailRoute/views/status_widget.dart

@@ -4,7 +4,7 @@ import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:google_fonts/google_fonts.dart';
 import 'package:taskwarrior/app/utils/constants/constants.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 
 
 class StatusWidget extends StatelessWidget {

lib/app/modules/detailRoute/views/tags_widget.dart

@@ -11,7 +11,7 @@ import 'package:taskwarrior/app/modules/home/controllers/home_controller.dart';
 import 'package:taskwarrior/app/utils/constants/constants.dart';
 import 'package:taskwarrior/app/utils/constants/utilites.dart';
 import 'package:taskwarrior/app/utils/taskfunctions/validate.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 
 class TagsWidget extends StatelessWidget {
   const TagsWidget({

lib/app/modules/home/controllers/home_controller.dart

@@ -28,7 +28,7 @@ import 'package:taskwarrior/app/utils/taskfunctions/comparator.dart';
 import 'package:taskwarrior/app/utils/taskfunctions/projects.dart';
 import 'package:taskwarrior/app/utils/taskfunctions/query.dart';
 import 'package:taskwarrior/app/utils/taskfunctions/tags.dart';
-import 'package:taskwarrior/app/utils/theme/app_settings.dart';
+import 'package:taskwarrior/app/utils/app_settings/app_settings.dart';
 import 'package:tutorial_coach_mark/tutorial_coach_mark.dart';
 
 class HomeController extends GetxController {