feat: implement "Hide Seen Repositories" and Flatpak packaging

rainxchzed · rainxchzed · commit 3d4bfb0078ff · 2026-03-21T00:01:51.000+05:00
- **New Feature: Seen Repositories**
    - Implement a tracking system to mark GitHub repositories as "seen" once viewed in the details screen.
    - Add a toggle in Profile settings to hide previously seen repositories from discovery and search feeds.
    - Provide a "Clear Seen History" option in settings to reset the seen status of all repositories.
    - Update `HomeViewModel`, `SearchViewModel`, and `DetailsViewModel` to handle seen repository state and filtering logic.

- **Database &amp; Data Layer**
    - Perform a Room database migration (version 5 to 6) to add the `seen_repos` table.
    - Create `SeenRepoDao`, `SeenRepoEntity`, and `SeenReposRepository` to manage persistent seen status.
    - Update `TweaksRepository` to store the "Hide Seen" user preference.

- **Flatpak Packaging**
    - Add initial Flatpak packaging support including build manifest (`.yml`), AppStream metadata, desktop entry, and launcher scripts.
    - Include a comprehensive `README.md` in the packaging directory detailing build requirements and local installation steps.

- **UI &amp; Localization**
    - Add localized strings for "Hide Seen Repositories" and "Clear Seen History" features.
    - Enhance the Profile screen with new toggle and action cards for managing seen repository history.
diff --git a/core/data/schemas/zed.rainxch.core.data.local.db.AppDatabase/4.json b/core/data/schemas/zed.rainxch.core.data.local.db.AppDatabase/4.json
diff --git a/core/data/schemas/zed.rainxch.core.data.local.db.AppDatabase/5.json b/core/data/schemas/zed.rainxch.core.data.local.db.AppDatabase/5.json
diff --git a/core/data/src/androidMain/kotlin/zed/rainxch/core/data/local/db/initDatabase.kt b/core/data/src/androidMain/kotlin/zed/rainxch/core/data/local/db/initDatabase.kt
@@ -7,6 +7,7 @@ import zed.rainxch.core.data.local.db.migrations.MIGRATION_1_2
 import zed.rainxch.core.data.local.db.migrations.MIGRATION_2_3
 import zed.rainxch.core.data.local.db.migrations.MIGRATION_3_4
 import zed.rainxch.core.data.local.db.migrations.MIGRATION_4_5
+import zed.rainxch.core.data.local.db.migrations.MIGRATION_5_6
 
 fun initDatabase(context: Context): AppDatabase {
     val appContext = context.applicationContext
@@ -21,5 +22,6 @@ fun initDatabase(context: Context): AppDatabase {
             MIGRATION_2_3,
             MIGRATION_3_4,
             MIGRATION_4_5,
+            MIGRATION_5_6,
         ).build()
 }
diff --git a/core/data/src/androidMain/kotlin/zed/rainxch/core/data/local/db/migrations/MIGRATION_5_6.kt b/core/data/src/androidMain/kotlin/zed/rainxch/core/data/local/db/migrations/MIGRATION_5_6.kt
@@ -0,0 +1,18 @@
+package zed.rainxch.core.data.local.db.migrations
+
+import androidx.room.migration.Migration
+import androidx.sqlite.db.SupportSQLiteDatabase
+
+val MIGRATION_5_6 =
+    object : Migration(5, 6) {
+        override fun migrate(db: SupportSQLiteDatabase) {
+            db.execSQL(
+                """
+                CREATE TABLE IF NOT EXISTS seen_repos (
+                    repoId INTEGER NOT NULL PRIMARY KEY,
+                    seenAt INTEGER NOT NULL
+                )
+                """.trimIndent(),
+            )
+        }
+    }
diff --git a/core/data/src/commonMain/kotlin/zed/rainxch/core/data/di/SharedModule.kt b/core/data/src/commonMain/kotlin/zed/rainxch/core/data/di/SharedModule.kt
@@ -15,6 +15,7 @@ import zed.rainxch.core.data.local.db.AppDatabase
 import zed.rainxch.core.data.local.db.dao.CacheDao
 import zed.rainxch.core.data.local.db.dao.FavoriteRepoDao
 import zed.rainxch.core.data.local.db.dao.InstalledAppDao
+import zed.rainxch.core.data.local.db.dao.SeenRepoDao
 import zed.rainxch.core.data.local.db.dao.StarredRepoDao
 import zed.rainxch.core.data.local.db.dao.UpdateHistoryDao
 import zed.rainxch.core.data.logging.KermitLogger
@@ -26,6 +27,7 @@ import zed.rainxch.core.data.repository.FavouritesRepositoryImpl
 import zed.rainxch.core.data.repository.InstalledAppsRepositoryImpl
 import zed.rainxch.core.data.repository.ProxyRepositoryImpl
 import zed.rainxch.core.data.repository.RateLimitRepositoryImpl
+import zed.rainxch.core.data.repository.SeenReposRepositoryImpl
 import zed.rainxch.core.data.repository.StarredRepositoryImpl
 import zed.rainxch.core.data.repository.TweaksRepositoryImpl
 import zed.rainxch.core.domain.getPlatform
@@ -37,6 +39,7 @@ import zed.rainxch.core.domain.repository.FavouritesRepository
 import zed.rainxch.core.domain.repository.InstalledAppsRepository
 import zed.rainxch.core.domain.repository.ProxyRepository
 import zed.rainxch.core.domain.repository.RateLimitRepository
+import zed.rainxch.core.domain.repository.SeenReposRepository
 import zed.rainxch.core.domain.repository.StarredRepository
 import zed.rainxch.core.domain.repository.TweaksRepository
 import zed.rainxch.core.domain.use_cases.SyncInstalledAppsUseCase
@@ -94,6 +97,12 @@ val coreModule =
             )
         }
 
+        single<SeenReposRepository> {
+            SeenReposRepositoryImpl(
+                seenRepoDao = get(),
+            )
+        }
+
         single<ProxyRepository> {
             ProxyRepositoryImpl(
                 preferences = get(),
@@ -203,4 +212,8 @@ val databaseModule =
         single<CacheDao> {
             get<AppDatabase>().cacheDao
         }
+
+        single<SeenRepoDao> {
+            get<AppDatabase>().seenRepoDao
+        }
     }
diff --git a/core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/AppDatabase.kt b/core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/AppDatabase.kt
@@ -5,11 +5,13 @@ import androidx.room.RoomDatabase
 import zed.rainxch.core.data.local.db.dao.CacheDao
 import zed.rainxch.core.data.local.db.dao.FavoriteRepoDao
 import zed.rainxch.core.data.local.db.dao.InstalledAppDao
+import zed.rainxch.core.data.local.db.dao.SeenRepoDao
 import zed.rainxch.core.data.local.db.dao.StarredRepoDao
 import zed.rainxch.core.data.local.db.dao.UpdateHistoryDao
 import zed.rainxch.core.data.local.db.entities.CacheEntryEntity
 import zed.rainxch.core.data.local.db.entities.FavoriteRepoEntity
 import zed.rainxch.core.data.local.db.entities.InstalledAppEntity
+import zed.rainxch.core.data.local.db.entities.SeenRepoEntity
 import zed.rainxch.core.data.local.db.entities.StarredRepositoryEntity
 import zed.rainxch.core.data.local.db.entities.UpdateHistoryEntity
 
@@ -20,8 +22,9 @@ import zed.rainxch.core.data.local.db.entities.UpdateHistoryEntity
         UpdateHistoryEntity::class,
         StarredRepositoryEntity::class,
         CacheEntryEntity::class,
+        SeenRepoEntity::class,
     ],
-    version = 5,
+    version = 6,
     exportSchema = true,
 )
 abstract class AppDatabase : RoomDatabase() {
@@ -30,4 +33,5 @@ abstract class AppDatabase : RoomDatabase() {
     abstract val updateHistoryDao: UpdateHistoryDao
     abstract val starredReposDao: StarredRepoDao
     abstract val cacheDao: CacheDao
+    abstract val seenRepoDao: SeenRepoDao
 }
diff --git a/core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/dao/SeenRepoDao.kt b/core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/dao/SeenRepoDao.kt
@@ -0,0 +1,20 @@
+package zed.rainxch.core.data.local.db.dao
+
+import androidx.room.Dao
+import androidx.room.Insert
+import androidx.room.OnConflictStrategy
+import androidx.room.Query
+import kotlinx.coroutines.flow.Flow
+import zed.rainxch.core.data.local.db.entities.SeenRepoEntity
+
+@Dao
+interface SeenRepoDao {
+    @Query("SELECT repoId FROM seen_repos")
+    fun getAllSeenRepoIds(): Flow<List<Long>>
+
+    @Insert(onConflict = OnConflictStrategy.IGNORE)
+    suspend fun insert(entity: SeenRepoEntity)
+
+    @Query("DELETE FROM seen_repos")
+    suspend fun clearAll()
+}
diff --git a/core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/entities/SeenRepoEntity.kt b/core/data/src/commonMain/kotlin/zed/rainxch/core/data/local/db/entities/SeenRepoEntity.kt
@@ -0,0 +1,11 @@
+package zed.rainxch.core.data.local.db.entities
+
+import androidx.room.Entity
+import androidx.room.PrimaryKey
+
+@Entity(tableName = "seen_repos")
+data class SeenRepoEntity(
+    @PrimaryKey
+    val repoId: Long,
+    val seenAt: Long,
+)
diff --git a/core/data/src/commonMain/kotlin/zed/rainxch/core/data/repository/SeenReposRepositoryImpl.kt b/core/data/src/commonMain/kotlin/zed/rainxch/core/data/repository/SeenReposRepositoryImpl.kt
@@ -0,0 +1,27 @@
+package zed.rainxch.core.data.repository
+
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.map
+import zed.rainxch.core.data.local.db.dao.SeenRepoDao
+import zed.rainxch.core.data.local.db.entities.SeenRepoEntity
+import zed.rainxch.core.domain.repository.SeenReposRepository
+
+class SeenReposRepositoryImpl(
+    private val seenRepoDao: SeenRepoDao,
+) : SeenReposRepository {
+    override fun getAllSeenRepoIds(): Flow<Set<Long>> =
+        seenRepoDao.getAllSeenRepoIds().map { it.toSet() }
+
+    override suspend fun markAsSeen(repoId: Long) {
+        seenRepoDao.insert(
+            SeenRepoEntity(
+                repoId = repoId,
+                seenAt = System.currentTimeMillis(),
+            ),
+        )
+    }
+
+    override suspend fun clearAll() {
+        seenRepoDao.clearAll()
+    }
+}
diff --git a/core/data/src/commonMain/kotlin/zed/rainxch/core/data/repository/TweaksRepositoryImpl.kt b/core/data/src/commonMain/kotlin/zed/rainxch/core/data/repository/TweaksRepositoryImpl.kt
@@ -26,6 +26,7 @@ class TweaksRepositoryImpl(
     private val UPDATE_CHECK_INTERVAL_KEY = longPreferencesKey("update_check_interval_hours")
     private val INCLUDE_PRE_RELEASES_KEY = booleanPreferencesKey("include_pre_releases")
     private val LIQUID_GLASS_ENABLED_KEY = booleanPreferencesKey("liquid_glass_enabled")
+    private val HIDE_SEEN_ENABLED_KEY = booleanPreferencesKey("hide_seen_enabled")
 
     override fun getThemeColor(): Flow<AppTheme> =
         preferences.data.map { prefs ->
@@ -144,6 +145,17 @@ class TweaksRepositoryImpl(
         }
     }
 
+    override fun getHideSeenEnabled(): Flow<Boolean> =
+        preferences.data.map { prefs ->
+            prefs[HIDE_SEEN_ENABLED_KEY] ?: false
+        }
+
+    override suspend fun setHideSeenEnabled(enabled: Boolean) {
+        preferences.edit { prefs ->
+            prefs[HIDE_SEEN_ENABLED_KEY] = enabled
+        }
+    }
+
     companion object {
         const val DEFAULT_UPDATE_CHECK_INTERVAL_HOURS = 6L
     }
diff --git a/core/domain/src/commonMain/kotlin/zed/rainxch/core/domain/repository/SeenReposRepository.kt b/core/domain/src/commonMain/kotlin/zed/rainxch/core/domain/repository/SeenReposRepository.kt
@@ -0,0 +1,11 @@
+package zed.rainxch.core.domain.repository
+
+import kotlinx.coroutines.flow.Flow
+
+interface SeenReposRepository {
+    fun getAllSeenRepoIds(): Flow<Set<Long>>
+
+    suspend fun markAsSeen(repoId: Long)
+
+    suspend fun clearAll()
+}
diff --git a/core/domain/src/commonMain/kotlin/zed/rainxch/core/domain/repository/TweaksRepository.kt b/core/domain/src/commonMain/kotlin/zed/rainxch/core/domain/repository/TweaksRepository.kt
@@ -45,4 +45,8 @@ interface TweaksRepository {
     fun getLiquidGlassEnabled(): Flow<Boolean>
 
     suspend fun setLiquidGlassEnabled(enabled: Boolean)
+
+    fun getHideSeenEnabled(): Flow<Boolean>
+
+    suspend fun setHideSeenEnabled(enabled: Boolean)
 }
diff --git a/core/presentation/src/commonMain/composeResources/values/strings.xml b/core/presentation/src/commonMain/composeResources/values/strings.xml
@@ -586,4 +586,10 @@
 
     <string name="liquid_glass_option_title">Liquid Glass Effect</string>
     <string name="liquid_glass_option_description">Enhance the interface with a smooth glass-like appearance</string>
+
+    <string name="hide_seen_title">Hide Seen Repositories</string>
+    <string name="hide_seen_description">Hide repositories you have already viewed from discovery feeds</string>
+    <string name="clear_seen_history">Clear Seen History</string>
+    <string name="clear_seen_history_description">Reset all seen repositories so they appear again in feeds</string>
+    <string name="seen_history_cleared">Seen history cleared</string>
 </resources>
diff --git a/feature/details/presentation/src/commonMain/kotlin/zed/rainxch/details/presentation/DetailsViewModel.kt b/feature/details/presentation/src/commonMain/kotlin/zed/rainxch/details/presentation/DetailsViewModel.kt
@@ -33,6 +33,7 @@ import zed.rainxch.core.domain.model.RateLimitException
 import zed.rainxch.core.domain.network.Downloader
 import zed.rainxch.core.domain.repository.FavouritesRepository
 import zed.rainxch.core.domain.repository.InstalledAppsRepository
+import zed.rainxch.core.domain.repository.SeenReposRepository
 import zed.rainxch.core.domain.repository.StarredRepository
 import zed.rainxch.core.domain.repository.TweaksRepository
 import zed.rainxch.core.domain.system.Installer
@@ -90,6 +91,7 @@ class DetailsViewModel(
     private val logger: GitHubStoreLogger,
     private val isComingFromUpdate: Boolean,
     private val tweaksRepository: TweaksRepository,
+    private val seenReposRepository: SeenReposRepository,
 ) : ViewModel() {
     private var hasLoadedInitialData = false
     private var currentDownloadJob: Job? = null
@@ -160,6 +162,8 @@ class DetailsViewModel(
                     } else {
                         detailsRepository.getRepositoryById(repositoryId)
                     }
+                launch { seenReposRepository.markAsSeen(repo.id) }
+
                 val isFavoriteDeferred =
                     async {
                         try {
diff --git a/feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeRoot.kt b/feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeRoot.kt
@@ -244,7 +244,17 @@ private fun MainState(
     bottomNavLiquidState: LiquidState,
     homeTopBarLiquidState: LiquidState,
 ) {
-    if (state.repos.isNotEmpty()) {
+    val visibleRepos by remember(state.repos, state.isHideSeenEnabled, state.seenRepoIds) {
+        derivedStateOf {
+            if (state.isHideSeenEnabled && state.seenRepoIds.isNotEmpty()) {
+                state.repos.filter { it.repository.id !in state.seenRepoIds }
+            } else {
+                state.repos
+            }
+        }
+    }
+
+    if (visibleRepos.isNotEmpty()) {
         LazyVerticalStaggeredGrid(
             state = listState,
             columns = StaggeredGridCells.Adaptive(350.dp),
@@ -254,7 +264,7 @@ private fun MainState(
             modifier = Modifier.fillMaxSize(),
         ) {
             items(
-                items = state.repos,
+                items = visibleRepos,
                 key = { it.repository.id },
                 contentType = { "repo" },
             ) { discoveryRepository ->
diff --git a/feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeState.kt b/feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeState.kt
@@ -20,4 +20,6 @@ data class HomeState(
     val currentPlatform: DiscoveryPlatform = DiscoveryPlatform.All,
     val isPlatformPopupVisible: Boolean = false,
     val isLiquidGlassEnabled: Boolean = true,
+    val isHideSeenEnabled: Boolean = false,
+    val seenRepoIds: Set<Long> = emptySet(),
 )
diff --git a/feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeViewModel.kt b/feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeViewModel.kt
@@ -21,6 +21,7 @@ import zed.rainxch.core.domain.model.DiscoveryPlatform
 import zed.rainxch.core.domain.model.Platform
 import zed.rainxch.core.domain.repository.FavouritesRepository
 import zed.rainxch.core.domain.repository.InstalledAppsRepository
+import zed.rainxch.core.domain.repository.SeenReposRepository
 import zed.rainxch.core.domain.repository.StarredRepository
 import zed.rainxch.core.domain.use_cases.SyncInstalledAppsUseCase
 import zed.rainxch.core.domain.repository.TweaksRepository
@@ -42,6 +43,7 @@ class HomeViewModel(
     private val logger: GitHubStoreLogger,
     private val shareManager: ShareManager,
     private val tweaksRepository: TweaksRepository,
+    private val seenReposRepository: SeenReposRepository,
 ) : ViewModel() {
     private var hasLoadedInitialData = false
     private var currentJob: Job? = null
@@ -61,6 +63,8 @@ class HomeViewModel(
                     observeFavourites()
                     observeStarredRepos()
                     observeLiquidGlassEnabled()
+                    observeSeenRepos()
+                    observeHideSeenEnabled()
 
                     hasLoadedInitialData = true
                 }
@@ -365,6 +369,22 @@ class HomeViewModel(
         }
     }
 
+    private fun observeSeenRepos() {
+        viewModelScope.launch {
+            seenReposRepository.getAllSeenRepoIds().collect { ids ->
+                _state.update { it.copy(seenRepoIds = ids) }
+            }
+        }
+    }
+
+    private fun observeHideSeenEnabled() {
+        viewModelScope.launch {
+            tweaksRepository.getHideSeenEnabled().collect { enabled ->
+                _state.update { it.copy(isHideSeenEnabled = enabled) }
+            }
+        }
+    }
+
     private fun observeFavourites() {
         viewModelScope.launch {
             favouritesRepository.getAllFavorites().collect { favourites ->
diff --git a/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileAction.kt b/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileAction.kt
@@ -94,5 +94,11 @@ sealed interface ProfileAction {
         val enabled: Boolean,
     ) : ProfileAction
 
+    data class OnHideSeenToggled(
+        val enabled: Boolean,
+    ) : ProfileAction
+
+    data object OnClearSeenRepos : ProfileAction
+
     data object OnSponsorClick : ProfileAction
 }
diff --git a/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileEvent.kt b/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileEvent.kt
@@ -18,4 +18,6 @@ sealed interface ProfileEvent {
     data class OnCacheClearError(
         val message: String,
     ) : ProfileEvent
+
+    data object OnSeenHistoryCleared : ProfileEvent
 }
diff --git a/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileRoot.kt b/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileRoot.kt
@@ -92,6 +92,12 @@ fun ProfileRoot(
                     snackbarState.showSnackbar(event.message)
                 }
             }
+
+            ProfileEvent.OnSeenHistoryCleared -> {
+                coroutineScope.launch {
+                    snackbarState.showSnackbar(getString(Res.string.seen_history_cleared))
+                }
+            }
         }
     }
 
diff --git a/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileState.kt b/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileState.kt
@@ -30,4 +30,5 @@ data class ProfileState(
     val updateCheckIntervalHours: Long = 6L,
     val includePreReleases: Boolean = false,
     val isLiquidGlassEnabled: Boolean = true,
+    val isHideSeenEnabled: Boolean = false,
 )
diff --git a/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileViewModel.kt b/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/ProfileViewModel.kt
diff --git a/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/components/sections/Appearance.kt b/feature/profile/presentation/src/commonMain/kotlin/zed/rainxch/profile/presentation/components/sections/Appearance.kt
diff --git a/feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchRoot.kt b/feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchRoot.kt
diff --git a/feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchState.kt b/feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchState.kt
diff --git a/feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchViewModel.kt b/feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchViewModel.kt
diff --git a/packaging/flatpak/README.md b/packaging/flatpak/README.md
