M0: project scaffold (Gradle 9.3.1 / AGP 9.1.0, Compose shell, storage permissions)

.gitignore

@@ -0,0 +1,31 @@
+# Android / Gradle
+*.iml
+.gradle/
+.kotlin/
+/local.properties
+/.idea/
+.DS_Store
+build/
+/captures
+.externalNativeBuild
+.cxx
+
+# Build outputs
+*.apk
+*.aab
+*.ap_
+*.dex
+
+# Signing material — never commit keys!
+*.keystore
+*.jks
+keystore.properties
+!debug.keystore
+
+# Generated data — regenerated on demand, never committed
+fixtures/
+store-assets/raw-screenshots/
+demo-files/
+
+# Note that the *finished* store assets are not ignored: the icon, the feature graphic and
+# `store-assets/screenshots/` are committed beside the code that produces them.

CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to File Manager are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the
+project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+`versionCode` and `versionName` are defined in `app/build.gradle.kts`. Each Play
+upload needs a **higher `versionCode`** than every previous upload.
+
+## [Unreleased]
+
+### Added
+
+- **M0 — project scaffold.** Gradle 9.3.1 / AGP 9.1.0 build with a version catalog,
+  `de.softwareapp_hb.filemanager` app module, a Compose Material 3 shell with the
+  branded blue theme (dynamic colour on Android 12+), an adaptive launcher icon, and
+  the storage-access permission set (all files access + SAF fallback). Debug APK
+  builds, installs and runs on an AOSP Android 12 AVD.

README.md

@@ -0,0 +1,81 @@
+# File Manager
+
+An **ad-free**, **one-time-paid** Android file manager. It browses and manages the
+files on your device — locally, with no ads, no account and no analytics.
+
+Nothing ever leaves the device: the app declares no network permission and contains
+no advertising or tracking SDKs.
+
+> **Working title.** The display name and the store listing are decided before the
+> first Play upload (see [docs/ROADMAP.md](docs/ROADMAP.md), M10). The `applicationId`
+> is already fixed and can never change after the first release.
+
+## Status
+
+**M0 — toolchain & scaffold: done.** The project builds, installs and runs a themed
+Compose shell. See [docs/ROADMAP.md](docs/ROADMAP.md) for the full milestone plan.
+
+## Tech stack
+
+| Area | Choice |
+|---|---|
+| Language | Kotlin 2.4.10 (using AGP 9 *built-in Kotlin*) |
+| UI | Jetpack Compose, BOM 2026.06.01, Material 3 |
+| Build | Gradle 9.3.1, Android Gradle Plugin 9.1.0 |
+| Storage access | `MANAGE_EXTERNAL_STORAGE` ("All files access") with a Storage Access Framework fallback |
+| Archives | Apache Commons Compress (pure Java — no NDK) |
+| SDK levels | `compileSdk`/`targetSdk` 36, `minSdk` 26 |
+
+`targetSdk` is 36 because Google Play requires new apps and updates to target
+Android 16 (API 36) from 31 August 2026.
+
+## Project layout
+
+```
+app/src/main/java/de/softwareapp_hb/filemanager/
+├── core/      Pure-Kotlin engine (no Android imports!) — paths, sorting, formatting,
+│              search matching, copy/move planning, conflict policy
+├── data/      Storage backends (all-files access + SAF), volumes, bookmarks,
+│              file operations, archives, deletion
+├── domain/    Browser + operation controllers, models, permission state
+├── service/   Foreground service for long-running file operations
+├── ui/        Compose theme, browser screen, components, ViewModels
+└── text/      Domain enum → string-resource mapping
+app/src/test/java/…            JVM unit tests for the core engine
+```
+
+`core/` deliberately has **no Android dependencies**, so the trickiest logic is
+covered by fast JVM tests.
+
+## Building
+
+Prerequisites:
+
+- JDK 17+ (JDK 25 verified)
+- Android SDK with `platforms;android-36` and `build-tools;36.0.0`
+
+```bash
+# Tell Gradle where the SDK lives (this file is git-ignored)
+echo "sdk.dir=$HOME/Android/Sdk" > local.properties
+
+./gradlew :app:assembleDebug        # debug APK
+./gradlew :app:testDebugUnitTest    # JVM unit tests for the engine
+./gradlew :app:lintDebug            # Android Lint
+./gradlew :app:bundleRelease        # Play upload bundle (.aab)
+```
+
+Release signing is optional and driven by a git-ignored `keystore.properties`
+(see `keystore.properties.example`); without it the release build still runs
+R8/minification but produces an unsigned artefact.
+
+## Tracked in git
+
+- Source, resources and Gradle build files.
+- `docs/` — roadmap and release documentation.
+- `PRIVACY.md`, `CHANGELOG.md`, and (from M10) `store-assets/`.
+
+Not tracked: `local.properties`, `keystore.properties`, `*.jks`, build outputs.
+
+## Licence
+
+Proprietary — all rights reserved.

app/build.gradle.kts

@@ -0,0 +1,186 @@
+import java.util.Properties
+import org.gradle.api.tasks.testing.Test
+
+plugins {
+    alias(libs.plugins.android.application)
+    alias(libs.plugins.kotlin.compose)
+}
+
+// Optional release signing.
+//
+// Create a `keystore.properties` file in the project ROOT (it is git-ignored; see
+// keystore.properties.example) with:
+//
+//   storeFile=/absolute/path/to/upload-keystore.jks
+//   storePassword=********
+//   keyAlias=upload
+//   keyPassword=********
+//
+// Without that file the release build still runs R8/minification but produces an
+// unsigned APK, which is fine for local checks but cannot be uploaded to Play.
+val keystorePropertiesFile = rootProject.file("keystore.properties")
+val keystoreProperties = Properties().apply {
+    if (keystorePropertiesFile.exists()) {
+        keystorePropertiesFile.inputStream().use { load(it) }
+    }
+}
+val hasReleaseSigning = keystoreProperties.getProperty("storeFile") != null
+
+if (hasReleaseSigning) {
+    // Fail early and readably instead of letting signReleaseBundle blow up later
+    // with an opaque NullPointerException.
+    val missing = listOf("storePassword", "keyAlias")
+        .filter { keystoreProperties.getProperty(it).isNullOrBlank() }
+    check(missing.isEmpty()) {
+        "keystore.properties is incomplete — missing: ${missing.joinToString()}"
+    }
+}
+
+android {
+    namespace = "de.softwareapp_hb.filemanager"
+    compileSdk = 36
+
+    defaultConfig {
+        applicationId = "de.softwareapp_hb.filemanager"
+        minSdk = 26
+        targetSdk = 36
+        versionCode = 1
+        versionName = "1.0.0"
+
+        vectorDrawables {
+            useSupportLibrary = true
+        }
+    }
+
+    signingConfigs {
+        if (hasReleaseSigning) {
+            create("release") {
+                storeFile = file(keystoreProperties.getProperty("storeFile"))
+                storePassword = keystoreProperties.getProperty("storePassword")
+                keyAlias = keystoreProperties.getProperty("keyAlias")
+                // Falls back to the store password. That matches reality: PKCS12
+                // keystores (the default on modern JDKs) cannot have a key password
+                // that differs from the store password, and leaving this null makes
+                // AGP's signReleaseBundle crash with an NPE.
+                keyPassword = keystoreProperties.getProperty("keyPassword")
+                    ?: keystoreProperties.getProperty("storePassword")
+            }
+        }
+    }
+
+    buildTypes {
+        debug {
+            applicationIdSuffix = ".debug"
+            versionNameSuffix = "-debug"
+        }
+        release {
+            if (hasReleaseSigning) {
+                signingConfig = signingConfigs.getByName("release")
+            }
+            isMinifyEnabled = true
+            isShrinkResources = true
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro",
+            )
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+
+    buildFeatures {
+        compose = true
+    }
+
+    testOptions {
+        unitTests {
+            // Robolectric needs the merged resources and manifest to stand up the framework.
+            isIncludeAndroidResources = true
+        }
+    }
+
+    packaging {
+        resources {
+            excludes += "/META-INF/{AL2.0,LGPL2.1}"
+        }
+    }
+
+    lint {
+        // Dependency versions are pinned deliberately — Compose 1.12+/Coil 3.6+ need
+        // compileSdk 37, which AGP 9.1 does not support yet (see the README version
+        // note). These advisories are noise rather than signal here.
+        disable += setOf(
+            "GradleDependency",
+            "AndroidGradlePluginVersion",
+            "NewerVersionAvailable",
+        )
+    }
+}
+
+kotlin {
+    compilerOptions {
+        // With AGP built-in Kotlin this already defaults to
+        // android.compileOptions.targetCompatibility; set explicitly for clarity.
+        jvmTarget = org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17
+    }
+}
+
+// Robolectric reflects into JDK internals (notably java.io.FileDescriptor), which the module
+// system blocks from JDK 17 onwards. Without these it fails with "Failed to interact with raw
+// FileDescriptor internals".
+tasks.withType<Test>().configureEach {
+    jvmArgs(
+        "--add-opens=java.base/java.io=ALL-UNNAMED",
+        "--add-opens=java.base/java.lang=ALL-UNNAMED",
+        "--add-opens=java.base/java.lang.reflect=ALL-UNNAMED",
+        "--add-opens=java.base/java.util=ALL-UNNAMED",
+        "--add-opens=java.base/java.text=ALL-UNNAMED",
+        "--add-opens=java.base/java.nio=ALL-UNNAMED",
+        "--add-opens=java.base/sun.nio.ch=ALL-UNNAMED",
+        // Robolectric reaches FileDescriptor internals through jdk.internal.access.SharedSecrets, and
+        // that needs an *export* rather than an *open*: without it the run dies with
+        // "IllegalAccessException ... module java.base does not export jdk.internal.access".
+        "--add-exports=java.base/jdk.internal.access=ALL-UNNAMED",
+        "--add-exports=java.base/jdk.internal.misc=ALL-UNNAMED",
+        "--add-exports=java.base/jdk.internal.reflect=ALL-UNNAMED",
+    )
+    maxHeapSize = "2g"
+    testLogging { showStandardStreams = true }
+}
+
+dependencies {
+    implementation(libs.androidx.core.ktx)
+    // SAF backend for the "All files access denied" fallback path.
+    implementation(libs.androidx.documentfile)
+
+    implementation(libs.androidx.lifecycle.runtime.ktx)
+    implementation(libs.androidx.lifecycle.runtime.compose)
+    implementation(libs.androidx.lifecycle.viewmodel.compose)
+
+    implementation(libs.androidx.activity.compose)
+
+    implementation(platform(libs.androidx.compose.bom))
+    implementation(libs.androidx.compose.ui)
+    implementation(libs.androidx.compose.ui.graphics)
+    implementation(libs.androidx.compose.ui.tooling.preview)
+    implementation(libs.androidx.compose.material3)
+    implementation(libs.androidx.compose.material.icons.core)
+    implementation(libs.androidx.compose.material.icons.extended)
+
+    implementation(libs.kotlinx.coroutines.android)
+
+    // Image loading for thumbnails and the built-in image viewer.
+    implementation(libs.coil.compose)
+
+    // ZIP/TAR/GZ archive support. Pure Java — no native code, no NDK.
+    implementation(libs.commons.compress)
+
+    debugImplementation(libs.androidx.compose.ui.tooling)
+
+    testImplementation(libs.junit)
+    // Runs the real Android framework on the JVM, so the data layer is testable without a device.
+    testImplementation(libs.robolectric)
+}

app/proguard-rules.pro

@@ -0,0 +1,17 @@
+# ProGuard/R8 rules for the release build.
+#
+# The app relies on reflection only indirectly (Compose, Coil, AndroidX ship their
+# own consumer rules), so we keep this list intentionally short.
+
+# Keep line numbers so crash reports stay readable without the original class names.
+-keepattributes SourceFile,LineNumberTable
+-renamesourcefileattribute SourceFile
+
+# Coroutines: keep the internal classes R8 sometimes struggles to strip correctly.
+-dontwarn kotlinx.coroutines.**
+
+# Commons Compress discovers codecs and archive formats reflectively in a few
+# places; keep the annotated and provider classes so extraction keeps working
+# after shrinking.
+-keep class org.apache.commons.compress.** { *; }
+-dontwarn org.apache.commons.compress.**

app/src/main/AndroidManifest.xml

@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <!--
+      Storage access.
+
+      This app is a file manager, which Google Play lists as a permitted use of the
+      "All files access" special permission. The permission is declared here and must
+      be accompanied by a Permissions Declaration Form in the Play Console before the
+      release goes live (see docs/PLAY_RELEASE_CHECKLIST.md).
+
+      When the user does not grant it, the app falls back to the Storage Access
+      Framework (ACTION_OPEN_DOCUMENT_TREE) — see data/SafSource.
+    -->
+    <uses-permission
+        android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
+        tools:ignore="ScopedStorage" />
+
+    <!--
+      Media access, used for thumbnails and the built-in viewers on Android 13+.
+      On Android 12 and below this collapses to READ_EXTERNAL_STORAGE.
+    -->
+    <uses-permission
+        android:name="android.permission.READ_EXTERNAL_STORAGE"
+        android:maxSdkVersion="32" />
+    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
+    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
+    <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
+    <!-- Android 14+ partial ("Selected photos") access. -->
+    <uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED" />
+
+    <!--
+      Needed only on Android 10 (API 29) and below to write through the legacy
+      storage path. Android 11+ writes go through the all-files-access route or SAF.
+    -->
+    <uses-permission
+        android:name="android.permission.WRITE_EXTERNAL_STORAGE"
+        android:maxSdkVersion="29"
+        tools:ignore="ScopedStorage" />
+
+    <application
+        android:name=".FileManagerApplication"
+        android:allowBackup="true"
+        android:dataExtractionRules="@xml/data_extraction_rules"
+        android:fullBackupContent="@xml/backup_rules"
+        android:icon="@mipmap/ic_launcher"
+        android:enableOnBackInvokedCallback="true"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.FileManager"
+        tools:targetApi="33">
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:theme="@style/Theme.FileManager">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

app/src/main/java/de/softwareapp_hb/filemanager/FileManagerApplication.kt

@@ -0,0 +1,13 @@
+package de.softwareapp_hb.filemanager
+
+import android.app.Application
+
+/**
+ * Application entry point.
+ *
+ * Deliberately lightweight: the app has no dependency-injection graph, no analytics
+ * and no network access. From M2 this will own the browser/operations controller so
+ * that navigation and long-running file operations survive activity recreation; the
+ * storage layer and preference stores are opened lazily where they are used.
+ */
+class FileManagerApplication : Application()

app/src/main/java/de/softwareapp_hb/filemanager/MainActivity.kt

@@ -0,0 +1,29 @@
+package de.softwareapp_hb.filemanager
+
+import android.os.Bundle
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.setContent
+import androidx.activity.enableEdgeToEdge
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.ui.Modifier
+import de.softwareapp_hb.filemanager.ui.browser.BrowserScreen
+import de.softwareapp_hb.filemanager.ui.theme.FileManagerTheme
+
+class MainActivity : ComponentActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        enableEdgeToEdge()
+        super.onCreate(savedInstanceState)
+        setContent {
+            FileManagerTheme {
+                Surface(
+                    modifier = Modifier.fillMaxSize(),
+                    color = MaterialTheme.colorScheme.background,
+                ) {
+                    BrowserScreen()
+                }
+            }
+        }
+    }
+}

app/src/main/java/de/softwareapp_hb/filemanager/ui/browser/BrowserScreen.kt

@@ -0,0 +1,56 @@
+package de.softwareapp_hb.filemanager.ui.browser
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Text
+import androidx.compose.material3.TopAppBar
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.unit.dp
+import de.softwareapp_hb.filemanager.R
+
+/**
+ * The browser screen.
+ *
+ * M0 scaffold: it establishes the Compose shell (edge-to-edge scaffold, themed top
+ * bar, empty state) that the storage layer and file list will be wired into in M2/M4.
+ */
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun BrowserScreen(modifier: Modifier = Modifier) {
+    Scaffold(
+        modifier = modifier.fillMaxSize(),
+        topBar = {
+            TopAppBar(title = { Text(text = stringResource(R.string.app_name)) })
+        },
+    ) { innerPadding ->
+        Column(
+            modifier = Modifier
+                .fillMaxSize()
+                .padding(innerPadding)
+                .padding(horizontal = 32.dp),
+            horizontalAlignment = Alignment.CenterHorizontally,
+            verticalArrangement = Arrangement.Center,
+        ) {
+            Text(
+                text = stringResource(R.string.empty_state_title),
+                style = MaterialTheme.typography.titleLarge,
+            )
+            Spacer(Modifier.height(8.dp))
+            Text(
+                text = stringResource(R.string.empty_state_body),
+                style = MaterialTheme.typography.bodyMedium,
+                color = MaterialTheme.colorScheme.onSurfaceVariant,
+            )
+        }
+    }
+}

app/src/main/java/de/softwareapp_hb/filemanager/ui/theme/Color.kt

@@ -0,0 +1,27 @@
+package de.softwareapp_hb.filemanager.ui.theme
+
+import androidx.compose.ui.graphics.Color
+
+// Brand palette: a calm blue ("files and folders") accent with a teal secondary.
+// Only the roles the app actually uses are overridden; the rest come from the
+// Material 3 baseline, which keeps the scheme consistent.
+
+val BluePrimaryLight = Color(0xFF1565C0)
+val BlueOnPrimaryLight = Color(0xFFFFFFFF)
+val BlueContainerLight = Color(0xFFD6E3FF)
+val BlueOnContainerLight = Color(0xFF001B3D)
+val TealSecondaryLight = Color(0xFF00696E)
+val SurfaceLight = Color(0xFFFFFBFE)
+val SurfaceVariantLight = Color(0xFFE0E2EC)
+val OnSurfaceLight = Color(0xFF1A1C1E)
+val ErrorLight = Color(0xFFBA1A1A)
+
+val BluePrimaryDark = Color(0xFFA8C8FF)
+val BlueOnPrimaryDark = Color(0xFF00315F)
+val BlueContainerDark = Color(0xFF004787)
+val BlueOnContainerDark = Color(0xFFD6E3FF)
+val TealSecondaryDark = Color(0xFF4CDADE)
+val SurfaceDark = Color(0xFF111318)
+val SurfaceVariantDark = Color(0xFF44474E)
+val OnSurfaceDark = Color(0xFFE2E2E6)
+val ErrorDark = Color(0xFFFFB4AB)

app/src/main/java/de/softwareapp_hb/filemanager/ui/theme/Theme.kt

@@ -0,0 +1,64 @@
+package de.softwareapp_hb.filemanager.ui.theme
+
+import android.os.Build
+import androidx.compose.foundation.isSystemInDarkTheme
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.darkColorScheme
+import androidx.compose.material3.dynamicDarkColorScheme
+import androidx.compose.material3.dynamicLightColorScheme
+import androidx.compose.material3.lightColorScheme
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.platform.LocalContext
+
+private val LightColors = lightColorScheme(
+    primary = BluePrimaryLight,
+    onPrimary = BlueOnPrimaryLight,
+    primaryContainer = BlueContainerLight,
+    onPrimaryContainer = BlueOnContainerLight,
+    secondary = TealSecondaryLight,
+    background = SurfaceLight,
+    surface = SurfaceLight,
+    surfaceVariant = SurfaceVariantLight,
+    onSurface = OnSurfaceLight,
+    error = ErrorLight,
+)
+
+private val DarkColors = darkColorScheme(
+    primary = BluePrimaryDark,
+    onPrimary = BlueOnPrimaryDark,
+    primaryContainer = BlueContainerDark,
+    onPrimaryContainer = BlueOnContainerDark,
+    secondary = TealSecondaryDark,
+    background = SurfaceDark,
+    surface = SurfaceDark,
+    surfaceVariant = SurfaceVariantDark,
+    onSurface = OnSurfaceDark,
+    error = ErrorDark,
+)
+
+/**
+ * App theme. Uses Material You dynamic colour on Android 12+ when available and
+ * falls back to the branded blue scheme otherwise.
+ */
+@Composable
+fun FileManagerTheme(
+    darkTheme: Boolean = isSystemInDarkTheme(),
+    dynamicColor: Boolean = true,
+    content: @Composable () -> Unit,
+) {
+    val colorScheme = when {
+        dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
+            val context = LocalContext.current
+            if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context)
+        }
+
+        darkTheme -> DarkColors
+        else -> LightColors
+    }
+
+    MaterialTheme(
+        colorScheme = colorScheme,
+        typography = FileManagerTypography,
+        content = content,
+    )
+}

app/src/main/java/de/softwareapp_hb/filemanager/ui/theme/Type.kt

@@ -0,0 +1,9 @@
+package de.softwareapp_hb.filemanager.ui.theme
+
+import androidx.compose.material3.Typography
+
+/**
+ * The app sticks with the Material 3 default type scale; a dedicated object keeps
+ * a single place to tune typography later.
+ */
+val FileManagerTypography = Typography()

app/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path
+        android:fillColor="@color/ic_launcher_background"
+        android:pathData="M0,0 h108 v108 h-108 z" />
+</vector>

app/src/main/res/drawable/ic_launcher_foreground.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Launcher foreground: a folder, with a second folder offset behind it for depth.
+  Drawn inside the 66dp safe zone of the 108dp adaptive-icon canvas.
+-->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+
+    <!-- Back folder (semi-transparent, offset up and to the right) -->
+    <path
+        android:fillAlpha="0.45"
+        android:fillColor="#FFFFFF"
+        android:pathData="M34,38 h14 l5,5 h27 a4,4 0 0 1 4,4 v20 a4,4 0 0 1 -4,4 h-46 a4,4 0 0 1 -4,-4 v-25 a4,4 0 0 1 4,-4 z" />
+
+    <!-- Front folder -->
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M28,44 h14 l5,5 h27 a4,4 0 0 1 4,4 v20 a4,4 0 0 1 -4,4 h-46 a4,4 0 0 1 -4,-4 v-25 a4,4 0 0 1 4,-4 z" />
+
+    <!-- Document tab peeking out of the front folder -->
+    <path
+        android:fillColor="#1565C0"
+        android:pathData="M44,56 h20 a2,2 0 0 1 2,2 v12 a2,2 0 0 1 -2,2 h-20 a2,2 0 0 1 -2,-2 v-12 a2,2 0 0 1 2,-2 z" />
+</vector>

app/src/main/res/drawable/ic_notification.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Notification small icon. Monochrome on purpose: Android renders notification icons
+  as an alpha mask, so only the alpha channel matters.
+-->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+
+    <path
+        android:fillColor="#FFFFFFFF"
+        android:pathData="M3,6.5 a1.5,1.5 0 0 1 1.5,-1.5 h4 l2,2 h9 a1.5,1.5 0 0 1 1.5,1.5 v9 a1.5,1.5 0 0 1 -1.5,1.5 h-15 a1.5,1.5 0 0 1 -1.5,-1.5 z" />
+</vector>

app/src/main/res/mipmap-anydpi/ic_launcher.xml

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

app/src/main/res/mipmap-anydpi/ic_launcher_round.xml

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

app/src/main/res/values-night/colors.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="window_background">#111318</color>
+    <color name="ic_launcher_background">#1565C0</color>
+</resources>

app/src/main/res/values-night/themes.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="Theme.FileManager" parent="android:Theme.Material.NoActionBar">
+        <item name="android:windowBackground">@color/window_background</item>
+        <item name="android:statusBarColor">@android:color/transparent</item>
+        <item name="android:navigationBarColor">@android:color/transparent</item>
+        <item name="android:windowLightStatusBar">false</item>
+    </style>
+</resources>

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

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="window_background">#FFFBFE</color>
+    <color name="ic_launcher_background">#1565C0</color>
+</resources>

app/src/main/res/values/strings.xml

@@ -0,0 +1,16 @@
+<resources xmlns:tools="http://schemas.android.com/tools">
+    <!--
+      All user-visible text lives here. English is currently the only locale, but keeping the
+      text in resources is what makes a translation possible later at all — Play's automatic
+      translation covers the store listing, not the app UI. Plurals are declared properly so a
+      language with more than two plural forms needs no code change.
+
+      NOTE: `app_name` is a working title. The Play listing needs a distinctive name before
+      the first upload (it is changeable afterwards, unlike the applicationId).
+    -->
+    <string name="app_name">File Manager</string>
+
+    <!-- Browser empty state (M0 placeholder for the real file list). -->
+    <string name="empty_state_title">Your files, without the clutter</string>
+    <string name="empty_state_body">Ad-free, account-free and completely offline. Browsing is wired up next.</string>
+</resources>

app/src/main/res/values/themes.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <!--
+      Compose owns the real theming; this XML theme only prevents a jarring flash
+      before the first frame. It is intentionally a framework theme so the app
+      needs no Material Components (View-system) dependency.
+    -->
+    <style name="Theme.FileManager" parent="android:Theme.Material.Light.NoActionBar">
+        <item name="android:windowBackground">@color/window_background</item>
+        <item name="android:statusBarColor">@android:color/transparent</item>
+        <item name="android:navigationBarColor">@android:color/transparent</item>
+        <item name="android:windowLightStatusBar">true</item>
+    </style>
+</resources>

app/src/main/res/xml/backup_rules.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Bookmarks, recents and settings are device-specific, so nothing this app stores is
+  worth carrying to another device or restoring into a fresh install.
+-->
+<full-backup-content>
+    <exclude domain="sharedpref" path="." />
+    <exclude domain="database" path="." />
+</full-backup-content>

app/src/main/res/xml/data_extraction_rules.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<data-extraction-rules>
+    <cloud-backup>
+        <exclude domain="sharedpref" path="." />
+        <exclude domain="database" path="." />
+    </cloud-backup>
+    <device-transfer>
+        <exclude domain="sharedpref" path="." />
+        <exclude domain="database" path="." />
+    </device-transfer>
+</data-extraction-rules>

build.gradle.kts

@@ -0,0 +1,10 @@
+// Top-level build file. Plugins are declared here (without applying them) so the
+// versions are resolved once for the whole build, and applied per-module.
+//
+// NOTE: since AGP 9.0 Kotlin support is built into AGP ("built-in Kotlin"), so the
+// `org.jetbrains.kotlin.android` plugin must NOT be applied anymore. Only the
+// Compose compiler plugin is still applied explicitly.
+plugins {
+    alias(libs.plugins.android.application) apply false
+    alias(libs.plugins.kotlin.compose) apply false
+}

docs/ROADMAP.md

@@ -0,0 +1,38 @@
+# Roadmap
+
+File Manager is built against a fixed milestone plan (**M0–M10**). This file is the
+single source of truth for what is done and what remains.
+
+Legend: ✅ done · 🚧 in progress · ⏳ not started · 💡 candidate (proposed, not scheduled)
+
+## Milestones
+
+| # | Milestone | Status | Evidence / notes |
+|---|---|---|---|
+| M0 | Toolchain & scaffold | ✅ | Gradle 9.3.1 + AGP 9.1.0 wrapper, version catalog, app module, Compose theme, debug APK builds, installs and runs on the `phone` AVD: package `de.softwareapp_hb.filemanager.debug`, `versionCode 1`, `minSdk 26`/`targetSdk 36`, **no `INTERNET` permission**, `lintDebug` clean (one expected `UnusedResources` for the not-yet-used notification icon) |
+| M1 | Pure-Kotlin core + JVM tests | ⏳ | `StoragePath`/`FileEntry`, sort comparators, name/MIME/category classification, human-readable size/date, search matcher, copy/move planner, conflict policy — `core/` has **no Android imports** |
+| M2 | Storage layer | ⏳ | `StorageSource` interface with `AllFilesSource` (`MANAGE_EXTERNAL_STORAGE`) and `SafSource` (persisted tree URIs); `VolumeRepository` (`StorageManager`/`StorageVolume`, `StatFs`); permission + all-files-access state machine |
+| M3 | Operations engine + service | ⏳ | create/rename/copy/move/delete, recursive copy with progress + cancellation, conflict resolution, trash via MediaStore, foreground service + progress notification |
+| M4 | Compose UI | ⏳ | browser list/grid, breadcrumb + up navigation, sort/filter sheet, multi-select action bar, details sheet, permission prompts, theme |
+| M5 | Analysis, archives, viewers | ⏳ | disk-usage analysis, large-file finder, ZIP/TAR/GZ via Commons Compress, image viewer, text editor |
+| M6 | Release config & Play readiness | ⏳ | R8/minify, optional signing, `.aab`; [PLAY_RELEASE_CHECKLIST](PLAY_RELEASE_CHECKLIST.md) (incl. the **Permissions Declaration Form**), [PRIVACY.md](../PRIVACY.md), README |
+| M7 | On-device validation & hardening | ⏳ | AVD + real-device checks, per-operation error boundaries, edge-case fixtures |
+| M8 | Localisation groundwork | ⏳ | every user-visible string in `res/values/strings.xml` with real `<plurals>`; `text/` mapping |
+| M9 | Monetisation | ⏳ | **one-time paid** — price set only in the Play Console before the first upload; no Billing code and no `BILLING` permission |
+| M10 | Store assets | ⏳ | icon/feature-graphic generators, per-form-factor screenshots, [STORE_LISTING](STORE_LISTING.md); display name confirmed |
+
+## Key decisions
+
+| Decision | Choice | Rationale |
+|---|---|---|
+| Language / UI | Kotlin + Jetpack Compose | Mirrors the sibling app's proven, installed toolchain; no NDK |
+| Storage access | `MANAGE_EXTERNAL_STORAGE` first, SAF fallback | Google Play explicitly permits "All files access" for file managers; SAF keeps the app usable if the user declines |
+| Connectivity | Local-first (no `INTERNET` in v1) | Preserves the "nothing leaves the device" claim and keeps the Data Safety form trivial |
+| Monetisation | One-time paid, price in Console | No Billing code; free → paid is impossible after the first upload, so the price must be set beforehand |
+
+## Deliberately deferred (post-1.0)
+
+- Dual-pane view; cloud storage (Drive/OneDrive/Dropbox/…); network clients
+  (SMB/FTP/SFTP/WebDAV); FTP/Web server.
+- App manager (`QUERY_ALL_PACKAGES`), APK installation (`REQUEST_INSTALL_PACKAGES`).
+- RAR/7z archives; root explorer; encryption vault; themes/icon packs.

gradle.properties

@@ -0,0 +1,20 @@
+# Project-wide Gradle settings.
+
+# JVM memory for the Gradle daemon (large Android builds need headroom).
+org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g -Dfile.encoding=UTF-8
+
+# Build performance.
+org.gradle.parallel=true
+org.gradle.caching=true
+
+# AndroidX is required for Jetpack libraries.
+android.useAndroidX=true
+
+# Only generate R class entries for the module's own resources (faster builds).
+android.nonTransitiveRClass=true
+
+# Let the Android Gradle Plugin auto-download any missing SDK components
+# (platform/build-tools) using the licenses that were accepted during setup.
+android.builder.sdkDownload=true
+
+kotlin.code.style=official

gradle/libs.versions.toml

@@ -0,0 +1,62 @@
+[versions]
+agp = "9.1.0"
+kotlin = "2.4.10"
+
+# AndroidX / Compose
+coreKtx = "1.18.0"
+lifecycle = "2.10.0"
+activityCompose = "1.13.0"
+# SAF backend: DocumentFile over a persisted tree URI.
+documentfile = "1.1.0"
+# Compose BOM 2026.06.01 -> Compose UI/foundation 1.11.4, material3 1.4.0.
+# Newer BOMs (2026.08.00+) ship Compose 1.12.x, which requires compileSdk 37 —
+# that is newer than what AGP 9.1.0 supports (36) and newer than the API level
+# Google Play requires for targetSdk, so we deliberately stay on 1.11.4.
+composeBom = "2026.06.01"
+# Coil 3.6.x requires compileSdk 37; 3.5.0 requires 36.
+coil = "3.5.0"
+
+# Kotlin libraries
+coroutines = "1.9.0"
+
+# Archives. Commons Compress is pure Java (zip/tar/gzip/bzip2/xz, 7z read),
+# so it adds no native code and therefore no NDK dependency to the build.
+commonsCompress = "1.27.1"
+
+# Testing
+junit = "4.13.2"
+robolectric = "4.17"
+
+[libraries]
+androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
+androidx-documentfile = { group = "androidx.documentfile", name = "documentfile", version.ref = "documentfile" }
+
+androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version.ref = "lifecycle" }
+androidx-lifecycle-runtime-compose = { group = "androidx.lifecycle", name = "lifecycle-runtime-compose", version.ref = "lifecycle" }
+androidx-lifecycle-viewmodel-compose = { group = "androidx.lifecycle", name = "lifecycle-viewmodel-compose", version.ref = "lifecycle" }
+
+androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
+
+androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
+androidx-compose-ui = { group = "androidx.compose.ui", name = "ui" }
+androidx-compose-ui-graphics = { group = "androidx.compose.ui", name = "ui-graphics" }
+androidx-compose-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling" }
+androidx-compose-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview" }
+androidx-compose-material3 = { group = "androidx.compose.material3", name = "material3" }
+androidx-compose-material-icons-core = { group = "androidx.compose.material", name = "material-icons-core" }
+androidx-compose-material-icons-extended = { group = "androidx.compose.material", name = "material-icons-extended" }
+
+kotlinx-coroutines-android = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-android", version.ref = "coroutines" }
+
+coil-compose = { group = "io.coil-kt.coil3", name = "coil-compose", version.ref = "coil" }
+
+commons-compress = { group = "org.apache.commons", name = "commons-compress", version.ref = "commonsCompress" }
+
+junit = { group = "junit", name = "junit", version.ref = "junit" }
+robolectric = { group = "org.robolectric", name = "robolectric", version.ref = "robolectric" }
+
+[plugins]
+android-application = { id = "com.android.application", version.ref = "agp" }
+# NOTE: `org.jetbrains.kotlin.android` is intentionally absent — AGP 9.x provides
+# built-in Kotlin support and applying that plugin is now an error.
+kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-all.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

gradlew

@@ -0,0 +1,248 @@
+#!/bin/sh
+
+#
+# Copyright © 2015 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+    echo "$*"
+} >&2
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
+esac
+
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD=$JAVA_HOME/jre/sh/java
+    else
+        JAVACMD=$JAVA_HOME/bin/java
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

gradlew.bat

@@ -0,0 +1,93 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if %ERRORLEVEL% equ 0 goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

keystore.properties.example

@@ -0,0 +1,24 @@
+# Template for release signing. Copy to `keystore.properties` and fill in real values.
+#
+# `keystore.properties` is git-ignored and must NEVER be committed.
+#
+# Generate an upload keystore (keep the file and passwords safe — losing the
+# upload key means you cannot ship updates to Google Play):
+#
+#   keytool -genkeypair -v \
+#     -keystore filemanager-upload.jks \
+#     -alias upload \
+#     -keyalg RSA -keysize 4096 -validity 10000
+#
+# Then enable Play App Signing in the Play Console and register this key as the
+# *upload* key (Google keeps the app signing key).
+
+# Path to your keystore (absolute is safest).
+storeFile=/absolute/path/to/filemanager-upload.jks
+storePassword=change-me
+keyAlias=upload
+
+# Optional — defaults to storePassword when omitted or left blank.
+# PKCS12 keystores (the default on modern JDKs) cannot have a key password that
+# differs from the store password, so this is normally the same value.
+keyPassword=change-me

settings.gradle.kts

@@ -0,0 +1,24 @@
+pluginManagement {
+    repositories {
+        google {
+            content {
+                includeGroupByRegex("com\\.android.*")
+                includeGroupByRegex("com\\.google.*")
+                includeGroupByRegex("androidx.*")
+            }
+        }
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+
+dependencyResolutionManagement {
+    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+rootProject.name = "FileManager"
+include(":app")