Surface router: /uiux. You are here: enhance-readme. Native iOS/Android (SwiftUI / Compose, no web layer) is out of scope — use Apple HIG / Material directly.

Enhance README

Degree of freedom: MIXED. Caption and tour selection [HIGH freedom]; capture, generator, gitignore, Camo-safe names [LOW freedom — run exactly].

Add a theme-aware hero image and a tour grid to a project's README so the repo advertises itself visually instead of being a wall of text.

How to reason

1. Detect — live URL vs local, theme toggle, login
2. Capture — dark and light at 1600×1000; promote to docs/screenshots/
3. Weave — name + tagline + <picture> hero + tour under badges
4. Sync — badges match package.json; first screen answers what/why/who

Worked example