External storage support, auto-show changelog, ANR fix

- Auto-open update sheet during first launch after an update
- Introduced last seen app version tracking in UserPreferencesRepository.
- Enhanced FilesystemFolderPickerSheet to display device storage options.
- Improved blur handling in various screens to enhance visual clarity.
- Updated Gradle dependencies for better performance and compatibility.
- Adding issue templates

Author: bikram-agarwal

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,76 @@
+name: Bug Report
+description: File a report for any bug you find in the app.
+title: "[BUG] "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: "Describe the bug"
+      description: "A clear and concise description of what the bug is."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: "Steps to reproduce"
+      description: "Steps to reproduce the behavior"
+      placeholder: |
+        1. Open the app
+        2. Navigate to...
+        3. Click on...
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: "Expected behavior"
+      description: "A clear and concise description of what you expected to happen."
+      placeholder: "What should have happened instead?"
+    validations:
+      required: true
+
+  - type: textarea
+    id: device_info
+    attributes:
+      label: "Device information"
+      description: |
+        Please fill out the details below.
+        *Tip: Check display/font size at Android Settings -> Display -> Display size & text.*
+      value: |
+        - Device: 
+        - OS: 
+        - Display size & font size: 
+        - FilePipe version: 
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: "FilePipe logs"
+      description: |
+        Get the log file: Go to FilePipe settings, scroll to the bottom, tap the 🐞 bug icon at the top-right of the About section, and save that file.
+        Then attach that log file here by dragging and dropping it into this text box.
+        *Note: Bug reports without logs will be closed without further notice.*
+      placeholder: "Drag & drop or paste your log file here"
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: "Checklist"
+      description: "Please confirm the following before submitting"
+      options:
+        - label: "I have searched for existing issues with this problem"
+          required: true
+        - label: "I am using the latest version of the app"
+          required: true
+        - label: "I have attached the FilePipe log file (retrieved from settings -> 🐞 bug icon)"
+          required: true
+        - label: "I have provided enough information to reproduce the issue"
+          required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,34 @@
+name: "Feature request"
+description: "Suggest a new feature for the app."
+labels: ["enhancement", "to check"]
+body:
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      options:
+        - label: I confirm this request is not part of an existing issue.
+          required: true
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: Describe the feature
+      description: |
+        A clear and concise description of what you want to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered (if applicable)
+      description: |
+        A clear and concise description of any alternative solutions or features you've considered.
+    validations:
+      required: true
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.
+    validations:
+      required: false

app/build.gradle.kts

@@ -56,8 +56,8 @@ extensions.configure<ApplicationExtension>("android") {
         applicationId = filePipeApplicationId
         minSdk = 31
         targetSdk = 37
-        versionCode = 387
-        versionName = "3.8.7"
+        versionCode = 388
+        versionName = "3.8.8"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
 

app/src/main/java/dev/bikram/filepipe/MainActivity.kt

@@ -55,10 +55,15 @@ class MainActivity : ComponentActivity() {
             statusBarStyle = SystemBarStyle.auto(AndroidColor.TRANSPARENT, AndroidColor.TRANSPARENT),
             navigationBarStyle = SystemBarStyle.auto(AndroidColor.TRANSPARENT, AndroidColor.TRANSPARENT),
         )
+        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
+            window.isNavigationBarContrastEnforced = false
+            window.isStatusBarContrastEnforced = false
+        }
         handleShortcutIntent(intent)
         handleOpenHistoryIntent(intent)
         handleOpenHistoryDetailIntent(intent)
         handleOpenSettingsUpdatesIntent(intent)
+        openSettingsUpdatesIfAppWasUpdated()
 
         setContent {
             val preferencesState by userPreferencesRepository.preferencesFlow
@@ -165,4 +170,17 @@ class MainActivity : ComponentActivity() {
             sourceIntent.removeExtra(PendingShortcutRepository.EXTRA_OPEN_SETTINGS_UPDATES)
         }
     }
+
+    /** First launch after an update (fresh installs are not announced): auto-opens the update sheet with the changelog. */
+    private fun openSettingsUpdatesIfAppWasUpdated() {
+        lifecycleScope.launch {
+            val lastSeenVersion = userPreferencesRepository.getLastSeenAppVersion()
+            val currentVersion = BuildConfig.VERSION_NAME
+            val wasUpdated = !lastSeenVersion.isNullOrBlank() && lastSeenVersion != currentVersion
+            if (wasUpdated && BuildConfig.SHOW_UPDATES) {
+                pendingShortcutRepository.requestOpenSettingsForUpdates()
+            }
+            userPreferencesRepository.setLastSeenAppVersion(currentVersion)
+        }
+    }
 }

app/src/main/java/dev/bikram/filepipe/data/preferences/UserPreferencesRepository.kt

@@ -77,6 +77,7 @@ private object PrefKeys {
     val UPDATE_LAST_NOTIFIED_DEDUPE_KEY = stringPreferencesKey("update_last_notified_dedupe_key")
     val GITHUB_ACK_FINGERPRINT = stringPreferencesKey("github_last_acknowledged_release_fingerprint")
     val GITHUB_ACK_INSTALLED_VERSION = stringPreferencesKey("github_acknowledged_for_installed_version")
+    val LAST_SEEN_APP_VERSION = stringPreferencesKey("last_seen_app_version")
     val SAVE_UPDATE_APK_TO_DOWNLOADS = booleanPreferencesKey("save_update_apk_to_downloads")
     val UPDATE_APK_DOWNLOADS_COPY_SUCCEEDED = booleanPreferencesKey("update_apk_downloads_copy_succeeded")
     val USE_GRADIENT_BACKGROUND = booleanPreferencesKey("use_gradient_background")
@@ -419,6 +420,13 @@ class UserPreferencesRepository
             }
         }
 
+        /** Null means this install has never recorded a version, i.e. it's a fresh install. */
+        suspend fun getLastSeenAppVersion(): String? = dataStore.data.first()[PrefKeys.LAST_SEEN_APP_VERSION]
+
+        suspend fun setLastSeenAppVersion(version: String) {
+            dataStore.edit { it[PrefKeys.LAST_SEEN_APP_VERSION] = version }
+        }
+
         /**
          * One-time: `auto_check_for_updates` boolean -> [PrefKeys.UPDATE_CHECK_SCHEDULE]; removes legacy key.
          */

app/src/main/java/dev/bikram/filepipe/ui/components/FilesystemFolderPickerSheet.kt

@@ -39,6 +39,7 @@ import androidx.compose.runtime.setValue
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.platform.LocalContext
 import androidx.compose.ui.platform.LocalDensity
 import androidx.compose.ui.res.stringResource
 import androidx.compose.ui.text.style.TextOverflow
@@ -76,6 +77,12 @@ private data class FolderPickerDirectoryEntry(
     val listKey: String,
 )
 
+private data class StorageVolumeRoot(
+    val label: String,
+    val path: String,
+    val isPrimary: Boolean,
+)
+
 private fun folderPickerDirectoryEntry(file: File): FolderPickerDirectoryEntry? {
     if (!file.isDirectory || !file.canRead() || file.name.startsWith(".")) return null
     val resolvedPath =
@@ -95,14 +102,19 @@ private fun buildBreadcrumbSegments(
     primaryRoot: String,
     internalStorageLabel: String,
     sdCardLabel: String,
+    devicesLabel: String,
 ): List<BreadcrumbSegment> {
     val normalized = normalizeFilesystemFolderPath(canonicalPath) ?: return emptyList()
+    if (normalized == "/storage") {
+        return listOf(BreadcrumbSegment(devicesLabel, "/storage"))
+    }
     val primary = primaryRoot.trimEnd('/')
 
     if (normalized == primary || normalized.startsWith(primary + File.separator)) {
         val tail = if (normalized == primary) "" else normalized.removePrefix(primary + File.separator)
         val parts = if (tail.isEmpty()) emptyList() else tail.split('/').filter { it.isNotEmpty() }
         val out = ArrayList<BreadcrumbSegment>()
+        out.add(BreadcrumbSegment(devicesLabel, "/storage"))
         out.add(BreadcrumbSegment(internalStorageLabel, primary))
         var accumulated = primary
         for (part in parts) {
@@ -119,6 +131,7 @@ private fun buildBreadcrumbSegments(
         val rest = sdMatch.groupValues[2].orEmpty().trim('/')
         val parts = if (rest.isEmpty()) emptyList() else rest.split('/').filter { it.isNotEmpty() }
         val out = ArrayList<BreadcrumbSegment>()
+        out.add(BreadcrumbSegment(devicesLabel, "/storage"))
         out.add(BreadcrumbSegment(sdCardLabel, sdRoot))
         var accumulated = sdRoot
         for (part in parts) {
@@ -129,7 +142,10 @@ private fun buildBreadcrumbSegments(
     }
 
     val fallbackLabel = normalized.substringAfterLast(File.separator).ifEmpty { normalized }
-    return listOf(BreadcrumbSegment(fallbackLabel, normalized))
+    return listOf(
+        BreadcrumbSegment(devicesLabel, "/storage"),
+        BreadcrumbSegment(fallbackLabel, normalized),
+    )
 }
 
 /**
@@ -143,14 +159,58 @@ fun FilesystemFolderPickerSheetContent(
     onDismiss: () -> Unit,
     onFolderChosen: (normalizedAbsolutePath: String) -> Unit,
 ) {
+    // Keep these literals so that the font subset harvester detects them:
+    @Suppress("UNUSED_EXPRESSION")
+    if (false) {
+        FilePipeMaterialRoundedSymbol(name = "folder")
+        FilePipeMaterialRoundedSymbol(name = "mobile")
+        FilePipeMaterialRoundedSymbol(name = "sd_card")
+    }
+
     val internalStorageLabel = stringResource(R.string.filesystem_folder_picker_internal_storage)
     val sdCardLabel = stringResource(R.string.filesystem_folder_picker_sd_card)
+    val devicesLabel = stringResource(R.string.filesystem_folder_picker_devices)
     val primaryRoot =
         remember {
             runCatching { Environment.getExternalStorageDirectory().canonicalPath }.getOrNull()
                 ?: "/storage/emulated/0"
         }
 
+    val context = LocalContext.current
+    val storageVolumes =
+        remember(context, internalStorageLabel, sdCardLabel) {
+            val list = mutableListOf<StorageVolumeRoot>()
+            val primaryPath =
+                runCatching { Environment.getExternalStorageDirectory().canonicalPath }.getOrNull()
+                    ?: "/storage/emulated/0"
+            list.add(StorageVolumeRoot(internalStorageLabel, primaryPath, isPrimary = true))
+
+            val externalDirs = context.getExternalFilesDirs(null)
+            for (dir in externalDirs) {
+                if (dir == null) continue
+                val path = dir.absolutePath
+                if (path.contains("/Android/data/")) {
+                    val rootPath = path.substringBefore("/Android/data/")
+                    if (rootPath != primaryPath && File(rootPath).exists()) {
+                        val sdName = rootPath.substringAfterLast('/')
+                        list.add(
+                            StorageVolumeRoot(
+                                label =
+                                    if (sdName.matches(Regex("^[0-9A-F]{4}-[0-9A-F]{4}$", RegexOption.IGNORE_CASE))) {
+                                        "$sdCardLabel ($sdName)"
+                                    } else {
+                                        sdCardLabel
+                                    },
+                                path = rootPath,
+                                isPrimary = false,
+                            ),
+                        )
+                    }
+                }
+            }
+            list.distinctBy { it.path }
+        }
+
     val startPath =
         remember(initialDirectory) {
             normalizeFilesystemFolderPath(initialDirectory)
@@ -168,8 +228,8 @@ fun FilesystemFolderPickerSheetContent(
     var newFolderDialogErrorResId by remember { mutableStateOf<Int?>(null) }
 
     val breadcrumbSegments =
-        remember(currentPath, primaryRoot, internalStorageLabel, sdCardLabel) {
-            buildBreadcrumbSegments(currentPath, primaryRoot, internalStorageLabel, sdCardLabel)
+        remember(currentPath, primaryRoot, internalStorageLabel, sdCardLabel, devicesLabel) {
+            buildBreadcrumbSegments(currentPath, primaryRoot, internalStorageLabel, sdCardLabel, devicesLabel)
         }
 
     var childDirectories by remember(currentPath, childListRefreshKey) {
@@ -178,12 +238,22 @@ fun FilesystemFolderPickerSheetContent(
     LaunchedEffect(currentPath, childListRefreshKey) {
         childDirectories =
             withContext(Dispatchers.IO) {
-                File(currentPath)
-                    .listFiles()
-                    ?.mapNotNull(::folderPickerDirectoryEntry)
-                    ?.distinctBy { entry -> entry.listKey }
-                    ?.sortedBy { entry -> entry.name.lowercase() }
-                    ?: emptyList()
+                if (currentPath == "/storage") {
+                    storageVolumes.map { volume ->
+                        FolderPickerDirectoryEntry(
+                            name = volume.label,
+                            path = volume.path,
+                            listKey = volume.path,
+                        )
+                    }
+                } else {
+                    File(currentPath)
+                        .listFiles()
+                        ?.mapNotNull(::folderPickerDirectoryEntry)
+                        ?.distinctBy { entry -> entry.listKey }
+                        ?.sortedBy { entry -> entry.name.lowercase() }
+                        ?: emptyList()
+                }
             }
     }
 
@@ -332,9 +402,11 @@ fun FilesystemFolderPickerSheetContent(
                     modifier =
                         Modifier.tapSoundClickable {
                             val target = normalizeFilesystemFolderPath(segment.path) ?: return@tapSoundClickable
-                            if (File(target).isDirectory &&
-                                File(target).canRead() &&
-                                isFilesystemFolderPathAllowedForRules(target)
+                            if (target == "/storage" || (
+                                    File(target).isDirectory &&
+                                        File(target).canRead() &&
+                                        isFilesystemFolderPathAllowedForRules(target)
+                                )
                             ) {
                                 currentPath = target
                             }
@@ -366,8 +438,17 @@ fun FilesystemFolderPickerSheetContent(
                         ListItem(
                             colors = ListItemDefaults.colors(containerColor = Color.Transparent),
                             leadingContent = {
+                                val isDrive =
+                                    entry.path == "/storage/emulated/0" ||
+                                        Regex("^/storage/[0-9A-F]{4}-[0-9A-F]{4}$", RegexOption.IGNORE_CASE).matches(entry.path)
+                                val iconName =
+                                    if (isDrive) {
+                                        if (entry.path == "/storage/emulated/0") "mobile" else "sd_card"
+                                    } else {
+                                        "folder"
+                                    }
                                 FilePipeMaterialRoundedSymbol(
-                                    name = "folder",
+                                    name = iconName,
                                     contentDescription = null,
                                     size = 24.dp,
                                     modifier = Modifier.size(24.dp),

app/src/main/java/dev/bikram/filepipe/ui/navigation/AdaptiveRoutes.kt

@@ -322,6 +322,7 @@ fun SettingsTwoPaneRoute(
                             onNavigateBack = { showSettingsSection(SettingsSectionKey.About) },
                             updateVm = updateVm,
                             showNavigateBack = showDetailNavigateBack,
+                            suppressBlur = true,
                         )
                     } else {
                         SettingsScreen(
@@ -338,6 +339,7 @@ fun SettingsTwoPaneRoute(
                             selectedSectionKey = selectedSectionKey,
                             showTopBar = false,
                             showSectionHeaders = false,
+                            suppressBlur = true,
                         )
                     }
                 }