Develop

.gitignore

@@ -69,4 +69,5 @@ DEVELOPER_ARCHITECTURE_GUIDE.docx
 lib/features/practice/specs/routines-openapi.yaml
 
 # claude
-CLAUDE.md
+CLAUDE.md
+/docs/notification/notification.md

android/app/src/main/assets/airbridge.json

@@ -1,8 +1,11 @@
 {
-  "sdkEnabled": true,
-  "logLevel": "info",
-  "autoStartTrackingEnabled": true,
-  "sessionTimeoutInSecond": 300,
-  "hashUserInformationEnabled": true,
-  "trackAirbridgeDeeplinkOnlyEnabled": true
+    "sdkEnabled": true,
+    "logLevel": "info",
+    "autoStartTrackingEnabled": true,
+    "sessionTimeoutInSecond": 300,
+    "hashUserInformationEnabled": true,
+    "trackAirbridgeDeeplinkOnlyEnabled": true,
+    "trackingLinkCustomDomains": [
+        "join.webuddhist.com"
+    ]
 }

android/app/src/main/res/mipmap-anydpi-v26/launcher_icon.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+  <background android:drawable="@color/ic_launcher_background"/>
+  <foreground>
+      <inset
+          android:drawable="@drawable/ic_launcher_foreground"
+          android:inset="16%" />
+  </foreground>
+</adaptive-icon>

android/app/src/main/res/values/colors.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="ic_launcher_background">#FFFFFF</color>
+</resources>

ios/Flutter/Runner.entitlements.template

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.developer.associated-domains</key>
+	<array>
+		<string>webcredentials:${AUTH0_DOMAIN}</string>
+		<string>applinks:${AIRBRIDGE_APP_NAME}.airbridge.io</string>
+		<string>applinks:${AIRBRIDGE_APP_NAME}.abr.ge</string>
+		<string>applinks:join.webuddhist.com</string>
+	</array>
+</dict>
+</plist>

ios/Podfile.lock

@@ -211,16 +211,13 @@ PODS:
   - OrderedSet (6.0.3)
   - package_info_plus (0.4.5):
     - Flutter
-  - path_provider_foundation (0.0.1):
-    - Flutter
-    - FlutterMacOS
   - permission_handler_apple (9.4.8):
     - Flutter
   - PostHog (3.61.0)
   - posthog_flutter (0.0.1):
     - Flutter
     - FlutterMacOS
-    - PostHog (< 4.0.0, >= 3.59.3)
+    - PostHog (< 4.0.0, >= 3.61.0)
   - PromisesObjC (2.4.1)
   - PromisesSwift (2.4.1):
     - PromisesObjC (= 2.4.1)
@@ -266,7 +263,6 @@ DEPENDENCIES:
   - image_picker_ios (from `.symlinks/plugins/image_picker_ios/ios`)
   - just_audio (from `.symlinks/plugins/just_audio/darwin`)
   - package_info_plus (from `.symlinks/plugins/package_info_plus/ios`)
-  - path_provider_foundation (from `.symlinks/plugins/path_provider_foundation/darwin`)
   - permission_handler_apple (from `.symlinks/plugins/permission_handler_apple/ios`)
   - posthog_flutter (from `.symlinks/plugins/posthog_flutter/darwin`)
   - share_plus (from `.symlinks/plugins/share_plus/ios`)
@@ -346,8 +342,6 @@ EXTERNAL SOURCES:
     :path: ".symlinks/plugins/just_audio/darwin"
   package_info_plus:
     :path: ".symlinks/plugins/package_info_plus/ios"
-  path_provider_foundation:
-    :path: ".symlinks/plugins/path_provider_foundation/darwin"
   permission_handler_apple:
     :path: ".symlinks/plugins/permission_handler_apple/ios"
   posthog_flutter:
@@ -405,10 +399,9 @@ SPEC CHECKSUMS:
   nanopb: fad817b59e0457d11a5dfbde799381cd727c1275
   OrderedSet: e539b66b644ff081c73a262d24ad552a69be3a94
   package_info_plus: af8e2ca6888548050f16fa2f1938db7b5a5df499
-  path_provider_foundation: bb55f6dbba17d0dccd6737fe6f7f34fbd0376880
   permission_handler_apple: 92d754bbaa7361d436db2d6c3c1c2a0fdcec462e
   PostHog: 82eee1ba92efc8144b06b6e4412abba5438c8fda
-  posthog_flutter: 343db84a70d44b12fa0fe2fc35bbb58098074bd4
+  posthog_flutter: 35d27c0ca7b0afe0e24789b1c6594e88dfffe066
   PromisesObjC: 752c3227f599e3467650e47ea36f433eeb10c273
   PromisesSwift: 217dea0fd5d2ad65222a109c48698add13cc1c5b
   SDWebImage: e9fc87c1aab89a8ab1bbd74eba378c6f53be8abf

ios/Runner.xcodeproj/project.pbxproj

@@ -3,7 +3,7 @@
 	archiveVersion = 1;
 	classes = {
 	};
-	objectVersion = 54;
+	objectVersion = 60;
 	objects = {
 
 /* Begin PBXBuildFile section */
@@ -294,7 +294,7 @@
 			);
 			mainGroup = 97C146E51CF9000F007C117D;
 			packageReferences = (
-				781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "FlutterGeneratedPluginSwiftPackage" */,
+				781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage" */,
 			);
 			productRefGroup = 97C146EF1CF9000F007C117D /* Products */;
 			projectDirPath = "";
@@ -338,10 +338,14 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources-${CONFIGURATION}-input-files.xcfilelist",
 			);
+			inputPaths = (
+			);
 			name = "[CP] Copy Pods Resources";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources-${CONFIGURATION}-output-files.xcfilelist",
 			);
+			outputPaths = (
+			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources.sh\"\n";
@@ -371,10 +375,14 @@
 			inputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks-${CONFIGURATION}-input-files.xcfilelist",
 			);
+			inputPaths = (
+			);
 			name = "[CP] Embed Pods Frameworks";
 			outputFileListPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks-${CONFIGURATION}-output-files.xcfilelist",
 			);
+			outputPaths = (
+			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
 			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks.sh\"\n";
@@ -626,7 +634,7 @@
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = R523566J54;
+				DEVELOPMENT_TEAM = "";
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				INFOPLIST_KEY_CFBundleDisplayName = WeBuddhist;
@@ -823,7 +831,7 @@
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = R523566J54;
+				DEVELOPMENT_TEAM = "";
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				INFOPLIST_KEY_CFBundleDisplayName = WeBuddhist;
@@ -855,7 +863,7 @@
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = R523566J54;
+				DEVELOPMENT_TEAM = "";
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				INFOPLIST_KEY_CFBundleDisplayName = WeBuddhist;
@@ -886,7 +894,7 @@
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = R523566J54;
+				DEVELOPMENT_TEAM = PZFFFQ5T9X;
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				INFOPLIST_KEY_CFBundleDisplayName = "[Dev] WeBuddhist";
@@ -918,7 +926,7 @@
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = R523566J54;
+				DEVELOPMENT_TEAM = PZFFFQ5T9X;
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				INFOPLIST_KEY_CFBundleDisplayName = "[Dev] WeBuddhist";
@@ -949,7 +957,7 @@
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = R523566J54;
+				DEVELOPMENT_TEAM = "";
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				INFOPLIST_KEY_CFBundleDisplayName = WeBuddhist;
@@ -981,7 +989,7 @@
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = R523566J54;
+				DEVELOPMENT_TEAM = "";
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				INFOPLIST_KEY_CFBundleDisplayName = WeBuddhist;
@@ -1558,7 +1566,7 @@
 /* End XCConfigurationList section */
 
 /* Begin XCLocalSwiftPackageReference section */
-		781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "FlutterGeneratedPluginSwiftPackage" */ = {
+		781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage" */ = {
 			isa = XCLocalSwiftPackageReference;
 			relativePath = Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage;
 		};

lib/core/config/protected_routes.dart

@@ -82,6 +82,11 @@ class ProtectedRoutes {
   /// The token is sent when the user is authenticated; silently skipped for guests.
   static const List<String> optionalPaths = [
     '/plans/{planId}/days',
+    // Series list/detail: sends auth when logged in so the response includes
+    // user-enriched fields like `progress` and `partner`.
+    '/series',
+    '/series/{id}',
+    '/series/featured',
     '/author/groups',
     // Group detail + members: sends auth when logged in so fields like
     // `is_group_enrolled` reflect the current user (anonymous GET → false).

lib/core/constants/app_assets.dart

@@ -17,11 +17,14 @@ class AppAssets {
   static const String verseOfDayFallback = 'assets/images/buddha.jpeg';
 
   // ========== AUDIO ==========
-  static const String meditationSound = 'assets/audios/meditation.mp3';
+  // PCM WAV (not MP3): ExoPlayer's offload path mis-parses the encoded MP3 on
+  // the first cold-start play (getFramesPerEncodedSample → IllegalArgumentException),
+  // dropping the bell. PCM never takes that path, matching the working mala.wav.
+  static const String meditationSound = 'assets/audios/meditation.wav';
   static const String malaSound = 'assets/audios/mala.wav';
 
   // ========== LOGOS ==========
-  static const String weBuddhistLogo = 'assets/images/webuddhist_gold.png';
+  static const String weBuddhistLogo = 'assets/images/app_logo.png';
   static const String googleIcon = 'assets/images/google-icon.png';
 
   // ========== AUTH ICONS ==========

lib/core/deep_linking/app_links_deep_link_service.dart

@@ -60,16 +60,52 @@ class AppLinksDeepLinkService {
   }
 
   bool drainPendingLink() {
-    if (_router == null) return false;
+    final router = _router;
+    if (router == null) return false;
 
     final pending = _pendingUri;
     if (pending == null) return false;
 
     _pendingUri = null;
-    _dispatch(pending, baseLocation: AppRoutes.home);
+    // Cold start: draining is scheduled the moment auth finishes loading, but
+    // the auth-driven route guard redirect (/splash -> /home) resolves
+    // asynchronously and may not have completed yet. Pushing the deep-link
+    // target now would leave /splash as the base of the back stack, so pressing
+    // Back would show the splash loading spinner. Wait until the router has
+    // actually settled off /splash before dispatching so the target is pushed
+    // on top of /home and Back returns Home.
+    _dispatchWhenRouterSettled(router, pending);
     return true;
   }
 
+  /// Dispatches [uri] once the router's base location has left `/splash`.
+  ///
+  /// Uses `currentConfiguration.uri`, which reflects only non-imperative
+  /// matches (i.e. the true base location, ignoring any pushed pages). The
+  /// router delegate is a [Listenable], so we attach a one-shot listener when
+  /// the base has not settled yet.
+  void _dispatchWhenRouterSettled(GoRouter router, Uri uri) {
+    final delegate = router.routerDelegate;
+
+    bool isSettled() =>
+        delegate.currentConfiguration.uri.path != AppRoutes.splash;
+
+    if (isSettled()) {
+      _dispatch(uri);
+      return;
+    }
+
+    _logger.info('Router still on splash, deferring deep link dispatch: $uri');
+    void onRouterChanged() {
+      if (!isSettled()) return;
+      delegate.removeListener(onRouterChanged);
+      _logger.info('Router settled, dispatching deferred deep link: $uri');
+      _dispatch(uri);
+    }
+
+    delegate.addListener(onRouterChanged);
+  }
+
   Future<void> dispose() async {
     await _subscription?.cancel();
     _subscription = null;