bvandeusen/minstrel
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases 39 Wiki Activity

docs: refine porting rule — exact on behavior+feel, idiomatic on implementation

Browse Source 
Operator guidance: parity is about the user experience (layout, copy,
states, and especially responsiveness — caching exists to make the UI
feel instant), not literal transliteration of Flutter's Dart. Replicate
the behavior faithfully but reach it with the best well-supported native
mechanism (Room+Flow, Compose, WorkManager, Media3) rather than copying
drift watch() / Riverpod invalidate. A more native approach that improves
the UX is preferred — recorded as an intentional divergence in the parity
map.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Bryan Van Deusen
2026-05-28 08:23:29 -04:00
parent a37fe4c167
commit 942d7e88cc
1 changed files with 11 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+11 -4
View File
@@ -13,10 +13,17 @@ exists in Flutter:
opened the Flutter file in this session, you have not earned the right to opened the Flutter file in this session, you have not earned the right to
write the Android version. write the Android version.
2. **Replicate it exactly.** Match the behavior, the layout structure, the 2. **Replicate the user-visible behavior exactly; implement it idiomatically.**
section order, the empty/loading/error states, the copy strings, the data Match what the user sees and feels: layout structure, section order, empty/
sources, and the edge cases. Same number of rows, same fields per row, same loading/error states, copy strings, edge cases, and — critically — the
tap targets. **responsiveness** (the app caches to make the UI feel instant; preserve
that). But you do NOT have to copy Flutter's *implementation*. Flutter uses
drift `watch()` + Riverpod `invalidate`; the well-supported Android idioms
are Room + Flow, Compose state, WorkManager, Media3. **Prefer the native
mechanism that delivers the same or better UX** over a literal transliteration
of the Dart. Exact on behavior + feel; idiomatic on structure. If a more
native approach genuinely improves the experience, do that (and note it in
the parity map as an intentional, better-supported divergence).
3. **Never silently substitute a different design.** If the faithful port seems 3. **Never silently substitute a different design.** If the faithful port seems
hard, blocked, or impossible, STOP and verify by reading more of the Flutter hard, blocked, or impossible, STOP and verify by reading more of the Flutter