CLAUDE.md

1# Starred Feature
2 
3Locally cached view of user's starred repos. **Presentation-only** — uses `StarredRepository` from `core/domain` directly.
4 
5## Structure
6 
7```
8feature/starred/presentation/
9├── StarredReposViewModel / State / Action / Root
10├── model/StarredRepositoryUi
11├── mappers/StarredRepoToUiMapper
12├── utils/TimeFormatUtils
13└── components/StarredRepositoryItem
14```
15 
16## Deps
17 
18- `StarredRepository`, `FavouritesRepository`, `AuthenticationState` (core/domain)
19- `ProfileRepository` (feature/profile/domain) — current user login for E20 self-owned badge
20- Local Room (`StarredRepoDao` in core/data)
21 
22## Navigation
23 
24`GithubStoreGraph.StarredReposScreen`.
25 
26## Notes
27 
28- Periodic sync against GitHub's `/user/starred` (gated on `isAuthenticated`). Local Room mirror is the read source.
29- UI model `StarredRepositoryUi` mapped from domain `StarredRepository`.
30- Starring happens elsewhere (home/details/search). This module displays + removes.
31- Inline search bar (E562) when list non-empty — filters by name/owner/description/language client-side. `OnRefresh` clears active query so refreshed list isn't masked behind stale filter.
32- `StarredRepositoryUi.isCurrentUserOwner` set when signed-in user owns the repo (E20).
33- Koin module registered in `composeApp/.../app/di/ViewModelsModule.kt` (no `data/di/`).
34