Android Persistence

Standards for Room Database and DataStore

majiayu000 13e06e2 2 files · 1.6 KB Updated 567 repo stars

File contents

Android Persistence Standards

Priority: P0

Implementation Guidelines

Room

  • Async: Return Flow<List<T>> for queries, use suspend for Write/Insert.
  • Entities: Keep simple @Entity data classes. Map to Domain models in Repository.
  • Transactions: Use @Transaction for multi-table queries (Relations).

DataStore

  • Usage: Replace SharedPreferences with ProtoDataStore (Type-safe) or PreferencesDataStore.
  • Scope: Inject singleton instance via Hilt.

Anti-Patterns

  • Main Thread: **No IO on Main**: Use Dispatchers.IO (Room helper does this, but verify flow collection).
  • Domain Leak: **No Entities in UI**: Map to Domain/UI Models.

References

  • DAO Templates

majiayu000/claude-skill-registry-data/tree/main/data/persistence commit 13e06e2e50

Frequently asked questions

npx skillmds add majiayu000/android-persistence