mirror of
https://github.com/simplex-chat/simplex-chat.git
synced 2026-11-16 10:58:10 +00:00
* plan: mcp-flat-sessions * plan: mcp-flat-sessions, the user's answers * plan: mcp-flat-sessions, image widths and times per platform * plan: mcp-flat-sessions, one flat media width and smaller avatars * plan: mcp-flat-sessions, list breaks * plan: mcp-flat-sessions, visible avatar gaps and the gap below the sender row * plan: mcp-flat-sessions, equal gaps around the name * plan: mcp-flat-sessions, restore the approved gaps * mcp: open the groups of new sessions in the Flat layout * ui: avatar on the name line and full-width messages in the flat layout * ui: record the snapshot references of the flat layout * ui: flat media beside the go-to button, text below tall name lines * mcp: source of the session image, Main group check in the e2e test * plan: mcp-flat-sessions, as implemented * plans: flat sessions, the tests run on master * android, desktop: keep the width limit of the media box in intrinsic measurement * android, desktop: test the intrinsic height of media at an unbounded width * ui: flat name rows close to their messages, cards at the text edge * desktop: flat group snapshot references, the media scene * plans: flat sessions, avatars and flat-layout defects * desktop: avatar snapshot scenes with photos and placeholders * ios: flat snapshot references, the deleted items scene * desktop: avatar snapshot scenes of share, contact and user lists, calls, channel members * android, desktop: avatars without inner padding, each in its former box * ios: snapshot scenes of hidden integrity errors in Flat rows and bubbles * desktop: avatar snapshot references, recorded before the inset removal * android, desktop: snapshot scenes of hidden integrity errors in Flat rows and bubbles * ios: hidden integrity errors take no space in the chat * plans: flat sessions, the user's answers, avatar call sites as implemented, hidden rows * ios: scenes of the time before deleted items, unread users, appearance * ios: avatars in Flat rows pass the letters' edge by 2 pt * ios: 6 pt from the avatar to the message below it in Flat rows * ios: time on the last line of messages ending with empty lines in Flat * ios: code cards as wide as the code, the time beside them, in Flat rows * ios: delivery status only with the time in Flat rows * ios: time shown on a message before a deleted or hidden item * ios: no gap below a reactions row between one sender's messages in Flat * ios: no early wrap of the last word before the time in Flat rows * ios: name the condition that shows the time before deleted items * ios: spec links to the moved lines of TerminalItemView * ios: test of the delivery status without the time in Flat rows * desktop: snapshot references after the inset removal, hidden integrity error scenes * android, desktop: blur of blocked members' photos as on iOS * ios: user picker scene with the chat running, as in the app * android, desktop: snapshot scenes of the Flat defects and the chat banner * ios: status without the time only for partial delivery and errors * ios: snapshot references of the Flat avatar overshoot, gap and defect fixes * ios: snapshot references without the empty line after a hidden time * android, desktop: hidden integrity errors take no space; the time before deleted and hidden items * android, desktop: chat banner 20 dp above its avatar and 10 dp below * android, desktop: Flat avatars 2 dp past the letters, 6 dp above the text, four layout defects * android, desktop: share list shows each chat's own avatar * android, desktop: business, bot and agent placeholders as on iOS * plans: flat sessions, the decisions as implemented on Android and desktop * ios: scene of a hidden item between two messages of one sender * ios: sender name 12 pt after the visible avatar in Flat rows * ios: rows around hidden items grouped as if the hidden items were absent * ios: full time in a deleted message bubble * android, desktop: rows skip hidden items as neighbours; the time before deleted items in Flat rows only * android, desktop: Flat sender names 12 dp after the avatar * android, desktop: avatar placeholders from their own assets; unused icons removed * plans: flat sessions, questions numbered as answered, neighbours of hidden rows, overshoot note * ios: snapshot references of rows around hidden items and the name start * android, desktop: hidden rows keep one date separator; marked deleted errors shown; rows rebuilt on the developer setting * desktop: snapshot references of the Flat decisions, defects, banner and rows around hidden items * spec, plans: Flat row layout, hidden rows and their neighbours, status with the time; avatar assets as implemented * android, desktop: new, unread and read statuses only with the time in Flat rows, as on iOS * desktop: snapshot references of the Flat defects scene with an unread message; plans: partial delivery wording * mcp: session image with the Flat row geometry: avatar 2 pt past the letters, text 6 pt below it * mcp: session image with a shorter answer, so the first row shows in full * ios: user picker snapshot scenes at the height of the sheet * plans: flat sessions, an avatar column with tighter paddings * ios: snapshot references of the user picker at the height of the sheet * plans: flat sessions, the avatar column with only the gap open * ui: Flat avatar column, the avatar 2 into the padding, text 10 after it Names, items, later rows of one sender, events and deleted cards sit in the message column; media widths are measured from it. Chats without avatars keep 12 on both sides. The session scene on both platforms; the README image redrawn with the column. * ui: snapshot references of the Flat avatar column and the session scene * ui: Flat cards and pills take their corners from the roundness setting Deleted, marked deleted, moderated, blocked, error and decryption error cards and group invitations: 18 × roundness without a tail, as media, on iOS and Android/desktop. A scene of each platform at roundness 0.3. * ui: Flat pill text on the text start, sender rows at master's pitch Deleted, marked deleted, moderated, blocked and error pills start at the message column, so their text lines up with the messages, as on master; in chats without avatars they keep 12 from the screen edge. The name line of a sender row starts at the row gap, as on master; the avatar is centred on it and reaches into the gap above, on both platforms. * android, desktop: avatars in a box drawn at exactly 5/6 of it, as master's padded placeholders centeredIn scales its child to 5/6 of the box and centres it with fractional placement, so placeholder edges match master at the pixel at every font scale. Photos and the incognito icon take the same size, up to 1 px larger than master's rounded photo padding. The chat-link thumbnail of the chat list uses the same box, 44 sp. * android, desktop: avatars in a box at whole pixels, photos fill the drawn box centeredIn places its child at box/12 rounded down and sizes it to the box less twice that, so placeholders keep master's first and last ink pixel and stay sharp. Photos take their rounded square from the drawn box in pixels. * ui: photo corners from the nominal size; iOS references of pills, corners and sender rows The rounded square of a photo keeps its corner radius from the size argument. iOS references for the pill alignment, the corner radius from the roundness setting with a 0.3 scene, and sender rows at master's pitch. * android, desktop: snapshot references of pills, corners, sender rows and avatars at whole pixels
SimpleX Chat iOS -- Specification Overview
Technical specification suite for the SimpleX Chat iOS application. Each document provides bidirectional links to product documentation and source code.
Executive Summary
The SimpleX Chat iOS app is a native SwiftUI frontend that communicates with a Haskell core library via C FFI. All chat logic, encryption, protocol handling, and database operations happen in the Haskell core (chat_ctrl). The iOS layer handles UI rendering, system integration (CallKit, Push Notifications, Background Tasks), local preferences, and theming. The app shares its database with a Notification Service Extension (NSE) for decrypting push payloads while the main app is inactive.
Dependency Graph
SimpleXApp (root entry point)
├── ChatModel (ObservableObject state) <-> SimpleXAPI (FFI bridge) <-> Haskell Core (chat_ctrl)
├── Views (SwiftUI)
│ ├── ChatListView -> ChatView -> ComposeView
│ ├── ChatItemView (renders individual messages)
│ ├── Settings, UserProfiles, Onboarding
│ └── ActiveCallView (WebRTC + CallKit)
├── Models
│ ├── ChatModel (global app state -- singleton)
│ ├── ItemsModel (per-chat message list state -- singleton + secondary instances)
│ ├── ChatTagsModel (tag filtering state)
│ └── Chat (per-conversation observable state)
├── Services
│ ├── NtfManager (push notification coordination)
│ ├── BGManager (background task scheduling)
│ ├── CallController (CallKit + VoIP push)
│ └── ThemeManager (theme resolution engine)
└── Extensions
├── SimpleX NSE (Notification Service Extension -- decrypts push payloads)
└── SimpleX SE (Share Extension)
Specification Documents
| Document | Description |
|---|---|
| Architecture | System architecture, FFI bridge, app lifecycle, extension model |
| Chat API Reference | Complete ChatCommand, ChatResponse, ChatEvent, ChatError type reference |
| State Management | ChatModel, ItemsModel, Chat, ChatInfo, preference storage |
| Database & Storage | SQLite databases, encryption, file storage, export/import |
| Chat View | Message rendering, chat item types, context menu actions |
| Chat List | Conversation list, filtering, search, swipe actions |
| Message Composition | Compose bar, attachments, reply/edit/forward modes, voice recording |
| Navigation | Navigation stack, deep linking, sheet presentation, call overlay |
| Push Notifications | NtfManager, NSE, notification modes, token lifecycle |
| WebRTC Calling | CallController, WebRTCClient, CallKit, signaling via SMP |
| File Transfer | Inline/XFTP transfer, auto-receive, CryptoFile, file constants |
| Theme Engine | ThemeManager, default themes, customization layers, wallpapers |
| Impact Graph | Source file → product concept mapping, risk levels |
Related Product Documentation
Source Code Entry Points
| File | Role |
|---|---|
Shared/SimpleXApp.swift |
App entry point, Haskell init, lifecycle management |
Shared/AppDelegate.swift |
UIApplicationDelegate for push token registration |
Shared/ContentView.swift |
Root view -- authentication gate, call overlay, navigation |
Shared/Model/ChatModel.swift |
Primary observable state (ChatModel, ItemsModel, Chat) |
Shared/Model/SimpleXAPI.swift |
FFI bridge -- chatSendCmd, chatApiSendCmd, sendSimpleXCmd |
Shared/Model/AppAPITypes.swift |
ChatCommand, ChatResponse, ChatEvent enums (iOS app layer) |
SimpleXChat/APITypes.swift |
APIResult, ChatError, ChatCmdProtocol (shared framework) |
SimpleXChat/ChatTypes.swift |
User, ChatInfo, Contact, GroupInfo, ChatItem data types |
SimpleXChat/SimpleX.h |
C header for Haskell FFI functions |