simplex-chat/apps/multiplatform/spec/impact.md

# SimpleX Chat Android & Desktop -- Impact Graph

> Source file to product concept mapping. Use this to identify which product documents must be updated when a source file changes.
>
> Covers Kotlin Multiplatform (Compose) sources: commonMain, androidMain, desktopMain, and the Android and Desktop app modules. Also covers the shared Haskell core.

---

## Product Concept Legend

| ID | Concept |
|----|---------|
| PC1 | Chat List |
| PC2 | Direct Chat |
| PC3 | Group Chat |
| PC4 | Message Composition |
| PC5 | Message Reactions |
| PC6 | Message Editing |
| PC7 | Message Deletion |
| PC8 | Timed Messages |
| PC9 | Voice Messages |
| PC10 | File Transfer |
| PC11 | Link Previews |
| PC12 | Contact Connection |
| PC13 | Contact Verification |
| PC14 | Group Management |
| PC15 | Group Links |
| PC16 | Member Roles |
| PC17 | Audio/Video Calls |
| PC18 | Notifications |
| PC19 | User Profiles |
| PC20 | Incognito Mode |
| PC21 | Hidden Profiles |
| PC22 | Local Authentication |
| PC23 | Database Encryption |
| PC24 | Theme System |
| PC25 | Network Configuration |
| PC26 | Device Migration |
| PC27 | Remote Desktop |
| PC28 | Chat Tags |
| PC29 | User Address |
| PC30 | Member Support Chat |

---

## 1. Common Sources (commonMain)

Path prefix: `common/src/commonMain/kotlin/chat/simplex/common/`

### 1.1 Core Model & Platform

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `App.kt` | PC1 through PC30 | High | Root composable — navigation scaffold for all features |
| `AppLock.kt` | PC22 | Medium | App lock state and authorization lifecycle |
| `model/ChatModel.kt` | PC1 through PC30 | High | Central state object — every feature reads or writes here |
| `model/SimpleXAPI.kt` | PC1 through PC30 | High | FFI bridge to Haskell core — all commands and responses |
| `model/CryptoFile.kt` | PC10, PC23 | Medium | Encrypted file read/write helpers |
| `platform/Core.kt` | PC1 through PC30 | High | Native FFI declarations (`chatMigrateInit`, `chatSendCmd`, etc.) — all API traffic |
| `platform/AppCommon.kt` | PC1 through PC30 | Medium | Shared app initialization logic |
| `platform/Files.kt` | PC10, PC23, PC26 | Medium | File path resolution, temp dirs, encryption utilities |
| `platform/NtfManager.kt` | PC18 | High | Notification manager expect declarations |
| `platform/Notifications.kt` | PC18 | Medium | Notification channel and permission abstractions |
| `platform/SimplexService.kt` | PC18 | Medium | Background service expect declarations |
| `platform/RecAndPlay.kt` | PC9 | Medium | Audio recording and playback abstractions |
| `platform/VideoPlayer.kt` | PC10, PC17 | Low | Video playback abstractions |
| `platform/Cryptor.kt` | PC23 | Medium | Keystore encryption expect declarations |
| `platform/Share.kt` | PC10, PC12 | Low | Share sheet abstractions |
| `platform/Images.kt` | PC10, PC19 | Low | Image processing utilities |
| `platform/Platform.kt` | PC1 through PC30 | Low | Platform detection and capability flags |
| `platform/PlatformTextField.kt` | PC4 | Low | Native text input expect declarations |
| `platform/Back.kt` | PC1 | Low | Back navigation handling |
| `platform/UI.kt` | PC24 | Low | UI density and locale helpers |
| `platform/ScrollableColumn.kt` | PC1 | Low | Scrollable list abstractions |
| `platform/Log.kt` | — | Low | Logging utility — no direct product impact |
| `platform/Modifier.kt` | PC24 | Low | Compose modifier extensions |
| `platform/Resources.kt` | PC24 | Low | Resource loading helpers |

### 1.2 Theme

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `ui/theme/ThemeManager.kt` | PC24 | Medium | Theme resolution engine — all color and wallpaper logic |
| `ui/theme/Theme.kt` | PC24 | Medium | Theme composables and `SimpleXTheme` |
| `ui/theme/Color.kt` | PC24 | Low | Color palette definitions |
| `ui/theme/Shape.kt` | PC24 | Low | Shape token definitions |
| `ui/theme/Type.kt` | PC24 | Low | Typography definitions |

### 1.3 Views — Chat List

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/chatlist/ChatListView.kt` | PC1, PC28 | High | Main screen — chat list rendering and search |
| `views/chatlist/ChatListNavLinkView.kt` | PC1, PC2, PC3 | Medium | Navigation from chat list item to chat |
| `views/chatlist/ChatPreviewView.kt` | PC1, PC2, PC3, PC11 | Medium | Chat row preview rendering |
| `views/chatlist/TagListView.kt` | PC28 | Medium | Chat tag filter UI |
| `views/chatlist/UserPicker.kt` | PC19, PC21 | Medium | Multi-profile switcher overlay |
| `views/chatlist/ShareListView.kt` | PC10 | Low | Share target list |
| `views/chatlist/ShareListNavLinkView.kt` | PC10 | Low | Share target navigation |
| `views/chatlist/ChatHelpView.kt` | PC1 | Low | Empty-state help content |
| `views/chatlist/ContactRequestView.kt` | PC12 | Medium | Incoming contact request row |
| `views/chatlist/ContactConnectionView.kt` | PC12 | Low | Pending connection row |
| `views/chatlist/ServersSummaryView.kt` | PC25 | Low | Server status summary |

### 1.4 Views — Chat & Messaging

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/chat/ChatView.kt` | PC2, PC3, PC4, PC5, PC6, PC7, PC8, PC9, PC11 | High | Core conversation UI — most messaging features |
| `views/chat/ComposeView.kt` | PC4, PC6, PC9, PC10, PC11 | High | Message composition — send path for all messages |
| `views/chat/SendMsgView.kt` | PC4, PC9 | Medium | Send button and voice record toggle |
| `views/chat/ComposeVoiceView.kt` | PC9 | Medium | Voice message recording UI |
| `views/chat/ComposeFileView.kt` | PC10 | Low | File attachment preview in compose area |
| `views/chat/ComposeImageView.kt` | PC10 | Low | Image attachment preview in compose area |
| `views/chat/ContextItemView.kt` | PC6 | Low | Reply/edit quote preview |
| `views/chat/SelectableChatItemToolbars.kt` | PC7, PC10 | Medium | Multi-select toolbar (delete, forward) |
| `views/chat/ChatInfoView.kt` | PC2, PC13, PC20 | Medium | Contact details and verification |
| `views/chat/ContactPreferences.kt` | PC2, PC8 | Medium | Per-contact feature preferences |
| `views/chat/ChatItemInfoView.kt` | PC2, PC3 | Low | Message delivery detail |
| `views/chat/ChatItemsLoader.kt` | PC2, PC3 | Medium | Pagination and message loading logic |
| `views/chat/ChatItemsMerger.kt` | PC2, PC3 | Medium | Merges incremental message updates |
| `views/chat/VerifyCodeView.kt` | PC13 | Medium | Contact security code verification |
| `views/chat/ScanCodeView.kt` | PC13 | Low | QR code scanning for verification |
| `views/chat/CommandsMenuView.kt` | PC4 | Low | Slash-command menu |
| `views/chat/ComposeContextProfilePickerView.kt` | PC20 | Low | Incognito profile picker in compose |
| `views/chat/ComposeContextPendingMemberActionsView.kt` | PC14, PC30 | Low | Pending member action buttons in compose |
| `views/chat/ComposeContextGroupDirectInvitationActionsView.kt` | PC14 | Low | Direct invitation action buttons in compose |
| `views/chat/ComposeContextContactRequestActionsView.kt` | PC12 | Low | Contact request action buttons in compose |

### 1.5 Views — Chat Items

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/chat/item/ChatItemView.kt` | PC2, PC3, PC5, PC6, PC7, PC8 | High | Root chat item renderer with context menus |
| `views/chat/item/TextItemView.kt` | PC2, PC3, PC4 | Medium | Text message bubble rendering |
| `views/chat/item/FramedItemView.kt` | PC4, PC6, PC10, PC11 | Medium | Framed (quoted/forwarded) message container |
| `views/chat/item/CIImageView.kt` | PC10 | Medium | Image message rendering |
| `views/chat/item/CIVideoView.kt` | PC10 | Medium | Video message rendering |
| `views/chat/item/CIFileView.kt` | PC10 | Medium | File message rendering |
| `views/chat/item/CIVoiceView.kt` | PC9 | Medium | Voice message rendering and playback |
| `views/chat/item/EmojiItemView.kt` | PC5 | Low | Emoji reaction display |
| `views/chat/item/CIMetaView.kt` | PC2, PC3, PC8 | Low | Timestamp, delivery status, timed message indicator |
| `views/chat/item/CICallItemView.kt` | PC17 | Low | Call event item rendering |
| `views/chat/item/CIEventView.kt` | PC3, PC14, PC16 | Low | Group event item rendering |
| `views/chat/item/CIGroupInvitationView.kt` | PC3, PC14 | Low | Group invitation item rendering |
| `views/chat/item/CIMemberCreatedContactView.kt` | PC3, PC12 | Low | Member-created contact event |
| `views/chat/item/CIChatFeatureView.kt` | PC8 | Low | Feature change event rendering |
| `views/chat/item/CIFeaturePreferenceView.kt` | PC8 | Low | Feature preference change rendering |
| `views/chat/item/CIRcvDecryptionError.kt` | PC2, PC3 | Low | Decryption error display |
| `views/chat/item/DeletedItemView.kt` | PC7 | Low | Deleted message placeholder |
| `views/chat/item/MarkedDeletedItemView.kt` | PC7 | Low | Moderated/marked-deleted placeholder |
| `views/chat/item/ImageFullScreenView.kt` | PC10 | Low | Full-screen image viewer |
| `views/chat/item/CIBrokenComposableView.kt` | — | Low | Fallback for render failures |
| `views/chat/item/CIInvalidJSONView.kt` | — | Low | Fallback for malformed items |
| `views/chat/item/IntegrityErrorItemView.kt` | PC2, PC3 | Low | Message integrity error display |

### 1.6 Views — Groups

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/chat/group/GroupChatInfoView.kt` | PC3, PC14, PC15, PC16, PC30 | High | Group management hub |
| `views/chat/group/AddGroupMembersView.kt` | PC14, PC16 | Medium | Member invitation flow |
| `views/chat/group/GroupMemberInfoView.kt` | PC3, PC14, PC16, PC30 | Medium | Member details and role management |
| `views/chat/group/GroupProfileView.kt` | PC3, PC14 | Medium | Group profile editing |
| `views/chat/group/GroupLinkView.kt` | PC15 | Low | Group link creation and sharing |
| `views/chat/group/GroupPreferences.kt` | PC3, PC8, PC14 | Medium | Group feature toggles |
| `views/chat/group/GroupMentions.kt` | PC3, PC4 | Medium | @mention resolution and display |
| `views/chat/group/GroupMembersToolbar.kt` | PC3, PC14 | Low | Member list toolbar |
| `views/chat/group/GroupReportsView.kt` | PC3, PC14 | Low | Group content reports |
| `views/chat/group/MemberAdmission.kt` | PC14, PC16 | Medium | Member admission settings |
| `views/chat/group/MemberSupportView.kt` | PC30 | Medium | Member support chat toggle |
| `views/chat/group/MemberSupportChatView.kt` | PC30 | Medium | Member support chat conversation |
| `views/chat/group/WelcomeMessageView.kt` | PC3, PC14 | Low | Group welcome message editor |

### 1.7 Views — Calls

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/call/CallView.kt` | PC17 | High | Call UI and WebRTC composable |
| `views/call/CallManager.kt` | PC17 | High | Call lifecycle management |
| `views/call/WebRTC.kt` | PC17 | High | WebRTC types and signaling |
| `views/call/IncomingCallAlertView.kt` | PC17, PC18 | Medium | Incoming call overlay |

### 1.8 Views — New Chat & Contacts

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/newchat/NewChatView.kt` | PC12, PC29 | High | New connection creation — onramp for all contacts |
| `views/newchat/NewChatSheet.kt` | PC12 | Medium | Bottom sheet with connection options |
| `views/newchat/ConnectPlan.kt` | PC12, PC15 | Medium | Link parsing and connection plan resolution |
| `views/newchat/AddGroupView.kt` | PC3, PC14 | Medium | New group creation flow |
| `views/newchat/ContactConnectionInfoView.kt` | PC12 | Low | Pending connection details |
| `views/newchat/AddContactLearnMore.kt` | PC12 | Low | Educational content |
| `views/newchat/QRCode.kt` | PC12 | Low | QR code display |
| `views/newchat/QRCodeScanner.kt` | PC12 | Low | QR code camera scanner |
| `views/contacts/ContactListNavView.kt` | PC1, PC12 | Medium | Contact list navigation |
| `views/contacts/ContactPreviewView.kt` | PC12 | Low | Contact row preview |

### 1.9 Views — User Settings

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/usersettings/SettingsView.kt` | PC18, PC22, PC23, PC24, PC25, PC29 | Medium | Settings navigation hub |
| `views/usersettings/Appearance.kt` | PC24 | Low | Theme and appearance customization |
| `views/usersettings/PrivacySettings.kt` | PC20, PC22 | Medium | Privacy and lock settings |
| `views/usersettings/UserProfileView.kt` | PC19 | Medium | Profile display name and image editing |
| `views/usersettings/UserProfilesView.kt` | PC19, PC21 | Medium | Multi-profile management |
| `views/usersettings/HiddenProfileView.kt` | PC21 | Medium | Hidden profile access |
| `views/usersettings/IncognitoView.kt` | PC20 | Low | Incognito mode explanation |
| `views/usersettings/UserAddressView.kt` | PC29 | Medium | User SimpleX address management |
| `views/usersettings/UserAddressLearnMore.kt` | PC29 | Low | Address educational content |
| `views/usersettings/NotificationsSettingsView.kt` | PC18 | Medium | Notification mode configuration |
| `views/usersettings/CallSettings.kt` | PC17 | Low | Call-related settings |
| `views/usersettings/Preferences.kt` | PC2, PC3, PC8 | Medium | Chat feature preferences UI |
| `views/usersettings/SetDeliveryReceiptsView.kt` | PC2 | Low | Delivery receipts toggle |
| `views/usersettings/RTCServers.kt` | PC17, PC25 | Medium | WebRTC ICE server configuration |
| `views/usersettings/DeveloperView.kt` | — | Low | Developer/debug settings |
| `views/usersettings/HelpView.kt` | — | Low | Help and support links |
| `views/usersettings/MarkdownHelpView.kt` | PC4 | Low | Markdown formatting guide |
| `views/usersettings/VersionInfoView.kt` | — | Low | Version display |
| `views/usersettings/networkAndServers/NetworkAndServers.kt` | PC25 | High | Server and network configuration hub |
| `views/usersettings/networkAndServers/AdvancedNetworkSettings.kt` | PC25 | Medium | SOCKS proxy, timeouts, etc. |
| `views/usersettings/networkAndServers/OperatorView.kt` | PC25 | Medium | Server operator management |
| `views/usersettings/networkAndServers/ProtocolServersView.kt` | PC25 | Medium | SMP/XFTP server list |
| `views/usersettings/networkAndServers/ProtocolServerView.kt` | PC25 | Low | Individual server editing |
| `views/usersettings/networkAndServers/NewServerView.kt` | PC25 | Low | Add new server |
| `views/usersettings/networkAndServers/ScanProtocolServer.kt` | PC25 | Low | QR scan for server address |

### 1.10 Views — Database & Migration

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/database/DatabaseView.kt` | PC23, PC26 | High | Database management — export, import, passphrase |
| `views/database/DatabaseEncryptionView.kt` | PC23 | High | Database encryption passphrase change |
| `views/database/DatabaseErrorView.kt` | PC23 | Medium | Database open error recovery |
| `views/migration/MigrateFromDevice.kt` | PC26 | High | Outbound device migration |
| `views/migration/MigrateToDevice.kt` | PC26 | High | Inbound device migration |

### 1.11 Views — Local Auth & Onboarding

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/localauth/LocalAuthView.kt` | PC22 | Medium | App lock authentication flow |
| `views/localauth/SetAppPasscodeView.kt` | PC22 | Medium | Passcode creation and change |
| `views/localauth/PasscodeView.kt` | PC22 | Medium | Passcode entry UI |
| `views/localauth/PasswordEntry.kt` | PC22 | Low | Password input field |
| `views/onboarding/OnboardingView.kt` | PC1 | Medium | Onboarding flow navigation |
| `views/onboarding/SimpleXInfo.kt` | PC1 | Low | Welcome screen |
| `views/onboarding/SetNotificationsMode.kt` | PC18 | Medium | Notification permission and mode setup |
| `views/onboarding/SetupDatabasePassphrase.kt` | PC23 | Medium | Initial database passphrase setup |
| `views/onboarding/ChooseServerOperators.kt` | PC25 | Medium | Initial server operator selection |
| `views/onboarding/WhatsNewView.kt` | — | Low | Release notes display |
| `views/onboarding/HowItWorks.kt` | — | Low | Educational content |
| `views/onboarding/LinkAMobileView.kt` | PC27 | Low | Mobile linking onboarding |

### 1.12 Views — Remote Desktop

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/remote/ConnectDesktopView.kt` | PC27 | Medium | Connect-to-desktop flow (from mobile) |
| `views/remote/ConnectMobileView.kt` | PC27 | Medium | Connect-to-mobile flow (from desktop) |

### 1.13 Views — Helpers

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/helpers/AlertManager.kt` | PC1 through PC30 | Medium | Modal alert system used across all features |
| `views/helpers/ModalView.kt` | PC1 through PC30 | Medium | Modal navigation stack |
| `views/helpers/Utils.kt` | PC1 through PC30 | Low | Shared formatting, clipboard, and utility functions |
| `views/helpers/DatabaseUtils.kt` | PC23 | Medium | Keystore passphrase and database helpers |
| `views/helpers/LinkPreviews.kt` | PC11 | Medium | Link preview fetching and rendering |
| `views/helpers/LocalAuthentication.kt` | PC22 | Medium | Biometric/passcode authentication expect |
| `views/helpers/ChatWallpaper.kt` | PC24 | Low | Chat wallpaper rendering |
| `views/helpers/ChatInfoImage.kt` | PC19 | Low | Profile image composable |
| `views/helpers/ThemeModeEditor.kt` | PC24 | Low | Theme mode toggle |
| `views/helpers/ChooseAttachmentView.kt` | PC10 | Low | Attachment picker |
| `views/helpers/GetImageView.kt` | PC10, PC19 | Low | Image capture and crop |
| `views/helpers/TextEditor.kt` | PC4 | Low | Rich text editor helpers |
| `views/helpers/SearchTextField.kt` | PC1 | Low | Search bar composable |
| `views/helpers/CustomTimePicker.kt` | PC8 | Low | Time picker for timed messages |
| `views/helpers/DragAndDrop.kt` | PC10 | Low | Drag-and-drop file handling |
| `views/helpers/ProcessedErrors.kt` | — | Low | Error aggregation |
| `views/helpers/AnimationUtils.kt` | PC24 | Low | Animation helpers |
| `views/helpers/DefaultDialog.kt` | — | Low | Dialog composable primitives |
| `views/helpers/DefaultDropdownMenu.kt` | — | Low | Dropdown menu composable |
| `views/helpers/Section.kt` | — | Low | Settings section composable |
| `views/helpers/SimpleButton.kt` | — | Low | Button composable |
| `views/helpers/DefaultTopAppBar.kt` | — | Low | App bar composable |
| `views/helpers/DefaultBasicTextField.kt` | PC4 | Low | Text field composable |
| `views/helpers/AppBarTitle.kt` | — | Low | App bar title composable |
| `views/helpers/BlurModifier.kt` | PC22 | Low | Blur modifier for app lock |
| `views/helpers/CollapsingAppBar.kt` | — | Low | Collapsing toolbar composable |
| `views/helpers/CustomIcons.kt` | — | Low | Custom icon definitions |
| `views/helpers/DataClasses.kt` | — | Low | Shared data class utilities |
| `views/helpers/DefaultProgressBar.kt` | — | Low | Progress bar composable |
| `views/helpers/DefaultSwitch.kt` | — | Low | Switch composable |
| `views/helpers/Enums.kt` | — | Low | Enum utility extensions |
| `views/helpers/ExposedDropDownSettingRow.kt` | — | Low | Dropdown setting row composable |
| `views/helpers/GestureDetector.kt` | — | Low | Touch gesture utilities |
| `views/helpers/Modifiers.kt` | — | Low | Compose modifier extensions |
| `views/helpers/SubscriptionStatusIcon.kt` | PC25 | Low | Server connection status icon |

### 1.14 Views — Other

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `views/TerminalView.kt` | — | Low | Developer chat console |
| `views/SplashView.kt` | — | Low | Splash screen |
| `views/WelcomeView.kt` | PC1 | Low | Empty-state welcome |
| `views/Preview.kt` | — | Low | Compose preview utilities |

---

## 2. Android Sources

### 2.1 Android App Module

Path prefix: `android/src/main/java/chat/simplex/app/`

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `SimplexApp.kt` | PC1 through PC30 | High | Application class — initializes core, preferences, and notification channels |
| `MainActivity.kt` | PC1 through PC30 | High | Single-activity host — intent handling, lifecycle, deep links |
| `SimplexService.kt` | PC18 | High | Foreground service — keeps message receiver alive |
| `CallService.kt` | PC17 | Medium | Foreground service for active calls |
| `MessagesFetcherWorker.kt` | PC18 | Medium | WorkManager periodic message fetch |
| `model/NtfManager.android.kt` | PC18 | High | Android notification channels, display, and actions |
| `views/call/CallActivity.kt` | PC17 | Medium | Dedicated activity for full-screen call UI |
| `views/helpers/Util.kt` | — | Low | Android-specific utility extensions |

### 2.2 Android Platform Implementations (androidMain)

Path prefix: `common/src/androidMain/kotlin/chat/simplex/common/`

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `platform/AppCommon.android.kt` | PC1 through PC30 | Medium | Android app initialization actual declarations |
| `platform/SimplexService.android.kt` | PC18 | Medium | Android foreground service actual implementation |
| `platform/Files.android.kt` | PC10, PC23, PC26 | Medium | Android file paths and content-URI resolution |
| `platform/Cryptor.android.kt` | PC23 | Medium | Android Keystore encryption actual implementation |
| `platform/RecAndPlay.android.kt` | PC9 | Medium | Android MediaRecorder/MediaPlayer actual implementation |
| `platform/VideoPlayer.android.kt` | PC10 | Low | Android ExoPlayer actual implementation |
| `platform/Notifications.android.kt` | PC18 | Medium | Android notification channel creation |
| `platform/Images.android.kt` | PC10, PC19 | Low | Android bitmap processing |
| `platform/PlatformTextField.android.kt` | PC4 | Low | Android native text field actual implementation |
| `platform/Share.android.kt` | PC10 | Low | Android share intent actual implementation |
| `platform/Back.android.kt` | PC1 | Low | Android back press handler |
| `platform/UI.android.kt` | PC24 | Low | Android density and locale |
| `platform/ScrollableColumn.android.kt` | PC1 | Low | Android lazy list actual implementation |
| `platform/Log.android.kt` | — | Low | Android Log wrapper |
| `platform/Modifier.android.kt` | — | Low | Android modifier extensions |
| `platform/Resources.android.kt` | — | Low | Android resource loading |
| `helpers/NetworkObserver.kt` | PC25 | Medium | Android ConnectivityManager observer |
| `helpers/Permissions.kt` | PC9, PC10, PC17, PC18 | Medium | Android runtime permission requests |
| `helpers/SoundPlayer.kt` | PC17, PC18 | Low | Android sound playback for calls and notifications |
| `helpers/Extensions.kt` | — | Low | Kotlin extension utilities |
| `helpers/Locale.kt` | — | Low | Locale helpers |
| `views/call/CallView.android.kt` | PC17 | Medium | Android WebView-based WebRTC call |
| `views/call/CallAudioDeviceManager.kt` | PC17 | Medium | Android audio routing (speaker, earpiece, bluetooth) |
| `views/chat/ComposeView.android.kt` | PC4, PC10 | Low | Android compose view extensions |
| `views/chat/SendMsgView.android.kt` | PC4 | Low | Android send button extensions |
| `views/chat/item/ChatItemView.android.kt` | PC2, PC3 | Low | Android chat item extensions |
| `views/chat/item/CIImageView.android.kt` | PC10 | Low | Android image rendering extensions |
| `views/chat/item/CIVideoView.android.kt` | PC10 | Low | Android video rendering extensions |
| `views/chat/item/CIFileView.android.kt` | PC10 | Low | Android file view extensions |
| `views/chat/item/EmojiItemView.android.kt` | PC5 | Low | Android emoji rendering extensions |
| `views/chat/item/ImageFullScreenView.android.kt` | PC10 | Low | Android full-screen image viewer |
| `views/chatlist/ChatListView.android.kt` | PC1 | Low | Android chat list extensions |
| `views/chatlist/ChatListNavLinkView.android.kt` | PC1 | Low | Android chat list navigation extensions |
| `views/chatlist/TagListView.android.kt` | PC28 | Low | Android tag list extensions |
| `views/chatlist/UserPicker.android.kt` | PC19 | Low | Android profile picker extensions |
| `views/database/DatabaseView.android.kt` | PC23, PC26 | Low | Android database view extensions |
| `views/database/DatabaseEncryptionView.android.kt` | PC23 | Low | Android encryption view extensions |
| `views/helpers/LocalAuthentication.android.kt` | PC22 | Medium | Android BiometricPrompt actual implementation |
| `views/helpers/ChooseAttachmentView.android.kt` | PC10 | Low | Android file/camera chooser |
| `views/helpers/GetImageView.android.kt` | PC10, PC19 | Low | Android image capture |
| `views/helpers/CustomTimePicker.android.kt` | PC8 | Low | Android time picker |
| `views/helpers/Utils.android.kt` | — | Low | Android utility extensions |
| `views/helpers/DefaultDialog.android.kt` | — | Low | Android dialog extensions |
| `views/helpers/WorkaroundFocusSearchLayout.kt` | — | Low | Android focus workaround |
| `views/newchat/QRCode.android.kt` | PC12 | Low | Android QR code rendering |
| `views/newchat/QRCodeScanner.android.kt` | PC12 | Low | Android camera QR scanner |
| `views/onboarding/SimpleXInfo.android.kt` | PC1 | Low | Android onboarding extensions |
| `views/onboarding/SetNotificationsMode.android.kt` | PC18 | Low | Android notification mode extensions |
| `views/usersettings/Appearance.android.kt` | PC24 | Low | Android appearance extensions |
| `views/usersettings/PrivacySettings.android.kt` | PC20, PC22 | Low | Android privacy settings extensions |
| `views/usersettings/SettingsView.android.kt` | — | Low | Android settings extensions |
| `views/usersettings/networkAndServers/OperatorView.android.kt` | PC25 | Low | Android operator view extensions |
| `views/usersettings/networkAndServers/ScanProtocolServer.android.kt` | PC25 | Low | Android server QR scan |
| `ui/theme/Theme.android.kt` | PC24 | Low | Android dynamic color / system theme |
| `ui/theme/Type.android.kt` | PC24 | Low | Android typography |

---

## 3. Desktop Sources

### 3.1 Desktop App Module

Path prefix: `desktop/src/jvmMain/kotlin/chat/simplex/desktop/`

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `Main.kt` | PC1 through PC30 | High | JVM entry point — Haskell init, migrations, app launch |

### 3.2 Desktop Platform Implementations (desktopMain)

Path prefix: `common/src/desktopMain/kotlin/chat/simplex/common/`

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `DesktopApp.kt` | PC1, PC2, PC3 | High | Desktop Compose window — window lifecycle, crash recovery |
| `StoreWindowState.kt` | — | Low | Window position/size persistence |
| `model/NtfManager.desktop.kt` | PC18 | Medium | Desktop system tray notification display |
| `platform/AppCommon.desktop.kt` | PC1 through PC30 | Medium | Desktop app initialization actual declarations |
| `platform/SimplexService.desktop.kt` | PC18 | Low | Desktop background receiver (no foreground service) |
| `platform/Files.desktop.kt` | PC10, PC23, PC26 | Medium | Desktop file path resolution |
| `platform/Cryptor.desktop.kt` | PC23 | Medium | Desktop keystore encryption actual implementation |
| `platform/RecAndPlay.desktop.kt` | PC9 | Medium | Desktop audio recording/playback actual implementation |
| `platform/VideoPlayer.desktop.kt` | PC10 | Low | Desktop VLC-based video player |
| `platform/Videos.desktop.kt` | PC10 | Low | Desktop video utilities |
| `platform/Notifications.desktop.kt` | PC18 | Low | Desktop notification setup |
| `platform/Images.desktop.kt` | PC10 | Low | Desktop image processing |
| `platform/PlatformTextField.desktop.kt` | PC4 | Low | Desktop text field actual implementation |
| `platform/Share.desktop.kt` | PC10 | Low | Desktop clipboard/share |
| `platform/Back.desktop.kt` | PC1 | Low | Desktop back navigation |
| `platform/UI.desktop.kt` | PC24 | Low | Desktop density and locale |
| `platform/ScrollableColumn.desktop.kt` | PC1 | Low | Desktop lazy list |
| `platform/Platform.desktop.kt` | — | Low | Platform detection |
| `platform/Log.desktop.kt` | — | Low | Desktop log output |
| `platform/Modifier.desktop.kt` | — | Low | Desktop modifier extensions |
| `platform/Resources.desktop.kt` | — | Low | Desktop resource loading |
| `views/call/CallView.desktop.kt` | PC17 | Medium | Desktop WebView-based WebRTC call |
| `views/chat/ComposeView.desktop.kt` | PC4, PC10 | Low | Desktop compose view (drag-and-drop, paste) |
| `views/chat/SendMsgView.desktop.kt` | PC4 | Low | Desktop send shortcut (Enter key handling) |
| `views/chat/item/ChatItemView.desktop.kt` | PC2, PC3 | Low | Desktop chat item extensions |
| `views/chat/item/CIImageView.desktop.kt` | PC10 | Low | Desktop image rendering |
| `views/chat/item/CIVideoView.desktop.kt` | PC10 | Low | Desktop video rendering |
| `views/chat/item/CIFileView.desktop.kt` | PC10 | Low | Desktop file open/save |
| `views/chat/item/EmojiItemView.desktop.kt` | PC5 | Low | Desktop emoji rendering |
| `views/chat/item/ImageFullScreenView.desktop.kt` | PC10 | Low | Desktop full-screen image |
| `views/chatlist/ChatListView.desktop.kt` | PC1 | Low | Desktop chat list extensions |
| `views/chatlist/ChatListNavLinkView.desktop.kt` | PC1 | Low | Desktop chat list navigation |
| `views/chatlist/TagListView.desktop.kt` | PC28 | Low | Desktop tag list extensions |
| `views/chatlist/UserPicker.desktop.kt` | PC19 | Low | Desktop profile picker |
| `views/database/DatabaseView.desktop.kt` | PC23, PC26 | Low | Desktop database view extensions |
| `views/database/DatabaseEncryptionView.desktop.kt` | PC23 | Low | Desktop encryption view extensions |
| `views/helpers/AppUpdater.kt` | — | Low | Desktop auto-update checker and installer |
| `views/helpers/OkHttpProgressListener.kt` | — | Low | Download progress tracking for updates |
| `views/helpers/LocalAuthentication.desktop.kt` | PC22 | Low | Desktop passcode-only auth (no biometrics) |
| `views/helpers/ChooseAttachmentView.desktop.kt` | PC10 | Low | Desktop file chooser dialog |
| `views/helpers/GetImageView.desktop.kt` | PC10, PC19 | Low | Desktop image file picker |
| `views/helpers/CustomTimePicker.desktop.kt` | PC8 | Low | Desktop time picker |
| `views/helpers/Utils.desktop.kt` | — | Low | Desktop utility extensions |
| `views/helpers/DefaultDialog.desktop.kt` | — | Low | Desktop dialog extensions |
| `views/newchat/QRCode.desktop.kt` | PC12 | Low | Desktop QR code rendering |
| `views/newchat/QRCodeScanner.desktop.kt` | PC12 | Low | Desktop QR code scanner (screen/clipboard) |
| `views/onboarding/SimpleXInfo.desktop.kt` | PC1 | Low | Desktop onboarding extensions |
| `views/onboarding/SetNotificationsMode.desktop.kt` | PC18 | Low | Desktop notification mode extensions |
| `views/usersettings/Appearance.desktop.kt` | PC24 | Low | Desktop appearance extensions |
| `views/usersettings/PrivacySettings.desktop.kt` | PC20, PC22 | Low | Desktop privacy settings extensions |
| `views/usersettings/SettingsView.desktop.kt` | — | Low | Desktop settings extensions |
| `views/usersettings/networkAndServers/OperatorView.desktop.kt` | PC25 | Low | Desktop operator view extensions |
| `views/usersettings/networkAndServers/ScanProtocolServer.desktop.kt` | PC25 | Low | Desktop server address scan |
| `ui/theme/Theme.desktop.kt` | PC24 | Low | Desktop system theme detection |
| `ui/theme/Type.desktop.kt` | PC24 | Low | Desktop typography |
| `other/videoplayer/SkiaBitmapVideoSurface.kt` | PC10 | Low | Desktop Skia video surface for VLC |

---

## 4. Haskell Core Impact

The Haskell core is compiled as a shared native library (`libsimplex.so` / `libsimplex.dylib`) and linked via JNI through `Core.kt`. Changes here affect both Android and Desktop identically.

| Source File | Product Concepts Affected | Risk Level | Notes |
|-------------|--------------------------|------------|-------|
| `src/Simplex/Chat.hs` | PC1 through PC30 | High | Main chat module — top-level orchestration |
| `src/Simplex/Chat/Controller.hs` | PC1 through PC30 | High | Command processor — all API commands dispatched here |
| `src/Simplex/Chat/Types.hs` | PC1 through PC30 | High | Core data types shared across all features |
| `src/Simplex/Chat/Core.hs` | PC1 through PC30 | High | Chat engine lifecycle (start, stop, subscribe) |
| `src/Simplex/Chat/Library/Commands.hs` | PC1 through PC30 | High | API command handler implementations |
| `src/Simplex/Chat/Library/Internal.hs` | PC1 through PC30 | High | Internal helpers for command processing |
| `src/Simplex/Chat/Library/Subscriber.hs` | PC1 through PC30 | High | Event subscriber — incoming message routing |
| `src/Simplex/Chat/Protocol.hs` | PC2, PC3, PC4, PC5, PC6, PC7 | High | Chat-level message protocol (x-events) |
| `src/Simplex/Chat/Messages.hs` | PC2, PC3, PC4, PC5, PC6, PC7, PC8, PC9 | High | Message types and content |
| `src/Simplex/Chat/Messages/CIContent.hs` | PC4, PC5, PC6, PC7, PC8, PC9, PC11 | Medium | Chat item content variants |
| `src/Simplex/Chat/Messages/CIContent/Events.hs` | PC3, PC14, PC16 | Medium | Group event content types |
| `src/Simplex/Chat/Messages/Batch.hs` | PC2, PC3, PC4 | Medium | Message batching for efficient delivery |
| `src/Simplex/Chat/Call.hs` | PC17 | Medium | Call signaling types |
| `src/Simplex/Chat/Files.hs` | PC10 | Medium | File transfer orchestration |
| `src/Simplex/Chat/Delivery.hs` | PC2, PC3 | Medium | Message delivery engine |
| `src/Simplex/Chat/Markdown.hs` | PC4 | Low | Markdown parsing for message formatting |
| `src/Simplex/Chat/Store.hs` | PC1 through PC30 | High | Database store interface |
| `src/Simplex/Chat/Store/Shared.hs` | PC1 through PC30 | Medium | Shared store utilities |
| `src/Simplex/Chat/Store/Messages.hs` | PC4, PC5, PC6, PC7, PC8 | High | Message persistence |
| `src/Simplex/Chat/Store/Groups.hs` | PC3, PC14, PC15, PC16, PC30 | High | Group persistence |
| `src/Simplex/Chat/Store/Direct.hs` | PC2, PC12, PC13 | High | Contact persistence |
| `src/Simplex/Chat/Store/Files.hs` | PC10 | Medium | File transfer persistence |
| `src/Simplex/Chat/Store/Profiles.hs` | PC19, PC21 | Medium | User profile persistence |
| `src/Simplex/Chat/Store/Connections.hs` | PC2, PC12 | High | Connection persistence and entity resolution |
| `src/Simplex/Chat/Store/ContactRequest.hs` | PC12 | Medium | Contact request persistence |
| `src/Simplex/Chat/Store/NoteFolders.hs` | PC1 | Low | Note folder (self-chat) persistence |
| `src/Simplex/Chat/Store/Delivery.hs` | PC2, PC3 | Medium | Delivery task persistence |
| `src/Simplex/Chat/Store/AppSettings.hs` | PC25 | Low | App settings persistence |
| `src/Simplex/Chat/Store/Remote.hs` | PC27 | Low | Remote desktop session persistence |
| `src/Simplex/Chat/Archive.hs` | PC26 | Medium | Database export/import for migration |
| `src/Simplex/Chat/Options.hs` | PC23, PC25 | Low | Startup options (DB path, key, etc.) |
| `src/Simplex/Chat/Remote.hs` | PC27 | Medium | Remote desktop protocol handler |
| `src/Simplex/Chat/Remote/Types.hs` | PC27 | Low | Remote desktop data types |
| `src/Simplex/Chat/Remote/Protocol.hs` | PC27 | Medium | Remote desktop wire protocol |
| `src/Simplex/Chat/Remote/Transport.hs` | PC27 | Low | Remote desktop transport layer |
| `src/Simplex/Chat/Remote/RevHTTP.hs` | PC27 | Low | Reverse HTTP for remote desktop |
| `src/Simplex/Chat/Remote/AppVersion.hs` | PC27 | Low | Remote version negotiation |
| `src/Simplex/Chat/ProfileGenerator.hs` | PC20 | Low | Random profile generation for incognito |
| `src/Simplex/Chat/Types/UITheme.hs` | PC24 | Low | Theme data types for UI customization |
| `src/Simplex/Chat/Types/Preferences.hs` | PC2, PC3, PC8 | Medium | Chat feature preferences (timed messages, etc.) |
| `src/Simplex/Chat/Types/Shared.hs` | PC3, PC16 | Medium | Shared types including GroupMemberRole |
| `src/Simplex/Chat/Types/MemberRelations.hs` | PC3, PC16, PC30 | Medium | Member relationship state machine |
| `src/Simplex/Chat/Operators.hs` | PC25 | Medium | Server operator management |
| `src/Simplex/Chat/Operators/Presets.hs` | PC25 | Low | Preset server operators |
| `src/Simplex/Chat/Operators/Conditions.hs` | PC25 | Low | Operator usage conditions |
| `src/Simplex/Chat/AppSettings.hs` | PC25 | Low | App settings sync types |
| `src/Simplex/Chat/Mobile.hs` | PC1 through PC30 | High | C FFI exports — JNI bridge target |
| `src/Simplex/Chat/Mobile/File.hs` | PC10 | Medium | Mobile file read/write FFI |
| `src/Simplex/Chat/Mobile/Shared.hs` | PC1 through PC30 | Medium | Shared FFI helpers |
| `src/Simplex/Chat/Mobile/WebRTC.hs` | PC17 | Low | WebRTC FFI helpers |
| `src/Simplex/Chat/View.hs` | PC1 through PC30 | Low | Terminal view rendering (not used by mobile/desktop UI) |
| `src/Simplex/Chat/Stats.hs` | PC25 | Low | Server statistics tracking |
| `src/Simplex/Chat/Util.hs` | — | Low | General Haskell utilities |
| `src/Simplex/Chat/Styled.hs` | — | Low | Terminal styled text (not used by mobile/desktop UI) |
| `src/Simplex/Chat/Help.hs` | — | Low | Terminal help text |
| `src/Simplex/Chat/Bot.hs` | — | Low | Chat bot framework |
| `src/Simplex/Chat/Bot/KnownContacts.hs` | — | Low | Bot known contacts |