tomevault-io Jetpack Compose Standards
Priority: P0
Implementation Guidelines
State Hoisting
- Pattern:
Screen(Stateful) ->Content(Stateless). - Events: Pass lambda callbacks down (
onItemClick: (Id) -> Unit). - Dependencies: NEVER pass ViewModel to stateless composables.
Performance
- Recomposition: Use
@Stable/@Immutableon UI Models. - Lists: Always use
keyinLazyColumn/LazyRow. - Modifiers: Reuse Modifier instances or extract to variables if stable.
Theming (Material 3)
- Tokens: Use
MaterialTheme.colorSchemeandMaterialTheme.typography. - Hardcoding:
**No Hardcoded Colors**: Use Theme.
Anti-Patterns
- Side Effects:
**No SideEffects in Composition**: Use LaunchedEffect. - ViewModel pass-through:
**No VM deep pass**: Hoist state.
References
- Patterns & Optimization
Converted and distributed by TomeVault — claim your Tome and manage your conversions.