v0.19.0

README.md

@@ -19,15 +19,19 @@
 <h4 align="center">Discover and replace proprietary apps with FOSS alternatives.</h4>
 
 <h4 align=center>
-<img alt="GitHub Release" src="https://img.shields.io/github/v/release/jksalcedo/librefind?include_prereleases&logo=github">
-<img alt="GitHub Downloads (all assets, all releases)" src="https://img.shields.io/github/downloads/jksalcedo/librefind/total">
-    <img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/jksalcedo/librefind">
-    <img alt="GitHub License" src="https://img.shields.io/github/license/jksalcedo/librefind?logo=MIT">
-<a href="https://github.com/jksalcedo/librefind/actions/workflows/codeql.yml">
-  <img src="https://github.com/jksalcedo/librefind/actions/workflows/codeql.yml/badge.svg" alt="CodeQL Advanced">
-</a>    <img alt="GitHub Release Date" src="https://img.shields.io/github/release-date/jksalcedo/librefind">
-
+  <a href="https://developer.android.com">
+    <img src="https://img.shields.io/badge/Platform-Android-brighgtreen?logo=android" alt="Android Platform">
+  </a>
+  <img src="https://img.shields.io/badge/API-24%2B-3DDC84?logo=android&color=blue" alt="Minimum SDK">
+  <img alt="GitHub Release" src="https://img.shields.io/github/v/release/jksalcedo/librefind?include_prereleases&logo=github&label=Release&color=blue">
+  <img alt="GitHub Downloads (all assets, all releases)" src="https://img.shields.io/github/downloads/jksalcedo/librefind/total?label=APK%20Downloads&color=brightgreen">
+  <img alt="GitHub License" src="https://img.shields.io/github/license/jksalcedo/librefind?logo=MIT&label=License&color=blue">
+  <a href="https://github.com/jksalcedo/librefind/actions/workflows/codeql.yml">
+    <img src="https://github.com/jksalcedo/librefind/actions/workflows/codeql.yml/badge.svg" alt="CodeQL Advanced">
+  </a>
+  <img src="https://img.shields.io/github/last-commit/jksalcedo/librefind?color=blue" alt="Last Commit">
 </h4>
+
 <p align="center">
 <a href="https://apt.izzysoft.de/packages/com.jksalcedo.librefind">
   <img alt="Get it on IzzyOnDroid" src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" width="160">
@@ -38,11 +42,11 @@
     alt="Get it on F-Droid"
     width="160">
 </a>
- 
+
   <a href="https://github.com/jksalcedo/librefind/releases">
   <img src="https://github.com/SilentCoderHere/aihub/blob/main/fastlane/metadata/android/en-US/images/badge_github.png" width="160" alt="Get it on GitHub">
   </a>
-  
+
   <br>
 
   <a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/jksalcedo/librefind">
@@ -56,7 +60,8 @@
 
 ## What is LibreFind?
 
-LibreFind is a free and lightweight Android app that scans your installed packages locally and queries our database to identify proprietary software and find FOSS alternatives.
+LibreFind is a free and lightweight Android app that scans your installed packages locally and
+queries our database to identify proprietary software and find FOSS alternatives.
 
 ### Core Features
 
@@ -67,10 +72,10 @@ LibreFind is a free and lightweight Android app that scans your installed packag
 
 ## Screenshots
 
-| Dashboard                                                          | Alternative List                                                             | Submission                                                           | Profile                                                        |
-|--------------------------------------------------------------------|------------------------------------------------------------------------------|----------------------------------------------------------------------|----------------------------------------------------------------|
+| Dashboard                                                                           | Alternative List                                                                              | Submission                                                                            | Profile                                                                         |
+|-------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|
 | ![Dashboard](fastlane/metadata/android/en-US/images/phoneScreenshots/dashboard.jpg) | ![Alternatives](fastlane/metadata/android/en-US/images/phoneScreenshots/alternative_list.jpg) | ![Submission](fastlane/metadata/android/en-US/images/phoneScreenshots/submission.jpg) | ![Profile](fastlane/metadata/android/en-US/images/phoneScreenshots/profile.jpg) |
-| Scan your apps and view sovereignty score                          | Browse FOSS alternatives                                                     | Contribute new alternatives                                          | Track your submissions                                         |
+| Scan your apps and view sovereignty score                                           | Browse FOSS alternatives                                                                      | Contribute new alternatives                                                           | Track your submissions                                                          |
 
 ### Community Contributions
 
@@ -94,11 +99,15 @@ Please join the Telegram channel for further discussions.
 
 ## ☕ Support
 
-LibreFind is a free and open-source project managed independently. Our goal is to promote digital privacy by making FOSS apps mainstream. Currently, LibreFind is trusted by **1,334 registered users** globally. 
+LibreFind is a free and open-source project managed independently. Our goal is to promote digital
+privacy by making FOSS apps mainstream. Currently, LibreFind is trusted by **1,334 registered users 
+** globally.
+
+While the app is free, **infrastructure and hosting servers** cost money to keep running 24/7.
 
-While the app is free, **infrastructure and hosting servers** cost money to keep running 24/7. 
+If you find this tool useful for reclaiming your digital privacy, please consider buying me a
+coffee. Your support goes directly toward:
 
-If you find this tool useful for reclaiming your digital privacy, please consider buying me a coffee. Your support goes directly toward:
 * Paying monthly server bills.
 * Keeping the database online and fast.
 * Development of new features.
@@ -109,14 +118,29 @@ If you find this tool useful for reclaiming your digital privacy, please conside
   </a>
 </div>
 
-<!-- SUGGESTION: List some ways to support the project without paying -->
+## Contributing
+
+Can't donate? You can still make a real difference:
+
+- **Star the repo** — helps others discover LibreFind on GitHub
+- **Report bugs** — open an issue if something isn't working
+- **Suggest features** — share ideas through GitHub issues
+- **Test & give feedback** — usability and performance reports are valuable
+- **Translate** — help bring LibreFind to more languages
+  via [Weblate](https://hosted.weblate.org/engage/librefind/)
+- **Spread the word** — share with friends or on social media
+- **Contribute code** — fix bugs or add features via pull requests
+
+Every small contribution helps the project grow.
 
 ## Translations
+
 <a href="https://hosted.weblate.org/engage/librefind/">
 <img src="https://hosted.weblate.org/widget/librefind/android-strings/multi-auto.svg" alt="Translation status" />
 </a>
 
-LibreFind uses [Weblate](https://hosted.weblate.org/engage/librefind/) to manage translations. You can help translate LibreFind into your language!
+LibreFind uses [Weblate](https://hosted.weblate.org/engage/librefind/) to manage translations. You
+can help translate LibreFind into your language!
 
 ## Star History
 

app/build.gradle.kts

@@ -1,4 +1,8 @@
+import com.android.build.api.artifact.SingleArtifact
+import com.android.build.api.dsl.ApplicationExtension
 import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+import java.io.FileInputStream
+import java.util.Properties
 
 plugins {
     alias(libs.plugins.android.application)
@@ -8,36 +12,56 @@ plugins {
     alias(libs.plugins.kotlin.serialization)
 }
 
-val versionMajor = 1
-val versionMinor = 0
-val versionPatch = 0
-val versionStage = "beta" // Change to "alpha", "beta", "rc", or "stable"
-val versionBuild = 18
+// Load the version.properties file
+val versionPropsFile: File = rootProject.file("version.properties")
+val versionProps = Properties()
+if (versionPropsFile.exists()) {
+    versionProps.load(FileInputStream(versionPropsFile))
+} else {
+    throw GradleException("version.properties file not found! Please create it in the project root.")
+}
+
+// Safely parse the values
+val vMajor = versionProps.getProperty("VERSION_MAJOR", "0").toInt()
+val vMinor = versionProps.getProperty("VERSION_MINOR", "1").toInt()
+val vPatch = versionProps.getProperty("VERSION_PATCH", "0").toInt()
+val vStage = versionProps.getProperty("VERSION_STAGE", "beta").lowercase()
+val vBuild = versionProps.getProperty("VERSION_BUILD", "1").toInt()
 
-val stageWeight = when (versionStage.lowercase()) {
+val stageWeight = when (vStage) {
     "alpha" -> 0
     "beta" -> 1
     "rc" -> 2
     "stable" -> 3
     else -> 0
 }
 
-val computedVersionCode = (versionMajor * 100000) +
-        (versionMinor * 1000) +
-        (versionPatch * 100) +
-        (stageWeight * 10) +
-        versionBuild
+val suffix = if (vStage == "stable") "" else "-$vStage$vBuild"
 
-// Construct the versionName dynamically
-// If stable, just output "1.0.0"
-// Otherwise, output "1.0.0-beta16" or "1.0.0-rc1"
-val mVersionName =
-    "$versionMajor.$versionMinor.$versionPatch-$versionStage${
-        if (versionStage.lowercase() == "stable") null else versionBuild
-    }"
+val computedVersionCode = versionProps.getProperty("VERSION_CODE")?.toInt() ?: ((vMajor * 10000000) +
+        (vMinor * 100000) +
+        (vPatch * 1000) +
+        (stageWeight * 100) +
+        vBuild)
 
+val computedVersionName = versionProps.getProperty("VERSION_NAME") ?: "$vMajor.$vMinor.$vPatch$suffix"
 
-configure<com.android.build.api.dsl.ApplicationExtension> {
+tasks.register("updateVersionProperties") {
+    doLast {
+        val calculatedCode = (vMajor * 10000000) +
+                (vMinor * 100000) +
+                (vPatch * 1000) +
+                (stageWeight * 100) +
+                vBuild
+        val calculatedName = "$vMajor.$vMinor.$vPatch$suffix"
+
+        versionProps.setProperty("VERSION_CODE", calculatedCode.toString())
+        versionProps.setProperty("VERSION_NAME", calculatedName)
+        versionProps.store(versionPropsFile.outputStream(), null)
+    }
+}
+
+configure<ApplicationExtension> {
     namespace = "com.jksalcedo.librefind"
     compileSdk = 36
 
@@ -46,7 +70,7 @@ configure<com.android.build.api.dsl.ApplicationExtension> {
         minSdk = 24
         targetSdk = 36
         versionCode = computedVersionCode
-        versionName = mVersionName
+        versionName = computedVersionName
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
     }
@@ -104,11 +128,11 @@ kotlin {
 androidComponents {
     onVariants { variant ->
         val appName = "librefind"
-        val versionName = mVersionName
+        val versionName = computedVersionName
         val capitalizedName = variant.name.replaceFirstChar { it.titlecase() }
 
         tasks.register<Copy>("rename${capitalizedName}Apk") {
-            from(variant.artifacts.get(com.android.build.api.artifact.SingleArtifact.APK))
+            from(variant.artifacts.get(SingleArtifact.APK))
             into(layout.buildDirectory.dir("outputs/apk/${variant.name}"))
             rename(".*\\.apk", "$appName-v$versionName-${variant.name}.apk")
         }
@@ -176,4 +200,4 @@ dependencies {
     androidTestImplementation(libs.androidx.compose.ui.test.junit4)
     debugImplementation(libs.androidx.compose.ui.tooling)
     debugImplementation(libs.androidx.compose.ui.test.manifest)
-}
+}

app/src/main/java/com/jksalcedo/librefind/MainActivity.kt

@@ -5,6 +5,7 @@ import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
 import androidx.activity.enableEdgeToEdge
 import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.WindowInsets
 import androidx.compose.foundation.layout.padding
 import androidx.compose.material3.Icon
 import androidx.compose.material3.NavigationBar
@@ -46,6 +47,7 @@ class MainActivity : AppCompatActivity() {
                     currentRoute == Route.Dashboard.route || currentRoute == Route.Discover.route
 
                 Scaffold(
+                    contentWindowInsets = WindowInsets(0),
                     bottomBar = {
                         if (showBottomBar) {
                             NavigationBar {

app/src/main/java/com/jksalcedo/librefind/data/local/InventorySource.kt

@@ -13,7 +13,8 @@ import android.os.Build
  * Wraps Android PackageManager API to extract installed packages.
  */
 class InventorySource(
-    private val context: Context
+    private val context: Context,
+    private val preferencesManager: PreferencesManager
 ) {
     /**
      * Gets all user-installed apps
@@ -34,16 +35,18 @@ class InventorySource(
                 .map { it.activityInfo.packageName }
                 .toSet()
 
+            val hideSystemPackages = preferencesManager.shouldHideSystemPackages()
+
             pm.getInstalledPackages(PackageManager.GET_META_DATA)
                 .filter { app ->
                     val isSystem = (app.applicationInfo?.flags?.and(ApplicationInfo.FLAG_SYSTEM) != 0)
                     val isUpdatedSystem = (app.applicationInfo?.flags?.and(ApplicationInfo.FLAG_UPDATED_SYSTEM_APP) != 0)
-                    
-                    // Filter logic: 
-                    // 1. User apps (!isSystem)
-                    // 2. Updated System Apps (isUpdatedSystem)
-                    // 3. System apps that are launchable (launchablePackages.contains)
-                    !isSystem || isUpdatedSystem || launchablePackages.contains(app.packageName)
+
+                    if (hideSystemPackages) {
+                        !isSystem || isUpdatedSystem
+                    } else {
+                        !isSystem || isUpdatedSystem || launchablePackages.contains(app.packageName)
+                    }
                 }
         } catch (_: Exception) {
             emptyList()

app/src/main/java/com/jksalcedo/librefind/data/local/PreferencesManager.kt

@@ -2,10 +2,13 @@ package com.jksalcedo.librefind.data.local
 
 import android.content.Context
 import android.content.SharedPreferences
+import kotlinx.coroutines.channels.awaitClose
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.callbackFlow
 import java.util.UUID
 
 class PreferencesManager(private val context: Context) {
-    private val prefs: SharedPreferences = 
+    private val prefs: SharedPreferences =
         context.getSharedPreferences("librefind_prefs", Context.MODE_PRIVATE)
 
     fun hasSeenOnboarding(): Boolean {
@@ -43,7 +46,7 @@ class PreferencesManager(private val context: Context) {
     fun getOrCreateDeviceId(): String {
         val existing = prefs.getString(KEY_DEVICE_ID, null)
         if (existing != null) return existing
-        
+
         val newId = UUID.randomUUID().toString()
         prefs.edit().putString(KEY_DEVICE_ID, newId).apply()
         return newId
@@ -57,10 +60,43 @@ class PreferencesManager(private val context: Context) {
         }
     }
 
+    // --- System package filtering preferences ---
+    /**
+     * Returns whether system/vendor packages should be hidden from the UI.
+     *
+     * Default: true (on)
+     */
+    fun shouldHideSystemPackages(): Boolean {
+        return prefs.getBoolean(KEY_HIDE_SYSTEM_PACKAGES, true)
+    }
+
+    /**
+     * Persist user preference for hiding system/vendor packages.
+     */
+    fun setHideSystemPackages(enabled: Boolean) {
+        prefs.edit().putBoolean(KEY_HIDE_SYSTEM_PACKAGES, enabled).apply()
+    }
+
+    fun observeHideSystemPackages(): Flow<Boolean> = callbackFlow {
+        val listener = SharedPreferences.OnSharedPreferenceChangeListener { _, key ->
+            if (key == KEY_HIDE_SYSTEM_PACKAGES) {
+                trySend(shouldHideSystemPackages())
+            }
+        }
+        prefs.registerOnSharedPreferenceChangeListener(listener)
+        trySend(shouldHideSystemPackages())
+        awaitClose { prefs.unregisterOnSharedPreferenceChangeListener(listener) }
+    }
+
+
+
     companion object {
         private const val KEY_ONBOARDING_COMPLETE = "onboarding_complete"
         private const val KEY_LAST_VERSION = "last_seen_version"
         private const val KEY_TUTORIAL_COMPLETE = "tutorial_complete"
         private const val KEY_DEVICE_ID = "device_id"
+
+        // New keys for system package filtering
+        private const val KEY_HIDE_SYSTEM_PACKAGES = "hide_system_packages"
     }
 }

app/src/main/java/com/jksalcedo/librefind/data/remote/model/SupabaseModels.kt

@@ -8,7 +8,7 @@ data class SolutionDto(
     @SerialName("package_name") val packageName: String,
     val name: String,
     val description: String,
-    val category: String? = null,
+    val category: String = "Other",
     @SerialName("icon_url") val iconUrl: String? = null,
     @SerialName("fdroid_id") val fdroidId: String? = null,
     @SerialName("repo_url") val repoUrl: String? = null,
@@ -103,4 +103,36 @@ data class AppReport(
     @SerialName("issue_type") val issueType: String,
     @SerialName("description") val description: String,
     @SerialName("status") val status: String = "pending"
+)
+
+@Serializable
+data class MatchVoteDto(
+    @SerialName("user_id") val userId: String,
+    @SerialName("target_package") val targetPackage: String,
+    @SerialName("solution_package") val solutionPackage: String,
+    val vote: Int  // +1 or -1
+)
+
+/** Returned by the get_alternatives_with_match_votes RPC */
+@Serializable
+data class AlternativeWithVoteDto(
+    @SerialName("package_name") val packageName: String,
+    val name: String,
+    val license: String,
+    @SerialName("repo_url") val repoUrl: String? = null,
+    @SerialName("fdroid_id") val fdroidId: String? = null,
+    @SerialName("icon_url") val iconUrl: String? = null,
+    val description: String = "",
+    val category: String = "Other",
+    val features: List<String>? = emptyList(),
+    val pros: List<String>? = emptyList(),
+    val cons: List<String>? = emptyList(),
+    @SerialName("rating_privacy") val ratingPrivacy: Float? = 0f,
+    @SerialName("rating_usability") val ratingUsability: Float? = 0f,
+    @SerialName("rating_features") val ratingFeatures: Float? = 0f,
+    @SerialName("vote_count") val voteCount: Int? = 0,
+    @SerialName("match_upvotes") val matchUpvotes: Int = 0,
+    @SerialName("match_downvotes") val matchDownvotes: Int = 0,
+    @SerialName("match_score") val matchScore: Int = 0,
+    @SerialName("user_match_vote") val userMatchVote: Int? = null
 )