fix: Store starred plans in SharedPreferences when configuring native fetcher

- Add updateStarredPlans call in configureNativeFetcher to store starred
  plan IDs in SharedPreferences for the native fetcher to use
- Clear starred plans if none provided to ensure state consistency
- Add starredPlansCount to configuration log for debugging

This fixes the issue where the native fetcher was querying the API
with an empty planIds array because starred plans weren't being stored
in SharedPreferences. Now when configureNativeFetcher is called with
starredPlanHandleIds, they are properly stored and available for
background prefetch operations.

Also updates package-lock.json for daily-notification-plugin v1.0.11.

.cursor/rules/development/development_guide.mdc

@@ -2,9 +2,8 @@
 globs: **/src/**/*
 alwaysApply: false
 ---
-✅ use system date command to timestamp all interactions with accurate date and
+✅ use system date command to timestamp all documentation with accurate date and
   time
-✅ python script files must always have a blank line at their end
 ✅ remove whitespace at the end of lines
 ✅ use npm run lint-fix to check for warnings
 ✅ do not use npm run dev let me handle running and supplying feedback
@@ -22,12 +21,10 @@ alwaysApply: false
 
 - [ ] **Timestamp Usage**: Include accurate timestamps in all interactions
 - [ ] **Code Quality**: Use npm run lint-fix to check for warnings
-- [ ] **File Standards**: Ensure Python files have blank line at end
 - [ ] **Whitespace**: Remove trailing whitespace from all lines
 
 ### After Development
 
 - [ ] **Linting Check**: Run npm run lint-fix to verify code quality
-- [ ] **File Validation**: Confirm Python files end with blank line
 - [ ] **Whitespace Review**: Verify no trailing whitespace remains
 - [ ] **Documentation**: Update relevant documentation with changes

.husky/pre-commit

@@ -9,6 +9,10 @@ echo "🔍 Running pre-commit hooks..."
 
 # Run lint-fix first
 echo "📝 Running lint-fix..."
+
+# Capture git status before lint-fix to detect changes
+git_status_before=$(git status --porcelain)
+
 npm run lint-fix || {
     echo
     echo "❌ Linting failed. Please fix the issues and try again."
@@ -18,6 +22,36 @@ npm run lint-fix || {
     exit 1
 }
 
+# Check if lint-fix made any changes
+git_status_after=$(git status --porcelain)
+
+if [ "$git_status_before" != "$git_status_after" ]; then
+    echo
+    echo "⚠️  lint-fix made changes to your files!"
+    echo "📋 Changes detected:"
+    git diff --name-only
+    echo
+    echo "❓ What would you like to do?"
+    echo "   [c] Continue commit without the new changes"
+    echo "   [a] Abort commit (recommended - review and stage the changes)"
+    echo
+    printf "Choose [c/a]: "
+    # The `< /dev/tty` is necessary to make read work in git's non-interactive shell
+    read choice < /dev/tty
+    
+    case $choice in
+        [Cc]* )
+            echo "✅ Continuing commit without lint-fix changes..."
+            sleep 3
+            ;;
+        [Aa]* | * )
+            echo "🛑 Commit aborted. Please review the changes made by lint-fix."
+            echo "💡 You can stage the changes with 'git add .' and commit again."
+            exit 1
+            ;;
+    esac
+fi
+
 # Then run Build Architecture Guard
 
 #echo "🏗️  Running Build Architecture Guard..."

BUILDING.md

@@ -1151,28 +1151,28 @@ If you need to build manually or want to understand the individual steps:
 
 - ... and you may have to fix these, especially with pkgx:
 
-   ```bash
-   gem_path=$(which gem)
-   shortened_path="${gem_path:h:h}"
-   export GEM_HOME=$shortened_path
-   export GEM_PATH=$shortened_path
-   ```
+```bash
+gem_path=$(which gem)
+shortened_path="${gem_path:h:h}"
+export GEM_HOME=$shortened_path
+export GEM_PATH=$shortened_path
+```
 
-##### 1. Bump the version in package.json, then here
+##### 1. Bump the version in package.json for `MARKETING_VERSION`, then `grep CURRENT_PROJECT_VERSION ios/App/App.xcodeproj/project.pbxproj` and add 1 for the numbered version;
 
-   ```bash
-   cd ios/App && xcrun agvtool new-version 40 && perl -p -i -e "s/MARKETING_VERSION = .*;/MARKETING_VERSION = 1.0.7;/g" App.xcodeproj/project.pbxproj && cd -
-   # Unfortunately this edits Info.plist directly.
-   #xcrun agvtool new-marketing-version 0.4.5
-   ```
+```bash
+cd ios/App && xcrun agvtool new-version 47 && perl -p -i -e "s/MARKETING_VERSION = .*;/MARKETING_VERSION = 1.1.2;/g" App.xcodeproj/project.pbxproj && cd -
+# Unfortunately this edits Info.plist directly.
+#xcrun agvtool new-marketing-version 0.4.5
+```
 
 ##### 2. Build
 
-  Here's prod. Also available: test, dev
+Here's prod. Also available: test, dev
 
-  ```bash
-  npm run build:ios:prod
-  ```
+```bash
+npm run build:ios:prod
+```
 
 3.1. Use Xcode to build and run on simulator or device.
 
@@ -1197,7 +1197,8 @@ If you need to build manually or want to understand the individual steps:
   - It can take 15 minutes for the build to show up in the list of builds.
   - You'll probably have to "Manage" something about encryption, disallowed in France.
   - Then "Save" and "Add to Review" and "Resubmit to App Review".
-- Eventually it'll be "Ready for Distribution" which means
+- Eventually it'll be "Ready for Distribution" which means it's live
+- When finished, bump package.json version
 
 ### Android Build
 
@@ -1315,26 +1316,26 @@ The recommended way to build for Android is using the automated build script:
 
 #### Android Manual Build Process
 
-##### 1. Bump the version in package.json, then here: android/app/build.gradle
+##### 1. Bump the version in package.json, then update these versions & run:
 
-  ```bash
-  perl -p -i -e 's/versionCode .*/versionCode 40/g' android/app/build.gradle
-  perl -p -i -e 's/versionName .*/versionName "1.0.7"/g' android/app/build.gradle
-  ```
+```bash
+perl -p -i -e 's/versionCode .*/versionCode 47/g' android/app/build.gradle
+perl -p -i -e 's/versionName .*/versionName "1.1.2"/g' android/app/build.gradle
+```
 
 ##### 2. Build
 
   Here's prod. Also available: test, dev
 
-  ```bash
-  npm run build:android:prod
-  ```
+```bash
+npm run build:android:prod
+```
 
 ##### 3. Open the project in Android Studio
 
-   ```bash
-   npx cap open android
-   ```
+```bash
+npx cap open android
+```
 
 ##### 4. Use Android Studio to build and run on emulator or device
 
@@ -1379,6 +1380,8 @@ At play.google.com/console:
 - Note that if you add testers, you have to go to "Publishing Overview" and send
   those changes or your (closed) testers won't see it.
 
+- When finished, bump package.json version
+
 ### Capacitor Operations
 
 ```bash

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## [1.1.2] - 2025.11.06
+
+### Fixed
+- Bad page when user follows prompt to backup seed
+
+
+## [1.1.1] - 2025.11.03
+
+### Added
+- Meeting onboarding via prompts
+- Emojis on gift feed
+- Starred projects with notification
+
+
 ## [1.0.7] - 2025.08.18
 
 ### Fixed

android/app/build.gradle

@@ -31,8 +31,8 @@ android {
         applicationId "app.timesafari.app"
         minSdkVersion rootProject.ext.minSdkVersion
         targetSdkVersion rootProject.ext.targetSdkVersion
-        versionCode 41
-        versionName "1.0.8"
+        versionCode 47
+        versionName "1.1.2"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         aaptOptions {
              // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
@@ -101,6 +101,8 @@ dependencies {
     implementation project(':capacitor-android')
     implementation project(':capacitor-community-sqlite')
     implementation "androidx.biometric:biometric:1.2.0-alpha05"
+    // Gson for JSON parsing in native notification fetcher
+    implementation "com.google.code.gson:gson:2.10.1"
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

android/app/capacitor.build.gradle

@@ -18,6 +18,7 @@ dependencies {
     implementation project(':capacitor-share')
     implementation project(':capacitor-status-bar')
     implementation project(':capawesome-capacitor-file-picker')
+    implementation project(':timesafari-daily-notification-plugin')
 
 }
 

android/app/src/main/AndroidManifest.xml

@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <application
+        android:name=".TimeSafariApplication"
         android:allowBackup="true"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
@@ -36,6 +37,30 @@
             android:grantUriPermissions="true">
             <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths" />
         </provider>
+
+        <!-- Daily Notification Plugin Receivers -->
+        <receiver
+            android:name="com.timesafari.dailynotification.DailyNotificationReceiver"
+            android:enabled="true"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="com.timesafari.daily.NOTIFICATION" />
+            </intent-filter>
+        </receiver>
+        <receiver
+            android:name="com.timesafari.dailynotification.BootReceiver"
+            android:directBootAware="true"
+            android:enabled="true"
+            android:exported="true">
+            <intent-filter android:priority="1000">
+                <!-- Delivered very early after reboot (before unlock) -->
+                <action android:name="android.intent.action.LOCKED_BOOT_COMPLETED" />
+                <!-- Delivered after the user unlocks / credential-encrypted storage is available -->
+                <action android:name="android.intent.action.BOOT_COMPLETED" />
+                <!-- Delivered after app update; great for rescheduling alarms without reboot -->
+                <action android:name="android.intent.action.MY_PACKAGE_REPLACED" />
+            </intent-filter>
+        </receiver>
     </application>
 
     <!-- Permissions -->
@@ -45,4 +70,15 @@
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
     <uses-permission android:name="android.permission.CAMERA" />
     <uses-feature android:name="android.hardware.camera" android:required="true" />
+
+    <!-- Notification permissions -->
+    <!-- POST_NOTIFICATIONS required for Android 13+ (API 33+) -->
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+
+    <!-- SCHEDULE_EXACT_ALARM required for Android 12+ (API 31+) to schedule exact alarms -->
+    <!-- Note: On Android 12+, users can grant/deny this permission -->
+    <uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" />
+
+    <!-- RECEIVE_BOOT_COMPLETED needed to reschedule notifications after device reboot -->
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
 </manifest>

android/app/src/main/assets/capacitor.plugins.json

@@ -34,5 +34,9 @@
 	{
 		"pkg": "@capawesome/capacitor-file-picker",
 		"classpath": "io.capawesome.capacitorjs.plugins.filepicker.FilePickerPlugin"
+	},
+	{
+		"pkg": "@timesafari/daily-notification-plugin",
+		"classpath": "com.timesafari.dailynotification.DailyNotificationPlugin"
 	}
 ]

android/app/src/main/java/app/timesafari/TimeSafariApplication.java

@@ -0,0 +1,118 @@
+/**
+ * TimeSafariApplication.java
+ * 
+ * Application class for the TimeSafari app.
+ * Registers the native content fetcher for the Daily Notification Plugin.
+ * 
+ * @author TimeSafari Team
+ * @version 1.0.0
+ */
+
+package app.timesafari;
+
+import android.app.Application;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.content.Context;
+import android.os.Build;
+import android.util.Log;
+import com.timesafari.dailynotification.DailyNotificationPlugin;
+import com.timesafari.dailynotification.NativeNotificationContentFetcher;
+
+/**
+ * Application class that registers native fetcher for daily notifications
+ */
+public class TimeSafariApplication extends Application {
+    
+    private static final String TAG = "TimeSafariApplication";
+    
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        
+        // Instrumentation: Log app initialization with process info
+        int pid = android.os.Process.myPid();
+        String processName = getApplicationInfo().processName;
+        Log.i(TAG, String.format(
+            "APP|ON_CREATE ts=%d pid=%d processName=%s",
+            System.currentTimeMillis(),
+            pid,
+            processName
+        ));
+        
+        Log.i(TAG, "Initializing TimeSafari Application");
+        
+        // Create notification channel for daily notifications (required for Android 8.0+)
+        createNotificationChannel();
+        
+        // Register native fetcher with application context
+        Context context = getApplicationContext();
+        NativeNotificationContentFetcher nativeFetcher = 
+            new TimeSafariNativeFetcher(context);
+        
+        // Instrumentation: Log before registration
+        Log.i(TAG, String.format(
+            "FETCHER|REGISTER_START instanceHash=%d ts=%d",
+            nativeFetcher.hashCode(),
+            System.currentTimeMillis()
+        ));
+        
+        DailyNotificationPlugin.setNativeFetcher(nativeFetcher);
+        
+        // Instrumentation: Verify registration succeeded
+        NativeNotificationContentFetcher verified = 
+            DailyNotificationPlugin.getNativeFetcherStatic();
+        boolean registered = (verified != null && verified == nativeFetcher);
+        
+        Log.i(TAG, String.format(
+            "FETCHER|REGISTERED providerKey=DailyNotificationPlugin instanceHash=%d registered=%s ts=%d",
+            nativeFetcher.hashCode(),
+            registered,
+            System.currentTimeMillis()
+        ));
+        
+        Log.i(TAG, "Native fetcher registered: " + nativeFetcher.getClass().getName());
+    }
+    
+    /**
+     * Create notification channel for daily notifications
+     * Required for Android 8.0 (API 26) and above
+     */
+    private void createNotificationChannel() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            NotificationManager notificationManager = 
+                (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
+            
+            if (notificationManager == null) {
+                Log.w(TAG, "NotificationManager is null, cannot create channel");
+                return;
+            }
+            
+            // Channel ID must match the one used in DailyNotificationWorker
+            String channelId = "timesafari.daily";
+            String channelName = "Daily Notifications";
+            String channelDescription = "Daily notification updates from TimeSafari";
+            
+            // Check if channel already exists
+            NotificationChannel existingChannel = notificationManager.getNotificationChannel(channelId);
+            if (existingChannel != null) {
+                Log.d(TAG, "Notification channel already exists: " + channelId);
+                return;
+            }
+            
+            // Create the channel with high importance (for priority="high" notifications)
+            NotificationChannel channel = new NotificationChannel(
+                channelId,
+                channelName,
+                NotificationManager.IMPORTANCE_HIGH
+            );
+            channel.setDescription(channelDescription);
+            channel.enableVibration(true);
+            channel.setShowBadge(true);
+            
+            notificationManager.createNotificationChannel(channel);
+            Log.i(TAG, "Notification channel created: " + channelId);
+        }
+    }
+}
+

android/app/src/main/java/app/timesafari/TimeSafariNativeFetcher.java

@@ -0,0 +1,605 @@
+/**
+ * TimeSafariNativeFetcher.java
+ * 
+ * Implementation of NativeNotificationContentFetcher for the TimeSafari app.
+ * Fetches notification content from the endorser API endpoint.
+ * 
+ * @author TimeSafari Team
+ * @version 1.0.0
+ */
+
+package app.timesafari;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.util.Log;
+import androidx.annotation.NonNull;
+import com.timesafari.dailynotification.FetchContext;
+import com.timesafari.dailynotification.NativeNotificationContentFetcher;
+import com.timesafari.dailynotification.NotificationContent;
+import com.google.gson.Gson;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonArray;
+import com.google.gson.JsonParser;
+import java.io.BufferedReader;
+import java.io.InputStreamReader;
+import java.io.OutputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
+import java.nio.charset.StandardCharsets;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.concurrent.CompletableFuture;
+
+/**
+ * Native content fetcher implementation for TimeSafari
+ * 
+ * Fetches notification content from the endorser API endpoint.
+ * Uses the same endpoint as the TypeScript code: /api/v2/report/plansLastUpdatedBetween
+ */
+public class TimeSafariNativeFetcher implements NativeNotificationContentFetcher {
+    
+    private static final String TAG = "TimeSafariNativeFetcher";
+    private static final String ENDORSER_ENDPOINT = "/api/v2/report/plansLastUpdatedBetween";
+    private static final int CONNECT_TIMEOUT_MS = 10000; // 10 seconds
+    private static final int READ_TIMEOUT_MS = 15000;    // 15 seconds
+    private static final int MAX_RETRIES = 3; // Maximum number of retry attempts
+    private static final int RETRY_DELAY_MS = 1000; // Base delay for exponential backoff
+    
+    // SharedPreferences constants
+    // NOTE: Must match plugin's SharedPreferences name and keys for starred plans
+    // Plugin uses "daily_notification_timesafari" (see DailyNotificationPlugin.updateStarredPlans)
+    private static final String PREFS_NAME = "daily_notification_timesafari";
+    private static final String KEY_STARRED_PLAN_IDS = "starredPlanIds";  // Matches plugin key
+    private static final String KEY_LAST_ACKED_JWT_ID = "last_acked_jwt_id";  // For pagination
+    
+    private final Gson gson = new Gson();
+    private final Context appContext;
+    private SharedPreferences prefs;
+    
+    // Volatile fields for configuration, set via configure() method
+    private volatile String apiBaseUrl;
+    private volatile String activeDid;
+    private volatile String jwtToken; // Pre-generated JWT token from TypeScript (ES256K signed)
+    
+    /**
+     * Constructor
+     * 
+     * @param context Application context for SharedPreferences access
+     */
+    public TimeSafariNativeFetcher(Context context) {
+        this.appContext = context.getApplicationContext();
+        this.prefs = appContext.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
+        Log.d(TAG, "TimeSafariNativeFetcher: Initialized with context");
+    }
+    
+    /**
+     * Configure the native fetcher with API credentials
+     * 
+     * Called by the plugin when configureNativeFetcher() is invoked from TypeScript.
+     * This method stores the configuration for use in background fetches.
+     * 
+     * <p><b>Architecture Note:</b> The JWT token is pre-generated in TypeScript using
+     * TimeSafari's {@code accessTokenForBackground()} function (ES256K DID-based signing).
+     * The native fetcher just uses the token directly - no JWT generation needed.</p>
+     * 
+     * @param apiBaseUrl Base URL for API server (e.g., "https://api.endorser.ch")
+     * @param activeDid Active DID for authentication (e.g., "did:ethr:0x...")
+     * @param jwtToken Pre-generated JWT token (ES256K signed) from TypeScript
+     */
+    @Override
+    public void configure(String apiBaseUrl, String activeDid, String jwtToken) {
+        // Instrumentation: Log configuration start
+        int pid = android.os.Process.myPid();
+        Log.i(TAG, String.format(
+            "FETCHER|CONFIGURE_START instanceHash=%d pid=%d ts=%d",
+            this.hashCode(),
+            pid,
+            System.currentTimeMillis()
+        ));
+        
+        this.apiBaseUrl = apiBaseUrl;
+        this.activeDid = activeDid;
+        this.jwtToken = jwtToken;
+        
+        // Instrumentation: Log configuration completion
+        boolean configured = (apiBaseUrl != null && activeDid != null && jwtToken != null);
+        Log.i(TAG, String.format(
+            "FETCHER|CONFIGURE_COMPLETE instanceHash=%d configured=%s apiBaseUrl=%s activeDid=%s jwtLength=%d ts=%d",
+            this.hashCode(),
+            configured,
+            apiBaseUrl != null ? apiBaseUrl : "null",
+            activeDid != null ? activeDid.substring(0, Math.min(30, activeDid.length())) + "..." : "null",
+            jwtToken != null ? jwtToken.length() : 0,
+            System.currentTimeMillis()
+        ));
+        
+        // Enhanced logging for JWT diagnostic purposes
+        Log.i(TAG, "TimeSafariNativeFetcher: Configured with API: " + apiBaseUrl);
+        if (activeDid != null) {
+            Log.i(TAG, "TimeSafariNativeFetcher: ActiveDID: " + activeDid.substring(0, Math.min(30, activeDid.length())) + 
+                       (activeDid.length() > 30 ? "..." : ""));
+        } else {
+            Log.w(TAG, "TimeSafariNativeFetcher: ActiveDID is NULL");
+        }
+        
+        if (jwtToken != null) {
+            Log.i(TAG, "TimeSafariNativeFetcher: JWT token received - Length: " + jwtToken.length() + " chars");
+            // Log first and last 10 chars for verification (not full token for security)
+            String tokenPreview = jwtToken.length() > 20 
+                ? jwtToken.substring(0, 10) + "..." + jwtToken.substring(jwtToken.length() - 10)
+                : jwtToken.substring(0, Math.min(jwtToken.length(), 20)) + "...";
+            Log.d(TAG, "TimeSafariNativeFetcher: JWT preview: " + tokenPreview);
+        } else {
+            Log.e(TAG, "TimeSafariNativeFetcher: JWT token is NULL - API calls will fail");
+        }
+    }
+    
+    @Override
+    @NonNull
+    public CompletableFuture<List<NotificationContent>> fetchContent(
+            @NonNull FetchContext context) {
+        
+        // Instrumentation: Log fetch start with context
+        int pid = android.os.Process.myPid();
+        Log.i(TAG, String.format(
+            "PREFETCH|START id=%s notifyAt=%d trigger=%s instanceHash=%d pid=%d ts=%d",
+            context.scheduledTime != null ? "daily_" + context.scheduledTime : "unknown",
+            context.scheduledTime != null ? context.scheduledTime : 0,
+            context.trigger,
+            this.hashCode(),
+            pid,
+            System.currentTimeMillis()
+        ));
+        
+        Log.d(TAG, "TimeSafariNativeFetcher: Fetch triggered - trigger=" + context.trigger +
+            ", scheduledTime=" + context.scheduledTime + ", fetchTime=" + context.fetchTime);
+        
+        // Start with retry count 0
+        return fetchContentWithRetry(context, 0);
+    }
+    
+    /**
+     * Fetch content with retry logic for transient errors
+     * 
+     * @param context Fetch context
+     * @param retryCount Current retry attempt (0 for first attempt)
+     * @return Future with notification contents or empty list on failure
+     */
+    private CompletableFuture<List<NotificationContent>> fetchContentWithRetry(
+            @NonNull FetchContext context, int retryCount) {
+        
+        return CompletableFuture.supplyAsync(() -> {
+            try {
+                // Check if configured
+                if (apiBaseUrl == null || activeDid == null || jwtToken == null) {
+                    Log.e(TAG, String.format(
+                        "PREFETCH|SOURCE from=fallback reason=not_configured apiBaseUrl=%s activeDid=%s jwtToken=%s ts=%d",
+                        apiBaseUrl != null ? "set" : "null",
+                        activeDid != null ? "set" : "null",
+                        jwtToken != null ? "set" : "null",
+                        System.currentTimeMillis()
+                    ));
+                    Log.e(TAG, "TimeSafariNativeFetcher: Not configured. Call configureNativeFetcher() from TypeScript first.");
+                    return Collections.emptyList();
+                }
+                
+                // Instrumentation: Log native fetcher usage
+                Log.i(TAG, String.format(
+                    "PREFETCH|SOURCE from=native instanceHash=%d apiBaseUrl=%s ts=%d",
+                    this.hashCode(),
+                    apiBaseUrl,
+                    System.currentTimeMillis()
+                ));
+                
+                Log.i(TAG, "TimeSafariNativeFetcher: Starting fetch from " + apiBaseUrl + ENDORSER_ENDPOINT);
+                
+                // Build request URL
+                String urlString = apiBaseUrl + ENDORSER_ENDPOINT;
+                URL url = new URL(urlString);
+                
+                // Create HTTP connection
+                HttpURLConnection connection = (HttpURLConnection) url.openConnection();
+                connection.setConnectTimeout(CONNECT_TIMEOUT_MS);
+                connection.setReadTimeout(READ_TIMEOUT_MS);
+                connection.setRequestMethod("POST");
+                connection.setRequestProperty("Content-Type", "application/json");
+                
+                // Diagnostic logging for JWT usage
+                if (jwtToken != null) {
+                    String jwtPreview = jwtToken.length() > 20 
+                        ? jwtToken.substring(0, 10) + "..." + jwtToken.substring(jwtToken.length() - 10)
+                        : jwtToken;
+                    Log.d(TAG, "TimeSafariNativeFetcher: Using JWT for API call - Length: " + jwtToken.length() + 
+                               ", Preview: " + jwtPreview + ", ActiveDID: " + 
+                               (activeDid != null ? activeDid.substring(0, Math.min(30, activeDid.length())) + "..." : "null"));
+                } else {
+                    Log.e(TAG, "TimeSafariNativeFetcher: JWT token is NULL when making API call!");
+                }
+                
+                connection.setRequestProperty("Authorization", "Bearer " + jwtToken);
+                connection.setDoOutput(true);
+                
+                // Build request body
+                Map<String, Object> requestBody = new HashMap<>();
+                requestBody.put("planIds", getStarredPlanIds());
+                
+                // afterId is required by the API endpoint
+                // Use "0" for first request (no previous data), or stored jwtId for subsequent requests
+                String afterId = getLastAcknowledgedJwtId();
+                if (afterId == null || afterId.isEmpty()) {
+                    afterId = "0"; // First request - start from beginning
+                }
+                requestBody.put("afterId", afterId);
+                
+                String jsonBody = gson.toJson(requestBody);
+                Log.d(TAG, "TimeSafariNativeFetcher: Request body: " + jsonBody);
+                
+                // Write request body
+                try (OutputStream os = connection.getOutputStream()) {
+                    byte[] input = jsonBody.getBytes(StandardCharsets.UTF_8);
+                    os.write(input, 0, input.length);
+                }
+                
+                // Execute request
+                int responseCode = connection.getResponseCode();
+                Log.d(TAG, "TimeSafariNativeFetcher: HTTP response code: " + responseCode);
+                
+                if (responseCode == 200) {
+                    // Read response
+                    BufferedReader reader = new BufferedReader(
+                        new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8));
+                    StringBuilder response = new StringBuilder();
+                    String line;
+                    while ((line = reader.readLine()) != null) {
+                        response.append(line);
+                    }
+                    reader.close();
+                    
+                    String responseBody = response.toString();
+                    Log.d(TAG, "TimeSafariNativeFetcher: Response body length: " + responseBody.length());
+                    
+                    // Parse response and convert to NotificationContent
+                    List<NotificationContent> contents = parseApiResponse(responseBody, context);
+                    
+                    // Update last acknowledged JWT ID from the response (for pagination)
+                    if (!contents.isEmpty()) {
+                        // Get the last JWT ID from the parsed response (stored during parsing)
+                        updateLastAckedJwtIdFromResponse(contents, responseBody);
+                    }
+                    
+                    Log.i(TAG, "TimeSafariNativeFetcher: Successfully fetched " + contents.size() + 
+                        " notification(s)");
+                    
+                    // Instrumentation: Log successful fetch
+                    Log.i(TAG, String.format(
+                        "PREFETCH|WRITE_OK id=%s items=%d ts=%d",
+                        context.scheduledTime != null ? "daily_" + context.scheduledTime : "unknown",
+                        contents.size(),
+                        System.currentTimeMillis()
+                    ));
+                    
+                    return contents;
+                    
+                } else {
+                    // Read error response
+                    String errorMessage = "Unknown error";
+                    try {
+                        BufferedReader reader = new BufferedReader(
+                            new InputStreamReader(connection.getErrorStream(), StandardCharsets.UTF_8));
+                        StringBuilder errorResponse = new StringBuilder();
+                        String line;
+                        while ((line = reader.readLine()) != null) {
+                            errorResponse.append(line);
+                        }
+                        reader.close();
+                        errorMessage = errorResponse.toString();
+                    } catch (Exception e) {
+                        Log.w(TAG, "TimeSafariNativeFetcher: Could not read error stream", e);
+                    }
+                    
+                    Log.e(TAG, "TimeSafariNativeFetcher: API error " + responseCode + ": " + errorMessage);
+                    
+                    // Handle retryable errors (5xx server errors, network timeouts)
+                    if (shouldRetry(responseCode, retryCount)) {
+                        long delayMs = RETRY_DELAY_MS * (1 << retryCount); // Exponential backoff
+                        Log.w(TAG, "TimeSafariNativeFetcher: Retryable error, retrying in " + delayMs + "ms " +
+                                  "(" + (retryCount + 1) + "/" + MAX_RETRIES + ")");
+                        
+                        try {
+                            Thread.sleep(delayMs);
+                        } catch (InterruptedException e) {
+                            Thread.currentThread().interrupt();
+                            Log.e(TAG, "TimeSafariNativeFetcher: Retry delay interrupted", e);
+                            return Collections.emptyList();
+                        }
+                        
+                        // Recursive retry
+                        return fetchContentWithRetry(context, retryCount + 1).join();
+                    }
+                    
+                    // Non-retryable errors (4xx client errors, max retries reached)
+                    if (responseCode >= 400 && responseCode < 500) {
+                        Log.e(TAG, "TimeSafariNativeFetcher: Non-retryable client error " + responseCode);
+                    } else if (retryCount >= MAX_RETRIES) {
+                        Log.e(TAG, "TimeSafariNativeFetcher: Max retries (" + MAX_RETRIES + ") reached");
+                    }
+                    
+                    // Return empty list on error (fallback will be handled by worker)
+                    return Collections.emptyList();
+                }
+                
+            } catch (java.net.SocketTimeoutException | java.net.UnknownHostException e) {
+                // Network errors are retryable
+                Log.w(TAG, "TimeSafariNativeFetcher: Network error during fetch", e);
+                
+                if (shouldRetry(0, retryCount)) { // Use 0 as response code for network errors
+                    long delayMs = RETRY_DELAY_MS * (1 << retryCount);
+                    Log.w(TAG, "TimeSafariNativeFetcher: Retrying after network error in " + delayMs + "ms " +
+                              "(" + (retryCount + 1) + "/" + MAX_RETRIES + ")");
+                    
+                    try {
+                        Thread.sleep(delayMs);
+                    } catch (InterruptedException ie) {
+                        Thread.currentThread().interrupt();
+                        Log.e(TAG, "TimeSafariNativeFetcher: Retry delay interrupted", ie);
+                        return Collections.emptyList();
+                    }
+                    
+                    return fetchContentWithRetry(context, retryCount + 1).join();
+                }
+                
+                Log.e(TAG, "TimeSafariNativeFetcher: Max retries reached for network error");
+                return Collections.emptyList();
+                
+            } catch (Exception e) {
+                Log.e(TAG, "TimeSafariNativeFetcher: Error during fetch", e);
+                // Non-retryable errors (parsing, configuration, etc.)
+                return Collections.emptyList();
+            }
+        });
+    }
+    
+    /**
+     * Determine if an error should be retried
+     * 
+     * @param responseCode HTTP response code (0 for network errors)
+     * @param retryCount Current retry attempt count
+     * @return true if error is retryable and retry count not exceeded
+     */
+    private boolean shouldRetry(int responseCode, int retryCount) {
+        if (retryCount >= MAX_RETRIES) {
+            return false; // Max retries exceeded
+        }
+        
+        // Retry on network errors (responseCode 0) or server errors (5xx)
+        // Don't retry on client errors (4xx) as they indicate permanent issues
+        if (responseCode == 0) {
+            return true; // Network error (timeout, unknown host, etc.)
+        }
+        
+        if (responseCode >= 500 && responseCode < 600) {
+            return true; // Server error (retryable)
+        }
+        
+        // Some 4xx errors might be retryable (e.g., 429 Too Many Requests)
+        if (responseCode == 429) {
+            return true; // Rate limit - retry with backoff
+        }
+        
+        return false; // Other client errors (401, 403, 404, etc.) are not retryable
+    }
+    
+    /**
+     * Get starred plan IDs from SharedPreferences
+     * 
+     * @return List of starred plan IDs, empty list if none stored
+     */
+    private List<String> getStarredPlanIds() {
+        try {
+            // Use the same SharedPreferences as the plugin (not the instance variable 'prefs')
+            // Plugin stores in "daily_notification_timesafari" with key "starredPlanIds"
+            SharedPreferences pluginPrefs = appContext.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
+            String idsJson = pluginPrefs.getString(KEY_STARRED_PLAN_IDS, "[]");
+            
+            if (idsJson == null || idsJson.isEmpty() || idsJson.equals("[]")) {
+                Log.d(TAG, "TimeSafariNativeFetcher: No starred plan IDs found in SharedPreferences");
+                return new ArrayList<>();
+            }
+            
+            // Parse JSON array (plugin stores as JSON string)
+            JsonParser parser = new JsonParser();
+            JsonArray jsonArray = parser.parse(idsJson).getAsJsonArray();
+            List<String> planIds = new ArrayList<>();
+            
+            for (int i = 0; i < jsonArray.size(); i++) {
+                planIds.add(jsonArray.get(i).getAsString());
+            }
+            
+            Log.i(TAG, "TimeSafariNativeFetcher: Loaded " + planIds.size() + " starred plan IDs from SharedPreferences");
+            if (planIds.size() > 0) {
+                Log.d(TAG, "TimeSafariNativeFetcher: First plan ID: " + 
+                      planIds.get(0).substring(0, Math.min(30, planIds.get(0).length())) + "...");
+            }
+            return planIds;
+            
+        } catch (Exception e) {
+            Log.e(TAG, "TimeSafariNativeFetcher: Error loading starred plan IDs from SharedPreferences", e);
+            return new ArrayList<>();
+        }
+    }
+    
+    /**
+     * Get last acknowledged JWT ID from SharedPreferences (for pagination)
+     * 
+     * @return Last acknowledged JWT ID, or null if none stored
+     */
+    private String getLastAcknowledgedJwtId() {
+        try {
+            String jwtId = prefs.getString(KEY_LAST_ACKED_JWT_ID, null);
+            if (jwtId != null) {
+                Log.d(TAG, "TimeSafariNativeFetcher: Loaded last acknowledged JWT ID");
+            }
+            return jwtId;
+        } catch (Exception e) {
+            Log.e(TAG, "TimeSafariNativeFetcher: Error loading last acknowledged JWT ID", e);
+            return null;
+        }
+    }
+    
+    /**
+     * Update last acknowledged JWT ID from the API response
+     * Uses the last JWT ID from the data array for pagination
+     * 
+     * @param contents Parsed notification contents (may contain JWT IDs)
+     * @param responseBody Original response body for parsing
+     */
+    private void updateLastAckedJwtIdFromResponse(List<NotificationContent> contents, String responseBody) {
+        try {
+            JsonParser parser = new JsonParser();
+            JsonObject root = parser.parse(responseBody).getAsJsonObject();
+            JsonArray dataArray = root.getAsJsonArray("data");
+            
+            if (dataArray != null && dataArray.size() > 0) {
+                // Get the last item's JWT ID (most recent)
+                JsonObject lastItem = dataArray.get(dataArray.size() - 1).getAsJsonObject();
+                
+                // Try to get JWT ID from different possible locations in response structure
+                String jwtId = null;
+                if (lastItem.has("jwtId")) {
+                    jwtId = lastItem.get("jwtId").getAsString();
+                } else if (lastItem.has("plan")) {
+                    JsonObject plan = lastItem.getAsJsonObject("plan");
+                    if (plan.has("jwtId")) {
+                        jwtId = plan.get("jwtId").getAsString();
+                    }
+                }
+                
+                if (jwtId != null && !jwtId.isEmpty()) {
+                    updateLastAckedJwtId(jwtId);
+                    Log.d(TAG, "TimeSafariNativeFetcher: Updated last acknowledged JWT ID: " + 
+                              jwtId.substring(0, Math.min(20, jwtId.length())) + "...");
+                }
+            }
+        } catch (Exception e) {
+            Log.w(TAG, "TimeSafariNativeFetcher: Could not extract JWT ID from response for pagination", e);
+        }
+    }
+    
+    /**
+     * Update last acknowledged JWT ID in SharedPreferences
+     * 
+     * @param jwtId JWT ID to store as last acknowledged
+     */
+    private void updateLastAckedJwtId(String jwtId) {
+        try {
+            prefs.edit().putString(KEY_LAST_ACKED_JWT_ID, jwtId).apply();
+            Log.d(TAG, "TimeSafariNativeFetcher: Updated last acknowledged JWT ID");
+        } catch (Exception e) {
+            Log.e(TAG, "TimeSafariNativeFetcher: Error updating last acknowledged JWT ID", e);
+        }
+    }
+    
+    /**
+     * Parse API response and convert to NotificationContent list
+     */
+    private List<NotificationContent> parseApiResponse(String responseBody, FetchContext context) {
+        List<NotificationContent> contents = new ArrayList<>();
+        
+        try {
+            JsonParser parser = new JsonParser();
+            JsonObject root = parser.parse(responseBody).getAsJsonObject();
+            
+            // Parse response structure (matches PlansLastUpdatedResponse)
+            JsonArray dataArray = root.getAsJsonArray("data");
+            if (dataArray != null) {
+                for (int i = 0; i < dataArray.size(); i++) {
+                    JsonObject item = dataArray.get(i).getAsJsonObject();
+                    
+                    NotificationContent content = new NotificationContent();
+                    
+                    // Extract data from API response
+                    // Support both flat structure (jwtId, planId) and nested (plan.jwtId, plan.handleId)
+                    String planId = null;
+                    String jwtId = null;
+                    
+                    if (item.has("planId")) {
+                        planId = item.get("planId").getAsString();
+                    } else if (item.has("plan")) {
+                        JsonObject plan = item.getAsJsonObject("plan");
+                        if (plan.has("handleId")) {
+                            planId = plan.get("handleId").getAsString();
+                        }
+                    }
+                    
+                    if (item.has("jwtId")) {
+                        jwtId = item.get("jwtId").getAsString();
+                    } else if (item.has("plan")) {
+                        JsonObject plan = item.getAsJsonObject("plan");
+                        if (plan.has("jwtId")) {
+                            jwtId = plan.get("jwtId").getAsString();
+                        }
+                    }
+                    
+                    // Create notification ID
+                    String notificationId = "endorser_" + (jwtId != null ? jwtId : 
+                        System.currentTimeMillis() + "_" + i);
+                    content.setId(notificationId);
+                    
+                    // Create notification title
+                    String title = "Project Update";
+                    if (planId != null) {
+                        title = "Update: " + planId.substring(Math.max(0, planId.length() - 8));
+                    }
+                    content.setTitle(title);
+                    
+                    // Create notification body
+                    StringBuilder body = new StringBuilder();
+                    if (planId != null) {
+                        body.append("Plan ").append(planId.substring(Math.max(0, planId.length() - 12))).append(" has been updated.");
+                    } else {
+                        body.append("A project you follow has been updated.");
+                    }
+                    content.setBody(body.toString());
+                    
+                    // Use scheduled time from context, or default to 1 hour from now
+                    long scheduledTimeMs = context.scheduledTime != null ?
+                        context.scheduledTime : (System.currentTimeMillis() + 3600000);
+                    content.setScheduledTime(scheduledTimeMs);
+                    
+                    // Set notification properties
+                    content.setPriority("default");
+                    content.setSound(true);
+                    
+                    contents.add(content);
+                }
+            }
+            
+            // If no data items, create a default notification
+            if (contents.isEmpty()) {
+                NotificationContent defaultContent = new NotificationContent();
+                defaultContent.setId("endorser_no_updates_" + System.currentTimeMillis());
+                defaultContent.setTitle("No Project Updates");
+                defaultContent.setBody("No updates found in your starred projects.");
+                
+                long scheduledTimeMs = context.scheduledTime != null ?
+                    context.scheduledTime : (System.currentTimeMillis() + 3600000);
+                defaultContent.setScheduledTime(scheduledTimeMs);
+                defaultContent.setPriority("default");
+                defaultContent.setSound(true);
+                
+                contents.add(defaultContent);
+            }
+            
+        } catch (Exception e) {
+            Log.e(TAG, "TimeSafariNativeFetcher: Error parsing API response", e);
+            // Return empty list on parse error
+        }
+        
+        return contents;
+    }
+}
+

android/capacitor.settings.gradle

@@ -28,3 +28,6 @@ project(':capacitor-status-bar').projectDir = new File('../node_modules/@capacit
 
 include ':capawesome-capacitor-file-picker'
 project(':capawesome-capacitor-file-picker').projectDir = new File('../node_modules/@capawesome/capacitor-file-picker/android')
+
+include ':timesafari-daily-notification-plugin'
+project(':timesafari-daily-notification-plugin').projectDir = new File('../node_modules/@timesafari/daily-notification-plugin/android')

doc/active-identity-upgrade-plan.md

@@ -1,390 +0,0 @@
-# Active Identity Upgrade Plan
-
-**Author**: Matthew Raymer  
-**Date**: 2025-09-11  
-**Status**: 🎯 **PLANNING** - Database migration and active identity system upgrade
-
-## Overview
-
-Comprehensive upgrade to the active identity system, addressing architectural issues and implementing enhanced database constraints. Includes database migration enhancements and settings table cleanup based on team feedback.
-
-## Implementation Status
-
-**✅ COMPLETED**: Migration structure updated according to team member feedback
-
-### Implemented Changes
-
-1. **✅ Migration 003**: `003_add_hasBackedUpSeed_to_settings` - Adds `hasBackedUpSeed` column to settings (assumes master deployment)
-2. **✅ Migration 004**: `004_active_identity_and_seed_backup` - Creates `active_identity` table with data migration
-3. **✅ Migration Service**: Updated validation and schema detection logic for new migration structure
-4. **✅ TypeScript**: Fixed type compatibility issues
-
-### Migration Structure Now Follows Team Guidance
-
-- **Migration 003**: `003_add_hasBackedUpSeed_to_settings` (assumes master code deployed)
-- **Migration 004**: `004_active_identity_and_seed_backup` (creates active_identity table)
-- **All migrations are additional** - no editing of previous migrations
-- **Data migration logic** preserves existing `activeDid` from settings
-- **iOS/Android compatibility** confirmed with SQLCipher 4.9.0 (SQLite 3.44.2)
-
-## Educational Context
-
-### Why This Upgrade Matters
-
-The active identity system is **critical infrastructure** affecting every user interaction:
-
-1. **Data Integrity**: Current `ON DELETE SET NULL` allows accidental deletion of active accounts
-2. **Manual Maintenance**: Timestamps require manual updates, creating inconsistency opportunities
-3. **Architectural Clarity**: Separating active identity from user settings improves maintainability
-
-### What This Upgrade Achieves
-
-- **Prevents Data Loss**: `ON DELETE RESTRICT` prevents accidental account deletion
-- **Automatic Consistency**: Database triggers ensure timestamps are always current
-- **Cleaner Architecture**: Complete separation of identity management from user preferences
-- **Better Performance**: Optimized indexes for faster account selection
-
-## Current State Analysis
-
-### Existing Migration Structure
-
-- **Migration 003**: `003_add_hasBackedUpSeed_to_settings` - Adds `hasBackedUpSeed` column to settings (already deployed in master)
-- **Migration 004**: `004_active_identity_and_seed_backup` - Creates `active_identity` table with data migration
-- **Foreign Key**: `ON DELETE SET NULL` constraint
-- **Data Migration**: Copies existing `activeDid` from settings to `active_identity` table
-- **Bootstrapping**: Auto-selects first account if `activeDid` is null/empty
-
-**Important**: All migrations are **additional** - no editing of previous migrations since master code has been deployed.
-
-### Current Schema (Migration 004) - IMPLEMENTED
-
-```sql
--- Migration 004: active_identity_and_seed_backup
--- Assumes master code deployed with migration 003
-
-PRAGMA foreign_keys = ON;
-CREATE UNIQUE INDEX IF NOT EXISTS idx_accounts_did_unique ON accounts(did);
-
-CREATE TABLE IF NOT EXISTS active_identity (
-  id INTEGER PRIMARY KEY CHECK (id = 1),
-  activeDid TEXT DEFAULT NULL,
-  lastUpdated TEXT NOT NULL DEFAULT (datetime('now')),
-  FOREIGN KEY (activeDid) REFERENCES accounts(did) ON DELETE SET NULL
-);
-
-CREATE UNIQUE INDEX IF NOT EXISTS idx_active_identity_single_record ON active_identity(id);
-
--- Seed singleton row
-INSERT INTO active_identity (id, activeDid, lastUpdated)
-SELECT 1, NULL, datetime('now')
-WHERE NOT EXISTS (SELECT 1 FROM active_identity WHERE id = 1);
-
--- MIGRATE EXISTING DATA: Copy activeDid from settings
-UPDATE active_identity
-SET activeDid = (SELECT activeDid FROM settings WHERE id = 1),
-    lastUpdated = datetime('now')
-WHERE id = 1
-AND EXISTS (SELECT 1 FROM settings WHERE id = 1 AND activeDid IS NOT NULL AND activeDid != '');
-```
-
-## Current Implementation Details
-
-### PlatformServiceMixin.ts Implementation
-
-The current `$getActiveIdentity()` method in `src/utils/PlatformServiceMixin.ts`:
-
-```typescript
-async $getActiveIdentity(): Promise<{ activeDid: string }> {
-  try {
-    const result = await this.$dbQuery("SELECT activeDid FROM active_identity WHERE id = 1");
-    
-    if (!result?.values?.length) {
-      logger.warn("[PlatformServiceMixin] Active identity table is empty - migration issue");
-      return { activeDid: "" };
-    }
-
-    const activeDid = result.values[0][0] as string | null;
-
-    // Handle null activeDid - auto-select first account
-    if (activeDid === null) {
-      const firstAccount = await this.$dbQuery("SELECT did FROM accounts ORDER BY dateCreated, did LIMIT 1");
-      if (firstAccount?.values?.length) {
-        const firstAccountDid = firstAccount.values[0][0] as string;
-        await this.$dbExec("UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1", [firstAccountDid]);
-        return { activeDid: firstAccountDid };
-      }
-      logger.warn("[PlatformServiceMixin] No accounts available for auto-selection");
-      return { activeDid: "" };
-    }
-
-    // Validate activeDid exists in accounts
-    const accountExists = await this.$dbQuery("SELECT did FROM accounts WHERE did = ?", [activeDid]);
-    if (accountExists?.values?.length) {
-      return { activeDid };
-    }
-
-    // Clear corrupted activeDid and return empty
-    logger.warn("[PlatformServiceMixin] Active identity not found in accounts, clearing");
-    await this.$dbExec("UPDATE active_identity SET activeDid = NULL, lastUpdated = datetime('now') WHERE id = 1");
-    return { activeDid: "" };
-  } catch (error) {
-    logger.error("[PlatformServiceMixin] Error getting active identity:", error);
-    return { activeDid: "" };
-  }
-}
-```
-
-### Key Implementation Notes
-
-1. **Null Handling**: Auto-selects first account when `activeDid` is null
-2. **Corruption Detection**: Clears invalid `activeDid` values
-3. **Manual Timestamps**: Updates `lastUpdated` manually in code
-4. **Error Handling**: Returns empty string on any error with appropriate logging
-
-## Proposed Changes Impact
-
-### 1. Foreign Key Constraint Change
-**Current**: `ON DELETE SET NULL` → **Proposed**: `ON DELETE RESTRICT`
-- **Data Safety**: Prevents accidental deletion of active account
-- **New Migration**: Add migration 005 to update constraint
-
-### 2. Automatic Timestamp Updates
-**Current**: Manual `lastUpdated` updates → **Proposed**: Database trigger
-- **Code Simplification**: Remove manual timestamp updates from `PlatformServiceMixin`
-- **Consistency**: Ensures `lastUpdated` is always current
-
-### 3. Enhanced Indexing
-**Current**: Single unique index on `id` → **Proposed**: Additional index on `accounts(dateCreated, did)`
-- **Performance Improvement**: Faster account selection queries
-- **Minimal Risk**: Additive change only
-
-## Implementation Strategy
-
-### Add Migration 005
-
-Since the `active_identity` table already exists and is working, we can add a new migration to enhance it:
-
-```sql
-{
-  name: "005_active_identity_enhancements",
-  sql: `
-    PRAGMA foreign_keys = ON;
-    
-    -- Recreate table with ON DELETE RESTRICT constraint
-    CREATE TABLE active_identity_new (
-      id INTEGER PRIMARY KEY CHECK (id = 1),
-      activeDid TEXT REFERENCES accounts(did) ON DELETE RESTRICT,
-      lastUpdated TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-    
-    -- Copy existing data
-    INSERT INTO active_identity_new (id, activeDid, lastUpdated)
-    SELECT id, activeDid, lastUpdated FROM active_identity;
-    
-    -- Replace old table
-    DROP TABLE active_identity;
-    ALTER TABLE active_identity_new RENAME TO active_identity;
-    
-    -- Add performance indexes
-    CREATE INDEX IF NOT EXISTS idx_accounts_pick ON accounts(dateCreated, did);
-    
-    -- Create automatic timestamp trigger
-    CREATE TRIGGER IF NOT EXISTS trg_active_identity_touch
-    AFTER UPDATE ON active_identity
-    FOR EACH ROW
-    BEGIN
-      UPDATE active_identity
-        SET lastUpdated = datetime('now')
-        WHERE id = 1;
-    END;
-  `
-}
-```
-
-## Migration Service Updates Required
-
-### Enhanced Validation Logic
-
-**File**: `src/services/migrationService.ts`
-
-**Migration 004 validation**:
-- **Table existence**: `SELECT name FROM sqlite_master WHERE type='table' AND name='active_identity'`
-- **Column structure**: `SELECT id, activeDid, lastUpdated FROM active_identity LIMIT 1`
-- **Schema detection**: Uses `isSchemaAlreadyPresent()` to check if migration was already applied
-
-**Migration 005 validation**:
-- **Trigger existence**: `trg_active_identity_touch`
-- **Performance index**: `idx_accounts_pick`
-- **Foreign key constraint**: `ON DELETE RESTRICT`
-- **Table recreation**: Verify table was successfully recreated
-
-### Enhanced Schema Detection
-
-**Migration 004 verification**:
-- **Table structure**: Checks `active_identity` table exists and has correct columns
-- **Data integrity**: Validates that the table can be queried successfully
-- **Migration tracking**: Uses `isSchemaAlreadyPresent()` to avoid re-applying migrations
-
-**Migration 005 verification**:
-- **Table structure**: Enhanced constraints with `ON DELETE RESTRICT`
-- **Trigger presence**: Automatic timestamp updates
-- **Index presence**: Performance optimization
-- **Data integrity**: Existing data was preserved during table recreation
-
-## Risk Assessment
-
-### Low Risk Changes
-- **Performance Index**: Additive only, no data changes
-- **Trigger Creation**: Additive only, improves consistency
-- **New Migration**: Clean implementation, no modification of existing migrations
-
-### Medium Risk Changes
-- **Foreign Key Change**: `ON DELETE RESTRICT` is more restrictive
-- **Table Recreation**: Requires careful data preservation
-- **Validation Updates**: Need to test enhanced validation logic
-
-### Mitigation Strategies
-1. **Comprehensive Testing**: Test migration on various database states
-2. **Data Preservation**: Verify existing data is copied correctly
-3. **Clean Implementation**: New migration with all enhancements
-4. **Validation Coverage**: Enhanced validation ensures correctness
-5. **Rollback Plan**: Can drop new table and restore original if needed
-
-## Implementation Timeline
-
-### Phase 1: Migration Enhancement
-- [ ] Add migration 005 with enhanced constraints
-- [ ] Add enhanced validation logic
-- [ ] Add enhanced schema detection logic
-- [ ] Test migration on clean database
-
-### Phase 2: Testing
-- [ ] Test migration on existing databases
-- [ ] Validate foreign key constraints work correctly
-- [ ] Test trigger functionality
-- [ ] Test performance improvements
-- [ ] Verify data preservation during table recreation
-
-### Phase 3: Deployment
-- [ ] Deploy enhanced migration to development
-- [ ] Monitor migration success rates
-- [ ] Deploy to production
-- [ ] Monitor for any issues
-
-### Phase 4: Settings Table Cleanup
-- [ ] Create migration 006 to clean up settings table
-- [ ] Remove orphaned settings records (accountDid is null)
-- [ ] Clear any remaining activeDid values in settings
-- [ ] Consider removing activeDid column entirely (future task)
-
-## Settings Table Cleanup Strategy
-
-### Current State Analysis
-The settings table currently contains:
-- **Legacy activeDid column**: Still present from original design
-- **Orphaned records**: Settings with `accountDid = null` that may be obsolete
-- **Redundant data**: Some settings may have been copied unnecessarily
-
-Based on team feedback, the cleanup should include:
-
-1. **Remove orphaned settings records**:
-   ```sql
-   DELETE FROM settings WHERE accountDid IS NULL;
-   ```
-
-2. **Clear any remaining activeDid values**:
-   ```sql
-   UPDATE settings SET activeDid = NULL;
-   ```
-
-3. **Future consideration**: Remove the activeDid column entirely from settings table
-
-### Migration 006: Settings Cleanup
-
-```sql
-{
-  name: "006_settings_cleanup",
-  sql: `
-    -- Remove orphaned settings records (accountDid is null)
-    DELETE FROM settings WHERE accountDid IS NULL;
-    
-    -- Clear any remaining activeDid values in settings
-    UPDATE settings SET activeDid = NULL;
-    
-    -- Optional: Consider removing the activeDid column entirely
-    -- ALTER TABLE settings DROP COLUMN activeDid;
-  `
-}
-```
-
-### Benefits of Settings Cleanup
-- **Reduced confusion**: Eliminates dual-purpose columns
-- **Cleaner architecture**: Settings table focuses only on user preferences
-- **Reduced storage**: Removes unnecessary data
-- **Clearer separation**: Active identity vs. user settings are distinct concerns
-
-### Risk Assessment: LOW
-- **Data safety**: Only removes orphaned/obsolete records
-- **Backward compatibility**: Maintains existing column structure
-- **Rollback**: Easy to restore if needed
-- **Testing**: Can be validated with existing data
-
-## Code Changes Required
-
-### Files to Modify
-1. **`src/db-sql/migration.ts`** - Add migration 005 with enhanced constraints
-2. **`src/db-sql/migration.ts`** - Add migration 006 for settings cleanup
-3. **`src/services/migrationService.ts`** - Add enhanced validation and detection logic
-4. **`src/utils/PlatformServiceMixin.ts`** - Remove manual timestamp updates
-
-### Estimated Impact
-- **Migration File**: ~25 lines added (migration 005) + ~15 lines added (migration 006)
-- **Migration Service**: ~50 lines added (enhanced validation)
-- **PlatformServiceMixin**: ~20 lines removed (manual timestamps)
-- **Total**: ~90 lines changed
-
-## Conclusion
-
-**✅ IMPLEMENTATION COMPLETE**: The active identity upgrade plan has been successfully applied to the current project.
-
-### Successfully Implemented
-
-**✅ Migration Structure Updated**:
-- **Migration 003**: `003_add_hasBackedUpSeed_to_settings` (assumes master deployment)
-- **Migration 004**: `004_active_identity_and_seed_backup` (creates active_identity table)
-- **All migrations are additional** - follows team member feedback exactly
-
-**✅ Technical Implementation**:
-- **Data Migration**: Preserves existing `activeDid` from settings table
-- **Foreign Key Constraints**: `ON DELETE SET NULL` for data safety
-- **iOS/Android Compatibility**: Confirmed with SQLCipher 4.9.0 (SQLite 3.44.2)
-- **Migration Service**: Updated validation and schema detection logic
-
-**✅ Code Quality**:
-- **TypeScript**: All type errors resolved
-- **Linting**: No linting errors
-- **Team Guidance**: Follows "additional migrations only" requirement
-
-### Next Steps (Future Enhancements)
-
-The foundation is now in place for future enhancements:
-
-1. **Migration 005**: `005_active_identity_enhancements` (ON DELETE RESTRICT, triggers, indexes)
-2. **Migration 006**: `006_settings_cleanup` (remove orphaned settings, clear legacy activeDid)
-3. **Code Simplification**: Remove manual timestamp updates from PlatformServiceMixin
-
-### Current Status
-
-**Migration 004 is ready for deployment** and will:
-- ✅ Create `active_identity` table with proper constraints
-- ✅ Migrate existing `activeDid` data from settings
-- ✅ Work identically on iOS and Android
-- ✅ Follow team member feedback for additional migrations only
-
-**Key Point**: All migrations are **additional** - no editing of previous migrations since master code has been deployed. This ensures compatibility and proper testing.
-
----
-
-**Status**: Ready for team review and implementation approval  
-**Last Updated**: 2025-09-11  
-**Next Review**: After team feedback and approval

doc/active-pointer-smart-deletion-pattern.md

@@ -1,392 +0,0 @@
-# Engineering Directive v2 — Active Pointer + Smart Deletion Pattern (hardened)
-
-**Author**: Matthew Raymer  
-**Date**: 2025-01-27  
-**Status**: 🎯 **ACTIVE** - Production-grade engineering directive for implementing smart deletion patterns
-
-## Overview
-
-This supersedes the previous draft and is **copy-pasteable** for any `<model>`. It keeps UX smooth, guarantees data integrity, and adds production-grade safeguards (bootstrapping, races, soft deletes, bulk ops, and testability). Built on your prior pattern.
-
-## 0) Objectives (non-negotiable)
-
-1. Exactly **one active `<model>`** pointer (or `NULL` during first-run).
-2. **Block deletion** when it would leave **zero** `<models>`.
-3. If deleting the **active** item, **atomically re-point** to a deterministic **next** item **before** delete.
-4. Enforce with **app logic** + **FK `RESTRICT`** (and `ON UPDATE CASCADE` if `ref` can change).
-
----
-
-## 1) Schema / Migration (SQLite)
-
-```sql
--- <timestamp>__active_<model>.sql
-PRAGMA foreign_keys = ON;
-
--- Stable external key on <models> (e.g., did/slug/uuid)
--- ALTER TABLE <models> ADD COLUMN ref TEXT UNIQUE NOT NULL; -- if missing
-
-CREATE TABLE IF NOT EXISTS active_<model> (
-  id INTEGER PRIMARY KEY CHECK (id = 1),
-  activeRef TEXT UNIQUE, -- allow NULL on first run
-  lastUpdated TEXT NOT NULL DEFAULT (datetime('now')),
-  FOREIGN KEY (activeRef) REFERENCES <models>(ref)
-    ON UPDATE CASCADE
-    ON DELETE RESTRICT
-);
-
--- Seed singleton row (idempotent)
-INSERT INTO active_<model> (id, activeRef)
-SELECT 1, NULL
-WHERE NOT EXISTS (SELECT 1 FROM active_<model> WHERE id = 1);
-```
-
-**Rules**
-
-* **Never** default `activeRef` to `''`—use `NULL` for "no selection yet".
-* Ensure `PRAGMA foreign_keys = ON` for **every connection**.
-
----
-
-## 2) Data Access API (TypeScript)
-
-```ts
-// Required DAL
-async function getAllRefs(): Promise<string[]> { /* SELECT ref FROM <models> ORDER BY created_at, ref */ }
-async function getRefById(id: number): Promise<string> { /* SELECT ref FROM <models> WHERE id=? */ }
-async function getActiveRef(): Promise<string|null> { /* SELECT activeRef FROM active_<model> WHERE id=1 */ }
-async function setActiveRef(ref: string|null): Promise<void> { /* UPDATE active_<model> SET activeRef=?, lastUpdated=datetime('now') WHERE id=1 */ }
-async function deleteById(id: number): Promise<void> { /* DELETE FROM <models> WHERE id=? */ }
-async function countModels(): Promise<number> { /* SELECT COUNT(*) FROM <models> */ }
-
-// Deterministic "next"
-function pickNextRef(all: string[], current?: string): string {
-  const sorted = [...all].sort();
-  if (!current) return sorted[0];
-  const i = sorted.indexOf(current);
-  return sorted[(i + 1) % sorted.length];
-}
-```
-
----
-
-## 3) Smart Delete (Atomic, Race-safe)
-
-```ts
-async function smartDeleteModelById(id: number, notify: (m: string) => void) {
-  await db.transaction(async trx => {
-    const total = await countModels();
-    if (total <= 1) {
-      notify("Cannot delete the last item. Keep at least one.");
-      throw new Error("blocked:last-item");
-    }
-
-    const refToDelete = await getRefById(id);
-    const activeRef   = await getActiveRef();
-
-    if (activeRef === refToDelete) {
-      const all = (await getAllRefs()).filter(r => r !== refToDelete);
-      const next = pickNextRef(all, refToDelete);
-      await setActiveRef(next);
-      notify(`Switched active to ${next} before deletion.`);
-    }
-
-    await deleteById(id); // RESTRICT prevents orphaning if we forgot to switch
-  });
-
-  // Post-tx: emit events / refresh UI
-}
-```
-
----
-
-## 4) Bootstrapping & Repair
-
-```ts
-async function ensureActiveSelected() {
-  const active = await getActiveRef();
-  const all = await getAllRefs();
-  if (active === null && all.length > 0) {
-    await setActiveRef(pickNextRef(all)); // first stable choice
-  }
-}
-```
-
-Invoke after migrations and after bulk imports.
-
----
-
-## 5) Concurrency & Crash Safety
-
-* **Always** wrap "switch → delete" inside a **single transaction**.
-* Treat any FK violation as a **logic regression**; surface telemetry (`fk:restrict`).
-
----
-
-## 6) Soft Deletes (if applicable)
-
-If `<models>` uses `deleted_at`:
-
-* Replace `DELETE` with `UPDATE <models> SET deleted_at = datetime('now') WHERE id=?`.
-* Add a **partial uniqueness** strategy for `ref`:
-
-  * SQLite workaround: make `ref` unique globally and never reuse; or maintain a shadow `refs` ledger to prevent reuse.
-* Adjust `getAllRefs()` to filter `WHERE deleted_at IS NULL`.
-
----
-
-## 7) Bulk Ops & Imports
-
-* For batch deletes:
-
-  1. Compute survivors.
-  2. If a batch would remove **all** survivors → **refuse**.
-  3. If the **active** is included, precompute a deterministic **new active** and set it **once** before deleting.
-* After imports, run `ensureActiveSelected()`.
-
----
-
-## 8) Multi-Scope Actives (optional)
-
-To support **one active per workspace/tenant**:
-
-* Replace singleton with scoped pointer:
-
-  ```sql
-  CREATE TABLE active_<model> (
-    scope TEXT NOT NULL,        -- e.g., workspace_id
-    activeRef TEXT,
-    lastUpdated TEXT NOT NULL DEFAULT (datetime('now')),
-    PRIMARY KEY (scope),
-    FOREIGN KEY (activeRef) REFERENCES <models>(ref) ON UPDATE CASCADE ON DELETE RESTRICT
-  );
-  ```
-* All APIs gain `scope` parameter; transactions remain unchanged in spirit.
-
----
-
-## 9) UX Contract
-
-* Delete confirmation must state:
-
-  * Deleting the **active** item will **auto-switch**.
-  * Deleting the **last** item is **not allowed**.
-* Keep list ordering aligned with `pickNextRef` strategy for predictability.
-
----
-
-## 10) Observability
-
-* Log categories:
-
-  * `blocked:last-item`
-  * `fk:restrict`
-  * `repair:auto-selected-active`
-  * `active:switch:pre-delete`
-* Emit metrics counters; attach `<model>` and (if used) `scope`.
-
----
-
-## 11) Test Matrix (must pass)
-
-1. **Non-active delete** (≥2): deleted; active unchanged.
-2. **Active delete** (≥2): active switches deterministically, then delete succeeds.
-3. **Last item delete** (==1): blocked with message.
-4. **First-run**: 0 items → `activeRef` stays `NULL`; add first → `ensureActiveSelected()` selects it.
-5. **Ref update** (if allowed): `activeRef` follows via `ON UPDATE CASCADE`.
-6. **Soft delete** mode: filters respected; invariants preserved.
-7. **Bulk delete** that includes active but not all: pre-switch then delete set.
-8. **Foreign keys disabled** (fault injection): tests must fail to surface missing PRAGMA.
-
----
-
-## 12) Rollout & Rollback
-
-* **Feature-flag** the new deletion path.
-* Migrations are **idempotent**; ship `ensureActiveSelected()` with them.
-* Keep a pre-migration backup for `<models>` on first rollout.
-* Rollback leaves `active_<model>` table harmlessly present.
-
----
-
-## 13) Replace-Me Cheatsheet
-
-* `<model>` → singular (e.g., `project`)
-* `<models>` → plural table (e.g., `projects`)
-* `ref` → stable external key (`did` | `slug` | `uuid`)
-
----
-
-**Outcome:** You get **predictable UX**, **atomic state changes**, and **hard integrity guarantees** across single- or multi-scope actives, with clear tests and telemetry to keep it honest.
-
----
-
-## TimeSafari Implementation Guide
-
-### Current State Analysis (2025-01-27)
-
-**Status**: ✅ **FULLY COMPLIANT** - Active Pointer + Smart Deletion Pattern implementation complete.
-
-**Compliance Score**: 100% (6/6 components compliant)
-
-#### ✅ **What's Working**
-- **Smart Deletion Logic**: `IdentitySwitcherView.vue` implements atomic transaction-safe deletion
-- **Data Access API**: All required DAL methods exist in `PlatformServiceMixin.ts`
-- **Schema Structure**: `active_identity` table follows singleton pattern correctly
-- **Bootstrapping**: `$ensureActiveSelected()` method implemented
-- **Foreign Key Constraint**: ✅ **FIXED** - Now uses `ON DELETE RESTRICT` (Migration 005)
-- **Settings Cleanup**: ✅ **COMPLETED** - Orphaned records removed (Migration 006)
-
-#### ✅ **All Issues Resolved**
-- ✅ Foreign key constraint fixed to `ON DELETE RESTRICT`
-- ✅ Settings table cleaned up (orphaned records removed)
-
-### Updated Implementation Plan
-
-**Note**: Smart deletion logic is already implemented correctly. Focus on fixing security issues and cleanup.
-
-#### 1) Critical Security Fix (Migration 005)
-
-**Fix Foreign Key Constraint:**
-```sql
--- Migration 005: Fix foreign key constraint to ON DELETE RESTRICT
-{
-  name: "005_active_identity_constraint_fix",
-  sql: `
-    PRAGMA foreign_keys = ON;
-    
-    -- Recreate table with ON DELETE RESTRICT constraint (SECURITY FIX)
-    CREATE TABLE active_identity_new (
-      id INTEGER PRIMARY KEY CHECK (id = 1),
-      activeDid TEXT REFERENCES accounts(did) ON DELETE RESTRICT,
-      lastUpdated TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-    
-    -- Copy existing data
-    INSERT INTO active_identity_new (id, activeDid, lastUpdated)
-    SELECT id, activeDid, lastUpdated FROM active_identity;
-    
-    -- Replace old table
-    DROP TABLE active_identity;
-    ALTER TABLE active_identity_new RENAME TO active_identity;
-    
-    -- Recreate indexes
-    CREATE UNIQUE INDEX IF NOT EXISTS idx_active_identity_single_record ON active_identity(id);
-  `
-}
-```
-
-### Updated Implementation Plan
-
-**Note**: Smart deletion logic is already implemented correctly. Migration 005 (security fix) completed successfully.
-
-#### ✅ **Phase 1: Critical Security Fix (COMPLETED)**
-- **Migration 005**: ✅ **COMPLETED** - Fixed foreign key constraint to `ON DELETE RESTRICT`
-- **Impact**: Prevents accidental account deletion
-- **Status**: ✅ **Successfully applied and tested**
-
-#### **Phase 2: Settings Cleanup (CURRENT)**
-- **Migration 006**: Remove orphaned settings records
-- **Impact**: Cleaner architecture, reduced confusion
-- **Risk**: LOW - Only removes obsolete data
-
-#### 3) Optional Future Enhancement (Migration 007)
-
-**Remove Legacy activeDid Column:**
-```sql
--- Migration 007: Remove activeDid column entirely (future task)
-{
-  name: "007_remove_activeDid_column",
-  sql: `
-    -- Remove the legacy activeDid column from settings table
-    ALTER TABLE settings DROP COLUMN activeDid;
-  `
-}
-```
-
-### Current Implementation Status
-
-#### ✅ **Already Implemented Correctly**
-- **Smart Deletion Logic**: `IdentitySwitcherView.vue` lines 285-315
-- **Data Access API**: All methods exist in `PlatformServiceMixin.ts`
-- **Transaction Safety**: Uses `$withTransaction()` for atomicity
-- **Last Account Protection**: Blocks deletion when `total <= 1`
-- **Deterministic Selection**: `$pickNextAccountDid()` method
-- **Bootstrapping**: `$ensureActiveSelected()` method
-
-#### ❌ **Requires Immediate Fix**
-1. **Foreign Key Constraint**: Change from `ON DELETE SET NULL` to `ON DELETE RESTRICT`
-2. **Settings Cleanup**: Remove orphaned records with `accountDid=null`
-
-### Implementation Priority
-
-#### **Phase 1: Critical Security Fix (IMMEDIATE)**
-- **Migration 005**: Fix foreign key constraint to `ON DELETE RESTRICT`
-- **Impact**: Prevents accidental account deletion
-- **Risk**: HIGH - Current implementation allows data loss
-
-#### **Phase 2: Settings Cleanup (HIGH PRIORITY)**
-- **Migration 006**: Remove orphaned settings records
-- **Impact**: Cleaner architecture, reduced confusion
-- **Risk**: LOW - Only removes obsolete data
-
-#### **Phase 3: Future Enhancement (OPTIONAL)**
-- **Migration 007**: Remove `activeDid` column from settings
-- **Impact**: Complete separation of concerns
-- **Risk**: LOW - Architectural cleanup
-
-#### **Phase 2: Settings Cleanup Implementation (Migration 006)**
-
-**Remove Orphaned Records:**
-```sql
--- Migration 006: Settings cleanup
-{
-  name: "006_settings_cleanup",
-  sql: `
-    -- Remove orphaned settings records (accountDid is null)
-    DELETE FROM settings WHERE accountDid IS NULL;
-    
-    -- Clear any remaining activeDid values in settings
-    UPDATE settings SET activeDid = NULL;
-  `
-}
-```
-
-### Updated Compliance Assessment
-
-#### **Current Status**: ✅ **FULLY COMPLIANT** (100%)
-
-| Component | Status | Compliance |
-|-----------|--------|------------|
-| Smart Deletion Logic | ✅ Complete | 100% |
-| Data Access API | ✅ Complete | 100% |
-| Schema Structure | ✅ Complete | 100% |
-| Foreign Key Constraint | ✅ Fixed (`RESTRICT`) | 100% |
-| Settings Cleanup | ✅ Completed | 100% |
-| **Overall** | ✅ **Complete** | **100%** |
-
-### Implementation Benefits
-
-**Current implementation already provides:**
-- ✅ **Atomic Operations**: Transaction-safe account deletion
-- ✅ **Last Account Protection**: Prevents deletion of final account
-- ✅ **Smart Switching**: Auto-switches active account before deletion
-- ✅ **Deterministic Behavior**: Predictable "next account" selection
-- ✅ **NULL Handling**: Proper empty state management
-
-**After fixes will add:**
-- ✅ **Data Integrity**: Foreign key constraints prevent orphaned references
-- ✅ **Clean Architecture**: Complete separation of identity vs. settings
-- ✅ **Production Safety**: No accidental account deletion possible
-
-### Implementation Complete
-
-✅ **All Required Steps Completed:**
-1. ✅ **Migration 005**: Foreign key constraint fixed to `ON DELETE RESTRICT`
-2. ✅ **Migration 006**: Settings cleanup completed (orphaned records removed)
-3. ✅ **Testing**: All migrations executed successfully with no performance delays
-
-**Optional Future Enhancement:**
-- **Migration 007**: Remove `activeDid` column from settings table (architectural cleanup)
-
-The Active Pointer + Smart Deletion Pattern is now **fully implemented** with **100% compliance**.

doc/activeDid-migration-plan.md

@@ -1,559 +0,0 @@
-# ActiveDid Migration Plan - Implementation Guide
-
-**Author**: Matthew Raymer
-**Date**: 2025-09-03T06:40:54Z
-**Status**: 🚀 **ACTIVE MIGRATION** - API Layer Complete, Component Updates Complete ✅
-
-## Objective
-
-Move the `activeDid` field from the `settings` table to a dedicated `active_identity` table to improve database architecture, prevent data corruption, and separate identity selection from user preferences.
-
-## Result
-
-This document provides the specific implementation steps required to complete the ActiveDid migration with all necessary code changes.
-
-## Use/Run
-
-Follow this implementation checklist step-by-step to complete the migration.
-
-## Context & Scope
-
-- **In scope**: Database migration, API updates, component updates, testing
-- **Out of scope**: UI changes, authentication flow changes, MASTER_SETTINGS_KEY elimination (future improvement)
-
-## Critical Vue Reactivity Bug Discovery
-
-### Issue
-During testing of the ActiveDid migration, a critical Vue reactivity bug was discovered:
-
-**Problem**: The `newDirectOffersActivityNumber` element in HomeView.vue fails to render correctly without a watcher on `numNewOffersToUser`.
-
-**Symptoms**: 
-- Element not found in DOM even when `numNewOffersToUser` has correct value
-- Test failures with "element not found" errors
-- Inconsistent rendering behavior
-
-**Root Cause**: Unknown Vue reactivity issue where property changes don't trigger proper template updates
-
-**Workaround**: A watcher on `numNewOffersToUser` with debug logging is required:
-```typescript
-@Watch("numNewOffersToUser")
-onNumNewOffersToUserChange(newValue: number, oldValue: number) {
-  logger.debug("[HomeView] numNewOffersToUser changed", {
-    oldValue,
-    newValue,
-    willRender: !!newValue,
-    timestamp: new Date().toISOString()
-  });
-}
-```
-
-**Impact**: This watcher must remain in the codebase until the underlying Vue reactivity issue is resolved.
-
-**Files Affected**: `src/views/HomeView.vue`
-
-### Investigation Needed
-- [ ] Investigate why Vue reactivity is not working correctly
-- [ ] Check for race conditions in component lifecycle
-- [ ] Verify if this affects other components
-- [ ] Consider Vue version upgrade or configuration changes
-
-## Implementation Checklist
-
-### Phase 1: Database Migration ✅ COMPLETE
-- [x] Add migration to MIGRATIONS array in `src/db-sql/migration.ts`
-- [x] Create active_identity table with constraints
-- [x] Include data migration from settings to active_identity table
-
-**Status**: All migrations executed successfully. active_identity table created and populated with data.
-
-### Phase 2: API Layer Updates ✅ COMPLETE
-- [x] Implement `$getActiveIdentity()` method (exists with correct return type)
-- [x] Fix `$getActiveIdentity()` return type to match documented interface
-- [x] Update `$accountSettings()` to use new method (minimal safe change)
-- [x] Update `$updateActiveDid()` with dual-write pattern
-- [x] Add strategic logging for migration verification
-
-**Status**: All API layer updates complete and verified working. Methods return correct data format and maintain backward compatibility.
-
-### Phase 3: Component Updates ✅ COMPLETE
-- [x] Update HomeView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update OfferDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update PhotoDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update GiftedDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update MembersList.vue to use `$getActiveIdentity()` (completed)
-- [x] Update OnboardingDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ImageMethodDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update DIDView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update TestView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactAmountsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update UserProfileView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ClaimView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update OfferDetailsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update QuickActionBvcEndView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update SharedPhotoView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ClaimReportCertificateView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ProjectsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ClaimAddRawView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactQRScanShowView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update InviteOneAcceptView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update RecentOffersToUserView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update NewEditProjectView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update GiftedDetailsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update IdentitySwitcherView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactQRScanFullView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update NewActivityView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactImportView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ProjectViewView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ClaimCertificateView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactGiftingView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ConfirmGiftView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update RecentOffersToUserProjectsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update InviteOneView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update AccountViewView.vue to use `$getActiveIdentity()` (completed)
-- [x] All component migrations complete! ✅
-- [ ] Replace `this.activeDid = settings.activeDid` pattern
-- [ ] Test each component individually
-
-**Status**: 23 components successfully migrated. 11 components remaining. API layer ready for systematic updates.
-
-### Phase 4: Testing 🟡 PARTIALLY STARTED
-
-- [x] Test Web platform (verified working)
-- [ ] Test Electron platform
-- [ ] Test iOS platform  
-- [ ] Test Android platform
-- [ ] Test migration rollback scenarios
-- [ ] Test data corruption recovery
-
-## Required Code Changes
-
-### 1. Database Migration ✅ COMPLETE
-
-```typescript
-// Already added to MIGRATIONS array in src/db-sql/migration.ts
-{
-  name: "003_active_did_separate_table",
-  sql: `
-    -- Create new active_identity table with proper constraints
-    CREATE TABLE IF NOT EXISTS active_identity (
-      id INTEGER PRIMARY KEY CHECK (id = 1),
-      activeDid TEXT NOT NULL,
-      lastUpdated TEXT NOT NULL DEFAULT (datetime('now')),
-      FOREIGN KEY (activeDid) REFERENCES accounts(did) ON DELETE CASCADE
-    );
-
-    -- Add performance indexes
-    CREATE INDEX IF NOT EXISTS idx_active_identity_activeDid ON active_identity(activeDid);
-    CREATE UNIQUE INDEX IF NOT EXISTS idx_active_identity_single_record ON active_identity(id);
-
-    -- Insert default record (will be updated during migration)
-    INSERT OR IGNORE INTO active_identity (id, activeDid, lastUpdated) VALUES (1, '', datetime('now'));
-
-    -- MIGRATE EXISTING DATA: Copy activeDid from settings to active_identity
-    -- This prevents data loss when migration runs on existing databases
-    UPDATE active_identity 
-    SET activeDid = (SELECT activeDid FROM settings WHERE id = 1), 
-        lastUpdated = datetime('now')
-    WHERE id = 1 
-    AND EXISTS (SELECT 1 FROM settings WHERE id = 1 AND activeDid IS NOT NULL AND activeDid != '');
-  `,
-},
-```
-
-### 2. $getActiveIdentity() Method ✅ EXISTS
-
-```typescript
-// Already exists in PlatformServiceMixin.ts with correct return type
-async $getActiveIdentity(): Promise<{ activeDid: string }> {
-  try {
-    const result = await this.$dbQuery(
-      "SELECT activeDid FROM active_identity WHERE id = 1"
-    );
-    
-    if (result?.values?.length) {
-      const activeDid = result.values[0][0] as string;
-      
-      // Validate activeDid exists in accounts
-      if (activeDid) {
-        const accountExists = await this.$dbQuery(
-          "SELECT did FROM accounts WHERE did = ?",
-          [activeDid]
-        );
-        
-        if (accountExists?.values?.length) {
-          return { activeDid };
-        } else {
-          // Clear corrupted activeDid
-          await this.$dbExec(
-            "UPDATE active_identity SET activeDid = '', lastUpdated = datetime('now') WHERE id = 1"
-          );
-          return { activeDid: "" };
-        }
-      }
-    }
-    
-    return { activeDid: "" };
-  } catch (error) {
-    logger.error("[PlatformServiceMixin] Error getting active identity:", error);
-    return { activeDid: "" };
-  }
-}
-```
-
-### 3. Update $accountSettings Method
-
-```typescript
-// Update in PlatformServiceMixin.ts
-async $accountSettings(did?: string, defaults: Settings = {}): Promise<Settings> {
-  try {
-    // Get settings without activeDid (unchanged logic)
-    const settings = await this.$getMasterSettings(defaults);
-
-    if (!settings) {
-      return defaults;
-    }
-
-    // Get activeDid from new table (new logic)
-    const activeIdentity = await this.$getActiveIdentity();
-
-    // Return combined result (maintains backward compatibility)
-    return { ...settings, activeDid: activeIdentity.activeDid };
-  } catch (error) {
-    logger.error("[Settings Trace] ❌ Error in $accountSettings:", error);
-    return defaults;
-  }
-}
-```
-
-### 4. Update $updateActiveDid Method
-
-```typescript
-// Update in PlatformServiceMixin.ts
-async $updateActiveDid(newDid: string | null): Promise<boolean> {
-  try {
-    if (newDid === null) {
-      // Clear active identity in both tables
-      await this.$dbExec(
-        "UPDATE active_identity SET activeDid = '', lastUpdated = datetime('now') WHERE id = 1"
-      );
-      
-      // Keep legacy field in sync (backward compatibility)
-      await this.$dbExec(
-        "UPDATE settings SET activeDid = '' WHERE id = ?",
-        [MASTER_SETTINGS_KEY]
-      );
-    } else {
-      // Validate DID exists before setting
-      const accountExists = await this.$dbQuery(
-        "SELECT did FROM accounts WHERE did = ?",
-        [newDid]
-      );
-
-      if (!accountExists?.values?.length) {
-        logger.error(`[PlatformServiceMixin] Cannot set activeDid to non-existent DID: ${newDid}`);
-        return false;
-      }
-
-      // Update active identity in new table
-      await this.$dbExec(
-        "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
-        [newDid]
-      );
-      
-      // Keep legacy field in sync (backward compatibility)
-      await this.$dbExec(
-        "UPDATE settings SET activeDid = ? WHERE id = ?",
-        [newDid, MASTER_SETTINGS_KEY]
-      );
-    }
-
-    // Update internal tracking
-    await this._updateInternalActiveDid(newDid);
-    return true;
-  } catch (error) {
-    logger.error("[PlatformServiceMixin] Error updating activeDid:", error);
-    return false;
-  }
-}
-```
-
-### 5. Component Updates Required
-
-**35 components need this pattern change:**
-
-```typescript
-// CURRENT PATTERN (replace in all components):
-this.activeDid = settings.activeDid || "";
-
-// NEW PATTERN (use in all components):
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-const activeIdentity = await (this as any).$getActiveIdentity();
-this.activeDid = activeIdentity.activeDid || "";
-```
-
-**Components requiring updates:**
-
-#### Views (28 components)
-- `src/views/DIDView.vue` (line 378)
-- `src/views/TestView.vue` (line 654)
-- `src/views/ContactAmountsView.vue` (line 226)
-- `src/views/HomeView.vue` (line 517)
-- `src/views/UserProfileView.vue` (line 185)
-- `src/views/ClaimView.vue` (line 730)
-- `src/views/OfferDetailsView.vue` (line 435)
-- `src/views/QuickActionBvcEndView.vue` (line 229)
-- `src/views/SharedPhotoView.vue` (line 178)
-- `src/views/ClaimReportCertificateView.vue` (line 56)
-- `src/views/ProjectsView.vue` (line 393)
-- `src/views/ClaimAddRawView.vue` (line 114)
-- `src/views/ContactQRScanShowView.vue` (line 288)
-- `src/views/InviteOneAcceptView.vue` (line 122)
-- `src/views/RecentOffersToUserView.vue` (line 118)
-- `src/views/NewEditProjectView.vue` (line 380)
-- `src/views/GiftedDetailsView.vue` (line 443)
-- `src/views/ProjectViewView.vue` (line 782)
-- `src/views/ContactsView.vue` (line 296)
-- `src/views/ContactQRScanFullView.vue` (line 267)
-- `src/views/NewActivityView.vue` (line 204)
-- `src/views/ClaimCertificateView.vue` (line 42)
-- `src/views/ContactGiftingView.vue` (line 166)
-- `src/views/RecentOffersToUserProjectsView.vue` (line 126)
-- `src/views/InviteOneView.vue` (line 285)
-- `src/views/IdentitySwitcherView.vue` (line 202)
-- `src/views/AccountViewView.vue` (line 1052)
-- `src/views/ConfirmGiftView.vue` (line 549)
-- `src/views/ContactImportView.vue` (line 342)
-
-#### Components (7 components)
-- `src/components/OfferDialog.vue` (line 177)
-- `src/components/PhotoDialog.vue` (line 270)
-- `src/components/GiftedDialog.vue` (line 223)
-- `src/components/MembersList.vue` (line 234)
-- `src/components/OnboardingDialog.vue` (line 272)
-- `src/components/ImageMethodDialog.vue` (line 502)
-- `src/components/FeedFilters.vue` (line 89)
-
-**Implementation Strategy:**
-
-1. **Systematic Replacement**: Use grep search to find all instances
-2. **Pattern Matching**: Replace `this.activeDid = settings.activeDid` with new pattern
-3. **Error Handling**: Ensure proper error handling in each component
-4. **Testing**: Test each component individually after update
-
-**Example Component Update:**
-
-```typescript
-// BEFORE (in any component):
-private async initializeSettings() {
-  const settings = await this.$accountSettings();
-  this.activeDid = settings.activeDid || "";
-  this.apiServer = settings.apiServer || "";
-}
-
-// AFTER (in any component):
-private async initializeSettings() {
-  const settings = await this.$accountSettings();
-  const activeIdentity = await this.$getActiveIdentity();
-  this.activeDid = activeIdentity.activeDid || "";
-  this.apiServer = settings.apiServer || "";
-}
-```
-
-**Alternative Pattern (if settings still needed):**
-
-```typescript
-// If component needs both settings and activeDid:
-private async initializeSettings() {
-  const settings = await this.$accountSettings();
-  const activeIdentity = await this.$getActiveIdentity();
-  
-  // Use activeDid from new table
-  this.activeDid = activeIdentity.activeDid || "";
-  
-  // Use other settings from settings table
-  this.apiServer = settings.apiServer || "";
-  this.partnerApiServer = settings.partnerApiServer || "";
-  // ... other settings
-}
-```
-
-## What Works (Evidence)
-
-- ✅ **Migration code exists** in MIGRATIONS array
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows successful execution of migrations 003 and 004
-  - **Verify at**: `🎉 [Migration] Successfully applied: 003_active_did_separate_table`
-
-- ✅ **$getActiveIdentity() method exists** in PlatformServiceMixin
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows method calls returning correct data format
-  - **Verify at**: `[PlatformServiceMixin] $getActiveIdentity(): activeDid resolved {activeDid: 'did:ethr:0xAe6ea6A4c20aDeE7B1c7Ee1fEFAa6fBe0986a671'}`
-
-- ✅ **Database migration infrastructure** exists and mature
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows 6 migrations applied successfully
-  - **Verify at**: `🎉 [Migration] Migration process complete! Summary: 6 applied, 0 skipped`
-
-- ✅ **$accountSettings() updated** with minimal safe change
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows method returning activeDid from new table
-  - **Status**: Maintains all existing complex logic while using new table as primary source
-
-- ✅ **$updateActiveDid() dual-write implemented**
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Method exists and ready for testing
-  - **Status**: Uses MASTER_SETTINGS_KEY constant for proper settings table targeting
-
-- ✅ **HomeView.vue successfully migrated** to use new API
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows `[HomeView] ActiveDid migration - using new API`
-  - **Status**: Component successfully uses `$getActiveIdentity()` instead of `settings.activeDid`
-
-- ✅ **Clean architecture implemented** - active_identity is now single source of truth
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows consistent activeDid values from active_identity table
-  - **Status**: active_identity table is the only source for activeDid, settings table handles app config only
-
-- ✅ **Schema cleanup** - activeDid column removed from settings table
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows successful execution of migration 004
-  - **Status**: Complete separation of concerns - no more confusing dual-purpose columns
-
-## What Doesn't (Evidence & Hypotheses)
-
-- ❌ **11 components still use old pattern** `this.activeDid = settings.activeDid`
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Grep search found 11 remaining instances across views and components
-  - **Hypothesis**: Components need updates but API layer is now ready
-  - **Next probe**: Systematic component updates can now proceed
-
-## Risks, Limits, Assumptions
-
-- **Data Loss Risk**: Migration failure could lose activeDid values
-- **Breaking Changes**: API updates required in PlatformServiceMixin
-- **Testing Overhead**: All platforms must be tested with new structure
-- **Component Updates**: 35+ components need individual updates and testing
-
-## Rollback Strategy
-
-### Schema Rollback
-```sql
--- If migration fails, restore original schema
-DROP TABLE IF EXISTS active_identity;
-```
-
-### Data Rollback
-```typescript
-// Rollback function to restore activeDid to settings table
-async function rollbackActiveDidMigration(): Promise<boolean> {
-  try {
-    const activeIdentityResult = await dbQuery(
-      "SELECT activeDid FROM active_identity WHERE id = 1"
-    );
-    
-    if (activeIdentityResult?.values?.length) {
-      const activeDid = activeIdentityResult.values[0][0] as string;
-      
-      await dbExec(
-        "UPDATE settings SET activeDid = ? WHERE id = ?",
-        [activeDid, MASTER_SETTINGS_KEY]
-      );
-      
-      return true;
-    }
-    
-    return false;
-  } catch (error) {
-    logger.error("[Rollback] Failed to restore activeDid:", error);
-    return false;
-  }
-}
-```
-
-## Next Steps
-
-| Task | Exit Criteria | Priority |
-|------|---------------|----------|
-| **Update $accountSettings() method** | Method calls $getActiveIdentity and combines with settings | ✅ COMPLETE |
-| **Implement $updateActiveDid() dual-write** | Method updates both active_identity and settings tables | ✅ COMPLETE |
-| **Start application in browser** | Application loads and initializes IndexedDB database | ✅ COMPLETE |
-| **Inspect IndexedDB via DevTools** | Verify active_identity table exists and contains data | ✅ COMPLETE |
-| **Update first component** | One component successfully uses new API pattern | ✅ COMPLETE (HomeView.vue) |
-| **Systematic component updates** | All 26 remaining components use new API pattern (with test:web after each) | 🟢 HIGH |
-| **Test all platforms** | Web, Electron, iOS, Android platforms verified working | 🟡 MEDIUM |
-| **Performance optimization** | Reduce excessive $getActiveIdentity() calls | 🟡 MEDIUM |
-
-**Critical Blocker**: API layer complete. Ready to proceed with component updates.
-
-## Migration Execution Rule
-
-### **One Component + Test Pattern**
-**Rule**: After migrating each component, run `npm run test:web` and `npm run lint-fix` to verify the change doesn't break existing functionality and meets code standards.
-
-**Workflow**:
-1. **Migrate one component** - Update to use `$getActiveIdentity()` pattern
-2. **Run lint-fix** - Ensure code meets project standards
-3. **Run test:web** - Verify no regressions introduced
-4. **Commit if passing** - Only commit after tests and linting pass
-5. **Repeat** - Move to next component
-
-**Benefits**:
-- Catch issues immediately after each change
-- Maintain code quality throughout migration
-- Easy rollback if problems arise
-- Systematic progress tracking
-
-**Exit Criteria**: All 26 components migrated with passing tests
-
-## Performance Observations
-
-### Excessive API Calls Detected
-The console log shows `$getActiveIdentity()` being called very frequently (multiple times per component mount). This suggests:
-- Components may be calling the API more than necessary
-- Could be optimized for better performance
-- Not a blocker, but worth monitoring during component updates
-
-### Recommended Optimization Strategy
-1. **Audit component lifecycle** - Ensure API calls happen only when needed
-2. **Implement caching** - Consider short-term caching of activeDid values
-3. **Batch updates** - Group related API calls where possible
-4. **Monitor performance** - Track API call frequency during component updates
-
-## Future Improvement: MASTER_SETTINGS_KEY Elimination
-
-**Not critical for this task** but logged for future improvement:
-
-```typescript
-// Current: WHERE id = "1" 
-// Future: WHERE accountDid IS NULL
-
-// This eliminates the confusing concept of "master" settings
-// and uses a cleaner pattern for default settings
-```
-
-## References
-
-- [Database Migration Guide](./database-migration-guide.md)
-- [Dexie to SQLite Mapping](./dexie-to-sqlite-mapping.md)
-- [PlatformServiceMixin Documentation](./component-communication-guide.md)
-
-## Competence Hooks
-
-- *Why this works*: Separates concerns between identity selection and user preferences, prevents data corruption with foreign key constraints
-- *Common pitfalls*: Method signature mismatches, forgetting dual-write pattern, not testing database state
-- *Next skill unlock*: Systematic API updates with backward compatibility
-- *Teach-back*: Explain why dual-write pattern is needed during migration transition
-
-## Collaboration Hooks
-
-- **Reviewers**: Database team, PlatformServiceMixin maintainers, QA team
-- **Sign-off checklist**:
-  - [ ] Migration script integrated with existing MIGRATIONS array
-  - [x] $getActiveIdentity() method returns correct type
-  - [x] $accountSettings() method updated to use new API (minimal safe change)
-  - [x] $updateActiveDid() method implements dual-write pattern
-  - [ ] All 35+ components updated to use new API
-  - [ ] Rollback procedures validated
-  - [ ] All platforms tested
-  - [ ] All stakeholders approve deployment timeline

doc/migration-004-complexity-resolution-plan.md

@@ -1,198 +0,0 @@
-# Migration 004 Complexity Resolution Plan
-
-**Document Version**: 1.3  
-**Author**: Matthew Raymer  
-**Date**: 2025-01-27  
-**Status**: Implementation Phase - Phase 1 Complete  
-
-## Problem Summary
-
-The current migration 004 implementation has become overly complex with multiple critical issues that create serious risks for data integrity and application performance.
-
-### Four Most Critical Issues
-
-1. **Duplicate SQL Definitions**: Migration 004 SQL exists in three separate locations (main sql field, statements array, recovery logic), making it impossible to ensure all users run identical statements.
-
-2. **Non-Atomic Execution**: Individual statements continue executing even if earlier statements fail, causing partial data migration and potential data loss.
-
-3. **Incorrect Database Result Handling**: Code assumes PlatformService abstraction format when called directly from raw database services, causing runtime errors.
-
-4. **Duplicate Execution Risk**: Recovery logic could re-run statements that already executed successfully, leading to data corruption.
-
-## Resolution Principles
-
-**Guiding Principle**: All migrations must execute from a single SQL source in the MIGRATIONS array, as one atomic statement.
-
-- **Single Source of Truth**: Only one place defines migration SQL
-- **Atomic Operations**: Migration succeeds completely or fails completely  
-- **Database Agnostic**: Result handling works with any database service
-- **Minimal Overhead**: No unnecessary logging or validation
-- **Simple Recovery**: If migration fails, it should be obvious and fixable
-
-## Implementation Phases
-
-### Phase 1: Simplify Migration Definition ✅ COMPLETED
-**Objective**: Establish single source of truth for migration SQL
-
-**Actions**:
-- ✅ Remove `statements` array from migration 004 definition
-- ✅ Keep only the single `sql` field as the authoritative source
-- ✅ Remove all recovery logic that duplicates SQL statements
-- ✅ Ensure migration SQL is self-contained and atomic
-
-**Deliverables**:
-- ✅ Clean migration definition with single SQL source
-- ✅ Removed duplicate SQL definitions
-- ✅ Eliminated recovery logic complexity
-
-### Phase 2: Fix Database Result Handling ✅ COMPLETED
-**Objective**: Make result handling database-agnostic
-
-**Actions**:
-- ✅ Remove DatabaseResult type assumptions from migration code
-- ✅ Implement proper result extraction based on actual database service
-- ✅ Use the `extractMigrationNames` function pattern consistently
-- ✅ Make result handling work with any database service implementation
-- ✅ Normalize results from AbsurdSqlDatabaseService and CapacitorPlatformService into shared internal format
-
-**Deliverables**:
-- ✅ Database-agnostic result handling
-- ✅ Consistent result extraction across all database services
-- ✅ Removed type casting assumptions
-- ✅ Shared internal result format for all database services
-
-### Phase 3: Ensure Atomic Execution ✅ COMPLETED
-**Objective**: Guarantee migration succeeds completely or fails completely
-
-**Actions**:
-- ✅ Modify migration service to execute single SQL block only
-- ✅ Remove individual statement execution logic
-- ✅ Implement proper error handling that prevents partial execution
-- ✅ Ensure migration tracking is accurate
-- ✅ Provide explicit rollback/restore instructions for migration failures
-- ✅ Ensure migration logs indicate failure cause and required operator action
-
-**Deliverables**:
-- ✅ Atomic migration execution
-- ✅ Proper error handling
-- ✅ Accurate migration tracking
-- ✅ Clear recovery procedures
-
-### Phase 4: Remove Excessive Debugging ✅ COMPLETED
-**Objective**: Eliminate performance overhead from debugging code
-
-**Actions**:
-- ✅ Remove detailed logging that slows startup
-- ✅ Keep only essential error logging
-- ✅ Remove complex validation logic that runs on every startup
-- ✅ Move debugging code to test page or development-only mode
-
-**Deliverables**:
-- ✅ Faster application startup
-- ✅ Cleaner production code
-- ✅ Debugging available only when needed
-
-### Phase 5: Testing & Validation
-**Objective**: Ensure simplified migration works correctly
-
-**Actions**:
-- Test migration execution with different database services
-- Verify no duplicate execution occurs
-- Confirm proper error handling
-- Validate data integrity after migration
-- Test rollback/restore scenarios to confirm system recovery paths
-- Test edge cases: empty database, partially migrated database, already-migrated database
-- Test concurrency scenarios (multiple app instances/migrations starting simultaneously)
-- Test cross-platform/device differences (SQLite, AbsurdSQL, Capacitor DB adapters)
-
-**Deliverables**:
-- Working migration system
-- No duplicate execution
-- Proper error handling
-- Data integrity maintained
-- Validated recovery procedures
-- Edge case coverage confirmed
-- Documented test results as artifacts for future regression testing
-
-## Performance & Debugging
-
-**Current Issue**: Excessive logging and validation code runs on every app startup, slowing application performance.
-
-**Solution**: 
-- Debugging/logging is acceptable in development/test environments
-- Production startup must not be slowed by migration debugging
-- Move complex validation to test page or development-only mode
-- Keep only essential error logging for production
-
-## Rollback & Recovery Procedures
-
-### Manual Rollback Steps
-1. **Stop Application**: Ensure no active database connections
-2. **Restore Database**: Use snapshot/backup to restore pre-migration state
-3. **Clear Migration Tracking**: Remove migration 004 entry from migrations table
-4. **Verify State**: Confirm active_identity table is removed and settings.activeDid is restored
-5. **Restart Application**: Test normal operation
-
-### Automated Rollback
-- **Automated Detection**: Migration service detects failure and triggers rollback
-- **Database Restore**: Automated restoration from pre-migration snapshot
-- **Logging**: Detailed rollback logs with failure cause and recovery actions
-- **Validation**: Automated verification of rollback success
-
-### Recovery Validation
-- **Data Integrity Check**: Verify all data is consistent with pre-migration state
-- **Migration Status**: Confirm migration tracking reflects correct state
-- **Application Functionality**: Test core features work correctly
-- **Performance Baseline**: Confirm startup performance matches pre-migration levels
-
-## Files Requiring Changes
-
-### Core Migration Files (Primary Changes)
-- `src/db-sql/migration.ts` - Remove duplicate SQL definitions, fix DatabaseResult usage, remove recovery logic
-- `src/services/migrationService.ts` - Remove individual statement execution, ensure atomic execution
-
-### Database Service Files (Result Handling Fixes)
-- `src/services/AbsurdSqlDatabaseService.ts` - Fix result extraction for migration queries
-- `src/services/platforms/CapacitorPlatformService.ts` - Fix result extraction for migration queries
-
-**Note**: Verify all file paths match repository reality as part of CI validation.
-
-## Success Criteria
-
-- [ ] Migration 004 SQL defined in single location only
-- [ ] Migration executes atomically (all-or-nothing)
-- [ ] Database result handling works with all database services
-- [ ] No duplicate statement execution possible
-- [ ] Startup time reduced by at least 20% compared to pre-fix baseline (measured via cold app start profiling logs)
-- [ ] Migration tracking is accurate and reliable
-- [ ] Error handling is clear and actionable
-
-## Next Steps
-
-1. **Review and Approve Plan**: Get stakeholder approval for this approach
-2. **Phase 1 Implementation**: Begin with simplifying migration definition
-3. **Testing**: Validate each phase before proceeding
-4. **Assign Migration Owner**: Designate clear owner for future migration reviews
-5. **Create Review Checklist**: Define lightweight checklist (SQL duplication, atomicity, error handling) to prevent recurrence
-
-## Dependencies
-
-- Migration service architecture
-- Database service implementations
-- Testing infrastructure
-- Documentation system
-- Seed datasets or controlled test states for reproducible validation
-- Snapshot/restore utilities for rollback testing
-
-## Lessons Learned
-
-**Process Improvement Note**: This migration complexity highlights the importance of closer review and consolidation of AI-generated code. Uncontrolled proliferation of generated logic leads to fragmentation, review fatigue, and system instability. Future development should prioritize:
-
-- Single source of truth for all critical logic
-- Atomic operations over complex multi-step processes  
-- Regular consolidation and simplification of generated code
-- Clear ownership and review processes for migration logic
-
----
-
-*This document will be updated as the implementation progresses and new insights are gained.*

doc/verification-party-system-plan.md

@@ -1,375 +0,0 @@
-# TimeSafari Identity Verification Party System Plan
-
-## Objectives
-
-* Maintain strict conformity with TimeSafari's existing **DID, contact, and identity management**.
-* Ensure **offline-first reliability** with background sync and retry logic.
-* Provide **minimal, mobile-first UX** with single-tap core actions and QR-driven flows.
-
-## Architecture
-
-* Use a **single atomic migration** (`005_verification_party_system.sql`) following `registerMigration()` + `MIGRATIONS` array pattern.
-* Standardize timestamps (`dateCreated`, `dateVerified`) in **ISO-8601 UTC**.
-* Add `verification_session_logs` for audit trail and debugging.
-
-## Workflow
-
-* **Pre-Party**: Enforce RSVP via DID signing challenge; cache DID QR locally.
-* **In-Party**: Dual-mode verification (Fast Scan + Deep Verify) with **trust presets**.
-* **Post-Party**: Queue verifications for delayed sync; issue signed receipts; auto-create verified contacts.
-
-## Services
-
-* `VerificationPartyService`: Monolithic class aligned with existing service pattern.
-* `DidVerificationService`: Pluggable methods (QR, NFC, manual, photo ID).
-* `TrustNetworkService`: Add caching + **trust decay** unless renewed.
-
-## Security
-
-* Store **hashes of evidence** only (not raw PII).
-* Encrypt data with **per-user derived keys**.
-* Provide **per-verification sharing controls** (private, party-only, global).
-
-## UI/UX
-
-* Single-tap flows for RSVP, scan, verify.
-* Embed **trust level criteria** in UI to reduce inconsistency.
-* Optimize QR scanning and trust graph for **battery savings**.
-* Follow existing **i18n service** for multi-language support.
-
-## Priorities
-
-1. Migration + offline queue
-2. Dual-mode verification UI
-3. Trust graph caching + decay
-4. Privacy-hardened evidence handling
-5. Notification constants + helper integration
-
----
-
-## Database Schema
-
-### Migration 005: Verification Party System
-Add to `src/db-sql/migration.ts` in the `MIGRATIONS` array:
-
-```typescript
-{
-  name: "005_verification_party_system",
-  sql: `
-    -- Migration 005: verification_party_system
-    -- Adds identity verification party functionality
-    
-    -- Enable foreign key constraints for data integrity
-    PRAGMA foreign_keys = ON;
-    
-    -- Create verification_parties table
-    CREATE TABLE IF NOT EXISTS verification_parties (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      partyId TEXT UNIQUE NOT NULL,
-      organizerDid TEXT NOT NULL,
-      name TEXT NOT NULL,
-      description TEXT,
-      location TEXT,
-      scheduledDate TEXT,
-      maxParticipants INTEGER DEFAULT 50,
-      status TEXT DEFAULT 'planned',
-      dateCreated TEXT DEFAULT (datetime('now')),
-      FOREIGN KEY (organizerDid) REFERENCES accounts(did)
-    );
-    
-    -- Create party_participants table
-    CREATE TABLE IF NOT EXISTS party_participants (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      partyId TEXT NOT NULL,
-      participantDid TEXT NOT NULL,
-      status TEXT DEFAULT 'invited',
-      verificationCount INTEGER DEFAULT 0,
-      rsvpDate TEXT,
-      checkInDate TEXT,
-      dateCreated TEXT DEFAULT (datetime('now')),
-      FOREIGN KEY (partyId) REFERENCES verification_parties(partyId),
-      FOREIGN KEY (participantDid) REFERENCES accounts(did)
-    );
-    
-    -- Create did_verifications table
-    CREATE TABLE IF NOT EXISTS did_verifications (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      verifierDid TEXT NOT NULL,
-      verifiedDid TEXT NOT NULL,
-      partyId TEXT,
-      verificationMethod TEXT,
-      verificationNotes TEXT,
-      verificationLevel INTEGER DEFAULT 1,
-      verificationEvidenceHash TEXT,
-      dateVerified TEXT DEFAULT (datetime('now')),
-      FOREIGN KEY (verifierDid) REFERENCES accounts(did),
-      FOREIGN KEY (verifiedDid) REFERENCES accounts(did),
-      FOREIGN KEY (partyId) REFERENCES verification_parties(partyId)
-    );
-    
-    -- Create verification_session_logs table
-    CREATE TABLE IF NOT EXISTS verification_session_logs (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      partyId TEXT NOT NULL,
-      sessionAction TEXT NOT NULL,
-      participantDid TEXT,
-      actionData TEXT,
-      dateCreated TEXT DEFAULT (datetime('now')),
-      FOREIGN KEY (partyId) REFERENCES verification_parties(partyId),
-      FOREIGN KEY (participantDid) REFERENCES accounts(did)
-    );
-    
-    -- Create indexes for performance
-    CREATE INDEX IF NOT EXISTS idx_verification_parties_organizer ON verification_parties(organizerDid);
-    CREATE INDEX IF NOT EXISTS idx_verification_parties_status ON verification_parties(status);
-    CREATE INDEX IF NOT EXISTS idx_party_participants_party ON party_participants(partyId);
-    CREATE INDEX IF NOT EXISTS idx_party_participants_did ON party_participants(participantDid);
-    CREATE INDEX IF NOT EXISTS idx_did_verifications_verifier ON did_verifications(verifierDid);
-    CREATE INDEX IF NOT EXISTS idx_did_verifications_verified ON did_verifications(verifiedDid);
-    CREATE INDEX IF NOT EXISTS idx_did_verifications_party ON did_verifications(partyId);
-    CREATE INDEX IF NOT EXISTS idx_session_logs_party ON verification_session_logs(partyId);
-  `
-}
-```
-
----
-
-## TypeScript Interfaces
-
-### Required Interface Definitions
-Add to `src/interfaces/verification-party.ts`:
-
-```typescript
-/**
- * Verification Party entity interface
- */
-export interface VerificationParty {
-  id: number;
-  partyId: string;
-  organizerDid: string;
-  name: string;
-  description?: string;
-  location?: string;
-  scheduledDate?: string;
-  maxParticipants: number;
-  status: 'planned' | 'active' | 'completed' | 'cancelled';
-  dateCreated: string;
-}
-
-/**
- * Party Participant entity interface
- */
-export interface PartyParticipant {
-  id: number;
-  partyId: string;
-  participantDid: string;
-  status: 'invited' | 'confirmed' | 'attended' | 'verified';
-  verificationCount: number;
-  rsvpDate?: string;
-  checkInDate?: string;
-  dateCreated: string;
-}
-
-/**
- * DID Verification entity interface
- */
-export interface DidVerification {
-  id: number;
-  verifierDid: string;
-  verifiedDid: string;
-  partyId?: string;
-  verificationMethod: 'qr_scan' | 'manual_entry' | 'photo_id' | 'nfc';
-  verificationNotes?: string;
-  verificationLevel: number; // 1-5 trust level
-  verificationEvidenceHash?: string; // Hash of verification evidence
-  dateVerified: string;
-}
-
-/**
- * Verification Session Log entity interface
- */
-export interface VerificationSessionLog {
-  id: number;
-  partyId: string;
-  sessionAction: 'party_started' | 'participant_joined' | 'verification_completed' | 'sync_attempted';
-  participantDid?: string;
-  actionData?: string; // JSON blob of action-specific data
-  dateCreated: string;
-}
-```
-
----
-
-## PlatformServiceMixin Integration
-
-### Required Methods
-Add to `PlatformServiceMixin`:
-
-```typescript
-// Add to PlatformServiceMixin methods
-async $insertVerificationParty(party: Partial<VerificationParty>): Promise<boolean> {
-  return this.$insertEntity('verification_parties', party, [
-    'partyId', 'organizerDid', 'name', 'description', 'location', 
-    'scheduledDate', 'maxParticipants', 'status', 'dateCreated'
-  ]);
-}
-
-async $insertPartyParticipant(participant: Partial<PartyParticipant>): Promise<boolean> {
-  return this.$insertEntity('party_participants', participant, [
-    'partyId', 'participantDid', 'status', 'verificationCount',
-    'rsvpDate', 'checkInDate', 'dateCreated'
-  ]);
-}
-
-async $insertDidVerification(verification: Partial<DidVerification>): Promise<boolean> {
-  return this.$insertEntity('did_verifications', verification, [
-    'verifierDid', 'verifiedDid', 'partyId', 'verificationMethod',
-    'verificationNotes', 'verificationLevel', 'verificationEvidenceHash', 'dateVerified'
-  ]);
-}
-
-async $getVerificationParties(): Promise<VerificationParty[]> {
-  const results = await this.$dbQuery('SELECT * FROM verification_parties ORDER BY dateCreated DESC');
-  return this.$mapResults(results, (row) => ({
-    id: row[0] as number,
-    partyId: row[1] as string,
-    organizerDid: row[2] as string,
-    name: row[3] as string,
-    description: row[4] as string,
-    location: row[5] as string,
-    scheduledDate: row[6] as string,
-    maxParticipants: row[7] as number,
-    status: row[8] as VerificationParty['status'],
-    dateCreated: row[9] as string,
-  }));
-}
-
-async $getPartyParticipants(partyId: string): Promise<PartyParticipant[]> {
-  const results = await this.$dbQuery(
-    'SELECT * FROM party_participants WHERE partyId = ? ORDER BY dateCreated DESC',
-    [partyId]
-  );
-  return this.$mapResults(results, (row) => ({
-    id: row[0] as number,
-    partyId: row[1] as string,
-    participantDid: row[2] as string,
-    status: row[3] as PartyParticipant['status'],
-    verificationCount: row[4] as number,
-    rsvpDate: row[5] as string,
-    checkInDate: row[6] as string,
-    dateCreated: row[7] as string,
-  }));
-}
-```
-
----
-
-## Notification Constants
-
-### Required Notification Constants
-Add to `src/constants/notifications.ts`:
-
-```typescript
-// Used in: VerificationPartyCreateView.vue (createParty method)
-export const NOTIFY_PARTY_CREATED = {
-  title: "Verification Party Created",
-  message: "Your verification party has been created successfully."
-};
-
-// Used in: VerificationPartyJoinView.vue (joinParty method)
-export const NOTIFY_PARTY_JOINED = {
-  title: "Party Joined",
-  message: "You have successfully joined the verification party."
-};
-
-// Used in: VerificationPartyActiveView.vue (submitManualVerification method)
-export const NOTIFY_VERIFICATION_COMPLETED = {
-  title: "Identity Verified",
-  message: "You have successfully verified this person's identity."
-};
-
-// Used in: VerificationPartyService.ts (syncVerifications method)
-export const NOTIFY_VERIFICATION_SYNCED = {
-  title: "Verifications Synced",
-  message: "Your verification data has been synchronized successfully."
-};
-
-// Used in: VerificationPartyActiveView.vue (error handling)
-export const NOTIFY_VERIFICATION_FAILED = {
-  title: "Verification Failed",
-  message: "There was an error completing the verification. Please try again."
-};
-```
-
-### Notification Helper Integration
-Use existing `createNotifyHelpers()` pattern in components:
-
-```typescript
-// In VerificationPartyCreateView.vue
-const { success, error } = createNotifyHelpers(this.$notify);
-
-// Usage
-success("Party created successfully!");
-error("Failed to create party. Please try again.");
-```
-
----
-
-## Component Implementation Pattern
-
-### VerificationPartyCreateView.vue Structure
-```typescript
-@Component({
-  name: "VerificationPartyCreateView",
-  components: {
-    QuickNav,
-    TopMessage,
-    EntityIcon,
-  },
-  mixins: [PlatformServiceMixin],
-})
-export default class VerificationPartyCreateView extends Vue {
-  // Use PlatformServiceMixin methods
-  async createParty(): Promise<void> {
-    const partyData: Partial<VerificationParty> = {
-      partyId: `party_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
-      organizerDid: (await this.$getActiveIdentity()).activeDid,
-      name: this.partyForm.name,
-      description: this.partyForm.description,
-      location: this.partyForm.location,
-      scheduledDate: this.partyForm.scheduledDate,
-      maxParticipants: this.partyForm.maxParticipants,
-      status: 'planned',
-      dateCreated: new Date().toISOString(),
-    };
-    
-    const success = await this.$insertVerificationParty(partyData);
-    if (success) {
-      this.$notify(NOTIFY_PARTY_CREATED);
-      this.$router.push(`/verification-party/${partyData.partyId}`);
-    } else {
-      this.$notify(NOTIFY_VERIFICATION_FAILED);
-    }
-  }
-}
-```
-
----
-
-## Architecture Conformity Checklist
-
-### ✅ **100% CONFORMANT PATTERNS**
-- **Migration Structure**: ✅ Follows existing `registerMigration()` and `MIGRATIONS` array pattern
-- **Database Schema**: ✅ Uses `INTEGER PRIMARY KEY AUTOINCREMENT` and `camelCase` field naming
-- **Component Architecture**: ✅ Integrates `@Component` decorator and `PlatformServiceMixin`
-- **Service Pattern**: ✅ Single monolithic service class following TimeSafari conventions
-- **Notification System**: ✅ Uses existing `NOTIFY_*` constants and `createNotifyHelpers()`
-- **UI Components**: ✅ Leverages existing `QuickNav`, `TopMessage`, `EntityIcon` components
-- **TypeScript Interfaces**: ✅ Proper interface definitions following existing patterns
-- **PlatformServiceMixin Integration**: ✅ Uses existing `$insertEntity()` and `$mapResults()` methods
-- **Database Operations**: ✅ Follows existing `$dbQuery()`, `$dbExec()` patterns
-- **Error Handling**: ✅ Uses existing logger and error handling patterns
-
-### 📊 **FINAL CONFORMITY SCORE: 100%**
-
-The verification party system plan now achieves complete conformity with TimeSafari's existing architecture patterns, naming conventions, and integration approaches.

docs/directives/fix-notification-dismiss-cancel.mdc

@@ -0,0 +1,109 @@
+# Fix Notification Dismiss to Cancel Notification
+
+## Problem
+
+When a user clicks the "Dismiss" button on a daily notification, the notification is removed from storage and alarms are cancelled, but the notification itself is not cancelled from the NotificationManager. This means the notification remains visible in the system tray even though it's been dismissed.
+
+Additionally, clicking on the notification (not the dismiss button) launches the app, which is working as intended.
+
+## Root Cause
+
+In `DailyNotificationWorker.java`, the `handleDismissNotification()` method:
+1. ✅ Removes notification from storage
+2. ✅ Cancels pending alarms
+3. ❌ **MISSING**: Does not cancel the notification from NotificationManager
+
+The notification is displayed with ID = `content.getId().hashCode()` (line 440), but this ID is never used to cancel the notification when dismissing.
+
+## Solution
+
+Add notification cancellation to `handleDismissNotification()` method in `DailyNotificationWorker.java`.
+
+### IMPORTANT: Plugin Source Change
+
+**This change must be applied to the plugin source repository**, not the host app. The file is located in the `@timesafari/daily-notification-plugin` package.
+
+### File to Modify
+
+**Plugin Source Repository:**
+`android/src/main/java/com/timesafari/dailynotification/DailyNotificationWorker.java`
+
+**Note:** In the host app's `node_modules`, this file is located at:
+`node_modules/@timesafari/daily-notification-plugin/android/src/main/java/com/timesafari/dailynotification/DailyNotificationWorker.java`
+
+However, changes to `node_modules` will be overwritten on the next `npm install`. This fix must be applied to the plugin's source repository.
+
+### Change Required
+
+In the `handleDismissNotification()` method (around line 177-206), add code to cancel the notification from NotificationManager:
+
+```java
+private Result handleDismissNotification(String notificationId) {
+    Trace.beginSection("DN:dismiss");
+    try {
+        Log.d(TAG, "DN|DISMISS_START id=" + notificationId);
+        
+        // Cancel the notification from NotificationManager FIRST
+        // This ensures the notification disappears immediately when dismissed
+        NotificationManager notificationManager = 
+            (NotificationManager) getApplicationContext().getSystemService(Context.NOTIFICATION_SERVICE);
+        if (notificationManager != null) {
+            int systemNotificationId = notificationId.hashCode();
+            notificationManager.cancel(systemNotificationId);
+            Log.d(TAG, "DN|DISMISS_CANCEL_NOTIF systemId=" + systemNotificationId);
+        }
+        
+        // Remove from Room if present; also remove from legacy storage for compatibility
+        try {
+            DailyNotificationStorageRoom room = new DailyNotificationStorageRoom(getApplicationContext());
+            // No direct delete DAO exposed via service; legacy removal still applied
+        } catch (Exception ignored) { }
+        DailyNotificationStorage storage = new DailyNotificationStorage(getApplicationContext());
+        storage.removeNotification(notificationId);
+        
+        // Cancel any pending alarms
+        DailyNotificationScheduler scheduler = new DailyNotificationScheduler(
+            getApplicationContext(),
+            (android.app.AlarmManager) getApplicationContext().getSystemService(Context.ALARM_SERVICE)
+        );
+        scheduler.cancelNotification(notificationId);
+        
+        Log.i(TAG, "DN|DISMISS_OK id=" + notificationId);
+        return Result.success();
+        
+    } catch (Exception e) {
+        Log.e(TAG, "DN|DISMISS_ERR exception id=" + notificationId + " err=" + e.getMessage(), e);
+        return Result.retry();
+    } finally {
+        Trace.endSection();
+    }
+}
+```
+
+### Key Points
+
+1. **Notification ID**: Use `notificationId.hashCode()` to match the ID used when displaying (line 440: `int notificationId = content.getId().hashCode()`)
+2. **Order**: Cancel the notification FIRST, before removing from storage, so it disappears immediately
+3. **Null check**: Check that NotificationManager is not null before calling cancel()
+4. **Logging**: Add instrumentation log to track cancellation
+
+### Expected Behavior After Fix
+
+1. User clicks "Dismiss" button → Notification disappears immediately from system tray
+2. User clicks notification body → App launches (unchanged behavior)
+3. User swipes notification away → Notification dismissed (Android handles this automatically with `setAutoCancel(true)`)
+
+## Testing Checklist
+
+- [ ] Click dismiss button → Notification disappears immediately
+- [ ] Click notification body → App launches
+- [ ] Swipe notification away → Notification dismissed
+- [ ] Check logs for `DN|DISMISS_CANCEL_NOTIF` entry
+- [ ] Verify notification is removed from storage after dismiss
+- [ ] Verify alarms are cancelled after dismiss
+
+## Related Code
+
+- Notification display: `DailyNotificationWorker.displayNotification()` line 440
+- Notification ID generation: `content.getId().hashCode()`
+- Auto-cancel: `builder.setAutoCancel(true)` line 363 (handles swipe-to-dismiss)

docs/prefetch-investigation-summary.md

@@ -0,0 +1,109 @@
+# Prefetch Investigation Summary
+
+## Problem Statement
+
+The daily notification prefetch job (T-5 min) is not calling the native fetcher, resulting in:
+- `from: null` in prefetch logs
+- Fallback/mock content being used
+- `DISPLAY_SKIP content_not_found` at notification time
+- Storage empty (`[]`) when display worker runs
+
+## Root Cause Hypothesis
+
+Based on the directive analysis, likely causes (ranked):
+
+1. **Registration Timing**: Prefetch worker runs before `Application.onCreate()` completes
+2. **Discovery Failure**: Worker resolves fetcher to `null` (wrong scope, process mismatch)
+3. **Persistence Bug**: Content written but wiped/deduped before display
+4. **ID Mismatch**: Prefetch writes `notify_...` but display looks for `daily_...`
+
+## Instrumentation Added
+
+### TimeSafariApplication.java
+- `APP|ON_CREATE ts=... pid=... processName=...` - App initialization timing
+- `FETCHER|REGISTER_START instanceHash=... ts=...` - Before registration
+- `FETCHER|REGISTERED providerKey=... instanceHash=... registered=... ts=...` - After registration with verification
+
+### TimeSafariNativeFetcher.java
+- `FETCHER|CONFIGURE_START instanceHash=... pid=... ts=...` - Configuration start
+- `FETCHER|CONFIGURE_COMPLETE instanceHash=... configured=... apiBaseUrl=... activeDid=... jwtLength=... ts=...` - Configuration completion
+- `PREFETCH|START id=... notifyAt=... trigger=... instanceHash=... pid=... ts=...` - Fetch start
+- `PREFETCH|SOURCE from=native/fallback reason=... ts=...` - Source resolution
+- `PREFETCH|WRITE_OK id=... items=... ts=...` - Successful fetch
+
+## Diagnostic Tools
+
+### Log Filtering Script
+```bash
+./scripts/diagnose-prefetch.sh app.timesafari.app
+```
+
+Filters logcat for:
+- `APP|ON_CREATE`
+- `FETCHER|*`
+- `PREFETCH|*`
+- `DISPLAY|*`
+- `STORAGE|*`
+
+### Manual Filtering
+```bash
+adb logcat | grep -E "APP\|ON_CREATE|FETCHER\||PREFETCH\||DISPLAY\||STORAGE\|"
+```
+
+## Investigation Checklist
+
+### A. App/Plugin Initialization Order
+- [ ] Confirm `APP|ON_CREATE` appears before `PREFETCH|START`
+- [ ] Verify `FETCHER|REGISTERED registered=true`
+- [ ] Check for multiple `onCreate` invocations (process restarts)
+- [ ] Confirm single process (no `android:process` on workers)
+
+### B. Prefetch Worker Resolution
+- [ ] Check `PREFETCH|SOURCE from=native` (not `from=fallback`)
+- [ ] Verify `instanceHash` matches between registration and fetch
+- [ ] Compare `pid` values (should be same process)
+- [ ] Check `FETCHER|CONFIGURE_COMPLETE configured=true` before prefetch
+
+### C. Storage & Persistence
+- [ ] Verify `PREFETCH|WRITE_OK items>=1`
+- [ ] Check storage logs for content persistence
+- [ ] Compare prefetch ID vs display lookup ID (must match)
+
+### D. ID Schema Consistency
+- [ ] Prefetch ID format: `daily_<epoch>` or `notify_<epoch>`
+- [ ] Display lookup ID format: must match prefetch ID
+- [ ] Verify ID derivation rules are consistent
+
+## Next Steps
+
+1. **Run diagnostic script** during a notification cycle
+2. **Analyze logs** for timing issues and process mismatches
+3. **If fetcher is null**: Implement Fix #2 (Pass Fetcher Context With Work) or Fix #3 (Process-Safe DI)
+4. **If ID mismatch**: Normalize ID schema across prefetch and display
+5. **If storage issue**: Add transactional writes and read-after-write verification
+
+## Expected Log Flow (Success Case)
+
+```
+APP|ON_CREATE ts=... pid=... processName=app.timesafari.app
+FETCHER|REGISTER_START instanceHash=... ts=...
+FETCHER|REGISTERED providerKey=DailyNotificationPlugin instanceHash=... registered=true ts=...
+FETCHER|CONFIGURE_START instanceHash=... pid=... ts=...
+FETCHER|CONFIGURE_COMPLETE instanceHash=... configured=true ... ts=...
+PREFETCH|START id=daily_... notifyAt=... trigger=prefetch instanceHash=... pid=... ts=...
+PREFETCH|SOURCE from=native instanceHash=... apiBaseUrl=... ts=...
+PREFETCH|WRITE_OK id=daily_... items=1 ts=...
+STORAGE|POST_PREFETCH total=1 ids=[daily_...]
+DISPLAY|START id=daily_...
+STORAGE|PRE_DISPLAY total=1 ids=[daily_...]
+DISPLAY|LOOKUP result=hit id=daily_...
+```
+
+## Failure Indicators
+
+- `PREFETCH|SOURCE from=fallback` - Native fetcher not resolved
+- `PREFETCH|SOURCE from=null` - Fetcher registration failed
+- `FETCHER|REGISTERED registered=false` - Registration verification failed
+- `STORAGE|PRE_DISPLAY total=0` - Content not persisted
+- `DISPLAY|LOOKUP result=miss` - ID mismatch or content cleared
+

index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/favicon.ico" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover, user-scalable=no, interactive-widget=overlays-content" />
     
     <!-- CORS headers removed to allow images from any domain -->
     
@@ -13,4 +13,4 @@
     <div id="app"></div>
     <script type="module" src="/src/main.ts"></script>
   </body>
-</html>
+</html>

ios/App/App.xcodeproj/project.pbxproj

@@ -403,7 +403,7 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 41;
+				CURRENT_PROJECT_VERSION = 47;
 				DEVELOPMENT_TEAM = GM3FS5JQPH;
 				ENABLE_APP_SANDBOX = NO;
 				ENABLE_USER_SCRIPT_SANDBOXING = NO;
@@ -413,7 +413,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.0.8;
+				MARKETING_VERSION = 1.1.2;
 				OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";
 				PRODUCT_BUNDLE_IDENTIFIER = app.timesafari;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -430,7 +430,7 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 41;
+				CURRENT_PROJECT_VERSION = 47;
 				DEVELOPMENT_TEAM = GM3FS5JQPH;
 				ENABLE_APP_SANDBOX = NO;
 				ENABLE_USER_SCRIPT_SANDBOXING = NO;
@@ -440,7 +440,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.0.8;
+				MARKETING_VERSION = 1.1.2;
 				PRODUCT_BUNDLE_IDENTIFIER = app.timesafari;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "timesafari",
-  "version": "1.1.0-beta",
+  "version": "1.1.3-beta",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "timesafari",
-      "version": "1.1.0-beta",
+      "version": "1.1.3-beta",
       "dependencies": {
         "@capacitor-community/electron": "^5.0.1",
         "@capacitor-community/sqlite": "6.0.2",
@@ -27,6 +27,7 @@
         "@ethersproject/hdnode": "^5.7.0",
         "@ethersproject/wallet": "^5.8.0",
         "@fortawesome/fontawesome-svg-core": "^6.5.1",
+        "@fortawesome/free-regular-svg-icons": "^6.7.2",
         "@fortawesome/free-solid-svg-icons": "^6.5.1",
         "@fortawesome/vue-fontawesome": "^3.0.6",
         "@jlongster/sql.js": "^1.6.7",
@@ -36,6 +37,7 @@
         "@pvermeer/dexie-encrypted-addon": "^3.0.0",
         "@simplewebauthn/browser": "^10.0.0",
         "@simplewebauthn/server": "^10.0.0",
+        "@timesafari/daily-notification-plugin": "file:../daily-notification-plugin",
         "@tweenjs/tween.js": "^21.1.1",
         "@types/qrcode": "^1.5.5",
         "@veramo/core": "^5.6.0",
@@ -90,6 +92,7 @@
         "vue": "3.5.13",
         "vue-axios": "^3.5.2",
         "vue-facing-decorator": "3.0.4",
+        "vue-markdown-render": "^2.2.1",
         "vue-picture-cropper": "^0.7.0",
         "vue-qrcode-reader": "^5.5.3",
         "vue-router": "^4.5.0",
@@ -106,6 +109,7 @@
         "@types/js-yaml": "^4.0.9",
         "@types/leaflet": "^1.9.8",
         "@types/luxon": "^3.4.2",
+        "@types/markdown-it": "^14.1.2",
         "@types/node": "^20.14.11",
         "@types/node-fetch": "^2.6.12",
         "@types/ramda": "^0.29.11",
@@ -146,6 +150,43 @@
         "vite": "^5.2.0"
       }
     },
+    "../daily-notification-plugin": {
+      "name": "@timesafari/daily-notification-plugin",
+      "version": "1.0.11",
+      "license": "MIT",
+      "workspaces": [
+        "packages/*"
+      ],
+      "dependencies": {
+        "@capacitor/core": "^6.2.1"
+      },
+      "devDependencies": {
+        "@capacitor/android": "^6.2.1",
+        "@capacitor/cli": "^6.2.1",
+        "@capacitor/ios": "^6.2.1",
+        "@types/jest": "^29.5.0",
+        "@types/jsdom": "^21.1.7",
+        "@types/node": "^20.19.0",
+        "@typescript-eslint/eslint-plugin": "^5.57.0",
+        "@typescript-eslint/parser": "^5.57.0",
+        "eslint": "^8.37.0",
+        "jest": "^29.5.0",
+        "jest-environment-jsdom": "^30.0.5",
+        "jsdom": "^26.1.0",
+        "markdownlint-cli2": "^0.18.1",
+        "prettier": "^2.8.7",
+        "rimraf": "^4.4.0",
+        "rollup": "^3.20.0",
+        "rollup-plugin-typescript2": "^0.31.0",
+        "standard-version": "^9.5.0",
+        "ts-jest": "^29.1.0",
+        "typescript": "~5.2.0",
+        "vite": "^7.1.9"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@0no-co/graphql.web": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/@0no-co/graphql.web/-/graphql.web-1.2.0.tgz",
@@ -6786,6 +6827,17 @@
         "node": ">=6"
       }
     },
+    "node_modules/@fortawesome/free-regular-svg-icons": {
+      "version": "6.7.2",
+      "resolved": "https://registry.npmjs.org/@fortawesome/free-regular-svg-icons/-/free-regular-svg-icons-6.7.2.tgz",
+      "integrity": "sha512-7Z/ur0gvCMW8G93dXIQOkQqHo2M5HLhYrRVC0//fakJXxcF1VmMPsxnG6Ee8qEylA8b8Q3peQXWMNZ62lYF28g==",
+      "dependencies": {
+        "@fortawesome/fontawesome-common-types": "6.7.2"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/@fortawesome/free-solid-svg-icons": {
       "version": "6.7.2",
       "resolved": "https://registry.npmjs.org/@fortawesome/free-solid-svg-icons/-/free-solid-svg-icons-6.7.2.tgz",
@@ -9591,6 +9643,10 @@
         "node": ">=10"
       }
     },
+    "node_modules/@timesafari/daily-notification-plugin": {
+      "resolved": "../daily-notification-plugin",
+      "link": true
+    },
     "node_modules/@tootallnate/once": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/@tootallnate/once/-/once-2.0.0.tgz",
@@ -10147,6 +10203,12 @@
         "@types/geojson": "*"
       }
     },
+    "node_modules/@types/linkify-it": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/@types/linkify-it/-/linkify-it-5.0.0.tgz",
+      "integrity": "sha512-sVDA58zAw4eWAffKOaQH5/5j3XeayukzDk+ewSsnv3p4yJEZHCCzMDiZM8e0OUrRvmpGZ85jf4yDHkHsgBNr9Q==",
+      "dev": true
+    },
     "node_modules/@types/luxon": {
       "version": "3.7.1",
       "resolved": "https://registry.npmjs.org/@types/luxon/-/luxon-3.7.1.tgz",
@@ -10154,6 +10216,22 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/markdown-it": {
+      "version": "14.1.2",
+      "resolved": "https://registry.npmjs.org/@types/markdown-it/-/markdown-it-14.1.2.tgz",
+      "integrity": "sha512-promo4eFwuiW+TfGxhi+0x3czqTYJkG8qB17ZUJiVF10Xm7NLVRSLUsfRTU/6h1e24VvRnXCx+hG7li58lkzog==",
+      "dev": true,
+      "dependencies": {
+        "@types/linkify-it": "^5",
+        "@types/mdurl": "^2"
+      }
+    },
+    "node_modules/@types/mdurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/@types/mdurl/-/mdurl-2.0.0.tgz",
+      "integrity": "sha512-RGdgjQUZba5p6QEFAVx2OGb8rQDL/cPRG7GiedRzMcJ1tYnUANBncjbSB1NRGwbvjcPeikRABz2nshyPk1bhWg==",
+      "dev": true
+    },
     "node_modules/@types/minimist": {
       "version": "1.2.5",
       "resolved": "https://registry.npmjs.org/@types/minimist/-/minimist-1.2.5.tgz",
@@ -32883,6 +32961,61 @@
         "vue": "^3.0.0"
       }
     },
+    "node_modules/vue-markdown-render": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/vue-markdown-render/-/vue-markdown-render-2.2.1.tgz",
+      "integrity": "sha512-XkYnC0PMdbs6Vy6j/gZXSvCuOS0787Se5COwXlepRqiqPiunyCIeTPQAO2XnB4Yl04EOHXwLx5y6IuszMWSgyQ==",
+      "dependencies": {
+        "markdown-it": "^13.0.2"
+      },
+      "peerDependencies": {
+        "vue": "^3.3.4"
+      }
+    },
+    "node_modules/vue-markdown-render/node_modules/entities": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-3.0.1.tgz",
+      "integrity": "sha512-WiyBqoomrwMdFG1e0kqvASYfnlb0lp8M5o5Fw2OFq1hNZxxcNk8Ik0Xm7LxzBhuidnZB/UtBqVCgUz3kBOP51Q==",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/vue-markdown-render/node_modules/linkify-it": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/linkify-it/-/linkify-it-4.0.1.tgz",
+      "integrity": "sha512-C7bfi1UZmoj8+PQx22XyeXCuBlokoyWQL5pWSP+EI6nzRylyThouddufc2c1NDIcP9k5agmN9fLpA7VNJfIiqw==",
+      "dependencies": {
+        "uc.micro": "^1.0.1"
+      }
+    },
+    "node_modules/vue-markdown-render/node_modules/markdown-it": {
+      "version": "13.0.2",
+      "resolved": "https://registry.npmjs.org/markdown-it/-/markdown-it-13.0.2.tgz",
+      "integrity": "sha512-FtwnEuuK+2yVU7goGn/MJ0WBZMM9ZPgU9spqlFs7/A/pDIUNSOQZhUgOqYCficIuR2QaFnrt8LHqBWsbTAoI5w==",
+      "dependencies": {
+        "argparse": "^2.0.1",
+        "entities": "~3.0.1",
+        "linkify-it": "^4.0.1",
+        "mdurl": "^1.0.1",
+        "uc.micro": "^1.0.5"
+      },
+      "bin": {
+        "markdown-it": "bin/markdown-it.js"
+      }
+    },
+    "node_modules/vue-markdown-render/node_modules/mdurl": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/mdurl/-/mdurl-1.0.1.tgz",
+      "integrity": "sha512-/sKlQJCBYVY9Ers9hqzKou4H6V5UWc/M59TH2dvkt+84itfnq7uFOMLpOiOS4ujvHP4etln18fmIxA5R5fll0g=="
+    },
+    "node_modules/vue-markdown-render/node_modules/uc.micro": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/uc.micro/-/uc.micro-1.0.6.tgz",
+      "integrity": "sha512-8Y75pvTYkLJW2hWQHXxoqRgV7qb9B+9vFEtidML+7koHUFapnVJAZ6cKs+Qjz5Aw3aZWHMC6u0wJE3At+nSGwA=="
+    },
     "node_modules/vue-picture-cropper": {
       "version": "0.7.0",
       "resolved": "https://registry.npmjs.org/vue-picture-cropper/-/vue-picture-cropper-0.7.0.tgz",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "timesafari",
-  "version": "1.1.0-beta",
+  "version": "1.1.3-beta",
   "description": "Time Safari Application",
   "author": {
     "name": "Time Safari Team"
@@ -106,7 +106,7 @@
     "guard": "bash ./scripts/build-arch-guard.sh",
     "guard:test": "bash ./scripts/build-arch-guard.sh --staged",
     "guard:setup": "npm run prepare && echo '✅ Build Architecture Guard is now active!'",
-    "clean:android": "./scripts/clean-android.sh",
+    "clean:android": "./scripts/uninstall-android.sh",
     "clean:ios": "rm -rf ios/App/build ios/App/Pods ios/App/output ios/App/App/public ios/DerivedData ios/capacitor-cordova-ios-plugins ios/App/App/capacitor.config.json ios/App/App/config.xml || true",
     "clean:electron": "./scripts/build-electron.sh --clean",
     "clean:all": "npm run clean:ios && npm run clean:android && npm run clean:electron",
@@ -136,7 +136,6 @@
     "*.{js,ts,vue,css,json,yml,yaml}": "eslint --fix || true",
     "*.{md,markdown,mdc}": "markdownlint-cli2 --fix"
   },
-
   "dependencies": {
     "@capacitor-community/electron": "^5.0.1",
     "@capacitor-community/sqlite": "6.0.2",
@@ -157,6 +156,7 @@
     "@ethersproject/hdnode": "^5.7.0",
     "@ethersproject/wallet": "^5.8.0",
     "@fortawesome/fontawesome-svg-core": "^6.5.1",
+    "@fortawesome/free-regular-svg-icons": "^6.7.2",
     "@fortawesome/free-solid-svg-icons": "^6.5.1",
     "@fortawesome/vue-fontawesome": "^3.0.6",
     "@jlongster/sql.js": "^1.6.7",
@@ -166,6 +166,7 @@
     "@pvermeer/dexie-encrypted-addon": "^3.0.0",
     "@simplewebauthn/browser": "^10.0.0",
     "@simplewebauthn/server": "^10.0.0",
+    "@timesafari/daily-notification-plugin": "file:../daily-notification-plugin",
     "@tweenjs/tween.js": "^21.1.1",
     "@types/qrcode": "^1.5.5",
     "@veramo/core": "^5.6.0",
@@ -220,6 +221,7 @@
     "vue": "3.5.13",
     "vue-axios": "^3.5.2",
     "vue-facing-decorator": "3.0.4",
+    "vue-markdown-render": "^2.2.1",
     "vue-picture-cropper": "^0.7.0",
     "vue-qrcode-reader": "^5.5.3",
     "vue-router": "^4.5.0",
@@ -236,6 +238,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/leaflet": "^1.9.8",
     "@types/luxon": "^3.4.2",
+    "@types/markdown-it": "^14.1.2",
     "@types/node": "^20.14.11",
     "@types/node-fetch": "^2.6.12",
     "@types/ramda": "^0.29.11",

scripts/build-android.sh

@@ -22,6 +22,7 @@
 #   --sync                  Sync Capacitor only
 #   --assets                Generate assets only
 #   --deploy                Deploy APK to connected device
+#   --uninstall             Uninstall app from connected device
 #   -h, --help             Show this help message
 #   -v, --verbose          Enable verbose logging
 #
@@ -196,6 +197,7 @@ SYNC_ONLY=false
 ASSETS_ONLY=false
 DEPLOY_APP=false
 AUTO_RUN=false
+UNINSTALL=false
 CUSTOM_API_IP=""
 
 # Function to parse Android-specific arguments
@@ -246,6 +248,9 @@ parse_android_args() {
             --auto-run)
                 AUTO_RUN=true
                 ;;
+            --uninstall)
+                UNINSTALL=true
+                ;;
             --api-ip)
                 if [ $((i + 1)) -lt ${#args[@]} ]; then
                     CUSTOM_API_IP="${args[$((i + 1))]}"
@@ -291,6 +296,7 @@ print_android_usage() {
     echo "  --assets                Generate assets only"
     echo "  --deploy                Deploy APK to connected device"
     echo "  --auto-run              Auto-run app after build"
+    echo "  --uninstall             Uninstall app from connected device"
     echo "  --api-ip <ip>          Custom IP address for claim API (defaults to 10.0.2.2)"
     echo ""
     echo "Common Options:"
@@ -305,6 +311,7 @@ print_android_usage() {
     echo "  $0 --clean             # Clean only"
     echo "  $0 --sync              # Sync only"
     echo "  $0 --deploy            # Build and deploy to device"
+    echo "  $0 --uninstall         # Uninstall app from device"
     echo "  $0 --dev                    # Dev build with default 10.0.2.2"
     echo "  $0 --dev --api-ip 192.168.1.100  # Dev build with custom API IP"
     echo ""
@@ -351,8 +358,18 @@ fi
 # Setup application directories
 setup_app_directories
 
-# Load environment from .env file if it exists
-load_env_file ".env"
+# Load environment-specific .env file if it exists
+env_file=".env.$BUILD_MODE"
+if [ -f "$env_file" ]; then
+    load_env_file "$env_file"
+else
+    log_debug "No $env_file file found, using default environment"
+fi
+
+# Load .env file if it exists (fallback)
+if [ -f ".env" ]; then
+    load_env_file ".env"
+fi
 
 # Handle clean-only mode
 if [ "$CLEAN_ONLY" = true ]; then
@@ -407,14 +424,33 @@ safe_execute "Validating asset configuration" "npm run assets:validate" || {
     log_info "If you encounter build failures, please run 'npm install' first to ensure all dependencies are available."
 }
 
-# Step 2: Clean Android app
-safe_execute "Cleaning Android app" "npm run clean:android" || exit 1
+# Step 2: Uninstall Android app
+if [ "$UNINSTALL" = true ]; then
+    log_info "Uninstall: uninstalling app from device"
+    safe_execute "Uninstalling Android app" "./scripts/uninstall-android.sh" || exit 1
+    log_success "Uninstall completed successfully!"
+    exit 0
+fi
 
 # Step 3: Clean dist directory
 log_info "Cleaning dist directory..."
 clean_build_artifacts "dist"
 
-# Step 4: Build Capacitor version with mode
+# Step 4: Run TypeScript type checking for test and production builds
+if [ "$BUILD_MODE" = "production" ] || [ "$BUILD_MODE" = "test" ]; then
+    log_info "Running TypeScript type checking for $BUILD_MODE mode..."
+    
+    if ! measure_time npm run type-check; then
+        log_error "TypeScript type checking failed for $BUILD_MODE mode!"
+        exit 2
+    fi
+    
+    log_success "TypeScript type checking completed for $BUILD_MODE mode"
+else
+    log_debug "Skipping TypeScript type checking for development mode"
+fi
+
+# Step 5: Build Capacitor version with mode
 if [ "$BUILD_MODE" = "development" ]; then
     safe_execute "Building Capacitor version (development)" "npm run build:capacitor" || exit 3
 elif [ "$BUILD_MODE" = "test" ]; then
@@ -423,23 +459,23 @@ elif [ "$BUILD_MODE" = "production" ]; then
     safe_execute "Building Capacitor version (production)" "npm run build:capacitor -- --mode production" || exit 3
 fi
 
-# Step 5: Clean Gradle build
+# Step 6: Clean Gradle build
 safe_execute "Cleaning Gradle build" "cd android && ./gradlew clean && cd .." || exit 4
 
-# Step 6: Build based on type
+# Step 7: Build based on type
 if [ "$BUILD_TYPE" = "debug" ]; then
     safe_execute "Assembling debug build" "cd android && ./gradlew assembleDebug && cd .." || exit 5
 elif [ "$BUILD_TYPE" = "release" ]; then
     safe_execute "Assembling release build" "cd android && ./gradlew assembleRelease && cd .." || exit 5
 fi
 
-# Step 7: Sync with Capacitor
+# Step 8: Sync with Capacitor
 safe_execute "Syncing with Capacitor" "npx cap sync android" || exit 6
 
-# Step 8: Generate assets
+# Step 9: Generate assets
 safe_execute "Generating assets" "npx capacitor-assets generate --android" || exit 7
 
-# Step 9: Build APK/AAB if requested
+# Step 10: Build APK/AAB if requested
 if [ "$BUILD_APK" = true ]; then
     if [ "$BUILD_TYPE" = "debug" ]; then
         safe_execute "Building debug APK" "cd android && ./gradlew assembleDebug && cd .." || exit 5
@@ -452,7 +488,7 @@ if [ "$BUILD_AAB" = true ]; then
     safe_execute "Building AAB" "cd android && ./gradlew bundleRelease && cd .." || exit 5
 fi
 
-# Step 10: Auto-run app if requested
+# Step 11: Auto-run app if requested
 if [ "$AUTO_RUN" = true ]; then
     log_step "Auto-running Android app..."
     safe_execute "Launching app" "npx cap run android" || {
@@ -463,7 +499,7 @@ if [ "$AUTO_RUN" = true ]; then
     log_success "Android app launched successfully!"
 fi
 
-# Step 11: Open Android Studio if requested
+# Step 12: Open Android Studio if requested
 if [ "$OPEN_STUDIO" = true ]; then
     safe_execute "Opening Android Studio" "npx cap open android" || exit 8
 fi

scripts/build-electron.sh

@@ -341,7 +341,19 @@ main_electron_build() {
     # Setup environment
     setup_build_env "electron" "$BUILD_MODE"
     setup_app_directories
-    load_env_file ".env"
+    
+    # Load environment-specific .env file if it exists
+    env_file=".env.$BUILD_MODE"
+    if [ -f "$env_file" ]; then
+        load_env_file "$env_file"
+    else
+        log_debug "No $env_file file found, using default environment"
+    fi
+    
+    # Load .env file if it exists (fallback)
+    if [ -f ".env" ]; then
+        load_env_file ".env"
+    fi
     
     # Step 1: Clean Electron build artifacts
     clean_electron_artifacts

scripts/build-ios.sh

@@ -324,8 +324,18 @@ fi
 # Setup application directories
 setup_app_directories
 
-# Load environment from .env file if it exists
-load_env_file ".env"
+# Load environment-specific .env file if it exists
+env_file=".env.$BUILD_MODE"
+if [ -f "$env_file" ]; then
+    load_env_file "$env_file"
+else
+    log_debug "No $env_file file found, using default environment"
+fi
+
+# Load .env file if it exists (fallback)
+if [ -f ".env" ]; then
+    load_env_file ".env"
+fi
 
 # Validate iOS environment
 validate_ios_environment
@@ -371,7 +381,21 @@ safe_execute "Cleaning iOS build" "clean_ios_build" || exit 1
 log_info "Cleaning dist directory..."
 clean_build_artifacts "dist"
 
-# Step 4: Build Capacitor version with mode
+# Step 4: Run TypeScript type checking for test and production builds
+if [ "$BUILD_MODE" = "production" ] || [ "$BUILD_MODE" = "test" ]; then
+    log_info "Running TypeScript type checking for $BUILD_MODE mode..."
+    
+    if ! measure_time npm run type-check; then
+        log_error "TypeScript type checking failed for $BUILD_MODE mode!"
+        exit 2
+    fi
+    
+    log_success "TypeScript type checking completed for $BUILD_MODE mode"
+else
+    log_debug "Skipping TypeScript type checking for development mode"
+fi
+
+# Step 5: Build Capacitor version with mode
 if [ "$BUILD_MODE" = "development" ]; then
     safe_execute "Building Capacitor version (development)" "npm run build:capacitor" || exit 3
 elif [ "$BUILD_MODE" = "test" ]; then
@@ -380,16 +404,16 @@ elif [ "$BUILD_MODE" = "production" ]; then
     safe_execute "Building Capacitor version (production)" "npm run build:capacitor -- --mode production" || exit 3
 fi
 
-# Step 5: Sync with Capacitor
+# Step 6: Sync with Capacitor
 safe_execute "Syncing with Capacitor" "npx cap sync ios" || exit 6
 
-# Step 6: Generate assets
+# Step 7: Generate assets
 safe_execute "Generating assets" "npx capacitor-assets generate --ios" || exit 7
 
-# Step 7: Build iOS app
+# Step 8: Build iOS app
 safe_execute "Building iOS app" "build_ios_app" || exit 5
 
-# Step 8: Build IPA/App if requested
+# Step 9: Build IPA/App if requested
 if [ "$BUILD_IPA" = true ]; then
     log_info "Building IPA package..."
     cd ios/App
@@ -416,12 +440,12 @@ if [ "$BUILD_APP" = true ]; then
     log_success "App bundle built successfully"
 fi
 
-# Step 9: Auto-run app if requested
+# Step 10: Auto-run app if requested
 if [ "$AUTO_RUN" = true ]; then
     safe_execute "Auto-running iOS app" "auto_run_ios_app" || exit 9
 fi
 
-# Step 10: Open Xcode if requested
+# Step 11: Open Xcode if requested
 if [ "$OPEN_STUDIO" = true ]; then
     safe_execute "Opening Xcode" "npx cap open ios" || exit 8
 fi

scripts/diagnose-prefetch.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+#
+# Diagnostic script for daily notification prefetch issues
+# Filters logcat output for prefetch-related instrumentation logs
+#
+# Usage:
+#   ./scripts/diagnose-prefetch.sh [package_name]
+#
+# Example:
+#   ./scripts/diagnose-prefetch.sh app.timesafari.app
+#
+
+set -e
+
+PACKAGE_NAME="${1:-app.timesafari.app}"
+
+echo "🔍 Daily Notification Prefetch Diagnostic Tool"
+echo "=============================================="
+echo ""
+echo "Package: $PACKAGE_NAME"
+echo "Filtering for instrumentation tags:"
+echo "  - APP|ON_CREATE"
+echo "  - FETCHER|*"
+echo "  - PREFETCH|*"
+echo "  - DISPLAY|*"
+echo "  - STORAGE|*"
+echo ""
+echo "Press Ctrl+C to stop"
+echo ""
+
+# Filter logcat for instrumentation tags
+adb logcat -c  # Clear logcat buffer first
+
+adb logcat | grep -E "APP\|ON_CREATE|FETCHER\||PREFETCH\||DISPLAY\||STORAGE\||DailyNotification|TimeSafariApplication|TimeSafariNativeFetcher" | \
+  grep -i "$PACKAGE_NAME\|TimeSafari\|DailyNotification"
+

scripts/uninstall-android.sh

@@ -1,8 +1,8 @@
 #!/bin/bash
-# clean-android.sh
+# uninstall-android.sh
 # Author: Matthew Raymer
 # Date: 2025-08-19
-# Description: Clean Android app with timeout protection to prevent hanging
+# Description: Uninstall Android app with timeout protection to prevent hanging
 # This script safely uninstalls the TimeSafari app from connected Android devices
 # with a 30-second timeout to prevent indefinite hanging.
 

src/assets/styles/tailwind.css

@@ -7,6 +7,24 @@
     html {
         font-family: 'Work Sans', ui-sans-serif, system-ui, sans-serif !important;
     }
+    
+    /* Fix iOS viewport height changes when keyboard appears/disappears */
+    html, body {
+        height: 100%;
+        height: 100vh;
+        height: 100dvh; /* Dynamic viewport height for better mobile support */
+        overflow: hidden; /* Disable all scrolling on html and body */
+        position: fixed; /* Force fixed positioning to prevent viewport changes */
+        width: 100%;
+        top: 0;
+        left: 0;
+    }
+    
+    #app {
+        height: 100vh;
+        height: 100dvh;
+        overflow-y: auto;
+    }
 }
 
 @layer components {
@@ -20,6 +38,26 @@
 	}
 
 	.dialog {
-		@apply bg-white p-4 rounded-lg w-full max-w-lg;
+		@apply bg-white px-4 py-6 rounded-lg w-full max-w-lg max-h-[calc(100vh-3rem)] overflow-y-auto;
+	}
+
+	/* Markdown content styling to restore list elements */
+	.markdown-content ul {
+		@apply list-disc list-inside ml-4;
+	}
+
+	.markdown-content ol {
+		@apply list-decimal list-inside ml-4;
+	}
+
+	.markdown-content li {
+		@apply mb-1;
+	}
+
+	.markdown-content ul ul,
+	.markdown-content ol ol,
+	.markdown-content ul ol,
+	.markdown-content ol ul {
+		@apply ml-4 mt-1;
 	}
 }

src/components/ActivityListItem.vue

@@ -77,15 +77,95 @@
         </a>
       </div>
 
+      <!-- Emoji Section -->
+      <div
+        v-if="hasEmojis || isRegistered"
+        class="float-right ml-3 mb-1 bg-white rounded border border-slate-300 px-1.5 py-0.5 max-w-[240px]"
+      >
+        <div class="flex items-center justify-between gap-1">
+          <!-- Existing Emojis Display -->
+          <div v-if="hasEmojis" class="flex flex-wrap gap-1">
+            <button
+              v-for="(count, emoji) in record.emojiCount"
+              :key="emoji"
+              class="inline-flex items-center gap-0.5 px-1 py-0.5 text-xs bg-slate-50 hover:bg-slate-100 rounded border border-slate-200 transition-colors cursor-pointer"
+              :class="{
+                'bg-blue-50 border-blue-200': isUserEmojiWithoutLoading(emoji),
+                'opacity-75 cursor-wait': loadingEmojis,
+              }"
+              :title="
+                loadingEmojis
+                  ? 'Loading...'
+                  : !emojisOnActivity?.isResolved
+                    ? 'Click to load your emojis'
+                    : isUserEmojiWithoutLoading(emoji)
+                      ? 'Click to remove your emoji'
+                      : 'Click to add this emoji'
+              "
+              :disabled="!isRegistered"
+              @click="toggleThisEmoji(emoji)"
+            >
+              <!-- Show spinner when loading -->
+              <div v-if="loadingEmojis" class="animate-spin text-xs">
+                <font-awesome icon="spinner" class="fa-spin" />
+              </div>
+              <span v-else class="text-sm leading-none">{{ emoji }}</span>
+              <span class="text-xs text-slate-600 font-medium leading-none">{{
+                count
+              }}</span>
+            </button>
+          </div>
+
+          <!-- Add Emoji Button -->
+          <button
+            v-if="isRegistered"
+            class="inline-flex px-1 py-0.5 text-xs bg-slate-100 hover:bg-slate-200 rounded border border-slate-300 transition-colors items-center justify-center ml-2 ml-auto"
+            :title="showEmojiPicker ? 'Close emoji picker' : 'Add emoji'"
+            @click="toggleEmojiPicker"
+          >
+            <span class="px-2 text-sm leading-none">{{
+              showEmojiPicker ? "x" : "😊"
+            }}</span>
+          </button>
+        </div>
+
+        <!-- Emoji Picker (placeholder for now) -->
+        <div
+          v-if="showEmojiPicker"
+          class="mt-1 p-1.5 bg-slate-50 rounded border border-slate-300"
+        >
+          <!-- Temporary emoji buttons for testing -->
+          <div class="flex flex-wrap gap-3 mt-1">
+            <button
+              v-for="emoji in QUICK_EMOJIS"
+              :key="emoji"
+              class="p-0.5 hover:bg-slate-200 rounded text-base transition-opacity"
+              :class="{
+                'opacity-75 cursor-wait': loadingEmojis,
+              }"
+              :disabled="loadingEmojis"
+              @click="toggleThisEmoji(emoji)"
+            >
+              <!-- Show spinner when loading -->
+              <div v-if="loadingEmojis" class="animate-spin text-sm">⟳</div>
+              <span v-else>{{ emoji }}</span>
+            </button>
+          </div>
+        </div>
+      </div>
+
       <!-- Description -->
       <p class="font-medium">
-        <a class="cursor-pointer" @click="emitLoadClaim(record.jwtId)">
-          {{ description }}
+        <a class="block cursor-pointer" @click="emitLoadClaim(record.jwtId)">
+          <vue-markdown
+            :source="truncatedDescription"
+            class="markdown-content"
+          />
         </a>
       </p>
 
       <div
-        class="relative flex justify-between gap-4 max-w-[40rem] mx-auto mt-4"
+        class="clear-right relative flex justify-between gap-4 max-w-[40rem] mx-auto mt-4"
       >
         <!-- Source -->
         <div
@@ -248,33 +328,51 @@
 
 <script lang="ts">
 import { Component, Prop, Vue, Emit } from "vue-facing-decorator";
-import { GiveRecordWithContactInfo } from "@/interfaces/give";
+import VueMarkdown from "vue-markdown-render";
+
+import { logger } from "../utils/logger";
+import {
+  createAndSubmitClaim,
+  getHeaders,
+  isHiddenDid,
+} from "../libs/endorserServer";
 import EntityIcon from "./EntityIcon.vue";
-import { isHiddenDid } from "../libs/endorserServer";
 import ProjectIcon from "./ProjectIcon.vue";
-import { createNotifyHelpers, NotifyFunction } from "@/utils/notify";
+import { createNotifyHelpers, NotifyFunction, TIMEOUTS } from "@/utils/notify";
 import {
   NOTIFY_PERSON_HIDDEN,
   NOTIFY_UNKNOWN_PERSON,
 } from "@/constants/notifications";
-import { TIMEOUTS } from "@/utils/notify";
+import { EmojiSummaryRecord, GenericVerifiableCredential } from "@/interfaces";
+import { GiveRecordWithContactInfo } from "@/interfaces/give";
+import { PromiseTracker } from "@/libs/util";
 
 @Component({
   components: {
     EntityIcon,
     ProjectIcon,
+    VueMarkdown,
   },
 })
 export default class ActivityListItem extends Vue {
+  readonly QUICK_EMOJIS = ["👍", "👏", "❤️", "🎉", "😊", "😆", "🔥"];
+
   @Prop() record!: GiveRecordWithContactInfo;
   @Prop() lastViewedClaimId?: string;
   @Prop() isRegistered!: boolean;
   @Prop() activeDid!: string;
+  @Prop() apiServer!: string;
 
   isHiddenDid = isHiddenDid;
   notify!: ReturnType<typeof createNotifyHelpers>;
   $notify!: NotifyFunction;
 
+  // Emoji-related data
+  showEmojiPicker = false;
+  loadingEmojis = false; // Track if emojis are currently loading
+
+  emojisOnActivity: PromiseTracker<EmojiSummaryRecord[]> | null = null; // load this only when needed
+
   created() {
     this.notify = createNotifyHelpers(this.$notify);
   }
@@ -303,6 +401,14 @@ export default class ActivityListItem extends Vue {
     return `${claim?.description || ""}`;
   }
 
+  get truncatedDescription(): string {
+    const desc = this.description;
+    if (desc.length <= 300) {
+      return desc;
+    }
+    return desc.substring(0, 300) + "...";
+  }
+
   private displayAmount(code: string, amt: number) {
     return `${amt} ${this.currencyShortWordForCode(code, amt === 1)}`;
   }
@@ -330,5 +436,186 @@ export default class ActivityListItem extends Vue {
       day: "numeric",
     });
   }
+
+  // Emoji-related computed properties and methods
+  get hasEmojis(): boolean {
+    return Object.keys(this.record.emojiCount).length > 0;
+  }
+
+  triggerUserEmojiLoad(): PromiseTracker<EmojiSummaryRecord[]> {
+    if (!this.emojisOnActivity) {
+      const promise = new Promise<EmojiSummaryRecord[]>((resolve) => {
+        (async () => {
+          this.axios
+            .get(
+              `${this.apiServer}/api/v2/report/emoji?parentHandleId=${encodeURIComponent(this.record.handleId)}`,
+              { headers: await getHeaders(this.activeDid) },
+            )
+            .then((response) => {
+              const userEmojiRecords = response.data.data.filter(
+                (e: EmojiSummaryRecord) => e.issuerDid === this.activeDid,
+              );
+              resolve(userEmojiRecords);
+            })
+            .catch((error) => {
+              logger.error("Error loading user emojis:", error);
+              resolve([]);
+            });
+        })();
+      });
+
+      this.emojisOnActivity = new PromiseTracker(promise);
+    }
+    return this.emojisOnActivity;
+  }
+
+  /**
+   *
+   * @param emoji - The emoji to check.
+   * @returns True if the emoji is in the user's emojis, false otherwise.
+   *
+   * @note This method is quick and synchronous, and can check resolved emojis
+   * without triggering a server request. Returns false if emojis haven't been loaded yet.
+   */
+  isUserEmojiWithoutLoading(emoji: string): boolean {
+    if (this.emojisOnActivity?.isResolved && this.emojisOnActivity.value) {
+      return this.emojisOnActivity.value.some(
+        (record) => record.text === emoji,
+      );
+    }
+    return false;
+  }
+
+  async toggleEmojiPicker() {
+    this.triggerUserEmojiLoad(); // trigger it, but don't wait for it to complete
+    this.showEmojiPicker = !this.showEmojiPicker;
+  }
+
+  async toggleThisEmoji(emoji: string) {
+    // Start loading indicator
+    this.loadingEmojis = true;
+    this.showEmojiPicker = false; // always close the picker when an emoji is clicked
+
+    try {
+      this.triggerUserEmojiLoad(); // trigger just in case
+
+      const userEmojiList = await this.emojisOnActivity!.promise; // must wait now that they've chosen
+
+      const userHasEmoji: boolean = userEmojiList.some(
+        (record) => record.text === emoji,
+      );
+
+      if (userHasEmoji) {
+        this.$notify(
+          {
+            group: "modal",
+            type: "confirm",
+            title: "Remove Emoji",
+            text: `Do you want to remove your ${emoji} ?`,
+            yesText: "Remove",
+            onYes: async () => {
+              await this.removeEmoji(emoji);
+            },
+          },
+          TIMEOUTS.MODAL,
+        );
+      } else {
+        // User doesn't have this emoji, add it
+        await this.submitEmoji(emoji);
+      }
+    } finally {
+      // Remove loading indicator
+      this.loadingEmojis = false;
+    }
+  }
+
+  async submitEmoji(emoji: string) {
+    try {
+      // Create an Emoji claim and send to the server
+      const emojiClaim: GenericVerifiableCredential = {
+        "@context": "https://endorser.ch",
+        "@type": "Emoji",
+        text: emoji,
+        parentItem: { lastClaimId: this.record.jwtId },
+      };
+      const claim = await createAndSubmitClaim(
+        emojiClaim,
+        this.activeDid,
+        this.apiServer,
+        this.axios,
+      );
+      if (claim.success && !claim.embeddedRecordError) {
+        // Update emoji count
+        this.record.emojiCount[emoji] =
+          (this.record.emojiCount[emoji] || 0) + 1;
+
+        // Create a new emoji record (we'll get the actual jwtId from the server response later)
+        const newEmojiRecord: EmojiSummaryRecord = {
+          issuerDid: this.activeDid,
+          jwtId: claim.claimId || "",
+          text: emoji,
+          parentHandleId: this.record.jwtId,
+        };
+
+        // Update user emojis list by creating a new promise with the updated data
+        // (Trigger shouldn't be necessary since all calls should come through a toggle, but just in case someone calls this directly)
+        this.triggerUserEmojiLoad();
+        const currentEmojis = await this.emojisOnActivity!.promise; // must wait now that they've clicked one
+        this.emojisOnActivity = new PromiseTracker(
+          Promise.resolve([...currentEmojis, newEmojiRecord]),
+        );
+      } else {
+        this.notify.error("Failed to add emoji.", TIMEOUTS.STANDARD);
+      }
+    } catch (error) {
+      logger.error("Error submitting emoji:", error);
+      this.notify.error("Got error adding emoji.", TIMEOUTS.STANDARD);
+    }
+  }
+
+  async removeEmoji(emoji: string) {
+    try {
+      // Create an Emoji claim and send to the server
+      const emojiClaim: GenericVerifiableCredential = {
+        "@context": "https://endorser.ch",
+        "@type": "Emoji",
+        text: emoji,
+        parentItem: { lastClaimId: this.record.jwtId },
+      };
+      const claim = await createAndSubmitClaim(
+        emojiClaim,
+        this.activeDid,
+        this.apiServer,
+        this.axios,
+      );
+      if (claim.success && !claim.embeddedRecordError) {
+        // Update emoji count
+        const newCount = Math.max(0, (this.record.emojiCount[emoji] || 0) - 1);
+        if (newCount === 0) {
+          delete this.record.emojiCount[emoji];
+        } else {
+          this.record.emojiCount[emoji] = newCount;
+        }
+
+        // Update user emojis list by creating a new promise with the updated data
+        // (Trigger shouldn't be necessary since all calls should come through a toggle, but just in case someone calls this directly)
+        this.triggerUserEmojiLoad();
+        const currentEmojis = await this.emojisOnActivity!.promise; // must wait now that they've clicked one
+        this.emojisOnActivity = new PromiseTracker(
+          Promise.resolve(
+            currentEmojis.filter(
+              (record) =>
+                record.issuerDid === this.activeDid && record.text !== emoji,
+            ),
+          ),
+        );
+      } else {
+        this.notify.error("Failed to remove emoji.", TIMEOUTS.STANDARD);
+      }
+    } catch (error) {
+      logger.error("Error removing emoji:", error);
+      this.notify.error("Got error removing emoji.", TIMEOUTS.STANDARD);
+    }
+  }
 }
 </script>

src/components/BulkMembersDialog.vue

@@ -0,0 +1,465 @@
+<template>
+  <div v-if="visible" class="dialog-overlay">
+    <div class="dialog">
+      <div class="text-slate-900 text-center">
+        <h3 class="text-lg font-semibold leading-[1.25] mb-2">
+          {{ title }}
+        </h3>
+        <p class="text-sm mb-4">
+          {{ description }}
+        </p>
+
+        <!-- Member Selection Table -->
+        <div class="mb-4">
+          <table
+            class="w-full border-collapse border border-slate-300 text-sm text-start"
+          >
+            <!-- Select All Header -->
+            <thead v-if="membersData && membersData.length > 0">
+              <tr class="bg-slate-100 font-medium">
+                <th class="border border-slate-300 px-3 py-2">
+                  <label class="flex items-center gap-2">
+                    <input
+                      type="checkbox"
+                      :checked="isAllSelected"
+                      :indeterminate="isIndeterminate"
+                      @change="toggleSelectAll"
+                    />
+                    Select All
+                  </label>
+                </th>
+              </tr>
+            </thead>
+            <tbody>
+              <!-- Empty State -->
+              <tr v-if="!membersData || membersData.length === 0">
+                <td
+                  class="border border-slate-300 px-3 py-2 text-center italic text-gray-500"
+                >
+                  {{ emptyStateText }}
+                </td>
+              </tr>
+              <!-- Member Rows -->
+              <tr
+                v-for="member in membersData || []"
+                :key="member.member.memberId"
+              >
+                <td class="border border-slate-300 px-3 py-2">
+                  <div class="flex items-center justify-between gap-2">
+                    <label class="flex items-center gap-2">
+                      <input
+                        type="checkbox"
+                        :checked="isMemberSelected(member.did)"
+                        @change="toggleMemberSelection(member.did)"
+                      />
+                      <div class="">
+                        <div class="text-sm font-semibold">
+                          {{ member.name || SOMEONE_UNNAMED }}
+                        </div>
+                        <div
+                          class="flex items-center gap-0.5 text-xs text-slate-500"
+                        >
+                          <span class="font-semibold sm:hidden">DID:</span>
+                          <span
+                            class="w-[35vw] sm:w-auto truncate text-left"
+                            style="direction: rtl"
+                            >{{ member.did }}</span
+                          >
+                        </div>
+                      </div>
+                    </label>
+
+                    <!-- Contact indicator - only show if they are already a contact -->
+                    <font-awesome
+                      v-if="member.isContact"
+                      icon="user-circle"
+                      class="fa-fw ms-auto text-slate-400 cursor-pointer hover:text-slate-600"
+                      @click="showContactInfo"
+                    />
+                  </div>
+                </td>
+              </tr>
+            </tbody>
+            <!-- Select All Footer -->
+            <tfoot v-if="membersData && membersData.length > 0">
+              <tr class="bg-slate-100 font-medium">
+                <th class="border border-slate-300 px-3 py-2">
+                  <label class="flex items-center gap-2">
+                    <input
+                      type="checkbox"
+                      :checked="isAllSelected"
+                      :indeterminate="isIndeterminate"
+                      @change="toggleSelectAll"
+                    />
+                    Select All
+                  </label>
+                </th>
+              </tr>
+            </tfoot>
+          </table>
+        </div>
+
+        <!-- Action Buttons -->
+        <div class="space-y-2">
+          <!-- Main Action Button -->
+          <button
+            v-if="membersData && membersData.length > 0"
+            :disabled="!hasSelectedMembers"
+            :class="[
+              'block w-full text-center text-md font-bold uppercase px-2 py-2 rounded-md',
+              hasSelectedMembers
+                ? 'bg-blue-600 text-white cursor-pointer'
+                : 'bg-slate-400 text-slate-200 cursor-not-allowed',
+            ]"
+            @click="processSelectedMembers"
+          >
+            {{ buttonText }}
+          </button>
+          <!-- Cancel Button -->
+          <button
+            class="block w-full text-center text-md font-bold uppercase bg-slate-600 text-white px-2 py-2 rounded-md"
+            @click="cancel"
+          >
+            Maybe Later
+          </button>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script lang="ts">
+import { Vue, Component, Prop } from "vue-facing-decorator";
+
+import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
+import { SOMEONE_UNNAMED } from "@/constants/entities";
+import { MemberData } from "@/interfaces";
+import { setVisibilityUtil, getHeaders, register } from "@/libs/endorserServer";
+import { createNotifyHelpers } from "@/utils/notify";
+import { Contact } from "@/db/tables/contacts";
+
+@Component({
+  mixins: [PlatformServiceMixin],
+  emits: ["close"],
+})
+export default class BulkMembersDialog extends Vue {
+  @Prop({ default: "" }) activeDid!: string;
+  @Prop({ default: "" }) apiServer!: string;
+  // isOrganizer: true = organizer mode (admit members), false = member mode (set visibility)
+  @Prop({ required: true }) isOrganizer!: boolean;
+
+  // Vue notification system
+  $notify!: (
+    notification: { group: string; type: string; title: string; text: string },
+    timeout?: number,
+  ) => void;
+
+  // Notification system
+  notify!: ReturnType<typeof createNotifyHelpers>;
+
+  // Component state
+  membersData: MemberData[] = [];
+  selectedMembers: string[] = [];
+  visible = false;
+
+  // Constants
+  // In Vue templates, imported constants need to be explicitly made available to the template
+  readonly SOMEONE_UNNAMED = SOMEONE_UNNAMED;
+
+  get hasSelectedMembers() {
+    return this.selectedMembers.length > 0;
+  }
+
+  get isAllSelected() {
+    if (!this.membersData || this.membersData.length === 0) return false;
+    return this.membersData.every((member) =>
+      this.selectedMembers.includes(member.did),
+    );
+  }
+
+  get isIndeterminate() {
+    if (!this.membersData || this.membersData.length === 0) return false;
+    const selectedCount = this.membersData.filter((member) =>
+      this.selectedMembers.includes(member.did),
+    ).length;
+    return selectedCount > 0 && selectedCount < this.membersData.length;
+  }
+
+  get title() {
+    return this.isOrganizer
+      ? "Admit Pending Members"
+      : "Add Members to Contacts";
+  }
+
+  get description() {
+    return this.isOrganizer
+      ? "Would you like to admit these members to the meeting and add them to your contacts?"
+      : "Would you like to add these members to your contacts?";
+  }
+
+  get buttonText() {
+    return this.isOrganizer ? "Admit + Add to Contacts" : "Add to Contacts";
+  }
+
+  get emptyStateText() {
+    return this.isOrganizer
+      ? "No pending members to admit"
+      : "No members are not in your contacts";
+  }
+
+  created() {
+    this.notify = createNotifyHelpers(this.$notify);
+  }
+
+  open(members: MemberData[]) {
+    this.visible = true;
+    this.membersData = members;
+    // Select all by default
+    this.selectedMembers = this.membersData.map((member) => member.did);
+  }
+
+  close(notSelectedMemberDids: string[]) {
+    this.visible = false;
+    this.$emit("close", { notSelectedMemberDids: notSelectedMemberDids });
+  }
+
+  cancel() {
+    this.close(this.membersData.map((member) => member.did));
+  }
+
+  toggleSelectAll() {
+    if (!this.membersData || this.membersData.length === 0) return;
+
+    if (this.isAllSelected) {
+      // Deselect all
+      this.selectedMembers = [];
+    } else {
+      // Select all
+      this.selectedMembers = this.membersData.map((member) => member.did);
+    }
+  }
+
+  toggleMemberSelection(memberDid: string) {
+    const index = this.selectedMembers.indexOf(memberDid);
+    if (index > -1) {
+      this.selectedMembers.splice(index, 1);
+    } else {
+      this.selectedMembers.push(memberDid);
+    }
+  }
+
+  isMemberSelected(memberDid: string) {
+    return this.selectedMembers.includes(memberDid);
+  }
+
+  async processSelectedMembers() {
+    try {
+      const selectedMembers: MemberData[] = this.membersData.filter((member) =>
+        this.selectedMembers.includes(member.did),
+      );
+      const notSelectedMembers: MemberData[] = this.membersData.filter(
+        (member) => !this.selectedMembers.includes(member.did),
+      );
+
+      let admittedCount = 0;
+      let contactAddedCount = 0;
+      let errors = 0;
+
+      for (const member of selectedMembers) {
+        try {
+          // Organizer mode: admit and register the member first
+          if (this.isOrganizer) {
+            await this.admitMember(member);
+            await this.registerMember(member);
+            admittedCount++;
+          }
+
+          // If they're not a contact yet, add them as a contact
+          if (!member.isContact) {
+            // Organizer mode: set isRegistered to true, member mode: undefined
+            await this.addAsContact(
+              member,
+              this.isOrganizer ? true : undefined,
+            );
+            contactAddedCount++;
+          }
+
+          // Set their seesMe to true
+          await this.updateContactVisibility(member.did, true);
+        } catch (error) {
+          // eslint-disable-next-line no-console
+          console.error(`Error processing member ${member.did}:`, error);
+          // Continue with other members even if one fails
+          errors++;
+        }
+      }
+
+      // Show success notification
+      if (this.isOrganizer) {
+        if (admittedCount > 0) {
+          this.$notify(
+            {
+              group: "alert",
+              type: "success",
+              title: "Members Admitted Successfully",
+              text: `${admittedCount} member${admittedCount === 1 ? "" : "s"} admitted and registered${contactAddedCount === 0 ? "" : admittedCount === contactAddedCount ? " and" : `, ${contactAddedCount}`}${contactAddedCount === 0 ? "" : ` added as contact${contactAddedCount === 1 ? "" : "s"}`}.`,
+            },
+            5000,
+          );
+        }
+        if (errors > 0) {
+          this.$notify(
+            {
+              group: "alert",
+              type: "danger",
+              title: "Error",
+              text: "Failed to fully admit some members. Work with them individually below.",
+            },
+            5000,
+          );
+        }
+      } else {
+        // Member mode: show contacts added notification
+        if (contactAddedCount > 0) {
+          this.$notify(
+            {
+              group: "alert",
+              type: "success",
+              title: "Contacts Added Successfully",
+              text: `${contactAddedCount} member${contactAddedCount === 1 ? "" : "s"} added as contact${contactAddedCount === 1 ? "" : "s"}.`,
+            },
+            5000,
+          );
+        }
+      }
+
+      this.close(notSelectedMembers.map((member) => member.did));
+    } catch (error) {
+      // eslint-disable-next-line no-console
+      console.error(
+        `Error ${this.isOrganizer ? "admitting members" : "adding contacts"}:`,
+        error,
+      );
+      this.$notify(
+        {
+          group: "alert",
+          type: "danger",
+          title: "Error",
+          text: "Some errors occurred. Work with members individually below.",
+        },
+        5000,
+      );
+    }
+  }
+
+  async admitMember(member: {
+    did: string;
+    name: string;
+    member: { memberId: string };
+  }) {
+    try {
+      const headers = await getHeaders(this.activeDid);
+      await this.axios.put(
+        `${this.apiServer}/api/partner/groupOnboardMember/${member.member.memberId}`,
+        { admitted: true },
+        { headers },
+      );
+    } catch (err) {
+      // eslint-disable-next-line no-console
+      console.error("Error admitting member:", err);
+      throw err;
+    }
+  }
+
+  async registerMember(member: MemberData) {
+    try {
+      const contact: Contact = { did: member.did };
+      const result = await register(
+        this.activeDid,
+        this.apiServer,
+        this.axios,
+        contact,
+      );
+      if (result.success) {
+        if (result.embeddedRecordError) {
+          throw new Error(result.embeddedRecordError);
+        }
+        await this.$updateContact(member.did, { registered: true });
+      } else {
+        throw result;
+      }
+    } catch (err) {
+      // eslint-disable-next-line no-console
+      console.error("Error registering member:", err);
+      throw err;
+    }
+  }
+
+  async addAsContact(
+    member: { did: string; name: string },
+    isRegistered?: boolean,
+  ) {
+    try {
+      const newContact: Contact = {
+        did: member.did,
+        name: member.name,
+        registered: isRegistered,
+      };
+
+      await this.$insertContact(newContact);
+    } catch (err) {
+      // eslint-disable-next-line no-console
+      console.error("Error adding contact:", err);
+      if (err instanceof Error && err.message?.indexOf("already exists") > -1) {
+        // Contact already exists, continue
+      } else {
+        throw err; // Re-throw if it's not a duplicate error
+      }
+    }
+  }
+
+  async updateContactVisibility(did: string, seesMe: boolean) {
+    try {
+      // Get the contact object
+      const contact = await this.$getContact(did);
+      if (!contact) {
+        throw new Error(`Contact not found for DID: ${did}`);
+      }
+
+      // Use the proper API to set visibility on the server
+      const result = await setVisibilityUtil(
+        this.activeDid,
+        this.apiServer,
+        this.axios,
+        contact,
+        seesMe,
+      );
+
+      if (!result.success) {
+        throw new Error(result.error || "Failed to set visibility");
+      }
+    } catch (err) {
+      // eslint-disable-next-line no-console
+      console.error("Error updating contact visibility:", err);
+      throw err;
+    }
+  }
+
+  showContactInfo() {
+    // isOrganizer: true = admit mode, false = visibility mode
+    const message = this.isOrganizer
+      ? "This user is already your contact, but they are not yet admitted to the meeting."
+      : "This user is already your contact, but your activities are not visible to them yet.";
+
+    this.$notify(
+      {
+        group: "alert",
+        type: "info",
+        title: "Contact Info",
+        text: message,
+      },
+      5000,
+    );
+  }
+}
+</script>

src/components/ContactListItem.vue

@@ -46,7 +46,7 @@
 
             <span class="text-xs truncate">{{ contact.did }}</span>
           </div>
-          <div class="text-sm">
+          <div class="text-sm truncate">
             {{ contact.notes }}
           </div>
         </div>

src/components/DataExportSection.vue

@@ -18,7 +18,7 @@ messages * - Conditional UI based on platform capabilities * * @component *
     >
       <!-- Notification dot - show while the user has not yet backed up their seed phrase -->
       <font-awesome
-        v-if="!hasBackedUpSeed"
+        v-if="showRedNotificationDot"
         icon="circle"
         class="absolute -right-[8px] -top-[8px] text-rose-500 text-[14px] border border-white rounded-full"
       ></font-awesome>
@@ -108,7 +108,7 @@ export default class DataExportSection extends Vue {
    * Flag indicating if the user has backed up their seed phrase
    * Used to control the visibility of the notification dot
    */
-  hasBackedUpSeed = false;
+  showRedNotificationDot = false;
 
   /**
    * Notification helper for consistent notification patterns
@@ -240,11 +240,12 @@ export default class DataExportSection extends Vue {
   private async loadSeedBackupStatus(): Promise<void> {
     try {
       const settings = await this.$accountSettings();
-      this.hasBackedUpSeed = !!settings.hasBackedUpSeed;
+      this.showRedNotificationDot =
+        !!settings.isRegistered && !settings.hasBackedUpSeed;
     } catch (err: unknown) {
       logger.error("Failed to load seed backup status:", err);
       // Default to false (show notification dot) if we can't load the setting
-      this.hasBackedUpSeed = false;
+      this.showRedNotificationDot = false;
     }
   }
 }

src/components/EntityGrid.vue

@@ -2,12 +2,55 @@
 GiftedDialog.vue to provide a reusable grid layout * for displaying people,
 projects, and special entities with selection. * * @author Matthew Raymer */
 <template>
-  <ul :class="gridClasses">
+  <!-- Quick Search -->
+  <div id="QuickSearch" class="mb-4 flex items-center text-sm">
+    <input
+      v-model="searchTerm"
+      type="text"
+      placeholder="Search…"
+      class="block w-full rounded-l border border-r-0 border-slate-400 px-3 py-1.5 placeholder:italic placeholder:text-slate-400 focus:outline-none"
+      @input="handleSearchInput"
+      @keydown.enter="performSearch"
+    />
+    <div
+      v-show="isSearching && searchTerm"
+      class="border-y border-slate-400 ps-2 py-1.5 text-center text-slate-400"
+    >
+      <font-awesome
+        icon="spinner"
+        class="fa-spin-pulse leading-[1.1]"
+      ></font-awesome>
+    </div>
+    <button
+      :disabled="!searchTerm"
+      class="px-2 py-1.5 rounded-r bg-white border border-l-0 border-slate-400 text-slate-400 disabled:cursor-not-allowed"
+      @click="clearSearch"
+    >
+      <font-awesome
+        :icon="searchTerm ? 'times' : 'magnifying-glass'"
+        class="fa-fw"
+      ></font-awesome>
+    </button>
+  </div>
+
+  <div
+    v-if="searchTerm && !isSearching && filteredEntities.length === 0"
+    class="mb-4 text-sm italic text-slate-500 text-center"
+  >
+    “{{ searchTerm }}” doesn't match any
+    {{ entityType === "people" ? "people" : "projects" }}. Try a different
+    search.
+  </div>
+
+  <ul
+    ref="scrollContainer"
+    class="border-t border-slate-300 mb-4 max-h-[60vh] overflow-y-auto"
+  >
     <!-- Special entities (You, Unnamed) for people grids -->
     <template v-if="entityType === 'people'">
       <!-- "You" entity -->
       <SpecialEntityCard
-        v-if="showYouEntity"
+        v-if="showYouEntity && !searchTerm.trim()"
         entity-type="you"
         label="You"
         icon="hand"
@@ -21,6 +64,7 @@ projects, and special entities with selection. * * @author Matthew Raymer */
 
       <!-- "Unnamed" entity -->
       <SpecialEntityCard
+        v-if="showUnnamedEntity && !searchTerm.trim()"
         entity-type="unnamed"
         :label="unnamedEntityName"
         icon="circle-question"
@@ -38,16 +82,60 @@ projects, and special entities with selection. * * @author Matthew Raymer */
 
     <!-- Entity cards (people or projects) -->
     <template v-if="entityType === 'people'">
-      <PersonCard
-        v-for="person in displayedEntities as Contact[]"
-        :key="person.did"
-        :person="person"
-        :conflicted="isPersonConflicted(person.did)"
-        :show-time-icon="true"
-        :notify="notify"
-        :conflict-context="conflictContext"
-        @person-selected="handlePersonSelected"
-      />
+      <!-- When showing contacts without search: split into recent and alphabetical -->
+      <template v-if="!searchTerm.trim()">
+        <!-- Recently Added Section -->
+        <template v-if="recentContacts.length > 0">
+          <li
+            class="text-xs font-semibold text-slate-500 uppercase pt-5 pb-1.5 px-2 border-b border-slate-300"
+          >
+            Recently Added
+          </li>
+          <PersonCard
+            v-for="person in recentContacts"
+            :key="person.did"
+            :person="person"
+            :conflicted="isPersonConflicted(person.did)"
+            :show-time-icon="true"
+            :notify="notify"
+            :conflict-context="conflictContext"
+            @person-selected="handlePersonSelected"
+          />
+        </template>
+
+        <!-- Alphabetical Section -->
+        <template v-if="alphabeticalContacts.length > 0">
+          <li
+            class="text-xs font-semibold text-slate-500 uppercase pt-5 pb-1.5 px-2 border-b border-slate-300"
+          >
+            Everyone Else
+          </li>
+          <PersonCard
+            v-for="person in alphabeticalContacts"
+            :key="person.did"
+            :person="person"
+            :conflicted="isPersonConflicted(person.did)"
+            :show-time-icon="true"
+            :notify="notify"
+            :conflict-context="conflictContext"
+            @person-selected="handlePersonSelected"
+          />
+        </template>
+      </template>
+
+      <!-- When searching: show filtered results normally -->
+      <template v-else>
+        <PersonCard
+          v-for="person in displayedEntities as Contact[]"
+          :key="person.did"
+          :person="person"
+          :conflicted="isPersonConflicted(person.did)"
+          :show-time-icon="true"
+          :notify="notify"
+          :conflict-context="conflictContext"
+          @person-selected="handlePersonSelected"
+        />
+      </template>
     </template>
 
     <template v-else-if="entityType === 'projects'">
@@ -63,28 +151,27 @@ projects, and special entities with selection. * * @author Matthew Raymer */
         @project-selected="handleProjectSelected"
       />
     </template>
-
-    <!-- Show All navigation -->
-    <ShowAllCard
-      v-if="shouldShowAll"
-      :entity-type="entityType"
-      :route-name="showAllRoute"
-      :query-params="showAllQueryParams"
-    />
   </ul>
 </template>
 
 <script lang="ts">
-import { Component, Prop, Vue, Emit } from "vue-facing-decorator";
+import { Component, Prop, Vue, Emit, Watch } from "vue-facing-decorator";
+import { useInfiniteScroll } from "@vueuse/core";
 import PersonCard from "./PersonCard.vue";
 import ProjectCard from "./ProjectCard.vue";
 import SpecialEntityCard from "./SpecialEntityCard.vue";
-import ShowAllCard from "./ShowAllCard.vue";
 import { Contact } from "../db/tables/contacts";
 import { PlanData } from "../interfaces/records";
 import { NotificationIface } from "../constants/app";
 import { UNNAMED_ENTITY_NAME } from "@/constants/entities";
 
+/**
+ * Constants for infinite scroll configuration
+ */
+const INITIAL_BATCH_SIZE = 20;
+const INCREMENT_SIZE = 20;
+const RECENT_CONTACTS_COUNT = 3;
+
 /**
  * EntityGrid - Unified grid layout for displaying people or projects
  *
@@ -93,7 +180,6 @@ import { UNNAMED_ENTITY_NAME } from "@/constants/entities";
  * - Special entity integration (You, Unnamed)
  * - Conflict detection integration
  * - Empty state messaging
- * - Show All navigation
  * - Event delegation for entity selection
  * - Warning notifications for conflicted entities
  * - Template streamlined with computed CSS properties
@@ -104,7 +190,6 @@ import { UNNAMED_ENTITY_NAME } from "@/constants/entities";
     PersonCard,
     ProjectCard,
     SpecialEntityCard,
-    ShowAllCard,
   },
 })
 export default class EntityGrid extends Vue {
@@ -112,14 +197,21 @@ export default class EntityGrid extends Vue {
   @Prop({ required: true })
   entityType!: "people" | "projects";
 
+  // Search state
+  searchTerm = "";
+  isSearching = false;
+  searchTimeout: NodeJS.Timeout | null = null;
+  filteredEntities: Contact[] | PlanData[] = [];
+
+  // Infinite scroll state
+  displayedCount = INITIAL_BATCH_SIZE;
+  infiniteScrollReset?: () => void;
+  scrollContainer?: HTMLElement;
+
   /** Array of entities to display */
   @Prop({ required: true })
   entities!: Contact[] | PlanData[];
 
-  /** Maximum number of entities to display */
-  @Prop({ default: 10 })
-  maxItems!: number;
-
   /** Active user's DID */
   @Prop({ required: true })
   activeDid!: string;
@@ -140,18 +232,14 @@ export default class EntityGrid extends Vue {
   @Prop({ default: true })
   showYouEntity!: boolean;
 
+  /** Whether to show the "Unnamed" entity for people grids */
+  @Prop({ default: true })
+  showUnnamedEntity!: boolean;
+
   /** Whether the "You" entity is selectable */
   @Prop({ default: true })
   youSelectable!: boolean;
 
-  /** Route name for "Show All" navigation */
-  @Prop({ default: "" })
-  showAllRoute!: string;
-
-  /** Query parameters for "Show All" navigation */
-  @Prop({ default: () => ({}) })
-  showAllQueryParams!: Record<string, string>;
-
   /** Notification function from parent component */
   @Prop()
   notify?: (notification: NotificationIface, timeout?: number) => void;
@@ -160,42 +248,31 @@ export default class EntityGrid extends Vue {
   @Prop({ default: "other party" })
   conflictContext!: string;
 
-  /** Whether to hide the "Show All" navigation */
-  @Prop({ default: false })
-  hideShowAll!: boolean;
-
   /**
    * Function to determine which entities to display (allows parent control)
    *
    * This function prop allows parent components to customize which entities
-   * are displayed in the grid, enabling advanced filtering, sorting, and
-   * display logic beyond the default simple slice behavior.
+   * are displayed in the grid, enabling advanced filtering and sorting.
+   * Note: Infinite scroll is disabled when this prop is provided.
    *
    * @param entities - The full array of entities (Contact[] or PlanData[])
    * @param entityType - The type of entities being displayed ("people" or "projects")
-   * @param maxItems - The maximum number of items to display (from maxItems prop)
    * @returns Filtered/sorted array of entities to display
    *
    * @example
    * // Custom filtering: only show contacts with profile images
-   * :display-entities-function="(entities, type, max) =>
-   *   entities.filter(e => e.profileImageUrl).slice(0, max)"
+   * :display-entities-function="(entities, type) =>
+   *   entities.filter(e => e.profileImageUrl)"
    *
    * @example
    * // Custom sorting: sort projects by name
-   * :display-entities-function="(entities, type, max) =>
-   *   entities.sort((a, b) => a.name.localeCompare(b.name)).slice(0, max)"
-   *
-   * @example
-   * // Advanced logic: different limits for different entity types
-   * :display-entities-function="(entities, type, max) =>
-   *   type === 'projects' ? entities.slice(0, 5) : entities.slice(0, max)"
+   * :display-entities-function="(entities, type) =>
+   *   entities.sort((a, b) => a.name.localeCompare(b.name))"
    */
   @Prop({ default: null })
   displayEntitiesFunction?: (
     entities: Contact[] | PlanData[],
     entityType: "people" | "projects",
-    maxItems: number,
   ) => Contact[] | PlanData[];
 
   /**
@@ -206,33 +283,60 @@ export default class EntityGrid extends Vue {
   }
 
   /**
-   * Computed CSS classes for the grid layout
+   * Computed entities to display - uses function prop if provided, otherwise uses infinite scroll
+   * When searching, returns filtered results with infinite scroll applied
    */
-  get gridClasses(): string {
-    const baseClasses = "grid gap-x-2 gap-y-4 text-center mb-4";
-
-    if (this.entityType === "projects") {
-      return `${baseClasses} grid-cols-3 md:grid-cols-4`;
-    } else {
-      return `${baseClasses} grid-cols-4 sm:grid-cols-5 md:grid-cols-6`;
+  get displayedEntities(): Contact[] | PlanData[] {
+    // If searching, return filtered results with infinite scroll
+    if (this.searchTerm.trim()) {
+      return this.filteredEntities.slice(0, this.displayedCount);
     }
+
+    // If custom function provided, use it (disables infinite scroll)
+    if (this.displayEntitiesFunction) {
+      return this.displayEntitiesFunction(this.entities, this.entityType);
+    }
+
+    // Default: projects use infinite scroll
+    if (this.entityType === "projects") {
+      return (this.entities as PlanData[]).slice(0, this.displayedCount);
+    }
+
+    // People: handled by recentContacts + alphabeticalContacts (both use displayedCount)
+    return [];
   }
 
   /**
-   * Computed entities to display - uses function prop if provided, otherwise defaults
+   * Get the 3 most recently added contacts (when showing contacts and not searching)
    */
-  get displayedEntities(): Contact[] | PlanData[] {
-    if (this.displayEntitiesFunction) {
-      return this.displayEntitiesFunction(
-        this.entities,
-        this.entityType,
-        this.maxItems,
-      );
+  get recentContacts(): Contact[] {
+    if (this.entityType !== "people" || this.searchTerm.trim()) {
+      return [];
     }
+    // Entities are already sorted by date added (newest first)
+    return (this.entities as Contact[]).slice(0, 3);
+  }
 
-    // Default implementation for backward compatibility
-    const maxDisplay = this.entityType === "projects" ? 7 : this.maxItems;
-    return this.entities.slice(0, maxDisplay);
+  /**
+   * Get the remaining contacts sorted alphabetically (when showing contacts and not searching)
+   * Uses infinite scroll to control how many are displayed
+   */
+  get alphabeticalContacts(): Contact[] {
+    if (this.entityType !== "people" || this.searchTerm.trim()) {
+      return [];
+    }
+    // Skip the first 3 (recent contacts) and sort the rest alphabetically
+    // Create a copy to avoid mutating the original array
+    const remaining = (this.entities as Contact[]).slice(RECENT_CONTACTS_COUNT);
+    const sorted = [...remaining].sort((a: Contact, b: Contact) => {
+      // Sort alphabetically by name, falling back to DID if name is missing
+      const nameA = (a.name || a.did).toLowerCase();
+      const nameB = (b.name || b.did).toLowerCase();
+      return nameA.localeCompare(nameB);
+    });
+    // Apply infinite scroll: show based on displayedCount (minus the 3 recent)
+    const toShow = Math.max(0, this.displayedCount - RECENT_CONTACTS_COUNT);
+    return sorted.slice(0, toShow);
   }
 
   /**
@@ -246,15 +350,6 @@ export default class EntityGrid extends Vue {
     }
   }
 
-  /**
-   * Whether to show the "Show All" navigation
-   */
-  get shouldShowAll(): boolean {
-    return (
-      !this.hideShowAll && this.entities.length > 0 && this.showAllRoute !== ""
-    );
-  }
-
   /**
    * Whether the "You" entity is conflicted
    */
@@ -328,6 +423,144 @@ export default class EntityGrid extends Vue {
     });
   }
 
+  /**
+   * Handle search input with debouncing
+   */
+  handleSearchInput(): void {
+    // Show spinner immediately when user types
+    this.isSearching = true;
+
+    // Clear existing timeout
+    if (this.searchTimeout) {
+      clearTimeout(this.searchTimeout);
+    }
+
+    // Set new timeout for 500ms delay
+    this.searchTimeout = setTimeout(() => {
+      this.performSearch();
+    }, 500);
+  }
+
+  /**
+   * Perform the actual search
+   */
+  async performSearch(): Promise<void> {
+    if (!this.searchTerm.trim()) {
+      this.filteredEntities = [];
+      this.displayedCount = INITIAL_BATCH_SIZE;
+      this.infiniteScrollReset?.();
+      return;
+    }
+
+    this.isSearching = true;
+
+    try {
+      // Simulate async search (in case we need to add API calls later)
+      await new Promise((resolve) => setTimeout(resolve, 100));
+
+      const searchLower = this.searchTerm.toLowerCase().trim();
+
+      if (this.entityType === "people") {
+        this.filteredEntities = (this.entities as Contact[])
+          .filter((contact: Contact) => {
+            const name = contact.name?.toLowerCase() || "";
+            const did = contact.did.toLowerCase();
+            return name.includes(searchLower) || did.includes(searchLower);
+          })
+          .sort((a: Contact, b: Contact) => {
+            // Sort alphabetically by name, falling back to DID if name is missing
+            const nameA = (a.name || a.did).toLowerCase();
+            const nameB = (b.name || b.did).toLowerCase();
+            return nameA.localeCompare(nameB);
+          });
+      } else {
+        this.filteredEntities = (this.entities as PlanData[])
+          .filter((project: PlanData) => {
+            const name = project.name?.toLowerCase() || "";
+            const handleId = project.handleId.toLowerCase();
+            return name.includes(searchLower) || handleId.includes(searchLower);
+          })
+          .sort((a: PlanData, b: PlanData) => {
+            // Sort alphabetically by name
+            return a.name.toLowerCase().localeCompare(b.name.toLowerCase());
+          });
+      }
+
+      // Reset displayed count when search completes
+      this.displayedCount = INITIAL_BATCH_SIZE;
+      this.infiniteScrollReset?.();
+    } finally {
+      this.isSearching = false;
+    }
+  }
+
+  /**
+   * Clear the search
+   */
+  clearSearch(): void {
+    this.searchTerm = "";
+    this.filteredEntities = [];
+    this.isSearching = false;
+    this.displayedCount = INITIAL_BATCH_SIZE;
+    this.infiniteScrollReset?.();
+
+    // Clear any pending timeout
+    if (this.searchTimeout) {
+      clearTimeout(this.searchTimeout);
+      this.searchTimeout = null;
+    }
+  }
+
+  /**
+   * Determine if more entities can be loaded
+   */
+  canLoadMore(): boolean {
+    if (this.displayEntitiesFunction) {
+      // Custom function disables infinite scroll
+      return false;
+    }
+
+    if (this.searchTerm.trim()) {
+      // Search mode: check filtered entities
+      return this.displayedCount < this.filteredEntities.length;
+    }
+
+    if (this.entityType === "projects") {
+      // Projects: check if more available
+      return this.displayedCount < this.entities.length;
+    }
+
+    // People: check if more alphabetical contacts available
+    // Total available = 3 recent + all alphabetical
+    const remaining = (this.entities as Contact[]).slice(RECENT_CONTACTS_COUNT);
+    const totalAvailable = RECENT_CONTACTS_COUNT + remaining.length;
+    return this.displayedCount < totalAvailable;
+  }
+
+  /**
+   * Initialize infinite scroll on mount
+   */
+  mounted(): void {
+    this.$nextTick(() => {
+      const container = this.$refs.scrollContainer as HTMLElement;
+
+      if (container) {
+        const { reset } = useInfiniteScroll(
+          container,
+          () => {
+            // Load more: increment displayedCount
+            this.displayedCount += INCREMENT_SIZE;
+          },
+          {
+            distance: 50, // pixels from bottom
+            canLoadMore: () => this.canLoadMore(),
+          },
+        );
+        this.infiniteScrollReset = reset;
+      }
+    });
+  }
+
   // Emit methods using @Emit decorator
 
   @Emit("entity-selected")
@@ -340,6 +573,33 @@ export default class EntityGrid extends Vue {
   } {
     return data;
   }
+
+  /**
+   * Watch for changes in search term to reset displayed count
+   */
+  @Watch("searchTerm")
+  onSearchTermChange(): void {
+    this.displayedCount = INITIAL_BATCH_SIZE;
+    this.infiniteScrollReset?.();
+  }
+
+  /**
+   * Watch for changes in entities prop to reset displayed count
+   */
+  @Watch("entities")
+  onEntitiesChange(): void {
+    this.displayedCount = INITIAL_BATCH_SIZE;
+    this.infiniteScrollReset?.();
+  }
+
+  /**
+   * Cleanup timeouts when component is destroyed
+   */
+  beforeUnmount(): void {
+    if (this.searchTimeout) {
+      clearTimeout(this.searchTimeout);
+    }
+  }
 }
 </script>
 

src/components/EntitySelectionStep.vue

@@ -3,10 +3,9 @@ from GiftedDialog.vue to handle the complete step 1 * entity selection interface
 with dynamic labeling and grid display. * * Features: * - Dynamic step labeling
 based on context * - EntityGrid integration for unified entity display * -
 Conflict detection and prevention * - Special entity handling (You, Unnamed) * -
-Show All navigation with context preservation * - Cancel functionality * - Event
-delegation for entity selection * - Warning notifications for conflicted
-entities * - Template streamlined with computed CSS properties * * @author
-Matthew Raymer */
+Cancel functionality * - Event delegation for entity selection * - Warning
+notifications for conflicted entities * - Template streamlined with computed CSS
+properties * * @author Matthew Raymer */
 <template>
   <div id="sectionGiftedGiver">
     <label class="block font-bold mb-4">
@@ -16,18 +15,14 @@ Matthew Raymer */
     <EntityGrid
       :entity-type="shouldShowProjects ? 'projects' : 'people'"
       :entities="shouldShowProjects ? projects : allContacts"
-      :max-items="10"
       :active-did="activeDid"
       :all-my-dids="allMyDids"
       :all-contacts="allContacts"
       :conflict-checker="conflictChecker"
       :show-you-entity="shouldShowYouEntity"
       :you-selectable="youSelectable"
-      :show-all-route="showAllRoute"
-      :show-all-query-params="showAllQueryParams"
       :notify="notify"
       :conflict-context="conflictContext"
-      :hide-show-all="hideShowAll"
       @entity-selected="handleEntitySelected"
     />
 
@@ -68,7 +63,6 @@ interface EntitySelectionEvent {
  * - EntityGrid integration for unified entity display
  * - Conflict detection and prevention
  * - Special entity handling (You, Unnamed)
- * - Show All navigation with context preservation
  * - Cancel functionality
  * - Event delegation for entity selection
  * - Warning notifications for conflicted entities
@@ -154,10 +148,6 @@ export default class EntitySelectionStep extends Vue {
   @Prop()
   notify?: (notification: NotificationIface, timeout?: number) => void;
 
-  /** Whether to hide the "Show All" navigation */
-  @Prop({ default: false })
-  hideShowAll!: boolean;
-
   /**
    * CSS classes for the cancel button
    */
@@ -222,59 +212,6 @@ export default class EntitySelectionStep extends Vue {
     return !this.conflictChecker(this.activeDid);
   }
 
-  /**
-   * Route name for "Show All" navigation
-   */
-  get showAllRoute(): string {
-    if (this.shouldShowProjects) {
-      return "discover";
-    } else if (this.allContacts.length > 0) {
-      return "contact-gift";
-    }
-    return "";
-  }
-
-  /**
-   * Query parameters for "Show All" navigation
-   */
-  get showAllQueryParams(): Record<string, string> {
-    const baseParams = {
-      stepType: this.stepType,
-      giverEntityType: this.giverEntityType,
-      recipientEntityType: this.recipientEntityType,
-      // Form field values to preserve
-      description: this.description,
-      amountInput: this.amountInput,
-      unitCode: this.unitCode,
-      offerId: this.offerId,
-      fromProjectId: this.fromProjectId,
-      toProjectId: this.toProjectId,
-      showProjects: this.showProjects.toString(),
-      isFromProjectView: this.isFromProjectView.toString(),
-    };
-
-    if (this.shouldShowProjects) {
-      // For project contexts, still pass entity type information
-      return baseParams;
-    }
-
-    return {
-      ...baseParams,
-      // Always pass both giver and recipient info for context preservation
-      giverProjectId: this.fromProjectId || "",
-      giverProjectName: this.giver?.name || "",
-      giverProjectImage: this.giver?.image || "",
-      giverProjectHandleId: this.giver?.handleId || "",
-      giverDid: this.giverEntityType === "person" ? this.giver?.did || "" : "",
-      recipientProjectId: this.toProjectId || "",
-      recipientProjectName: this.receiver?.name || "",
-      recipientProjectImage: this.receiver?.image || "",
-      recipientProjectHandleId: this.receiver?.handleId || "",
-      recipientDid:
-        this.recipientEntityType === "person" ? this.receiver?.did || "" : "",
-    };
-  }
-
   /**
    * Handle entity selection from EntityGrid
    */

src/components/FeedFilters.vue

@@ -211,8 +211,6 @@ export default class FeedFilters extends Vue {
 }
 </script>
 
-<style>
-#dialogFeedFilters.dialog-overlay {
-  overflow: scroll;
-}
+<style scoped>
+/* Component-specific styles if needed */
 </style>

src/components/GiftedDialog.vue

@@ -29,7 +29,6 @@
         :unit-code="unitCode"
         :offer-id="offerId"
         :notify="$notify"
-        :hide-show-all="hideShowAll"
         @entity-selected="handleEntitySelected"
         @cancel="cancel"
       />
@@ -117,7 +116,6 @@ export default class GiftedDialog extends Vue {
   @Prop() fromProjectId = "";
   @Prop() toProjectId = "";
   @Prop() isFromProjectView = false;
-  @Prop() hideShowAll = false;
   @Prop({ default: "person" }) giverEntityType = "person" as
     | "person"
     | "project";
@@ -233,7 +231,7 @@ export default class GiftedDialog extends Vue {
         apiServer: this.apiServer,
       });
 
-      this.allContacts = await this.$contacts();
+      this.allContacts = await this.$contactsByDateAdded();
 
       this.allMyDids = await retrieveAccountDids();
 

src/components/ImageMethodDialog.vue

@@ -293,7 +293,7 @@ const inputImageFileNameRef = ref<Blob>();
 export default class ImageMethodDialog extends Vue {
   $notify!: NotifyFunction;
   $router!: Router;
-  notify = createNotifyHelpers(this.$notify);
+  notify!: ReturnType<typeof createNotifyHelpers>;
 
   /** Active DID for user authentication */
   activeDid = "";
@@ -498,6 +498,9 @@ export default class ImageMethodDialog extends Vue {
    * @throws {Error} When settings retrieval fails
    */
   async mounted() {
+    // Initialize notification helpers
+    this.notify = createNotifyHelpers(this.$notify);
+
     try {
       // Get activeDid from active_identity table (single source of truth)
       // eslint-disable-next-line @typescript-eslint/no-explicit-any

src/components/MembersList.vue

@@ -1,183 +1,255 @@
 <template>
-  <div class="space-y-4">
-    <!-- Loading State -->
-    <div
-      v-if="isLoading"
-      class="mt-16 text-center text-4xl bg-slate-400 text-white w-14 py-2.5 rounded-full mx-auto"
-    >
-      <font-awesome icon="spinner" class="fa-spin-pulse" />
-    </div>
-
-    <!-- Members List -->
-
-    <div v-else>
-      <div class="text-center text-red-600 py-4">
-        {{ decryptionErrorMessage() }}
+  <div>
+    <div class="space-y-4">
+      <!-- Loading State -->
+      <div
+        v-if="isLoading"
+        class="mt-16 text-center text-4xl bg-slate-400 text-white w-14 py-2.5 rounded-full mx-auto"
+      >
+        <font-awesome icon="spinner" class="fa-spin-pulse" />
       </div>
 
-      <div v-if="missingMyself" class="py-4 text-red-600">
-        You are not currently admitted by the organizer.
-      </div>
-      <div v-if="!firstName" class="py-4 text-red-600">
-        Your name is not set, so others may not recognize you. Reload this page
-        to set it.
-      </div>
+      <!-- Members List -->
 
-      <div>
-        <span
-          v-if="membersToShow().length > 0 && showOrganizerTools && isOrganizer"
-          class="inline-flex items-center flex-wrap"
-        >
-          <span class="inline-flex items-center">
-            &bull; Click
-            <span
-              class="mx-2 min-w-[24px] min-h-[24px] w-6 h-6 flex items-center justify-center rounded-full bg-blue-100 text-blue-600"
-            >
-              <font-awesome icon="plus" class="text-sm" />
-            </span>
-            /
-            <span
-              class="mx-2 min-w-[24px] min-h-[24px] w-6 h-6 flex items-center justify-center rounded-full bg-blue-100 text-blue-600"
-            >
-              <font-awesome icon="minus" class="text-sm" />
-            </span>
-            to add/remove them to/from the meeting.
-          </span>
-        </span>
-      </div>
-      <div>
-        <span
-          v-if="membersToShow().length > 0"
-          class="inline-flex items-center"
-        >
-          &bull; Click
-          <span
-            class="mx-2 w-8 h-8 flex items-center justify-center rounded-full bg-green-100 text-green-600"
+      <div v-else>
+        <div class="text-center text-red-600 my-4">
+          {{ decryptionErrorMessage() }}
+        </div>
+
+        <div v-if="missingMyself" class="py-4 text-red-600">
+          You are not currently admitted by the organizer.
+        </div>
+        <div v-if="!firstName" class="py-4 text-red-600">
+          Your name is not set, so others may not recognize you. Reload this
+          page to set it.
+        </div>
+
+        <ul class="list-disc text-sm ps-4 space-y-2 mb-4">
+          <li
+            v-if="
+              membersToShow().length > 0 && showOrganizerTools && isOrganizer
+            "
           >
-            <font-awesome icon="circle-user" class="text-xl" />
-          </span>
-          to add them to your contacts.
-        </span>
-      </div>
+            Click
+            <font-awesome icon="circle-plus" class="text-blue-500 text-sm" />
+            /
+            <font-awesome icon="circle-minus" class="text-rose-500 text-sm" />
+            to add/remove them to/from the meeting.
+          </li>
+          <li
+            v-if="
+              membersToShow().length > 0 && getNonContactMembers().length > 0
+            "
+          >
+            Click
+            <font-awesome icon="circle-user" class="text-green-600 text-sm" />
+            to add them to your contacts.
+          </li>
+        </ul>
 
-      <div class="flex justify-center">
-        <!-- 
+        <div class="flex justify-between">
+          <!-- 
         always have at least one refresh button even without members in case the organizer 
          changes the password 
          -->
-        <button
-          class="btn-action-refresh"
-          title="Refresh members list"
-          @click="fetchMembers"
-        >
-          <font-awesome icon="rotate" :class="{ 'fa-spin': isLoading }" />
-        </button>
-      </div>
-      <div
-        v-for="member in membersToShow()"
-        :key="member.member.memberId"
-        class="mt-2 p-4 bg-gray-50 rounded-lg"
-      >
-        <div class="flex items-center justify-between">
-          <div class="flex items-center">
-            <h3 class="text-lg font-medium">
-              {{ member.name || unnamedMember }}
-            </h3>
-            <div
-              v-if="!getContactFor(member.did) && member.did !== activeDid"
-              class="flex justify-end"
-            >
-              <button
-                class="btn-add-contact"
-                title="Add as contact"
-                @click="addAsContact(member)"
-              >
-                <font-awesome icon="circle-user" class="text-xl" />
-              </button>
-            </div>
-            <button
-              v-if="member.did !== activeDid"
-              class="btn-info-contact"
-              title="Contact info"
-              @click="
-                informAboutAddingContact(
-                  getContactFor(member.did) !== undefined,
-                )
-              "
-            >
-              <font-awesome icon="circle-info" class="text-base" />
-            </button>
-          </div>
-          <div class="flex">
-            <span
-              v-if="
-                showOrganizerTools && isOrganizer && member.did !== activeDid
-              "
-              class="flex items-center"
-            >
-              <button
-                class="btn-admission"
-                :title="
-                  member.member.admitted ? 'Remove member' : 'Admit member'
-                "
-                @click="checkWhetherContactBeforeAdmitting(member)"
-              >
-                <font-awesome
-                  :icon="member.member.admitted ? 'minus' : 'plus'"
-                  class="text-sm"
-                />
-              </button>
-              <button
-                class="btn-info-admission"
-                title="Admission info"
-                @click="informAboutAdmission()"
-              >
-                <font-awesome icon="circle-info" class="text-base" />
-              </button>
-            </span>
-          </div>
+          <button
+            class="text-sm bg-gradient-to-b from-slate-400 to-slate-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] text-white px-3 py-1.5 rounded-md"
+            title="Refresh members list now"
+            @click="refreshData(false)"
+          >
+            <font-awesome icon="rotate" :class="{ 'fa-spin': isLoading }" />
+            Refresh
+            <span class="text-xs">({{ countdownTimer }}s)</span>
+          </button>
         </div>
-        <p class="text-sm text-gray-600 truncate">
-          {{ member.did }}
+        <ul
+          v-if="membersToShow().length > 0"
+          class="border-t border-slate-300 my-2"
+        >
+          <li
+            v-for="member in membersToShow()"
+            :key="member.member.memberId"
+            :class="[
+              'border-b px-2 sm:px-3 py-1.5',
+              {
+                'bg-blue-50 border-t border-blue-300 -mt-[1px]':
+                  !member.member.admitted &&
+                  (isOrganizer || member.did === activeDid),
+              },
+              { 'border-slate-300': member.member.admitted },
+            ]"
+          >
+            <div class="flex items-center gap-2 justify-between">
+              <div class="flex items-center gap-1 overflow-hidden">
+                <h3
+                  :class="[
+                    'font-semibold truncate',
+                    {
+                      'text-slate-500':
+                        !member.member.admitted &&
+                        (isOrganizer || member.did === activeDid),
+                    },
+                  ]"
+                >
+                  <font-awesome
+                    v-if="member.member.memberId === members[0]?.memberId"
+                    icon="crown"
+                    class="fa-fw text-amber-400"
+                  />
+                  <font-awesome
+                    v-if="member.did === activeDid"
+                    icon="hand"
+                    class="fa-fw text-slate-500"
+                  />
+                  <font-awesome
+                    v-if="
+                      !member.member.admitted &&
+                      (isOrganizer || member.did === activeDid)
+                    "
+                    icon="hourglass-half"
+                    class="fa-fw text-slate-400"
+                  />
+                  {{ member.name || unnamedMember }}
+                </h3>
+                <div
+                  v-if="!getContactFor(member.did) && member.did !== activeDid"
+                  class="flex items-center gap-1.5 ml-2 ms-1"
+                >
+                  <button
+                    class="btn-add-contact ml-2"
+                    title="Add as contact"
+                    @click="addAsContact(member)"
+                  >
+                    <font-awesome icon="circle-user" />
+                  </button>
+
+                  <button
+                    class="btn-info-contact ml-2"
+                    title="Contact Info"
+                    @click="
+                      informAboutAddingContact(
+                        getContactFor(member.did) !== undefined,
+                      )
+                    "
+                  >
+                    <font-awesome icon="circle-info" />
+                  </button>
+                </div>
+                <div
+                  v-if="getContactFor(member.did) && member.did !== activeDid"
+                  class="flex items-center gap-1.5 ms-1"
+                >
+                  <router-link
+                    :to="{ name: 'contact-edit', params: { did: member.did } }"
+                  >
+                    <font-awesome
+                      icon="pen"
+                      class="text-sm text-blue-500 ml-2 mb-1"
+                    />
+                  </router-link>
+                  <router-link
+                    :to="{ name: 'did', params: { did: member.did } }"
+                  >
+                    <font-awesome
+                      icon="arrow-up-right-from-square"
+                      class="text-sm text-blue-500 ml-2 mb-1"
+                    />
+                  </router-link>
+                </div>
+              </div>
+              <span
+                v-if="
+                  showOrganizerTools && isOrganizer && member.did !== activeDid
+                "
+                class="flex items-center gap-1.5"
+              >
+                <button
+                  :class="
+                    member.member.admitted
+                      ? 'btn-admission-remove'
+                      : 'btn-admission-add'
+                  "
+                  :title="
+                    member.member.admitted ? 'Remove member' : 'Admit member'
+                  "
+                  @click="checkWhetherContactBeforeAdmitting(member)"
+                >
+                  <font-awesome
+                    :icon="
+                      member.member.admitted ? 'circle-minus' : 'circle-plus'
+                    "
+                  />
+                </button>
+
+                <button
+                  class="btn-info-admission"
+                  title="Admission Info"
+                  @click="informAboutAdmission()"
+                >
+                  <font-awesome icon="circle-info" />
+                </button>
+              </span>
+            </div>
+            <p class="text-xs text-gray-600 truncate">
+              {{ member.did }}
+            </p>
+          </li>
+        </ul>
+
+        <div v-if="membersToShow().length > 0" class="flex justify-between">
+          <!-- 
+        always have at least one refresh button even without members in case the organizer 
+         changes the password 
+         -->
+          <button
+            class="text-sm bg-gradient-to-b from-slate-400 to-slate-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] text-white px-3 py-1.5 rounded-md"
+            title="Refresh members list now"
+            @click="refreshData(false)"
+          >
+            <font-awesome icon="rotate" :class="{ 'fa-spin': isLoading }" />
+            Refresh
+            <span class="text-xs">({{ countdownTimer }}s)</span>
+          </button>
+        </div>
+
+        <p v-if="members.length === 0" class="text-gray-500 py-4">
+          No members have joined this meeting yet
         </p>
       </div>
-      <div v-if="membersToShow().length > 0" class="flex justify-center mt-4">
-        <button
-          class="btn-action-refresh"
-          title="Refresh members list"
-          @click="fetchMembers"
-        >
-          <font-awesome icon="rotate" :class="{ 'fa-spin': isLoading }" />
-        </button>
-      </div>
-
-      <p v-if="members.length === 0" class="text-gray-500 py-4">
-        No members have joined this meeting yet
-      </p>
     </div>
+
+    <!-- Bulk Members Dialog for both admitting and setting visibility -->
+    <BulkMembersDialog
+      ref="bulkMembersDialog"
+      :active-did="activeDid"
+      :api-server="apiServer"
+      :is-organizer="isOrganizer"
+      @close="closeBulkMembersDialogCallback"
+    />
   </div>
 </template>
 
 <script lang="ts">
 import { Component, Vue, Prop, Emit } from "vue-facing-decorator";
 
-import {
-  errorStringForLog,
-  getHeaders,
-  register,
-  serverMessageForUser,
-} from "../libs/endorserServer";
-import { decryptMessage } from "../libs/crypto";
-import { Contact } from "../db/tables/contacts";
-import * as libsUtil from "../libs/util";
-import { NotificationIface } from "../constants/app";
-import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
-import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
+import { NotificationIface } from "@/constants/app";
 import {
   NOTIFY_ADD_CONTACT_FIRST,
   NOTIFY_CONTINUE_WITHOUT_ADDING,
 } from "@/constants/notifications";
 import { SOMEONE_UNNAMED } from "@/constants/entities";
+import {
+  errorStringForLog,
+  getHeaders,
+  register,
+  serverMessageForUser,
+} from "@/libs/endorserServer";
+import { decryptMessage } from "@/libs/crypto";
+import { Contact } from "@/db/tables/contacts";
+import { MemberData } from "@/interfaces";
+import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
+import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
+import BulkMembersDialog from "./BulkMembersDialog.vue";
 
 interface Member {
   admitted: boolean;
@@ -193,13 +265,15 @@ interface DecryptedMember {
 }
 
 @Component({
+  components: {
+    BulkMembersDialog,
+  },
   mixins: [PlatformServiceMixin],
 })
 export default class MembersList extends Vue {
   $notify!: (notification: NotificationIface, timeout?: number) => void;
 
   notify!: ReturnType<typeof createNotifyHelpers>;
-  libsUtil = libsUtil;
 
   @Prop({ required: true }) password!: string;
   @Prop({ default: false }) showOrganizerTools!: boolean;
@@ -210,6 +284,7 @@ export default class MembersList extends Vue {
     return message;
   }
 
+  contacts: Array<Contact> = [];
   decryptedMembers: DecryptedMember[] = [];
   firstName = "";
   isLoading = true;
@@ -219,7 +294,12 @@ export default class MembersList extends Vue {
   missingMyself = false;
   activeDid = "";
   apiServer = "";
-  contacts: Array<Contact> = [];
+
+  // Auto-refresh functionality
+  countdownTimer = 10;
+  autoRefreshInterval: NodeJS.Timeout | null = null;
+  lastRefreshTime = 0;
+  previousMemberDidsIgnored: string[] = [];
 
   /**
    * Get the unnamed member constant
@@ -240,8 +320,8 @@ export default class MembersList extends Vue {
 
     this.apiServer = settings.apiServer || "";
     this.firstName = settings.firstName || "";
-    await this.fetchMembers();
-    await this.loadContacts();
+
+    this.refreshData();
   }
 
   async fetchMembers() {
@@ -287,7 +367,10 @@ export default class MembersList extends Vue {
         const content = JSON.parse(decryptedContent);
 
         this.decryptedMembers.push({
-          member: member,
+          member: {
+            ...member,
+            admitted: member.admitted !== undefined ? member.admitted : true, // Default to true for non-organizers
+          },
           name: content.name,
           did: content.did,
           isRegistered: !!content.isRegistered,
@@ -329,22 +412,81 @@ export default class MembersList extends Vue {
   }
 
   membersToShow(): DecryptedMember[] {
+    let members: DecryptedMember[] = [];
+
     if (this.isOrganizer) {
       if (this.showOrganizerTools) {
-        return this.decryptedMembers;
+        members = this.decryptedMembers;
       } else {
-        return this.decryptedMembers.filter(
+        members = this.decryptedMembers.filter(
           (member: DecryptedMember) => member.member.admitted,
         );
       }
+    } else {
+      // non-organizers only get visible members from server, plus themselves
+
+      // Check if current user is already in the decrypted members list
+      if (
+        !this.decryptedMembers.find((member) => member.did === this.activeDid)
+      ) {
+        // this is a stub for this user just in case they are waiting to get in
+        // which is especially useful so they can see their own DID
+        const currentUser: DecryptedMember = {
+          member: {
+            admitted: false,
+            content: "{}",
+            memberId: -1,
+          },
+          name: this.firstName,
+          did: this.activeDid,
+          isRegistered: false,
+        };
+        members = [currentUser, ...this.decryptedMembers];
+      } else {
+        members = this.decryptedMembers;
+      }
     }
-    // non-organizers only get visible members from server
-    return this.decryptedMembers;
+
+    // Sort members according to priority:
+    // 1. Organizer at the top
+    // 2. Current user next
+    // 3. Non-admitted members next
+    // 4. Everyone else after
+    return members.sort((a, b) => {
+      // Check if either member is the organizer (first member in original list)
+      const aIsOrganizer = a.member.memberId === this.members[0]?.memberId;
+      const bIsOrganizer = b.member.memberId === this.members[0]?.memberId;
+
+      // Check if either member is the current user
+      const aIsCurrentUser = a.did === this.activeDid;
+      const bIsCurrentUser = b.did === this.activeDid;
+
+      // Organizer always comes first
+      if (aIsOrganizer && !bIsOrganizer) return -1;
+      if (!aIsOrganizer && bIsOrganizer) return 1;
+
+      // If both are organizers, maintain original order
+      if (aIsOrganizer && bIsOrganizer) return 0;
+
+      // Current user comes second (after organizer)
+      if (aIsCurrentUser && !bIsCurrentUser && !bIsOrganizer) return -1;
+      if (!aIsCurrentUser && bIsCurrentUser && !aIsOrganizer) return 1;
+
+      // If both are current users, maintain original order
+      if (aIsCurrentUser && bIsCurrentUser) return 0;
+
+      // Non-admitted members come before admitted members
+      if (!a.member.admitted && b.member.admitted) return -1;
+      if (a.member.admitted && !b.member.admitted) return 1;
+
+      // If admission status is the same, maintain original order
+      return 0;
+    });
   }
 
   informAboutAdmission() {
     this.notify.info(
-      "This is to register people in Time Safari and to admit them to the meeting. A '+' symbol means they are not yet admitted and you can register and admit them. A '-' means you can remove them, but they will stay registered.",
+      "This is to register people in Time Safari and to admit them to the meeting. A (+) symbol means they are not yet admitted and you can register and admit them. A (-) symbol means you can remove them, but they will stay registered.",
       TIMEOUTS.VERY_LONG,
     );
   }
@@ -363,18 +505,85 @@ export default class MembersList extends Vue {
     }
   }
 
-  async loadContacts() {
-    this.contacts = await this.$getAllContacts();
-  }
-
   getContactFor(did: string): Contact | undefined {
     return this.contacts.find((contact) => contact.did === did);
   }
 
+  getPendingMembersToAdmit(): MemberData[] {
+    return this.decryptedMembers
+      .filter(
+        (member) => member.did !== this.activeDid && !member.member.admitted,
+      )
+      .map(this.convertDecryptedMemberToMemberData);
+  }
+
+  getNonContactMembers(): MemberData[] {
+    return this.decryptedMembers
+      .filter(
+        (member) =>
+          member.did !== this.activeDid && !this.getContactFor(member.did),
+      )
+      .map(this.convertDecryptedMemberToMemberData);
+  }
+
+  convertDecryptedMemberToMemberData(
+    decryptedMember: DecryptedMember,
+  ): MemberData {
+    return {
+      did: decryptedMember.did,
+      name: decryptedMember.name,
+      isContact: !!this.getContactFor(decryptedMember.did),
+      member: {
+        memberId: decryptedMember.member.memberId.toString(),
+      },
+    };
+  }
+
+  /**
+   * Show the bulk members dialog if conditions are met
+   * (admit pending members for organizers, add to contacts for non-organizers)
+   */
+  async refreshData(bypassPromptIfAllWereIgnored = true) {
+    // Force refresh both contacts and members
+    this.contacts = await this.$getAllContacts();
+    await this.fetchMembers();
+
+    const pendingMembers = this.isOrganizer
+      ? this.getPendingMembersToAdmit()
+      : this.getNonContactMembers();
+    if (pendingMembers.length === 0) {
+      this.startAutoRefresh();
+      return;
+    }
+    if (bypassPromptIfAllWereIgnored) {
+      // only show if there are members that have not been ignored
+      const pendingMembersNotIgnored = pendingMembers.filter(
+        (member) => !this.previousMemberDidsIgnored.includes(member.did),
+      );
+      if (pendingMembersNotIgnored.length === 0) {
+        this.startAutoRefresh();
+        // everyone waiting has been ignored
+        return;
+      }
+    }
+    this.stopAutoRefresh();
+    (this.$refs.bulkMembersDialog as BulkMembersDialog).open(pendingMembers);
+  }
+
+  // Bulk Members Dialog methods
+  async closeBulkMembersDialogCallback(
+    result: { notSelectedMemberDids: string[] } | undefined,
+  ) {
+    this.previousMemberDidsIgnored = result?.notSelectedMemberDids || [];
+
+    await this.refreshData();
+  }
+
   checkWhetherContactBeforeAdmitting(decrMember: DecryptedMember) {
     const contact = this.getContactFor(decrMember.did);
     if (!decrMember.member.admitted && !contact) {
-      // If not a contact, show confirmation dialog
+      // If not a contact, stop auto-refresh and show confirmation dialog
+      this.stopAutoRefresh();
       this.$notify(
         {
           group: "modal",
@@ -387,6 +596,7 @@ export default class MembersList extends Vue {
             await this.addAsContact(decrMember);
             // After adding as contact, proceed with admission
             await this.toggleAdmission(decrMember);
+            this.startAutoRefresh();
           },
           onNo: async () => {
             // If they choose not to add as contact, show second confirmation
@@ -399,14 +609,19 @@ export default class MembersList extends Vue {
                 yesText: NOTIFY_CONTINUE_WITHOUT_ADDING.yesText,
                 onYes: async () => {
                   await this.toggleAdmission(decrMember);
+                  this.startAutoRefresh();
                 },
                 onCancel: async () => {
                   // Do nothing, effectively canceling the operation
+                  this.startAutoRefresh();
                 },
               },
               TIMEOUTS.MODAL,
             );
           },
+          onCancel: async () => {
+            this.startAutoRefresh();
+          },
         },
         TIMEOUTS.MODAL,
       );
@@ -508,6 +723,41 @@ export default class MembersList extends Vue {
       this.notify.error(message, TIMEOUTS.LONG);
     }
   }
+
+  startAutoRefresh() {
+    this.stopAutoRefresh();
+    this.lastRefreshTime = Date.now();
+    this.countdownTimer = 10;
+
+    this.autoRefreshInterval = setInterval(() => {
+      const now = Date.now();
+      const timeSinceLastRefresh = (now - this.lastRefreshTime) / 1000;
+
+      if (timeSinceLastRefresh >= 10) {
+        // Time to refresh
+        this.refreshData();
+        this.lastRefreshTime = now;
+        this.countdownTimer = 10;
+      } else {
+        // Update countdown
+        this.countdownTimer = Math.max(
+          0,
+          Math.round(10 - timeSinceLastRefresh),
+        );
+      }
+    }, 1000); // Update every second
+  }
+
+  stopAutoRefresh() {
+    if (this.autoRefreshInterval) {
+      clearInterval(this.autoRefreshInterval);
+      this.autoRefreshInterval = null;
+    }
+  }
+
+  beforeDestroy() {
+    this.stopAutoRefresh();
+  }
 }
 </script>
 
@@ -522,29 +772,26 @@ export default class MembersList extends Vue {
 
 .btn-add-contact {
   /* stylelint-disable-next-line at-rule-no-unknown */
-  @apply ml-2 w-8 h-8 flex items-center justify-center rounded-full 
-    bg-green-100 text-green-600 hover:bg-green-200 hover:text-green-800 
-    transition-colors;
-}
-
-.btn-info-contact {
-  /* stylelint-disable-next-line at-rule-no-unknown */
-  @apply ml-2 mb-2 w-6 h-6 flex items-center justify-center rounded-full 
-    bg-slate-100 text-slate-500 hover:bg-slate-200 hover:text-slate-800 
-    transition-colors;
-}
-
-.btn-admission {
-  /* stylelint-disable-next-line at-rule-no-unknown */
-  @apply mr-2 w-6 h-6 flex items-center justify-center rounded-full 
-    bg-blue-100 text-blue-600 hover:bg-blue-200 hover:text-blue-800 
+  @apply text-lg text-green-600 hover:text-green-800 
     transition-colors;
 }
 
+.btn-info-contact,
 .btn-info-admission {
   /* stylelint-disable-next-line at-rule-no-unknown */
-  @apply mr-2 mb-2 w-6 h-6 flex items-center justify-center rounded-full 
-    bg-slate-100 text-slate-500 hover:bg-slate-200 hover:text-slate-800 
+  @apply text-slate-400 hover:text-slate-600 
+    transition-colors;
+}
+
+.btn-admission-add {
+  /* stylelint-disable-next-line at-rule-no-unknown */
+  @apply text-lg text-blue-500 hover:text-blue-700 
+    transition-colors;
+}
+
+.btn-admission-remove {
+  /* stylelint-disable-next-line at-rule-no-unknown */
+  @apply text-lg text-rose-500 hover:text-rose-700 
     transition-colors;
 }
 </style>

src/components/PersonCard.vue

@@ -3,30 +3,25 @@ GiftedDialog.vue to handle person entity display * with selection states and
 conflict detection. * * @author Matthew Raymer */
 <template>
   <li :class="cardClasses" @click="handleClick">
-    <div class="relative w-fit mx-auto">
+    <div>
       <EntityIcon
         v-if="person.did"
         :contact="person"
-        class="!size-[3rem] mx-auto border border-slate-300 bg-white overflow-hidden rounded-full mb-1"
+        class="!size-[2rem] shrink-0 border border-slate-300 bg-white overflow-hidden rounded-full"
       />
       <font-awesome
         v-else
         icon="circle-question"
-        class="text-slate-400 text-5xl mb-1"
+        class="text-slate-400 text-5xl mb-1 shrink-0"
       />
-
-      <!-- Time icon overlay for contacts -->
-      <div
-        v-if="person.did && showTimeIcon"
-        class="rounded-full bg-slate-400 absolute bottom-0 right-0 p-1 translate-x-1/3"
-      >
-        <font-awesome icon="clock" class="block text-white text-xs w-[1em]" />
-      </div>
     </div>
 
-    <h3 :class="nameClasses">
-      {{ displayName }}
-    </h3>
+    <div class="overflow-hidden">
+      <h3 :class="nameClasses">
+        {{ displayName }}
+      </h3>
+      <p class="text-xs text-slate-500 truncate">{{ person.did }}</p>
+    </div>
   </li>
 </template>
 
@@ -81,29 +76,32 @@ export default class PersonCard extends Vue {
    * Computed CSS classes for the card
    */
   get cardClasses(): string {
+    const baseCardClasses =
+      "flex items-center gap-2 px-2 py-1.5 border-b border-slate-300";
+
     if (!this.selectable || this.conflicted) {
-      return "opacity-50 cursor-not-allowed";
+      return `${baseCardClasses} *:opacity-50 cursor-not-allowed`;
     }
-    return "cursor-pointer hover:bg-slate-50";
+
+    return `${baseCardClasses} cursor-pointer hover:bg-slate-50`;
   }
 
   /**
    * Computed CSS classes for the person name
    */
   get nameClasses(): string {
-    const baseClasses =
-      "text-xs font-medium text-ellipsis whitespace-nowrap overflow-hidden";
+    const baseNameClasses = "text-sm font-semibold truncate";
 
     if (this.conflicted) {
-      return `${baseClasses} text-slate-400`;
+      return `${baseNameClasses} text-slate-500`;
     }
 
     // Add italic styling for entities without set names
     if (!this.person.name) {
-      return `${baseClasses} italic text-slate-500`;
+      return `${baseNameClasses} italic text-slate-500`;
     }
 
-    return baseClasses;
+    return baseNameClasses;
   }
 
   /**

src/components/ProjectCard.vue

@@ -2,25 +2,26 @@
 GiftedDialog.vue to handle project entity display * with selection states and
 issuer information. * * @author Matthew Raymer */
 <template>
-  <li class="cursor-pointer" @click="handleClick">
-    <div class="relative w-fit mx-auto">
-      <ProjectIcon
-        :entity-id="project.handleId"
-        :icon-size="48"
-        :image-url="project.image"
-        class="!size-[3rem] mx-auto border border-slate-300 bg-white overflow-hidden rounded-full mb-1"
-      />
-    </div>
+  <li
+    class="flex items-center gap-2 px-2 py-1.5 border-b border-slate-300 hover:bg-slate-50 cursor-pointer"
+    @click="handleClick"
+  >
+    <ProjectIcon
+      :entity-id="project.handleId"
+      :icon-size="48"
+      :image-url="project.image"
+      class="!size-[2rem] shrink-0 border border-slate-300 bg-white overflow-hidden rounded-full"
+    />
 
-    <h3
-      class="text-xs font-medium text-ellipsis whitespace-nowrap overflow-hidden"
-    >
-      {{ project.name || unnamedProject }}
-    </h3>
+    <div class="overflow-hidden">
+      <h3 class="text-sm font-semibold truncate">
+        {{ project.name || unnamedProject }}
+      </h3>
 
-    <div class="text-xs text-slate-500 truncate">
-      <font-awesome icon="user" class="fa-fw text-slate-400" />
-      {{ issuerDisplayName }}
+      <div class="text-xs text-slate-500 truncate">
+        <font-awesome icon="user" class="text-slate-400" />
+        {{ issuerDisplayName }}
+      </div>
     </div>
   </li>
 </template>

src/components/ShowAllCard.vue

@@ -1,66 +0,0 @@
-/** * ShowAllCard.vue - Show All navigation card component * * Extracted from
-GiftedDialog.vue to handle "Show All" navigation * for both people and projects
-entity types. * * @author Matthew Raymer */
-<template>
-  <li class="cursor-pointer">
-    <router-link :to="navigationRoute" class="block text-center">
-      <font-awesome icon="circle-right" class="text-blue-500 text-5xl mb-1" />
-      <h3
-        class="text-xs text-slate-500 font-medium italic text-ellipsis whitespace-nowrap overflow-hidden"
-      >
-        Show All
-      </h3>
-    </router-link>
-  </li>
-</template>
-
-<script lang="ts">
-import { Component, Prop, Vue } from "vue-facing-decorator";
-import { RouteLocationRaw } from "vue-router";
-
-/**
- * ShowAllCard - Displays "Show All" navigation for entity grids
- *
- * Features:
- * - Provides navigation to full entity listings
- * - Supports different routes based on entity type
- * - Maintains context through query parameters
- * - Consistent visual styling with other cards
- */
-@Component({ name: "ShowAllCard" })
-export default class ShowAllCard extends Vue {
-  /** Type of entities being shown */
-  @Prop({ required: true })
-  entityType!: "people" | "projects";
-
-  /** Route name to navigate to */
-  @Prop({ required: true })
-  routeName!: string;
-
-  /** Query parameters to pass to the route */
-  @Prop({ default: () => ({}) })
-  queryParams!: Record<string, string>;
-
-  /**
-   * Computed navigation route with query parameters
-   */
-  get navigationRoute(): RouteLocationRaw {
-    return {
-      name: this.routeName,
-      query: this.queryParams,
-    };
-  }
-}
-</script>
-
-<style scoped>
-/* Ensure router-link styling is consistent */
-a {
-  text-decoration: none;
-}
-
-a:hover .fa-circle-right {
-  transform: scale(1.1);
-  transition: transform 0.2s ease;
-}
-</style>

src/components/SpecialEntityCard.vue

@@ -63,23 +63,24 @@ export default class SpecialEntityCard extends Vue {
   conflictContext!: string;
 
   /**
-   * Computed CSS classes for the card container
+   * Computed CSS classes for the card
    */
   get cardClasses(): string {
-    const baseClasses = "block";
+    const baseCardClasses =
+      "flex items-center gap-2 px-2 py-1.5 border-b border-slate-300";
 
     if (!this.selectable || this.conflicted) {
-      return `${baseClasses} cursor-not-allowed opacity-50`;
+      return `${baseCardClasses} *:opacity-50 cursor-not-allowed`;
     }
 
-    return `${baseClasses} cursor-pointer`;
+    return `${baseCardClasses} cursor-pointer hover:bg-slate-50`;
   }
 
   /**
    * Computed CSS classes for the icon
    */
   get iconClasses(): string {
-    const baseClasses = "text-5xl mb-1";
+    const baseClasses = "text-[2rem]";
 
     if (this.conflicted) {
       return `${baseClasses} text-slate-400`;
@@ -101,7 +102,7 @@ export default class SpecialEntityCard extends Vue {
    */
   get nameClasses(): string {
     const baseClasses =
-      "text-xs font-medium text-ellipsis whitespace-nowrap overflow-hidden";
+      "text-sm font-semibold text-ellipsis whitespace-nowrap overflow-hidden";
 
     if (this.conflicted) {
       return `${baseClasses} text-slate-400`;

src/components/TopMessage.vue

@@ -1,16 +1,9 @@
 <template>
   <div
-    class="absolute right-5 top-[max(0.75rem,env(safe-area-inset-top),var(--safe-area-inset-top,0px))]"
+    v-if="message"
+    class="-mt-6 bg-rose-100 border border-t-0 border-dashed border-rose-600 text-rose-900 text-sm text-center font-semibold rounded-b-md px-3 py-2 mb-3"
   >
-    <span class="align-center text-red-500 mr-2">{{ message }}</span>
-    <span class="ml-2">
-      <router-link
-        :to="{ name: 'help' }"
-        class="text-xs uppercase bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] text-white px-1.5 py-1 rounded-md ml-1"
-      >
-        Help
-      </router-link>
-    </span>
+    {{ message }}
   </div>
 </template>
 
@@ -27,8 +20,8 @@ import { logger } from "../utils/logger";
 })
 export default class TopMessage extends Vue {
   // Enhanced PlatformServiceMixin v4.0 provides:
-  // - Cached database operations: this.$contacts(), this.$settings(), this.$accountSettings()
-  // - Settings shortcuts: this.$saveSettings(), this.$saveMySettings()
+  // - Cached database operations: this.$contacts(), this.$accountSettings()
+  // - Settings shortcuts: this.$saveSettings()
   // - Cache management: this.$refreshSettings(), this.$clearAllCaches()
   // - Ultra-concise database methods: this.$db(), this.$exec(), this.$query()
   // - All methods use smart caching with TTL for massive performance gains

src/components/UsageLimitsSection.vue

@@ -8,7 +8,7 @@
     <!-- show spinner if loading limits -->
     <div
       v-if="loadingLimits"
-      class="text-center"
+      class="text-slate-500 text-center italic mb-4"
       role="status"
       aria-live="polite"
     >
@@ -19,7 +19,10 @@
         aria-hidden="true"
       ></font-awesome>
     </div>
-    <div class="mb-4 text-center">
+    <div
+      v-if="limitsMessage"
+      class="bg-amber-200 text-amber-900 border-amber-500 border-dashed border text-center rounded-md overflow-hidden px-4 py-3 mb-4"
+    >
       {{ limitsMessage }}
     </div>
     <div v-if="endorserLimits">

src/components/notifications/DailyNotificationSection.vue

@@ -0,0 +1,781 @@
+<template>
+  <section
+    v-if="notificationsSupported"
+    id="sectionDailyNotifications"
+    class="bg-slate-100 rounded-md overflow-hidden px-4 py-4 mt-8 mb-8"
+    aria-labelledby="dailyNotificationsHeading"
+  >
+    <h2 id="dailyNotificationsHeading" class="mb-2 font-bold">
+      Daily Notifications
+      <button
+        class="text-slate-400 fa-fw cursor-pointer"
+        aria-label="Learn more about native notifications"
+        @click.stop="showNativeNotificationInfo"
+      >
+        <font-awesome icon="circle-question" aria-hidden="true" />
+      </button>
+    </h2>
+
+    <div class="flex items-center justify-between">
+      <div>Daily Notification</div>
+      <!-- Toggle switch -->
+      <div
+        class="relative ml-2 cursor-pointer"
+        role="switch"
+        :aria-checked="nativeNotificationEnabled"
+        :aria-label="
+          nativeNotificationEnabled
+            ? 'Disable daily notifications'
+            : 'Enable daily notifications'
+        "
+        tabindex="0"
+        @click="toggleNativeNotification"
+      >
+        <!-- input -->
+        <input
+          :checked="nativeNotificationEnabled"
+          type="checkbox"
+          class="sr-only"
+          tabindex="-1"
+          readonly
+        />
+        <!-- line -->
+        <div
+          class="block bg-slate-500 w-14 h-8 rounded-full transition"
+          :class="{
+            'bg-blue-600': nativeNotificationEnabled,
+          }"
+        ></div>
+        <!-- dot -->
+        <div
+          class="dot absolute left-1 top-1 bg-slate-400 w-6 h-6 rounded-full transition"
+          :class="{
+            'left-7 bg-white': nativeNotificationEnabled,
+          }"
+        ></div>
+      </div>
+    </div>
+
+    <!-- Show "Open Settings" button when permissions are denied -->
+    <div
+      v-if="
+        notificationsSupported &&
+        notificationStatus &&
+        notificationStatus.permissions.notifications === 'denied'
+      "
+      class="mt-2"
+    >
+      <button
+        class="w-full px-3 py-2 bg-blue-600 text-white rounded text-sm font-medium"
+        @click="openNotificationSettings"
+      >
+        Open Settings
+      </button>
+      <p class="text-xs text-slate-500 mt-1 text-center">
+        Enable notifications in Settings > App info > Notifications
+      </p>
+    </div>
+
+    <!-- Time input section - show when enabled OR when no time is set -->
+    <div
+      v-if="nativeNotificationEnabled || !nativeNotificationTimeStorage"
+      class="mt-2"
+    >
+      <div
+        v-if="nativeNotificationEnabled"
+        class="flex items-center justify-between mb-2"
+      >
+        <span
+          >Scheduled for:
+          <span v-if="nativeNotificationTime">{{
+            nativeNotificationTime
+          }}</span>
+          <span v-else class="text-slate-500">Not set</span></span
+        >
+        <button
+          class="text-blue-500 text-sm"
+          @click="editNativeNotificationTime"
+        >
+          {{ showTimeEdit ? "Cancel" : "Edit Time" }}
+        </button>
+      </div>
+
+      <!-- Time input (shown when editing or when no time is set) -->
+      <div v-if="showTimeEdit || !nativeNotificationTimeStorage" class="mt-2">
+        <label class="block text-sm text-slate-600 mb-1">
+          Notification Time
+        </label>
+        <div class="flex items-center gap-2">
+          <input
+            v-model="nativeNotificationTimeStorage"
+            type="time"
+            class="rounded border border-slate-400 px-2 py-2"
+            @change="onTimeChange"
+          />
+          <button
+            v-if="showTimeEdit || nativeNotificationTimeStorage"
+            class="px-3 py-2 bg-blue-600 text-white rounded"
+            @click="saveTimeChange"
+          >
+            Save
+          </button>
+        </div>
+        <p
+          v-if="!nativeNotificationTimeStorage"
+          class="text-xs text-slate-500 mt-1"
+        >
+          Set a time before enabling notifications
+        </p>
+      </div>
+    </div>
+
+    <!-- Loading state -->
+    <div v-if="loading" class="mt-2 text-sm text-slate-500">Loading...</div>
+  </section>
+</template>
+
+<script lang="ts">
+/**
+ * DailyNotificationSection Component
+ *
+ * A self-contained component for managing daily notification scheduling
+ * in AccountViewView. This component handles platform detection, permission
+ * requests, scheduling, and state management for daily notifications.
+ *
+ * Features:
+ * - Platform capability detection (hides on unsupported platforms)
+ * - Permission request flow
+ * - Schedule/cancel notifications
+ * - Time editing with HTML5 time input
+ * - Settings persistence
+ * - Plugin state synchronization
+ *
+ * @author Generated for TimeSafari Daily Notification Integration
+ * @component
+ */
+
+import { Component, Vue } from "vue-facing-decorator";
+import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
+import { logger } from "@/utils/logger";
+import { PlatformServiceFactory } from "@/services/PlatformServiceFactory";
+import type {
+  NotificationStatus,
+  PermissionStatus,
+} from "@/services/PlatformService";
+import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
+import type { NotificationIface } from "@/constants/app";
+
+/**
+ * Convert 24-hour time format ("09:00") to 12-hour display format ("9:00 AM")
+ */
+function formatTimeForDisplay(time24: string): string {
+  if (!time24) return "";
+  const [hours, minutes] = time24.split(":");
+  const hourNum = parseInt(hours);
+  const isPM = hourNum >= 12;
+  const displayHour =
+    hourNum === 0 ? 12 : hourNum > 12 ? hourNum - 12 : hourNum;
+  return `${displayHour}:${minutes} ${isPM ? "PM" : "AM"}`;
+}
+
+@Component({
+  name: "DailyNotificationSection",
+  mixins: [PlatformServiceMixin],
+})
+export default class DailyNotificationSection extends Vue {
+  $notify!: (notification: NotificationIface, timeout?: number) => void;
+
+  // Component state
+  notificationsSupported: boolean = false;
+  nativeNotificationEnabled: boolean = false;
+  nativeNotificationTime: string = ""; // Display format: "9:00 AM"
+  nativeNotificationTimeStorage: string = ""; // Plugin format: "09:00"
+  nativeNotificationTitle: string = "Daily Update";
+  nativeNotificationMessage: string = "Your daily notification is ready!";
+  showTimeEdit: boolean = false;
+  loading: boolean = false;
+  notificationStatus: NotificationStatus | null = null;
+
+  // Notify helpers
+  private notify!: ReturnType<typeof createNotifyHelpers>;
+
+  async created(): Promise<void> {
+    this.notify = createNotifyHelpers(this.$notify);
+  }
+
+  /**
+   * Initialize component state on mount
+   * Checks platform support and syncs with plugin state
+   *
+   * **Token Refresh on Mount:**
+   * - Refreshes native fetcher configuration to ensure plugin has valid token
+   * - This handles cases where app was closed for extended periods
+   * - Token refresh happens automatically without user interaction
+   *
+   * **App Resume Listener:**
+   * - Listens for Capacitor 'resume' event to refresh token when app comes to foreground
+   * - Ensures plugin always has fresh token for background prefetch operations
+   * - Cleaned up in `beforeDestroy()` lifecycle hook
+   */
+  async mounted(): Promise<void> {
+    await this.initializeState();
+    // Refresh native fetcher configuration on mount
+    // This ensures plugin has valid token even if app was closed for extended periods
+    await this.refreshNativeFetcherConfig();
+    // Listen for app resume events to refresh token when app comes to foreground
+    // This is part of the proactive token refresh strategy
+    document.addEventListener("resume", this.handleAppResume);
+  }
+
+  /**
+   * Cleanup on component destroy
+   */
+  beforeDestroy(): void {
+    document.removeEventListener("resume", this.handleAppResume);
+  }
+
+  /**
+   * Handle app resume event - refresh native fetcher configuration
+   *
+   * This method is called when the app comes to foreground (via Capacitor 'resume' event).
+   * It proactively refreshes the JWT token to ensure the plugin has valid authentication
+   * for background prefetch operations.
+   *
+   * **Why refresh on resume?**
+   * - Tokens expire after 72 hours
+   * - App may have been closed for extended periods
+   * - Refreshing ensures plugin has valid token for next prefetch cycle
+   * - No user interaction required - happens automatically
+   *
+   * @see {@link refreshNativeFetcherConfig} For implementation details
+   */
+  async handleAppResume(): Promise<void> {
+    logger.debug(
+      "[DailyNotificationSection] App resumed, refreshing native fetcher config",
+    );
+    await this.refreshNativeFetcherConfig();
+  }
+
+  /**
+   * Refresh native fetcher configuration with fresh JWT token
+   *
+   * This method ensures the daily notification plugin has a valid authentication token
+   * for background prefetch operations. It's called proactively to prevent token expiration
+   * issues during offline periods.
+   *
+   * **Refresh Triggers:**
+   * - Component mount (when notification settings page loads)
+   * - App resume (when app comes to foreground)
+   * - Notification enabled (when user enables daily notifications)
+   *
+   * **Token Refresh Strategy (Hybrid Approach):**
+   * - Tokens are valid for 72 hours (see `accessTokenForBackground`)
+   * - Tokens are refreshed proactively when app is already open
+   * - If token expires while offline, plugin uses cached content
+   * - Next time app opens, token is automatically refreshed
+   *
+   * **Why This Approach?**
+   * - No app wake-up required (tokens refresh when app is already open)
+   * - Works offline (72-hour validity supports extended offline periods)
+   * - Automatic (no user interaction required)
+   * - Includes starred plans (fetcher receives user's starred plans for prefetch)
+   * - Graceful degradation (if refresh fails, cached content still works)
+   *
+   * **Error Handling:**
+   * - Errors are logged but not shown to user (background operation)
+   * - Returns early if notifications not supported or disabled
+   * - Returns early if API server not configured
+   * - Failures don't interrupt user experience
+   *
+   * @returns Promise that resolves when refresh completes (or fails silently)
+   *
+   * @example
+   * ```typescript
+   * // Called automatically on mount/resume
+   * await this.refreshNativeFetcherConfig();
+   * ```
+   *
+   * @see {@link CapacitorPlatformService.configureNativeFetcher} For token generation
+   * @see {@link accessTokenForBackground} For 72-hour token generation
+   */
+  async refreshNativeFetcherConfig(): Promise<void> {
+    try {
+      const platformService = PlatformServiceFactory.getInstance();
+
+      // Early return: Only refresh if notifications are supported and enabled
+      // This prevents unnecessary work when notifications aren't being used
+      if (!this.notificationsSupported || !this.nativeNotificationEnabled) {
+        return;
+      }
+
+      // Get settings for API server and starred plans
+      // API server tells plugin where to fetch content from
+      // Starred plans tell plugin which plans to prefetch
+      const settings = await this.$accountSettings();
+      const apiServer = settings.apiServer || "";
+
+      if (!apiServer) {
+        logger.warn(
+          "[DailyNotificationSection] No API server configured, skipping native fetcher refresh",
+        );
+        return;
+      }
+
+      // Get starred plans from settings
+      // These are passed to the plugin so it knows which plans to prefetch
+      const starredPlanHandleIds = settings.starredPlanHandleIds || [];
+
+      // Configure native fetcher with fresh token
+      // The jwt parameter is ignored - configureNativeFetcher generates it automatically
+      // This ensures we always have a fresh token with current expiration time
+      await platformService.configureNativeFetcher({
+        apiServer,
+        jwt: "", // Will be generated automatically by configureNativeFetcher
+        starredPlanHandleIds,
+      });
+
+      logger.info(
+        "[DailyNotificationSection] Native fetcher configuration refreshed",
+      );
+    } catch (error) {
+      // Don't show error to user - this is a background operation
+      // Failures are logged for debugging but don't interrupt user experience
+      // If refresh fails, plugin will use existing token (if still valid) or cached content
+      logger.error(
+        "[DailyNotificationSection] Failed to refresh native fetcher config:",
+        error,
+      );
+    }
+  }
+
+  /**
+   * Initialize component state
+   * Checks platform support and syncs with plugin state
+   */
+  async initializeState(): Promise<void> {
+    try {
+      this.loading = true;
+      const platformService = PlatformServiceFactory.getInstance();
+
+      logger.debug(
+        "[DailyNotificationSection] Checking notification support...",
+      );
+
+      // Check if notifications are supported on this platform
+      // This also verifies plugin availability (returns null if plugin unavailable)
+      const status = await platformService.getDailyNotificationStatus();
+      if (status === null) {
+        // Notifications not supported or plugin unavailable - don't initialize
+        this.notificationsSupported = false;
+        logger.warn(
+          "[DailyNotificationSection] Notifications not supported or plugin unavailable - section will be hidden",
+        );
+        return;
+      }
+
+      logger.debug(
+        "[DailyNotificationSection] Notifications supported, status:",
+        status,
+      );
+
+      this.notificationsSupported = true;
+      this.notificationStatus = status;
+
+      // Plugin state is the source of truth
+      if (status.isScheduled && status.scheduledTime) {
+        // Plugin has a scheduled notification - sync UI to match
+        this.nativeNotificationEnabled = true;
+        this.nativeNotificationTimeStorage = status.scheduledTime;
+        this.nativeNotificationTime = formatTimeForDisplay(
+          status.scheduledTime,
+        );
+      } else {
+        // No plugin schedule - UI defaults to disabled
+        this.nativeNotificationEnabled = false;
+        this.nativeNotificationTimeStorage = "";
+        this.nativeNotificationTime = "";
+      }
+    } catch (error) {
+      logger.error("[DailyNotificationSection] Failed to initialize:", error);
+      this.notificationsSupported = false;
+    } finally {
+      this.loading = false;
+    }
+  }
+
+  /**
+   * Toggle notification on/off
+   */
+  async toggleNativeNotification(): Promise<void> {
+    // Prevent multiple simultaneous toggles
+    if (this.loading) {
+      logger.warn(
+        "[DailyNotificationSection] Toggle ignored - operation in progress",
+      );
+      return;
+    }
+
+    logger.info(
+      `[DailyNotificationSection] Toggling notification: ${this.nativeNotificationEnabled} -> ${!this.nativeNotificationEnabled}`,
+    );
+
+    if (this.nativeNotificationEnabled) {
+      await this.disableNativeNotification();
+    } else {
+      await this.enableNativeNotification();
+    }
+  }
+
+  /**
+   * Enable daily notification
+   */
+  async enableNativeNotification(): Promise<void> {
+    try {
+      this.loading = true;
+      const platformService = PlatformServiceFactory.getInstance();
+
+      // Check if we have a time set
+      if (!this.nativeNotificationTimeStorage) {
+        this.notify.error(
+          "Please set a notification time first",
+          TIMEOUTS.SHORT,
+        );
+        this.loading = false;
+        return;
+      }
+
+      // Check permissions first - this also verifies plugin availability
+      let permissions: PermissionStatus | null;
+      try {
+        permissions = await platformService.checkNotificationPermissions();
+        logger.info(
+          `[DailyNotificationSection] Permission check result:`,
+          permissions,
+        );
+      } catch (error) {
+        // Plugin may not be available or there's an error
+        logger.error(
+          "[DailyNotificationSection] Failed to check permissions (plugin may be unavailable):",
+          error,
+        );
+        this.notify.error(
+          "Unable to check notification permissions. The notification plugin may not be installed.",
+          TIMEOUTS.LONG,
+        );
+        this.nativeNotificationEnabled = false;
+        return;
+      }
+
+      if (permissions === null) {
+        // Platform doesn't support notifications or plugin unavailable
+        logger.warn(
+          "[DailyNotificationSection] Notifications not supported or plugin unavailable",
+        );
+        this.notify.error(
+          "Notifications are not supported on this platform or the plugin is not installed.",
+          TIMEOUTS.SHORT,
+        );
+        this.nativeNotificationEnabled = false;
+        return;
+      }
+
+      logger.info(
+        `[DailyNotificationSection] Permission state: ${permissions.notifications}`,
+      );
+
+      // If permissions are explicitly denied, don't try to request again
+      // (this prevents the plugin crash when handling denied permissions)
+      // Android won't show the dialog again if permissions are permanently denied
+      if (permissions.notifications === "denied") {
+        logger.warn(
+          "[DailyNotificationSection] Permissions already denied, directing user to settings",
+        );
+        this.notify.error(
+          "Notification permissions were denied. Tap 'Open Settings' to enable them.",
+          TIMEOUTS.LONG,
+        );
+        this.nativeNotificationEnabled = false;
+        return;
+      }
+
+      // Only request if permissions are in "prompt" state (not denied, not granted)
+      // This ensures we only call requestPermissions when Android will actually show a dialog
+      if (permissions.notifications === "prompt") {
+        logger.info(
+          "[DailyNotificationSection] Permission state is 'prompt', requesting permissions...",
+        );
+        try {
+          const result = await platformService.requestNotificationPermissions();
+          logger.info(
+            `[DailyNotificationSection] Permission request result:`,
+            result,
+          );
+          if (result === null) {
+            // Plugin unavailable or request failed
+            logger.error(
+              "[DailyNotificationSection] Permission request returned null",
+            );
+            this.notify.error(
+              "Unable to request notification permissions. The plugin may not be available.",
+              TIMEOUTS.LONG,
+            );
+            this.nativeNotificationEnabled = false;
+            return;
+          }
+          if (!result.notifications) {
+            // Permission request was denied
+            logger.warn(
+              "[DailyNotificationSection] Permission request denied by user",
+            );
+            this.notify.error(
+              "Notification permissions are required. Tap 'Open Settings' to enable them.",
+              TIMEOUTS.LONG,
+            );
+            this.nativeNotificationEnabled = false;
+            return;
+          }
+          // Permissions granted - continue
+          logger.info(
+            "[DailyNotificationSection] Permissions granted successfully",
+          );
+        } catch (error) {
+          // Handle permission request errors (including plugin crashes)
+          logger.error(
+            "[DailyNotificationSection] Permission request failed:",
+            error,
+          );
+          this.notify.error(
+            "Unable to request notification permissions. Tap 'Open Settings' to enable them.",
+            TIMEOUTS.LONG,
+          );
+          this.nativeNotificationEnabled = false;
+          return;
+        }
+      } else if (permissions.notifications !== "granted") {
+        // Unexpected state - shouldn't happen, but handle gracefully
+        logger.warn(
+          `[DailyNotificationSection] Unexpected permission state: ${permissions.notifications}`,
+        );
+        this.notify.error(
+          "Unable to determine notification permission status. Tap 'Open Settings' to check.",
+          TIMEOUTS.LONG,
+        );
+        this.nativeNotificationEnabled = false;
+        return;
+      } else {
+        logger.info("[DailyNotificationSection] Permissions already granted");
+      }
+
+      // Permissions are granted - continue with scheduling
+
+      // Schedule notification via PlatformService
+      await platformService.scheduleDailyNotification({
+        time: this.nativeNotificationTimeStorage, // "09:00" in local time
+        title: this.nativeNotificationTitle,
+        body: this.nativeNotificationMessage,
+        sound: true,
+        priority: "high",
+      });
+
+      // Update UI state
+      this.nativeNotificationEnabled = true;
+
+      // Refresh native fetcher configuration with fresh token
+      // This ensures plugin has valid authentication when notifications are first enabled
+      // Token will be valid for 72 hours, supporting offline prefetch operations
+      await this.refreshNativeFetcherConfig();
+
+      this.notify.success(
+        "Daily notification scheduled successfully",
+        TIMEOUTS.SHORT,
+      );
+    } catch (error) {
+      logger.error(
+        "[DailyNotificationSection] Failed to enable notification:",
+        error,
+      );
+      this.notify.error(
+        "Failed to schedule notification. Please try again.",
+        TIMEOUTS.LONG,
+      );
+      this.nativeNotificationEnabled = false;
+    } finally {
+      this.loading = false;
+    }
+  }
+
+  /**
+   * Disable daily notification
+   */
+  async disableNativeNotification(): Promise<void> {
+    try {
+      this.loading = true;
+      const platformService = PlatformServiceFactory.getInstance();
+
+      // Cancel notification via PlatformService
+      await platformService.cancelDailyNotification();
+
+      // Update UI state
+      this.nativeNotificationEnabled = false;
+      this.nativeNotificationTime = "";
+      this.nativeNotificationTimeStorage = "";
+      this.showTimeEdit = false;
+
+      this.notify.success("Daily notification disabled", TIMEOUTS.SHORT);
+    } catch (error) {
+      logger.error(
+        "[DailyNotificationSection] Failed to disable notification:",
+        error,
+      );
+      this.notify.error(
+        "Failed to disable notification. Please try again.",
+        TIMEOUTS.LONG,
+      );
+    } finally {
+      this.loading = false;
+    }
+  }
+
+  /**
+   * Show/hide time edit input
+   */
+  editNativeNotificationTime(): void {
+    this.showTimeEdit = !this.showTimeEdit;
+  }
+
+  /**
+   * Handle time input change
+   */
+  onTimeChange(): void {
+    // Time is already in nativeNotificationTimeStorage via v-model
+    // Just update display format
+    if (this.nativeNotificationTimeStorage) {
+      this.nativeNotificationTime = formatTimeForDisplay(
+        this.nativeNotificationTimeStorage,
+      );
+    }
+  }
+
+  /**
+   * Save time change and update notification schedule
+   */
+  async saveTimeChange(): Promise<void> {
+    if (!this.nativeNotificationTimeStorage) {
+      this.notify.error("Please select a time", TIMEOUTS.SHORT);
+      return;
+    }
+
+    // Update display format
+    this.nativeNotificationTime = formatTimeForDisplay(
+      this.nativeNotificationTimeStorage,
+    );
+
+    // If notification is enabled, update the schedule
+    if (this.nativeNotificationEnabled) {
+      await this.updateNotificationTime(this.nativeNotificationTimeStorage);
+    } else {
+      // Just update local state (time preference stored in component)
+      this.showTimeEdit = false;
+      this.notify.success("Notification time saved", TIMEOUTS.SHORT);
+    }
+  }
+
+  /**
+   * Update notification time
+   * If notification is enabled, immediately updates the schedule
+   */
+  async updateNotificationTime(newTime: string): Promise<void> {
+    // newTime is in "HH:mm" format from HTML5 time input
+    if (!this.nativeNotificationEnabled) {
+      // If notification is disabled, just update local state
+      this.nativeNotificationTimeStorage = newTime;
+      this.nativeNotificationTime = formatTimeForDisplay(newTime);
+      this.showTimeEdit = false;
+      return;
+    }
+
+    // Notification is enabled - update the schedule
+    try {
+      this.loading = true;
+      const platformService = PlatformServiceFactory.getInstance();
+
+      // 1. Cancel existing notification
+      await platformService.cancelDailyNotification();
+
+      // 2. Schedule with new time
+      await platformService.scheduleDailyNotification({
+        time: newTime, // "09:00" in local time
+        title: this.nativeNotificationTitle,
+        body: this.nativeNotificationMessage,
+        sound: true,
+        priority: "high",
+      });
+
+      // 3. Update local state
+      this.nativeNotificationTimeStorage = newTime;
+      this.nativeNotificationTime = formatTimeForDisplay(newTime);
+
+      this.notify.success(
+        "Notification time updated successfully",
+        TIMEOUTS.SHORT,
+      );
+      this.showTimeEdit = false;
+    } catch (error) {
+      logger.error(
+        "[DailyNotificationSection] Failed to update notification time:",
+        error,
+      );
+      this.notify.error(
+        "Failed to update notification time. Please try again.",
+        TIMEOUTS.LONG,
+      );
+    } finally {
+      this.loading = false;
+    }
+  }
+
+  /**
+   * Show info dialog about native notifications
+   */
+  showNativeNotificationInfo(): void {
+    // TODO: Implement info dialog or navigate to help page
+    this.notify.info(
+      "Daily notifications use your device's native notification system. They work even when the app is closed.",
+      TIMEOUTS.STANDARD,
+    );
+  }
+
+  /**
+   * Open app notification settings
+   */
+  async openNotificationSettings(): Promise<void> {
+    try {
+      const platformService = PlatformServiceFactory.getInstance();
+      const result = await platformService.openAppNotificationSettings();
+      if (result === null) {
+        this.notify.error(
+          "Unable to open settings. Please go to Settings > Apps > TimeSafari > Notifications manually.",
+          TIMEOUTS.LONG,
+        );
+      } else {
+        this.notify.success("Opening notification settings...", TIMEOUTS.SHORT);
+      }
+    } catch (error) {
+      logger.error(
+        "[DailyNotificationSection] Failed to open notification settings:",
+        error,
+      );
+      this.notify.error(
+        "Unable to open settings. Please go to Settings > Apps > TimeSafari > Notifications manually.",
+        TIMEOUTS.LONG,
+      );
+    }
+  }
+}
+</script>
+
+<style scoped>
+.dot {
+  transition: left 0.2s ease;
+}
+</style>

src/constants/accountView.ts

@@ -86,7 +86,7 @@ export const ACCOUNT_VIEW_CONSTANTS = {
     CANNOT_UPLOAD_IMAGES: "You cannot upload images.",
     BAD_SERVER_RESPONSE: "Bad server response.",
     ERROR_RETRIEVING_LIMITS:
-      "No limits were found, so no actions are allowed. You will need to get registered.",
+      "No limits were found, so no actions are allowed. You need to get registered.",
   },
 
   // Project assignment errors

src/constants/app.ts

@@ -59,7 +59,7 @@ export const PASSKEYS_ENABLED =
 export interface NotificationIface {
   group: string; // "alert" | "modal"
   type: string; // "toast" | "info" | "success" | "warning" | "danger"
-  title: string;
+  title?: string;
   text?: string;
   callback?: (success: boolean) => Promise<void>; // if this triggered an action
   noText?: string;
@@ -68,4 +68,11 @@ export interface NotificationIface {
   onYes?: () => Promise<void>;
   promptToStopAsking?: boolean;
   yesText?: string;
+  membersData?: Array<{
+    member: { admitted: boolean; content: string; memberId: number };
+    name: string;
+    did: string;
+    isContact: boolean;
+    contact?: { did: string; name?: string; seesMe?: boolean };
+  }>; // For passing member data to visibility dialog
 }

src/constants/notifications.ts

@@ -510,14 +510,6 @@ export const NOTIFY_REGISTER_CONTACT = {
   text: "Do you want to register them?",
 };
 
-// Used in: ContactsView.vue (showOnboardMeetingDialog method - complex modal for onboarding meeting)
-export const NOTIFY_ONBOARDING_MEETING = {
-  title: "Onboarding Meeting",
-  text: "Would you like to start a new meeting?",
-  yesText: "Start New Meeting",
-  noText: "Join Existing Meeting",
-};
-
 // TestView.vue specific constants
 // Used in: TestView.vue (executeSql method - SQL error handling)
 export const NOTIFY_SQL_ERROR = {

src/db-sql/migration.ts

@@ -68,13 +68,21 @@ const MIG_004_SQL = `
   WHERE id = 1 
   AND EXISTS (SELECT 1 FROM settings WHERE id = 1 AND activeDid IS NOT NULL AND activeDid != '');
   
+  -- Copy important settings that were set in the MASTER_SETTINGS_KEY to the main identity.
+  -- (We're not doing them all because some were already identity-specific and others aren't as critical.)
+  UPDATE settings
+  SET lastViewedClaimId = (SELECT lastViewedClaimId FROM settings WHERE id = 1),
+      profileImageUrl = (SELECT profileImageUrl FROM settings WHERE id = 1),
+      showShortcutBvc = (SELECT showShortcutBvc FROM settings WHERE id = 1),
+      warnIfProdServer = (SELECT warnIfProdServer FROM settings WHERE id = 1),
+      warnIfTestServer = (SELECT warnIfTestServer FROM settings WHERE id = 1)
+  WHERE id = 2;
+
   -- CLEANUP: Remove orphaned settings records and clear legacy activeDid values
+  -- which usually simply deletes the MASTER_SETTINGS_KEY record.
   -- This completes the migration from settings-based to table-based active identity
-  -- Use guarded operations to prevent accidental data loss
-  DELETE FROM settings WHERE accountDid IS NULL AND id != 1;
-  UPDATE settings SET activeDid = NULL WHERE id = 1 AND EXISTS (
-    SELECT 1 FROM active_identity WHERE id = 1 AND activeDid IS NOT NULL
-  );
+  DELETE FROM settings WHERE accountDid IS NULL;
+  UPDATE settings SET activeDid = NULL;
 `;
 
 // Each migration can include multiple SQL statements (with semicolons)
@@ -184,6 +192,13 @@ const MIGRATIONS = [
     name: "004_active_identity_management",
     sql: MIG_004_SQL,
   },
+  {
+    name: "005_add_starredPlanHandleIds_to_settings",
+    sql: `
+      ALTER TABLE settings ADD COLUMN starredPlanHandleIds TEXT DEFAULT '[]'; -- JSON string
+      ALTER TABLE settings ADD COLUMN lastAckedStarredPlanChangesJwtId TEXT;
+    `,
+  },
 ];
 
 /**
@@ -219,32 +234,20 @@ export async function runMigrations<T>(
   sqlQuery: (sql: string, params?: unknown[]) => Promise<T>,
   extractMigrationNames: (result: T) => Set<string>,
 ): Promise<void> {
-  // Only log migration start in development
-  const isDevelopment = process.env.VITE_PLATFORM === "development";
-  if (isDevelopment) {
-    logger.debug("[Migration] Starting database migrations");
-  }
+  logger.debug("[Migration] Starting database migrations");
 
   for (const migration of MIGRATIONS) {
-    if (isDevelopment) {
-      logger.debug("[Migration] Registering migration:", migration.name);
-    }
+    logger.debug("[Migration] Registering migration:", migration.name);
     registerMigration(migration);
   }
 
-  if (isDevelopment) {
-    logger.debug("[Migration] Running migration service");
-  }
+  logger.debug("[Migration] Running migration service");
   await runMigrationsService(sqlExec, sqlQuery, extractMigrationNames);
 
-  if (isDevelopment) {
-    logger.debug("[Migration] Database migrations completed");
-  }
+  logger.debug("[Migration] Database migrations completed");
 
   // Bootstrapping: Ensure active account is selected after migrations
-  if (isDevelopment) {
-    logger.debug("[Migration] Running bootstrapping hooks");
-  }
+  logger.debug("[Migration] Running bootstrapping hooks");
   try {
     // Check if we have accounts but no active selection
     const accountsResult = await sqlQuery("SELECT COUNT(*) FROM accounts");
@@ -259,18 +262,14 @@ export async function runMigrations<T>(
       activeDid = (extractSingleValue(activeResult) as string) || null;
     } catch (error) {
       // Table doesn't exist - migration 004 may not have run yet
-      if (isDevelopment) {
-        logger.debug(
-          "[Migration] active_identity table not found - migration may not have run",
-        );
-      }
+      logger.debug(
+        "[Migration] active_identity table not found - migration may not have run",
+      );
       activeDid = null;
     }
 
     if (accountsCount > 0 && (!activeDid || activeDid === "")) {
-      if (isDevelopment) {
-        logger.debug("[Migration] Auto-selecting first account as active");
-      }
+      logger.debug("[Migration] Auto-selecting first account as active");
       const firstAccountResult = await sqlQuery(
         "SELECT did FROM accounts ORDER BY dateCreated, did LIMIT 1",
       );

src/db/databaseUtil.ts

@@ -9,34 +9,6 @@ import { logger } from "@/utils/logger";
 import { DEFAULT_ENDORSER_API_SERVER } from "@/constants/app";
 import { QueryExecResult } from "@/interfaces/database";
 
-export async function updateDefaultSettings(
-  settingsChanges: Settings,
-): Promise<boolean> {
-  delete settingsChanges.accountDid; // just in case
-  // ensure there is no "id" that would override the key
-  delete settingsChanges.id;
-  try {
-    const platformService = PlatformServiceFactory.getInstance();
-    const { sql, params } = generateUpdateStatement(
-      settingsChanges,
-      "settings",
-      "id = ?",
-      [MASTER_SETTINGS_KEY],
-    );
-    const result = await platformService.dbExec(sql, params);
-    return result.changes === 1;
-  } catch (error) {
-    logger.error("Error updating default settings:", error);
-    if (error instanceof Error) {
-      throw error; // Re-throw if it's already an Error with a message
-    } else {
-      throw new Error(
-        `Failed to update settings. We recommend you try again or restart the app.`,
-      );
-    }
-  }
-}
-
 export async function insertDidSpecificSettings(
   did: string,
   settings: Partial<Settings> = {},
@@ -91,6 +63,7 @@ export async function updateDidSpecificSettings(
     ? mapColumnsToValues(postUpdateResult.columns, postUpdateResult.values)[0]
     : null;
 
+  // Note that we want to eliminate this check (and fix the above if it doesn't work).
   // Check if any of the target fields were actually changed
   let actuallyUpdated = false;
   if (currentRecord && updatedRecord) {
@@ -157,10 +130,11 @@ export async function retrieveSettingsForDefaultAccount(): Promise<Settings> {
       result.columns,
       result.values,
     )[0] as Settings;
-    if (settings.searchBoxes) {
-      // @ts-expect-error - the searchBoxes field is a string in the DB
-      settings.searchBoxes = JSON.parse(settings.searchBoxes);
-    }
+    settings.searchBoxes = parseJsonField(settings.searchBoxes, []);
+    settings.starredPlanHandleIds = parseJsonField(
+      settings.starredPlanHandleIds,
+      [],
+    );
     return settings;
   }
 }
@@ -226,10 +200,11 @@ export async function retrieveSettingsForActiveAccount(): Promise<Settings> {
         );
       }
 
-      // Handle searchBoxes parsing
-      if (settings.searchBoxes) {
-        settings.searchBoxes = parseJsonField(settings.searchBoxes, []);
-      }
+      settings.searchBoxes = parseJsonField(settings.searchBoxes, []);
+      settings.starredPlanHandleIds = parseJsonField(
+        settings.starredPlanHandleIds,
+        [],
+      );
 
       return settings;
     } catch (error) {

src/db/tables/settings.ts

@@ -43,6 +43,7 @@ export type Settings = {
 
   lastAckedOfferToUserJwtId?: string; // the last JWT ID for offer-to-user that they've acknowledged seeing
   lastAckedOfferToUserProjectsJwtId?: string; // the last JWT ID for offers-to-user's-projects that they've acknowledged seeing
+  lastAckedStarredPlanChangesJwtId?: string; // the last JWT ID for starred plan changes that they've acknowledged seeing
 
   // The claim list has a most recent one used in notifications that's separate from the last viewed
   lastNotifiedClaimId?: string;
@@ -67,15 +68,18 @@ export type Settings = {
   showContactGivesInline?: boolean; // Display contact inline or not
   showGeneralAdvanced?: boolean; // Show advanced features which don't have their own flag
   showShortcutBvc?: boolean; // Show shortcut for Bountiful Voluntaryist Community actions
+
+  starredPlanHandleIds?: string[]; // Array of starred plan handle IDs
   vapid?: string; // VAPID (Voluntary Application Server Identification) field for web push
   warnIfProdServer?: boolean; // Warn if using a production server
   warnIfTestServer?: boolean; // Warn if using a testing server
   webPushServer?: string; // Web Push server URL
 };
 
-// type of settings where the searchBoxes are JSON strings instead of objects
+// type of settings where the values are JSON strings instead of objects
 export type SettingsWithJsonStrings = Settings & {
   searchBoxes: string;
+  starredPlanHandleIds: string;
 };
 
 export function checkIsAnyFeedFilterOn(settings: Settings): boolean {
@@ -92,6 +96,11 @@ export const SettingsSchema = {
 /**
  * Constants.
  */
+
+/**
+ * This is deprecated.
+ * It only remains for those with a PWA who have not migrated, but we'll soon remove it.
+ */
 export const MASTER_SETTINGS_KEY = "1";
 
 export const DEFAULT_PASSKEY_EXPIRATION_MINUTES = 15;

src/interfaces/claims.ts

@@ -14,6 +14,13 @@ export interface AgreeActionClaim extends ClaimObject {
   object: Record<string, unknown>;
 }
 
+export interface EmojiClaim extends ClaimObject {
+  // default context is "https://endorser.ch"
+  "@type": "Emoji";
+  text: string;
+  parentItem: { lastClaimId: string };
+}
+
 // Note that previous VCs may have additional fields.
 // https://endorser.ch/doc/html/transactions.html#id4
 export interface GiveActionClaim extends ClaimObject {
@@ -72,11 +79,15 @@ export interface PlanActionClaim extends ClaimObject {
   name: string;
   agent?: { identifier: string };
   description?: string;
+  endTime?: string;
   identifier?: string;
+  image?: string;
   lastClaimId?: string;
   location?: {
     geo: { "@type": "GeoCoordinates"; latitude: number; longitude: number };
   };
+  startTime?: string;
+  url?: string;
 }
 
 // AKA Registration & RegisterAction

src/interfaces/common.ts

@@ -70,18 +70,11 @@ export interface AxiosErrorResponse {
   [key: string]: unknown;
 }
 
-export interface UserInfo {
-  did: string;
-  name: string;
-  publicEncKey: string;
-  registered: boolean;
-  profileImageUrl?: string;
-  nextPublicEncKeyHash?: string;
-}
-
 export interface CreateAndSubmitClaimResult {
   success: boolean;
+  embeddedRecordError?: string;
   error?: string;
+  claimId?: string;
   handleId?: string;
 }
 

src/interfaces/index.ts

@@ -1,36 +1,7 @@
-export type {
-  // From common.ts
-  CreateAndSubmitClaimResult,
-  GenericCredWrapper,
-  GenericVerifiableCredential,
-  KeyMeta,
-  // Exclude types that are also exported from other files
-  // GiveVerifiableCredential,
-  // OfferVerifiableCredential,
-  // RegisterVerifiableCredential,
-  // PlanSummaryRecord,
-  // UserInfo,
-} from "./common";
-
-export type {
-  // From claims.ts
-  GiveActionClaim,
-  OfferClaim,
-  RegisterActionClaim,
-} from "./claims";
-
-export type {
-  // From records.ts
-  PlanSummaryRecord,
-} from "./records";
-
-export type {
-  // From user.ts
-  UserInfo,
-} from "./user";
-
-export * from "./limits";
-export * from "./deepLinks";
-export * from "./common";
+export * from "./claims";
 export * from "./claims-result";
+export * from "./common";
+export * from "./deepLinks";
+export * from "./limits";
 export * from "./records";
+export * from "./user";

src/interfaces/records.ts

@@ -1,13 +1,26 @@
-import { GiveActionClaim, OfferClaim } from "./claims";
+import { GiveActionClaim, OfferClaim, PlanActionClaim } from "./claims";
+import { GenericCredWrapper } from "./common";
+
+export interface EmojiSummaryRecord {
+  issuerDid: string;
+  jwtId: string;
+  text: string;
+  parentHandleId: string;
+}
 
 // a summary record; the VC is found the fullClaim field
 export interface GiveSummaryRecord {
-  [x: string]: PropertyKey | undefined | GiveActionClaim;
+  [x: string]:
+    | PropertyKey
+    | undefined
+    | GiveActionClaim
+    | Record<string, number>;
   type?: string;
   agentDid: string;
   amount: number;
   amountConfirmed: number;
   description: string;
+  emojiCount: Record<string, number>; // Map of emoji character to count
   fullClaim: GiveActionClaim;
   fulfillsHandleId: string;
   fulfillsPlanHandleId?: string;
@@ -61,6 +74,11 @@ export interface PlanSummaryRecord {
   jwtId?: string;
 }
 
+export interface PlanSummaryAndPreviousClaim {
+  plan: PlanSummaryRecord;
+  wrappedClaimBefore: GenericCredWrapper<PlanActionClaim>;
+}
+
 /**
  * Represents data about a project
  *
@@ -87,7 +105,10 @@ export interface PlanData {
   name: string;
   /**
    * The identifier of the project record -- different from jwtId
-   * (Maybe we should use the jwtId to iterate through the records instead.)
+   *
+   * This has been used to iterate through plan records, because jwtId ordering doesn't match
+   * chronological create ordering, though it does match most recent edit order (in reverse order).
+   * (It may be worthwhile to order by jwtId instead. It is an indexed field.)
    **/
   rowId?: string;
 }

src/interfaces/user.ts

@@ -6,3 +6,12 @@ export interface UserInfo {
   profileImageUrl?: string;
   nextPublicEncKeyHash?: string;
 }
+
+export interface MemberData {
+  did: string;
+  name: string;
+  isContact: boolean;
+  member: {
+    memberId: string;
+  };
+}

src/libs/crypto/index.ts

@@ -104,6 +104,71 @@ export const accessToken = async (did?: string) => {
   }
 };
 
+/**
+ * Generate a longer-lived access token for background operations
+ *
+ * This function creates JWT tokens with extended validity (default 72 hours) for use
+ * in background prefetch operations. The longer expiration period allows the daily
+ * notification plugin to work offline for extended periods without requiring the app
+ * to be in the foreground to refresh tokens.
+ *
+ * **Token Refresh Strategy (Hybrid Approach):**
+ * - Tokens are valid for 72 hours (configurable)
+ * - Tokens are refreshed proactively when:
+ *   - App comes to foreground (via Capacitor 'resume' event)
+ *   - Component mounts (DailyNotificationSection)
+ *   - Notifications are enabled
+ * - If token expires while offline, plugin uses cached content
+ * - Next time app opens, token is automatically refreshed
+ *
+ * **Why 72 Hours?**
+ * - Balances security (read-only prefetch operations) with offline capability
+ * - Reduces need for app to wake itself for token refresh
+ * - Allows plugin to work offline for extended periods (e.g., weekend trips)
+ * - Longer than typical prefetch windows (5 minutes before notification)
+ *
+ * **Security Considerations:**
+ * - Tokens are used only for read-only prefetch operations
+ * - Tokens are stored securely in plugin's Room database
+ * - Tokens are refreshed proactively to minimize exposure window
+ * - No private keys are exposed to native code
+ *
+ * @param {string} did - User DID (Decentralized Identifier) for token issuer
+ * @param {number} expirationMinutes - Optional expiration in minutes (defaults to 72 hours = 4320 minutes)
+ * @return {Promise<string>} JWT token with extended validity, or empty string if no DID provided
+ *
+ * @example
+ * ```typescript
+ * // Generate token with default 72-hour expiration
+ * const token = await accessTokenForBackground("did:ethr:0x...");
+ *
+ * // Generate token with custom expiration (24 hours)
+ * const token24h = await accessTokenForBackground("did:ethr:0x...", 24 * 60);
+ * ```
+ *
+ * @see {@link accessToken} For short-lived tokens (1 minute) for regular API requests
+ * @see {@link createEndorserJwtForDid} For JWT creation implementation
+ */
+export const accessTokenForBackground = async (
+  did?: string,
+  expirationMinutes?: number,
+): Promise<string> => {
+  if (!did) {
+    return "";
+  }
+
+  // Use provided expiration or default to 72 hours (4320 minutes)
+  // This allows background prefetch operations to work offline for extended periods
+  const expirationSeconds = expirationMinutes
+    ? expirationMinutes * 60
+    : 72 * 60 * 60; // Default 72 hours
+
+  const nowEpoch = Math.floor(Date.now() / 1000);
+  const endEpoch = nowEpoch + expirationSeconds;
+  const tokenPayload = { exp: endEpoch, iat: nowEpoch, iss: did };
+  return createEndorserJwtForDid(did, tokenPayload);
+};
+
 /**
  * Extract JWT from various URL formats
  * @param jwtUrlText The URL containing the JWT

src/libs/endorserServer.ts

@@ -42,9 +42,6 @@ import {
   PlanActionClaim,
   RegisterActionClaim,
   TenureClaim,
-} from "../interfaces/claims";
-
-import {
   GenericCredWrapper,
   GenericVerifiableCredential,
   AxiosErrorResponse,
@@ -55,9 +52,12 @@ import {
   QuantitativeValue,
   KeyMetaWithPrivate,
   KeyMetaMaybeWithPrivate,
-} from "../interfaces/common";
-import { PlanSummaryRecord } from "../interfaces/records";
-import { logger } from "../utils/logger";
+  OfferSummaryRecord,
+  OfferToPlanSummaryRecord,
+  PlanSummaryAndPreviousClaim,
+  PlanSummaryRecord,
+} from "../interfaces";
+import { logger, safeStringify } from "../utils/logger";
 import { PlatformServiceFactory } from "@/services/PlatformServiceFactory";
 import { APP_SERVER } from "@/constants/app";
 import { SOMEONE_UNNAMED } from "@/constants/entities";
@@ -362,6 +362,22 @@ export function didInfo(
   return didInfoForContact(did, activeDid, contact, allMyDids).displayName;
 }
 
+/**
+ * In some contexts (eg. agent), a blank really is nobody.
+ */
+export function didInfoOrNobody(
+  did: string | undefined,
+  activeDid: string | undefined,
+  allMyDids: string[],
+  contacts: Contact[],
+): string {
+  if (did == null) {
+    return "Nobody";
+  } else {
+    return didInfo(did, activeDid, allMyDids, contacts);
+  }
+}
+
 /**
  * return text description without any references to "you" as user
  */
@@ -609,11 +625,7 @@ async function performPlanRequest(
 
       return cred;
     } else {
-      // Use debug level for development to reduce console noise
-      const isDevelopment = process.env.VITE_PLATFORM === "development";
-      const log = isDevelopment ? logger.debug : logger.log;
-
-      log(
+      logger.debug(
         "[Plan Loading] ⚠️ Plan cache is empty for handle",
         handleId,
         " Got data:",
@@ -685,7 +697,7 @@ export function serverMessageForUser(error: unknown): string | undefined {
 export function errorStringForLog(error: unknown) {
   let stringifiedError = "" + error;
   try {
-    stringifiedError = JSON.stringify(error);
+    stringifiedError = safeStringify(error);
   } catch (e) {
     // can happen with Dexie, eg:
     // TypeError: Converting circular structure to JSON
@@ -697,7 +709,7 @@ export function errorStringForLog(error: unknown) {
 
   if (error && typeof error === "object" && "response" in error) {
     const err = error as AxiosErrorResponse;
-    const errorResponseText = JSON.stringify(err.response);
+    const errorResponseText = safeStringify(err.response);
     // for some reason, error.response is not included in stringify result (eg. for 400 errors on invite redemptions)
     if (!R.empty(errorResponseText) && !fullError.includes(errorResponseText)) {
       // add error.response stuff
@@ -707,7 +719,7 @@ export function errorStringForLog(error: unknown) {
         R.equals(err.config, err.response.config)
       ) {
         // but exclude "config" because it's already in there
-        const newErrorResponseText = JSON.stringify(
+        const newErrorResponseText = safeStringify(
           R.omit(["config"] as never[], err.response),
         );
         fullError +=
@@ -730,7 +742,7 @@ export async function getNewOffersToUser(
   activeDid: string,
   afterOfferJwtId?: string,
   beforeOfferJwtId?: string,
-) {
+): Promise<{ data: Array<OfferSummaryRecord>; hitLimit: boolean }> {
   let url = `${apiServer}/api/v2/report/offers?recipientDid=${activeDid}`;
   if (afterOfferJwtId) {
     url += "&afterId=" + afterOfferJwtId;
@@ -752,7 +764,7 @@ export async function getNewOffersToUserProjects(
   activeDid: string,
   afterOfferJwtId?: string,
   beforeOfferJwtId?: string,
-) {
+): Promise<{ data: Array<OfferToPlanSummaryRecord>; hitLimit: boolean }> {
   let url = `${apiServer}/api/v2/report/offersToPlansOwnedByMe`;
   if (afterOfferJwtId) {
     url += "?afterId=" + afterOfferJwtId;
@@ -766,6 +778,46 @@ export async function getNewOffersToUserProjects(
   return response.data;
 }
 
+/**
+ * Get starred projects that have been updated since the last check
+ *
+ * @param axios - axios instance
+ * @param apiServer - endorser API server URL
+ * @param activeDid - user's DID for authentication
+ * @param starredPlanHandleIds - array of starred project handle IDs
+ * @param afterId - JWT ID to check for changes after (from lastAckedStarredPlanChangesJwtId)
+ * @returns { data: Array<PlanSummaryAndPreviousClaim>, hitLimit: boolean }
+ */
+export async function getStarredProjectsWithChanges(
+  axios: Axios,
+  apiServer: string,
+  activeDid: string,
+  starredPlanHandleIds: string[],
+  afterId?: string,
+): Promise<{ data: Array<PlanSummaryAndPreviousClaim>; hitLimit: boolean }> {
+  if (!starredPlanHandleIds || starredPlanHandleIds.length === 0) {
+    return { data: [], hitLimit: false };
+  }
+
+  if (!afterId) {
+    // This doesn't make sense: there should always be some previous one they've seen.
+    // We'll just return blank.
+    return { data: [], hitLimit: false };
+  }
+
+  // Use POST method for larger lists of project IDs
+  const url = `${apiServer}/api/v2/report/plansLastUpdatedBetween`;
+  const headers = await getHeaders(activeDid);
+
+  const requestBody = {
+    planIds: starredPlanHandleIds,
+    afterId: afterId,
+  };
+
+  const response = await axios.post(url, requestBody, { headers });
+  return response.data;
+}
+
 /**
  * Construct GiveAction VC for submission to server
  *
@@ -1165,7 +1217,12 @@ export async function createAndSubmitClaim(
       timestamp: new Date().toISOString(),
     });
 
-    return { success: true, handleId: response.data?.handleId };
+    return {
+      success: true,
+      claimId: response.data?.claimId,
+      handleId: response.data?.handleId,
+      embeddedRecordError: response.data?.embeddedRecordError,
+    };
   } catch (error: unknown) {
     // Enhanced error logging with comprehensive context
     const requestId = `claim_error_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
@@ -1600,31 +1657,39 @@ export async function register(
       message?: string;
     }>(url, { jwtEncoded: vcJwt });
 
-    if (resp.data?.success?.handleId) {
-      return { success: true };
-    } else if (resp.data?.success?.embeddedRecordError) {
+    if (resp.data?.success?.embeddedRecordError) {
       let message =
         "There was some problem with the registration and so it may not be complete.";
       if (typeof resp.data.success.embeddedRecordError === "string") {
         message += " " + resp.data.success.embeddedRecordError;
       }
       return { error: message };
+    } else if (resp.data?.success?.handleId) {
+      return { success: true };
     } else {
-      logger.error("Registration error:", JSON.stringify(resp.data));
-      return { error: "Got a server error when registering." };
+      logger.error("Registration non-thrown error:", JSON.stringify(resp.data));
+      return {
+        error:
+          (resp.data?.error as { message?: string })?.message ||
+          (resp.data?.error as string) ||
+          "Got a server error when registering.",
+      };
     }
   } catch (error: unknown) {
     if (error && typeof error === "object") {
       const err = error as AxiosErrorResponse;
       const errorMessage =
-        err.message ||
-        (err.response?.data &&
-        typeof err.response.data === "object" &&
-        "message" in err.response.data
-          ? (err.response.data as { message: string }).message
-          : undefined);
-      logger.error("Registration error:", errorMessage || JSON.stringify(err));
-      return { error: errorMessage || "Got a server error when registering." };
+        err.response?.data?.error?.message ||
+        err.response?.data?.error ||
+        err.message;
+      logger.error(
+        "Registration thrown error:",
+        errorMessage || JSON.stringify(err),
+      );
+      return {
+        error:
+          (errorMessage as string) || "Got a server error when registering.",
+      };
     }
     return { error: "Got a server error when registering." };
   }
@@ -1697,49 +1762,19 @@ export async function fetchEndorserRateLimits(
     timestamp: new Date().toISOString(),
   });
 
-  try {
-    const response = await axios.get(url, { headers } as AxiosRequestConfig);
+  // not wrapped in a 'try' because the error returned is self-explanatory
+  const response = await axios.get(url, { headers } as AxiosRequestConfig);
 
-    // Log successful registration check
-    logger.debug("[User Registration] User registration check successful:", {
-      did: issuerDid,
-      server: apiServer,
-      status: response.status,
-      isRegistered: true,
-      timestamp: new Date().toISOString(),
-    });
+  // Log successful registration check
+  logger.debug("[User Registration] User registration check successful:", {
+    did: issuerDid,
+    server: apiServer,
+    status: response.status,
+    isRegistered: true,
+    timestamp: new Date().toISOString(),
+  });
 
-    return response;
-  } catch (error) {
-    // Enhanced error logging with user registration context
-    const axiosError = error as {
-      response?: {
-        data?: { error?: { code?: string; message?: string } };
-        status?: number;
-      };
-    };
-    const errorCode = axiosError.response?.data?.error?.code;
-    const errorMessage = axiosError.response?.data?.error?.message;
-    const httpStatus = axiosError.response?.status;
-
-    logger.warn("[User Registration] User not registered on server:", {
-      did: issuerDid,
-      server: apiServer,
-      errorCode: errorCode,
-      errorMessage: errorMessage,
-      httpStatus: httpStatus,
-      needsRegistration: true,
-      timestamp: new Date().toISOString(),
-    });
-
-    // Log the original error for debugging
-    logger.error(
-      `[fetchEndorserRateLimits] Error for DID ${issuerDid}:`,
-      errorStringForLog(error),
-    );
-
-    throw error;
-  }
+  return response;
 }
 
 /**
@@ -1788,14 +1823,17 @@ export async function fetchImageRateLimits(
       };
     };
 
-    logger.error("[Image Server] Image rate limits check failed:", {
-      did: issuerDid,
-      server: server,
-      errorCode: axiosError.response?.data?.error?.code,
-      errorMessage: axiosError.response?.data?.error?.message,
-      httpStatus: axiosError.response?.status,
-      timestamp: new Date().toISOString(),
-    });
+    logger.warn(
+      "[Image Server] Image rate limits check failed, which is expected for users not registered on test server (eg. when only registered on local server).",
+      {
+        did: issuerDid,
+        server: server,
+        errorCode: axiosError.response?.data?.error?.code,
+        errorMessage: axiosError.response?.data?.error?.message,
+        httpStatus: axiosError.response?.status,
+        timestamp: new Date().toISOString(),
+      },
+    );
     return null;
   }
 }

src/libs/fontawesome.ts

@@ -29,6 +29,7 @@ import {
   faCircle,
   faCircleCheck,
   faCircleInfo,
+  faCircleMinus,
   faCirclePlus,
   faCircleQuestion,
   faCircleRight,
@@ -37,6 +38,7 @@ import {
   faCoins,
   faComment,
   faCopy,
+  faCrown,
   faDollar,
   faDownload,
   faEllipsis,
@@ -58,6 +60,7 @@ import {
   faHand,
   faHandHoldingDollar,
   faHandHoldingHeart,
+  faHourglassHalf,
   faHouseChimney,
   faImage,
   faImagePortrait,
@@ -86,6 +89,7 @@ import {
   faSquareCaretDown,
   faSquareCaretUp,
   faSquarePlus,
+  faStar,
   faThumbtack,
   faTrashCan,
   faTriangleExclamation,
@@ -94,6 +98,9 @@ import {
   faXmark,
 } from "@fortawesome/free-solid-svg-icons";
 
+// these are referenced differently, eg. ":icon='['far', 'star']'" as in ProjectViewView.vue
+import { faStar as faStarRegular } from "@fortawesome/free-regular-svg-icons";
+
 // Initialize Font Awesome library with all required icons
 library.add(
   faArrowDown,
@@ -119,6 +126,7 @@ library.add(
   faCircle,
   faCircleCheck,
   faCircleInfo,
+  faCircleMinus,
   faCirclePlus,
   faCircleQuestion,
   faCircleRight,
@@ -127,6 +135,7 @@ library.add(
   faCoins,
   faComment,
   faCopy,
+  faCrown,
   faDollar,
   faDownload,
   faEllipsis,
@@ -148,6 +157,7 @@ library.add(
   faHand,
   faHandHoldingDollar,
   faHandHoldingHeart,
+  faHourglassHalf,
   faHouseChimney,
   faImage,
   faImagePortrait,
@@ -168,14 +178,16 @@ library.add(
   faPlus,
   faQrcode,
   faQuestion,
-  faRotate,
   faRightFromBracket,
+  faRotate,
   faShareNodes,
   faSpinner,
   faSquare,
   faSquareCaretDown,
   faSquareCaretUp,
   faSquarePlus,
+  faStar,
+  faStarRegular,
   faThumbtack,
   faTrashCan,
   faTriangleExclamation,

src/libs/util.ts

@@ -988,11 +988,6 @@ export async function importFromMnemonic(
 ): Promise<void> {
   const mne: string = mnemonic.trim().toLowerCase();
 
-  // Check if this is Test User #0
-  const TEST_USER_0_MNEMONIC =
-    "rigid shrug mobile smart veteran half all pond toilet brave review universe ship congress found yard skate elite apology jar uniform subway slender luggage";
-  const isTestUser0 = mne === TEST_USER_0_MNEMONIC;
-
   // Derive address and keys from mnemonic
   const [address, privateHex, publicHex] = deriveAddress(mne, derivationPath);
 
@@ -1007,90 +1002,6 @@ export async function importFromMnemonic(
 
   // Save the new identity
   await saveNewIdentity(newId, mne, derivationPath);
-
-  // Set up Test User #0 specific settings
-  if (isTestUser0) {
-    // Set up Test User #0 specific settings with enhanced error handling
-    const platformService = await getPlatformService();
-
-    try {
-      // First, ensure the DID-specific settings record exists
-      await platformService.insertNewDidIntoSettings(newId.did);
-
-      // Then update with Test User #0 specific settings
-      await platformService.updateDidSpecificSettings(newId.did, {
-        firstName: "User Zero",
-        isRegistered: true,
-      });
-
-      // Verify the settings were saved correctly
-      const verificationResult = await platformService.dbQuery(
-        "SELECT firstName, isRegistered FROM settings WHERE accountDid = ?",
-        [newId.did],
-      );
-
-      if (verificationResult?.values?.length) {
-        const settings = verificationResult.values[0];
-        const firstName = settings[0];
-        const isRegistered = settings[1];
-
-        logger.debug(
-          "[importFromMnemonic] Test User #0 settings verification",
-          {
-            did: newId.did,
-            firstName,
-            isRegistered,
-            expectedFirstName: "User Zero",
-            expectedIsRegistered: true,
-          },
-        );
-
-        // If settings weren't saved correctly, try individual updates
-        if (firstName !== "User Zero" || isRegistered !== 1) {
-          logger.warn(
-            "[importFromMnemonic] Test User #0 settings not saved correctly, retrying with individual updates",
-          );
-
-          await platformService.dbExec(
-            "UPDATE settings SET firstName = ? WHERE accountDid = ?",
-            ["User Zero", newId.did],
-          );
-
-          await platformService.dbExec(
-            "UPDATE settings SET isRegistered = ? WHERE accountDid = ?",
-            [1, newId.did],
-          );
-
-          // Verify again
-          const retryResult = await platformService.dbQuery(
-            "SELECT firstName, isRegistered FROM settings WHERE accountDid = ?",
-            [newId.did],
-          );
-
-          if (retryResult?.values?.length) {
-            const retrySettings = retryResult.values[0];
-            logger.debug(
-              "[importFromMnemonic] Test User #0 settings after retry",
-              {
-                firstName: retrySettings[0],
-                isRegistered: retrySettings[1],
-              },
-            );
-          }
-        }
-      } else {
-        logger.error(
-          "[importFromMnemonic] Failed to verify Test User #0 settings - no record found",
-        );
-      }
-    } catch (error) {
-      logger.error(
-        "[importFromMnemonic] Error setting up Test User #0 settings:",
-        error,
-      );
-      // Don't throw - allow the import to continue even if settings fail
-    }
-  }
 }
 
 /**
@@ -1147,3 +1058,29 @@ export async function checkForDuplicateAccount(
 
   return (existingAccount?.values?.length ?? 0) > 0;
 }
+
+export class PromiseTracker<T> {
+  private _promise: Promise<T>;
+  private _resolved = false;
+  private _value: T | undefined;
+
+  constructor(promise: Promise<T>) {
+    this._promise = promise.then((value) => {
+      this._resolved = true;
+      this._value = value;
+      return value;
+    });
+  }
+
+  get isResolved(): boolean {
+    return this._resolved;
+  }
+
+  get value(): T | undefined {
+    return this._value;
+  }
+
+  get promise(): Promise<T> {
+    return this._promise;
+  }
+}

src/router/index.ts

@@ -285,6 +285,16 @@ const routes: Array<RouteRecordRaw> = [
     name: "user-profile",
     component: () => import("../views/UserProfileView.vue"),
   },
+  // Catch-all route for 404 errors - must be last
+  {
+    path: "/:pathMatch(.*)*",
+    name: "not-found",
+    component: () => import("../views/NotFoundView.vue"),
+    meta: {
+      title: "Page Not Found",
+      requiresAuth: false,
+    },
+  },
 ];
 
 const isElectron = window.location.protocol === "file:";

src/services/PlatformService.ts

@@ -32,6 +32,68 @@ export interface PlatformCapabilities {
   isNativeApp: boolean;
 }
 
+/**
+ * Permission status for notifications
+ */
+export interface PermissionStatus {
+  /** Notification permission status */
+  notifications: "granted" | "denied" | "prompt";
+  /** Exact alarms permission status (Android only) */
+  exactAlarms?: "granted" | "denied" | "prompt";
+}
+
+/**
+ * Result of permission request
+ */
+export interface PermissionResult {
+  /** Whether notification permission was granted */
+  notifications: boolean;
+  /** Whether exact alarms permission was granted (Android only) */
+  exactAlarms?: boolean;
+}
+
+/**
+ * Status of scheduled daily notifications
+ */
+export interface NotificationStatus {
+  /** Whether a notification is currently scheduled */
+  isScheduled: boolean;
+  /** Scheduled time in "HH:mm" format (24-hour) */
+  scheduledTime?: string;
+  /** Last time the notification was triggered (ISO string) */
+  lastTriggered?: string;
+  /** Current permission status */
+  permissions: PermissionStatus;
+}
+
+/**
+ * Options for scheduling a daily notification
+ */
+export interface ScheduleOptions {
+  /** Time in "HH:mm" format (24-hour) in local time */
+  time: string;
+  /** Notification title */
+  title: string;
+  /** Notification body text */
+  body: string;
+  /** Whether to play sound (default: true) */
+  sound?: boolean;
+  /** Notification priority */
+  priority?: "high" | "normal" | "low";
+}
+
+/**
+ * Configuration for native fetcher background operations
+ */
+export interface NativeFetcherConfig {
+  /** API server URL */
+  apiServer: string;
+  /** JWT token for authentication */
+  jwt: string;
+  /** Array of starred plan handle IDs */
+  starredPlanHandleIds: string[];
+}
+
 /**
  * Platform-agnostic interface for handling platform-specific operations.
  * Provides a common API for file system operations, camera interactions,
@@ -209,6 +271,58 @@ export interface PlatformService {
    */
   retrieveSettingsForActiveAccount(): Promise<Record<string, unknown> | null>;
 
+  // Daily notification operations
+  /**
+   * Get the status of scheduled daily notifications
+   * @returns Promise resolving to notification status, or null if not supported
+   */
+  getDailyNotificationStatus(): Promise<NotificationStatus | null>;
+
+  /**
+   * Check notification permissions
+   * @returns Promise resolving to permission status, or null if not supported
+   */
+  checkNotificationPermissions(): Promise<PermissionStatus | null>;
+
+  /**
+   * Request notification permissions
+   * @returns Promise resolving to permission result, or null if not supported
+   */
+  requestNotificationPermissions(): Promise<PermissionResult | null>;
+
+  /**
+   * Schedule a daily notification
+   * @param options - Notification scheduling options
+   * @returns Promise that resolves when scheduled, or rejects if not supported
+   */
+  scheduleDailyNotification(options: ScheduleOptions): Promise<void>;
+
+  /**
+   * Cancel scheduled daily notification
+   * @returns Promise that resolves when cancelled, or rejects if not supported
+   */
+  cancelDailyNotification(): Promise<void>;
+
+  /**
+   * Configure native fetcher for background operations
+   * @param config - Native fetcher configuration
+   * @returns Promise that resolves when configured, or null if not supported
+   */
+  configureNativeFetcher(config: NativeFetcherConfig): Promise<void | null>;
+
+  /**
+   * Update starred plans for background fetcher
+   * @param plans - Starred plan IDs
+   * @returns Promise that resolves when updated, or null if not supported
+   */
+  updateStarredPlans(plans: { planIds: string[] }): Promise<void | null>;
+
+  /**
+   * Open the app's notification settings in the system settings
+   * @returns Promise that resolves when the settings page is opened, or null if not supported
+   */
+  openAppNotificationSettings(): Promise<void | null>;
+
   // --- PWA/Web-only methods (optional, only implemented on web) ---
   /**
    * Registers the service worker for PWA support (web only)

src/services/api.ts

@@ -19,7 +19,6 @@ import { logger, safeStringify } from "../utils/logger";
  * @remarks
  * Special handling includes:
  * - Enhanced logging for Capacitor platform
- * - Rate limit detection and handling
  * - Detailed error information logging including:
  *   - Error message
  *   - HTTP status
@@ -50,11 +49,5 @@ export const handleApiError = (error: AxiosError, endpoint: string) => {
     });
   }
 
-  // Specific handling for rate limits
-  if (error.response?.status === 400) {
-    logger.warn(`[Rate Limit] ${endpoint}`);
-    return null;
-  }
-
   throw error;
 };

src/services/migrationService.ts

@@ -799,7 +799,7 @@ export async function runMigrations<T>(
     }
 
     // Only show completion message in development
-    logger.debug(
+    logger.log(
       `🎉 [Migration] Migration process complete! Summary: ${appliedCount} applied, ${skippedCount} skipped`,
     );
   } catch (error) {

src/services/platforms/BaseDatabaseService.ts

@@ -0,0 +1,297 @@
+/**
+ * @fileoverview Base Database Service for Platform Services
+ * @author Matthew Raymer
+ *
+ * This abstract base class provides common database operations that are
+ * identical across all platform implementations. It eliminates code
+ * duplication and ensures consistency in database operations.
+ *
+ * Key Features:
+ * - Common database utility methods
+ * - Consistent settings management
+ * - Active identity management
+ * - Abstract methods for platform-specific database operations
+ *
+ * Architecture:
+ * - Abstract base class with common implementations
+ * - Platform services extend this class
+ * - Platform-specific database operations remain abstract
+ *
+ * @since 1.1.1-beta
+ */
+
+import { logger } from "../../utils/logger";
+import { QueryExecResult } from "@/interfaces/database";
+
+/**
+ * Abstract base class for platform-specific database services.
+ *
+ * This class provides common database operations that are identical
+ * across all platform implementations (Web, Capacitor, Electron).
+ * Platform-specific services extend this class and implement the
+ * abstract database operation methods.
+ *
+ * Common Operations:
+ * - Settings management (update, retrieve, insert)
+ * - Active identity management
+ * - Database utility methods
+ *
+ * @abstract
+ * @example
+ * ```typescript
+ * export class WebPlatformService extends BaseDatabaseService {
+ *   async dbQuery(sql: string, params?: unknown[]): Promise<QueryExecResult> {
+ *     // Web-specific implementation
+ *   }
+ * }
+ * ```
+ */
+export abstract class BaseDatabaseService {
+  /**
+   * Generate an INSERT statement for a model object.
+   *
+   * Creates a parameterized INSERT statement with placeholders for
+   * all properties in the model object. This ensures safe SQL
+   * execution and prevents SQL injection.
+   *
+   * @param model - Object containing the data to insert
+   * @param tableName - Name of the target table
+   * @returns Object containing the SQL statement and parameters
+   *
+   * @example
+   * ```typescript
+   * const { sql, params } = this.generateInsertStatement(
+   *   { name: 'John', age: 30 },
+   *   'users'
+   * );
+   * // sql: "INSERT INTO users (name, age) VALUES (?, ?)"
+   * // params: ['John', 30]
+   * ```
+   */
+  generateInsertStatement(
+    model: Record<string, unknown>,
+    tableName: string,
+  ): { sql: string; params: unknown[] } {
+    const keys = Object.keys(model);
+    const placeholders = keys.map(() => "?").join(", ");
+    const sql = `INSERT INTO ${tableName} (${keys.join(", ")}) VALUES (${placeholders})`;
+    const params = keys.map((key) => model[key]);
+    return { sql, params };
+  }
+
+  /**
+   * Update default settings for the currently active account.
+   *
+   * Retrieves the active DID from the active_identity table and updates
+   * the corresponding settings record. This ensures settings are always
+   * updated for the correct account.
+   *
+   * @param settings - Object containing the settings to update
+   * @returns Promise that resolves when settings are updated
+   *
+   * @throws {Error} If no active DID is found or database operation fails
+   *
+   * @example
+   * ```typescript
+   * await this.updateDefaultSettings({
+   *   theme: 'dark',
+   *   notifications: true
+   * });
+   * ```
+   */
+  async updateDefaultSettings(
+    settings: Record<string, unknown>,
+  ): Promise<void> {
+    // Get current active DID and update that identity's settings
+    const activeIdentity = await this.getActiveIdentity();
+    const activeDid = activeIdentity.activeDid;
+
+    if (!activeDid) {
+      logger.warn(
+        "[BaseDatabaseService] No active DID found, cannot update default settings",
+      );
+      return;
+    }
+
+    const keys = Object.keys(settings);
+    const setClause = keys.map((key) => `${key} = ?`).join(", ");
+    const sql = `UPDATE settings SET ${setClause} WHERE accountDid = ?`;
+    const params = [...keys.map((key) => settings[key]), activeDid];
+    await this.dbExec(sql, params);
+  }
+
+  /**
+   * Update the active DID in the active_identity table.
+   *
+   * Sets the active DID and updates the lastUpdated timestamp.
+   * This is used when switching between different accounts/identities.
+   *
+   * @param did - The DID to set as active
+   * @returns Promise that resolves when the update is complete
+   *
+   * @example
+   * ```typescript
+   * await this.updateActiveDid('did:example:123');
+   * ```
+   */
+  async updateActiveDid(did: string): Promise<void> {
+    await this.dbExec(
+      "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
+      [did],
+    );
+  }
+
+  /**
+   * Get the currently active DID from the active_identity table.
+   *
+   * Retrieves the active DID that represents the currently selected
+   * account/identity. This is used throughout the application to
+   * ensure operations are performed on the correct account.
+   *
+   * @returns Promise resolving to object containing the active DID
+   *
+   * @example
+   * ```typescript
+   * const { activeDid } = await this.getActiveIdentity();
+   * console.log('Current active DID:', activeDid);
+   * ```
+   */
+  async getActiveIdentity(): Promise<{ activeDid: string }> {
+    const result = (await this.dbQuery(
+      "SELECT activeDid FROM active_identity WHERE id = 1",
+    )) as QueryExecResult;
+    return {
+      activeDid: (result?.values?.[0]?.[0] as string) || "",
+    };
+  }
+
+  /**
+   * Insert a new DID into the settings table with default values.
+   *
+   * Creates a new settings record for a DID with default configuration
+   * values. Uses INSERT OR REPLACE to handle cases where settings
+   * already exist for the DID.
+   *
+   * @param did - The DID to create settings for
+   * @returns Promise that resolves when settings are created
+   *
+   * @example
+   * ```typescript
+   * await this.insertNewDidIntoSettings('did:example:123');
+   * ```
+   */
+  async insertNewDidIntoSettings(did: string): Promise<void> {
+    // Import constants dynamically to avoid circular dependencies
+    const { DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER } =
+      await import("@/constants/app");
+
+    // Use INSERT OR REPLACE to handle case where settings already exist for this DID
+    // This prevents duplicate accountDid entries and ensures data integrity
+    await this.dbExec(
+      "INSERT OR REPLACE INTO settings (accountDid, finishedOnboarding, apiServer, partnerApiServer) VALUES (?, ?, ?, ?)",
+      [did, false, DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER],
+    );
+  }
+
+  /**
+   * Update settings for a specific DID.
+   *
+   * Updates settings for a particular DID rather than the active one.
+   * This is useful for bulk operations or when managing multiple accounts.
+   *
+   * @param did - The DID to update settings for
+   * @param settings - Object containing the settings to update
+   * @returns Promise that resolves when settings are updated
+   *
+   * @example
+   * ```typescript
+   * await this.updateDidSpecificSettings('did:example:123', {
+   *   theme: 'light',
+   *   notifications: false
+   * });
+   * ```
+   */
+  async updateDidSpecificSettings(
+    did: string,
+    settings: Record<string, unknown>,
+  ): Promise<void> {
+    const keys = Object.keys(settings);
+    const setClause = keys.map((key) => `${key} = ?`).join(", ");
+    const sql = `UPDATE settings SET ${setClause} WHERE accountDid = ?`;
+    const params = [...keys.map((key) => settings[key]), did];
+    await this.dbExec(sql, params);
+  }
+
+  /**
+   * Retrieve settings for the currently active account.
+   *
+   * Gets the active DID and retrieves all settings for that account.
+   * Excludes the 'id' column from the returned settings object.
+   *
+   * @returns Promise resolving to settings object or null if no active DID
+   *
+   * @example
+   * ```typescript
+   * const settings = await this.retrieveSettingsForActiveAccount();
+   * if (settings) {
+   *   console.log('Theme:', settings.theme);
+   *   console.log('Notifications:', settings.notifications);
+   * }
+   * ```
+   */
+  async retrieveSettingsForActiveAccount(): Promise<Record<
+    string,
+    unknown
+  > | null> {
+    // Get current active DID from active_identity table
+    const activeIdentity = await this.getActiveIdentity();
+    const activeDid = activeIdentity.activeDid;
+
+    if (!activeDid) {
+      return null;
+    }
+
+    const result = (await this.dbQuery(
+      "SELECT * FROM settings WHERE accountDid = ?",
+      [activeDid],
+    )) as QueryExecResult;
+    if (result?.values?.[0]) {
+      // Convert the row to an object
+      const row = result.values[0];
+      const columns = result.columns || [];
+      const settings: Record<string, unknown> = {};
+
+      columns.forEach((column: string, index: number) => {
+        if (column !== "id") {
+          // Exclude the id column
+          settings[column] = row[index];
+        }
+      });
+
+      return settings;
+    }
+    return null;
+  }
+
+  // Abstract methods that must be implemented by platform-specific services
+
+  /**
+   * Execute a database query (SELECT operations).
+   *
+   * @abstract
+   * @param sql - SQL query string
+   * @param params - Optional parameters for prepared statements
+   * @returns Promise resolving to query results
+   */
+  abstract dbQuery(sql: string, params?: unknown[]): Promise<unknown>;
+
+  /**
+   * Execute a database statement (INSERT, UPDATE, DELETE operations).
+   *
+   * @abstract
+   * @param sql - SQL statement string
+   * @param params - Optional parameters for prepared statements
+   * @returns Promise resolving to execution results
+   */
+  abstract dbExec(sql: string, params?: unknown[]): Promise<unknown>;
+}

src/services/platforms/CapacitorPlatformService.ts

@@ -13,6 +13,7 @@ import {
   CapacitorSQLite,
   DBSQLiteValues,
 } from "@capacitor-community/sqlite";
+import { DailyNotification } from "@timesafari/daily-notification-plugin";
 
 import { runMigrations } from "@/db-sql/migration";
 import { QueryExecResult } from "@/interfaces/database";
@@ -20,8 +21,14 @@ import {
   ImageResult,
   PlatformService,
   PlatformCapabilities,
+  NotificationStatus,
+  PermissionStatus,
+  PermissionResult,
+  ScheduleOptions,
+  NativeFetcherConfig,
 } from "../PlatformService";
 import { logger } from "../../utils/logger";
+import { BaseDatabaseService } from "./BaseDatabaseService";
 
 interface QueuedOperation {
   type: "run" | "query" | "rawQuery";
@@ -39,7 +46,10 @@ interface QueuedOperation {
  * - Platform-specific features
  * - SQLite database operations
  */
-export class CapacitorPlatformService implements PlatformService {
+export class CapacitorPlatformService
+  extends BaseDatabaseService
+  implements PlatformService
+{
   /** Current camera direction */
   private currentDirection: CameraDirection = CameraDirection.Rear;
 
@@ -52,6 +62,7 @@ export class CapacitorPlatformService implements PlatformService {
   private isProcessingQueue: boolean = false;
 
   constructor() {
+    super();
     this.sqlite = new SQLiteConnection(CapacitorSQLite);
   }
 
@@ -86,16 +97,92 @@ export class CapacitorPlatformService implements PlatformService {
     }
 
     try {
-      // Create/Open database
-      this.db = await this.sqlite.createConnection(
-        this.dbName,
-        false,
-        "no-encryption",
-        1,
-        false,
-      );
+      // Try to create/Open database connection
+      try {
+        this.db = await this.sqlite.createConnection(
+          this.dbName,
+          false,
+          "no-encryption",
+          1,
+          false,
+        );
+      } catch (createError: unknown) {
+        // If connection already exists, try to retrieve it or handle gracefully
+        const errorMessage =
+          createError instanceof Error
+            ? createError.message
+            : String(createError);
+        const errorObj =
+          typeof createError === "object" && createError !== null
+            ? (createError as { errorMessage?: string; message?: string })
+            : {};
 
-      await this.db.open();
+        const fullErrorMessage =
+          errorObj.errorMessage || errorObj.message || errorMessage;
+
+        if (fullErrorMessage.includes("already exists")) {
+          logger.debug(
+            "[CapacitorPlatformService] Connection already exists on native side, attempting to retrieve",
+          );
+          // Check if connection exists in JavaScript Map
+          const isConnResult = await this.sqlite.isConnection(
+            this.dbName,
+            false,
+          );
+          if (isConnResult.result) {
+            // Connection exists in Map, retrieve it
+            this.db = await this.sqlite.retrieveConnection(this.dbName, false);
+            logger.debug(
+              "[CapacitorPlatformService] Successfully retrieved existing connection from Map",
+            );
+          } else {
+            // Connection exists on native side but not in JavaScript Map
+            // This can happen when the app is restarted but native connections persist
+            // Try to close the native connection first, then create a new one
+            logger.debug(
+              "[CapacitorPlatformService] Connection exists natively but not in Map, closing and recreating",
+            );
+            try {
+              await this.sqlite.closeConnection(this.dbName, false);
+            } catch (closeError) {
+              // Ignore close errors - connection might not be properly tracked
+              logger.debug(
+                "[CapacitorPlatformService] Error closing connection (may be expected):",
+                closeError,
+              );
+            }
+            // Now try to create the connection again
+            this.db = await this.sqlite.createConnection(
+              this.dbName,
+              false,
+              "no-encryption",
+              1,
+              false,
+            );
+            logger.debug(
+              "[CapacitorPlatformService] Successfully created connection after cleanup",
+            );
+          }
+        } else {
+          // Re-throw if it's a different error
+          throw createError;
+        }
+      }
+
+      // Open the connection if it's not already open
+      try {
+        await this.db.open();
+      } catch (openError: unknown) {
+        const openErrorMessage =
+          openError instanceof Error ? openError.message : String(openError);
+        // If already open, that's fine - continue
+        if (!openErrorMessage.includes("already open")) {
+          throw openError;
+        }
+        logger.debug(
+          "[CapacitorPlatformService] Database connection already open",
+        );
+      }
 
       // Set journal mode to WAL for better performance
       // await this.db.execute("PRAGMA journal_mode=WAL;");
@@ -1328,79 +1415,462 @@ export class CapacitorPlatformService implements PlatformService {
   // --- PWA/Web-only methods (no-op for Capacitor) ---
   public registerServiceWorker(): void {}
 
-  // Database utility methods
-  generateInsertStatement(
-    model: Record<string, unknown>,
-    tableName: string,
-  ): { sql: string; params: unknown[] } {
-    const keys = Object.keys(model);
-    const placeholders = keys.map(() => "?").join(", ");
-    const sql = `INSERT INTO ${tableName} (${keys.join(", ")}) VALUES (${placeholders})`;
-    const params = keys.map((key) => model[key]);
-    return { sql, params };
-  }
+  // Daily notification operations
+  /**
+   * Get the status of scheduled daily notifications
+   * @see PlatformService.getDailyNotificationStatus
+   */
+  async getDailyNotificationStatus(): Promise<NotificationStatus | null> {
+    try {
+      logger.debug(
+        "[CapacitorPlatformService] Getting daily notification status...",
+      );
 
-  async updateDefaultSettings(
-    settings: Record<string, unknown>,
-  ): Promise<void> {
-    const keys = Object.keys(settings);
-    const setClause = keys.map((key) => `${key} = ?`).join(", ");
-    const sql = `UPDATE settings SET ${setClause} WHERE id = 1`;
-    const params = keys.map((key) => settings[key]);
-    await this.dbExec(sql, params);
-  }
+      const pluginStatus = await DailyNotification.getNotificationStatus();
 
-  async updateActiveDid(did: string): Promise<void> {
-    await this.dbExec(
-      "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
-      [did],
-    );
-  }
+      // Get permissions separately
+      const permissions = await DailyNotification.checkPermissions();
 
-  async insertNewDidIntoSettings(did: string): Promise<void> {
-    // Import constants dynamically to avoid circular dependencies
-    const { DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER } =
-      await import("@/constants/app");
+      // Map plugin PermissionState to our PermissionStatus format
+      const notificationsPermission = permissions.notifications;
+      let notifications: "granted" | "denied" | "prompt";
 
-    // Use INSERT OR REPLACE to handle case where settings already exist for this DID
-    // This prevents duplicate accountDid entries and ensures data integrity
-    await this.dbExec(
-      "INSERT OR REPLACE INTO settings (accountDid, finishedOnboarding, apiServer, partnerApiServer) VALUES (?, ?, ?, ?)",
-      [did, false, DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER],
-    );
-  }
+      if (notificationsPermission === "granted") {
+        notifications = "granted";
+      } else if (notificationsPermission === "denied") {
+        notifications = "denied";
+      } else {
+        notifications = "prompt";
+      }
 
-  async updateDidSpecificSettings(
-    did: string,
-    settings: Record<string, unknown>,
-  ): Promise<void> {
-    const keys = Object.keys(settings);
-    const setClause = keys.map((key) => `${key} = ?`).join(", ");
-    const sql = `UPDATE settings SET ${setClause} WHERE accountDid = ?`;
-    const params = [...keys.map((key) => settings[key]), did];
-    await this.dbExec(sql, params);
-  }
-
-  async retrieveSettingsForActiveAccount(): Promise<Record<
-    string,
-    unknown
-  > | null> {
-    const result = await this.dbQuery("SELECT * FROM settings WHERE id = 1");
-    if (result?.values?.[0]) {
-      // Convert the row to an object
-      const row = result.values[0];
-      const columns = result.columns || [];
-      const settings: Record<string, unknown> = {};
-
-      columns.forEach((column, index) => {
-        if (column !== "id") {
-          // Exclude the id column
-          settings[column] = row[index];
+      // Handle lastNotificationTime which can be a Promise<number>
+      let lastTriggered: string | undefined;
+      const lastNotificationTime = pluginStatus.lastNotificationTime;
+      if (lastNotificationTime) {
+        const timeValue = await Promise.resolve(lastNotificationTime);
+        if (typeof timeValue === "number") {
+          lastTriggered = new Date(timeValue).toISOString();
         }
+      }
+
+      return {
+        isScheduled: pluginStatus.isScheduled ?? false,
+        scheduledTime: pluginStatus.settings?.time,
+        lastTriggered,
+        permissions: {
+          notifications,
+          exactAlarms: undefined, // Plugin doesn't expose this in status
+        },
+      };
+    } catch (error) {
+      const errorMessage =
+        error instanceof Error ? error.message : String(error);
+      logger.error(
+        "[CapacitorPlatformService] Failed to get notification status:",
+        errorMessage,
+        error,
+      );
+      logger.warn(
+        "[CapacitorPlatformService] Daily notification section will be hidden - plugin may not be installed or available",
+      );
+      return null;
+    }
+  }
+
+  /**
+   * Check notification permissions
+   * @see PlatformService.checkNotificationPermissions
+   */
+  async checkNotificationPermissions(): Promise<PermissionStatus | null> {
+    try {
+      const permissions = await DailyNotification.checkPermissions();
+
+      // Log the raw permission state for debugging
+      logger.info(
+        `[CapacitorPlatformService] Raw permission state from plugin:`,
+        permissions,
+      );
+
+      // Map plugin PermissionState to our PermissionStatus format
+      const notificationsPermission = permissions.notifications;
+      let notifications: "granted" | "denied" | "prompt";
+
+      // Handle all possible PermissionState values
+      if (notificationsPermission === "granted") {
+        notifications = "granted";
+      } else if (
+        notificationsPermission === "denied" ||
+        notificationsPermission === "ephemeral"
+      ) {
+        notifications = "denied";
+      } else {
+        // Treat "prompt", "prompt-with-rationale", "unknown", "provisional" as "prompt"
+        // This allows Android to show the permission dialog
+        notifications = "prompt";
+      }
+
+      logger.info(
+        `[CapacitorPlatformService] Mapped permission state: ${notifications} (from ${notificationsPermission})`,
+      );
+
+      return {
+        notifications,
+        exactAlarms: undefined, // Plugin doesn't expose this directly
+      };
+    } catch (error) {
+      logger.error(
+        "[CapacitorPlatformService] Failed to check permissions:",
+        error,
+      );
+      return null;
+    }
+  }
+
+  /**
+   * Request notification permissions
+   * @see PlatformService.requestNotificationPermissions
+   */
+  async requestNotificationPermissions(): Promise<PermissionResult | null> {
+    try {
+      logger.info(
+        `[CapacitorPlatformService] Requesting notification permissions...`,
+      );
+
+      const result = await DailyNotification.requestPermissions();
+
+      logger.info(
+        `[CapacitorPlatformService] Permission request result:`,
+        result,
+      );
+
+      // Map plugin PermissionState to boolean
+      const notificationsGranted = result.notifications === "granted";
+
+      logger.info(
+        `[CapacitorPlatformService] Mapped permission result: ${notificationsGranted} (from ${result.notifications})`,
+      );
+
+      return {
+        notifications: notificationsGranted,
+        exactAlarms: undefined, // Plugin doesn't expose this directly
+      };
+    } catch (error) {
+      logger.error(
+        "[CapacitorPlatformService] Failed to request permissions:",
+        error,
+      );
+      return null;
+    }
+  }
+
+  /**
+   * Schedule a daily notification
+   * @see PlatformService.scheduleDailyNotification
+   */
+  async scheduleDailyNotification(options: ScheduleOptions): Promise<void> {
+    try {
+      await DailyNotification.scheduleDailyNotification({
+        time: options.time,
+        title: options.title,
+        body: options.body,
+        sound: options.sound ?? true,
+        priority: options.priority ?? "high",
       });
 
-      return settings;
+      logger.info(
+        `[CapacitorPlatformService] Scheduled daily notification for ${options.time}`,
+      );
+    } catch (error) {
+      logger.error(
+        "[CapacitorPlatformService] Failed to schedule notification:",
+        error,
+      );
+      throw error;
     }
-    return null;
   }
+
+  /**
+   * Cancel scheduled daily notification
+   * @see PlatformService.cancelDailyNotification
+   */
+  async cancelDailyNotification(): Promise<void> {
+    try {
+      await DailyNotification.cancelAllNotifications();
+
+      logger.info("[CapacitorPlatformService] Cancelled daily notification");
+    } catch (error) {
+      logger.error(
+        "[CapacitorPlatformService] Failed to cancel notification:",
+        error,
+      );
+      throw error;
+    }
+  }
+
+  /**
+   * Configure native fetcher for background operations
+   *
+   * This method configures the daily notification plugin's native content fetcher
+   * with authentication credentials for background prefetch operations. It automatically
+   * retrieves the active DID from the database and generates a fresh JWT token with
+   * 72-hour expiration.
+   *
+   * **Authentication Flow:**
+   * 1. Retrieves active DID from `active_identity` table (single source of truth)
+   * 2. Generates JWT token with 72-hour expiration using `accessTokenForBackground()`
+   * 3. Configures plugin with API server URL, active DID, and JWT token
+   * 4. Plugin stores token in its Room database for background workers
+   *
+   * **Token Management:**
+   * - Tokens are valid for 72 hours (4320 minutes)
+   * - Tokens are refreshed proactively when app comes to foreground
+   * - If token expires while offline, plugin uses cached content
+   * - Token refresh happens automatically via `DailyNotificationSection.refreshNativeFetcherConfig()`
+   *
+   * **Offline-First Design:**
+   * - 72-hour validity supports extended offline periods
+   * - Plugin can prefetch content when online and use cached content when offline
+   * - No app wake-up required for token refresh (happens when app is already open)
+   *
+   * **Error Handling:**
+   * - Returns `null` if active DID not found (no user logged in)
+   * - Returns `null` if JWT generation fails
+   * - Logs errors but doesn't throw (allows graceful degradation)
+   *
+   * @param config - Native fetcher configuration
+   * @param config.apiServer - API server URL (optional, uses default if not provided)
+   * @param config.jwt - JWT token (ignored, generated automatically)
+   * @param config.starredPlanHandleIds - Array of starred plan handle IDs for prefetch
+   * @returns Promise that resolves when configured, or `null` if configuration failed
+   *
+   * @example
+   * ```typescript
+   * await platformService.configureNativeFetcher({
+   *   apiServer: "https://api.endorser.ch",
+   *   jwt: "", // Generated automatically
+   *   starredPlanHandleIds: ["plan-123", "plan-456"]
+   * });
+   * ```
+   *
+   * @see {@link accessTokenForBackground} For JWT token generation
+   * @see {@link DailyNotificationSection.refreshNativeFetcherConfig} For proactive token refresh
+   * @see PlatformService.configureNativeFetcher
+   */
+  async configureNativeFetcher(
+    config: NativeFetcherConfig,
+  ): Promise<void | null> {
+    try {
+      // Step 1: Get activeDid from database (single source of truth)
+      // This ensures we're using the correct user identity for authentication
+      const activeIdentity = await this.getActiveIdentity();
+      const activeDid = activeIdentity.activeDid;
+
+      if (!activeDid) {
+        logger.warn(
+          "[CapacitorPlatformService] No activeDid found, cannot configure native fetcher",
+        );
+        return null;
+      }
+
+      // Step 2: Generate JWT token for background operations
+      // Use 72-hour expiration for offline-first prefetch operations
+      // This allows the plugin to work offline for extended periods
+      const { accessTokenForBackground } = await import(
+        "../../libs/crypto/index"
+      );
+      // Use 72 hours (4320 minutes) for background prefetch tokens
+      // This is longer than passkey expiration to support offline scenarios
+      const expirationMinutes = 72 * 60; // 72 hours
+      const jwtToken = await accessTokenForBackground(
+        activeDid,
+        expirationMinutes,
+      );
+
+      if (!jwtToken) {
+        logger.error("[CapacitorPlatformService] Failed to generate JWT token");
+        return null;
+      }
+
+      // Step 3: Get API server from config or use default
+      // This ensures the plugin knows where to fetch content from
+      let apiServer =
+        config.apiServer ||
+        (await import("../../constants/app")).DEFAULT_ENDORSER_API_SERVER;
+
+      // Step 3.5: Convert localhost to 10.0.2.2 for Android emulators
+      // Android emulators can't reach localhost - they need 10.0.2.2 to access the host machine
+      const platform = Capacitor.getPlatform();
+      if (platform === "android" && apiServer) {
+        // Replace localhost or 127.0.0.1 with 10.0.2.2 for Android emulator compatibility
+        apiServer = apiServer.replace(
+          /http:\/\/(localhost|127\.0\.0\.1)(:\d+)?/,
+          "http://10.0.2.2$2",
+        );
+      }
+
+      // Step 4: Configure plugin with credentials
+      // Plugin stores these in its Room database for background workers
+      await DailyNotification.configureNativeFetcher({
+        apiBaseUrl: apiServer,
+        activeDid,
+        jwtToken,
+      });
+
+      // Step 5: Update starred plans if provided
+      // This stores the starred plan IDs in SharedPreferences for the native fetcher
+      if (
+        config.starredPlanHandleIds &&
+        config.starredPlanHandleIds.length > 0
+      ) {
+        await DailyNotification.updateStarredPlans({
+          planIds: config.starredPlanHandleIds,
+        });
+        logger.info(
+          `[CapacitorPlatformService] Updated starred plans: ${config.starredPlanHandleIds.length} plans`,
+        );
+      } else {
+        // Clear starred plans if none provided
+        await DailyNotification.updateStarredPlans({
+          planIds: [],
+        });
+        logger.info(
+          "[CapacitorPlatformService] Cleared starred plans (none provided)",
+        );
+      }
+
+      logger.info("[CapacitorPlatformService] Configured native fetcher", {
+        activeDid,
+        apiServer,
+        tokenExpirationHours: 72,
+        tokenExpirationMinutes: expirationMinutes,
+        starredPlansCount: config.starredPlanHandleIds?.length || 0,
+      });
+    } catch (error) {
+      logger.error(
+        "[CapacitorPlatformService] Failed to configure native fetcher:",
+        error,
+      );
+      return null;
+    }
+  }
+
+  /**
+   * Update starred plans for background fetcher
+   * @see PlatformService.updateStarredPlans
+   */
+  async updateStarredPlans(plans: { planIds: string[] }): Promise<void | null> {
+    try {
+      await DailyNotification.updateStarredPlans({
+        planIds: plans.planIds,
+      });
+
+      logger.info(
+        `[CapacitorPlatformService] Updated starred plans: ${plans.planIds.length} plans`,
+      );
+    } catch (error) {
+      logger.error(
+        "[CapacitorPlatformService] Failed to update starred plans:",
+        error,
+      );
+      return null;
+    }
+  }
+
+  /**
+   * Open the app's notification settings in the system settings
+   * @see PlatformService.openAppNotificationSettings
+   */
+  async openAppNotificationSettings(): Promise<void | null> {
+    try {
+      const platform = Capacitor.getPlatform();
+
+      if (platform === "android") {
+        // Android: Open app details settings page
+        // From there, users can navigate to "Notifications" section
+        // This is more reliable than trying to open notification settings directly
+        const packageName = "app.timesafari.app"; // Full application ID from build.gradle
+
+        // Use APPLICATION_DETAILS_SETTINGS which opens the app's settings page
+        // Users can then navigate to "Notifications" section
+        // Try multiple URL formats to ensure compatibility
+        const intentUrl1 = `intent:#Intent;action=android.settings.APPLICATION_DETAILS_SETTINGS;data=package:${packageName};end`;
+        const intentUrl2 = `intent://settings/app_detail?package=${packageName}#Intent;scheme=android-app;end`;
+
+        logger.info(
+          `[CapacitorPlatformService] Opening Android app settings for ${packageName}`,
+        );
+
+        // Log current permission state before opening settings
+        try {
+          const currentPerms = await this.checkNotificationPermissions();
+          logger.info(
+            `[CapacitorPlatformService] Current permission state before opening settings:`,
+            currentPerms,
+          );
+        } catch (e) {
+          logger.warn(
+            `[CapacitorPlatformService] Could not check permissions before opening settings:`,
+            e,
+          );
+        }
+
+        // Try multiple approaches to ensure it works
+        try {
+          // Method 1: Direct window.location.href (most reliable)
+          window.location.href = intentUrl1;
+
+          // Method 2: Fallback with window.open
+          setTimeout(() => {
+            try {
+              window.open(intentUrl1, "_blank");
+            } catch (e) {
+              logger.warn(
+                "[CapacitorPlatformService] window.open fallback failed:",
+                e,
+              );
+            }
+          }, 100);
+
+          // Method 3: Alternative format
+          setTimeout(() => {
+            try {
+              window.location.href = intentUrl2;
+            } catch (e) {
+              logger.warn(
+                "[CapacitorPlatformService] Alternative format failed:",
+                e,
+              );
+            }
+          }, 200);
+        } catch (e) {
+          logger.error(
+            "[CapacitorPlatformService] Failed to open intent URL:",
+            e,
+          );
+        }
+      } else if (platform === "ios") {
+        // iOS: Use app settings URL scheme
+        const settingsUrl = `app-settings:`;
+        window.location.href = settingsUrl;
+
+        logger.info("[CapacitorPlatformService] Opening iOS app settings");
+      } else {
+        logger.warn(
+          `[CapacitorPlatformService] Cannot open settings on platform: ${platform}`,
+        );
+        return null;
+      }
+    } catch (error) {
+      logger.error(
+        "[CapacitorPlatformService] Failed to open app notification settings:",
+        error,
+      );
+      return null;
+    }
+  }
+
+  // Database utility methods - inherited from BaseDatabaseService
+  // generateInsertStatement, updateDefaultSettings, updateActiveDid,
+  // getActiveIdentity, insertNewDidIntoSettings, updateDidSpecificSettings,
+  // retrieveSettingsForActiveAccount are all inherited from BaseDatabaseService
 }

src/services/platforms/ElectronPlatformService.ts

@@ -22,6 +22,13 @@
 
 import { CapacitorPlatformService } from "./CapacitorPlatformService";
 import { logger } from "../../utils/logger";
+import {
+  NotificationStatus,
+  PermissionStatus,
+  PermissionResult,
+  ScheduleOptions,
+  NativeFetcherConfig,
+} from "../PlatformService";
 
 /**
  * Electron-specific platform service implementation.
@@ -166,4 +173,88 @@ export class ElectronPlatformService extends CapacitorPlatformService {
 
   // --- PWA/Web-only methods (no-op for Electron) ---
   public registerServiceWorker(): void {}
+
+  // Daily notification operations
+  // Override CapacitorPlatformService methods to return null/throw errors
+  // since Electron doesn't support native daily notifications
+
+  /**
+   * Get the status of scheduled daily notifications
+   * @see PlatformService.getDailyNotificationStatus
+   * @returns null - notifications not supported on Electron platform
+   */
+  async getDailyNotificationStatus(): Promise<NotificationStatus | null> {
+    return null;
+  }
+
+  /**
+   * Check notification permissions
+   * @see PlatformService.checkNotificationPermissions
+   * @returns null - notifications not supported on Electron platform
+   */
+  async checkNotificationPermissions(): Promise<PermissionStatus | null> {
+    return null;
+  }
+
+  /**
+   * Request notification permissions
+   * @see PlatformService.requestNotificationPermissions
+   * @returns null - notifications not supported on Electron platform
+   */
+  async requestNotificationPermissions(): Promise<PermissionResult | null> {
+    return null;
+  }
+
+  /**
+   * Schedule a daily notification
+   * @see PlatformService.scheduleDailyNotification
+   * @throws Error - notifications not supported on Electron platform
+   */
+  async scheduleDailyNotification(_options: ScheduleOptions): Promise<void> {
+    throw new Error(
+      "Daily notifications are not supported on Electron platform",
+    );
+  }
+
+  /**
+   * Cancel scheduled daily notification
+   * @see PlatformService.cancelDailyNotification
+   * @throws Error - notifications not supported on Electron platform
+   */
+  async cancelDailyNotification(): Promise<void> {
+    throw new Error(
+      "Daily notifications are not supported on Electron platform",
+    );
+  }
+
+  /**
+   * Configure native fetcher for background operations
+   * @see PlatformService.configureNativeFetcher
+   * @returns null - native fetcher not supported on Electron platform
+   */
+  async configureNativeFetcher(
+    _config: NativeFetcherConfig,
+  ): Promise<void | null> {
+    return null;
+  }
+
+  /**
+   * Update starred plans for background fetcher
+   * @see PlatformService.updateStarredPlans
+   * @returns null - native fetcher not supported on Electron platform
+   */
+  async updateStarredPlans(_plans: {
+    planIds: string[];
+  }): Promise<void | null> {
+    return null;
+  }
+
+  /**
+   * Open the app's notification settings in the system settings
+   * @see PlatformService.openAppNotificationSettings
+   * @returns null - not supported on Electron platform
+   */
+  async openAppNotificationSettings(): Promise<void | null> {
+    return null;
+  }
 }

src/services/platforms/WebPlatformService.ts

@@ -2,9 +2,15 @@ import {
   ImageResult,
   PlatformService,
   PlatformCapabilities,
+  NotificationStatus,
+  PermissionStatus,
+  PermissionResult,
+  ScheduleOptions,
+  NativeFetcherConfig,
 } from "../PlatformService";
 import { logger } from "../../utils/logger";
 import { QueryExecResult } from "@/interfaces/database";
+import { BaseDatabaseService } from "./BaseDatabaseService";
 // Dynamic import of initBackend to prevent worker context errors
 import type {
   WorkerRequest,
@@ -29,7 +35,10 @@ import type {
  * Note: File system operations are not available in the web platform
  * due to browser security restrictions. These methods throw appropriate errors.
  */
-export class WebPlatformService implements PlatformService {
+export class WebPlatformService
+  extends BaseDatabaseService
+  implements PlatformService
+{
   private static instanceCount = 0; // Debug counter
   private worker: Worker | null = null;
   private workerReady = false;
@@ -46,17 +55,16 @@ export class WebPlatformService implements PlatformService {
   private readonly messageTimeout = 30000; // 30 seconds
 
   constructor() {
+    super();
     WebPlatformService.instanceCount++;
 
-    // Use debug level logging for development mode to reduce console noise
-    const isDevelopment = process.env.VITE_PLATFORM === "development";
-    const log = isDevelopment ? logger.debug : logger.log;
-
-    log("[WebPlatformService] Initializing web platform service");
+    logger.debug("[WebPlatformService] Initializing web platform service");
 
     // Only initialize SharedArrayBuffer setup for web platforms
     if (this.isWorker()) {
-      log("[WebPlatformService] Skipping initBackend call in worker context");
+      logger.debug(
+        "[WebPlatformService] Skipping initBackend call in worker context",
+      );
       return;
     }
 
@@ -670,105 +678,85 @@ export class WebPlatformService implements PlatformService {
     // SharedArrayBuffer initialization is handled by initBackend call in initializeWorker
   }
 
-  // Database utility methods
-  generateInsertStatement(
-    model: Record<string, unknown>,
-    tableName: string,
-  ): { sql: string; params: unknown[] } {
-    const keys = Object.keys(model);
-    const placeholders = keys.map(() => "?").join(", ");
-    const sql = `INSERT INTO ${tableName} (${keys.join(", ")}) VALUES (${placeholders})`;
-    const params = keys.map((key) => model[key]);
-    return { sql, params };
+  // Database utility methods - inherited from BaseDatabaseService
+  // generateInsertStatement, updateDefaultSettings, updateActiveDid,
+  // getActiveIdentity, insertNewDidIntoSettings, updateDidSpecificSettings,
+  // retrieveSettingsForActiveAccount are all inherited from BaseDatabaseService
+
+  // Daily notification operations
+  /**
+   * Get the status of scheduled daily notifications
+   * @see PlatformService.getDailyNotificationStatus
+   * @returns null - notifications not supported on web platform
+   */
+  async getDailyNotificationStatus(): Promise<NotificationStatus | null> {
+    return null;
   }
 
-  async updateDefaultSettings(
-    settings: Record<string, unknown>,
-  ): Promise<void> {
-    // Get current active DID and update that identity's settings
-    const activeIdentity = await this.getActiveIdentity();
-    const activeDid = activeIdentity.activeDid;
-
-    if (!activeDid) {
-      logger.warn(
-        "[WebPlatformService] No active DID found, cannot update default settings",
-      );
-      return;
-    }
-
-    const keys = Object.keys(settings);
-    const setClause = keys.map((key) => `${key} = ?`).join(", ");
-    const sql = `UPDATE settings SET ${setClause} WHERE accountDid = ?`;
-    const params = [...keys.map((key) => settings[key]), activeDid];
-    await this.dbExec(sql, params);
+  /**
+   * Check notification permissions
+   * @see PlatformService.checkNotificationPermissions
+   * @returns null - notifications not supported on web platform
+   */
+  async checkNotificationPermissions(): Promise<PermissionStatus | null> {
+    return null;
   }
 
-  async updateActiveDid(did: string): Promise<void> {
-    await this.dbExec(
-      "INSERT OR REPLACE INTO active_identity (id, activeDid, lastUpdated) VALUES (1, ?, ?)",
-      [did, new Date().toISOString()],
-    );
+  /**
+   * Request notification permissions
+   * @see PlatformService.requestNotificationPermissions
+   * @returns null - notifications not supported on web platform
+   */
+  async requestNotificationPermissions(): Promise<PermissionResult | null> {
+    return null;
   }
 
-  async getActiveIdentity(): Promise<{ activeDid: string }> {
-    const result = await this.dbQuery(
-      "SELECT activeDid FROM active_identity WHERE id = 1",
-    );
-    return {
-      activeDid: (result?.values?.[0]?.[0] as string) || "",
-    };
+  /**
+   * Schedule a daily notification
+   * @see PlatformService.scheduleDailyNotification
+   * @throws Error - notifications not supported on web platform
+   */
+  async scheduleDailyNotification(_options: ScheduleOptions): Promise<void> {
+    throw new Error("Daily notifications are not supported on web platform");
   }
 
-  async insertNewDidIntoSettings(did: string): Promise<void> {
-    // Import constants dynamically to avoid circular dependencies
-    const { DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER } =
-      await import("@/constants/app");
-
-    // Use INSERT OR REPLACE to handle case where settings already exist for this DID
-    // This prevents duplicate accountDid entries and ensures data integrity
-    await this.dbExec(
-      "INSERT OR REPLACE INTO settings (accountDid, finishedOnboarding, apiServer, partnerApiServer) VALUES (?, ?, ?, ?)",
-      [did, false, DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER],
-    );
+  /**
+   * Cancel scheduled daily notification
+   * @see PlatformService.cancelDailyNotification
+   * @throws Error - notifications not supported on web platform
+   */
+  async cancelDailyNotification(): Promise<void> {
+    throw new Error("Daily notifications are not supported on web platform");
   }
 
-  async updateDidSpecificSettings(
-    did: string,
-    settings: Record<string, unknown>,
-  ): Promise<void> {
-    const keys = Object.keys(settings);
-    const setClause = keys.map((key) => `${key} = ?`).join(", ");
-    const sql = `UPDATE settings SET ${setClause} WHERE accountDid = ?`;
-    const params = [...keys.map((key) => settings[key]), did];
-    // Log update operation for debugging
-    logger.debug(
-      "[WebPlatformService] updateDidSpecificSettings",
-      sql,
-      JSON.stringify(params, null, 2),
-    );
-    await this.dbExec(sql, params);
+  /**
+   * Configure native fetcher for background operations
+   * @see PlatformService.configureNativeFetcher
+   * @returns null - native fetcher not supported on web platform
+   */
+  async configureNativeFetcher(
+    _config: NativeFetcherConfig,
+  ): Promise<void | null> {
+    return null;
   }
 
-  async retrieveSettingsForActiveAccount(): Promise<Record<
-    string,
-    unknown
-  > | null> {
-    const result = await this.dbQuery("SELECT * FROM settings WHERE id = 1");
-    if (result?.values?.[0]) {
-      // Convert the row to an object
-      const row = result.values[0];
-      const columns = result.columns || [];
-      const settings: Record<string, unknown> = {};
+  /**
+   * Update starred plans for background fetcher
+   * @see PlatformService.updateStarredPlans
+   * @returns null - native fetcher not supported on web platform
+   */
+  async updateStarredPlans(_plans: {
+    planIds: string[];
+  }): Promise<void | null> {
+    return null;
+  }
 
-      columns.forEach((column, index) => {
-        if (column !== "id") {
-          // Exclude the id column
-          settings[column] = row[index];
-        }
-      });
-
-      return settings;
-    }
+  /**
+   * Open the app's notification settings in the system settings
+   * @see PlatformService.openAppNotificationSettings
+   * @returns null - not supported on web platform
+   */
+  async openAppNotificationSettings(): Promise<void | null> {
     return null;
   }
 }

src/test/EntityGridFunctionPropTest.vue

@@ -19,7 +19,6 @@
       <EntityGrid
         entity-type="people"
         :entities="people"
-        :max-items="5"
         :active-did="activeDid"
         :all-my-dids="allMyDids"
         :all-contacts="people"
@@ -39,7 +38,6 @@
       <EntityGrid
         entity-type="projects"
         :entities="projects"
-        :max-items="3"
         :active-did="activeDid"
         :all-my-dids="allMyDids"
         :all-contacts="people"
@@ -152,11 +150,8 @@ export default class EntityGridFunctionPropTest extends Vue {
   customPeopleFunction = (
     entities: Contact[],
     _entityType: string,
-    maxItems: number,
   ): Contact[] => {
-    return entities
-      .filter((person) => person.profileImageUrl)
-      .slice(0, maxItems);
+    return entities.filter((person) => person.profileImageUrl);
   };
 
   /**
@@ -165,7 +160,6 @@ export default class EntityGridFunctionPropTest extends Vue {
   customProjectsFunction = (
     entities: PlanData[],
     _entityType: string,
-    _maxItems: number,
   ): PlanData[] => {
     return entities.sort((a, b) => a.name.localeCompare(b.name)).slice(0, 3);
   };
@@ -200,16 +194,16 @@ export default class EntityGridFunctionPropTest extends Vue {
    */
   get displayedPeopleCount(): number {
     if (this.useCustomFunction) {
-      return this.customPeopleFunction(this.people, "people", 5).length;
+      return this.customPeopleFunction(this.people, "people").length;
     }
-    return Math.min(5, this.people.length);
+    return Math.min(10, this.people.length); // Initial batch size for infinite scroll
   }
 
   get displayedProjectsCount(): number {
     if (this.useCustomFunction) {
-      return this.customProjectsFunction(this.projects, "projects", 3).length;
+      return this.customProjectsFunction(this.projects, "projects").length;
     }
-    return Math.min(7, this.projects.length);
+    return Math.min(10, this.projects.length); // Initial batch size for infinite scroll
   }
 }
 </script>

src/test/PlatformServiceMixinTest.vue

@@ -85,7 +85,6 @@
 <script lang="ts">
 import { Component, Vue } from "vue-facing-decorator";
 import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
-import { MASTER_SETTINGS_KEY } from "@/db/tables/settings";
 
 @Component({
   mixins: [PlatformServiceMixin],
@@ -197,10 +196,10 @@ This tests the helper method only - no database interaction`;
       const success = await this.$saveSettings(testSettings);
 
       if (success) {
-        // Now query the raw database to see how it's actually stored
+        // Now query the raw database to see how it's actually stored.
+        // Note that new users probably have settings with ID of 1 but old migrated users might skip to 2.
         const rawResult = await this.$dbQuery(
-          "SELECT searchBoxes FROM settings WHERE id = ?",
-          [MASTER_SETTINGS_KEY],
+          "SELECT searchBoxes FROM settings limit 1",
         );
 
         if (rawResult?.values?.length) {

src/utils/PlatformServiceMixin.ts

@@ -301,7 +301,11 @@ export const PlatformServiceMixin = {
           }
 
           // Convert SQLite JSON strings to objects/arrays
-          if (column === "contactMethods" || column === "searchBoxes") {
+          if (
+            column === "contactMethods" ||
+            column === "searchBoxes" ||
+            column === "starredPlanHandleIds"
+          ) {
             value = this._parseJsonField(value, []);
           }
 
@@ -349,6 +353,14 @@ export const PlatformServiceMixin = {
           ? JSON.stringify(settings.searchBoxes)
           : String(settings.searchBoxes);
       }
+      if (settings.starredPlanHandleIds !== undefined) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (converted as any).starredPlanHandleIds = Array.isArray(
+          settings.starredPlanHandleIds,
+        )
+          ? JSON.stringify(settings.starredPlanHandleIds)
+          : String(settings.starredPlanHandleIds);
+      }
 
       return converted;
     },
@@ -514,7 +526,7 @@ export const PlatformServiceMixin = {
      * Utility method for retrieving master settings
      * Common pattern used across many components
      */
-    async $getMasterSettings(
+    async _getMasterSettings(
       fallback: Settings | null = null,
     ): Promise<Settings | null> {
       try {
@@ -551,6 +563,12 @@ export const PlatformServiceMixin = {
         if (settings.searchBoxes) {
           settings.searchBoxes = this._parseJsonField(settings.searchBoxes, []);
         }
+        if (settings.starredPlanHandleIds) {
+          settings.starredPlanHandleIds = this._parseJsonField(
+            settings.starredPlanHandleIds,
+            [],
+          );
+        }
 
         return settings;
       } catch (error) {
@@ -571,7 +589,7 @@ export const PlatformServiceMixin = {
     ): Promise<Settings> {
       try {
         // Get default settings
-        const defaultSettings = await this.$getMasterSettings(defaultFallback);
+        const defaultSettings = await this._getMasterSettings(defaultFallback);
 
         // If no account DID, return defaults
         if (!accountDid) {
@@ -617,6 +635,12 @@ export const PlatformServiceMixin = {
             [],
           );
         }
+        if (mergedSettings.starredPlanHandleIds) {
+          mergedSettings.starredPlanHandleIds = this._parseJsonField(
+            mergedSettings.starredPlanHandleIds,
+            [],
+          );
+        }
 
         return mergedSettings;
       } catch (error) {
@@ -946,6 +970,20 @@ export const PlatformServiceMixin = {
       return this.$normalizeContacts(rawContacts);
     },
 
+    /**
+     * Load all contacts sorted by when they were added (by ID)
+     * Always fetches fresh data from database for consistency
+     * Handles JSON string/object duality for contactMethods field
+     * @returns Promise<Contact[]> Array of normalized contact objects sorted by addition date (newest first)
+     */
+    async $contactsByDateAdded(): Promise<Contact[]> {
+      const rawContacts = (await this.$query(
+        "SELECT * FROM contacts ORDER BY id DESC",
+      )) as ContactMaybeWithJsonStrings[];
+
+      return this.$normalizeContacts(rawContacts);
+    },
+
     /**
      * Ultra-concise shortcut for getting number of contacts
      * @returns Promise<number> Total number of contacts
@@ -970,7 +1008,7 @@ export const PlatformServiceMixin = {
      * @returns Fresh settings object from database
      */
     async $settings(defaults: Settings = {}): Promise<Settings> {
-      const settings = await this.$getMasterSettings(defaults);
+      const settings = await this._getMasterSettings(defaults);
 
       if (!settings) {
         return defaults;
@@ -1003,7 +1041,7 @@ export const PlatformServiceMixin = {
     ): Promise<Settings> {
       try {
         // Get default settings first
-        const defaultSettings = await this.$getMasterSettings(defaults);
+        const defaultSettings = await this._getMasterSettings(defaults);
 
         if (!defaultSettings) {
           return defaults;
@@ -1212,6 +1250,11 @@ export const PlatformServiceMixin = {
      * @param changes Settings changes to save
      * @returns Promise<boolean> Success status
      */
+    /**
+     * Since this is unused, and since it relies on this.activeDid which isn't guaranteed to exist,
+     * let's take this out for the sake of safety.
+     * Totally remove after start of 2026 (since it would be obvious by then that it's not used).
+     *
     async $saveMySettings(changes: Partial<Settings>): Promise<boolean> {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       const currentDid = (this as any).activeDid;
@@ -1221,6 +1264,7 @@ export const PlatformServiceMixin = {
       }
       return await this.$saveUserSettings(currentDid, changes);
     },
+    **/
 
     // =================================================
     // CACHE MANAGEMENT METHODS
@@ -1842,7 +1886,7 @@ export const PlatformServiceMixin = {
     async $debugMergedSettings(did: string): Promise<void> {
       try {
         // Get default settings
-        const defaultSettings = await this.$getMasterSettings({});
+        const defaultSettings = await this._getMasterSettings({});
         logger.debug(
           `[PlatformServiceMixin] Default settings:`,
           defaultSettings,
@@ -1892,7 +1936,6 @@ export interface IPlatformServiceMixin {
     params?: unknown[],
   ): Promise<SqlValue[] | undefined>;
   $dbRawQuery(sql: string, params?: unknown[]): Promise<unknown | undefined>;
-  $getMasterSettings(fallback?: Settings | null): Promise<Settings | null>;
   $getMergedSettings(
     defaultKey: string,
     accountDid?: string,
@@ -2017,7 +2060,6 @@ declare module "@vue/runtime-core" {
       params?: unknown[],
     ): Promise<unknown[] | undefined>;
     $dbRawQuery(sql: string, params?: unknown[]): Promise<unknown | undefined>;
-    $getMasterSettings(defaults?: Settings | null): Promise<Settings | null>;
     $getMergedSettings(
       key: string,
       did?: string,
@@ -2029,6 +2071,7 @@ declare module "@vue/runtime-core" {
 
     // Specialized shortcuts - contacts cached, settings fresh
     $contacts(): Promise<Contact[]>;
+    $contactsByDateAdded(): Promise<Contact[]>;
     $contactCount(): Promise<number>;
     $settings(defaults?: Settings): Promise<Settings>;
     $accountSettings(did?: string, defaults?: Settings): Promise<Settings>;
@@ -2040,7 +2083,8 @@ declare module "@vue/runtime-core" {
       did: string,
       changes: Partial<Settings>,
     ): Promise<boolean>;
-    $saveMySettings(changes: Partial<Settings>): Promise<boolean>;
+    // @deprecated; see implementation note above
+    // $saveMySettings(changes: Partial<Settings>): Promise<boolean>;
 
     // Cache management methods
     $refreshSettings(): Promise<Settings>;

src/utils/logger.ts

@@ -24,10 +24,28 @@ export function getMemoryLogs(): string[] {
   return [..._memoryLogs];
 }
 
+/**
+ * Stringify an object with proper handling of circular references and functions
+ *
+ * Don't use for arrays; map with this over the array.
+ *
+ * @param obj - The object to stringify
+ * @returns The stringified object, plus 'message' and 'stack' for Error objects
+ */
 export function safeStringify(obj: unknown) {
   const seen = new WeakSet();
 
-  return JSON.stringify(obj, (_key, value) => {
+  // since 'message' & 'stack' are not enumerable for errors, let's add those
+  let objToStringify = obj;
+  if (obj instanceof Error) {
+    objToStringify = {
+      ...obj,
+      message: obj.message,
+      stack: obj.stack,
+    };
+  }
+
+  return JSON.stringify(objToStringify, (_key, value) => {
     if (typeof value === "object" && value !== null) {
       if (seen.has(value)) {
         return "[Circular]";
@@ -178,7 +196,8 @@ export const logger = {
     }
 
     // Database logging
-    const argsString = args.length > 0 ? " - " + safeStringify(args) : "";
+    const argsString =
+      args.length > 0 ? " - " + args.map(safeStringify).join(", ") : "";
     logToDatabase(message + argsString, "info");
   },
 
@@ -189,7 +208,8 @@ export const logger = {
     }
 
     // Database logging
-    const argsString = args.length > 0 ? " - " + safeStringify(args) : "";
+    const argsString =
+      args.length > 0 ? " - " + args.map(safeStringify).join(", ") : "";
     logToDatabase(message + argsString, "info");
   },
 
@@ -200,7 +220,8 @@ export const logger = {
     }
 
     // Database logging
-    const argsString = args.length > 0 ? " - " + safeStringify(args) : "";
+    const argsString =
+      args.length > 0 ? " - " + args.map(safeStringify).join(", ") : "";
     logToDatabase(message + argsString, "warn");
   },
 
@@ -211,9 +232,9 @@ export const logger = {
     }
 
     // Database logging
-    const messageString = safeStringify(message);
-    const argsString = args.length > 0 ? safeStringify(args) : "";
-    logToDatabase(messageString + argsString, "error");
+    const argsString =
+      args.length > 0 ? " - " + args.map(safeStringify).join(", ") : "";
+    logToDatabase(message + argsString, "error");
   },
 
   // New database-focused methods (self-contained)

src/views/AccountViewView.vue

@@ -1,6 +1,5 @@
 <template>
   <QuickNav selected="Profile" />
-  <TopMessage />
 
   <!-- CONTENT -->
   <main
@@ -9,10 +8,22 @@
     role="main"
     aria-label="Account Profile"
   >
-    <!-- Heading -->
-    <h1 id="ViewHeading" class="text-4xl text-center font-light">
-      Your Identity
-    </h1>
+    <TopMessage />
+
+    <!-- Main View Heading -->
+    <div class="flex gap-4 items-center mb-8">
+      <h1 id="ViewHeading" class="text-2xl font-bold leading-none">
+        Your Identity
+      </h1>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
+    </div>
 
     <!-- ID notice -->
     <div
@@ -150,7 +161,8 @@
     </section>
     <PushNotificationPermission ref="pushNotificationPermission" />
 
-    <LocationSearchSection :search-box="searchBox" />
+    <!-- Daily Notifications (Native) -->
+    <DailyNotificationSection />
 
     <!-- User Profile -->
     <section
@@ -244,6 +256,8 @@
       <div v-else>Saving...</div>
     </section>
 
+    <LocationSearchSection :search-box="searchBox" />
+
     <UsageLimitsSection
       v-if="activeDid"
       :loading-limits="loadingLimits"
@@ -779,6 +793,7 @@ import IdentitySection from "@/components/IdentitySection.vue";
 import RegistrationNotice from "@/components/RegistrationNotice.vue";
 import LocationSearchSection from "@/components/LocationSearchSection.vue";
 import UsageLimitsSection from "@/components/UsageLimitsSection.vue";
+import DailyNotificationSection from "@/components/notifications/DailyNotificationSection.vue";
 import {
   AppString,
   DEFAULT_IMAGE_API_SERVER,
@@ -810,6 +825,7 @@ import {
 import { logger } from "../utils/logger";
 import { PlatformServiceMixin } from "../utils/PlatformServiceMixin";
 import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
+import { PlatformServiceFactory } from "../services/PlatformServiceFactory";
 import { ACCOUNT_VIEW_CONSTANTS } from "@/constants/accountView";
 import { showSeedPhraseReminder } from "@/utils/seedPhraseReminder";
 import {
@@ -847,6 +863,7 @@ interface UserNameDialogRef {
     RegistrationNotice,
     LocationSearchSection,
     UsageLimitsSection,
+    DailyNotificationSection,
   },
   mixins: [PlatformServiceMixin],
 })
@@ -1064,8 +1081,8 @@ export default class AccountViewView extends Vue {
     this.hideRegisterPromptOnNewContact =
       !!settings.hideRegisterPromptOnNewContact;
     this.isRegistered = !!settings?.isRegistered;
-    this.isSearchAreasSet = !!settings.searchBoxes;
-    this.searchBox = settings.searchBoxes?.[0] || null;
+    this.isSearchAreasSet =
+      !!settings.searchBoxes && settings.searchBoxes.length > 0;
     this.notifyingNewActivity = !!settings.notifyingNewActivityTime;
     this.notifyingNewActivityTime = settings.notifyingNewActivityTime || "";
     this.notifyingReminder = !!settings.notifyingReminderTime;
@@ -1079,6 +1096,7 @@ export default class AccountViewView extends Vue {
     this.passkeyExpirationMinutes =
       settings.passkeyExpirationMinutes ?? DEFAULT_PASSKEY_EXPIRATION_MINUTES;
     this.previousPasskeyExpirationMinutes = this.passkeyExpirationMinutes;
+    this.searchBox = settings.searchBoxes?.[0] || null;
     this.showGeneralAdvanced = !!settings.showGeneralAdvanced;
     this.showShortcutBvc = !!settings.showShortcutBvc;
     this.warnIfProdServer = !!settings.warnIfProdServer;
@@ -1454,7 +1472,6 @@ export default class AccountViewView extends Vue {
         this.imageLimits = imageResp.data;
       } else {
         this.limitsMessage = ACCOUNT_VIEW_CONSTANTS.LIMITS.NO_IMAGE_ACCESS;
-        this.notify.warning(ACCOUNT_VIEW_CONSTANTS.LIMITS.CANNOT_UPLOAD_IMAGES);
       }
 
       const endorserResp = await fetchEndorserRateLimits(
@@ -1465,9 +1482,6 @@ export default class AccountViewView extends Vue {
 
       if (endorserResp.status === 200) {
         this.endorserLimits = endorserResp.data;
-      } else {
-        this.limitsMessage = ACCOUNT_VIEW_CONSTANTS.LIMITS.NO_LIMITS_FOUND;
-        this.notify.warning(ACCOUNT_VIEW_CONSTANTS.LIMITS.BAD_SERVER_RESPONSE);
       }
     } catch (error) {
       this.limitsMessage =
@@ -1480,18 +1494,21 @@ export default class AccountViewView extends Vue {
           status?: number;
         };
       };
-      logger.error("[Server Limits] Error retrieving limits:", {
-        error: error instanceof Error ? error.message : String(error),
-        did: did,
-        apiServer: this.apiServer,
-        imageServer: this.DEFAULT_IMAGE_API_SERVER,
-        partnerApiServer: this.partnerApiServer,
-        errorCode: axiosError?.response?.data?.error?.code,
-        errorMessage: axiosError?.response?.data?.error?.message,
-        httpStatus: axiosError?.response?.status,
-        needsUserMigration: true,
-        timestamp: new Date().toISOString(),
-      });
+      logger.warn(
+        "[Server Limits] Error retrieving limits, expected for unregistered users:",
+        {
+          error: error instanceof Error ? error.message : String(error),
+          did: did,
+          apiServer: this.apiServer,
+          imageServer: this.DEFAULT_IMAGE_API_SERVER,
+          partnerApiServer: this.partnerApiServer,
+          errorCode: axiosError?.response?.data?.error?.code,
+          errorMessage: axiosError?.response?.data?.error?.message,
+          httpStatus: axiosError?.response?.status,
+          needsUserMigration: true,
+          timestamp: new Date().toISOString(),
+        },
+      );
 
       // this.notify.error(this.limitsMessage, TIMEOUTS.STANDARD);
     } finally {
@@ -1531,6 +1548,33 @@ export default class AccountViewView extends Vue {
       settingsSaved: true,
       timestamp: new Date().toISOString(),
     });
+
+    // Refresh native fetcher configuration with new API server
+    // This ensures background notification prefetch uses the updated endpoint
+    try {
+      const platformService = PlatformServiceFactory.getInstance();
+      const settings = await this.$accountSettings();
+      const starredPlanHandleIds = settings.starredPlanHandleIds || [];
+
+      await platformService.configureNativeFetcher({
+        apiServer: newApiServer,
+        jwt: "", // Will be generated automatically by configureNativeFetcher
+        starredPlanHandleIds,
+      });
+
+      logger.info(
+        "[AccountViewView] Native fetcher configuration refreshed after API server change",
+        {
+          newApiServer,
+        },
+      );
+    } catch (error) {
+      logger.error(
+        "[AccountViewView] Failed to refresh native fetcher config after API server change:",
+        error,
+      );
+      // Don't throw - API server change should still succeed even if native fetcher refresh fails
+    }
   }
 
   async onClickSavePartnerServer(): Promise<void> {

src/views/ClaimAddRawView.vue

@@ -1,19 +1,27 @@
 <template>
-  <QuickNav />
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-lg text-center font-light relative px-7">
-        <!-- Back -->
-        <button
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="$router.back()"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw" />
-        </button>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Raw Claim
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <div class="flex">

src/views/ClaimView.vue

@@ -2,19 +2,27 @@
   <QuickNav />
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-lg text-center font-light relative px-7">
-        <!-- Back -->
-        <button
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          aria-label="Go back"
-          @click="$router.go(-1)"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw" />
-        </button>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Verifiable Claim Details
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <!-- Details -->
@@ -80,16 +88,25 @@
               </button>
             </div>
           </div>
-          <div class="text-sm">
-            <div data-testId="description">
-              <font-awesome icon="message" class="fa-fw text-slate-400" />
-              {{ claimDescription }}
+          <div class="text-sm overflow-hidden">
+            <div
+              data-testId="description"
+              class="flex items-start gap-2 overflow-hidden"
+            >
+              <font-awesome
+                icon="message"
+                class="fa-fw text-slate-400 flex-shrink-0 mt-1"
+              />
+              <vue-markdown
+                :source="claimDescription"
+                class="markdown-content flex-1 min-w-0"
+              />
             </div>
-            <div>
+            <div class="overflow-hidden text-ellipsis">
               <font-awesome icon="user" class="fa-fw text-slate-400" />
               {{ didInfo(veriClaim.issuer) }}
             </div>
-            <div>
+            <div class="overflow-hidden text-ellipsis">
               <font-awesome icon="calendar" class="fa-fw text-slate-400" />
               Recorded
               {{ formattedIssueDate }}
@@ -533,9 +550,11 @@ import { AxiosError } from "axios";
 import * as yaml from "js-yaml";
 import * as R from "ramda";
 import { Component, Vue } from "vue-facing-decorator";
+import VueMarkdown from "vue-markdown-render";
 import { Router, RouteLocationNormalizedLoaded } from "vue-router";
 import { copyToClipboard } from "../services/ClipboardService";
-import { GenericVerifiableCredential } from "../interfaces";
+
+import { EmojiClaim, GenericVerifiableCredential } from "../interfaces";
 import GiftedDialog from "../components/GiftedDialog.vue";
 import QuickNav from "../components/QuickNav.vue";
 import { NotificationIface } from "../constants/app";
@@ -553,7 +572,7 @@ import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
 import { APP_SERVER } from "@/constants/app";
 
 @Component({
-  components: { GiftedDialog, QuickNav },
+  components: { GiftedDialog, QuickNav, VueMarkdown },
   mixins: [PlatformServiceMixin],
 })
 export default class ClaimView extends Vue {
@@ -651,6 +670,10 @@ export default class ClaimView extends Vue {
       return giveClaim.description || "";
     }
 
+    if (this.veriClaim.claimType === "Emoji") {
+      return (claim as EmojiClaim).text || "";
+    }
+
     // Fallback for other claim types
     return (claim as { description?: string })?.description || "";
   }

src/views/ConfirmContactView.vue

@@ -1,18 +1,27 @@
 <template>
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-lg text-center font-light relative px-7">
-        <!-- Cancel -->
-        <router-link
-          :to="{ name: 'account' }"
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          ><font-awesome icon="chevron-left" class="fa-fw"></font-awesome>
-        </router-link>
-
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Confirm Contact
       </h1>
+
+      <!-- Back -->
+      <router-link
+        class="order-first text-lg text-center leading-none p-1"
+        :to="{ name: 'account' }"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </router-link>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <p class="text-center text-xl mb-4 font-light">

src/views/ConfirmGiftView.vue

@@ -1,18 +1,11 @@
 <template>
-  <QuickNav />
-  <TopMessage />
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-lg text-center font-light relative px-7">
-        <!-- Back -->
-        <button
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="$router.go(-1)"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw" />
-        </button>
+    <TopMessage />
+
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         <span
           v-if="
             libsUtil.isGiveRecordTheUserCanConfirm(
@@ -25,8 +18,24 @@
         >
           Do you agree?
         </span>
-        <span v-else> Confirmation Details </span>
+        <span v-else>Confirmation Details</span>
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <div v-if="giveDetails && !isLoading">

src/views/ContactAmountsView.vue

@@ -2,18 +2,27 @@
   <QuickNav selected="Contacts" />
 
   <section class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Header -->
-    <div class="mb-8">
-      <router-link
-        :to="{ name: 'contacts' }"
-        class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-      >
-        <font-awesome icon="chevron-left" class="fa-fw" />
-      </router-link>
-
-      <h1 class="text-4xl text-center font-light pt-4">
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Transferred with {{ contact?.name }}
       </h1>
+
+      <!-- Back -->
+      <router-link
+        class="order-first text-lg text-center leading-none p-1"
+        :to="{ name: 'contacts' }"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </router-link>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <!-- Info Messages -->
@@ -223,7 +232,7 @@ export default class ContactAmountssView extends Vue {
       const contact = await this.$getContact(contactDid);
       this.contact = contact;
 
-      const settings = await this.$getMasterSettings();
+      const settings = await this.$accountSettings();
 
       // Get activeDid from active_identity table (single source of truth)
       // eslint-disable-next-line @typescript-eslint/no-explicit-any

src/views/ContactEditView.vue

@@ -1,19 +1,28 @@
 <template>
-  <QuickNav selected="Contacts" />
-  <TopMessage />
-
   <section id="ContactEdit" class="p-6 max-w-3xl mx-auto">
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-4xl text-center font-light relative px-7">
-        <!-- Back -->
-        <button
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="$router.go(-1)"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw" />
-        </button>
+    <TopMessage />
+
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         {{ contact?.name || AppString.NO_CONTACT_NAME }}
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <!-- Contact Name -->
@@ -337,9 +346,7 @@ export default class ContactEditView extends Vue {
 
     // Notify success and redirect
     this.notify.success(NOTIFY_CONTACT_SAVED.message, TIMEOUTS.STANDARD);
-    (this.$router as Router).push({
-      path: "/did/" + encodeURIComponent(this.contact?.did || ""),
-    });
+    this.$router.back();
   }
 }
 </script>

src/views/ContactGiftingView.vue

@@ -2,17 +2,27 @@
   <QuickNav selected="Home"></QuickNav>
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-2xl text-center font-semibold relative px-7">
-        <!-- Back -->
-        <router-link
-          :to="{ name: 'home' }"
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          ><font-awesome icon="chevron-left" class="fa-fw"></font-awesome>
-        </router-link>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         {{ stepType === "giver" ? "Given by..." : "Given to..." }}
       </h1>
+
+      <!-- Back -->
+      <router-link
+        class="order-first text-lg text-center leading-none p-1"
+        :to="{ name: 'home' }"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </router-link>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <!-- Results List -->

src/views/ContactImportView.vue

@@ -1,20 +1,28 @@
 <template>
   <QuickNav selected="Contacts"></QuickNav>
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Back -->
-    <div class="text-lg text-center font-light relative px-7">
-      <h1
-        class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-        @click="$router.back()"
-      >
-        <font-awesome icon="chevron-left" class="fa-fw"></font-awesome>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
+        Contact Import
       </h1>
-    </div>
 
-    <!-- Heading -->
-    <h1 id="ViewHeading" class="text-4xl text-center font-light pt-4 mb-8">
-      Contact Import
-    </h1>
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
+    </div>
 
     <div v-if="checkingImports" class="text-center">
       <font-awesome icon="spinner" class="animate-spin" />

src/views/ContactQRScanFullView.vue

@@ -2,26 +2,27 @@
   <!-- CONTENT -->
   <section id="Content" class="relative w-[100vw] h-[100vh]">
     <div :class="mainContentClasses">
-      <div class="mb-4">
-        <h1 class="text-xl text-center font-semibold relative">
-          <!-- Back -->
-          <a
-            class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-            @click="handleBack"
-          >
-            <font-awesome icon="chevron-left" class="fa-fw" />
-          </a>
-
-          <!-- Quick Help -->
-          <a
-            class="text-xl text-center text-blue-500 px-2 py-1 absolute -right-2 -top-1"
-            @click="toastQRCodeHelp()"
-          >
-            <font-awesome icon="circle-question" class="fa-fw" />
-          </a>
-
+      <!-- Sub View Heading -->
+      <div id="SubViewHeading" class="flex gap-4 items-start mb-4">
+        <h1 class="grow text-xl text-center font-semibold leading-tight">
           Share Contact Info
         </h1>
+
+        <!-- Back -->
+        <a
+          class="order-first text-lg text-center leading-none p-1"
+          @click="handleBack"
+        >
+          <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+        </a>
+
+        <!-- Quick Help -->
+        <a
+          class="block text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+          @click="toastQRCodeHelp()"
+        >
+          <font-awesome icon="question" class="block text-center w-[1em]" />
+        </a>
       </div>
 
       <div
@@ -235,7 +236,7 @@ export default class ContactQRScanFull extends Vue {
    * Computed property for main content container CSS classes
    */
   get mainContentClasses(): string {
-    return "p-6 bg-white w-full max-w-[calc((100vh-max(env(safe-area-inset-top),var(--safe-area-inset-top,0px))-max(env(safe-area-inset-bottom),var(--safe-area-inset-bottom,0px)))*0.4)] mx-auto";
+    return "p-4 bg-white w-full max-w-[calc((100vh-max(env(safe-area-inset-top),var(--safe-area-inset-top,0px))-max(env(safe-area-inset-bottom),var(--safe-area-inset-bottom,0px)))*0.4)] mx-auto";
   }
 
   /**

src/views/ContactQRScanShowView.vue

@@ -1,26 +1,27 @@
 <template>
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <div class="mb-2">
-      <h1 class="text-2xl text-center font-semibold relative px-7">
-        <!-- Back -->
-        <a
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="handleBack"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw" />
-        </a>
-
-        <!-- Quick Help -->
-        <a
-          class="text-2xl text-center text-blue-500 px-2 py-1 absolute -right-2 -top-1"
-          @click="toastQRCodeHelp()"
-        >
-          <font-awesome icon="circle-question" class="fa-fw" />
-        </a>
-
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Share Contact Info
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="handleBack"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Quick Help -->
+      <a
+        class="block text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+        @click="toastQRCodeHelp()"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </a>
     </div>
 
     <div v-if="!givenName" :class="nameWarningClasses">

src/views/ContactsView.vue

@@ -1,14 +1,25 @@
 <template>
   <QuickNav selected="Contacts" />
-  <TopMessage />
 
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Heading -->
-    <h1 id="ViewHeading" class="text-4xl text-center font-light">
-      Your Contacts
-    </h1>
+    <TopMessage />
 
-    <div class="flex justify-between py-2 mt-8">
+    <!-- Main View Heading -->
+    <div class="flex gap-4 items-center mb-4">
+      <h1 id="ViewHeading" class="text-2xl font-bold leading-none">
+        Your Contacts
+      </h1>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
+    </div>
+
+    <div class="flex justify-between py-2 mt-4">
       <span />
       <span>
         <a
@@ -160,9 +171,11 @@ import {
   CONTACT_IMPORT_ONE_URL_PATH_TIME_SAFARI,
   CONTACT_URL_PATH_ENDORSER_CH_OLD,
 } from "../libs/endorserServer";
-import { GiveSummaryRecord } from "@/interfaces/records";
-import { UserInfo } from "@/interfaces/common";
-import { VerifiableCredential } from "@/interfaces/claims-result";
+import {
+  GiveSummaryRecord,
+  UserInfo,
+  VerifiableCredential,
+} from "@/interfaces";
 import * as libsUtil from "../libs/util";
 import {
   generateSaveAndActivateIdentity,

src/views/DIDView.vue

@@ -1,22 +1,31 @@
 <template>
   <QuickNav selected="Contacts" />
-  <TopMessage />
 
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 id="ViewHeading" class="text-lg text-center font-light relative px-7">
-        <!-- Go to 'contacts' instead of just 'back' because they could get here from an edit page 
-             (and going back there is annoying). -->
-        <router-link
-          :to="{ name: 'contacts' }"
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw"></font-awesome>
-        </router-link>
+    <TopMessage />
+
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Identifier Details
       </h1>
+
+      <!-- Back -->
+      <button
+        class="order-first text-lg text-center leading-none p-1"
+        @click="goBack()"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </button>
+
+      <!-- Help button -->
+      <button
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+        @click="goToHelp()"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </button>
     </div>
 
     <!-- Identity Details -->
@@ -25,7 +34,7 @@
       class="bg-slate-100 rounded-md overflow-hidden px-4 py-3 mb-4"
     >
       <div>
-        <h2 class="text-xl font-semibold">
+        <h2 class="text-xl font-semibold overflow-hidden text-ellipsis">
           {{ contactFromDid?.name || "(no name)" }}
           <router-link
             :to="{ name: 'contact-edit', params: { did: contactFromDid?.did } }"
@@ -467,7 +476,7 @@ export default class DIDView extends Vue {
    * Navigation helper methods
    */
   goBack() {
-    this.$router.go(-1);
+    this.$router.back();
   }
 
   /**

src/views/DeepLinkErrorView.vue

@@ -1,7 +1,15 @@
 <template>
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <h1>Invalid Deep Link</h1>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1
+        class="grow text-rose-500 text-xl text-center font-semibold leading-tight"
+      >
+        Invalid Deep Link
+      </h1>
+    </div>
+
     <div class="error-details">
       <div class="error-message">
         <h3>Error Details</h3>
@@ -114,11 +122,6 @@ onMounted(() => {
 </script>
 
 <style scoped>
-h1 {
-  color: #ff4444;
-  margin-bottom: 24px;
-}
-
 h2,
 h3 {
   color: #333;

src/views/DeepLinkRedirectView.vue

@@ -2,9 +2,12 @@
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
     <div class="mb-4">
-      <h1 class="text-2xl text-center font-semibold relative px-7">
-        Redirecting to Time Safari
-      </h1>
+      <!-- Sub View Heading -->
+      <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+        <h1 class="grow text-xl text-center font-semibold leading-tight">
+          Redirecting to Time Safari
+        </h1>
+      </div>
 
       <div v-if="destinationUrl" class="space-y-4">
         <!-- Platform-specific messaging -->

src/views/DiscoverView.vue

@@ -1,13 +1,22 @@
 <template>
   <QuickNav selected="Discover" />
-  <TopMessage />
 
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Heading -->
-    <h1 id="ViewHeading" class="text-4xl text-center font-light">
-      Discover Projects & People
-    </h1>
+    <TopMessage />
+
+    <!-- Main View Heading -->
+    <div class="flex gap-4 items-center mb-4">
+      <h1 id="ViewHeading" class="text-2xl font-bold leading-none">Discover</h1>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
+    </div>
 
     <OnboardingDialog ref="onboardingDialog" />
 
@@ -51,6 +60,33 @@
     <!-- Secondary Tabs -->
     <div class="text-center text-slate-500 border-b border-slate-300">
       <ul class="flex flex-wrap justify-center gap-4 -mb-px">
+        <li v-if="isProjectsActive">
+          <a
+            href="#"
+            :class="computedStarredTabStyleClassNames()"
+            @click="
+              projects = [];
+              userProfiles = [];
+              isStarredActive = true;
+              isLocalActive = false;
+              isMappedActive = false;
+              isAnywhereActive = false;
+              isSearchVisible = false;
+              tempSearchBox = null;
+              searchStarred();
+            "
+          >
+            Starred
+            <!-- restore when the links don't jump around for different numbers
+            <span
+              class="font-semibold text-sm bg-slate-200 px-1.5 py-0.5 rounded-md"
+              v-if="isLocalActive"
+            >
+              {{ localCount > -1 ? localCount : "?" }}
+            </span>
+            -->
+          </a>
+        </li>
         <li>
           <a
             href="#"
@@ -58,9 +94,11 @@
             @click="
               projects = [];
               userProfiles = [];
+              isStarredActive = false;
               isLocalActive = true;
               isMappedActive = false;
               isAnywhereActive = false;
+              isStarredActive = false;
               isSearchVisible = true;
               tempSearchBox = null;
               searchLocal();
@@ -84,9 +122,11 @@
             @click="
               projects = [];
               userProfiles = [];
+              isStarredActive = false;
               isLocalActive = false;
               isMappedActive = true;
               isAnywhereActive = false;
+              isStarredActive = false;
               isSearchVisible = false;
               searchTerms = '';
               tempSearchBox = null;
@@ -103,9 +143,11 @@
             @click="
               projects = [];
               userProfiles = [];
+              isStarredActive = false;
               isLocalActive = false;
               isMappedActive = false;
               isAnywhereActive = true;
+              isStarredActive = false;
               isSearchVisible = true;
               tempSearchBox = null;
               searchAll();
@@ -201,6 +243,15 @@
           >No {{ isProjectsActive ? "projects" : "people" }} were found with
           that search.</span
         >
+        <span v-else-if="isStarredActive">
+          <p>
+            You have no starred projects. Star some projects to see them here.
+          </p>
+          <p class="mt-4">
+            When you star projects, you will get a notice on the front page when
+            they change.
+          </p>
+        </span>
       </p>
     </div>
 
@@ -231,8 +282,8 @@
                 />
               </div>
 
-              <div class="grow">
-                <h2 class="text-base font-semibold">
+              <div class="grow overflow-hidden">
+                <h2 class="text-base font-semibold truncate">
                   {{ project.name || unnamedProject }}
                 </h2>
                 <div class="text-sm">
@@ -383,9 +434,12 @@ export default class DiscoverView extends Vue {
   allMyDids: Array<string> = [];
   apiServer = "";
   isLoading = false;
+
   isLocalActive = false;
   isMappedActive = false;
   isAnywhereActive = true;
+  isStarredActive = false;
+
   isProjectsActive = true;
   isPeopleActive = false;
   isSearchVisible = true;
@@ -474,6 +528,8 @@ export default class DiscoverView extends Vue {
         leafletObject: L.Map;
       };
       this.requestTiles(mapRef.leafletObject); // not ideal because I found this from experimentation, not documentation
+    } else if (this.isStarredActive) {
+      await this.searchStarred();
     } else {
       await this.searchAll();
     }
@@ -544,6 +600,60 @@ export default class DiscoverView extends Vue {
     }
   }
 
+  public async searchStarred() {
+    this.resetCounts();
+
+    // Clear any previous results
+    this.projects = [];
+    this.userProfiles = [];
+
+    try {
+      this.isLoading = true;
+
+      // Get starred project IDs from settings
+      const settings = await this.$accountSettings();
+
+      const starredIds = settings.starredPlanHandleIds || [];
+      if (starredIds.length === 0) {
+        // No starred projects
+        return;
+      }
+
+      // This could be optimized to only pull those not already in the cache (endorserServer.ts)
+
+      const planHandleIdsJson = JSON.stringify(starredIds);
+      const endpoint =
+        this.apiServer +
+        "/api/v2/report/plans?planHandleIds=" +
+        encodeURIComponent(planHandleIdsJson);
+      const response = await this.axios.get(endpoint, {
+        headers: await getHeaders(this.activeDid),
+      });
+      if (response.status !== 200) {
+        this.notify.error("Failed to load starred projects", TIMEOUTS.SHORT);
+        return;
+      }
+      const starredPlans: PlanData[] = response.data.data;
+      if (response.data.hitLimit) {
+        // someday we'll have to let them incrementally load the rest
+        this.notify.warning(
+          "Beware: you have so many starred projects that we cannot load them all.",
+          TIMEOUTS.SHORT,
+        );
+      }
+
+      this.projects = starredPlans;
+    } catch (error: unknown) {
+      logger.error("Error loading starred projects:", error);
+      this.notify.error(
+        "Failed to load starred projects. Please try again.",
+        TIMEOUTS.LONG,
+      );
+    } finally {
+      this.isLoading = false;
+    }
+  }
+
   public async searchLocal(beforeId?: string) {
     this.resetCounts();
 
@@ -637,9 +747,12 @@ export default class DiscoverView extends Vue {
         const latestProject = this.projects[this.projects.length - 1];
         if (this.isLocalActive || this.isMappedActive) {
           this.searchLocal(latestProject.rowId);
+        } else if (this.isStarredActive) {
+          this.searchStarred();
         } else if (this.isAnywhereActive) {
           this.searchAll(latestProject.rowId);
         }
+        // Note: Starred tab doesn't support pagination since we load all starred projects at once
       } else if (this.isPeopleActive && this.userProfiles.length > 0) {
         const latestProfile = this.userProfiles[this.userProfiles.length - 1];
         if (this.isLocalActive || this.isMappedActive) {
@@ -779,13 +892,31 @@ export default class DiscoverView extends Vue {
     this.$router.push(route);
   }
 
-  public computedLocalTabStyleClassNames() {
+  public computedStarredTabStyleClassNames() {
     return {
       "inline-block": true,
       "py-3": true,
       "rounded-t-lg": true,
       "border-b-2": true,
 
+      active: this.isStarredActive,
+      "text-black": this.isStarredActive,
+      "border-black": this.isStarredActive,
+      "font-semibold": this.isStarredActive,
+
+      "text-blue-600": !this.isStarredActive,
+      "border-transparent": !this.isStarredActive,
+      "hover:border-slate-400": !this.isStarredActive,
+    };
+  }
+
+  public computedLocalTabStyleClassNames() {
+    return {
+      "inline-block": true,
+      "py-2": true,
+      "rounded-t-lg": true,
+      "border-b-2": true,
+
       active: this.isLocalActive,
       "text-black": this.isLocalActive,
       "border-black": this.isLocalActive,
@@ -800,7 +931,7 @@ export default class DiscoverView extends Vue {
   public computedMappedTabStyleClassNames() {
     return {
       "inline-block": true,
-      "py-3": true,
+      "py-2": true,
       "rounded-t-lg": true,
       "border-b-2": true,
 
@@ -818,7 +949,7 @@ export default class DiscoverView extends Vue {
   public computedRemoteTabStyleClassNames() {
     return {
       "inline-block": true,
-      "py-3": true,
+      "py-2": true,
       "rounded-t-lg": true,
       "border-b-2": true,
 
@@ -836,7 +967,7 @@ export default class DiscoverView extends Vue {
   public computedProjectsTabStyleClassNames() {
     return {
       "inline-block": true,
-      "py-3": true,
+      "py-2": true,
       "rounded-t-lg": true,
       "border-b-2": true,
 
@@ -854,7 +985,7 @@ export default class DiscoverView extends Vue {
   public computedPeopleTabStyleClassNames() {
     return {
       "inline-block": true,
-      "py-3": true,
+      "py-2": true,
       "rounded-t-lg": true,
       "border-b-2": true,
 

src/views/GiftedDetailsView.vue

@@ -1,24 +1,33 @@
 <template>
-  <QuickNav />
-  <TopMessage />
-
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-2xl text-center font-semibold relative px-7 mb-2">
+    <TopMessage />
+
+    <div class="mb-8">
+      <!-- Sub View Heading -->
+      <div id="SubViewHeading" class="flex gap-4 items-start mb-4">
+        <h1 class="grow text-xl text-center font-semibold leading-tight">
+          What Was Given
+        </h1>
+
         <!-- Back -->
-        <div
-          v-if="!hideBackButton"
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
+        <a
+          class="order-first text-lg text-center leading-none p-1"
           @click="cancelBack()"
         >
-          <font-awesome icon="chevron-left" class="fa-fw" />
-        </div>
-        What Was Given
-      </h1>
+          <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+        </a>
 
-      <h2 class="text-lg font-normal text-center overflow-hidden">
+        <!-- Help button -->
+        <router-link
+          :to="{ name: 'help' }"
+          class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+        >
+          <font-awesome icon="question" class="block text-center w-[1em]" />
+        </router-link>
+      </div>
+
+      <h2 class="text-lg font-normal leading-tight text-center overflow-hidden">
         <div class="truncate">
           From
           {{

src/views/HelpNotificationTypesView.vue

@@ -3,22 +3,27 @@
 
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div class="mb-8">
-      <!-- Back -->
-      <div class="text-lg text-center font-light relative px-7">
-        <h1
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="$router.back()"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw"></font-awesome>
-        </h1>
-      </div>
-
-      <!-- Heading -->
-      <h1 id="ViewHeading" class="text-4xl text-center font-light pt-4 mb-8">
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Notification Types
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <!-- eslint-disable prettier/prettier -->

src/views/HelpNotificationsView.vue

@@ -34,22 +34,27 @@
 
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div class="mb-8">
-      <!-- Back -->
-      <div class="text-lg text-center font-light relative px-7">
-        <h1
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="goBack()"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw"></font-awesome>
-        </h1>
-      </div>
-
-      <!-- Heading -->
-      <h1 id="ViewHeading" class="text-4xl text-center font-light pt-4 mb-8">
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Notification Help
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="goBack()"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <!-- eslint-disable prettier/prettier -->
@@ -394,7 +399,7 @@ export default class HelpNotificationsView extends Vue {
   notifyingReminderTime = "";
 
   // Notification helper system
-  notify = createNotifyHelpers(this.$notify);
+  notify!: ReturnType<typeof createNotifyHelpers>;
 
   /**
    * Computed property for consistent button styling
@@ -430,6 +435,9 @@ export default class HelpNotificationsView extends Vue {
    * Handles errors gracefully with proper logging without exposing sensitive data.
    */
   async mounted() {
+    // Initialize notification helpers
+    this.notify = createNotifyHelpers(this.$notify);
+
     try {
       const registration = await navigator.serviceWorker?.ready;
       const fullSub = await registration?.pushManager.getSubscription();

src/views/HelpOnboardingView.vue

@@ -3,11 +3,9 @@
 
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div class="mb-8">
-      <!-- Don't include 'back' button since this is shown in a different window. -->
-      <!-- Heading -->
-      <h1 id="ViewHeading" class="text-4xl text-center font-light pt-4 mb-8">
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Time Safari Onboarding Instructions
       </h1>
     </div>

src/views/HelpView.vue

@@ -3,23 +3,25 @@
 
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div class="mb-8">
-      <!-- Back -->
-      <div class="text-lg text-center font-light relative px-7">
-        <h1
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="$router.back()"
-        >
-          <font-awesome icon="chevron-left" class="fa-fw" />
-        </h1>
-      </div>
-
-      <!-- Heading -->
-      <h1 id="ViewHeading" class="text-4xl text-center font-light pt-4 mb-8">
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Help
-        <span class="text-xs text-gray-500">{{ package.version }}</span>
+        <span class="text-xs font-medium text-slate-500 uppercase">{{
+          package.version
+        }}</span>
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Spacer (no Help button) -->
+      <div class="p-3 pe-3.5 pb-3.5"></div>
     </div>
 
     <!-- eslint-disable prettier/prettier max-len -->

src/views/HomeView.vue

@@ -6,7 +6,6 @@ Raymer * @version 1.0.0 */
 
 <template>
   <QuickNav selected="Home" />
-  <TopMessage />
 
   <!-- CONTENT -->
   <section
@@ -14,10 +13,25 @@ Raymer * @version 1.0.0 */
     class="p-6 pb-24 max-w-3xl mx-auto"
     :data-active-did="activeDid"
   >
-    <h1 id="ViewHeading" class="text-4xl text-center font-light mb-8">
-      {{ AppString.APP_NAME }}
-      <span class="text-xs text-gray-500">{{ package.version }}</span>
-    </h1>
+    <TopMessage />
+
+    <!-- Main View Heading -->
+    <div class="flex gap-4 items-center mb-4">
+      <h1 id="ViewHeading" class="text-2xl font-bold leading-none">
+        {{ AppString.APP_NAME }}
+        <span class="text-xs font-medium text-slate-500 uppercase">{{
+          package.version
+        }}</span>
+      </h1>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
+    </div>
 
     <OnboardingDialog ref="onboardingDialog" />
 
@@ -97,9 +111,9 @@ Raymer * @version 1.0.0 */
           <!-- Record Quick-Action -->
           <div class="mb-6">
             <div class="flex gap-2 items-center mb-2">
-              <h2 class="text-xl font-bold">Record something given by:</h2>
+              <h2 class="font-bold">Record something given by:</h2>
               <button
-                class="block ms-auto text-center text-white bg-gradient-to-b from-slate-400 to-slate-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-2 rounded-full"
+                class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-slate-400 to-slate-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
                 @click="openGiftedPrompts()"
               >
                 <font-awesome
@@ -143,10 +157,10 @@ Raymer * @version 1.0.0 */
     <!-- Results List -->
     <div class="mt-4 mb-4">
       <div class="flex gap-2 items-center mb-3">
-        <h2 class="text-xl font-bold">Latest Activity</h2>
+        <h2 class="font-bold">Latest Activity</h2>
         <button
           v-if="resultsAreFiltered()"
-          class="block ms-auto text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-2 rounded-full"
+          class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
           @click="openFeedFilters()"
         >
           <font-awesome
@@ -156,7 +170,7 @@ Raymer * @version 1.0.0 */
         </button>
         <button
           v-else
-          class="block ms-auto text-center text-white bg-gradient-to-b from-slate-400 to-slate-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-2 rounded-full"
+          class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-slate-400 to-slate-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
           @click="openFeedFilters()"
         >
           <font-awesome
@@ -170,10 +184,10 @@ Raymer * @version 1.0.0 */
         class="border-t p-2 border-slate-300"
         @click="goToActivityToUserPage()"
       >
-        <div class="flex justify-center">
+        <div class="flex justify-center gap-2">
           <div
             v-if="numNewOffersToUser"
-            class="bg-gradient-to-b from-green-400 to-green-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] m-1 px-4 py-4 rounded-md text-white"
+            class="bg-gradient-to-b from-green-400 to-green-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] flex-1 px-4 py-4 rounded-md text-white cursor-pointer"
           >
             <span
               class="block text-center text-6xl"
@@ -187,7 +201,7 @@ Raymer * @version 1.0.0 */
           </div>
           <div
             v-if="numNewOffersToUserProjects"
-            class="bg-gradient-to-b from-green-400 to-green-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] m-1 px-4 py-4 rounded-md text-white"
+            class="bg-gradient-to-b from-green-400 to-green-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] flex-1 px-4 py-4 rounded-md text-white cursor-pointer"
           >
             <span
               class="block text-center text-6xl"
@@ -201,6 +215,22 @@ Raymer * @version 1.0.0 */
               projects
             </p>
           </div>
+          <div
+            v-if="numNewStarredProjectChanges"
+            class="bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] flex-1 px-4 py-4 rounded-md text-white cursor-pointer"
+          >
+            <span
+              class="block text-center text-6xl"
+              data-testId="newStarredProjectChangesActivityNumber"
+            >
+              {{ numNewStarredProjectChanges
+              }}{{ newStarredProjectChangesHitLimit ? "+" : "" }}
+            </span>
+            <p class="text-center">
+              starred project{{ numNewStarredProjectChanges === 1 ? "" : "s" }}
+              with changes
+            </p>
+          </div>
         </div>
         <div class="flex justify-end mt-2">
           <button class="text-blue-500">View All New Activity For You</button>
@@ -215,6 +245,7 @@ Raymer * @version 1.0.0 */
             :last-viewed-claim-id="feedLastViewedClaimId"
             :is-registered="isRegistered"
             :active-did="activeDid"
+            :api-server="apiServer"
             @load-claim="onClickLoadClaim"
             @view-image="openImageViewer"
           />
@@ -268,6 +299,7 @@ import {
   getHeaders,
   getNewOffersToUser,
   getNewOffersToUserProjects,
+  getStarredProjectsWithChanges,
   getPlanFromCache,
 } from "../libs/endorserServer";
 import {
@@ -284,6 +316,7 @@ import { NOTIFY_CONTACT_LOADING_ISSUE } from "@/constants/notifications";
 import * as Package from "../../package.json";
 import { UNNAMED_ENTITY_NAME } from "@/constants/entities";
 import { errorStringForLog } from "../libs/endorserServer";
+import * as databaseUtil from "../db/databaseUtil";
 
 // consolidate this with GiveActionClaim in src/interfaces/claims.ts
 interface Claim {
@@ -396,11 +429,25 @@ export default class HomeView extends Vue {
   isRegistered = false;
   lastAckedOfferToUserJwtId?: string; // the last JWT ID for offer-to-user that they've acknowledged seeing
   lastAckedOfferToUserProjectsJwtId?: string; // the last JWT ID for offers-to-user's-projects that they've acknowledged seeing
+  lastAckedStarredPlanChangesJwtId?: string; // the last JWT ID for starred project changes that they've acknowledged seeing
   newOffersToUserHitLimit: boolean = false;
   newOffersToUserProjectsHitLimit: boolean = false;
+  newStarredProjectChangesHitLimit: boolean = false;
   numNewOffersToUser: number = 0; // number of new offers-to-user
   numNewOffersToUserProjects: number = 0; // number of new offers-to-user's-projects
 
+  numNewStarredProjectChanges: number = 0; // number of new starred project changes
+  starredPlanHandleIds: Array<string> = []; // list of starred project IDs
+  searchBoxes: Array<{
+    name: string;
+    bbox: BoundingBox;
+  }> = [];
+  showShortcutBvc = false;
+  userAgentInfo = new UAParser(); // see https://docs.uaparser.js.org/v2/api/ua-parser-js/get-os.html
+  selectedImage = "";
+  isImageViewerOpen = false;
+  showProjectsDialog = false;
+
   /**
    * CRITICAL VUE REACTIVITY BUG WORKAROUND
    *
@@ -438,16 +485,6 @@ export default class HomeView extends Vue {
   //   return shouldShow;
   // }
 
-  searchBoxes: Array<{
-    name: string;
-    bbox: BoundingBox;
-  }> = [];
-  showShortcutBvc = false;
-  userAgentInfo = new UAParser(); // see https://docs.uaparser.js.org/v2/api/ua-parser-js/get-os.html
-  selectedImage = "";
-  isImageViewerOpen = false;
-  showProjectsDialog = false;
-
   /**
    * Initializes notification helpers
    */
@@ -498,6 +535,7 @@ export default class HomeView extends Vue {
           this.numNewOffersToUser + this.numNewOffersToUserProjects > 0,
       });
 
+      await this.loadNewStarredProjectChanges();
       await this.checkOnboarding();
 
       logger.debug("[HomeView] mounted() - component lifecycle completed", {
@@ -623,8 +661,14 @@ export default class HomeView extends Vue {
       this.lastAckedOfferToUserJwtId = settings.lastAckedOfferToUserJwtId;
       this.lastAckedOfferToUserProjectsJwtId =
         settings.lastAckedOfferToUserProjectsJwtId;
+      this.lastAckedStarredPlanChangesJwtId =
+        settings.lastAckedStarredPlanChangesJwtId;
       this.searchBoxes = settings.searchBoxes || [];
       this.showShortcutBvc = !!settings.showShortcutBvc;
+      this.starredPlanHandleIds = databaseUtil.parseJsonField(
+        settings.starredPlanHandleIds,
+        [],
+      );
       this.isAnyFeedFilterOn = checkIsAnyFeedFilterOn(settings);
 
       // Check onboarding status
@@ -645,7 +689,9 @@ export default class HomeView extends Vue {
 
           if (resp.status === 200) {
             // Ultra-concise settings update with automatic cache invalidation!
-            await this.$saveMySettings({ isRegistered: true });
+            await this.$saveUserSettings(this.activeDid, {
+              isRegistered: true,
+            });
             this.isRegistered = true;
           }
         } catch (error) {
@@ -660,7 +706,7 @@ export default class HomeView extends Vue {
           };
 
           logger.warn(
-            "[HomeView Settings Trace] ⚠️ Registration check failed",
+            "[HomeView Settings Trace] ⚠️ Registration check failed, expected for unregistered users.",
             {
               error: errorMessage,
               did: this.activeDid,
@@ -703,7 +749,7 @@ export default class HomeView extends Vue {
    * Used for displaying contact info in feed and actions
    *
    * @internal
-   * Called by mounted() and initializeIdentity()
+   * Called by initializeIdentity()
    */
   private async loadContacts() {
     this.allContacts = await this.$contacts();
@@ -717,7 +763,6 @@ export default class HomeView extends Vue {
    * Triggers updateAllFeed() to populate activity feed
    *
    * @internal
-   * Called by mounted()
    */
   private async loadFeedData() {
     await this.updateAllFeed();
@@ -731,7 +776,6 @@ export default class HomeView extends Vue {
    * - Rate limit status for both
    *
    * @internal
-   * Called by mounted() and initializeIdentity()
    * @requires Active DID
    */
   private async loadNewOffers() {
@@ -835,6 +879,42 @@ export default class HomeView extends Vue {
     }
   }
 
+  /**
+   * Loads new changes for starred projects
+   * Updates:
+   * - Number of new starred project changes
+   * - Rate limit status for starred project changes
+   *
+   * @internal
+   * @requires Active DID
+   */
+  private async loadNewStarredProjectChanges() {
+    if (this.activeDid && this.starredPlanHandleIds.length > 0) {
+      try {
+        const starredProjectChanges = await getStarredProjectsWithChanges(
+          this.axios,
+          this.apiServer,
+          this.activeDid,
+          this.starredPlanHandleIds,
+          this.lastAckedStarredPlanChangesJwtId,
+        );
+        this.numNewStarredProjectChanges = starredProjectChanges.data.length;
+        this.newStarredProjectChangesHitLimit = starredProjectChanges.hitLimit;
+      } catch (error) {
+        // Don't show errors for starred project changes as it's a secondary feature
+        logger.warn(
+          "[HomeView] Failed to load starred project changes:",
+          error,
+        );
+        this.numNewStarredProjectChanges = 0;
+        this.newStarredProjectChangesHitLimit = false;
+      }
+    } else {
+      this.numNewStarredProjectChanges = 0;
+      this.newStarredProjectChangesHitLimit = false;
+    }
+  }
+
   /**
    * Checks if user needs onboarding using ultra-concise mixin utilities
    * Opens onboarding dialog if not completed
@@ -1185,6 +1265,7 @@ export default class HomeView extends Vue {
       provider,
       fulfillsPlan,
       providedByPlan,
+      record.emojiCount,
     );
   }
 
@@ -1408,12 +1489,14 @@ export default class HomeView extends Vue {
     provider: Provider | undefined,
     fulfillsPlan?: FulfillsPlan,
     providedByPlan?: ProvidedByPlan,
+    emojiCount?: Record<string, number>,
   ): GiveRecordWithContactInfo {
     return {
       ...record,
       jwtId: record.jwtId,
       fullClaim: record.fullClaim,
       description: record.description || "",
+      emojiCount: emojiCount || {},
       handleId: record.handleId,
       issuerDid: record.issuerDid,
       fulfillsPlanHandleId: record.fulfillsPlanHandleId,

src/views/IdentitySwitcherView.vue

@@ -1,18 +1,27 @@
 <template>
   <QuickNav selected="Profile"></QuickNav>
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-lg text-center font-light relative px-7">
-        <!-- Cancel -->
-        <router-link
-          :to="{ name: 'account' }"
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          ><font-awesome icon="chevron-left" class="fa-fw"></font-awesome>
-        </router-link>
-
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Switch Identity
       </h1>
+
+      <!-- Back -->
+      <router-link
+        class="order-first text-lg text-center leading-none p-1"
+        :to="{ name: 'account' }"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </router-link>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
 
     <!-- Identity List -->
@@ -306,6 +315,9 @@ export default class IdentitySwitcherView extends Vue {
       }
 
       await this.$exec("DELETE FROM accounts WHERE id = ?", [id]);
+      await this.$exec("DELETE FROM settings WHERE accountDid = ?", [
+        accountDid,
+      ]);
     });
 
     // Update UI

src/views/ImportAccountView.vue

@@ -1,17 +1,26 @@
 <template>
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-lg text-center font-light relative px-7">
-        <!-- Cancel -->
-        <button
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="$router.go(-1)"
-        >
-          <font-awesome icon="chevron-left"></font-awesome>
-        </button>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Import Existing Identifier
       </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
     </div>
     <!-- Import Account Form -->
     <p class="text-center text-xl mb-4 font-light">

src/views/ImportDerivedAccountView.vue

@@ -1,20 +1,29 @@
 <template>
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Breadcrumb -->
-    <div id="ViewBreadcrumb" class="mb-8">
-      <h1 class="text-lg text-center font-light relative px-7">
-        <!-- Cancel -->
-        <button
-          class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-          @click="$router.go(-1)"
-        >
-          <font-awesome icon="chevron-left"></font-awesome>
-        </button>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
         Derive from Existing Identity
       </h1>
-    </div>
-    <!-- Import Account Form -->
 
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
+    </div>
+
+    <!-- Import Account Form -->
     <div>
       <p class="text-center text-xl mb-4 font-light">
         Will increment the maximum known derivation path from the existing seed.

src/views/InviteOneView.vue

@@ -1,20 +1,31 @@
 <template>
-  <QuickNav selected="Invite" />
-  <TopMessage />
+  <QuickNav selected="Contacts" />
 
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Back -->
-    <div class="text-lg text-center font-light relative px-7">
-      <h1
-        class="text-lg text-center px-2 py-1 absolute -left-2 -top-1"
-        @click="$router.back()"
-      >
-        <font-awesome icon="chevron-left" class="fa-fw"></font-awesome>
-      </h1>
-    </div>
+    <TopMessage />
 
-    <!-- Heading -->
-    <h1 class="text-4xl text-center font-light">Invitations</h1>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">
+        Invitations
+      </h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
+    </div>
 
     <ul class="ml-8 mt-4 list-outside list-disc w-5/6">
       <li>

src/views/LogView.vue

@@ -1,22 +1,31 @@
 <!-- This is useful in an environment where the download doesn't work. -->
 <template>
   <QuickNav selected="" />
-  <TopMessage />
 
   <!-- CONTENT -->
   <section id="Content" class="p-6 pb-24 max-w-3xl mx-auto">
-    <!-- Back Button -->
-    <div class="relative px-7">
-      <h1
-        class="text-lg text-center font-light px-2 py-1 absolute -left-2 -top-1"
-        @click="$router.back()"
-      >
-        <font-awesome icon="chevron-left" class="mr-2" />
-      </h1>
-    </div>
+    <TopMessage />
 
-    <!-- Heading -->
-    <h1 id="ViewHeading" class="text-4xl text-center font-light mb-6">Logs</h1>
+    <!-- Sub View Heading -->
+    <div id="SubViewHeading" class="flex gap-4 items-start mb-8">
+      <h1 class="grow text-xl text-center font-semibold leading-tight">Logs</h1>
+
+      <!-- Back -->
+      <a
+        class="order-first text-lg text-center leading-none p-1"
+        @click="$router.go(-1)"
+      >
+        <font-awesome icon="chevron-left" class="block text-center w-[1em]" />
+      </a>
+
+      <!-- Help button -->
+      <router-link
+        :to="{ name: 'help' }"
+        class="block ms-auto text-sm text-center text-white bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] p-1.5 rounded-full"
+      >
+        <font-awesome icon="question" class="block text-center w-[1em]" />
+      </router-link>
+    </div>
 
     <!-- Error Message -->
     <div