From 58faeac59c5939c6782bcc34392d0f76bd02f29e Mon Sep 17 00:00:00 2001
From: Priveetee <brahim.benyoucefpro@proton.me>
Date: Sun, 25 Oct 2026 22:03:48 +0100
Subject: [PATCH 1/8] feat: load recommendation rows and send recommender
 feedback

---
 .../core/di/RecommenderRepositoryModule.kt    |  8 +++
 .../data/feed/HomeFeedRepositoryImpl.kt       | 18 ++++-
 .../android/data/network/TypeTypeFeedApi.kt   |  2 +
 .../data/network/TypeTypeRecommenderApi.kt    | 13 ++++
 .../network/dto/RecommenderFeedbackDto.kt     | 20 ++++++
 .../android/data/network/dto/VideoDto.kt      | 12 ++++
 .../RemoteRecommenderFeedbackRepository.kt    | 65 +++++++++++++++++++
 .../android/domain/feed/HomeFeedRepository.kt | 12 ++++
 .../RecommenderFeedbackRepository.kt          | 23 +++++++
 9 files changed, 172 insertions(+), 1 deletion(-)
 create mode 100644 core/data/src/main/java/dev/typetype/android/data/network/dto/RecommenderFeedbackDto.kt
 create mode 100644 core/data/src/main/java/dev/typetype/android/data/recommendations/RemoteRecommenderFeedbackRepository.kt
 create mode 100644 core/model/src/main/java/dev/typetype/android/domain/recommendations/RecommenderFeedbackRepository.kt

diff --git a/core/data/src/main/java/dev/typetype/android/core/di/RecommenderRepositoryModule.kt b/core/data/src/main/java/dev/typetype/android/core/di/RecommenderRepositoryModule.kt
index 6da500f8..cbc1872d 100644
--- a/core/data/src/main/java/dev/typetype/android/core/di/RecommenderRepositoryModule.kt
+++ b/core/data/src/main/java/dev/typetype/android/core/di/RecommenderRepositoryModule.kt
@@ -4,7 +4,9 @@ import dagger.Binds
 import dagger.Module
 import dagger.hilt.InstallIn
 import dagger.hilt.components.SingletonComponent
+import dev.typetype.android.data.recommendations.RemoteRecommenderFeedbackRepository
 import dev.typetype.android.data.recommendations.RemoteRecommenderSettingsRepository
+import dev.typetype.android.domain.recommendations.RecommenderFeedbackRepository
 import dev.typetype.android.domain.recommendations.RecommenderSettingsRepository
 import javax.inject.Singleton
 
@@ -16,4 +18,10 @@ abstract class RecommenderRepositoryModule {
     abstract fun bindRecommenderSettingsRepository(
         implementation: RemoteRecommenderSettingsRepository,
     ): RecommenderSettingsRepository
+
+    @Binds
+    @Singleton
+    abstract fun bindRecommenderFeedbackRepository(
+        implementation: RemoteRecommenderFeedbackRepository,
+    ): RecommenderFeedbackRepository
 }
diff --git a/core/data/src/main/java/dev/typetype/android/data/feed/HomeFeedRepositoryImpl.kt b/core/data/src/main/java/dev/typetype/android/data/feed/HomeFeedRepositoryImpl.kt
index 702b37bd..ed38f3a9 100644
--- a/core/data/src/main/java/dev/typetype/android/data/feed/HomeFeedRepositoryImpl.kt
+++ b/core/data/src/main/java/dev/typetype/android/data/feed/HomeFeedRepositoryImpl.kt
@@ -1,5 +1,8 @@
 package dev.typetype.android.data.feed
 
+import java.util.Locale
+import java.util.TimeZone
+import dev.typetype.android.domain.feed.HomeRecommendationRow
 import dev.typetype.android.data.account.ActiveAccountScope
 import dev.typetype.android.data.account.AccountScope
 import dev.typetype.android.data.network.TypeTypeApiHolder
@@ -54,6 +57,7 @@ class HomeFeedRepositoryImpl @Inject constructor(
     override suspend fun loadHomeRecommendations(
         cursor: String?,
         limit: Int,
+        service: Int,
     ): Result<HomeRecommendationsPage> = feedResult {
         val scope = activeAccountScope.require()
         val server = if (scope.accountId.startsWith(GUEST_ACCOUNT_PREFIX)) {
@@ -67,7 +71,14 @@ class HomeFeedRepositoryImpl @Inject constructor(
         }
         val api = apiHolder.require(scope)
         val response = withContext(Dispatchers.IO) {
-            api.homeRecommendations(intent = "auto", cursor = cursor, limit = limit)
+            api.homeRecommendations(
+                service = service,
+                intent = "auto",
+                cursor = cursor,
+                limit = limit,
+                locale = Locale.getDefault().toLanguageTag(),
+                timezone = TimeZone.getDefault().id,
+            )
         }
         response.requireSuccessfulResponse()
         val body = response.body() ?: error("Empty recommendations body")
@@ -75,6 +86,11 @@ class HomeFeedRepositoryImpl @Inject constructor(
         HomeRecommendationsPage(
             videos = body.items.map { it.toDomainVideo() },
             nextCursor = body.nextCursor?.takeIf { body.hasMore && it.isNotBlank() },
+            rows = body.rows.orEmpty().map { row ->
+                HomeRecommendationRow(row.id, row.title, row.reason, row.reasonRef, row.videoUrls)
+            },
+            algorithm = body.algorithm,
+            preparing = body.preparing == true,
         )
     }
 
diff --git a/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeFeedApi.kt b/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeFeedApi.kt
index d3a687df..e1cf1c38 100644
--- a/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeFeedApi.kt
+++ b/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeFeedApi.kt
@@ -27,6 +27,8 @@ interface TypeTypeFeedApi {
         @Query("limit") limit: Int = 30,
         @Query("intent") intent: String? = null,
         @Query("cursor") cursor: String? = null,
+        @Query("locale") locale: String? = null,
+        @Query("timezone") timezone: String? = null,
     ): Response<HomeRecommendationsResponse>
 
     @GET("recommendations/shorts")
diff --git a/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeRecommenderApi.kt b/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeRecommenderApi.kt
index d895387a..a61e2fb5 100644
--- a/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeRecommenderApi.kt
+++ b/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeRecommenderApi.kt
@@ -1,10 +1,15 @@
 package dev.typetype.android.data.network
 
+import dev.typetype.android.data.network.dto.RecommenderFeedbackDto
+import dev.typetype.android.data.network.dto.RecommenderFeedbackRequestDto
 import kotlinx.serialization.json.JsonObject
 import retrofit2.Response
 import retrofit2.http.Body
+import retrofit2.http.DELETE
 import retrofit2.http.GET
+import retrofit2.http.POST
 import retrofit2.http.PUT
+import retrofit2.http.Path
 
 interface TypeTypeRecommenderApi {
     @GET("recommendations/settings")
@@ -12,4 +17,12 @@ interface TypeTypeRecommenderApi {
 
     @PUT("recommendations/settings")
     suspend fun updateRecommenderSettings(@Body settings: JsonObject): Response<JsonObject>
+
+    @POST("recommendations/feedback")
+    suspend fun sendRecommenderFeedback(
+        @Body feedback: RecommenderFeedbackRequestDto,
+    ): Response<RecommenderFeedbackDto>
+
+    @DELETE("recommendations/feedback/{id}")
+    suspend fun deleteRecommenderFeedback(@Path("id") id: String): Response<Unit>
 }
diff --git a/core/data/src/main/java/dev/typetype/android/data/network/dto/RecommenderFeedbackDto.kt b/core/data/src/main/java/dev/typetype/android/data/network/dto/RecommenderFeedbackDto.kt
new file mode 100644
index 00000000..3c5c6cd3
--- /dev/null
+++ b/core/data/src/main/java/dev/typetype/android/data/network/dto/RecommenderFeedbackDto.kt
@@ -0,0 +1,20 @@
+package dev.typetype.android.data.network.dto
+
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class RecommenderFeedbackRequestDto(
+    val kind: String,
+    val verdict: String,
+    val comment: String? = null,
+    val videoUrl: String? = null,
+    val reason: String? = null,
+    val title: String? = null,
+    val channelName: String? = null,
+    val thumbnailUrl: String? = null,
+)
+
+@Serializable
+data class RecommenderFeedbackDto(
+    val id: String = "",
+)
diff --git a/core/data/src/main/java/dev/typetype/android/data/network/dto/VideoDto.kt b/core/data/src/main/java/dev/typetype/android/data/network/dto/VideoDto.kt
index 530fdf36..3b74ab89 100644
--- a/core/data/src/main/java/dev/typetype/android/data/network/dto/VideoDto.kt
+++ b/core/data/src/main/java/dev/typetype/android/data/network/dto/VideoDto.kt
@@ -31,6 +31,18 @@ data class HomeRecommendationsResponse(
     val items: List<VideoItem> = emptyList(),
     val nextCursor: String? = null,
     val hasMore: Boolean = false,
+    val algorithm: String? = null,
+    val preparing: Boolean? = null,
+    val rows: List<HomeRecommendationRowDto>? = null,
+)
+
+@Serializable
+data class HomeRecommendationRowDto(
+    val id: String,
+    val title: String,
+    val reason: String = "",
+    val reasonRef: String? = null,
+    val videoUrls: List<String> = emptyList(),
 )
 
 @Serializable
diff --git a/core/data/src/main/java/dev/typetype/android/data/recommendations/RemoteRecommenderFeedbackRepository.kt b/core/data/src/main/java/dev/typetype/android/data/recommendations/RemoteRecommenderFeedbackRepository.kt
new file mode 100644
index 00000000..345f284c
--- /dev/null
+++ b/core/data/src/main/java/dev/typetype/android/data/recommendations/RemoteRecommenderFeedbackRepository.kt
@@ -0,0 +1,65 @@
+package dev.typetype.android.data.recommendations
+
+import dev.typetype.android.core.error.suspendRunCatching
+import dev.typetype.android.data.account.ActiveAccountScope
+import dev.typetype.android.data.network.TypeTypeApiHolder
+import dev.typetype.android.data.network.dto.RecommenderFeedbackRequestDto
+import dev.typetype.android.data.network.requireSuccessfulResponse
+import dev.typetype.android.domain.feed.Video
+import dev.typetype.android.domain.recommendations.PageRefusalReason
+import dev.typetype.android.domain.recommendations.RecommenderFeedbackRepository
+import dev.typetype.android.domain.recommendations.VideoRefusalReason
+import javax.inject.Inject
+import javax.inject.Singleton
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+@Singleton
+class RemoteRecommenderFeedbackRepository @Inject constructor(
+    private val apiHolder: TypeTypeApiHolder,
+    private val activeAccountScope: ActiveAccountScope,
+) : RecommenderFeedbackRepository {
+    override suspend fun notForMe(video: Video, reason: VideoRefusalReason?): Result<String> = send(
+        RecommenderFeedbackRequestDto(
+            kind = "video",
+            verdict = "not_for_me",
+            videoUrl = video.url,
+            reason = reason?.wireName,
+            title = video.title.take(MAX_TEXT),
+            channelName = video.uploaderName.take(MAX_TEXT),
+            thumbnailUrl = video.thumbnailUrl.takeIf { it.length <= MAX_URL },
+        ),
+    )
+
+    override suspend fun ratePage(good: Boolean, reason: PageRefusalReason?, comment: String?): Result<String> = send(
+        RecommenderFeedbackRequestDto(
+            kind = "page",
+            verdict = if (good) "good" else "bad",
+            reason = reason?.wireName,
+            comment = comment?.trim()?.takeIf { it.isNotEmpty() }?.take(MAX_COMMENT),
+        ),
+    )
+
+    override suspend fun withdraw(feedbackId: String): Result<Unit> = suspendRunCatching {
+        val scope = activeAccountScope.require()
+        val response = withContext(Dispatchers.IO) {
+            apiHolder.require(scope).deleteRecommenderFeedback(feedbackId)
+        }
+        response.requireSuccessfulResponse()
+    }
+
+    private suspend fun send(request: RecommenderFeedbackRequestDto): Result<String> = suspendRunCatching {
+        val scope = activeAccountScope.require()
+        val response = withContext(Dispatchers.IO) {
+            apiHolder.require(scope).sendRecommenderFeedback(request)
+        }
+        response.requireSuccessfulResponse()
+        response.body()?.id.orEmpty()
+    }
+
+    private companion object {
+        const val MAX_TEXT = 300
+        const val MAX_URL = 500
+        const val MAX_COMMENT = 1000
+    }
+}
diff --git a/core/model/src/main/java/dev/typetype/android/domain/feed/HomeFeedRepository.kt b/core/model/src/main/java/dev/typetype/android/domain/feed/HomeFeedRepository.kt
index aca00814..d3d8bf1a 100644
--- a/core/model/src/main/java/dev/typetype/android/domain/feed/HomeFeedRepository.kt
+++ b/core/model/src/main/java/dev/typetype/android/domain/feed/HomeFeedRepository.kt
@@ -14,6 +14,17 @@ data class SubscriptionsPage(
 data class HomeRecommendationsPage(
     val videos: List<Video>,
     val nextCursor: String?,
+    val rows: List<HomeRecommendationRow> = emptyList(),
+    val algorithm: String? = null,
+    val preparing: Boolean = false,
+)
+
+data class HomeRecommendationRow(
+    val id: String,
+    val title: String,
+    val reason: String,
+    val reasonRef: String?,
+    val videoUrls: List<String>,
 )
 
 sealed interface ShortsContinuation {
@@ -35,6 +46,7 @@ interface HomeFeedRepository {
     suspend fun loadHomeRecommendations(
         cursor: String? = null,
         limit: Int = 20,
+        service: Int = 0,
     ): Result<HomeRecommendationsPage>
     suspend fun loadTrending(): Result<List<Video>>
     suspend fun loadSubscriptionsFeed(
diff --git a/core/model/src/main/java/dev/typetype/android/domain/recommendations/RecommenderFeedbackRepository.kt b/core/model/src/main/java/dev/typetype/android/domain/recommendations/RecommenderFeedbackRepository.kt
new file mode 100644
index 00000000..bb467be3
--- /dev/null
+++ b/core/model/src/main/java/dev/typetype/android/domain/recommendations/RecommenderFeedbackRepository.kt
@@ -0,0 +1,23 @@
+package dev.typetype.android.domain.recommendations
+
+import dev.typetype.android.domain.feed.Video
+
+enum class VideoRefusalReason(val wireName: String) {
+    Seen("seen"),
+    Channel("channel"),
+    Topic("topic"),
+    Other("other"),
+}
+
+enum class PageRefusalReason(val wireName: String) {
+    Repetitive("repetitive"),
+    Unrelated("unrelated"),
+    Old("old"),
+    Missing("missing"),
+}
+
+interface RecommenderFeedbackRepository {
+    suspend fun notForMe(video: Video, reason: VideoRefusalReason? = null): Result<String>
+    suspend fun withdraw(feedbackId: String): Result<Unit>
+    suspend fun ratePage(good: Boolean, reason: PageRefusalReason? = null, comment: String? = null): Result<String>
+}

From 59ab498b3521ee980c0fb11ebfbce223bdbbd90a Mon Sep 17 00:00:00 2001
From: Priveetee <brahim.benyoucefpro@proton.me>
Date: Sun, 25 Oct 2026 22:03:48 +0100
Subject: [PATCH 2/8] feat: add home cards for recommendations and feedback

---
 .../resources/src/main/res/values/strings.xml |  32 ++++
 .../android/feature/home/HomePageFeedback.kt  |  94 ++++++++++++
 .../feature/home/HomeRecommenderCards.kt      | 137 ++++++++++++++++++
 .../feature/home/HomeRecommenderState.kt      |  46 ++++++
 4 files changed, 309 insertions(+)
 create mode 100644 feature/home/src/main/java/dev/typetype/android/feature/home/HomePageFeedback.kt
 create mode 100644 feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderCards.kt
 create mode 100644 feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderState.kt

diff --git a/core/resources/src/main/res/values/strings.xml b/core/resources/src/main/res/values/strings.xml
index e0e0bb69..a74a8f11 100644
--- a/core/resources/src/main/res/values/strings.xml
+++ b/core/resources/src/main/res/values/strings.xml
@@ -934,6 +934,38 @@
     <string name="home_empty">Nothing here yet</string>
     <string name="home_section_trending">Trending</string>
     <string name="home_section_recommended">Recommended</string>
+    <string name="home_algo_welcome_title">Your home page can learn what you like</string>
+    <string name="home_algo_welcome_text">This instance offers personalized recommendations. Turn them on to get rows built from what you watch and follow, and change the algorithm anytime in Settings.</string>
+    <string name="home_algo_welcome_enable">Turn on</string>
+    <string name="home_algo_welcome_later">Later</string>
+    <string name="home_algo_preparing">Your home page is being prepared. It will show up by itself.</string>
+    <string name="home_algo_not_for_me">Not for me</string>
+    <string name="home_algo_removed">Off your home page</string>
+    <string name="home_algo_why">Why? (if you wish)</string>
+    <string name="home_algo_reason_seen">Already seen</string>
+    <string name="home_algo_reason_channel">Not this channel</string>
+    <string name="home_algo_reason_topic">Not this topic</string>
+    <string name="home_algo_reason_other">Other</string>
+    <string name="home_algo_undo">Undo</string>
+    <string name="home_algo_question">Does this page suit you?</string>
+    <string name="home_algo_page_good">Yes, this page suits me</string>
+    <string name="home_algo_page_bad">No, this page does not suit me</string>
+    <string name="home_algo_page_why">What\'s off? (if you wish)</string>
+    <string name="home_algo_page_repetitive">Too repetitive</string>
+    <string name="home_algo_page_unrelated">Nothing to do with me</string>
+    <string name="home_algo_page_old">Too many old videos</string>
+    <string name="home_algo_page_missing">My channels are missing</string>
+    <string name="home_algo_comment">A comment, if you wish</string>
+    <string name="home_algo_send">Send</string>
+    <string name="home_algo_thanks">Thank you, your opinion was saved.</string>
+    <string name="algo_part_recent">Recently watched</string>
+    <string name="algo_part_continue">Started videos</string>
+    <string name="algo_part_watch_again">Watch again</string>
+    <string name="algo_part_subscriptions">Subscriptions</string>
+    <string name="algo_part_topics">Your interests</string>
+    <string name="algo_part_discovery">New creators</string>
+    <string name="algo_part_trending">Trending</string>
+    <string name="algo_part_recommended">Recommended</string>
     <string name="home_section_continue_watching">Continue watching</string>
     <string name="library_tab_history">History</string>
     <string name="library_tab_favorites">Favorites</string>
diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomePageFeedback.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomePageFeedback.kt
new file mode 100644
index 00000000..bdc48df6
--- /dev/null
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomePageFeedback.kt
@@ -0,0 +1,94 @@
+package dev.typetype.android.feature.home
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.ExperimentalLayoutApi
+import androidx.compose.foundation.layout.FlowRow
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.outlined.ThumbDown
+import androidx.compose.material.icons.outlined.ThumbUp
+import androidx.compose.material3.Button
+import androidx.compose.material3.FilterChip
+import androidx.compose.material3.Icon
+import androidx.compose.material3.IconButton
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedTextField
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.saveable.rememberSaveable
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.LiveRegionMode
+import androidx.compose.ui.semantics.liveRegion
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.unit.dp
+import dev.typetype.android.R
+import dev.typetype.android.domain.recommendations.PageRefusalReason
+
+@OptIn(ExperimentalLayoutApi::class)
+@Composable
+internal fun HomePageFeedback(
+    verdict: PageVerdict,
+    reason: PageRefusalReason?,
+    onRate: (Boolean) -> Unit,
+    onReason: (PageRefusalReason) -> Unit,
+    onSend: (String) -> Unit,
+) {
+    Column(
+        modifier = Modifier.fillMaxWidth().padding(horizontal = 4.dp).semantics { liveRegion = LiveRegionMode.Polite },
+        verticalArrangement = Arrangement.spacedBy(8.dp),
+    ) {
+        when (verdict) {
+            PageVerdict.Thanked -> Text(
+                stringResource(R.string.home_algo_thanks),
+                style = MaterialTheme.typography.bodyMedium,
+                color = MaterialTheme.colorScheme.onSurfaceVariant,
+            )
+            PageVerdict.Unasked -> Row(verticalAlignment = Alignment.CenterVertically) {
+                Text(stringResource(R.string.home_algo_question), style = MaterialTheme.typography.bodyMedium)
+                IconButton(onClick = { onRate(true) }) {
+                    Icon(Icons.Outlined.ThumbUp, contentDescription = stringResource(R.string.home_algo_page_good))
+                }
+                IconButton(onClick = { onRate(false) }) {
+                    Icon(Icons.Outlined.ThumbDown, contentDescription = stringResource(R.string.home_algo_page_bad))
+                }
+            }
+            PageVerdict.AskingWhy -> {
+                var comment by rememberSaveable { mutableStateOf("") }
+                Text(stringResource(R.string.home_algo_page_why), style = MaterialTheme.typography.bodyMedium)
+                FlowRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                    PageRefusalReason.entries.forEach { option ->
+                        FilterChip(
+                            selected = reason == option,
+                            onClick = { onReason(option) },
+                            label = { Text(stringResource(option.label())) },
+                        )
+                    }
+                }
+                OutlinedTextField(
+                    value = comment,
+                    onValueChange = { comment = it.take(MAX_COMMENT) },
+                    label = { Text(stringResource(R.string.home_algo_comment)) },
+                    modifier = Modifier.fillMaxWidth(),
+                )
+                Button(onClick = { onSend(comment) }) { Text(stringResource(R.string.home_algo_send)) }
+            }
+        }
+    }
+}
+
+private fun PageRefusalReason.label(): Int = when (this) {
+    PageRefusalReason.Repetitive -> R.string.home_algo_page_repetitive
+    PageRefusalReason.Unrelated -> R.string.home_algo_page_unrelated
+    PageRefusalReason.Old -> R.string.home_algo_page_old
+    PageRefusalReason.Missing -> R.string.home_algo_page_missing
+}
+
+private const val MAX_COMMENT = 1000
diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderCards.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderCards.kt
new file mode 100644
index 00000000..d76b7d85
--- /dev/null
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderCards.kt
@@ -0,0 +1,137 @@
+package dev.typetype.android.feature.home
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.ExperimentalLayoutApi
+import androidx.compose.foundation.layout.FlowRow
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.outlined.AutoAwesome
+import androidx.compose.material.icons.outlined.ThumbDown
+import androidx.compose.material3.Button
+import androidx.compose.material3.Card
+import androidx.compose.material3.CardDefaults
+import androidx.compose.material3.FilterChip
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Text
+import androidx.compose.material3.TextButton
+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.semantics.LiveRegionMode
+import androidx.compose.ui.semantics.liveRegion
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.unit.dp
+import dev.typetype.android.R
+import dev.typetype.android.domain.recommendations.VideoRefusalReason
+
+@Composable
+internal fun HomeWelcomeCard(onEnable: () -> Unit, onLater: () -> Unit) {
+    Card(
+        modifier = Modifier.fillMaxWidth(),
+        colors = CardDefaults.cardColors(containerColor = MaterialTheme.colorScheme.secondaryContainer),
+    ) {
+        Column(modifier = Modifier.padding(16.dp), verticalArrangement = Arrangement.spacedBy(8.dp)) {
+            Row(verticalAlignment = Alignment.CenterVertically, horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                Icon(Icons.Outlined.AutoAwesome, contentDescription = null)
+                Text(stringResource(R.string.home_algo_welcome_title), style = MaterialTheme.typography.titleMedium)
+            }
+            Text(stringResource(R.string.home_algo_welcome_text), style = MaterialTheme.typography.bodyMedium)
+            Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                Button(onClick = onEnable) { Text(stringResource(R.string.home_algo_welcome_enable)) }
+                TextButton(onClick = onLater) { Text(stringResource(R.string.home_algo_welcome_later)) }
+            }
+        }
+    }
+}
+
+@Composable
+internal fun HomePreparingBanner() {
+    Text(
+        text = stringResource(R.string.home_algo_preparing),
+        style = MaterialTheme.typography.bodyMedium,
+        color = MaterialTheme.colorScheme.onSurfaceVariant,
+        modifier = Modifier
+            .padding(horizontal = 4.dp)
+            .semantics { liveRegion = LiveRegionMode.Polite },
+    )
+}
+
+@Composable
+internal fun HomeRowHeader(title: String, reason: String) {
+    Column(modifier = Modifier.padding(horizontal = 4.dp)) {
+        Text(title, style = MaterialTheme.typography.titleMedium)
+        Text(
+            stringResource(reasonLabel(reason)),
+            style = MaterialTheme.typography.labelMedium,
+            color = MaterialTheme.colorScheme.onSurfaceVariant,
+        )
+    }
+}
+
+@Composable
+internal fun NotForMeButton(onClick: () -> Unit) {
+    TextButton(onClick = onClick) {
+        Icon(Icons.Outlined.ThumbDown, contentDescription = null, modifier = Modifier.size(16.dp))
+        Text(
+            stringResource(R.string.home_algo_not_for_me),
+            style = MaterialTheme.typography.labelMedium,
+            modifier = Modifier.padding(start = 6.dp),
+        )
+    }
+}
+
+@OptIn(ExperimentalLayoutApi::class)
+@Composable
+internal fun RefusedVideoCard(
+    refusal: VideoRefusal,
+    onExplain: (VideoRefusalReason) -> Unit,
+    onUndo: () -> Unit,
+) {
+    Card(modifier = Modifier.fillMaxWidth()) {
+        Column(
+            modifier = Modifier.padding(16.dp).semantics { liveRegion = LiveRegionMode.Polite },
+            verticalArrangement = Arrangement.spacedBy(8.dp),
+        ) {
+            Text(stringResource(R.string.home_algo_removed), style = MaterialTheme.typography.titleSmall)
+            Text(
+                stringResource(R.string.home_algo_why),
+                style = MaterialTheme.typography.labelMedium,
+                color = MaterialTheme.colorScheme.onSurfaceVariant,
+            )
+            FlowRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                VideoRefusalReason.entries.forEach { reason ->
+                    FilterChip(
+                        selected = refusal.reason == reason,
+                        onClick = { onExplain(reason) },
+                        label = { Text(stringResource(reason.label())) },
+                    )
+                }
+            }
+            TextButton(onClick = onUndo) { Text(stringResource(R.string.home_algo_undo)) }
+        }
+    }
+}
+
+private fun VideoRefusalReason.label(): Int = when (this) {
+    VideoRefusalReason.Seen -> R.string.home_algo_reason_seen
+    VideoRefusalReason.Channel -> R.string.home_algo_reason_channel
+    VideoRefusalReason.Topic -> R.string.home_algo_reason_topic
+    VideoRefusalReason.Other -> R.string.home_algo_reason_other
+}
+
+internal fun reasonLabel(reason: String): Int = when (reason) {
+    "watched", "same_channel" -> R.string.algo_part_recent
+    "continue" -> R.string.algo_part_continue
+    "watch_again" -> R.string.algo_part_watch_again
+    "subscriptions", "new_from_subscriptions" -> R.string.algo_part_subscriptions
+    "topic" -> R.string.algo_part_topics
+    "discovery" -> R.string.algo_part_discovery
+    "trending" -> R.string.algo_part_trending
+    else -> R.string.algo_part_recommended
+}
diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderState.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderState.kt
new file mode 100644
index 00000000..7cb97c93
--- /dev/null
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderState.kt
@@ -0,0 +1,46 @@
+package dev.typetype.android.feature.home
+
+import dev.typetype.android.domain.feed.HomeRecommendationRow
+import dev.typetype.android.domain.recommendations.PageRefusalReason
+import dev.typetype.android.domain.recommendations.VideoRefusalReason
+
+data class VideoRefusal(
+    val feedbackId: String? = null,
+    val reason: VideoRefusalReason? = null,
+)
+
+sealed interface PageVerdict {
+    data object Unasked : PageVerdict
+    data object AskingWhy : PageVerdict
+    data object Thanked : PageVerdict
+}
+
+data class HomeRecommenderState(
+    val available: Boolean = false,
+    val enabled: Boolean? = null,
+    val welcomeDismissed: Boolean = false,
+    val rows: List<HomeRecommendationRow> = emptyList(),
+    val algorithm: String? = null,
+    val preparing: Boolean = false,
+    val refused: Map<String, VideoRefusal> = emptyMap(),
+    val pageVerdict: PageVerdict = PageVerdict.Unasked,
+    val pageReason: PageRefusalReason? = null,
+) {
+    val showWelcome: Boolean
+        get() = available && enabled == false && !welcomeDismissed
+
+    val personalized: Boolean
+        get() = algorithm != null && rows.isNotEmpty()
+}
+
+internal fun mergeRows(
+    current: List<HomeRecommendationRow>,
+    next: List<HomeRecommendationRow>,
+): List<HomeRecommendationRow> {
+    val merged = LinkedHashMap<String, HomeRecommendationRow>()
+    (current + next).forEach { row ->
+        val known = merged[row.id]
+        merged[row.id] = known?.copy(videoUrls = (known.videoUrls + row.videoUrls).distinct()) ?: row
+    }
+    return merged.values.toList()
+}

From e331b39cfaaf6a67269be4cbbe1434f162bfda88 Mon Sep 17 00:00:00 2001
From: Priveetee <brahim.benyoucefpro@proton.me>
Date: Sun, 25 Oct 2026 22:03:48 +0100
Subject: [PATCH 3/8] feat: show personalized rows and feedback on the home
 page

---
 .../android/feature/home/HomeAction.kt        | 12 +++
 .../feature/home/HomeRecommenderController.kt | 86 +++++++++++++++++++
 .../feature/home/HomeRecommenderGrid.kt       | 80 +++++++++++++++++
 .../android/feature/home/HomeScreen.kt        | 50 ++++++++++-
 .../android/feature/home/HomeState.kt         |  2 +
 .../android/feature/home/HomeViewModel.kt     | 77 ++++++++++++++++-
 6 files changed, 301 insertions(+), 6 deletions(-)
 create mode 100644 feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderController.kt
 create mode 100644 feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderGrid.kt

diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeAction.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeAction.kt
index bde0dbc7..e0241670 100644
--- a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeAction.kt
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeAction.kt
@@ -1,6 +1,18 @@
 package dev.typetype.android.feature.home
 
+import dev.typetype.android.domain.feed.Video
+import dev.typetype.android.domain.recommendations.PageRefusalReason
+import dev.typetype.android.domain.recommendations.VideoRefusalReason
+
 sealed interface HomeAction {
     data object OnRefresh : HomeAction
     data object OnLoadMore : HomeAction
+    data object EnableRecommendations : HomeAction
+    data object DismissWelcome : HomeAction
+    data class NotForMe(val video: Video) : HomeAction
+    data class ExplainRefusal(val video: Video, val reason: VideoRefusalReason) : HomeAction
+    data class UndoRefusal(val videoUrl: String) : HomeAction
+    data class RatePage(val good: Boolean) : HomeAction
+    data class ChoosePageReason(val reason: PageRefusalReason) : HomeAction
+    data class SendPageVerdict(val comment: String) : HomeAction
 }
diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderController.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderController.kt
new file mode 100644
index 00000000..1288813f
--- /dev/null
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderController.kt
@@ -0,0 +1,86 @@
+package dev.typetype.android.feature.home
+
+import dev.typetype.android.domain.feed.Video
+import dev.typetype.android.domain.recommendations.PageRefusalReason
+import dev.typetype.android.domain.recommendations.RecommenderFeedbackRepository
+import dev.typetype.android.domain.recommendations.RecommenderSettingsRepository
+import dev.typetype.android.domain.recommendations.VideoRefusalReason
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.update
+import kotlinx.coroutines.launch
+
+internal class HomeRecommenderController(
+    private val scope: CoroutineScope,
+    private val state: MutableStateFlow<HomeState>,
+    private val settings: RecommenderSettingsRepository,
+    private val feedback: RecommenderFeedbackRepository,
+    private val onEnabled: () -> Unit,
+) {
+    fun refreshEnabled() {
+        if (!state.value.recommender.available) return
+        scope.launch {
+            settings.enabled().onSuccess { enabled -> update { it.copy(enabled = enabled) } }
+        }
+    }
+
+    fun enable() {
+        scope.launch {
+            settings.setEnabled(true).onSuccess { enabled ->
+                update { it.copy(enabled = enabled) }
+                if (enabled) onEnabled()
+            }
+        }
+    }
+
+    fun dismissWelcome() = update { it.copy(welcomeDismissed = true) }
+
+    fun notForMe(video: Video) {
+        update { it.copy(refused = it.refused + (video.url to VideoRefusal())) }
+        scope.launch {
+            feedback.notForMe(video).fold(
+                onSuccess = { id -> setRefusal(video.url) { it.copy(feedbackId = id) } },
+                onFailure = { update { it.copy(refused = it.refused - video.url) } },
+            )
+        }
+    }
+
+    fun explain(video: Video, reason: VideoRefusalReason) {
+        setRefusal(video.url) { it.copy(reason = reason) }
+        scope.launch { feedback.notForMe(video, reason) }
+    }
+
+    fun undo(videoUrl: String) {
+        val id = state.value.recommender.refused[videoUrl]?.feedbackId
+        update { it.copy(refused = it.refused - videoUrl) }
+        if (!id.isNullOrEmpty()) scope.launch { feedback.withdraw(id) }
+    }
+
+    fun ratePage(good: Boolean) {
+        if (good) {
+            update { it.copy(pageVerdict = PageVerdict.Thanked) }
+            scope.launch { feedback.ratePage(good = true) }
+        } else {
+            update { it.copy(pageVerdict = PageVerdict.AskingWhy) }
+        }
+    }
+
+    fun choosePageReason(reason: PageRefusalReason) = update {
+        it.copy(pageReason = reason.takeUnless { selected -> selected == it.pageReason })
+    }
+
+    fun sendPageVerdict(comment: String) {
+        val reason = state.value.recommender.pageReason
+        update { it.copy(pageVerdict = PageVerdict.Thanked) }
+        scope.launch { feedback.ratePage(good = false, reason = reason, comment = comment) }
+    }
+
+    private fun setRefusal(videoUrl: String, transform: (VideoRefusal) -> VideoRefusal) = update {
+        val current = it.refused[videoUrl] ?: return@update it
+        it.copy(refused = it.refused + (videoUrl to transform(current)))
+    }
+
+    private fun update(transform: (HomeRecommenderState) -> HomeRecommenderState) {
+        state.update { it.copy(recommender = transform(it.recommender)) }
+    }
+}
diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderGrid.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderGrid.kt
new file mode 100644
index 00000000..49251412
--- /dev/null
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeRecommenderGrid.kt
@@ -0,0 +1,80 @@
+package dev.typetype.android.feature.home
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.lazy.LazyRow
+import androidx.compose.foundation.lazy.grid.GridItemSpan
+import androidx.compose.foundation.lazy.grid.LazyGridScope
+import androidx.compose.foundation.lazy.items
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.unit.dp
+import dev.typetype.android.core.ui.components.VideoCard
+import dev.typetype.android.domain.feed.Video
+import dev.typetype.android.feature.menu.VideoMenuScope
+
+internal fun LazyGridScope.recommendedRows(
+    recommender: HomeRecommenderState,
+    videos: List<Video>,
+    menuScope: VideoMenuScope,
+    onPlayVideo: (String) -> Unit,
+    onOpenChannel: (String) -> Unit,
+    onAction: (HomeAction) -> Unit,
+) {
+    val byUrl = videos.associateBy { it.url }
+    recommender.rows.forEach { row ->
+        val listed = row.videoUrls.mapNotNull(byUrl::get)
+        if (listed.isEmpty()) return@forEach
+        item(key = "row-${row.id}", span = { GridItemSpan(maxLineSpan) }, contentType = "recommended-row") {
+            Column(verticalArrangement = Arrangement.spacedBy(12.dp)) {
+                HomeRowHeader(title = row.title, reason = row.reason)
+                LazyRow(horizontalArrangement = Arrangement.spacedBy(12.dp)) {
+                    items(listed, key = { it.url }, contentType = { "row-video" }) { video ->
+                        RecommendedVideo(
+                            video = video,
+                            refusal = recommender.refused[video.url],
+                            menuScope = menuScope,
+                            onPlayVideo = onPlayVideo,
+                            onOpenChannel = onOpenChannel,
+                            onAction = onAction,
+                        )
+                    }
+                }
+            }
+        }
+    }
+}
+
+@androidx.compose.runtime.Composable
+private fun RecommendedVideo(
+    video: Video,
+    refusal: VideoRefusal?,
+    menuScope: VideoMenuScope,
+    onPlayVideo: (String) -> Unit,
+    onOpenChannel: (String) -> Unit,
+    onAction: (HomeAction) -> Unit,
+) {
+    Column(modifier = Modifier.width(ROW_CARD_WIDTH)) {
+        if (refusal != null) {
+            RefusedVideoCard(
+                refusal = refusal,
+                onExplain = { reason -> onAction(HomeAction.ExplainRefusal(video, reason)) },
+                onUndo = { onAction(HomeAction.UndoRefusal(video.url)) },
+            )
+        } else {
+            VideoCard(
+                video = video,
+                onClick = { onPlayVideo(video.url) },
+                onChannelClick = { onOpenChannel(video.uploaderUrl) },
+                onMenuAction = { action -> menuScope.onAction(action, video) },
+                menuItemState = menuScope.stateFor(video),
+            )
+            NotForMeButton(onClick = { onAction(HomeAction.NotForMe(video)) })
+        }
+    }
+}
+
+internal fun HomeRecommenderState.hasContinueRow(): Boolean =
+    personalized && rows.any { it.reason == "continue" }
+
+private val ROW_CARD_WIDTH = 280.dp
diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeScreen.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeScreen.kt
index cb07101b..2b5f030c 100644
--- a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeScreen.kt
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeScreen.kt
@@ -43,6 +43,7 @@ fun HomeRoute(
         onOpenChannel = onOpenChannel,
         onRetry = { viewModel.onAction(HomeAction.OnRefresh) },
         onLoadMore = { viewModel.onAction(HomeAction.OnLoadMore) },
+        onAction = viewModel::onAction,
     )
 }
 
@@ -53,6 +54,7 @@ fun HomeScreen(
     onOpenChannel: (channelUrl: String) -> Unit,
     onRetry: () -> Unit,
     onLoadMore: () -> Unit,
+    onAction: (HomeAction) -> Unit = {},
 ) {
     val menuScope = rememberVideoMenuScope(onOpenChannel = onOpenChannel)
     HomeContent(
@@ -62,6 +64,7 @@ fun HomeScreen(
         onOpenChannel = onOpenChannel,
         onRetry = onRetry,
         onLoadMore = onLoadMore,
+        onAction = onAction,
     )
 }
 
@@ -73,9 +76,15 @@ internal fun HomeContent(
     onOpenChannel: (channelUrl: String) -> Unit,
     onRetry: () -> Unit,
     onLoadMore: () -> Unit,
+    onAction: (HomeAction) -> Unit = {},
 ) {
+    val recommender = state.recommender
     val visibleVideos = state.videos.filterNot(menuScope::isHidden)
-    val continueWatching = if (state.hideContinueWatching) emptyList() else state.continueWatching
+    val continueWatching = if (state.hideContinueWatching || recommender.hasContinueRow()) {
+        emptyList()
+    } else {
+        state.continueWatching
+    }
     val showRecommendations = !state.hideHomeRecommendations
     when {
         state.isLoading && state.videos.isEmpty() && continueWatching.isEmpty() -> VideoGridSkeleton()
@@ -92,6 +101,14 @@ internal fun HomeContent(
             horizontalArrangement = Arrangement.spacedBy(16.dp),
             verticalArrangement = Arrangement.spacedBy(24.dp),
         ) {
+            if (recommender.showWelcome) {
+                item(key = "home-welcome", span = { GridItemSpan(maxLineSpan) }) {
+                    HomeWelcomeCard(
+                        onEnable = { onAction(HomeAction.EnableRecommendations) },
+                        onLater = { onAction(HomeAction.DismissWelcome) },
+                    )
+                }
+            }
             if (continueWatching.isNotEmpty()) {
                 item(key = "continue-watching", span = { GridItemSpan(maxLineSpan) }) {
                     ContinueWatchingSection(
@@ -101,12 +118,41 @@ internal fun HomeContent(
                     )
                 }
             }
+            if (showRecommendations && recommender.preparing) {
+                item(key = "home-preparing", span = { GridItemSpan(maxLineSpan) }) { HomePreparingBanner() }
+            }
             if (state.isLoading && showRecommendations && visibleVideos.isNotEmpty()) {
                 item(key = "home-refresh", span = { GridItemSpan(maxLineSpan) }) {
                     LinearProgressIndicator(modifier = Modifier.fillMaxWidth())
                 }
             }
-            if (showRecommendations) {
+            if (showRecommendations && recommender.personalized && state.feedKind == HomeFeedKind.Recommended) {
+                recommendedRows(
+                    recommender = recommender,
+                    videos = visibleVideos,
+                    menuScope = menuScope,
+                    onPlayVideo = onPlayVideo,
+                    onOpenChannel = onOpenChannel,
+                    onAction = onAction,
+                )
+                item(key = "home-page-feedback", span = { GridItemSpan(maxLineSpan) }) {
+                    HomePageFeedback(
+                        verdict = recommender.pageVerdict,
+                        reason = recommender.pageReason,
+                        onRate = { good -> onAction(HomeAction.RatePage(good)) },
+                        onReason = { reason -> onAction(HomeAction.ChoosePageReason(reason)) },
+                        onSend = { comment -> onAction(HomeAction.SendPageVerdict(comment)) },
+                    )
+                }
+                item(key = "home-pagination", span = { GridItemSpan(maxLineSpan) }) {
+                    LazyPaginationFooter(
+                        continuationKey = state.nextCursor,
+                        isLoading = state.isLoadingMore,
+                        hasError = state.loadMoreError,
+                        onLoadMore = onLoadMore,
+                    )
+                }
+            } else if (showRecommendations) {
                 item(key = "home-header", span = { GridItemSpan(maxLineSpan) }) {
                     SectionHeader(
                         text = stringResource(
diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeState.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeState.kt
index f898da44..74ef052a 100644
--- a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeState.kt
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeState.kt
@@ -19,4 +19,6 @@ data class HomeState(
     val errorMessage: String? = null,
     val errorRequestId: String? = null,
     val loadMoreError: Boolean = false,
+    val defaultService: Int = 0,
+    val recommender: HomeRecommenderState = HomeRecommenderState(),
 )
diff --git a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeViewModel.kt b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeViewModel.kt
index af539d04..3e284c74 100644
--- a/feature/home/src/main/java/dev/typetype/android/feature/home/HomeViewModel.kt
+++ b/feature/home/src/main/java/dev/typetype/android/feature/home/HomeViewModel.kt
@@ -11,18 +11,23 @@ import dev.typetype.android.domain.feed.HomeFeedRepository
 import dev.typetype.android.domain.library.LibraryRepository
 import dev.typetype.android.domain.library.VideoMetaRepository
 import dev.typetype.android.domain.library.cacheVideos
+import dev.typetype.android.domain.recommendations.RecommenderFeedbackRepository
+import dev.typetype.android.domain.recommendations.RecommenderSettingsRepository
 import dev.typetype.android.domain.server.Server
 import dev.typetype.android.domain.server.ServerRepository
 import dev.typetype.android.domain.usersettings.UserSettingsRepository
 import javax.inject.Inject
 import kotlinx.coroutines.Job
+import kotlinx.coroutines.delay
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.asStateFlow
 import kotlinx.coroutines.flow.update
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.supervisorScope
 
-private const val HOME_PAGE_SIZE = 12
+private const val HOME_PAGE_SIZE = 30
+private const val PREPARING_RETRY_MS = 10_000L
+private const val PREPARING_MAX_RETRIES = 6
 private const val CONTINUE_WATCHING_LIMIT = 12
 
 @HiltViewModel
@@ -33,6 +38,8 @@ class HomeViewModel @Inject constructor(
     private val videoMetaRepository: VideoMetaRepository,
     private val userSettingsRepository: UserSettingsRepository,
     private val errorMapper: UserErrorMapper,
+    recommenderSettings: RecommenderSettingsRepository,
+    recommenderFeedback: RecommenderFeedbackRepository,
 ) : ViewModel() {
 
     private val _state = MutableStateFlow(HomeState())
@@ -41,6 +48,14 @@ class HomeViewModel @Inject constructor(
     private var loadJob: Job? = null
     private var loadMoreJob: Job? = null
     private var supportingContentJob: Job? = null
+    private var preparingJob: Job? = null
+    private val recommender = HomeRecommenderController(
+        scope = viewModelScope,
+        state = _state,
+        settings = recommenderSettings,
+        feedback = recommenderFeedback,
+        onEnabled = ::refreshFeed,
+    )
 
     init {
         viewModelScope.launch {
@@ -48,7 +63,8 @@ class HomeViewModel @Inject constructor(
             serverRepository.observeCurrentServer().collect { server ->
                 val shouldRefresh = shouldRefreshHomeForServer(observedServerId, server)
                 observedServerId = server?.id
-                _state.update { it.copy(currentServer = server) }
+                val available = server?.recommender?.available == true
+                _state.update { it.copy(currentServer = server, recommender = it.recommender.copy(available = available)) }
                 if (shouldRefresh) {
                     refreshFeed()
                     refreshSupportingContent()
@@ -66,6 +82,7 @@ class HomeViewModel @Inject constructor(
                     it.copy(
                         hideHomeRecommendations = settings.hideHomeRecommendations,
                         hideContinueWatching = settings.hideContinueWatching,
+                        defaultService = settings.defaultService,
                     )
                 }
             }
@@ -79,6 +96,14 @@ class HomeViewModel @Inject constructor(
                 refreshSupportingContent()
             }
             HomeAction.OnLoadMore -> loadMore()
+            HomeAction.EnableRecommendations -> recommender.enable()
+            HomeAction.DismissWelcome -> recommender.dismissWelcome()
+            is HomeAction.NotForMe -> recommender.notForMe(action.video)
+            is HomeAction.ExplainRefusal -> recommender.explain(action.video, action.reason)
+            is HomeAction.UndoRefusal -> recommender.undo(action.videoUrl)
+            is HomeAction.RatePage -> recommender.ratePage(action.good)
+            is HomeAction.ChoosePageReason -> recommender.choosePageReason(action.reason)
+            is HomeAction.SendPageVerdict -> recommender.sendPageVerdict(action.comment)
         }
     }
 
@@ -89,12 +114,14 @@ class HomeViewModel @Inject constructor(
                 launch { libraryRepository.refreshHistory() }
                 launch { userSettingsRepository.refresh() }
             }
+            recommender.refreshEnabled()
         }
     }
 
     private fun refreshFeed() {
         loadJob?.cancel()
         loadMoreJob?.cancel()
+        preparingJob?.cancel()
         _state.update {
             it.copy(
                 isLoading = true,
@@ -110,7 +137,10 @@ class HomeViewModel @Inject constructor(
                     .getOrDefault(emptyList())
                 if (cached.isNotEmpty()) _state.update { it.copy(videos = cached) }
             }
-            val recommendations = feedRepository.loadHomeRecommendations(limit = HOME_PAGE_SIZE)
+            val recommendations = feedRepository.loadHomeRecommendations(
+                limit = HOME_PAGE_SIZE,
+                service = _state.value.defaultService,
+            )
             val page = recommendations.getOrNull()
             if (page != null && (page.videos.isNotEmpty() || page.nextCursor != null)) {
                 _state.update {
@@ -119,8 +149,14 @@ class HomeViewModel @Inject constructor(
                         feedKind = HomeFeedKind.Recommended,
                         videos = page.videos.distinctBy { video -> video.url },
                         nextCursor = page.nextCursor,
+                        recommender = it.recommender.copy(
+                            rows = page.rows,
+                            algorithm = page.algorithm,
+                            preparing = page.preparing,
+                        ),
                     )
                 }
+                if (page.preparing) waitForPreparedPage()
                 videoMetaRepository.cacheVideos(page.videos)
                 suspendRunCatching { feedRepository.cacheHomeFeed(page.videos, append = false) }
                 return@launch
@@ -129,6 +165,34 @@ class HomeViewModel @Inject constructor(
         }
     }
 
+    private fun waitForPreparedPage() {
+        preparingJob?.cancel()
+        preparingJob = viewModelScope.launch {
+            repeat(PREPARING_MAX_RETRIES) {
+                delay(PREPARING_RETRY_MS)
+                val page = feedRepository.loadHomeRecommendations(
+                    limit = HOME_PAGE_SIZE,
+                    service = _state.value.defaultService,
+                ).getOrNull() ?: return@repeat
+                if (page.preparing || page.videos.isEmpty()) return@repeat
+                _state.update {
+                    it.copy(
+                        videos = page.videos.distinctBy { video -> video.url },
+                        nextCursor = page.nextCursor,
+                        recommender = it.recommender.copy(
+                            rows = page.rows,
+                            algorithm = page.algorithm,
+                            preparing = false,
+                        ),
+                    )
+                }
+                videoMetaRepository.cacheVideos(page.videos)
+                return@launch
+            }
+            _state.update { it.copy(recommender = it.recommender.copy(preparing = false)) }
+        }
+    }
+
     private suspend fun loadTrendingFallback(recommendationsFailure: Throwable?) {
         feedRepository.loadTrending().fold(
             onSuccess = { videos ->
@@ -164,13 +228,18 @@ class HomeViewModel @Inject constructor(
         loadMoreJob?.cancel()
         loadMoreJob = viewModelScope.launch {
             _state.update { it.copy(isLoadingMore = true, loadMoreError = false) }
-            feedRepository.loadHomeRecommendations(cursor = cursor, limit = HOME_PAGE_SIZE).fold(
+            feedRepository.loadHomeRecommendations(
+                cursor = cursor,
+                limit = HOME_PAGE_SIZE,
+                service = current.defaultService,
+            ).fold(
                 onSuccess = { page ->
                     _state.update {
                         it.copy(
                             isLoadingMore = false,
                             videos = (it.videos + page.videos).distinctBy { video -> video.url },
                             nextCursor = page.nextCursor,
+                            recommender = it.recommender.copy(rows = mergeRows(it.recommender.rows, page.rows)),
                         )
                     }
                     videoMetaRepository.cacheVideos(page.videos)

From cefbff6fd5534e514b55f5fd71c2faad2d27c5fb Mon Sep 17 00:00:00 2001
From: Priveetee <brahim.benyoucefpro@proton.me>
Date: Sun, 25 Oct 2026 22:04:08 +0100
Subject: [PATCH 4/8] feat: read and save recommender algorithms, settings and
 data

---
 .../core/di/RecommenderRepositoryModule.kt    |   8 +
 .../data/network/TypeTypeRecommenderApi.kt    |  17 ++
 .../recommendations/RecommenderCatalogJson.kt | 150 ++++++++++++++++++
 .../RemoteRecommenderRepository.kt            |  51 ++++++
 .../recommendations/RecommenderModels.kt      |  74 +++++++++
 5 files changed, 300 insertions(+)
 create mode 100644 core/data/src/main/java/dev/typetype/android/data/recommendations/RecommenderCatalogJson.kt
 create mode 100644 core/data/src/main/java/dev/typetype/android/data/recommendations/RemoteRecommenderRepository.kt
 create mode 100644 core/model/src/main/java/dev/typetype/android/domain/recommendations/RecommenderModels.kt

diff --git a/core/data/src/main/java/dev/typetype/android/core/di/RecommenderRepositoryModule.kt b/core/data/src/main/java/dev/typetype/android/core/di/RecommenderRepositoryModule.kt
index cbc1872d..53e4f006 100644
--- a/core/data/src/main/java/dev/typetype/android/core/di/RecommenderRepositoryModule.kt
+++ b/core/data/src/main/java/dev/typetype/android/core/di/RecommenderRepositoryModule.kt
@@ -5,8 +5,10 @@ import dagger.Module
 import dagger.hilt.InstallIn
 import dagger.hilt.components.SingletonComponent
 import dev.typetype.android.data.recommendations.RemoteRecommenderFeedbackRepository
+import dev.typetype.android.data.recommendations.RemoteRecommenderRepository
 import dev.typetype.android.data.recommendations.RemoteRecommenderSettingsRepository
 import dev.typetype.android.domain.recommendations.RecommenderFeedbackRepository
+import dev.typetype.android.domain.recommendations.RecommenderRepository
 import dev.typetype.android.domain.recommendations.RecommenderSettingsRepository
 import javax.inject.Singleton
 
@@ -24,4 +26,10 @@ abstract class RecommenderRepositoryModule {
     abstract fun bindRecommenderFeedbackRepository(
         implementation: RemoteRecommenderFeedbackRepository,
     ): RecommenderFeedbackRepository
+
+    @Binds
+    @Singleton
+    abstract fun bindRecommenderRepository(
+        implementation: RemoteRecommenderRepository,
+    ): RecommenderRepository
 }
diff --git a/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeRecommenderApi.kt b/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeRecommenderApi.kt
index a61e2fb5..f0be4014 100644
--- a/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeRecommenderApi.kt
+++ b/core/data/src/main/java/dev/typetype/android/data/network/TypeTypeRecommenderApi.kt
@@ -2,6 +2,7 @@ package dev.typetype.android.data.network
 
 import dev.typetype.android.data.network.dto.RecommenderFeedbackDto
 import dev.typetype.android.data.network.dto.RecommenderFeedbackRequestDto
+import kotlinx.serialization.json.JsonArray
 import kotlinx.serialization.json.JsonObject
 import retrofit2.Response
 import retrofit2.http.Body
@@ -10,6 +11,7 @@ import retrofit2.http.GET
 import retrofit2.http.POST
 import retrofit2.http.PUT
 import retrofit2.http.Path
+import retrofit2.http.Query
 
 interface TypeTypeRecommenderApi {
     @GET("recommendations/settings")
@@ -23,6 +25,21 @@ interface TypeTypeRecommenderApi {
         @Body feedback: RecommenderFeedbackRequestDto,
     ): Response<RecommenderFeedbackDto>
 
+    @GET("recommendations/algorithms")
+    suspend fun recommenderAlgorithms(
+        @Query("locale") locale: String,
+        @Query("timezone") timezone: String,
+    ): Response<JsonObject>
+
+    @GET("recommendations/profile")
+    suspend fun recommenderProfile(
+        @Query("locale") locale: String,
+        @Query("timezone") timezone: String,
+    ): Response<JsonObject>
+
+    @GET("recommendations/data")
+    suspend fun recommenderData(): Response<JsonArray>
+
     @DELETE("recommendations/feedback/{id}")
     suspend fun deleteRecommenderFeedback(@Path("id") id: String): Response<Unit>
 }
diff --git a/core/data/src/main/java/dev/typetype/android/data/recommendations/RecommenderCatalogJson.kt b/core/data/src/main/java/dev/typetype/android/data/recommendations/RecommenderCatalogJson.kt
new file mode 100644
index 00000000..e39b4e7f
--- /dev/null
+++ b/core/data/src/main/java/dev/typetype/android/data/recommendations/RecommenderCatalogJson.kt
@@ -0,0 +1,150 @@
+package dev.typetype.android.data.recommendations
+
+import dev.typetype.android.domain.recommendations.AlgorithmCatalog
+import dev.typetype.android.domain.recommendations.AlgorithmInfo
+import dev.typetype.android.domain.recommendations.AlgorithmParameter
+import dev.typetype.android.domain.recommendations.AlgorithmTraits
+import dev.typetype.android.domain.recommendations.DataFamily
+import dev.typetype.android.domain.recommendations.InterestGroup
+import dev.typetype.android.domain.recommendations.RecommenderPreferences
+import kotlinx.serialization.json.JsonArray
+import kotlinx.serialization.json.JsonElement
+import kotlinx.serialization.json.JsonNull
+import kotlinx.serialization.json.JsonObject
+import kotlinx.serialization.json.JsonPrimitive
+import kotlinx.serialization.json.booleanOrNull
+import kotlinx.serialization.json.doubleOrNull
+import kotlinx.serialization.json.intOrNull
+import kotlinx.serialization.json.jsonArray
+import kotlinx.serialization.json.jsonObject
+import kotlinx.serialization.json.jsonPrimitive
+
+internal fun JsonObject.toCatalog(): AlgorithmCatalog = AlgorithmCatalog(
+    defaultId = string("default_algorithm"),
+    algorithms = array("algorithms").mapNotNull { (it as? JsonObject)?.toAlgorithm() },
+)
+
+private fun JsonObject.toAlgorithm(): AlgorithmInfo? {
+    val id = string("id") ?: return null
+    val guide = obj("guide")
+    val traits = guide?.obj("traits")
+    return AlgorithmInfo(
+        id = id,
+        name = string("name") ?: id,
+        description = string("description").orEmpty(),
+        forYouIf = guide?.string("for_you_if").orEmpty(),
+        youWillSee = guide?.string("you_will_see").orEmpty(),
+        goodToKnow = guide?.string("good_to_know").orEmpty(),
+        traits = AlgorithmTraits(
+            personal = traits?.int("personal") ?: 0,
+            discovery = traits?.int("discovery") ?: 0,
+            variety = traits?.int("variety") ?: 0,
+        ),
+        parameters = array("parameters").mapNotNull { (it as? JsonObject)?.toParameter() },
+    )
+}
+
+private fun JsonObject.toParameter(): AlgorithmParameter? {
+    val id = string("id") ?: return null
+    val group = string("group").orEmpty()
+    val label = string("label") ?: id
+    val help = string("help")
+    val featured = this["featured"]?.jsonPrimitive?.booleanOrNull == true
+    return when (string("type")) {
+        "number" -> AlgorithmParameter.Number(
+            id = id,
+            group = group,
+            label = label,
+            help = help,
+            featured = featured,
+            min = double("min") ?: 0.0,
+            max = double("max") ?: 1.0,
+            step = double("step") ?: 1.0,
+            default = double("default") ?: 0.0,
+            unit = string("unit"),
+        )
+        "boolean" -> AlgorithmParameter.Toggle(
+            id = id,
+            group = group,
+            label = label,
+            help = help,
+            featured = featured,
+            default = this["default"]?.jsonPrimitive?.booleanOrNull == true,
+        )
+        else -> null
+    }
+}
+
+internal fun JsonObject.toPreferences(): RecommenderPreferences = RecommenderPreferences(
+    enabled = this["enabled"]?.jsonPrimitive?.booleanOrNull == true,
+    algorithmId = string("algorithmId"),
+    parameters = obj("parameters").orEmpty().mapNotNull { (key, value) ->
+        val primitive = value as? JsonPrimitive ?: return@mapNotNull null
+        val parsed: Any = primitive.booleanOrNull ?: primitive.doubleOrNull ?: return@mapNotNull null
+        key to parsed
+    }.toMap(),
+    pinnedGroups = strings("pinnedGroups"),
+    mutedGroups = strings("mutedGroups"),
+    customInterests = strings("customInterests"),
+    unusedData = strings("unusedData"),
+)
+
+internal fun JsonObject.withPreferences(preferences: RecommenderPreferences): JsonObject =
+    JsonObject(
+        toMutableMap().apply {
+            put("enabled", JsonPrimitive(preferences.enabled))
+            put("algorithmId", preferences.algorithmId?.let(::JsonPrimitive) ?: JsonNull)
+            put(
+                "parameters",
+                JsonObject(
+                    preferences.parameters.mapValues { (_, value) ->
+                        when (value) {
+                            is Boolean -> JsonPrimitive(value)
+                            is Number -> JsonPrimitive(value)
+                            else -> JsonPrimitive(value.toString())
+                        }
+                    },
+                ),
+            )
+            put("pinnedGroups", preferences.pinnedGroups.toJsonArray())
+            put("mutedGroups", preferences.mutedGroups.toJsonArray())
+            put("customInterests", preferences.customInterests.toJsonArray())
+            put("unusedData", preferences.unusedData.toJsonArray())
+        },
+    )
+
+internal fun JsonObject.toInterests(): List<InterestGroup> = array("groups").mapNotNull { element ->
+    val group = element as? JsonObject ?: return@mapNotNull null
+    InterestGroup(
+        id = group.string("id") ?: return@mapNotNull null,
+        label = group.string("label").orEmpty(),
+        weight = group.double("weight") ?: 0.0,
+        pinned = group["pinned"]?.jsonPrimitive?.booleanOrNull == true,
+        muted = group["muted"]?.jsonPrimitive?.booleanOrNull == true,
+    )
+}
+
+internal fun JsonArray.toDataFamilies(): List<DataFamily> = mapNotNull { element ->
+    val family = element as? JsonObject ?: return@mapNotNull null
+    DataFamily(
+        id = family.string("id") ?: return@mapNotNull null,
+        count = family.int("count") ?: 0,
+        used = family["use"]?.jsonPrimitive?.booleanOrNull != false,
+    )
+}
+
+private fun List<String>.toJsonArray(): JsonArray = JsonArray(map(::JsonPrimitive))
+
+private fun JsonObject.string(key: String): String? =
+    (this[key] as? JsonPrimitive)?.takeIf { it.isString }?.content
+
+private fun JsonObject.int(key: String): Int? = (this[key] as? JsonPrimitive)?.intOrNull
+
+private fun JsonObject.double(key: String): Double? = (this[key] as? JsonPrimitive)?.doubleOrNull
+
+private fun JsonObject.obj(key: String): JsonObject? = this[key] as? JsonObject
+
+private fun JsonObject.array(key: String): List<JsonElement> = (this[key] as? JsonArray).orEmpty()
+
+private fun JsonObject.strings(key: String): List<String> =
+    array(key).mapNotNull { (it as? JsonPrimitive)?.takeIf { primitive -> primitive.isString }?.content }
diff --git a/core/data/src/main/java/dev/typetype/android/data/recommendations/RemoteRecommenderRepository.kt b/core/data/src/main/java/dev/typetype/android/data/recommendations/RemoteRecommenderRepository.kt
new file mode 100644
index 00000000..054dc7a7
--- /dev/null
+++ b/core/data/src/main/java/dev/typetype/android/data/recommendations/RemoteRecommenderRepository.kt
@@ -0,0 +1,51 @@
+package dev.typetype.android.data.recommendations
+
+import dev.typetype.android.core.error.suspendRunCatching
+import dev.typetype.android.data.account.ActiveAccountScope
+import dev.typetype.android.data.network.TypeTypeApi
+import dev.typetype.android.data.network.TypeTypeApiHolder
+import dev.typetype.android.data.network.requireSuccessfulResponse
+import dev.typetype.android.domain.recommendations.AlgorithmCatalog
+import dev.typetype.android.domain.recommendations.DataFamily
+import dev.typetype.android.domain.recommendations.InterestGroup
+import dev.typetype.android.domain.recommendations.RecommenderPreferences
+import dev.typetype.android.domain.recommendations.RecommenderRepository
+import java.util.TimeZone
+import javax.inject.Inject
+import javax.inject.Singleton
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import retrofit2.Response
+
+@Singleton
+class RemoteRecommenderRepository @Inject constructor(
+    private val apiHolder: TypeTypeApiHolder,
+    private val activeAccountScope: ActiveAccountScope,
+) : RecommenderRepository {
+    override suspend fun catalog(locale: String): Result<AlgorithmCatalog> =
+        call { recommenderAlgorithms(locale, TimeZone.getDefault().id) }.map { it.toCatalog() }
+
+    override suspend fun preferences(): Result<RecommenderPreferences> =
+        call { recommenderSettings() }.map { it.toPreferences() }
+
+    override suspend fun save(preferences: RecommenderPreferences): Result<RecommenderPreferences> =
+        suspendRunCatching {
+            val current = call { recommenderSettings() }.getOrThrow()
+            call { updateRecommenderSettings(current.withPreferences(preferences)) }.getOrThrow().toPreferences()
+        }
+
+    override suspend fun interests(locale: String): Result<List<InterestGroup>> =
+        call { recommenderProfile(locale, TimeZone.getDefault().id) }.map { it.toInterests() }
+
+    override suspend fun dataFamilies(): Result<List<DataFamily>> =
+        call { recommenderData() }.map { it.toDataFamilies() }
+
+    private suspend fun <T> call(request: suspend TypeTypeApi.() -> Response<T>): Result<T> = suspendRunCatching {
+        val scope = activeAccountScope.require()
+        val response = withContext(Dispatchers.IO) { apiHolder.require(scope).request() }
+        response.requireSuccessfulResponse()
+        val body = requireNotNull(response.body()) { "Empty recommender response" }
+        activeAccountScope.verify(scope)
+        body
+    }
+}
diff --git a/core/model/src/main/java/dev/typetype/android/domain/recommendations/RecommenderModels.kt b/core/model/src/main/java/dev/typetype/android/domain/recommendations/RecommenderModels.kt
new file mode 100644
index 00000000..a56b19d0
--- /dev/null
+++ b/core/model/src/main/java/dev/typetype/android/domain/recommendations/RecommenderModels.kt
@@ -0,0 +1,74 @@
+package dev.typetype.android.domain.recommendations
+
+sealed interface AlgorithmParameter {
+    val id: String
+    val group: String
+    val label: String
+    val help: String?
+    val featured: Boolean
+
+    data class Number(
+        override val id: String,
+        override val group: String,
+        override val label: String,
+        override val help: String?,
+        override val featured: Boolean,
+        val min: Double,
+        val max: Double,
+        val step: Double,
+        val default: Double,
+        val unit: String?,
+    ) : AlgorithmParameter
+
+    data class Toggle(
+        override val id: String,
+        override val group: String,
+        override val label: String,
+        override val help: String?,
+        override val featured: Boolean,
+        val default: Boolean,
+    ) : AlgorithmParameter
+}
+
+data class AlgorithmTraits(val personal: Int, val discovery: Int, val variety: Int)
+
+data class AlgorithmInfo(
+    val id: String,
+    val name: String,
+    val description: String,
+    val forYouIf: String,
+    val youWillSee: String,
+    val goodToKnow: String,
+    val traits: AlgorithmTraits,
+    val parameters: List<AlgorithmParameter>,
+)
+
+data class AlgorithmCatalog(val defaultId: String?, val algorithms: List<AlgorithmInfo>)
+
+data class RecommenderPreferences(
+    val enabled: Boolean = false,
+    val algorithmId: String? = null,
+    val parameters: Map<String, Any> = emptyMap(),
+    val pinnedGroups: List<String> = emptyList(),
+    val mutedGroups: List<String> = emptyList(),
+    val customInterests: List<String> = emptyList(),
+    val unusedData: List<String> = emptyList(),
+)
+
+data class InterestGroup(
+    val id: String,
+    val label: String,
+    val weight: Double,
+    val pinned: Boolean,
+    val muted: Boolean,
+)
+
+data class DataFamily(val id: String, val count: Int, val used: Boolean)
+
+interface RecommenderRepository {
+    suspend fun catalog(locale: String): Result<AlgorithmCatalog>
+    suspend fun preferences(): Result<RecommenderPreferences>
+    suspend fun save(preferences: RecommenderPreferences): Result<RecommenderPreferences>
+    suspend fun interests(locale: String): Result<List<InterestGroup>>
+    suspend fun dataFamilies(): Result<List<DataFamily>>
+}

From 545ca635ad0ecb3a48992a30fca2a23864ac8309 Mon Sep 17 00:00:00 2001
From: Priveetee <brahim.benyoucefpro@proton.me>
Date: Sun, 25 Oct 2026 22:04:08 +0100
Subject: [PATCH 5/8] feat: add recommender algorithm cards and parameter
 controls

---
 .../resources/src/main/res/values/strings.xml | 59 ++++++++++++
 .../recommender/RecommenderAlgorithmCard.kt   | 89 ++++++++++++++++++
 .../recommender/RecommenderParameterRows.kt   | 94 +++++++++++++++++++
 .../recommender/RecommenderSettingsState.kt   | 44 +++++++++
 4 files changed, 286 insertions(+)
 create mode 100644 feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderAlgorithmCard.kt
 create mode 100644 feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderParameterRows.kt
 create mode 100644 feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsState.kt

diff --git a/core/resources/src/main/res/values/strings.xml b/core/resources/src/main/res/values/strings.xml
index a74a8f11..1c82d6e4 100644
--- a/core/resources/src/main/res/values/strings.xml
+++ b/core/resources/src/main/res/values/strings.xml
@@ -934,6 +934,65 @@
     <string name="home_empty">Nothing here yet</string>
     <string name="home_section_trending">Trending</string>
     <string name="home_section_recommended">Recommended</string>
+    <string name="algo_title">Recommendations</string>
+    <string name="algo_entry_subtitle">Choose the algorithm, its settings, your interests and the data it reads</string>
+    <string name="algo_load_failed">The recommendation settings could not be loaded.</string>
+    <string name="algo_retry">Retry</string>
+    <string name="algo_save_failed">Your change could not be saved. Try again.</string>
+    <string name="algo_enabled">Personalized home page</string>
+    <string name="algo_enabled_subtitle">Build the home page with the algorithm chosen below instead of the standard page</string>
+    <string name="algo_choose">Algorithm</string>
+    <string name="algo_guide_intro">Each algorithm suits a different way of using the home page. You can switch at any time: your data and each algorithm\'s settings are kept.</string>
+    <string name="algo_guide_for_you_if">For you if</string>
+    <string name="algo_guide_you_see">What you will see</string>
+    <string name="algo_guide_good_to_know">Good to know</string>
+    <string name="algo_trait_personal">Personal</string>
+    <string name="algo_trait_discovery">Discovery</string>
+    <string name="algo_trait_variety">Variety</string>
+    <string name="algo_level_none">None</string>
+    <string name="algo_level_low">Low</string>
+    <string name="algo_level_medium">Medium</string>
+    <string name="algo_level_high">High</string>
+    <string name="algo_settings_of">%1$s settings</string>
+    <string name="algo_reset_all">Restore %1$s defaults</string>
+    <string name="algo_group_rows">Page</string>
+    <string name="algo_group_rows_help">The size of the page and how it is shared out.</string>
+    <string name="algo_group_sources">Sources</string>
+    <string name="algo_group_sources_help">Where the algorithm looks for candidate videos.</string>
+    <string name="algo_group_exploration">Discovery</string>
+    <string name="algo_group_exploration_help">The room left for what you do not watch yet.</string>
+    <string name="algo_group_randomness">Randomness</string>
+    <string name="algo_group_randomness_help">Whether the home page changes on every refresh.</string>
+    <string name="algo_group_decay">Recent videos</string>
+    <string name="algo_group_decay_help">How long a watched video keeps steering the home page.</string>
+    <string name="algo_group_weights">Weights</string>
+    <string name="algo_group_weights_help">What matters most when ranking the candidates.</string>
+    <string name="algo_group_other">Other</string>
+    <string name="algo_group_other_help">More settings of this algorithm.</string>
+    <string name="algo_interests_label">Interests</string>
+    <string name="algo_interest_add_hint">Add subjects in your own words, in any language. The algorithm will look for videos about them. Pin a subject to see more of it, or hide it from the home page.</string>
+    <string name="algo_interest_add_placeholder">Astronomy, Japanese cooking…</string>
+    <string name="algo_interest_add">Add</string>
+    <string name="algo_interest_remove">Remove</string>
+    <string name="algo_pin">Pin</string>
+    <string name="algo_hide">Hide</string>
+    <string name="algo_data_label">Data it may read</string>
+    <string name="algo_data_intro">Turn a family off to keep the algorithm from reading it. Nothing is deleted.</string>
+    <string name="algo_cat_history">Video history</string>
+    <string name="algo_cat_shorts_history">Shorts history</string>
+    <string name="algo_cat_favorites">Favorites</string>
+    <string name="algo_cat_subscriptions">Subscriptions</string>
+    <string name="algo_cat_blocked">Blocked content</string>
+    <string name="algo_cat_not_interested">Not interested</string>
+    <string name="algo_cat_other">Other data</string>
+    <plurals name="algo_interest_full">
+        <item quantity="one">%1$d subject added, that is the maximum. Remove one to add another.</item>
+        <item quantity="other">%1$d subjects added, that is the maximum. Remove one to add another.</item>
+    </plurals>
+    <plurals name="algo_data_count">
+        <item quantity="one">%1$d item</item>
+        <item quantity="other">%1$d items</item>
+    </plurals>
     <string name="home_algo_welcome_title">Your home page can learn what you like</string>
     <string name="home_algo_welcome_text">This instance offers personalized recommendations. Turn them on to get rows built from what you watch and follow, and change the algorithm anytime in Settings.</string>
     <string name="home_algo_welcome_enable">Turn on</string>
diff --git a/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderAlgorithmCard.kt b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderAlgorithmCard.kt
new file mode 100644
index 00000000..d8a92e04
--- /dev/null
+++ b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderAlgorithmCard.kt
@@ -0,0 +1,89 @@
+package dev.typetype.android.feature.settings.recommender
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.selection.selectable
+import androidx.compose.material3.Card
+import androidx.compose.material3.CardDefaults
+import androidx.compose.material3.LinearProgressIndicator
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.RadioButton
+import androidx.compose.material3.Text
+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.semantics.Role
+import androidx.compose.ui.unit.dp
+import dev.typetype.android.R
+import dev.typetype.android.domain.recommendations.AlgorithmInfo
+
+@Composable
+internal fun AlgorithmCard(algorithm: AlgorithmInfo, selected: Boolean, onSelect: () -> Unit) {
+    Card(
+        modifier = Modifier
+            .fillMaxWidth()
+            .selectable(selected = selected, onClick = onSelect, role = Role.RadioButton),
+        colors = CardDefaults.cardColors(
+            containerColor = if (selected) {
+                MaterialTheme.colorScheme.secondaryContainer
+            } else {
+                MaterialTheme.colorScheme.surfaceContainer
+            },
+        ),
+    ) {
+        Column(modifier = Modifier.padding(16.dp), verticalArrangement = Arrangement.spacedBy(8.dp)) {
+            Row(verticalAlignment = Alignment.CenterVertically) {
+                RadioButton(selected = selected, onClick = null)
+                Text(
+                    algorithm.name,
+                    style = MaterialTheme.typography.titleMedium,
+                    modifier = Modifier.padding(start = 8.dp),
+                )
+            }
+            Text(algorithm.description, style = MaterialTheme.typography.bodyMedium)
+            if (selected) {
+                GuideLine(R.string.algo_guide_for_you_if, algorithm.forYouIf)
+                GuideLine(R.string.algo_guide_you_see, algorithm.youWillSee)
+                GuideLine(R.string.algo_guide_good_to_know, algorithm.goodToKnow)
+                TraitMeter(R.string.algo_trait_personal, algorithm.traits.personal)
+                TraitMeter(R.string.algo_trait_discovery, algorithm.traits.discovery)
+                TraitMeter(R.string.algo_trait_variety, algorithm.traits.variety)
+            }
+        }
+    }
+}
+
+@Composable
+private fun GuideLine(labelRes: Int, text: String) {
+    if (text.isBlank()) return
+    Column {
+        Text(stringResource(labelRes), style = MaterialTheme.typography.labelLarge)
+        Text(text, style = MaterialTheme.typography.bodyMedium, color = MaterialTheme.colorScheme.onSurfaceVariant)
+    }
+}
+
+@Composable
+private fun TraitMeter(labelRes: Int, level: Int) {
+    val clamped = level.coerceIn(0, MAX_LEVEL)
+    Row(verticalAlignment = Alignment.CenterVertically, horizontalArrangement = Arrangement.spacedBy(12.dp)) {
+        Text(stringResource(labelRes), style = MaterialTheme.typography.labelMedium, modifier = Modifier.width(96.dp))
+        LinearProgressIndicator(
+            progress = { clamped / MAX_LEVEL.toFloat() },
+            modifier = Modifier.weight(1f),
+        )
+        Text(stringResource(LEVELS[clamped]), style = MaterialTheme.typography.labelMedium)
+    }
+}
+
+private const val MAX_LEVEL = 3
+private val LEVELS = listOf(
+    R.string.algo_level_none,
+    R.string.algo_level_low,
+    R.string.algo_level_medium,
+    R.string.algo_level_high,
+)
diff --git a/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderParameterRows.kt b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderParameterRows.kt
new file mode 100644
index 00000000..32c257eb
--- /dev/null
+++ b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderParameterRows.kt
@@ -0,0 +1,94 @@
+package dev.typetype.android.feature.settings.recommender
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Slider
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableFloatStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.semantics.stateDescription
+import androidx.compose.ui.unit.dp
+import dev.typetype.android.R
+import dev.typetype.android.core.ui.components.SwitchRow
+import dev.typetype.android.domain.recommendations.AlgorithmParameter
+import kotlin.math.roundToInt
+
+@Composable
+internal fun ParameterGroupHeader(group: String) {
+    val (title, help) = groupLabels(group)
+    Column(modifier = Modifier.padding(top = 8.dp)) {
+        Text(stringResource(title), style = MaterialTheme.typography.titleSmall)
+        Text(stringResource(help), style = MaterialTheme.typography.bodySmall, color = MaterialTheme.colorScheme.onSurfaceVariant)
+    }
+}
+
+@Composable
+internal fun ParameterRow(parameter: AlgorithmParameter, value: Any?, onChange: (Any) -> Unit) {
+    when (parameter) {
+        is AlgorithmParameter.Toggle -> SwitchRow(
+            title = parameter.label,
+            subtitle = parameter.help,
+            checked = value as? Boolean ?: parameter.default,
+            onCheckedChange = { onChange(it) },
+        )
+        is AlgorithmParameter.Number -> NumberParameter(parameter, (value as? Number)?.toDouble() ?: parameter.default, onChange)
+    }
+}
+
+@Composable
+private fun NumberParameter(parameter: AlgorithmParameter.Number, current: Double, onChange: (Any) -> Unit) {
+    var position by remember(parameter.id, current) { mutableFloatStateOf(current.toFloat()) }
+    val intervals = ((parameter.max - parameter.min) / parameter.step).roundToInt()
+    val steps = if (intervals in 1..MAX_VISIBLE_STEPS) intervals - 1 else 0
+    val shown = formatValue(position.toDouble(), parameter)
+    Column(modifier = Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(2.dp)) {
+        Row(modifier = Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.SpaceBetween) {
+            Text(parameter.label, style = MaterialTheme.typography.bodyLarge, modifier = Modifier.weight(1f))
+            Text(shown, style = MaterialTheme.typography.labelLarge)
+        }
+        parameter.help?.let {
+            Text(it, style = MaterialTheme.typography.bodySmall, color = MaterialTheme.colorScheme.onSurfaceVariant)
+        }
+        Slider(
+            value = position,
+            onValueChange = { position = snap(it.toDouble(), parameter).toFloat() },
+            onValueChangeFinished = { onChange(snap(position.toDouble(), parameter)) },
+            valueRange = parameter.min.toFloat()..parameter.max.toFloat(),
+            steps = steps,
+            modifier = Modifier.semantics { stateDescription = shown },
+        )
+    }
+}
+
+private fun snap(value: Double, parameter: AlgorithmParameter.Number): Double {
+    val steps = ((value - parameter.min) / parameter.step).roundToInt()
+    return (parameter.min + steps * parameter.step).coerceIn(parameter.min, parameter.max)
+}
+
+private fun formatValue(value: Double, parameter: AlgorithmParameter.Number): String {
+    if (parameter.unit == "%" && parameter.max <= 1.0) return "${(value * 100).roundToInt()} %"
+    val number = if (parameter.step >= 1.0) value.roundToInt().toString() else "%.2f".format(value)
+    return parameter.unit?.let { "$number $it" } ?: number
+}
+
+private fun groupLabels(group: String): Pair<Int, Int> = when (group) {
+    "rows" -> R.string.algo_group_rows to R.string.algo_group_rows_help
+    "sources" -> R.string.algo_group_sources to R.string.algo_group_sources_help
+    "exploration" -> R.string.algo_group_exploration to R.string.algo_group_exploration_help
+    "randomness" -> R.string.algo_group_randomness to R.string.algo_group_randomness_help
+    "decay" -> R.string.algo_group_decay to R.string.algo_group_decay_help
+    "weights" -> R.string.algo_group_weights to R.string.algo_group_weights_help
+    else -> R.string.algo_group_other to R.string.algo_group_other_help
+}
+
+private const val MAX_VISIBLE_STEPS = 12
diff --git a/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsState.kt b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsState.kt
new file mode 100644
index 00000000..c8260c59
--- /dev/null
+++ b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsState.kt
@@ -0,0 +1,44 @@
+package dev.typetype.android.feature.settings.recommender
+
+import dev.typetype.android.domain.recommendations.AlgorithmCatalog
+import dev.typetype.android.domain.recommendations.AlgorithmInfo
+import dev.typetype.android.domain.recommendations.DataFamily
+import dev.typetype.android.domain.recommendations.InterestGroup
+import dev.typetype.android.domain.recommendations.RecommenderPreferences
+
+data class RecommenderSettingsState(
+    val isLoading: Boolean = true,
+    val isSaving: Boolean = false,
+    val loadFailed: Boolean = false,
+    val saveFailed: Boolean = false,
+    val catalog: AlgorithmCatalog? = null,
+    val preferences: RecommenderPreferences = RecommenderPreferences(),
+    val interests: List<InterestGroup> = emptyList(),
+    val families: List<DataFamily> = emptyList(),
+) {
+    val selectedAlgorithm: AlgorithmInfo?
+        get() {
+            val algorithms = catalog?.algorithms.orEmpty()
+            val id = preferences.algorithmId ?: catalog?.defaultId
+            return algorithms.firstOrNull { it.id == id } ?: algorithms.firstOrNull()
+        }
+
+    val canAddInterest: Boolean
+        get() = preferences.customInterests.size < MAX_CUSTOM_INTERESTS
+}
+
+sealed interface RecommenderSettingsAction {
+    data object Retry : RecommenderSettingsAction
+    data class SetEnabled(val enabled: Boolean) : RecommenderSettingsAction
+    data class ChooseAlgorithm(val id: String) : RecommenderSettingsAction
+    data class SetParameter(val id: String, val value: Any) : RecommenderSettingsAction
+    data object ResetParameters : RecommenderSettingsAction
+    data class TogglePinned(val groupId: String) : RecommenderSettingsAction
+    data class ToggleMuted(val groupId: String) : RecommenderSettingsAction
+    data class AddInterest(val text: String) : RecommenderSettingsAction
+    data class RemoveInterest(val text: String) : RecommenderSettingsAction
+    data class SetFamilyUsed(val id: String, val used: Boolean) : RecommenderSettingsAction
+}
+
+internal const val MAX_CUSTOM_INTERESTS = 10
+internal const val MAX_INTEREST_LENGTH = 60

From d688674c06715c055ee75bdc6235c0556fa5be4c Mon Sep 17 00:00:00 2001
From: Priveetee <brahim.benyoucefpro@proton.me>
Date: Sun, 25 Oct 2026 22:04:08 +0100
Subject: [PATCH 6/8] feat: add a recommendations settings screen

---
 .../RecommenderInterestsSection.kt            | 130 ++++++++++++++++++
 .../recommender/RecommenderSettingsScreen.kt  | 107 ++++++++++++++
 .../RecommenderSettingsViewModel.kt           |  98 +++++++++++++
 3 files changed, 335 insertions(+)
 create mode 100644 feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderInterestsSection.kt
 create mode 100644 feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsScreen.kt
 create mode 100644 feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsViewModel.kt

diff --git a/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderInterestsSection.kt b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderInterestsSection.kt
new file mode 100644
index 00000000..b97fb531
--- /dev/null
+++ b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderInterestsSection.kt
@@ -0,0 +1,130 @@
+package dev.typetype.android.feature.settings.recommender
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.ExperimentalLayoutApi
+import androidx.compose.foundation.layout.FlowRow
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.lazy.LazyListScope
+import androidx.compose.foundation.lazy.items
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.filled.Close
+import androidx.compose.material3.Button
+import androidx.compose.material3.FilterChip
+import androidx.compose.material3.Icon
+import androidx.compose.material3.InputChip
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedTextField
+import androidx.compose.material3.Text
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.saveable.rememberSaveable
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.pluralStringResource
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.unit.dp
+import dev.typetype.android.R
+import dev.typetype.android.core.ui.components.SettingsSectionHeader
+import dev.typetype.android.core.ui.components.SwitchRow
+
+@OptIn(ExperimentalLayoutApi::class)
+internal fun LazyListScope.recommenderInterests(
+    state: RecommenderSettingsState,
+    onAction: (RecommenderSettingsAction) -> Unit,
+) {
+    val preferences = state.preferences
+    item { SettingsSectionHeader(stringResource(R.string.algo_interests_label)) }
+    item(key = "custom-interests") {
+        var draft by rememberSaveable { mutableStateOf("") }
+        Column(verticalArrangement = Arrangement.spacedBy(8.dp)) {
+            Text(stringResource(R.string.algo_interest_add_hint), style = MaterialTheme.typography.bodySmall)
+            FlowRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                preferences.customInterests.forEach { interest ->
+                    InputChip(
+                        selected = true,
+                        onClick = { onAction(RecommenderSettingsAction.RemoveInterest(interest)) },
+                        label = { Text(interest) },
+                        trailingIcon = {
+                            Icon(Icons.Filled.Close, contentDescription = stringResource(R.string.algo_interest_remove))
+                        },
+                    )
+                }
+            }
+            if (state.canAddInterest) {
+                Row(verticalAlignment = Alignment.CenterVertically, horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                    OutlinedTextField(
+                        value = draft,
+                        onValueChange = { draft = it.take(MAX_INTEREST_LENGTH) },
+                        placeholder = { Text(stringResource(R.string.algo_interest_add_placeholder)) },
+                        singleLine = true,
+                        modifier = Modifier.weight(1f),
+                    )
+                    Button(
+                        onClick = {
+                            onAction(RecommenderSettingsAction.AddInterest(draft))
+                            draft = ""
+                        },
+                        enabled = draft.isNotBlank(),
+                    ) { Text(stringResource(R.string.algo_interest_add)) }
+                }
+            } else {
+                Text(
+                    pluralStringResource(R.plurals.algo_interest_full, MAX_CUSTOM_INTERESTS, MAX_CUSTOM_INTERESTS),
+                    style = MaterialTheme.typography.bodySmall,
+                )
+            }
+        }
+    }
+    val groups = state.interests.sortedByDescending { it.weight }.take(VISIBLE_GROUPS)
+    items(groups, key = { "interest-${it.id}" }) { group ->
+        val pinned = group.id in preferences.pinnedGroups
+        val muted = group.id in preferences.mutedGroups
+        Column(modifier = Modifier.fillMaxWidth()) {
+            Text(group.label, style = MaterialTheme.typography.bodyLarge)
+            Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
+                FilterChip(
+                    selected = pinned,
+                    onClick = { onAction(RecommenderSettingsAction.TogglePinned(group.id)) },
+                    label = { Text(stringResource(R.string.algo_pin)) },
+                )
+                FilterChip(
+                    selected = muted,
+                    onClick = { onAction(RecommenderSettingsAction.ToggleMuted(group.id)) },
+                    label = { Text(stringResource(R.string.algo_hide)) },
+                )
+            }
+        }
+    }
+}
+
+internal fun LazyListScope.recommenderData(
+    state: RecommenderSettingsState,
+    onAction: (RecommenderSettingsAction) -> Unit,
+) {
+    if (state.families.isEmpty()) return
+    item { SettingsSectionHeader(stringResource(R.string.algo_data_label)) }
+    item { Text(stringResource(R.string.algo_data_intro), style = MaterialTheme.typography.bodySmall) }
+    items(state.families, key = { "family-${it.id}" }) { family ->
+        SwitchRow(
+            title = stringResource(familyLabel(family.id)),
+            subtitle = pluralStringResource(R.plurals.algo_data_count, family.count, family.count),
+            checked = family.used,
+            onCheckedChange = { onAction(RecommenderSettingsAction.SetFamilyUsed(family.id, it)) },
+        )
+    }
+}
+
+private fun familyLabel(id: String): Int = when (id) {
+    "history" -> R.string.algo_cat_history
+    "shorts_history" -> R.string.algo_cat_shorts_history
+    "favorites" -> R.string.algo_cat_favorites
+    "subscriptions" -> R.string.algo_cat_subscriptions
+    "blocked" -> R.string.algo_cat_blocked
+    "not_interested" -> R.string.algo_cat_not_interested
+    else -> R.string.algo_cat_other
+}
+
+private const val VISIBLE_GROUPS = 15
diff --git a/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsScreen.kt b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsScreen.kt
new file mode 100644
index 00000000..f83133d9
--- /dev/null
+++ b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsScreen.kt
@@ -0,0 +1,107 @@
+package dev.typetype.android.feature.settings.recommender
+
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.PaddingValues
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.lazy.items
+import androidx.compose.material3.LinearProgressIndicator
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.material3.TextButton
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.unit.dp
+import androidx.hilt.lifecycle.viewmodel.compose.hiltViewModel
+import androidx.lifecycle.compose.collectAsStateWithLifecycle
+import dev.typetype.android.R
+import dev.typetype.android.core.ui.components.SettingsSectionHeader
+import dev.typetype.android.core.ui.components.SwitchRow
+import dev.typetype.android.feature.settings.SettingsDetailTopBar
+
+@Composable
+fun RecommenderSettingsRoute(onNavigateBack: () -> Unit) {
+    val viewModel: RecommenderSettingsViewModel = hiltViewModel()
+    val state by viewModel.state.collectAsStateWithLifecycle()
+    RecommenderSettingsScreen(state = state, onAction = viewModel::onAction, onNavigateBack = onNavigateBack)
+}
+
+@Composable
+internal fun RecommenderSettingsScreen(
+    state: RecommenderSettingsState,
+    onAction: (RecommenderSettingsAction) -> Unit,
+    onNavigateBack: () -> Unit,
+) {
+    val preferences = state.preferences
+    val selected = state.selectedAlgorithm
+    Surface(modifier = Modifier.fillMaxSize(), color = MaterialTheme.colorScheme.background) {
+        Column(modifier = Modifier.fillMaxSize()) {
+            SettingsDetailTopBar(title = stringResource(R.string.algo_title), onNavigateBack = onNavigateBack)
+            if (state.isLoading || state.isSaving) LinearProgressIndicator(modifier = Modifier.fillMaxWidth())
+            LazyColumn(
+                modifier = Modifier.weight(1f),
+                contentPadding = PaddingValues(horizontal = 16.dp, vertical = 8.dp),
+                verticalArrangement = Arrangement.spacedBy(12.dp),
+            ) {
+                if (state.loadFailed) {
+                    item {
+                        Text(stringResource(R.string.algo_load_failed), color = MaterialTheme.colorScheme.error)
+                        TextButton(onClick = { onAction(RecommenderSettingsAction.Retry) }) {
+                            Text(stringResource(R.string.algo_retry))
+                        }
+                    }
+                }
+                if (state.saveFailed) {
+                    item { Text(stringResource(R.string.algo_save_failed), color = MaterialTheme.colorScheme.error) }
+                }
+                item {
+                    SwitchRow(
+                        title = stringResource(R.string.algo_enabled),
+                        subtitle = stringResource(R.string.algo_enabled_subtitle),
+                        checked = preferences.enabled,
+                        onCheckedChange = { onAction(RecommenderSettingsAction.SetEnabled(it)) },
+                        enabled = !state.isLoading,
+                    )
+                }
+                val algorithms = state.catalog?.algorithms.orEmpty()
+                if (algorithms.isNotEmpty()) {
+                    item { SettingsSectionHeader(stringResource(R.string.algo_choose)) }
+                    item { Text(stringResource(R.string.algo_guide_intro), style = MaterialTheme.typography.bodyMedium) }
+                    items(algorithms, key = { "algorithm-${it.id}" }) { algorithm ->
+                        AlgorithmCard(
+                            algorithm = algorithm,
+                            selected = algorithm.id == selected?.id,
+                            onSelect = { onAction(RecommenderSettingsAction.ChooseAlgorithm(algorithm.id)) },
+                        )
+                    }
+                }
+                if (selected != null && selected.parameters.isNotEmpty()) {
+                    item { SettingsSectionHeader(stringResource(R.string.algo_settings_of, selected.name)) }
+                    selected.parameters
+                        .sortedByDescending { it.featured }
+                        .groupBy { it.group }
+                        .forEach { (group, parameters) ->
+                            item(key = "group-$group") { ParameterGroupHeader(group) }
+                            items(parameters, key = { "parameter-${it.id}" }) { parameter ->
+                                ParameterRow(parameter, preferences.parameters[parameter.id]) { value ->
+                                    onAction(RecommenderSettingsAction.SetParameter(parameter.id, value))
+                                }
+                            }
+                        }
+                    item {
+                        TextButton(onClick = { onAction(RecommenderSettingsAction.ResetParameters) }) {
+                            Text(stringResource(R.string.algo_reset_all, selected.name))
+                        }
+                    }
+                }
+                recommenderInterests(state, onAction)
+                recommenderData(state, onAction)
+            }
+        }
+    }
+}
diff --git a/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsViewModel.kt b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsViewModel.kt
new file mode 100644
index 00000000..41bc6057
--- /dev/null
+++ b/feature/settings/src/main/java/dev/typetype/android/feature/settings/recommender/RecommenderSettingsViewModel.kt
@@ -0,0 +1,98 @@
+package dev.typetype.android.feature.settings.recommender
+
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.viewModelScope
+import dagger.hilt.android.lifecycle.HiltViewModel
+import dev.typetype.android.domain.recommendations.RecommenderPreferences
+import dev.typetype.android.domain.recommendations.RecommenderRepository
+import java.util.Locale
+import javax.inject.Inject
+import kotlinx.coroutines.Job
+import kotlinx.coroutines.async
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.flow.update
+import kotlinx.coroutines.launch
+
+@HiltViewModel
+class RecommenderSettingsViewModel @Inject constructor(
+    private val repository: RecommenderRepository,
+) : ViewModel() {
+    private val _state = MutableStateFlow(RecommenderSettingsState())
+    val state = _state.asStateFlow()
+    private var saveJob: Job? = null
+
+    init {
+        load()
+    }
+
+    fun onAction(action: RecommenderSettingsAction) {
+        when (action) {
+            RecommenderSettingsAction.Retry -> load()
+            is RecommenderSettingsAction.SetEnabled -> edit { it.copy(enabled = action.enabled) }
+            is RecommenderSettingsAction.ChooseAlgorithm -> edit { it.copy(algorithmId = action.id, enabled = true) }
+            is RecommenderSettingsAction.SetParameter -> edit { it.copy(parameters = it.parameters + (action.id to action.value)) }
+            RecommenderSettingsAction.ResetParameters -> {
+                val ids = _state.value.selectedAlgorithm?.parameters?.map { it.id }.orEmpty().toSet()
+                edit { it.copy(parameters = it.parameters - ids) }
+            }
+            is RecommenderSettingsAction.TogglePinned -> edit {
+                it.copy(pinnedGroups = it.pinnedGroups.toggle(action.groupId), mutedGroups = it.mutedGroups - action.groupId)
+            }
+            is RecommenderSettingsAction.ToggleMuted -> edit {
+                it.copy(mutedGroups = it.mutedGroups.toggle(action.groupId), pinnedGroups = it.pinnedGroups - action.groupId)
+            }
+            is RecommenderSettingsAction.AddInterest -> {
+                val text = action.text.trim().take(MAX_INTEREST_LENGTH)
+                if (text.isEmpty() || !_state.value.canAddInterest) return
+                edit { it.copy(customInterests = (it.customInterests + text).distinct()) }
+            }
+            is RecommenderSettingsAction.RemoveInterest -> edit { it.copy(customInterests = it.customInterests - action.text) }
+            is RecommenderSettingsAction.SetFamilyUsed -> {
+                edit {
+                    it.copy(unusedData = if (action.used) it.unusedData - action.id else (it.unusedData + action.id).distinct())
+                }
+                _state.update { state ->
+                    state.copy(families = state.families.map { family -> if (family.id == action.id) family.copy(used = action.used) else family })
+                }
+            }
+        }
+    }
+
+    private fun load() {
+        _state.update { it.copy(isLoading = true, loadFailed = false) }
+        viewModelScope.launch {
+            val locale = Locale.getDefault().toLanguageTag()
+            val catalog = async { repository.catalog(locale) }
+            val preferences = async { repository.preferences() }
+            val interests = async { repository.interests(locale) }
+            val families = async { repository.dataFamilies() }
+            val loadedCatalog = catalog.await().getOrNull()
+            val loadedPreferences = preferences.await().getOrNull()
+            _state.update {
+                it.copy(
+                    isLoading = false,
+                    loadFailed = loadedCatalog == null || loadedPreferences == null,
+                    catalog = loadedCatalog,
+                    preferences = loadedPreferences ?: it.preferences,
+                    interests = interests.await().getOrDefault(emptyList()),
+                    families = families.await().getOrDefault(emptyList()),
+                )
+            }
+        }
+    }
+
+    private fun edit(transform: (RecommenderPreferences) -> RecommenderPreferences) {
+        val updated = transform(_state.value.preferences)
+        _state.update { it.copy(preferences = updated, isSaving = true, saveFailed = false) }
+        saveJob?.cancel()
+        saveJob = viewModelScope.launch {
+            repository.save(updated).fold(
+                onSuccess = { saved -> _state.update { it.copy(preferences = saved, isSaving = false) } },
+                onFailure = { _state.update { it.copy(isSaving = false, saveFailed = true) } },
+            )
+        }
+    }
+}
+
+private fun List<String>.toggle(value: String): List<String> = if (value in this) this - value else this + value

From fe6845b02fe8d0467de2ba114691315d19b1fac5 Mon Sep 17 00:00:00 2001
From: Priveetee <brahim.benyoucefpro@proton.me>
Date: Sun, 25 Oct 2026 22:04:08 +0100
Subject: [PATCH 7/8] feat: open recommendations settings from content settings

---
 .../java/dev/typetype/android/AppNavHost.kt   |  7 ++++
 .../android/core/ui/navigation/Routes.kt      |  3 ++
 .../settings/content/ContentSettingsScreen.kt |  6 +++
 .../settings/content/RecommenderEntryRow.kt   | 40 +++++++++++++++++++
 4 files changed, 56 insertions(+)
 create mode 100644 feature/settings/src/main/java/dev/typetype/android/feature/settings/content/RecommenderEntryRow.kt

diff --git a/app/src/main/java/dev/typetype/android/AppNavHost.kt b/app/src/main/java/dev/typetype/android/AppNavHost.kt
index 44668351..649060e8 100644
--- a/app/src/main/java/dev/typetype/android/AppNavHost.kt
+++ b/app/src/main/java/dev/typetype/android/AppNavHost.kt
@@ -51,6 +51,7 @@ import dev.typetype.android.feature.settings.accounts.AccountSettingsRoute as Ac
 import dev.typetype.android.feature.settings.appearance.AppearanceRoute as AppearanceRouteScreen
 import dev.typetype.android.feature.settings.blocked.BlockedSettingsRoute as BlockedSettingsRouteScreen
 import dev.typetype.android.feature.settings.content.ContentSettingsRoute as ContentSettingsRouteScreen
+import dev.typetype.android.feature.settings.recommender.RecommenderSettingsRoute as RecommenderSettingsRouteScreen
 import dev.typetype.android.feature.settings.diagnostics.DiagnosticsRoute as DiagnosticsRouteScreen
 import dev.typetype.android.feature.settings.player.PlayerSettingsRoute as PlayerSettingsRouteScreen
 import dev.typetype.android.feature.settings.privacy.PrivacySettingsRoute as PrivacySettingsRouteScreen
@@ -238,8 +239,14 @@ fun AppNavHost(
             composable<ContentSettingsRoute> {
                 ContentSettingsRouteScreen(
                     onNavigateBack = { navController.popBackStack() },
+                    onOpenRecommender = {
+                        navController.navigate(dev.typetype.android.core.ui.navigation.RecommenderSettingsRoute)
+                    },
                 )
             }
+            composable<dev.typetype.android.core.ui.navigation.RecommenderSettingsRoute> {
+                RecommenderSettingsRouteScreen(onNavigateBack = { navController.popBackStack() })
+            }
             composable<PlayerSettingsRoute> {
                 PlayerSettingsRouteScreen(
                     onNavigateBack = { navController.popBackStack() },
diff --git a/core/ui/src/main/java/dev/typetype/android/core/ui/navigation/Routes.kt b/core/ui/src/main/java/dev/typetype/android/core/ui/navigation/Routes.kt
index 9a99e04d..a767aa79 100644
--- a/core/ui/src/main/java/dev/typetype/android/core/ui/navigation/Routes.kt
+++ b/core/ui/src/main/java/dev/typetype/android/core/ui/navigation/Routes.kt
@@ -56,6 +56,9 @@ data object PushNotificationsRoute
 @Serializable
 data object ChannelNotificationsRoute
 
+@Serializable
+data object RecommenderSettingsRoute
+
 @Serializable
 data object StorageSettingsRoute
 
diff --git a/feature/settings/src/main/java/dev/typetype/android/feature/settings/content/ContentSettingsScreen.kt b/feature/settings/src/main/java/dev/typetype/android/feature/settings/content/ContentSettingsScreen.kt
index c01d4547..03b18895 100644
--- a/feature/settings/src/main/java/dev/typetype/android/feature/settings/content/ContentSettingsScreen.kt
+++ b/feature/settings/src/main/java/dev/typetype/android/feature/settings/content/ContentSettingsScreen.kt
@@ -38,6 +38,7 @@ import dev.typetype.android.feature.settings.SettingsDetailTopBar
 @Composable
 fun ContentSettingsRoute(
     onNavigateBack: () -> Unit,
+    onOpenRecommender: () -> Unit = {},
     viewModel: ContentSettingsViewModel = hiltViewModel(),
 ) {
     val state by viewModel.state.collectAsStateWithLifecycle()
@@ -45,6 +46,7 @@ fun ContentSettingsRoute(
         state = state,
         onAction = viewModel::onAction,
         onNavigateBack = onNavigateBack,
+        onOpenRecommender = onOpenRecommender,
     )
 }
 
@@ -53,6 +55,7 @@ fun ContentSettingsScreen(
     state: ContentSettingsState,
     onAction: (ContentSettingsAction) -> Unit,
     onNavigateBack: () -> Unit,
+    onOpenRecommender: () -> Unit = {},
 ) {
     val controlsEnabled = !state.isLoading && !state.isUpdating
     Surface(modifier = Modifier.fillMaxSize(), color = MaterialTheme.colorScheme.background) {
@@ -193,6 +196,9 @@ fun ContentSettingsScreen(
                             enabled = !state.isRecommenderLoading && !state.isRecommenderUpdating,
                         )
                     }
+                    item {
+                        RecommenderEntryRow(onClick = onOpenRecommender)
+                    }
                     state.recommenderErrorMessage?.let { message ->
                         item {
                             ContentSettingsFailureCard(
diff --git a/feature/settings/src/main/java/dev/typetype/android/feature/settings/content/RecommenderEntryRow.kt b/feature/settings/src/main/java/dev/typetype/android/feature/settings/content/RecommenderEntryRow.kt
new file mode 100644
index 00000000..8453eff2
--- /dev/null
+++ b/feature/settings/src/main/java/dev/typetype/android/feature/settings/content/RecommenderEntryRow.kt
@@ -0,0 +1,40 @@
+package dev.typetype.android.feature.settings.content
+
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.automirrored.filled.KeyboardArrowRight
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Text
+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.semantics.Role
+import androidx.compose.ui.unit.dp
+import dev.typetype.android.R
+
+@Composable
+internal fun RecommenderEntryRow(onClick: () -> Unit) {
+    Row(
+        modifier = Modifier
+            .fillMaxWidth()
+            .clickable(role = Role.Button, onClick = onClick)
+            .padding(horizontal = 16.dp, vertical = 12.dp),
+        verticalAlignment = Alignment.CenterVertically,
+    ) {
+        Column(modifier = Modifier.weight(1f)) {
+            Text(stringResource(R.string.algo_title), style = MaterialTheme.typography.bodyLarge)
+            Text(
+                stringResource(R.string.algo_entry_subtitle),
+                style = MaterialTheme.typography.bodySmall,
+                color = MaterialTheme.colorScheme.onSurfaceVariant,
+            )
+        }
+        Icon(Icons.AutoMirrored.Filled.KeyboardArrowRight, contentDescription = null)
+    }
+}

From 401fec44ddce42f7fa31340e77ed42c61d743815 Mon Sep 17 00:00:00 2001
From: Priveetee <brahim.benyoucefpro@proton.me>
Date: Sun, 25 Oct 2026 22:04:35 +0100
Subject: [PATCH 8/8] chore: prepare 1.11.0 beta 8

---
 app/build.gradle.kts            | 4 ++--
 release-notes/v1.11.0-beta.8.md | 6 ++++++
 2 files changed, 8 insertions(+), 2 deletions(-)
 create mode 100644 release-notes/v1.11.0-beta.8.md

diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index 1df6f50c..5fa2baeb 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -22,8 +22,8 @@ android {
 
     defaultConfig {
         applicationId = "dev.typetype.android"
-        versionCode = 11107
-        versionName = "1.11.0-beta.7"
+        versionCode = 11108
+        versionName = "1.11.0-beta.8"
     }
 
     signingConfigs {
diff --git a/release-notes/v1.11.0-beta.8.md b/release-notes/v1.11.0-beta.8.md
new file mode 100644
index 00000000..769edfc6
--- /dev/null
+++ b/release-notes/v1.11.0-beta.8.md
@@ -0,0 +1,6 @@
+TypeType Android 1.11.0-beta.8
+
+- Turn on personalized recommendations from the home page when the instance offers them.
+- Show the recommended home page as titled rows, like the web app, with the reason for each row.
+- Say a video is not for you, and tell whether the home page suits you.
+- Choose the recommendation algorithm and its settings, add your own interests, pin or hide subjects, and choose which data it may read, in Settings > Content > Recommendations.