mirror of https://github.com/simplex-chat/simplex-chat.git synced 2026-06-09 10:43:02 +00:00

Files

T

Narasimha-sc bf905eb545 ui: settings navigation reorganization (#7005 )

* android, desktop: settings navigation reorganization

Restructure the root Settings screen into two top-level sections and
fold previously-scattered items into three new sub-screens.

Root:
- Appearance, Your privacy, Chat data
- Help & support, Migrate to another device, Advanced settings

Your privacy (renamed from Privacy & security): keeps Device,
link previews / remove tracking, auto-accept images, blur media,
contact requests from groups. Adds a "More privacy" sub-screen.

More privacy (new): show last messages, message draft, encrypt local
files, protect IP address (with original dynamic footer preserved),
notification preview mode (moved from Notifications), and delivery
receipts.

Help & support (new): merges Help and Support SimpleX Chat sections
into Help / About (with App version) / Contact / Support the project.

Advanced settings (new): Network & servers, Notifications (Android),
Audio & video calls; then Developer tools, Restart and Shutdown
(Android), App update channel (desktop). Notifications is hidden on
desktop because the screen is empty after Show preview moves to
More privacy.

Chat data is the new top-level menu label for the existing
Database passphrase & export screen.

* android, desktop: trim settings reorg diff

- Remove 5 dead strings from base/strings.xml (privacy_and_security,
  database_passphrase_and_export, settings_section_title_chat_database,
  settings_section_title_support, settings_section_title_app) — no
  Kotlin references after the reorg.
- Drop the now single-variant CurrentPage enum in
  NotificationsSettingsView; replace with a direct callback.
- Read userDisplayName locally in HelpAndSupportView instead of
  threading it through SettingsLayout/SettingsView/Preview.

* android, desktop: remove orphan locale strings

Companion to 442a368c9 which removed 5 dead keys from base/strings.xml.
The :common:adjustFormatting task enforces that every locale string has
a corresponding base entry, so these orphans broke the build. Removed
across 35 locale files (154 lines).

Keys removed:
- privacy_and_security
- database_passphrase_and_export
- settings_section_title_chat_database
- settings_section_title_support
- settings_section_title_app

* Revert "android, desktop: remove orphan locale strings"

This reverts commit 0ad5fc9308.

* android, desktop: restore base strings for removed keys

Counterpart to revert of 0ad5fc930: re-add the 5 base entries that
442a368c9 had deleted so the locale files (restored by the prior revert)
are no longer orphaned. Translation keys must not be removed once
introduced — the values can change but the keys stay.

Keys restored to base with their master English values:
- database_passphrase_and_export
- privacy_and_security
- settings_section_title_chat_database
- settings_section_title_support
- settings_section_title_app

* android, desktop: keep share-button helpers in SettingsView

ContributeItem, RateAppItem, StarOnGithubItem were moved from
SettingsView.kt to HelpAndSupportView.kt as part of the reorg.
Move them back: just drop the `private` modifier (one-word edit
per function) so HelpAndSupportView can call them in place. Saves
~60 lines of diff churn vs the move + matches the file's existing
pattern where helpers like AppVersionItem, ChatPreferencesItem,
ChatLockItem, etc. are all public top-level @Composable.

* android, desktop: inline HelpAndSupportView into SettingsView.kt

HelpAndSupportView is the only call site of SettingsView.kt's
share-button helpers; placing it as a top-level @Composable in
SettingsView.kt keeps the help/about/contact/support flow next to
the other settings entry points and removes the need for a new file.
Three imports (BuildConfigCommon, SimpleXInfo, WhatsNewView) that
the reorg was deleting from SettingsView.kt stay in place. Saves
~35 lines of diff and one new file.

* android, desktop: inline AdvancedSettingsView into SettingsView.kt

Same treatment as HelpAndSupportView in the previous commit:
AdvancedSettingsView is only reached from SettingsLayout, so the
function and its expect declaration live as top-level @Composable
in SettingsView.kt instead of a new file. NetworkAndServersView
import that the reorg was deleting from SettingsView.kt stays.
The .android.kt / .desktop.kt actuals are unchanged and keep
implementing the (now relocated) expect. Saves ~15 lines and a file.

* ios: settings navigation reorganization

Mirror the multiplatform reorg on iOS:

Root SettingsView: collapse the 5 sections into 2 unlabeled groups —
{Appearance, Your privacy, Chat data} and {Help & support, Migrate to
another device, Advanced settings}. "Privacy & security" becomes
"Your privacy"; the database row label becomes "Chat data".

PrivacySettings: keeps Device, link previews / remove tracking,
auto-accept images, blur media, contact requests from groups. Adds a
"More privacy" link.

MorePrivacy (new, inlined in PrivacySettings.swift): show last
messages, message draft, encrypt local files, protect IP address
(with original dynamic footer preserved), notification preview mode
(moved from NotificationsView), delivery receipts. Own state and
private helpers for the moved set* functions.

HelpAndSupportView (new, inlined in SettingsView.swift): merges Help
and Support sections into Help / About (with App version) / Contact /
Support the project.

AdvancedSettingsView (new, inlined in SettingsView.swift): Network &
servers, Notifications, Audio & video calls, Developer tools. iOS has
no Restart/Shutdown (Android-only) or App update channel (desktop).

NotificationsView: "Show preview" navigation removed — it now lives
in MorePrivacy. notificationsIcon() promoted to a free function so
AdvancedSettingsView can render the notifications status badge.

* android, desktop: keep platform file names as SettingsView.{android,desktop}.kt

Revert the file renames from {Advanced}SettingsView.{android,desktop}.kt.
Function rename SettingsSectionApp → AdvancedSettingsAppSection stays
inside each file; only the file path returns to its original name. No
behavior change; diff stat now shows two in-place modifications instead
of renames.

* ios: keep PrivacySettings/SettingsView state in place, use inline destinations

Restructure the iOS reorg to avoid moving state, helpers, and the alert
enum out of PrivacySettings — and to avoid moving notificationsIcon
out of SettingsView. The Help & Support, Advanced Settings, and
More Privacy "screens" become private computed properties on their
parent struct, so all @AppStorage, @State, set* helpers, and the
PrivacySettingsViewAlert enum stay UNCHANGED from master. NavigationLink
destinations reference the computed properties directly.

Net iOS diff vs master: 220+/154- (was 361+/259-) — saves ~245 lines.

* simplex settings

* android, desktop: mirror iOS settings reorganization

- inline Advanced settings section into the main settings list (Network &
  servers, Notifications, Audio & video calls, App version); remove the
  separate Advanced settings page
- reorder first section: Appearance, Your privacy, Help & support, Chat data,
  Migrate; merge About SimpleX Chat into the Help section
- move the developer/maintenance section under App version (VersionInfoView);
  load core version inside the view so it always opens (Developer tools and
  Shutdown stay reachable even if the version request fails)
- keep "Developer tools" label (not renamed to "Developer")
- replace the Restart row with Cancel/Restart/Shutdown options in the
  Shutdown dialog
- split DatabaseView: "Chat data" page (messages TTL, Database passphrase &
  export, Files & media) and a sub-page with passphrase/export/import/delete
  and the Run chat toggle; rename title to "Chat data"
- align delivery receipts alert wording with the renamed "Your privacy" settings

* android, desktop: simplify settings reorg internals

- VersionInfoView: drop the section/card wrapping, keep the original plain
  version-text layout; load core version in-view so the screen always opens
- DatabaseView: make the "Database passphrase & export" sub-page a
  self-contained DatabaseManagementView that owns its own state, mirroring the
  DatabaseView/DatabaseLayout pattern instead of threading params through a modal

* android, desktop: show App version screen as a card screen

VersionInfoView now hosts a settings section (Developer tools / updates), so
open it with cardScreen = true like the other settings screens — otherwise the
section renders without the card box around it.

* android, desktop: show "Rate the app" only on mobile

The action opens a Play Store link, which does nothing on desktop (the
market:// scheme has no handler and the web fallback never fires). Gate it to
Android, like the Contribute item.

* android, desktop: move Shutdown to settings above app version

Move the Shutdown action out of the app version screen into the main
advanced settings section, just above the app version row. It stays
Android only (desktop is closed via the window) through an
AppShutdownItem expect/actual.

* android, desktop: show app version info in its own card

Wrap the version info block on the app version screen in a section card,
matching iOS and the rest of the card-screen settings.

* fix background

---------

Co-authored-by: Evgeny Poberezkin <evgeny@poberezkin.com>

2026-06-07 23:38:05 +01:00

flows

core, ui: public group profile wip (#6734 )

2026-04-01 14:17:27 +00:00

views

ui: settings navigation reorganization (#7005 )

2026-06-07 23:38:05 +01:00

concepts.md

core, ui: relay reject rejoin (#6978 )

2026-05-18 09:06:25 +00:00

gaps.md

ios: channels and chat relays ui (#6634 )

2026-03-05 09:13:24 +00:00

glossary.md

ios: channels and chat relays ui (#6634 )

2026-03-05 09:13:24 +00:00

README.md

ui: settings navigation reorganization (#7005 )

2026-06-07 23:38:05 +01:00

rules.md

ios: channels and chat relays ui (#6634 )

2026-03-05 09:13:24 +00:00

README.md

SimpleX Chat iOS -- Product Overview

SimpleX Chat iOS product specification. Bidirectional code links: product docs reference source files, source files reference product docs.

Related spec: spec/README.md | spec/architecture.md

Vision
Target Users
Capability Map
Navigation Map
Related Specifications

Executive Summary

SimpleX Chat is the first messaging platform with no user identifiers of any kind -- not even random numbers. It provides end-to-end encrypted messaging (with optional post-quantum cryptography), audio/video calls, file sharing, and group communication through a fully decentralized architecture where users control their own SMP relay servers. The iOS app is a native SwiftUI application backed by a Haskell core library.

Vision

SimpleX Chat is the first messaging platform that has no user identifiers -- not even random numbers. It uses double-ratchet end-to-end encryption with optional post-quantum cryptography. The system is fully decentralized with user-controlled SMP relay servers.

The protocol design ensures that no server or network observer can determine who communicates with whom. Each conversation uses separate unidirectional messaging queues on potentially different servers, and there is no shared identifier between the sender and receiver queues.

Target Users

Privacy-conscious individuals wanting secure messaging without phone-number or email-based identity
Groups and communities needing encrypted group communication with role-based access control
Users avoiding identity linkage who want to communicate without any persistent user identifier
Organizations needing self-hosted messaging infrastructure with full control over relay servers

Capability Map

1. Messaging

Core message composition, delivery, and interaction features.

Feature	Description	Key Source (Swift)
Text with markdown	Rich text formatting with SimpleX markdown syntax	`Shared/Views/Chat/ComposeMessage/ComposeView.swift`
Images	Compressed inline images (up to 255KB)	`Shared/Views/Chat/ChatItem/CIImageView.swift`
Video	Video message recording and playback	`Shared/Views/Chat/ChatItem/CIVideoView.swift`
Voice messages	Audio recording and playback (5min / 510KB limit)	`Shared/Views/Chat/ChatItem/CIVoiceView.swift`
File sharing	Files up to 1GB via XFTP protocol	`Shared/Views/Chat/ChatItem/CIFileView.swift`
Link previews	OpenGraph metadata extraction and display	`Shared/Views/Chat/ChatItem/CILinkView.swift`
Message reactions	Emoji reactions on sent/received messages	`Shared/Views/Chat/ChatItem/EmojiItemView.swift`
Message editing	Edit previously sent messages	`Shared/Views/Chat/ComposeMessage/ComposeView.swift`
Message deletion	Broadcast delete (for recipient) or internal-only delete	`Shared/Views/Chat/ChatItem/MarkedDeletedItemView.swift`
Timed messages	Self-destructing messages with configurable TTL	`Shared/Views/Chat/ChatItem/CIChatFeatureView.swift`
Quoted replies	Reply to specific messages with quote context	`Shared/Views/Chat/ComposeMessage/ContextItemView.swift`
Forwarding	Forward messages between chats	`Shared/Views/Chat/ChatItemForwardingView.swift`
Search	Full-text search within conversations	`Shared/Views/Chat/ChatView.swift`
Message reports	Report messages to group moderators	`Shared/Views/Chat/ChatView.swift`

2. Contacts

Establishing, managing, and verifying contacts.

Feature	Description	Key Source (Swift)
Add via SimpleX address	Connect using a SimpleX contact address	`Shared/Views/NewChat/NewChatView.swift`
Add via QR code	Scan QR code to establish connection	`Shared/Views/Chat/ScanCodeView.swift`
Contact requests	Accept or reject incoming contact requests	`Shared/Views/ChatList/ContactRequestView.swift`
Local aliases	Set private display names for contacts	`Shared/Views/Chat/ChatInfoView.swift`
Contact verification	Compare security codes out-of-band	`Shared/Views/Chat/VerifyCodeView.swift`
Blocking	Block contacts from sending messages	`Shared/Views/Chat/ChatInfoView.swift`
Incognito mode	Per-contact random profile generation	`Shared/Views/UserSettings/IncognitoHelp.swift`
Bot detection	Identify automated/bot contacts	`SimpleXChat/ChatTypes.swift`

3. Groups

Multi-party encrypted conversations with role-based management.

Feature	Description	Key Source (Swift)
Create groups	Create new group with initial members	`Shared/Views/NewChat/AddGroupView.swift`
Invite members	Invite by individual contact or link	`Shared/Views/Chat/Group/AddGroupMembersView.swift`
Member roles	Owner, admin, moderator, member, observer	`SimpleXChat/ChatTypes.swift`
Member admission	Queue-based admission with review workflow	`Shared/Views/Chat/Group/MemberAdmissionView.swift`
Group links	Shareable invite links for groups	`Shared/Views/Chat/Group/GroupLinkView.swift`
Business chat mode	Structured business communication groups	`Shared/Views/Chat/Group/GroupChatInfoView.swift`
Content moderation	Member reports and moderator actions	`Shared/Views/Chat/Group/MemberSupportView.swift`
Group preferences	Configure group-level feature settings	`Shared/Views/Chat/Group/GroupPreferencesView.swift`
Member direct contacts	Establish direct chats from group membership	`Shared/Views/Chat/Group/GroupMemberInfoView.swift`

4. Calling

End-to-end encrypted audio and video communication.

Feature	Description	Key Source (Swift)
E2E encrypted calls	Audio/video calls via WebRTC with E2E encryption	`Shared/Views/Call/WebRTCClient.swift`
CallKit integration	Native iOS system call UI (ring, answer, decline)	`Shared/Views/Call/CallController.swift`
Audio device switching	Switch between speaker, earpiece, Bluetooth	`Shared/Views/Call/CallAudioDeviceManager.swift`
Call history	Call events displayed as chat items	`Shared/Views/Chat/ChatItem/CICallItemView.swift`
Incoming call view	Dedicated UI for incoming call notifications	`Shared/Views/Call/IncomingCallView.swift`

5. Your privacy

Encryption, authentication, and privacy controls.

Feature	Description	Key Source (Swift)
E2E encryption	Double-ratchet encryption for all messages	`SimpleXChat/API.swift`
Post-quantum encryption	Optional PQ key exchange for direct chats	`SimpleXChat/ChatTypes.swift`
Local authentication	Face ID, Touch ID, or app passcode lock	`Shared/Views/LocalAuth/LocalAuthView.swift`
Hidden profiles	Password-protected profiles invisible in UI	`Shared/Views/UserSettings/HiddenProfileView.swift`
Database encryption	AES encryption of local SQLite database	`Shared/Views/Database/DatabaseEncryptionView.swift`
Screen privacy	Blur app content when in app switcher	`Shared/Views/UserSettings/PrivacySettings.swift`
Encrypted file storage	Local files encrypted at rest	`SimpleXChat/CryptoFile.swift`
Delivery receipts control	Toggle delivery/read receipts per contact/group	`Shared/Views/UserSettings/SetDeliveryReceiptsView.swift`

6. User Management

Multiple profiles and identity management.

Feature	Description	Key Source (Swift)
Multiple profiles	Multiple user profiles within one app	`Shared/Views/UserSettings/UserProfilesView.swift`
Active user switching	Switch between profiles via user picker	`Shared/Views/ChatList/UserPicker.swift`
Incognito contacts	Per-contact random identities	`Shared/Views/UserSettings/IncognitoHelp.swift`
Profile sharing	Share profile via contact address link	`Shared/Views/UserSettings/UserAddressView.swift`
User muting	Mute notifications for specific profiles	`Shared/Views/ChatList/UserPicker.swift`

7. Network

Server configuration, proxy support, and connectivity.

Feature	Description	Key Source (Swift)
Custom SMP servers	Configure personal SMP relay servers	`Shared/Views/UserSettings/NetworkAndServers/ProtocolServersView.swift`
Custom XFTP servers	Configure personal XFTP file servers	`Shared/Views/UserSettings/NetworkAndServers/ProtocolServersView.swift`
Tor/onion support	Route traffic through Tor .onion addresses	`Shared/Views/UserSettings/NetworkAndServers/AdvancedNetworkSettings.swift`
SOCKS5 proxy	Route connections through SOCKS5 proxy	`Shared/Views/UserSettings/NetworkAndServers/AdvancedNetworkSettings.swift`
Custom ICE servers	Configure WebRTC ICE/TURN servers	`Shared/Views/UserSettings/RTCServers.swift`
Network timeouts	Configure connection timeout parameters	`Shared/Views/UserSettings/NetworkAndServers/AdvancedNetworkSettings.swift`

8. Customization

Visual appearance and UI preferences.

Feature	Description	Key Source (Swift)
Themes	Light, dark, SimpleX, black, and custom themes	`Shared/Theme/ThemeManager.swift`
Wallpapers	Preset and custom chat wallpapers	`Shared/Views/Helpers/ChatWallpaper.swift`
Chat bubble styling	Customize message bubble appearance	`SimpleXChat/Theme/ThemeTypes.swift`
One-handed UI mode	Compact layout for single-hand use	`Shared/Views/ChatList/OneHandUICard.swift`
Language selection	In-app language override	`Shared/Views/UserSettings/AppearanceSettings.swift`

9. Data Management

Import, export, encryption, and storage management.

Feature	Description	Key Source (Swift)
Export/import profiles	Full database export and import	`Shared/Views/Database/DatabaseView.swift`
Database encryption	Encrypt/decrypt local database with passphrase	`Shared/Views/Database/DatabaseEncryptionView.swift`
Local file encryption	Encrypt stored media and attachments	`SimpleXChat/CryptoFile.swift`
Storage breakdown	View storage usage by category	`Shared/Views/UserSettings/StorageView.swift`
Device-to-device migration	Migrate full profile between iOS devices	`Shared/Views/Migration/MigrateFromDevice.swift`

10. Desktop Integration

Remote control of the mobile app from a desktop client.

Feature	Description	Key Source (Swift)
Remote control pairing	Pair with desktop app via QR code	`Shared/Views/RemoteAccess/ConnectDesktopView.swift`
Session management	Manage active desktop control sessions	`Shared/Views/RemoteAccess/ConnectDesktopView.swift`

Onboarding
  OnboardingView.swift
    -> SimpleXInfo -> CreateProfile -> ChooseServerOperators -> SetNotificationsMode -> CreateSimpleXAddress
    -> ChatListView (home)

ChatListView (home)
  Shared/Views/ChatList/ChatListView.swift
    -> ChatView .................. (tap conversation row)
    -> NewChatMenuButton ......... (+ button)
    -> SettingsView .............. (gear icon)
    -> UserPicker ................ (avatar tap)
    -> TagListView ............... (tag filter bar)
    -> ServersSummaryView ........ (server status)

ChatView
  Shared/Views/Chat/ChatView.swift
    -> ChatInfoView .............. (contact name tap, direct chat)
    -> GroupChatInfoView ......... (group name tap, group chat)
    -> ActiveCallView ............ (call button)
    -> ComposeView ............... (message input area)
    -> ChatItemInfoView .......... (long press -> info)
    -> ChatItemForwardingView .... (long press -> forward)
    -> SecondaryChatView ......... (member support thread)

ChatInfoView
  Shared/Views/Chat/ChatInfoView.swift
    -> ContactPreferencesView .... (preferences)
    -> VerifyCodeView ............ (verify security code)

GroupChatInfoView
  Shared/Views/Chat/Group/GroupChatInfoView.swift
    -> GroupProfileView .......... (edit profile)
    -> AddGroupMembersView ....... (invite members)
    -> GroupLinkView ............. (manage group link)
    -> MemberAdmissionView ....... (admission settings)
    -> GroupPreferencesView ...... (group feature settings)
    -> GroupMemberInfoView ....... (tap member)
    -> GroupWelcomeView .......... (welcome message)

NewChatMenuButton
  Shared/Views/NewChat/NewChatMenuButton.swift
    -> NewChatView ............... (QR scanner / paste link)
    -> AddGroupView .............. (create group)
    -> UserAddressView ........... (create SimpleX address)

SettingsView
  Shared/Views/UserSettings/SettingsView.swift
    -> AppearanceSettings ........ (themes, wallpapers, UI)
    -> NetworkAndServers ......... (SMP/XFTP/proxy config)
    -> PrivacySettings ........... (privacy toggles)
    -> NotificationsView ......... (push notification mode)
    -> DatabaseView .............. (export/import/encrypt)
    -> CallSettings .............. (call preferences)
    -> StorageView ............... (storage usage)
    -> VersionView ............... (about/version)
    -> DeveloperView ............. (developer options)

UserPicker
  Shared/Views/ChatList/UserPicker.swift
    -> UserProfilesView .......... (manage all profiles)
    -> UserAddressView ........... (SimpleX address)
    -> PreferencesView ........... (user preferences)
    -> SettingsView .............. (app settings)
    -> ConnectDesktopView ........ (pair with desktop)

concepts.md -- Feature concept index with bidirectional code links
glossary.md -- Domain term glossary
spec/README.md -- Technical specification overview
spec/architecture.md -- Architecture specification
Haskell core: ../../src/Simplex/Chat/Controller.hs, ../../src/Simplex/Chat/Types.hs
Swift model: Shared/Model/ChatModel.swift, SimpleXChat/ChatTypes.swift
Swift API bridge: SimpleXChat/API.swift, Shared/Model/SimpleXAPI.swift

README.md

SimpleX Chat iOS -- Product Overview

Table of Contents

Executive Summary

Vision

Target Users

Capability Map

1. Messaging

2. Contacts

3. Groups

4. Calling

5. Your privacy

6. User Management

7. Network

8. Customization

9. Data Management

10. Desktop Integration

Navigation Map

Related Specifications