| Do | Use named slots (startContent, label, description, endContent) for the common layout. These cover the 80% case. |
| Do | Use density="compact" for menus and dense lists, "balanced" for standard rows, and "spacious" for roomier layouts. |
| Do | Set labelLines and descriptionLines to control truncation when content length varies. |
| Do | Use align="start" when start or end content is taller than a single line of text. |
| Don't | Don't nest interactive elements (buttons, links) inside an interactive XDSItem; it creates confusing focus and click targets. |
| Don't | Don't use XDSItem for navigation between views; use proper navigation components instead. |
| Don't | Don't add read/unread or inbox-specific behavior directly; compose a thin wrapper like XDSPreviewItem instead. |