Merge pull request #473 from OpenPecha/feat/PlanShareDeepLink

feat: add deep link support for series sharing and enhance routing

Author: tentamdin

lib/core/config/router/app_router.dart

@@ -122,6 +122,16 @@ final appRouterProvider = Provider<GoRouter>((ref) {
         redirect: (_, __) => AppRoutes.home,
       ),
 
+      // Compatibility fallback for series deep links delivered directly to
+      // go_router instead of through AppLinksDeepLinkService.
+      GoRoute(
+        path: '/open/series/:seriesId',
+        name: 'open-series',
+        redirect: (_, state) {
+          final seriesId = state.pathParameters['seriesId'] ?? '';
+          return '/home/series/$seriesId';
+        },
+      ),
       // Compatibility fallback in case a platform sends the first-party app
       // link directly to go_router instead of through AppLinksDeepLinkService.
       GoRoute(

lib/core/deep_linking/deep_link_router.dart

@@ -81,6 +81,16 @@ class DeepLinkRouter {
 
   static _DeepLinkDestination _resolveFirstPartyAppLink(Uri uri) {
     final segments = uri.pathSegments;
+    if (segments.length >= 3 &&
+        segments[0] == 'open' &&
+        segments[1] == 'series') {
+      final seriesId = segments[2];
+      return _DeepLinkDestination(
+        '/home/series/${Uri.encodeComponent(seriesId)}',
+        opensOnTop: true,
+      );
+    }
+
     if (segments.length >= 3 &&
         segments[0] == 'open' &&
         segments[1] == 'reader') {

lib/core/deep_linking/deep_link_url_builder.dart

@@ -3,6 +3,14 @@ class DeepLinkUrlBuilder {
 
   static const String _host = 'webuddhist.com';
 
+  static Uri seriesLink({required String seriesId}) {
+    return Uri(
+      scheme: 'https',
+      host: _host,
+      pathSegments: ['open', 'series', seriesId],
+    );
+  }
+
   static Uri readerSegmentLink({
     required String textId,
     required String segmentId,

lib/features/home/presentation/screens/series_detail_screen.dart

@@ -1,5 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_pecha/core/constants/app_assets.dart';
+import 'package:flutter_pecha/core/deep_linking/deep_link_url_builder.dart';
 import 'package:flutter_pecha/core/l10n/generated/app_localizations.dart';
 import 'package:flutter_pecha/core/widgets/error_state_widget.dart';
 import 'package:flutter_pecha/core/widgets/skeletons/skeletons.dart';
@@ -17,6 +18,7 @@ import 'package:flutter_pecha/features/practice/presentation/providers/bookmark_
 import 'package:flutter_pecha/shared/utils/helper_functions.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
+import 'package:share_plus/share_plus.dart';
 
 class SeriesDetailScreen extends ConsumerWidget {
   final String seriesId;
@@ -199,9 +201,17 @@ class SeriesDetailScreen extends ConsumerWidget {
       seriesId: series.id,
       seriesName: series.title,
       onAddToPractices: () => _onAddToPractices(context, ref, series),
+      onShare: () => _onShare(series),
     );
   }
 
+  Future<void> _onShare(Series series) async {
+    final url = DeepLinkUrlBuilder.seriesLink(seriesId: series.id).toString();
+    final message =
+        'Join me in practicing ${series.title} on WeBuddhist.\n\n$url';
+    await SharePlus.instance.share(ShareParams(text: message));
+  }
+
   /// Adds the series to the user's practice routine.
   ///
   /// Opens the routine editor with the already-loaded [series] injected. Adding

lib/features/home/presentation/widgets/series_more_bottom_sheet.dart

@@ -13,17 +13,20 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 /// Contains:
 ///   • "+ Add to my practices" action
 ///   • Bookmark toggle action
+///   • Share action
 class SeriesMoreBottomSheet extends ConsumerStatefulWidget {
   const SeriesMoreBottomSheet({
     super.key,
     required this.seriesId,
     required this.seriesName,
     this.onAddToPractices,
+    this.onShare,
   });
 
   final String seriesId;
   final String seriesName;
   final VoidCallback? onAddToPractices;
+  final VoidCallback? onShare;
 
   @override
   ConsumerState<SeriesMoreBottomSheet> createState() =>
@@ -118,6 +121,18 @@ class _SeriesMoreBottomSheetState extends ConsumerState<SeriesMoreBottomSheet> {
             },
           ),
 
+          // ── Share ──────────────────────────────────────────────────────
+          _SectionDivider(theme: theme),
+          ListTile(
+            leading: Icon(AppAssets.share, color: theme.colorScheme.onSurface),
+            title: Text('Share', style: theme.textTheme.bodyLarge),
+            onTap: () {
+              HapticFeedback.lightImpact();
+              Navigator.of(context).pop();
+              widget.onShare?.call();
+            },
+          ),
+
           const SizedBox(height: 8),
         ],
       ),
@@ -140,6 +155,7 @@ void showSeriesMoreBottomSheet(
   required String seriesId,
   required String seriesName,
   VoidCallback? onAddToPractices,
+  VoidCallback? onShare,
 }) {
   showModalBottomSheet(
     context: context,
@@ -153,6 +169,7 @@ void showSeriesMoreBottomSheet(
           seriesId: seriesId,
           seriesName: seriesName,
           onAddToPractices: onAddToPractices,
+          onShare: onShare,
         ),
   );
 }