RIPDPI: Skill for Claude Code

Protobuf DataStore

Overview

RIPDPI persists all app settings as a single Protobuf message (AppSettings) stored via Jetpack DataStore. The schema is the source of truth for all configurable values.

Key Files

Adding a New Setting

1. Add field to proto schema (app_settings.proto):

   bool your_new_setting = <next_field_number>;
   

   Use next available field number. Never reuse or renumber existing fields.

2. Set default in serializer (AppSettingsSerializer.kt):

   override val defaultValue: AppSettings = AppSettings.newBuilder()
       // ... existing defaults ...
       .setYourNewSetting(false)
       .build()
   

3. Expose in UI state (SettingsUiState or ConnectionDraft):

   data class SettingsUiState(
       // ... existing fields ...
       val yourNewSetting: Boolean = false,
   )
   

4. Map in conversion function (AppSettings.toUiState() or toConfigDraft()):

   fun AppSettings.toUiState() = SettingsUiState(
       // ... existing mappings ...
       yourNewSetting = this.yourNewSetting,
   )
   

5. Persist changes via DataStore:

   context.settingsStore.updateData { current ->
       current.toBuilder().setYourNewSetting(value).build()
   }
   

Reading Settings

// Reactive (preferred): Flow<AppSettings>
context.settingsStore.data.collect { settings ->
    val value = settings.yourSetting
}

// In ViewModel: combine with other flows
val uiState = combine(application.settingsStore.data, otherFlow) { settings, other ->
    UiState(setting = settings.yourSetting, /* ... */)
}.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5_000), UiState())