Matron iOS

A native iOS Matrix client built with SwiftUI and the Matrix Rust SDK.

Forked from Element X iOS.

Part of the Matron ecosystem

Project	Description
Matron Desktop	Desktop client
Matron Web	Web client
Matron iOS	iOS client (this repo)
Matron Server	Matrix homeserver
Dev Boxer	One-command dev environment setup

Prerequisites

• Xcode 16.0+
• XcodeGen (brew install xcodegen)

Getting started

git clone https://github.com/matronhq/matron-ios.git
cd matron-ios

# Install tools and generate the Xcode project
swift run tools setup-project

# Open in Xcode
xed .

Select the Matron scheme and run.

Architecture

MVVM-Coordinator pattern throughout. See AGENTS.md for the full architecture reference.

ElementX/Sources/
  Application/       App lifecycle, settings, root coordinators
  FlowCoordinators/  Navigation and state machines
  Services/          SDK proxies and business logic
  Screens/           View + ViewModel + Coordinator per screen

Custom features

• Button groups - Interactive buttons in messages via chat.matron.buttons custom Matrix events
• Commands - Slash commands for common operations

Testing

swift run tools ci unit-tests

License

Multi-licensed under AGPL-3.0-only / GPL-3.0-only, at your option.