Skip to content

docs(dsrn): ListItem performance audit (React parity decision) - #1434

Draft
georgewrmarshall wants to merge 2 commits into
mainfrom
docs/listitem-performance-audit
Draft

docs(dsrn): ListItem performance audit (React parity decision)#1434
georgewrmarshall wants to merge 2 commits into
mainfrom
docs/listitem-performance-audit

Conversation

@georgewrmarshall

Copy link
Copy Markdown
Contributor

Description

Adds a markdown performance/architecture audit for RN ListItem (and its Content / BoxRow / BoxColumn stack) based on Storybook + React DevTools nesting comparison against ActionListItem.

Motivation: before React parity (DSYS-1041 → BoxRow, DSYS-1042 → BoxColumn, DSYS-1043 → Content, DSYS-713 → ListItem), decide whether web should copy the RN composition stack or ship a flatter implementation with the same consumer API.

The doc recommends shared public props + flatter React implementation, and treating BoxRow/BoxColumn as optional helpers rather than required internals of Content.

Related issues

Fixes:

Related: DSYS-1041, DSYS-1042, DSYS-1043, DSYS-713 (parity queue)

Manual testing steps

  1. Open packages/design-system-react-native/src/components/ListItem/PERFORMANCE_AUDIT.md
  2. Optionally reproduce nesting in Storybook iOS: ListItem/End Accessory vs ActionListItem/End Accessory in React DevTools Components tab

Screenshots/Recordings

Before

N/A (docs only)

After

N/A (docs only) — evidence described from DevTools trees captured during audit

Pre-merge author checklist

  • I've followed MetaMask Contributor Docs
  • I've completed the PR template to the best of my ability
  • I’ve included tests if applicable
  • I’ve documented my code using JSDoc format if applicable

Pre-merge reviewer checklist

  • I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed).
  • I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.

Made with Cursor

georgewrmarshall and others added 2 commits August 7, 2026 09:27
Capture DevTools nesting findings vs ActionListItem and options for React
parity without necessarily copying BoxRow/BoxColumn/Content internals.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

📖 Storybook Links

Compare the preview for this pull request with the latest Storybooks from the main branch.

🔀 Pull Request Preview

🌳 Main Branch (Latest)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant