CLAUDE.md

1# Home Feature
2 
3Main discovery — Trending, Hot Releases, Most Popular. Infinite-scroll pagination. Integrates installed-app / favourite / starred status badges.
4 
5## Structure
6 
7```
8feature/home/
9├── domain/    # HomeRepository + HomeCategory (TRENDING / HOT_RELEASE / MOST_POPULAR), TopicCategory
10├── data/      # HomeRepositoryImpl, CachedRepositoriesDataSource (per-category 7-day TTL), dto, mappers, di
11└── presentation/
12    ├── HomeViewModel / State / Action / Event / Root
13    ├── components/HomeFilterChips
14    ├── locals/LocalHomeTopBarLiquid
15    └── utils/HomeCategoryMapper
16```
17 
18## Key interface
19 
20```kotlin
21interface HomeRepository {
22    fun getTrendingRepositories(page: Int): Flow<PaginatedDiscoveryRepositories>
23    fun getHotReleaseRepositories(page: Int): Flow<PaginatedDiscoveryRepositories>
24    fun getMostPopular(page: Int): Flow<PaginatedDiscoveryRepositories>
25}
26```
27 
28## Navigation
29 
30`GithubStoreGraph.ChartsScreen` (bottom-nav label "Top Charts"). The `ExploreScreen` route renders the feed feature, not this one.
31 
32## VM injects
33 
34`HomeRepository`, `InstalledAppsRepository`, `Platform`, `SyncInstalledAppsUseCase`, `FavouritesRepository`, `StarredRepository`, `GitHubStoreLogger`, `ShareManager`, `TweaksRepository`, `SeenReposRepository`, `HiddenReposRepository`, `ProfileRepository`.
35 
36## Notes
37 
38- `Semaphore` in `HomeRepositoryImpl` for concurrent request control. 7-day per-category cache. Pagination via `nextPageIndex`, dedupe by `fullName`.
39- `HomeRoot.visibleRepos` derives display list — filters by `hiddenRepoIds` (E11) and `seenRepoIds` when `isHideSeenEnabled`.
40- Apps section in bottom nav: `Platform.ANDROID` only.
41- Long-press on `RepositoryCard` opens `RepositoryActionsBottomSheet` (Share / Open on GitHub / Mark seen / Hide).
42- `DiscoveryRepositoryUi.isCurrentUserOwner` flipped by `observeCurrentUser` (E20).
43- State uses `onStart` + `stateIn(WhileSubscribed)`.
44