APPSPEC.md

## Feed Screen

**Purpose:** Primary content surface. Personalized
algorithmic feed mixing posts, reels, stories, and ads.

**Layout:** Top AppBar (Logo · DM · Notifications) +
Stories row (horizontal scroll, 72dp avatars) + vertical
feed (RecyclerView, prefetchDistance=4).

**Post card anatomy:**
  - Header: avatar (32dp), username, menu "⋯"
  - Media: carousel (ViewPager2) · 1:1 / 4:5 / 16:9
  - Action row: Like · Comment · Share · Save
  - Counters: "12,384 likes" · "View all 1.2K comments"
  - Caption: 3-line clamp, "more" expander

**Interactions:**
  - Double-tap media → optimistic like + heart burst
    animation (300ms spring)
  - Pull-to-refresh → prepends fresh items, max 5
  - Long-press → floating preview (peek), blur backdrop
  - Video auto-play on 50% viewport, mute by default

**State & data:**
  - FeedViewModel → Paging3 source (page_size=10)
  - Cache: Room DB, TTL 5min, stale-while-revalidate
  - Offline: last 3 pages served from cache

**Telemetry:**
  - impression, dwell_time, like_tap, comment_open,
    share_sheet_open, save_tap, video_watch_pct

**Edge cases:**
  - Empty: "Discover people to follow" empty state
  - Rate-limited: show cached, banner "Feed paused"

... 55 more screens, every flow grounded in decompiled code