# nextcloud/talk-ios architecture

> Architecture diagram of the GitHub repository nextcloud/talk-ios, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nextcloud/talk-ios
- Repository: https://github.com/nextcloud/talk-ios

## Overview

Nextcloud Talk is an iOS client for Nextcloud chat and audio/video calls. Users sign in to a Nextcloud server, browse conversations, exchange messages and shared content, or join calls. The main app also supports notifications and system sharing extensions. The graph reflects documented product capabilities and source-index references; several runtime links are omitted because the relevant implementation was not sampled, so the graph is intentionally not a complete call trace.

Main entry points: [`NextcloudTalk/Calls/CallViewController.swift`](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Calls/CallViewController.swift) (Call screen), [`NextcloudTalk/Chat/ChatViewController.swift`](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/ChatViewController.swift) (Chat screen), [`NextcloudTalk/Login/LoginViewController.swift`](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Login/LoginViewController.swift) (Sign in), [`NextcloudTalk/Rooms/RoomsTableViewController.swift`](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Rooms/RoomsTableViewController.swift) (Conversation list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and accounts"]
  node_login["Sign in"]
  node_settings["Account settings"]
  node_ui["App navigation"]
end

subgraph group_conversations["Rooms and chat"]
  node_roomlist["Conversation list"]
  node_rooms["Room management"]
  node_roommodel["Room model<br/>[NCRoom.swift]"]
  node_chatview["Chat screen"]
  node_chatlogic["Chat controller"]
  node_messages["Chat messages"]
  node_uploads["Chat file uploads"]
end

subgraph group_calling["Audio and video calls"]
  node_callscreen["Call screen"]
  node_callkit["Call integration"]
  node_callcontroller["Call controller"]
  node_signaling["Call signaling"]
  node_peer["Peer connection"]
end

subgraph group_services["Persistence and services"]
  node_api["Server API"]
  node_database[("Local database")]
  node_account["Account record<br/>[TalkAccount.swift]"]
  node_notifications["Notifications"]
end

subgraph group_extensions["System extensions"]
  node_share["Share extension"]
  node_broadcast["Broadcast upload"]
end

node_user(("User"))
node_server{{"Nextcloud server"}}

node_user -->|"signs in"| node_login
node_login -->|"authenticates with"| node_server
node_user -->|"browses rooms"| node_roomlist
node_roomlist -->|"displays rooms"| node_roommodel
node_user -->|"exchanges messages"| node_chatview
node_chatview -->|"uses"| node_chatlogic
node_chatview -->|"renders"| node_messages
node_user -->|"joins calls"| node_callscreen
node_callscreen -->|"starts calls"| node_callcontroller
node_callscreen -->|"integrates calls"| node_callkit
node_callscreen -->|"uses peers"| node_peer
node_user -->|"communicates through"| node_server
node_api -->|"reads accounts"| node_database
node_database -->|"stores"| node_account
node_user -.->|"shares content"| node_share
node_user -.->|"broadcasts media"| node_broadcast

click node_login "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Login/LoginViewController.swift"
click node_settings "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Settings/NCSettingsController.swift"
click node_ui "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/User%20Interface/NCUserInterfaceController.swift"
click node_roomlist "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Rooms/RoomsTableViewController.swift"
click node_rooms "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Rooms/NCRoomsManager.swift"
click node_roommodel "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Rooms/NCRoom.swift"
click node_chatview "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/ChatViewController.swift"
click node_chatlogic "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/NCChatController.swift"
click node_messages "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/NCChatMessage.swift"
click node_uploads "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/Chat%20upload/ChatFileUploader.swift"
click node_callscreen "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Calls/CallViewController.swift"
click node_callkit "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Calls/CallKitManager.swift"
click node_callcontroller "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Calls/NCCallController.swift"
click node_signaling "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/WebRTC/NCExternalSignalingController.swift"
click node_peer "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/WebRTC/NCPeerConnection.swift"
click node_api "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Network/NCAPIController.swift"
click node_database "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Database/NCDatabaseManager.swift"
click node_account "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Database/TalkAccount.swift"
click node_notifications "https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Notifications/NCNotificationController.swift"
click node_share "https://github.com/nextcloud/talk-ios/blob/main/ShareExtension/ShareViewController.h"
click node_broadcast "https://github.com/nextcloud/talk-ios/blob/main/BroadcastUploadExtension/SampleHandler.swift"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_login,node_settings,node_ui,node_user toneBlue
class node_roomlist,node_rooms,node_roommodel,node_chatview,node_chatlogic,node_messages,node_uploads toneAmber
class node_callscreen,node_callkit,node_callcontroller,node_signaling,node_peer,node_server toneMint
class node_api,node_database,node_account,node_notifications toneRose
class node_share,node_broadcast toneIndigo
```

## Components

### App and accounts

- [Sign in](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Login/LoginViewController.swift): `NextcloudTalk/Login/LoginViewController.swift`
- [Account settings](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Settings/NCSettingsController.swift): `NextcloudTalk/Settings/NCSettingsController.swift`
- [App navigation](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/User%20Interface/NCUserInterfaceController.swift): `NextcloudTalk/User Interface/NCUserInterfaceController.swift`

### Rooms and chat

- [Conversation list](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Rooms/RoomsTableViewController.swift): `NextcloudTalk/Rooms/RoomsTableViewController.swift`
- [Room management](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Rooms/NCRoomsManager.swift): `NextcloudTalk/Rooms/NCRoomsManager.swift`
- [Room model](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Rooms/NCRoom.swift): `NextcloudTalk/Rooms/NCRoom.swift`
- [Chat screen](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/ChatViewController.swift): `NextcloudTalk/Chat/ChatViewController.swift`
- [Chat controller](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/NCChatController.swift): `NextcloudTalk/Chat/NCChatController.swift`
- [Chat messages](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/NCChatMessage.swift): `NextcloudTalk/Chat/NCChatMessage.swift`
- [Chat file uploads](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Chat/Chat%20upload/ChatFileUploader.swift): `NextcloudTalk/Chat/Chat upload/ChatFileUploader.swift`

### Audio and video calls

- [Call screen](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Calls/CallViewController.swift): `NextcloudTalk/Calls/CallViewController.swift`
- [Call integration](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Calls/CallKitManager.swift): `NextcloudTalk/Calls/CallKitManager.swift`
- [Call controller](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Calls/NCCallController.swift): `NextcloudTalk/Calls/NCCallController.swift`
- [Call signaling](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/WebRTC/NCExternalSignalingController.swift): `NextcloudTalk/WebRTC/NCExternalSignalingController.swift`
- [Peer connection](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/WebRTC/NCPeerConnection.swift): `NextcloudTalk/WebRTC/NCPeerConnection.swift`

### Persistence and services

- [Server API](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Network/NCAPIController.swift): `NextcloudTalk/Network/NCAPIController.swift`
- [Local database](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Database/NCDatabaseManager.swift): `NextcloudTalk/Database/NCDatabaseManager.swift`
- [Account record](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Database/TalkAccount.swift): `NextcloudTalk/Database/TalkAccount.swift`
- [Notifications](https://github.com/nextcloud/talk-ios/blob/main/NextcloudTalk/Notifications/NCNotificationController.swift): `NextcloudTalk/Notifications/NCNotificationController.swift`

### System extensions

- [Share extension](https://github.com/nextcloud/talk-ios/blob/main/ShareExtension/ShareViewController.h): `ShareExtension/ShareViewController.h`
- [Broadcast upload](https://github.com/nextcloud/talk-ios/blob/main/BroadcastUploadExtension/SampleHandler.swift): `BroadcastUploadExtension/SampleHandler.swift`

### Other components

- **User**
- **Nextcloud server**

## Connections

- User → Sign in: signs in (evidence: `README.md`)
- Sign in → Nextcloud server: authenticates with (evidence: `NextcloudTalk/Login/LoginViewController.swift`)
- User → Conversation list: browses rooms (evidence: `README.md`)
- Conversation list → Room model: displays rooms (evidence: `NextcloudTalk/Rooms/RoomsTableViewController.swift`)
- User → Chat screen: exchanges messages (evidence: `README.md`)
- Chat screen → Chat controller: uses (evidence: `NextcloudTalk/Chat/ChatViewController.swift`)
- Chat screen → Chat messages: renders (evidence: `NextcloudTalk/Chat/BaseChatViewController.swift`)
- User → Call screen: joins calls (evidence: `README.md`)
- Call screen → Call controller: starts calls (evidence: `NextcloudTalk/Calls/CallViewController.swift`)
- Call screen → Call integration: integrates calls (evidence: `NextcloudTalk/Calls/CallViewController.swift`)
- Call screen → Peer connection: uses peers (evidence: `NextcloudTalk/Calls/CallViewController.swift`)
- User → Nextcloud server: communicates through (evidence: `README.md`)
- Server API → Local database: reads accounts (evidence: `NextcloudTalk/Network/NCAPIController.swift`)
- Local database → Account record: stores (evidence: `NextcloudTalk/Database/NCDatabaseManager.swift`)
- User → Share extension: shares content (evidence: `README.md`)
- User → Broadcast upload: broadcasts media
