feat(healthchat): paint the subtle gradient in brand blue

fix: remove rlement endpoints and links from the HealthChat
* fix(healthchat): switch off analytics, crash and bug reporting endpoints Upstream ships *.localhost placeholders in Secrets.swift and marks the file assume-unchanged; with analytics on, the Element Call widget was handed Element's own PostHog and Sentry. nil hides the analytics prompt, the Analytics and Report a problem entries until HealthChat runs its own services. * feat(healthchat): hide the Labs entry in settings * fix(healthchat): point Copyright and the analytics terms at healthchat.ch * docs(healthchat): add the 26.11.1 release notes * feat(healthchat): drop the Element help links * feat(healthchat): switch off location sharing * test(healthchat): skip the analytics suite without PostHog
2026-11-09 07:20:07 +00:00 · 2026-10-20 13:22:42 +02:00 · 2026-10-19 14:40:20 +02:00 · 2026-10-19 10:09:19 +02:00 · 2026-10-19 09:55:44 +02:00 · 2026-10-19 09:18:09 +02:00
3490 changed files with 51869 additions and 18958 deletions
@@ -0,0 +1,34 @@
+---
+name: constrained-tests
+description: Slow-CI simulation — run unit tests on saturated CPU to reproduce CI-style flakiness locally. Suggest when new/reworked suite lean heavy on awaits (deferFulfillment, waitForConfirmation, TestClock, timeouts) or test fail only on CI. Not for every change.
+---
+
+# Constrained test runs
+
+CI runners shared + slow. Background tasks starve, awaits stretch, scheduler races flake there, pass locally. `--constrained` saturate CPU with hog tasks — same conditions, local.
+
+## When
+
+- PR add/rework suite heavy on timing-sensitive async: `deferFulfillment`, `waitForConfirmation`, `TestClock`, `transitionValues`, timeouts.
+- Test fail on CI, pass locally.
+- Not routine changes, not sync suites — slow, no gain.
+
+## How
+
+Full unit test workflow (what CI run):
+
+```bash
+swift run tools ci unit-tests --constrained
+```
+
+One suite, iterate on new tests (prefer while developing):
+
+```bash
+swift run tools ci run-tests --scheme UnitTests --test-name MyNewTests --constrained
+```
+
+Hog count automatic (2× cores). Suite survive ~10 constrained iterations → good shape.
+
+## Failures mean
+
+Failure under constraint = real bug in test (sometimes code under test): assertion race async work, transient state observation missed, timeout too tight. Fix synchronisation, no blind timeout bump. Helpers in `UnitTests/Sources/TestUtilities/` (`deferFulfillment`, `deferFailure`, `waitForConfirmation`). Wait on durable state, not transient.
@@ -0,0 +1,99 @@
+---
+name: periphery-cleanup
+description: Dead-code sweep with Periphery — scan the Pro-configured project, delete unused code, guard false positives (keep-alive handles, future-use code), run unit tests, purge scan cache. Use when user want "clean up dead code", "run periphery", "remove unused code".
+---
+
+# Periphery cleanup
+
+Periphery = static analysis, find unused code. Scan build ALL schemes — slow (cold ~30-60 min). Maintenance thing, run rare.
+
+## Scan — always on the Pro variant
+
+Scan run on the Pro-configured project so every source get analysed (plain config leave hook implementations + their call sites out, flood report with false "unused"):
+
+```bash
+git submodule update --init --recursive   # once, if submodules missing
+swift run pipeline configure-element-pro
+periphery scan --relative-results --quiet > periphery-report.txt
+```
+
+Config live in `.periphery.yml` — schemes already cover every target, don't narrow. Two deliberate settings there:
+- `retain_unused_protocol_func_params: true` — protocol signatures are contracts (hooks, delegates); params unused in every conformance stay. NEVER annotate protocol function parameters, config already handle them.
+- `index_exclude: compound-ios/**` — Compound excluded: its Inspector app + package tests live outside this project's schemes, so their usage invisible → findings there unreliable (e.g. making things internal break the Inspector). Never act on Compound code from this scan.
+
+Report line format: `path:line:col: warning: <kind> '<name>'`. Build fail → fix build first, scan need compiling project.
+
+## Comment hygiene — strip, scan, restore
+
+Every run: existing `periphery:ignore` comments hide drift — code change, comment stay, nobody notice it useless. So:
+
+1. **Strip + remember.** Before the scan, remove every `periphery:ignore` comment (both spellings: `periphery:ignore` and `periphery: ignore`) and stash them: `git diff > /tmp/periphery-comments.patch` right after stripping, or just rely on `git diff` against HEAD to recall what was where.
+2. **Scan.** The report now show ground truth: every declaration that genuinely need protection re-flag.
+3. **Restore only what re-flag.** For each finding that match the false-positive table, put the comment back (same reason strings). Findings that DON'T re-flag = comments that were stale → stay deleted. Anything newly flagged that isn't a false positive = real dead code → delete it.
+
+Result: comment set always minimal, always true. The clutter never accumulate.
+
+## Triage — kind → action
+
+| Warning | Action |
+|---|---|
+| Unused function / property / enum / struct / init | Check false-positive table FIRST. True dead → delete whole declaration + helpers/extensions only it used |
+| Assign-only property | DANGER ZONE. Prime keep-alive suspect — read table below before touch |
+| Unused parameter | Protocol params never appear (config retain them). ObjC selector / system callback → `ignore:parameters <name> - <reason>`. Free signature → remove param + fix call sites |
+| Redundant protocol conformance | `TestablePreview` → SKIP, always (see below). Others: verify nothing need conformance (generics, tests, mocks), then remove conformance only, keep type |
+| Redundant public accessibility | Drop `public`, make internal — EXCEPT member that satisfy a public protocol in a public type (e.g. `previews`), Swift refuse internal there; skip or internalise whole type |
+| Superfluous ignore comment | Declaration referenced now — comment dead, code alive. Remove comment ONLY, never declaration |
+
+Never touch `Generated/` directories, never edit `Localizable.strings`. Delete bottom-up per file — line numbers stay valid.
+
+## False positives — mark, no delete
+
+Stored-never-read variable often alive ON PURPOSE: keep task / SDK object / coordinator alive past declaration scope. Delete = app break silent (observation stop, flow deallocate, rust handle drop). Mark instead: `// periphery:ignore - <reason>` line above declaration (NEVER `periphery:ignore:all` — whole files that shouldn't be reported, like hand-written mocks, belong in `report_exclude` in `.periphery.yml` instead). Comment go ABOVE any doc comment, never between doc and declaration. Reuse existing reasons from codebase:
+
+| Pattern | How recognise | Reason string |
+|---|---|---|
+| Rust SDK handle | `TaskHandle`, observation token from SDK, stored after `observe`/`subscribe` call | `required for instance retention in the rust codebase` |
+| Keep-alive reference | child flow coordinator, service stored so updates keep flowing | `retaining purpose` or `used to avoid deallocation` or `keep alive to keep receiving updates.` |
+| Cancellable task handle | `@CancellableTask` property, `Task` stored so reassign/nil cancel previous | `auto cancels when reassigned` |
+| SDK enum exhaustiveness | unused `init` switching over SDK enum | `Unused, but added to detect new cases when updating the SDK.` |
+| MVVM-C architecture | empty `ViewModelAction` enum from screen template, unused VM protocol — NEVER delete VM protocols, convention keep them | `required for the architecture` (keep the mark even if a superfluous-comment warning appear — it document intent) |
+| Property wrapper internals | `@propertyWrapper`, `@dynamicMemberLookup` subscript | `property wrappers generate false positives` / `subscript are seen as false positives` |
+| ObjC selector parameter | parameter only touched by runtime (`displayLink`, `sender` etc.) | `ignore:parameters <name> - required for objc selector` |
+| Underscored SwiftUI protocol | `_body` from `TextFieldStyle` etc. — called by SwiftUI, members inside resolve transitively | `called by SwiftUI via the TextFieldStyle protocol` |
+| SDK delegate requirement | method required by rust SDK delegate protocol (e.g. `didRefreshTokens`) | `required by the SDK's delegate protocol` |
+| Synthesized conformance | field only read via synthesized Hashable/Equatable/Codable (cache keys, diffing models) | `used via the synthesized Hashable conformance` |
+| Encoded/decoded schema field | Codable field parsed or serialized but not consumed yet | `documents the schema, parsed but not consumed yet` / `part of the encoded payload` |
+| Release-only code | compiled out in Debug scan (`#if !DEBUG` paths, nightly checks) | `only used in release builds` |
+| `TestablePreview` conformance | flagged "Redundant protocol conformance" on every preview | NO marker, NO removal — Sourcery read conformance, generate snapshot + a11y tests from it. Remove = tests silently vanish. Skip finding, bulk noise |
+
+**Unsure if keep-alive?** Property type Task / AnyCancellable / TaskHandle / coordinator / SDK proxy, assigned inside async or stream setup → smell like keep-alive. ASK USER before delete. Show declaration, where assigned, your read on it.
+
+## Future-use code
+
+Unused but look intentional — API pair completeness, feature half-landed, "team will need soon". No silent delete, no silent keep. Present to user: what, where, opinion keep-or-delete. User say keep → mark `// periphery:ignore - might be useful to have`.
+
+## Mock cascade after protocol deletions
+
+Delete protocol member → Sourcery regenerate mock WITHOUT its `fooReturnValue` / `fooClosure` helpers → hand-written mock `Configuration` inits and test set-up lines still assigning those helpers break the build. Those lines are inert setup for API nothing call — more dead code, not evidence of use. After protocol deletions: grep non-Generated `Mocks/` + `UnitTests/` for `<name>ReturnValue`, `<name>Closure`, direct assignments to deleted members — delete them too. Compiler walk you to the stragglers; that expected, not a false positive.
+
+Careful with same-name members: one mock file often configure SEVERAL protocols (proxy-level `inviter` vs info-level `inviter`). Strip only lines whose target member actually deleted — the wrong one compile fine (member still exist) but silently un-configure previews; snapshot tests catch it, so run them before calling done.
+
+## Verify — on the PLAIN project
+
+Restore the plain configuration BEFORE running tests — snapshots are recorded against plain Element X; Pro branding fail ~8 preview tests falsely:
+
+```bash
+git restore project.yml ElementX.xcodeproj/project.pbxproj "ElementX/Resources/AppIcon.icon/Assets/AppIcon.png"
+xcodegen
+swift run tools ci unit-tests
+```
+
+Sourcery regenerate mocks on build — deleted protocol members clean themselves. All tests pass before call done. Note: the CI helper pipe through `xcbeautify` — if not installed the exit code lie even when tests pass; check the `.xcresult` summary.
+
+## Purge cache — always
+
+Periphery DerivedData cache eat tens of GBs. Scan run rare → cache worthless between runs. Last step, no skip:
+
+```bash
+rm -rf ~/Library/Caches/com.github.peripheryapp
+```
@@ -0,0 +1,323 @@
+---
+name: releasing-healthchat
+description: Cut a HealthChat TestFlight release of element-x-ios by tagging healthchat-v*. Use when the user asks to release, publish, tag, deploy, ship, or cut a new HealthChat iOS version, asks about the TestFlight or App Store release process, asks about renewing the Apple Distribution signing certificate, or asks about the required GitHub Actions secrets for the release pipeline.
+---
+
+# Releasing HealthChat (element-x-ios)
+
+Releases are driven by git tags of the form `healthchat-v<version>` pushed to
+`origin`. The tag triggers `.github/workflows/release-healthchat.yml`, which runs
+on the org's self-hosted macOS runner, builds a signed App Store IPA, and uploads
+it to **TestFlight only**. No GitHub Release is created.
+
+**App Store submission is always a manual step** in App Store Connect after a
+TestFlight build has been validated — see "Promoting to App Store" below.
+
+**HealthChat ships as an in-place update of the legacy element-ios app.** Same
+bundle id (`ch.healthchat.element`), same team (`6G37K72W82`), same App Store
+record. Existing users' keychain and app-group container survive the update. Read
+"The migration contract" before changing anything that looks like an identifier.
+
+## Preflight checklist
+
+Verify each item before tagging. If any fail, fix and commit first.
+
+- [ ] On branch `release/healthchat` with a clean working tree (`git status`).
+- [ ] `HEALTHCHAT_CHANGES.md` has a section `## Changes in <new-version> (<date>)`
+      at the top. The pipeline's awk extractor matches this exact heading format;
+      no match ships a fallback placeholder as the TestFlight "What to Test" text.
+- [ ] The version is **numeric only** — see "Version rules". This is the single
+      most common way to waste 30 minutes here.
+- [ ] `CHANGES.md` is **not** used for HealthChat releases — upstream's
+      `release-to-github` owns it. Only edit `HEALTHCHAT_CHANGES.md`.
+
+## Version rules
+
+**Numeric only. One to three dot-separated integers.** `26.7.4`. Never `26.7.4-rc1`.
+
+**Store version ≠ bundle version, by decision (2026-10-16).** App Store Connect shows
+the 2.x line (2.0.0 shipped the 26.10.1 build; next is 2.1.0), entered by hand when the
+store version is created. The tag/bundle version keeps the calendar scheme and must
+exceed the previous one. Apple tolerates the mismatch today but documents that they
+"should match" — if that ever gets enforced, align the store label to the bundle version.
+
+The marketing version lands verbatim in `CFBundleShortVersionString`, and Apple
+rejects anything that is not at most three period-separated integers. A marker
+version passes the tag regex and every local gate, then dies at the **upload
+step, after ~30 minutes of signing**, with an ITMS error indistinguishable from a
+signing failure.
+
+The Fastfile guards this in `release_testflight`, before any build or signing work. Do not relax that guard.
+
+The legacy element-ios skill documents `-rc1` / `-hotfix1` / `-renew-test` tag
+suffixes. **Do not carry that convention over.** The workflow derives the version
+by stripping only the `healthchat-v` prefix, so a suffix becomes part of the
+version and hits the wall above. Put markers in the release notes, and use the
+`workflow_dispatch` path for test builds.
+
+`project.yml:56`'s `MARKETING_VERSION` is only a default — **the tag is the source
+of truth**, and the pipeline injects the version at build time without touching
+any tracked file. Rebases from upstream will drag `project.yml`'s version around
+(`automatic-calendar-version.yml` no-ops in this fork); ignore it.
+
+## Cutting the release (normal path)
+
+```bash
+# from release/healthchat, fully committed:
+git tag healthchat-v<MAJOR>.<MINOR>.<PATCH>
+git push origin healthchat-v<MAJOR>.<MINOR>.<PATCH>
+```
+
+Example: `git tag healthchat-v26.7.4`
+
+The `healthchat-` prefix keeps these tags clear of upstream's `release/<version>`
+and `nightly/*` namespaces.
+
+The workflow triggers automatically. Watch it with `gh run watch` or the Actions
+UI. The TestFlight build appears in App Store Connect within a few minutes of the
+run finishing (Apple's processing queue).
+
+**Build numbers are not encoded in tags.** `generate_build_number` in
+`fastlane/Fastfile` produces a `YYYYMMDDHHMMSS` timestamp, so ordering is
+monotonic and a retry never collides with a build number Apple has already seen.
+
+## Manual / retry path (workflow_dispatch)
+
+Use when retrying a failed run, testing the pipeline (e.g. cert-renewal
+verification), or rebuilding without moving tags.
+
+1. GitHub → Actions → "Release HealthChat" → **Run workflow**.
+2. Fill in:
+   - **version** (required): e.g. `26.7.99`. Numeric only — same rule as tags.
+   - **release_notes_override** (optional): replaces the `HEALTHCHAT_CHANGES.md`
+     lookup. Use this to mark test builds, since the version cannot carry a marker.
+3. Run. The IPA is built and uploaded to TestFlight exactly as the tag path would.
+
+## Release notes
+
+`HEALTHCHAT_CHANGES.md` is the single source. The workflow extracts the section
+matching the version being released. Format:
+
+```markdown
+## Changes in 26.7.4 (2026-08-01)
+
+🙌 Improvements
+
+- Bullet one.
+- Bullet two.
+```
+
+No matching section emits a workflow warning and falls back to
+`HealthChat <version> — automated build from <ref>.` Prefer fixing the changelog.
+A **missing file** is a hard error, not a fallback.
+
+## After the release
+
+- [ ] Workflow run is green in GitHub Actions.
+- [ ] Build appears under App Store Connect → TestFlight within ~10 minutes.
+- [ ] Internal testers are invited (the auto-distribution group may handle this).
+- [ ] Artifacts (IPA, dSYM, Gym logs) attached to the run, retained 90 days.
+
+## Never commit the post-lane tree
+
+A local lane run rewrites `ElementX.xcodeproj/project.pbxproj` — `xcodegen`
+regenerates it, then `disable_automatic_code_signing` and
+`update_project_provisioning` write Manual signing and profile UUIDs into it. That
+file is tracked.
+
+```bash
+git checkout -- ElementX.xcodeproj
+```
+
+Committing it pins every future build to one machine's profile UUIDs.
+
+## Required GitHub Actions secrets
+
+Five. Missing any fails the workflow at the signing step with a clear error.
+
+| Secret | Source |
+|---|---|
+| `HEALTHCHAT_ASC_KEY_ID` | App Store Connect → Users and Access → Integrations → Team Keys (10-char Key ID) |
+| `HEALTHCHAT_ASC_KEY_ISSUER_ID` | Same page, UUID at the top |
+| `HEALTHCHAT_ASC_KEY_CONTENT` | `.p8` contents including the `-----BEGIN/END PRIVATE KEY-----` lines |
+| `HEALTHCHAT_CERTIFICATES_P12` | Base64 distribution cert (`base64 -i healthchat.p12 \| pbcopy`) |
+| `HEALTHCHAT_CERTIFICATES_P12_PASSWORD` | Password used when exporting the `.p12` |
+
+**There is no `HEALTHCHAT_KEYCHAIN_PASSWORD`.** The legacy skill lists one and the
+legacy workflow references it, but it exists at neither repo nor org level and
+that pipeline runs green anyway — `import-codesign-certs` tolerates its absence.
+Do not add it back.
+
+Managing these needs the `snowping` GitHub account; this repo is INTERNAL and
+invisible to the other account.
+
+## Self-hosted runner requirements
+
+Runs on `novaloop-mac-studio-001` — an **org-level** runner (`[self-hosted,
+macOS, ARM64]`) shared with the legacy fork, not registered per-repo. One machine,
+three names: `novaloop-mac-studio-001` in GitHub, hostname `novaloop-mac-studio-2`
+(macOS appended `-2` in October 2026), `novaloops-mac-studio` on Tailscale.
+
+- **One Xcode, globally selected.** A single install at `/Applications/Xcode.app`
+  (**27.1**, build `27A9275`, since 2026-10-16; upgraded in place via the App Store)
+  — no versioned `Xcode_*.app` siblings. Upstream 26.10.3+ needs the iOS 27 SDK.
+  **Nothing pins it.** The Fastfile builds with whatever `xcode-select` points at, so
+  **whatever the runner has is what ships**. Upgrading the runner's Xcode silently
+  changes the compiler every subsequent release is built with — no tag, no diff, no
+  review. Treat that upgrade as a release-affecting change.
+- **Do not reintroduce a version pin.** Pinning a version the runner lacks sends
+  `xcodes` into a multi-GB authenticated download that no CI secret can satisfy, and
+  the run hangs. Change the runner's Xcode instead.
+- **Toolchain installed once by hand**, never by CI: `xcodegen swiftlint swiftformat
+  xcbeautify xcresultparser pkl` (`xcresultparser` is not in homebrew-core — only
+  `a7ex/homebrew-formulae/xcresultparser` ships it). `git-lfs`, `xcodes`, `brew` and
+  rbenv `ruby`/`bundle` are already present. There is deliberately **no `brew bundle`
+  step and no `Brewfile`**: this machine is shared with CI, and a per-run
+  `brew update` could upgrade `xcodegen` underneath a running release. CI asserts the
+  tools are present and fails loudly naming the fix; it never provisions.
+- **No passwordless sudo.** Nothing in CI may call `sudo` — that is why upstream's
+  `setup_github_actions_environment` cannot run here.
+- **`APPLE_ID`** exported as a machine-level shell variable — the `Appfile` reads
+  it and it is not carried in any secret.
+- Network access to `developer.apple.com`, `api.appstoreconnect.apple.com`,
+  `github.com`, `rubygems.org`.
+
+**A release's only Xcode provenance is its own log.** `release-healthchat.yml` runs
+`xcodebuild -version` (`Record toolchain`) before every build, so each run records the
+compiler that produced it. Nothing pins that version — upgrading the runner's Xcode
+silently changes the compiler every subsequent release is built with, and that log
+line is the only place it shows up. Do not reconstruct a past build's toolchain from
+the runner: it answers for today, not for the build you are asking about. Read the
+run's log.
+
+## Renewing the Apple Distribution certificate (annual)
+
+Apple Distribution certificates are valid for **exactly 1 year**. There is no
+longer-lived option. Last renewed **2026-04-07**, so the next is due around
+**April 2027**. Renew proactively.
+
+1. **~4 weeks before expiry**, check on the Mac holding the private key:
+   ```bash
+   security find-certificate -c "Apple Distribution: E-HealthSolutions GmbH" -p | openssl x509 -noout -enddate
+   ```
+2. **Generate a CSR** on whichever Mac will hold the new private key: Keychain
+   Access → Certificate Assistant → Request a Certificate from a Certificate
+   Authority… → "Saved to disk".
+3. **Apple Developer portal → Certificates** → **+** → Apple Distribution → upload
+   the CSR → download the `.cer` → double-click to install.
+4. **Regenerate all 3 App Store provisioning profiles** — they reference the old
+   cert and become invalid:
+   - `HealthChat App Store`
+   - `HealthChat NSE: App Store`
+   - `HealthChat Share Extension: App Store`
+5. **Verify locally**: archive in Xcode → Distribute App → App Store Connect →
+   Upload. TestFlight accepting the build proves the cert works.
+6. **Export as `.p12`**: Keychain Access → My Certificates → right-click the new
+   `Apple Distribution: E-HealthSolutions GmbH` → Export → set a password.
+7. **Re-encode and update secrets**: `base64 -i healthchat-new.p12 | pbcopy`, then
+   replace `HEALTHCHAT_CERTIFICATES_P12` and `HEALTHCHAT_CERTIFICATES_P12_PASSWORD`.
+8. **Run the workflow** via `workflow_dispatch` with a throwaway numeric version
+   to verify end-to-end. Discard the resulting build.
+9. **Revoke the old cert** once the new one works in both Xcode and CI.
+
+**Keep the expired `.p12` archived for 2 weeks** in case a rollback is needed.
+
+## Promoting a TestFlight build to the App Store
+
+TestFlight and App Store builds are the same binary. To release a validated one:
+
+1. App Store Connect → My Apps → HealthChat → **TestFlight** → find the build.
+2. Confirm it passed internal testing.
+3. **Distribution** tab → **+** next to "iOS App" → "Prepare for Submission" →
+   fill in metadata → **Add for Review**.
+4. Wait for review (24–48 hours typical).
+5. Release manually, or configure automatic release.
+
+**Deliberately not automated.** Automating submission needs `fastlane/metadata/`
+plus HealthChat-branded screenshots (neither exists) and a `Deliverfile`
+refactored for API key auth.
+
+**Before the first submission**, confirm the install base against the iOS floor:
+element-x requires **iOS 18.5**, the legacy required 15.1. Every user below 18.5
+stays on 1.4.1 forever — the App Store will not offer them the update, silently.
+That floor is upstream's and cannot be lowered.
+
+## Rollback
+
+- **Bad build, notes fine** → fix, commit, tag the next patch version. TestFlight
+  supersedes the bad build. (Build numbers are timestamps, so no version games.)
+- **Bad release notes only** → edit `HEALTHCHAT_CHANGES.md`, then update the
+  TestFlight "What to Test" text in App Store Connect by hand — the pipeline only
+  writes it at upload time.
+- **Wrong version number** → treat as burned; tag a higher one.
+- **Rolling back to legacy 1.4.1 loses push** — element-x overwrites the user's
+  sygnal pusher in place on first launch (same app id and pushkey).
+
+## The migration contract
+
+**Read this before "cleaning up" anything.** HealthChat replaces the legacy app in
+place, and these are what stop existing users being silently logged out.
+
+- **`CLASSIC_APP_*` in `Variants/HealthChat/healthchat.yml` is load-bearing.**
+  `ClassicAppManager` reads the legacy account and crypto-store keys through them.
+  Upstream's defaults in `app.yml` point at Element's own `group.im.vector` /
+  `im.vector.app.*`, which this team cannot provision. **Never restore upstream's
+  values.** Failure is silent — `loadAccounts()` throws, and
+  `AuthenticationService` logs it without telling the user or you.
+- **The classic keychain group in `ElementX/SupportingFiles/target.yml` must stay
+  in the `keychain-access-groups` array.** Entitlement arrays live there, never in
+  the variant — XcodeGen concatenates arrays on include-merge and only overrides
+  scalars.
+- **The `.requiresBackup` fall-through in `AuthenticationStartScreenViewModel` is a
+  deliberate upstream divergence.** Upstream sends those accounts to a sheet that
+  tells the user to open Element Classic. That app no longer exists — this update
+  replaced it — and the sheet's button opens a URL scheme nothing registers. A
+  rebase that reverts this reintroduces a dead button.
+- **Both apps share the `group.ch.healthchat` UserDefaults suite**
+  (`AppSettings.swift:56`). An unqualified `@UserPreference` name lands in a suite
+  the legacy also writes to. Collisions are cheap to introduce.
+- **`hasSignedInBefore` voids migration testing.** It lives in that shared suite,
+  survives app deletion, and short-circuits `loadAccounts()`. Any device that has
+  run an element-x HealthChat build shows a plain login screen *while migration
+  works perfectly*. Test on a device that has never run an element-x HealthChat
+  build, or clear the `group.ch.healthchat` suite first;
+  `"Already signed in to Element X before, skipping loadAccounts"` in the log
+  means the run is **void, not failed**. A
+  `"Classic App not configured, skipping loadAccounts"` line is the opposite —
+  the `CLASSIC_APP_*` Info.plist keys are missing, `ClassicAppManager` never
+  initialised, and migration is broken for every user. Investigate, do not
+  dismiss.
+
+## Known branch divergence on rebase
+
+`fastlane/`, `.github/workflows/release-healthchat.yml`, `HEALTHCHAT_CHANGES.md`,
+`Gemfile` and this skill are **fork-only** — upstream element-x-ios has
+no `fastlane/` directory at all. A rebase conflict in any of them means something
+upstream has started to overlap; keep `--ours` and investigate.
+
+What does need watching:
+
+- **`project.yml`'s `MARKETING_VERSION`** — `automatic-calendar-version.yml` and
+  `post-release.yml` are gated on `github.repository == 'element-hq/element-x-ios'`
+  and silently no-op here, so rebases drag upstream's version along. Harmless: the
+  tag is the source of truth.
+- **Upstream files this fork edits** (expect conflicts here on every sync):
+  `AuthenticationStartScreenViewModel` (migration fall-through, see "The migration
+  contract"), `AppHooks/UserHooks.swift` (two HealthChat hook fields),
+  `AppSettings.swift` (VoIP push properties for the NSE), `ElementCallService.swift`
+  (PushKit token storage, expiration parsing), `NSE/Sources/NotificationHandler.swift`
+  (VoIP push request to Sygnal), `UserSessionFlowCoordinator` (Members tab),
+  the `SettingsScreen` files, `RoomMemberDetailsScreen` and `UserProfileScreen`
+  (extended profile section).
+- **Sync strategy: patch stack, like healthchat-web.** `release/healthchat` is
+  upstream's release tag plus the HealthChat commits on top, nothing else. To sync:
+  rebase the stack onto the new upstream tag (or rebuild it from the resolved final
+  tree, one commit per topic), verify tree and tests, then force-push
+  `release/healthchat`. Older release tags keep their commits alive but leave the
+  branch line, as on the web fork after its rebase onto v1.12.21. `AGENTS.md`'s
+  no-rewrite rule is about PR branches; this sync is the one sanctioned rewrite.
+- **Unit tests need an iOS 27 simulator.** Upstream's video-size expectations are
+  encoder-dependent; on iOS 26.5 two `MediaUploadingPreprocessorTests` fail for no
+  real reason.
+- **`app.yml`'s `CLASSIC_APP_*`** — upstream owns these and they stay pointed at
+  Element's ids. The variant overrides them. Do not "fix" `app.yml`.
@@ -0,0 +1,135 @@
+---
+name: syncing-upstream-healthchat
+description: Bring the HealthChat fork (release/healthchat) onto a newer element-hq/element-x-ios release tag. Use when the user asks to rebase, sync, merge or update to upstream, take a new Element X version, or asks why the fork is behind upstream. Covers the patch-stack model, LFS, conflicts, verification, the force-push and the rewind.
+---
+
+# Syncing the HealthChat fork with upstream
+
+`release/healthchat` = upstream release tag + HealthChat commits on top. Patch stack, same as
+healthchat-web. A sync replaces the stack's base and force-pushes the branch. That is the one
+sanctioned history rewrite in this repo; everything else in `AGENTS.md` still holds.
+
+First done 26.09.1 → 26.10.3 (2026-10-16 to 10-19). Numbers below come from that run.
+
+## Before touching anything
+
+- [ ] **Toolchain.** Upstream pins Xcode + iOS in its CI (`runs-on:` in `.github/workflows/`,
+      `#available(iOS N)` in sources). Dev Mac AND the runner need it. 26.10.3 needed Xcode 27 /
+      iOS 27 SDK; the runner still had 26.6 and nobody knew — check `xcodebuild -version` on the
+      Studio (`novaloops-mac-studio` on Tailscale, runner `novaloop-mac-studio-001`). Upgrade via
+      App Store in place, open once for the licence, `xcodebuild -downloadPlatform iOS`.
+- [ ] **Upstream remote.** `git remote add upstream https://github.com/element-hq/element-x-ios.git`
+      then `git fetch upstream tag release/<old> tag release/<new> --no-tags`. Release tags are
+      `release/<version>`. After adding the remote, `gh` resolves to upstream — always pass
+      `-R Novaloop-AG/element-x-ios`.
+- [ ] **A 1.4.1 for the migration test.** Legacy users still exist. No 1.4.1 exists anywhere
+      (TestFlight builds expire, legacy pipeline last built it 2026-04). Build it from Xcode:
+      worktree of `Novaloop-AG/element-ios` at tag `healthchat-v1.4.1`, submodule
+      `matrix-ios-sdk`, `xcodegen`, `pod install`, open `Riot.xcworkspace`, scheme `Riot`,
+      run on the device with automatic signing. Builds on Xcode 27 (warnings only).
+- [ ] **Decisions, product owner:** store version label (stays 2.x, bundle version stays
+      calendar — see releasing skill), new upstream features on/off (26.10.3: search tab on,
+      search breadcrumbs kept).
+
+## The stack
+
+```bash
+git log --oneline release/<old>..release/healthchat --no-merges   # the fork's commits
+git merge-base --is-ancestor release/<old> release/healthchat     # must be true
+```
+
+Upstream files the fork edits — conflicts live here every time:
+`AuthenticationStartScreenViewModel` (migration fall-through, see releasing skill "The
+migration contract"), `AppHooks/UserHooks.swift` (two HealthChat hook fields),
+`AppSettings.swift` (VoIP push properties for the NSE), `ElementCallService.swift` (PushKit
+token, expiration parsing), `NSE/Sources/NotificationHandler.swift` (VoIP push to Sygnal),
+`UserSessionFlowCoordinator` (Members tab), `SettingsScreen*` (account status section, Labs
+gate), the five help URLs are `URL?` (`AppSettings`, `SessionVerificationScreen*`,
+`IdentityConfirmationScreen*`, `SecureBackupScreen*`, `RoomScreenModels` + `RoomScreenFooterView`,
+`SecurityAndPrivacyScreenModels`, `TimelineViewModel` alert — nil hides the "Learn more" link), `UnitTests/Sources/AnalyticsTests.swift` (suite skipped without PostHog secrets),
+`Components/Secrets/Secrets.swift` (analytics/sentry/rageshake nil, hand-edited; upstream's setup
+marks it `assume-unchanged`, so run `git update-index --no-assume-unchanged` on it before an
+edit shows up in `git status` or a commit),
+`RoomMemberDetailsScreen*` + `UserProfileScreen*` (extended profile section), the five fork-gated
+CI workflows, `.gitignore`, `project.pbxproj` (never resolve by hand — `xcodegen`).
+
+## Two ways to rebuild the stack
+
+**A. Plain rebase** — `git rebase --onto release/<new> release/<old> release/healthchat` on a
+scratch branch, resolve per commit. Faithful, but every conflicting commit must be resolved in
+its own context; upstream API removals (26.10.3: `AppHooks.configure(with:)`, `HomeTabsHook`,
+`CommonSettingsProtocol`, `appSettings` out of flow parameters) cannot be "resolved", they
+need new code. Expect rebased intermediates that do not compile; only the tip has to.
+
+**B. Resolve once, assemble the stack** (used for 26.10.3):
+
+1. Scratch branch off `release/healthchat`, `git merge --no-commit release/<new>`, resolve all
+   conflicts once, add the rework commits until it builds and tests pass. This is the
+   *final tree*. Verify it fully (next section) — the stack only reproduces it.
+2. Scratch branch off `release/<new>`, rebase the original commits with conflicts resolved to
+   the fork side blindly (`git checkout --theirs`), then append fix commits whose content is
+   `git checkout <final tree> -- <files>` per topic:
+   `chore(healthchat): resolve the rebase onto upstream <new>` (leftovers: workflows, package
+   pins, Enterprise pointer, start screen), one commit per rework topic, `test(healthchat):
+   refresh snapshots after rebase onto <new>`, docs. Order of fix commits: resolution first.
+3. `git diff --stat <final tree> HEAD` must be empty.
+
+Reproducing historic commits: commit with `--no-verify`, else the SwiftFormat hook rewrites
+them. `git cherry-pick` has no `-q`. In zsh, `for c in $VAR` does not split on newlines and a
+variable named `path` *is* `PATH` — use `while read`, never name a variable `path`.
+
+## Git LFS — the part that bites
+
+- Checkouts/merges done with `GIT_LFS_SKIP_SMUDGE=1` leave pointer files. Run
+  `git lfs checkout` before any test run: media fixtures (`UnitTests/Resources`) as pointers
+  fail `MediaUploadingPreprocessorTests`, `MediaProviderTests`, `VoiceMessageRecorderTests`.
+- origin is a standalone repo; upstream's LFS objects are not there. GitHub rejects a push
+  whose *history* references LFS objects it lacks (`GH008 … unknown Git LFS objects`).
+  `git lfs fetch upstream release/<new>` gets the tip only. Fetch the tree of every upstream
+  commit that touched LFS paths, one by one:
+  ```bash
+  git log --format=%H release/<old>..release/<new> -- '*.png' '*.jpg' '*.gif' '*.mp4' '*.m4a' \
+    | sort -u | while read c; do git lfs fetch upstream "$c"; done
+  git lfs push origin <branch>        # must report no "(missing)"; then git push
+  ```
+  A single missing object = one failed fetch; refetch that commit. 26.10.3: 35 commits, ~5 GB.
+- Snapshot recording (`swift run tools ci preview-tests --record`, iPhone SE 3rd gen,
+  iOS version from `Tools/Sources/Commands/CI/CI.swift`) re-records upstream references too
+  (284 of ~2400 differed on our Mac). Keep only `healthChat*` snapshots; revert upstream's.
+
+## Verification of the final tree
+
+- Build ElementX, NSE, ShareExtension (`xcodebuild build -scheme ElementX` covers all three).
+- Unit tests on an **iOS 27+ simulator** matching upstream's CI OS; two video-size tests are
+  encoder-dependent and fail on older simulators for no reason.
+- Migration guard: `healthChatProviderAllowsLegacyAccount` in
+  `AuthenticationStartScreenViewModelTests` (real hook values → `.welcomeBack`) and
+  `classicAppAccountRequiresBackupFallsThroughToLogin` must pass.
+- Runner: push the branch, `gh workflow run unit-tests.yml --ref <branch>` if the
+  `pull_request` trigger stays silent. A job whose predecessor was cancelled mid-run can crash
+  the test host at launch ("Early unexpected exit … signal kill") — plain re-run.
+- Device matrix (owner): 1.4.1 → new on a never-used device (log "Already signed in to
+  Element X before" = void run, "Classic App not configured" = broken), previous release → new,
+  VoIP ringing on a Debug build (Sygnal `.dev` entries need `platform: sandbox`), push +
+  badges, Members tab next to any new upstream tab.
+
+## Force-push, rewind
+
+```bash
+git push origin <old tip>:refs/heads/backup/release-healthchat-before-<new>
+git push --force-with-lease=release/healthchat:<old tip> origin <stack>:release/healthchat
+git checkout release/healthchat && git reset --hard origin/release/healthchat   # every clone
+```
+
+Branch is unprotected: the push lands immediately. Old release tags keep their commits alive
+and off the branch line. Rewind = `git push --force origin healthchat-v<last>^{commit}:release/healthchat`.
+A rewind does not remove a tag or TestFlight build made on the new history — tag only after
+the device tests. Then update `HEALTHCHAT_CHANGES.md`, the releasing skill (Xcode, divergence
+list) and this skill with what changed.
+
+## What not to do
+
+- Squash the fork into a side branch and *merge* upstream there: merging back into the
+  unsquashed branch conflicts on every file (81 on 26.10.3) and duplicates every commit.
+- Resolve `project.pbxproj` by hand. Commit the post-lane project file. Pull on a rewritten
+  branch (merges the old history back in).
@@ -1,5 +1,5 @@
 UITests/Sources/__Snapshots__/** filter=lfs diff=lfs merge=lfs -text
-DevelopmentAssets/Media/** filter=lfs diff=lfs merge=lfs -text
+Components/DevelopmentAssets/Media/** filter=lfs diff=lfs merge=lfs -text
 UnitTests/__Snapshots__/** filter=lfs diff=lfs merge=lfs -text
 PreviewTests/Sources/__Snapshots__/** filter=lfs diff=lfs merge=lfs -text
 compound-ios/Tests/CompoundTests/__Snapshots__/** filter=lfs diff=lfs merge=lfs -text
@@ -6,7 +6,7 @@ git lfs post-checkout "$@"
 export PATH="$PATH:/opt/homebrew/bin"

 # ignores updates of 'Secrets.swift' to avoid pushing sensitive data by mistake
-git update-index --assume-unchanged Secrets/Secrets.swift
+git update-index --assume-unchanged Components/Secrets/Secrets.swift

 LOCAL_SCRIPT_PATH="$HOME/.local/elementx_local_dev/post-checkout"
 if [ -x "$LOCAL_SCRIPT_PATH" ]; then
@@ -4,6 +4,7 @@
 - [ ] I am aware of the [etiquette](https://github.com/element-hq/element-x-ios/blob/develop/CONTRIBUTING.md#etiquette).
 - [ ] Pull request contains a [changelog label](https://github.com/element-hq/element-x-ios/blob/develop/CONTRIBUTING.md#changelog).
 - [ ] This PR has been made with the help of an LLM.
+  - Model and harness used: <!-- e.g. Claude Opus 5.5 with Claude Code -->

 **UI changes have been tested with:**
 - [ ] iPhone and iPad simulators in portrait and landscape orientations.
@@ -28,6 +28,10 @@ changelog:
      labels:
        - pr-wip

+    - title: 💼 Element Pro
+      labels:
+        - pr-element-pro
+
    - title: Others
      labels:
        - pr-misc
@@ -11,7 +11,12 @@ permissions: {}
 jobs:
  tests:
    name: Tests
-    runs-on: macos-26
+    # HealthChat: skip in this fork. It runs nightly Mon-Fri and fails at checkout, because
+    # permissions: {} leaves a metadata-only token that cannot read an INTERNAL repo. Gated rather
+    # than deleted so the file keeps rebasing cleanly. Run locally with
+    # `swift run tools ci accessibility-tests`.
+    if: github.repository == 'element-hq/element-x-ios'
+    runs-on: xcode-27
    timeout-minutes: 150

    concurrency:
@@ -31,7 +36,7 @@ jobs:
        run: swift run -q tools ci accessibility-tests

      - name: Archive artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        if: failure()
        with:
          name: Results
@@ -13,14 +13,14 @@ permissions: {}
 # Patch bumps are handled by the release script.
 jobs:
  automatic-calendar-version:
-    runs-on: macos-26
+    runs-on: xcode-27
    timeout-minutes: 15

    # Skip in forks
    if: github.repository == 'element-hq/element-x-ios'
    steps:
      - name: Checkout
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false

@@ -20,8 +20,13 @@ permissions: {}

 jobs:
  tests:
-    runs-on: macos-26
-    timeout-minutes: 15
+    # HealthChat: skip in this fork. It only triggers on changes under compound-ios/, which this fork
+    # has never edited, so it would only ever fire on an upstream sync and go red at checkout —
+    # permissions: {} leaves a metadata-only token that cannot read an INTERNAL repo. Gated rather
+    # than deleted so the file keeps rebasing cleanly.
+    if: github.repository == 'element-hq/element-x-ios'
+    runs-on: xcode-27
+    timeout-minutes: 25

    concurrency:
      # When running on develop, use the sha to allow all runs of this workflow to run concurrently.
@@ -34,8 +39,8 @@ jobs:
        with:
          persist-credentials: false

-      - name: Configure Xcode 26
-        run: sudo xcode-select -s /Applications/Xcode_26.5.app
+      - name: Configure Xcode 27
+        run: sudo xcode-select -s /Applications/Xcode_27.app

      - name: Install sourcery
        run: brew install sourcery
@@ -45,11 +50,11 @@ jobs:
        run: sourcery --config Tools/Sourcery/PreviewTestsConfig.yml

      - name: Create simulator
-        run: xcrun simctl create "Snapshots" "iPhone SE (3rd generation)" "com.apple.CoreSimulator.SimRuntime.iOS-26-5"
+        run: xcrun simctl create "Snapshots" "iPhone SE (3rd generation)" "com.apple.CoreSimulator.SimRuntime.iOS-27-0"

      - name: Run tests
        working-directory: compound-ios
-        run: set -o pipefail && xcodebuild test -scheme 'Compound' -sdk iphonesimulator -destination 'platform=iOS Simulator,name=Snapshots,OS=26.5' -skipPackagePluginValidation -resultBundlePath Logs/CompoundTests.xcresult | xcbeautify --renderer github-actions
+        run: set -o pipefail && xcodebuild test -scheme 'Compound' -sdk iphonesimulator -destination 'platform=iOS Simulator,name=Snapshots,OS=27.0' -skipPackagePluginValidation -resultBundlePath Logs/CompoundTests.xcresult | xcbeautify --renderer github-actions

      - name: Zip artifacts
        if: failure() # We only care about artefacts if the tests fail
@@ -57,7 +62,7 @@ jobs:
        run: zip -r Logs/CompoundTests.xcresult.zip Logs/CompoundTests.xcresult/

      - name: Archive artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        if: failure() # We only care about artefacts if the tests fail
        with:
          name: test-results
@@ -66,7 +71,7 @@ jobs:
          if-no-files-found: ignore

      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        with:
          fail_ci_if_error: false
          token: ${{ secrets.CODECOV_TOKEN }}
@@ -1,28 +0,0 @@
-name: Danger CI
-
-on:
-  pull_request:
-    types: [labeled, synchronize, opened, reopened]
-
-permissions: {}
-
-jobs:
-  build:
-    name: Danger
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-
-    concurrency:
-      # Only allow a single run of this workflow on each branch, automatically cancelling older runs.
-      group: ${{ format('danger-ci-{0}', github.ref) }}
-      cancel-in-progress: true
-
-    steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
-        with:
-          persist-credentials: false
-
-      - name: Danger
-        uses: danger/swift@434d7c25f3b02d490a340b23f5e78dd15a5670bc # 3.22.1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -11,7 +11,14 @@ permissions: {}
 jobs:
  integration_tests:
    name: Integration Tests
-    runs-on: macos-26
+    # HealthChat: skip in this fork. It runs nightly Mon-Fri and fails at checkout, and it is the one
+    # job that still calls out to Element's Codecov — its upload guard is true on schedule events, so
+    # it POSTs slug/branch/SHA every night with continue-on-error hiding the failure. Fixing it would
+    # need a real healthchat.ch test account and three new secrets, and would still not work:
+    # HealthChatAppSettingsHook sets allowOtherAccountProviders: false, hiding the change-server UI
+    # these tests drive. Gated rather than deleted so the file keeps rebasing cleanly.
+    if: github.repository == 'element-hq/element-x-ios'
+    runs-on: xcode-27
    timeout-minutes: 45

    concurrency:
@@ -20,7 +27,7 @@ jobs:
      cancel-in-progress: false

    steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false

@@ -35,19 +42,21 @@ jobs:
          INTEGRATION_TESTS_PASSWORD: ${{ secrets.INTEGRATION_TESTS_PASSWORD }}

      - name: Archive artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        # We only care about artefacts if the tests fail
        if: failure()
        with:
          name: Results
-          path: test_output/IntegrationTests.xcresult.zip
+          path: |
+            test_output/IntegrationTests.xcresult.zip
+            test_output/console*
          retention-days: 7
          if-no-files-found: ignore

      - name: Upload coverage to Codecov
        # Skip if not successful and in forks
        if: ${{ success() && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        with:
          report_type: coverage
          files: test_output/integration-cobertura.xml
@@ -59,7 +68,7 @@ jobs:
      - name: Upload test results to Codecov
        # Skip if cancelled and in forks
        if: ${{ !cancelled() && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        continue-on-error: true
        with:
          report_type: test_results
@@ -0,0 +1,109 @@
+name: PR Checks
+
+on:
+  # Privilege escalation necessary to comment on pull requests from forks.
+  # 🚨 We must not check out or execute any code here, and be careful around use of user-controlled inputs.
+  pull_request_target: # zizmor: ignore[dangerous-triggers]
+    types: [opened, reopened, edited, synchronize, labeled, unlabeled]
+
+permissions: {}
+
+jobs:
+  pr-checks:
+    name: PR Checks
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    concurrency:
+      # Only allow a single run of this workflow on each branch, automatically cancelling older runs.
+      group: ${{ format('pr-checks-{0}', github.ref) }}
+      cancel-in-progress: true
+
+    permissions:
+      pull-requests: write
+
+    steps:
+      - name: Check the pull request
+        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const body = pr.body ?? "";
+
+            const files = await github.paginate(github.rest.pulls.listFiles, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: pr.number
+            });
+            const paths = files.map(file => file.filename.toLowerCase());
+
+            const warnings = [];
+            const failures = [];
+
+            if (pr.additions > 1000) {
+              warnings.push("This pull request seems relatively large. Please consider splitting it into multiple smaller ones.");
+            }
+
+            if (!body) {
+              warnings.push("Please provide a description for this PR.");
+            }
+
+            if (paths.some(path => path.includes("/view")) && !body.includes("user-attachments")) {
+              warnings.push("You seem to have made changes to views. Please consider adding screenshots.");
+            }
+
+            if (paths.some(path => path.includes(".xcassets") && path.endsWith(".png"))) {
+              warnings.push("You seem to have made changes to some resource images. Please consider using an SVG or PDF.");
+            }
+
+            if (pr.title.endsWith("…") || /^(Fixes|Fix) #\d+/.test(pr.title) || /^\w+\(\w+\):/.test(pr.title)) {
+              failures.push("Please provide a complete title that can be used as a changelog entry.");
+            }
+
+            if (pr.labels.filter(label => label.name.startsWith("pr-")).length !== 1) {
+              failures.push("Please add a `pr-` label to categorise the changelog entry.");
+            }
+
+            warnings.forEach(warning => core.warning(warning));
+            failures.forEach(failure => core.error(failure));
+
+            // Keep a single comment up to date rather than adding a new one on every run.
+            const marker = "<!-- pr-checks -->";
+            const comments = await github.paginate(github.rest.issues.listComments, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: pr.number
+            });
+            const existing = comments.find(comment => comment.body.includes(marker));
+
+            if (warnings.length || failures.length) {
+              const lines = [...failures.map(failure => `- ❌ ${failure}`),
+                             ...warnings.map(warning => `- ⚠️ ${warning}`)];
+              const commentBody = `${marker}\n### PR Checks\n\n${lines.join("\n")}`;
+
+              if (existing) {
+                await github.rest.issues.updateComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  comment_id: existing.id,
+                  body: commentBody
+                });
+              } else {
+                await github.rest.issues.createComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: pr.number,
+                  body: commentBody
+                });
+              }
+            } else if (existing) {
+              await github.rest.issues.deleteComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: existing.id
+              });
+            }
+
+            if (failures.length) {
+              core.setFailed(`${failures.length} check(s) failed, see the comment on the pull request.`);
+            }
@@ -10,8 +10,8 @@ permissions: {}
 jobs:
  record-snapshots:
    name: Record Preview Snapshots
-    runs-on: macos-26
-    timeout-minutes: 45
+    runs-on: xcode-27
+    timeout-minutes: 60

    if: >
      github.event.label.name == 'record-snapshots' &&
@@ -0,0 +1,133 @@
+name: Release HealthChat
+
+on:
+  push:
+    tags:
+      - 'healthchat-v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Marketing version (e.g. 26.7.4). Must be 1-3 dot-separated integers — Apple rejects anything else.'
+        required: true
+        type: string
+      release_notes_override:
+        description: 'Optional release notes. If empty, falls back to the HEALTHCHAT_CHANGES.md section for the given version.'
+        required: false
+        type: string
+
+permissions:
+  # Minimum needed for actions/checkout to clone an internal repo. The workflow does not push,
+  # comment, or create releases — everything else authenticates with the ASC key and .p12.
+  contents: read
+
+concurrency:
+  group: release-healthchat-${{ github.event.inputs.version || github.ref_name }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Build & upload to TestFlight
+    runs-on: [self-hosted, macOS]
+    timeout-minutes: 90
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+        with:
+          # This repo's only submodule is element-hq's private Enterprise repo, which Novaloop
+          # cannot clone. Checking out submodules fails the job on its very first step.
+          submodules: false
+          persist-credentials: false
+
+      - name: Record toolchain
+        # HealthChat: nothing pins Xcode (the runner carries a single globally-selected one), so this
+        # log line is the only record of which compiler produced a given TestFlight build.
+        run: xcodebuild -version
+
+      - name: Resolve marketing version
+        id: version
+        env:
+          # Read via env, never `${{ }}` inside the script: the input is attacker-controlled text
+          # that GitHub would splice into the shell before the regex below could reject it.
+          INPUT_VERSION: ${{ github.event.inputs.version }}
+        run: |
+          set -euo pipefail
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+            VERSION="$INPUT_VERSION"
+          else
+            VERSION="${GITHUB_REF_NAME#healthchat-v}"
+          fi
+          # Apple caps CFBundleShortVersionString at three integers. The Fastfile guards this too,
+          # but failing here costs seconds instead of a signing run.
+          if ! [[ "$VERSION" =~ ^[0-9]+(\.[0-9]+){0,2}$ ]]; then
+            echo "::error::Invalid marketing version '$VERSION' — expected 1-3 dot-separated integers, e.g. 26.7.4"
+            exit 1
+          fi
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Resolved marketing version: $VERSION"
+
+      - name: Extract release notes
+        id: notes
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+          OVERRIDE: ${{ github.event.inputs.release_notes_override }}
+        run: |
+          set -euo pipefail
+          if [[ -n "$OVERRIDE" ]]; then
+            NOTES="$OVERRIDE"
+            echo "Using release notes from the workflow input"
+          elif [[ ! -f HEALTHCHAT_CHANGES.md ]]; then
+            echo "::error::HEALTHCHAT_CHANGES.md is missing — it is the release-notes source"
+            exit 1
+          else
+            NOTES=$(awk -v ver="$VERSION" '
+              /^## Changes in / {
+                if (found) { exit }
+                if ($0 ~ "## Changes in " ver "( |$|\\()") { found = 1; next }
+              }
+              found { print }
+            ' HEALTHCHAT_CHANGES.md | sed '/^[[:space:]]*$/{N;/^\n$/D;}')
+            if [[ -z "$NOTES" ]]; then
+              NOTES="HealthChat ${VERSION} — automated build from ${GITHUB_REF_NAME}."
+              echo "::warning::No HEALTHCHAT_CHANGES.md section found for $VERSION — using fallback"
+            fi
+          fi
+          {
+            echo 'notes<<NOTES_EOF'
+            echo "$NOTES"
+            echo 'NOTES_EOF'
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Bundle install
+        run: |
+          bundle config path vendor/bundle
+          bundle install --jobs 4 --retry 3
+
+      - name: Import signing certificate
+        uses: apple-actions/import-codesign-certs@b610f78488812c1e56b20e6df63ec42d833f2d14  # v6.0.0
+        with:
+          p12-file-base64: ${{ secrets.HEALTHCHAT_CERTIFICATES_P12 }}
+          p12-password: ${{ secrets.HEALTHCHAT_CERTIFICATES_P12_PASSWORD }}
+
+      - name: Build & upload to TestFlight
+        run: bundle exec fastlane release_testflight
+        env:
+          # Passed via env rather than lane options so multi-line notes containing quotes,
+          # $, or backticks survive without shell escaping.
+          HEALTHCHAT_MARKETING_VERSION: ${{ steps.version.outputs.version }}
+          HEALTHCHAT_RELEASE_NOTES: ${{ steps.notes.outputs.notes }}
+          APPSTORECONNECT_KEY_ID: ${{ secrets.HEALTHCHAT_ASC_KEY_ID }}
+          APPSTORECONNECT_KEY_ISSUER_ID: ${{ secrets.HEALTHCHAT_ASC_KEY_ISSUER_ID }}
+          APPSTORECONNECT_KEY_CONTENT: ${{ secrets.HEALTHCHAT_ASC_KEY_CONTENT }}
+          TEAM_ID: '6G37K72W82'
+
+      - name: Upload artifacts
+        if: always()
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4.6.2
+        with:
+          name: healthchat-${{ steps.version.outputs.version }}
+          path: |
+            out/ElementX.ipa
+            out/ElementX.app.dSYM.zip
+            build/Logs/Gym/*.log
+          retention-days: 90
+          if-no-files-found: warn
@@ -11,7 +11,7 @@ permissions: {}
 jobs:
  update-project:
    name: Update Xcode project
-    runs-on: macos-26
+    runs-on: xcode-27
    timeout-minutes: 20
    permissions:
      contents: write
@@ -25,7 +25,7 @@ jobs:

    steps:
      - name: Checkout
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          ref: ${{ github.head_ref }}
          token: ${{ secrets.ELEMENT_BOT_TOKEN }}
@@ -48,7 +48,7 @@ jobs:
        run: xcodebuild -scheme ElementX -project ElementX.xcodeproj -destination 'generic/platform=iOS Simulator' build

      - name: Update Acknowledgements
-        run: swift-package-list ElementX.xcodeproj --requires-license --ignore-package compound-ios --ignore-package compound-design-tokens --ignore-package matrix-rich-text-editor-swift --ignore-package element-call-swift --output-type settings-bundle --output-path ElementX/SupportingFiles
+        run: swift-package-list ElementX.xcodeproj --requires-license --ignore-package compound-ios --ignore-package compound-design-tokens --ignore-package matrix-rich-text-editor-swift --ignore-package element-call-swift --ignore-package element-call-ios --ignore-package matrix-rust-rtc --output-type settings-bundle --output-path ElementX/SupportingFiles

      - name: Commit and push changes
        run: |
@@ -13,17 +13,21 @@ jobs:
      issues: write
      pull-requests: write
    steps:
-      - uses: actions/stale@eb5cf3af3ac0a1aa4c9c45633dd1ae542a27a899 # v10.3.0
+      - uses: actions/stale@4391f3da665fdf50b6810c1a66712fb9ba21aa93 # v11
        with:
-          only-labels: "X-Needs-Info"
+          labels-to-remove-when-unstale: "X-Needs-Info"
+
+          # Issues
+          only-issue-labels: "X-Needs-Info"
          days-before-issue-stale: 30
          days-before-issue-close: 7
-          days-before-pr-stale: 30
-          days-before-pr-close: 7
-          stale-pr-label: "stale"
-          stale-pr-message: "This pull request has seen no activity for the past 30 days and will now be marked as stale. Please update it or leave a comment within the next 7 days to keep it open."
-          close-pr-message: "This pull request is being closed due to inactivity."
-          stale-issue-label: "stale"
-          labels-to-remove-when-unstale: "X-Needs-Info"
+          stale-issue-label: "Stale"
          stale-issue-message: "This issue has been awaiting further information for the past 30 days so will now be marked as stale. Please provide the requested information within the next 7 days to keep it open."
          close-issue-message: "This issue is being closed due to inactivity after further information was requested."
+
+          # Pull requests
+          days-before-pr-stale: 30
+          days-before-pr-close: 7
+          stale-pr-label: "Stale"
+          stale-pr-message: "This pull request has seen no activity for the past 30 days and will now be marked as stale. Please update it or leave a comment within the next 7 days to keep it open."
+          close-pr-message: "This pull request is being closed due to inactivity."
@@ -9,14 +9,14 @@ permissions: {}

 jobs:
  open-translations-pr:
-    runs-on: macos-26
+    runs-on: xcode-27
    timeout-minutes: 15

    # Skip in forks
    if: github.repository == 'element-hq/element-x-ios'
    steps:
      - name: Checkout
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false

@@ -15,7 +15,13 @@ permissions: {}
 jobs:
  tests:
    name: Tests
-    runs-on: macos-26
+    # HealthChat: skip in this fork. It runs nightly Mon-Fri and fails at checkout, because
+    # permissions: {} leaves a metadata-only token that cannot read an INTERNAL repo. Fixing the
+    # permission would not help: the rebrand changed the start screen without re-recording any
+    # UITests snapshot, so it would fail on content instead. Gated rather than deleted so the file
+    # keeps rebasing cleanly. Run locally with `swift run tools ci ui-tests`.
+    if: github.repository == 'element-hq/element-x-ios'
+    runs-on: xcode-27
    timeout-minutes: 90
    strategy:
      fail-fast: false
@@ -46,7 +52,7 @@ jobs:
          GITHUB_EVENT_INPUTS_TEST_NAME: ${{ github.event.inputs.test_name }}

      - name: Archive artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        # We only care about artefacts if the tests fail
        if: failure()
        with:
@@ -58,7 +64,7 @@ jobs:
      - name: Upload coverage to Codecov
        # Skip if not successful and in forks
        if: ${{ success() && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        with:
          report_type: coverage
          files: test_output/ui-cobertura.xml
@@ -70,7 +76,7 @@ jobs:
      - name: Upload test results to Codecov
        # Skip if cancelled and in forks
        if: ${{ !cancelled() && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        continue-on-error: true
        with:
          report_type: test_results
@@ -13,11 +13,18 @@ permissions: {}
 jobs:
  tests:
    name: Tests (Enterprise)
-    runs-on: macos-26
-    timeout-minutes: 45
+    runs-on: xcode-27
+    timeout-minutes: 60

    # Skip in forks
-    if: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}
+    # HealthChat: this job can never pass in this fork — it needs
+    # secrets.ELEMENT_BOT_TOKEN (Element's bot, absent here) and recursively
+    # checks out the private element-hq/element-ios-enterprise submodule, which
+    # Novaloop cannot obtain. The guard below only asks whether the PR comes
+    # FROM a fork, not whether this repo IS one, so it does not skip us. Gate on
+    # the upstream repo as post-release.yml does. Gated rather than deleted so
+    # the file keeps rebasing cleanly against upstream.
+    if: ${{ github.repository == 'element-hq/element-x-ios' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}

    concurrency:
      # Only allow a single run of this workflow on each branch, automatically cancelling older runs.
@@ -34,14 +41,29 @@ jobs:
      - name: Setup environment
        run: source ci_scripts/ci_common.sh && setup_github_actions_environment

+      - name: Restore compilation cache
+        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/Library/Developer/Xcode/CompilationCache.noindex
+          key: compilation-cache-unit-tests-enterprise-${{ github.sha }}
+          restore-keys: compilation-cache-unit-tests-enterprise-
+
      - name: Configure Enterprise
        run: swift run -q pipeline configure-element-pro

      - name: Run tests
        run: swift run -q tools ci unit-tests --skip-previews

+      - name: Save compilation cache
+        # Only develop populates the cache, all of the other runs simply read from it.
+        if: ${{ !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/develop' }}
+        uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/Library/Developer/Xcode/CompilationCache.noindex
+          key: compilation-cache-unit-tests-enterprise-${{ github.sha }}
+
      - name: Archive artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        # We only care about artefacts if the tests fail
        if: failure()
        with:
@@ -13,27 +13,96 @@ permissions: {}
 jobs:
  tests:
    name: Tests
-    runs-on: macos-26
+    # HealthChat: GitHub-hosted macos-26 could not finish this job inside
+    # timeout-minutes: 60 (two attempts: 51m42s, then killed at 60m44s), and macOS
+    # minutes bill at 10x. novaloop-mac-studio-001 is the org's Mac Studio, already
+    # used by the release pipeline; its labels are [self-hosted, macOS, ARM64].
+    runs-on: [self-hosted, macOS]
+    # Upstream's 60 is kept: with previews skipped (see Run tests) the build plus unit tests measured
+    # ~16 min here. A run approaching this budget is a signal, not normal — the earlier 60m timeouts
+    # were preview tests, not the build.
    timeout-minutes: 60

+    permissions:
+      contents: read # HealthChat: this fork is INTERNAL, so a metadata-only token 404s on checkout (and on git lfs pull). Upstream is public, hence permissions: {} there.
+
    concurrency:
      # Only allow a single run of this workflow on each branch, automatically cancelling older runs.
      group: ${{ format('unit-tests-{0}', github.ref) }}
      cancel-in-progress: true

    steps:
+      # HealthChat: upstream passes persist-credentials: false here, which the
+      # composite forwards to actions/checkout — stripping the auth header before
+      # its separate "Git LFS Pull" step runs. Upstream can afford that because
+      # its repo is public and git lfs pull works anonymously; this fork is
+      # INTERNAL, so the LFS batch endpoint would 404. Keep the composite's own
+      # default (true) so the pull is authenticated with GITHUB_TOKEN.
      - uses: nschloe/action-cached-lfs-checkout@385a8ecc719e50b8c71af6ab01a624b486b7c3bc # v1.2.5
-        with:
-          persist-credentials: false

-      - name: Setup environment
-        run: source ci_scripts/ci_common.sh && setup_github_actions_environment
+      # HealthChat: verify only — never provision. Upstream's
+      # setup_github_actions_environment cannot run on this runner: it calls
+      # `sudo xcode-select -s /Applications/Xcode_26.5.0.app`, but the runner has no
+      # passwordless sudo and no such path (only /Applications/Xcode.app exists), and
+      # it calls `brew update && brew install ...` — novaloop-mac-studio-001 is the
+      # shared release machine, so a per-run `brew update` could upgrade xcodegen
+      # underneath the release pipeline. These tools are installed once by hand; CI
+      # only asserts they are present and fails loudly, naming the fix, if not.
+      - name: Verify environment
+        run: |
+          set -eu
+          missing=""
+          formulae=""
+          for tool in xcodegen swiftlint swiftformat xcbeautify xcresultparser pkl git-lfs; do
+            if ! command -v "$tool" >/dev/null 2>&1; then
+              missing="$missing $tool"
+              case "$tool" in
+                # Not in homebrew-core; only this tap ships it.
+                xcresultparser) formulae="$formulae a7ex/homebrew-formulae/xcresultparser" ;;
+                *) formulae="$formulae $tool" ;;
+              esac
+            fi
+          done
+          if [ -n "$missing" ]; then
+            echo "::error::Missing on self-hosted runner:${missing}. Install by hand on novaloop-mac-studio-001, then re-run: brew install${formulae}"
+            exit 1
+          fi
+          # The Xcode version is no longer pinned anywhere, so this is the only record
+          # of which Xcode built a given run.
+          xcodebuild -version
+
+      - name: Restore compilation cache
+        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/Library/Developer/Xcode/CompilationCache.noindex
+          key: compilation-cache-unit-tests-${{ github.sha }}
+          restore-keys: compilation-cache-unit-tests-

      - name: Run tests
-        run: swift run -q tools ci unit-tests
+        # HealthChat: previews are skipped. PreviewTests renders a snapshot for every preview in the
+        # app and was the entire reason this job could not fit in an hour — it never once finished,
+        # on either runner. Unit tests alone take ~16 min here. Upstream skips them the same way in
+        # unit-tests-enterprise.yml. Cost: preview snapshot regressions are not caught in CI, so
+        # re-record and check them locally when changing UI.
+        env:
+          # HealthChat: VoiceMessageCacheTests cannot write its URLFileProtection.complete cache file on
+          # this runner's simulator (NSCocoaErrorDomain 513) — a runner-environment issue, not a code bug:
+          # the suite passes locally and upstream, and neither recreating+booting the device nor clearing
+          # state fixes it. Skip it here only, via -skip-testing. Drop this once the runner can write
+          # data-protected files again.
+          CI_SKIP_TESTS: VoiceMessageCacheTests
+        run: swift run -q tools ci unit-tests --skip-previews
+
+      - name: Save compilation cache
+        # Only develop populates the cache, all of the other runs simply read from it.
+        if: ${{ !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/develop' }}
+        uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/Library/Developer/Xcode/CompilationCache.noindex
+          key: compilation-cache-unit-tests-${{ github.sha }}

      - name: Archive artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
        # We only care about artefacts if the tests fail
        if: failure()
        with:
@@ -44,8 +113,12 @@ jobs:

      - name: Upload coverage to Codecov
        # Skip if not successful and in forks
-        if: ${{ success() && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        # HealthChat: the existing guard only asks whether the PR comes FROM a
+        # fork, not whether this repo IS one, so it is true here and the step
+        # runs without a CODECOV_TOKEN — which fails the job via
+        # fail_ci_if_error. Gate on the upstream repo as post-release.yml does.
+        if: ${{ success() && github.repository == 'element-hq/element-x-ios' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        with:
          report_type: coverage
          files: test_output/unit-cobertura.xml,test_output/preview-cobertura.xml
@@ -56,8 +129,10 @@ jobs:

      - name: Upload test results to Codecov
        # Skip if cancelled and in forks
-        if: ${{ !cancelled() && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
-        uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v7.0.0
+        # HealthChat: gated on the upstream repo for the same reason as the
+        # coverage step above — no CODECOV_TOKEN exists in this fork.
+        if: ${{ !cancelled() && github.repository == 'element-hq/element-x-ios' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository) }}
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
        continue-on-error: true
        with:
          report_type: test_results
@@ -14,11 +14,13 @@ jobs:
    runs-on: ubuntu-latest
    permissions:
      security-events: write # Required for upload-sarif (used by zizmor-action) to upload SARIF files.
+      contents: read # HealthChat: this fork is INTERNAL, so a metadata-only token 404s on checkout. Upstream is public, hence permissions: {} there.
+      actions: read # HealthChat: upload-sarif additionally needs this on private/internal repos; public upstream does not.
    steps:
      - name: Checkout repository
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
        with:
          persist-credentials: false

      - name: Run zizmor 🌈
-        uses: zizmorcore/zizmor-action@192e21d79ab29983730a13d1382995c2307fbcaa # v0.5.7
+        uses: zizmorcore/zizmor-action@cc914d7f3750a2d13d75c7f184a1060aa0e9d482 # v0.6.4
@@ -18,22 +18,9 @@ DerivedData/
 .swiftpm
 .netrc

-# fastlane
-#
-# It is recommended to not store the screenshots in the git repo.
-# Instead, use fastlane to re-generate the screenshots whenever they are needed.
-# For more information about the recommended setup visit:
-# https://docs.fastlane.tools/best-practices/source-control/#source-control
-
-fastlane/report.xml
-fastlane/Preview.html
-fastlane/screenshots/**/*.png
-fastlane/test_output
-towncrier.toml.tmp
-version_changes.md
-
 build
 /vendor/
+*/xcshareddata/xcodecloud

 ## macOS Files
 .DS_Store
@@ -47,5 +34,19 @@ build
 test_output

 # Only commit Pkl packages (there may be other caches in here).
-Secrets/vendor/*
-!Secrets/vendor/package-2
+Components/Secrets/vendor/*
+!Components/Secrets/vendor/package-2
+
+# fastlane release outputs
+out/
+provisioning_profiles/
+# Regenerated by every fastlane invocation, including on the runner. Ignored rather than
+# committed, matching element-ios.
+fastlane/README.md
+
+# Review working data (per-machine)
+.claude/review-context/
+.claude/review-log.jsonl
+
+# Local SDK development override
+matrix-rust-components-swift
@@ -1,19 +1,31 @@
 project: ElementX.xcodeproj
+# Periphery scans all targets built by these schemes. The ElementX scheme also
+# builds NSE, ShareExtension and MatrixRustSDKMocks as dependencies. Always run
+# the scan with the project configured for the Pro variant so that all of the
+# sources are analysed (see the periphery-cleanup skill).
 schemes:
 - ElementX
 - UnitTests
 - PreviewTests
 - UITests
 - IntegrationTests
-targets:
- ElementX
- NSE
- ShareExtension
- UnitTests
- PreviewTests
- UITests
- IntegrationTests
+- AccessibilityTests
+# Compound is excluded: its Inspector app and package tests aren't part of any
+# scheme in this project, so usage from them is invisible to the analysis.
+index_exclude:
+- "**/*?.build/**/*"
+- "**/SourcePackages/checkouts/**"
+- "compound-ios/**"
 report_exclude:
-  - ElementX/Sources/Mocks/Generated/GeneratedMocks.swift
-  - ElementX/Sources/Mocks/Generated/SDKGeneratedMocks.swift
+- "**/Generated/**"
+# Hand-written mocks: configuration surface is deliberately broader than any test uses.
+- "**/Mocks/**"
+- "ElementX/Sources/Services/AppLock/LAContextMock.swift"
+# Pure payload schema, fields exist to be encoded.
+- "ElementX/Sources/Services/Notification/Manager/APNSPayload.swift"
+# Backports: everything gated on #available, cleaned up with each OS drop.
+- "ElementX/Sources/Other/SwiftUI/Backports.swift"
 retain_swift_ui_previews: true
+# Protocol signatures are contracts (hooks, delegates) — parameters unused in
+# every current conformance are still part of the interface's design.
+retain_unused_protocol_func_params: true
@@ -1,6 +1,6 @@
 --swiftversion 5.6

--exclude **/Sources/**/Generated,vendor,**/Package.swift,Secrets/**
+--exclude **/Sources/**/Generated,vendor,**/Package.swift,Components/Secrets/**,build

 --disable wrapMultiLineStatementBraces
 --disable hoistPatternLet
@@ -3,6 +3,7 @@ disabled_rules:
  - unused_setter_value
  - redundant_discardable_let
  - identifier_name
+  - void_function_in_ternary

 opt_in_rules:
  - force_unwrapping
@@ -17,7 +18,7 @@ included:
 excluded:
  - "*/Sources/Generated/*"
  - Tools/Sources # Our command-line tools use a lot of print commands.
-  - Secrets
+  - Components/Secrets
  - compound-ios/Inspector

 line_length:
@@ -14,6 +14,9 @@ PRs must follow rules. Prefer Xcode MCP tools over terminal commands.
 - **SwiftLint** (.swiftlint.yml) + **SwiftFormat** (.swiftformat) enforce style on build. Warnings show in Xcode. Build before **XcodeRefreshCodeIssuesInFile**.
 - Follow [Swift API Design Guidelines](https://www.swift.org/documentation/api-design-guidelines/) everywhere, Rust SDK wrappers too (`ID` not `Id`, `URL` not `Url`, `configuration` not `config` or `cfg`).
 - File headers live in `IDETemplateMacros.plist`.
+- **Import `SwiftUI`, not `UIKit`** — need `UIPasteboard` etc, `SwiftUI` bring it. `SwiftUI` re-export `Foundation` too, so no `import Foundation` beside it.
+- **Clean Code** (Robert C. Martin) Newspaper order: headline first, detail down. Stepdown rule: caller above callee, calls point down. Tests: test cases first, helpers below. Swift idiom always win on clash.
+- **Member order in type**: properties (stored + computed, public + private) → `init` → functions. `View` types: properties → `init` → views (`body` first) → functions.

 ### Comments

@@ -52,10 +55,12 @@ PRs must follow rules. Prefer Xcode MCP tools over terminal commands.

 ## Pull Request Guidelines

+- New branch from `develop` must not track `develop`.
 - Sentence-style titles (no conventional commits).
 - Exactly one `pr-` label (see `.github/release.yml`).
 - Title = changelog entry — descriptive, no "Fixes #…".
 - Leave description template for developer. Point them to [contributing etiquette](CONTRIBUTING.md#etiquette).
+- Only fill template LLM line: tick box, name model + harness that made PR (e.g. Claude Opus 5.5, Claude Code).
 - Screenshots/videos for visual changes.
 - 500 additions max — split big changes.
 - Commits need title + description. No tiny commits, no massive commits.
@@ -63,6 +68,17 @@ PRs must follow rules. Prefer Xcode MCP tools over terminal commands.

 ---

+## Releasing
+
+HealthChat ship via tag `healthchat-v*` → TestFlight. Full runbook in
+`.agents/skills/releasing-healthchat/SKILL.md`. `release/healthchat` = upstream tag +
+HealthChat commits on top (patch stack). Upstream sync rebase stack, force-push branch —
+only rewrite allowed; procedure in
+`.agents/skills/syncing-upstream-healthchat/SKILL.md`. Read skill before release, cert
+renewal, or touching `fastlane/`. No duplicate runbook here.
+
+---
+
 ## Project Structure

 ### Build System
@@ -269,13 +285,16 @@ Services = where product-level opinions live (Rust SDK stays spec-faithful).
 - Inject via `init` parameters.
 - Screen coordinators get `Parameters` struct with specific dependencies.
 - `CommonFlowParameters` flow-coordinator-only.
- `ServiceLocator` **deprecated** — never use services directly. Always inject from above.
+- `UserSession` = per-account dependency container (`clientProxy`, `userSettings`, `mediaProvider`…).
+  - Need 2+ from it? Pass `userSession` down. Need 1? Pass that one direct.
+  - Receiver may store only pieces it need (e.g. `clientProxy`, `userSettings`).
+  - Never pass `userSession` plus value it already owns (e.g. `userSession` + `userSettings`).

 ---

 ## Concurrency & Actors

- All targets **Swift 6.2**, approachable concurrency.
+- All targets **Swift 6** language mode (`SWIFT_VERSION: 6`), approachable concurrency. Compiler version come from Xcode toolchain.
 - **ElementX** app, **UnitTests** + **PreviewTests**: `SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor` — no redundant `@MainActor`. Other targets (incl. app extensions) nonisolated.
 - Services + data-layer types: `nonisolated` + `Sendable` when background work need.
 - Never `@unchecked Sendable` / `nonisolated(unsafe)`. Dev add these.
@@ -370,6 +389,22 @@ Same pattern for publishers.

 ---

+## Xcode Agent Skills
+
+Apple ship agent skills with Xcode 27. Installed per machine, not in repo. Skill missing? Suggest user export them (Xcode running): `xcrun agent skills export --output-dir <agent skills dir>` (Claude Code: `~/.claude/skills`). User decline? Skip skill, carry on.
+
+Skill clash this file? This file win. Build settings, entitlements, Info.plist keys, targets → `project.yml`/`target.yml` + `xcodegen`, never `.xcodeproj` or Xcode project-write tools (`UpdateTargetBuildSetting`, `AddEntitlement`…). API newer than target's deployment target → `#available`.
+
+| Skill | Best moment |
+|-------|-------------|
+| `swiftui-specialist` | Writing/reviewing views: data flow, `ForEach`/`List` identity, environment, perf. `L10n` + Compound tokens beat its samples. |
+| `device-interaction` | Runtime check of UI/flow change (subagent skill). Xcode must open this checkout. No login: env `UI_TESTS_SCREEN=<UITestsScreenIdentifier case>` launch that case's mock fixture, no real session. `roomLayout*`, `appLockFlow*`, `*Pagination` need UITests runner. |
+| `swiftui-whats-new-27` | SDK 27 `@State`/`@ContentBuilder` compile errors, or adopting iOS 27 SwiftUI APIs. Keep `AlertInfo` alerts. |
+| `modernize-tests` | Modernizing UnitTests suites (`@Test(arguments:)`, `withKnownIssue`, `#require`). XCUI targets stay XCTest. Keep `deferFulfillment`/`waitForConfirmation` — bare `confirmation()` no wait async. No `.serialized`/`@MainActor` adds. |
+| `app-intents-specialist`, `app-intents-whats-new-27` | Adding App Intents/Shortcuts/Siri/controls (full support planned; iOS 26+ APIs → `-whats-new-27`). Not SiriKit `IN*` code. Intent strings need `LocalizedStringResource` — `L10n` return `String`. |
+
+---
+
 ## Key Files

 | File | Purpose |
@@ -378,7 +413,7 @@ Same pattern for publishers.
 | `app.yml` | App-level XcodeGen config |
 | `.swiftlint.yml` | SwiftLint rules |
 | `.swiftformat` | SwiftFormat rules |
-| `Dangerfile.swift` | Danger PR checks |
+| `.github/workflows/pr-checks.yml` | PR metadata checks (title, labels, size, screenshots) |
 | `Package.swift` | SPM manifest (Tools CLI) |
 | `localazy.json` | Localazy translation config |
 | `codecov.yml` | Codecov config |
@@ -53,6 +53,10 @@ final class AccessibilityTests: XCTestCase {
    private func performAccessibilityAuditForPreview(named name: String) {
        // Alows us to log the name of the preview that is being tested
        XCTContext.runActivity(named: name) { _ in
+            // Previews that focus a text field bring up the system keyboard, which we can't fix.
+            // Snapshot the keyboard in one query so one that's dismissing can't fail the test between checking and reading it.
+            let keyboardFrame = (try? app.keyboards.firstMatch.snapshot().frame) ?? .null
+            
            do {
                // We have removed `textClipped` and `contrast` for now
                try app.performAccessibilityAudit(for: [.dynamicType, .elementDetection, .hitRegion, .sufficientElementDescription, .trait]) { issue in
@@ -66,6 +70,11 @@ final class AccessibilityTests: XCTestCase {
                        return true
                    }
                    
+                    // The system keyboard's own elements aren't ours to fix
+                    if keyboardFrame.contains(element.frame) {
+                        return true
+                    }
+                    
                    // We are fine with elements that only partially support dynamic types
                    guard issue.compactDescription != Self.partiallyUnsupportedDynamicTypeMessage else {
                        return true
@@ -98,7 +107,6 @@ final class AccessibilityTests: XCTestCase {
    
    private static let partiallyUnsupportedDynamicTypeMessage = "Dynamic Type font sizes are partially unsupported"
    private static let notHumanReadableMessage = "Label not human-readable"
-    private static let elementHasNoDescription = "Element has no description"
    
    /// Use this array to filter add specific filters to ignore specific issues for certain elements
    private static let ignoredA11yIdentifiers: [String: [FilterType]] = [
@@ -108,11 +116,7 @@ final class AccessibilityTests: XCTestCase {
    /// Use this array to filter add specific filters to ignore specific tests
    private static let ignoredA11yTest: [String: [FilterType]] = [
        // It's an image rendering test doesn't need to have descriptions
-        "RoomAvatarImage_Previews-0": [.auditType(.sufficientElementDescription)],
-        // Empty container slots of the principal search toolbar, system chrome with nothing to describe
-        "SearchScreen_Previews-Empty": [.emptyContainerDescription],
-        "SearchScreen_Previews-No results": [.emptyContainerDescription],
-        "SearchScreen_Previews-Loaded": [.emptyContainerDescription]
+        "RoomAvatarImage_Previews-0": [.auditType(.sufficientElementDescription)]
    ]
 }

@@ -121,8 +125,6 @@ private enum FilterType {
    case compactDescription(String)
    /// Filter by the type of the issue
    case auditType(XCUIAccessibilityAuditType)
-    /// Filter "no description" issues on empty container elements (label + identifier empty), e.g. system toolbar slots
-    case emptyContainerDescription
 }

 private extension Array where Element == FilterType {
@@ -134,14 +136,6 @@ private extension Array where Element == FilterType {
                return true
            case .compactDescription(issue.compactDescription):
                return true
-            case .emptyContainerDescription:
-                if issue.auditType == .sufficientElementDescription,
-                   let element = issue.element,
-                   element.elementType == .other,
-                   element.label.isEmpty,
-                   element.identifier.isEmpty {
-                    return true
-                }
            default:
                break
            }
@@ -7,8 +7,8 @@

 extension AccessibilityTests {

-    func testAdvancedSettingsScreen() async throws {
-        try await performAccessibilityAudit(named: "AdvancedSettingsScreen_Previews")
+    func testActiveCallTimelineItemView() async throws {
+        try await performAccessibilityAudit(named: "ActiveCallTimelineItemView_Previews")
    }

    func testAnalyticsPromptScreen() async throws {
@@ -55,6 +55,10 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "AvatarHeaderView_Previews")
    }

+    func testAvatarSettingsButton() async throws {
+        try await performAccessibilityAudit(named: "AvatarSettingsButton_Previews")
+    }
+
    func testBadgeLabel() async throws {
        try await performAccessibilityAudit(named: "BadgeLabel_Previews")
    }
@@ -183,6 +187,30 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "FullscreenDialog_Previews")
    }

+    func testGalleryRoomTimelineView() async throws {
+        try await performAccessibilityAudit(named: "GalleryRoomTimelineView_Previews")
+    }
+
+    func testHealthChatAccountStatusSection() async throws {
+        try await performAccessibilityAudit(named: "HealthChatAccountStatusSection_Previews")
+    }
+
+    func testHealthChatExtendedProfileSection() async throws {
+        try await performAccessibilityAudit(named: "HealthChatExtendedProfileSection_Previews")
+    }
+
+    func testHealthChatInviteMemberScreen() async throws {
+        try await performAccessibilityAudit(named: "HealthChatInviteMemberScreen_Previews")
+    }
+
+    func testHealthChatMemberDirectoryScreen() async throws {
+        try await performAccessibilityAudit(named: "HealthChatMemberDirectoryScreen_Previews")
+    }
+
+    func testHealthChatProfileEditScreen() async throws {
+        try await performAccessibilityAudit(named: "HealthChatProfileEditScreen_Previews")
+    }
+
    func testHighlightedTimelineItemModifier() async throws {
        try await performAccessibilityAudit(named: "HighlightedTimelineItemModifier_Previews")
    }
@@ -327,6 +355,10 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "LocationSharingScreen_Previews")
    }

+    func testLocationSharingSettingsScreen() async throws {
+        try await performAccessibilityAudit(named: "LocationSharingSettingsScreen_Previews")
+    }
+
    func testLoginScreen() async throws {
        try await performAccessibilityAudit(named: "LoginScreen_Previews")
    }
@@ -359,6 +391,10 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "MediaUploadPreviewScreen_Previews")
    }

+    func testMediaUploadQualitySettingsScreen() async throws {
+        try await performAccessibilityAudit(named: "MediaUploadQualitySettingsScreen_Previews")
+    }
+
    func testMentionSuggestionItemView() async throws {
        try await performAccessibilityAudit(named: "MentionSuggestionItemView_Previews")
    }
@@ -379,10 +415,22 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "MessageText_Previews")
    }

+    func testModerationAndSafetySettingsScreen() async throws {
+        try await performAccessibilityAudit(named: "ModerationAndSafetySettingsScreen_Previews")
+    }
+
+    func testMultiAccountAnnouncementView() async throws {
+        try await performAccessibilityAudit(named: "MultiAccountAnnouncementView_Previews")
+    }
+
    func testNoticeRoomTimelineView() async throws {
        try await performAccessibilityAudit(named: "NoticeRoomTimelineView_Previews")
    }

+    func testNotificationCountBadge() async throws {
+        try await performAccessibilityAudit(named: "NotificationCountBadge_Previews")
+    }
+
    func testNotificationPermissionsScreen() async throws {
        try await performAccessibilityAudit(named: "NotificationPermissionsScreen_Previews")
    }
@@ -479,6 +527,10 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "ReadReceiptsSummaryView_Previews")
    }

+    func testRedactConfirmationView() async throws {
+        try await performAccessibilityAudit(named: "RedactConfirmationView_Previews")
+    }
+
    func testRedactedRoomTimelineView() async throws {
        try await performAccessibilityAudit(named: "RedactedRoomTimelineView_Previews")
    }
@@ -647,10 +699,6 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "SeparatorRoomTimelineView_Previews")
    }

-    func testServerConfirmationScreen() async throws {
-        try await performAccessibilityAudit(named: "ServerConfirmationScreen_Previews")
-    }
-
    func testServerSelection() async throws {
        try await performAccessibilityAudit(named: "ServerSelection_Previews")
    }
@@ -663,6 +711,14 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "SessionVerification_Previews")
    }

+    func testSettingsScreenUserStatusPickerView() async throws {
+        try await performAccessibilityAudit(named: "SettingsScreenUserStatusPickerView_Previews")
+    }
+
+    func testSettingsScreenUserStatusRow() async throws {
+        try await performAccessibilityAudit(named: "SettingsScreenUserStatusRow_Previews")
+    }
+
    func testSettingsScreen() async throws {
        try await performAccessibilityAudit(named: "SettingsScreen_Previews")
    }
@@ -739,10 +795,6 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "SwipeRightAction_Previews")
    }

-    func testSwipeToReplyView() async throws {
-        try await performAccessibilityAudit(named: "SwipeToReplyView_Previews")
-    }
-
    func testTextRoomTimelineView() async throws {
        try await performAccessibilityAudit(named: "TextRoomTimelineView_Previews")
    }
@@ -787,6 +839,10 @@ extension AccessibilityTests {
        try await performAccessibilityAudit(named: "TimelineMediaPreviewRedactConfirmationView_Previews")
    }

+    func testTimelineMessageSelectionActionBar() async throws {
+        try await performAccessibilityAudit(named: "TimelineMessageSelectionActionBar_Previews")
+    }
+
    func testTimelineReactionView() async throws {
        try await performAccessibilityAudit(named: "TimelineReactionView_Previews")
    }
@@ -9,9 +9,6 @@
    }
  ],
  "defaultOptions" : {
-    "addressSanitizer" : {
-      "enabled" : true
-    },
    "codeCoverage" : {
      "targets" : [
        {
@@ -21,7 +18,7 @@
        }
      ]
    },
-    "defaultTestExecutionTimeAllowance" : 120,
+    "defaultTestExecutionTimeAllowance" : 240,
    "environmentVariableEntries" : [

    ],
@@ -36,8 +33,7 @@
      "identifier" : "C0C687DE1D270F9895FEE186",
      "name" : "AccessibilityTests"
    },
-    "testTimeoutsEnabled" : true,
-    "undefinedBehaviorSanitizerEnabled" : true
+    "testTimeoutsEnabled" : true
  },
  "testTargets" : [
    {
@@ -36,7 +36,7 @@ targets:
      base:
        PRODUCT_NAME: AccessibilityTests
        PRODUCT_BUNDLE_IDENTIFIER: ${BASE_BUNDLE_IDENTIFIER}.accessibility.tests
-        SWIFT_VERSION: 6.2
+        SWIFT_VERSION: 6
        SWIFT_APPROACHABLE_CONCURRENCY: YES
      configs:
      # This is required to remove the $(inherited) flags
@@ -1,3 +1,391 @@
+## Changes in 26.09.2 (2026-09-23)
+
+### What's Changed
+
+🙌 Improvements
+* Add an `AccountProvider` type and use it within the authentication flow. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6103
+* Update the Start Chat button's icon. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6179
+
+🐛 Bugfixes
+* Update the read marker colour to match the Figma. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6146
+* Fix some isolation errors when compiling with Swift 6.4. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6148
+* Cancel message edit if content remains unchanged by @thepearl in https://github.com/element-hq/element-x-ios/pull/6153
+* Fix HDR UI bugs on iOS 27.0. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6177
+* Fix the split view layout on iOS 27. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6180
+* Only make toolbar buttons prominent when tinted. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6188
+
+🗣 Translations
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6151
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6164
+
+🚧 In development 🚧
+* Introduce a local mechanism for managing the app's badge count by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6135
+* Various search tab tweaks by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6157
+* Add experimental native calls behind a developer flag by @BillCarsonFr in https://github.com/element-hq/element-x-ios/pull/6159
+* Bump element-call-ios to 0.1.0-rc.7 by @BillCarsonFr in https://github.com/element-hq/element-x-ios/pull/6168
+* Add specific prefix for native call logs by @BillCarsonFr in https://github.com/element-hq/element-x-ios/pull/6169
+* Bump element-call native to 0.1.0-rc.8 by @BillCarsonFr in https://github.com/element-hq/element-x-ios/pull/6181
+
+Others
+* Update Project Dependencies by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6136
+* Fix some SwiftLint warnings. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6149
+* Update zizmorcore/zizmor-action action to v0.6.4 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6155
+* Bump the RustSDK to v26.09.17 by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6160
+* Update codecov/codecov-action action to v7.1.0 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6176
+* Update dependency siteline/SwiftUI-Introspect to v27 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6175
+* Drop Intel device support from the build scripts and project by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6171
+* Update the SDK. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6182
+
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.09.1...release/26.09.2
+
+## Changes in 26.09.1 (2026-09-10)
+
+### What's Changed
+
+✨ Features
+* Add a developer option and selection mode for timeline messages by @Velin92 in https://github.com/element-hq/element-x-ios/pull/6102
+
+🐛 Bugfixes
+* Limit the custom status input to 30 characters. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6139
+* Scope dark mode change only to the presenting sheet by @Velin92 in https://github.com/element-hq/element-x-ios/pull/6144
+
+🚧 In development 🚧
+* Show message counts on room list notification badges by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6132
+
+Others
+* Fix start chat UI test snapshots following copy changes by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6137
+* Add a couple of points about code style/ordering to the AGENTS.md by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6133
+* Update the SDK. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6147
+
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.09.0...release/26.09.1
+
+## Changes in 26.09.0 (2026-09-08)
+
+### What's Changed
+
+✨ Features
+* Autoplay the next voice message if it is the next timeline item. by @Velin92 in https://github.com/element-hq/element-x-ios/pull/6089
+* Add a Mentions room list filter by @ara4n in https://github.com/element-hq/element-x-ios/pull/5885
+* Add support for `<details>` and `<summary>` tags by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6077
+* Redaction reason by @Velin92 in https://github.com/element-hq/element-x-ios/pull/6098
+
+🙌 Improvements
+* Advance the join room screen if we're autojoined by the server by @ara4n in https://github.com/element-hq/element-x-ios/pull/5875
+* Updates to Notification Settings by @americanrefugee in https://github.com/element-hq/element-x-ios/pull/6075
+* Use server name from user id function by @Velin92 in https://github.com/element-hq/element-x-ios/pull/6082
+
+🐛 Bugfixes
+* Fix crash when activating incompatible room filters by @sergeyospanov in https://github.com/element-hq/element-x-ios/pull/6087
+* hide the forward action on live location shares by @thepearl in https://github.com/element-hq/element-x-ios/pull/6091
+* Fix photo picker selection tint on iOS 26 by @thepearl in https://github.com/element-hq/element-x-ios/pull/6095
+* Fix the tab rail flickering on narrow iPad windows by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6107
+* Minor quicklook fixes. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6112
+* Use disambiguated display name for avatar change events by @Velin92 in https://github.com/element-hq/element-x-ios/pull/6131
+
+🗣 Translations
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6088
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6111
+
+🧱 Build
+* Pin project dependencies to exact versions given we have Renovate. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6078
+* Try using Danger with the Node/Docker fix? by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6079
+* Replace danger-swift with a actions/github-script version by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6080
+* Bump the calendar version ready for the next release by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6092
+
+Others
+* Use the `ClientFactory` pattern everywhere replacing raw `ClientBuilders`. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6054
+* Add tests for the UserSessionStore. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6065
+* Update Project Dependencies by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6068
+* Allow copying blocked user id by @Velin92 in https://github.com/element-hq/element-x-ios/pull/6071
+* Don't focus the user status text field during tests. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6076
+* Limit link previews width in the timeline to 300 points. by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6069
+* Fix UI test snapshots following copy changes and filter reordering by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6100
+* Feature flag tweaks by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6096
+* Update dependency siteline/SwiftUI-Introspect to v26.0.2 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6104
+* Update zizmorcore/zizmor-action action to v0.6.3 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6109
+* Bump the RustSDK to v26.09.07 by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6110
+* Update the Enterprise submodule. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6114
+* Update the SDK. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6134
+
+### New Contributors
+* @sergeyospanov made their first contribution in https://github.com/element-hq/element-x-ios/pull/6087
+* @thepearl made their first contribution in https://github.com/element-hq/element-x-ios/pull/6091
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.08.4...release/26.09.0
+
+## Changes in 26.08.4 (2026-08-25)
+
+### What's Changed
+
+✨ Features
+* Enable the User Status feature on supported homeservers. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6059
+
+🐛 Bugfixes
+* Attributed string builder tweaks by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6055
+
+🗣 Translations
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6058
+
+🚧 In development 🚧
+* More tweaks for User Status. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6051
+
+Others
+* Various tweaks and fixes by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6045
+* Update dependency element-hq/compound-design-tokens to v10.2.4 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6048
+* Update the Enterprise submodule by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6053
+* Fix missing back pagination attempt by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6056
+* Stop the integration tests from backgrounding the web authentication session by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6060
+* Preserve the blank lines typed after a list by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6061
+* Update the Enterprise submodule. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6063
+* Fixed one accessibility test and an UI test snapshot by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6064
+* Update sdk to 26.08.25 by @Velin92 in https://github.com/element-hq/element-x-ios/pull/6067
+
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.08.3...release/26.08.4
+
+## Changes in 26.08.3 (2026-08-20)
+
+### What's Changed
+
+✨ Features
+* Load MapLibre lazily instead of at every app launch by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6012
+
+🙌 Improvements
+* Offer Retry and Remove actions with a reason when tapping a failed message by @ara4n in https://github.com/element-hq/element-x-ios/pull/5988
+* Update the toolbars in the Chats/Spaces screens. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6043
+
+🐛 Bugfixes
+* Avoid race conditions between the home screen's crash alert and Sentry's `onLastRunStatusDetermined` by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6017
+* Prevent invalid composer mode crashes by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6018
+* Delay secondary room summary provider setup by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6038
+
+🗣 Translations
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6036
+
+🧱 Build
+* Re-run XcodeGen. by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6040
+
+🚧 In development 🚧
+* Update the SDK fixing some user status bugs. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6037
+* Fix the emoji picker's title when setting a custom status. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6039
+
+Others
+* Update Project Dependencies by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6011
+* Move various top level folder to the `Components` one by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6014
+* Update dependency PostHog to v3.69.1 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/6013
+* Avoid re-applying identical room list filters by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6016
+* Detach the Client's `cacheAccountURL` call by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6019
+* Update the Enterprise submodule. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6023
+* Fix the flaky ElementCallServiceTests by replacing TestClock by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6022
+* Implement TimelineItemProvider diff `truncate` mechanism by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6029
+* Update the SDK. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6030
+* Attempt another kind of fix for the encryption settings UI test by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6035
+* Fail fast on the integration tests when encountering the first failed assert by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6041
+* Various unit test improvements by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6042
+* Update the Enterprise submodule. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6049
+
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.08.2...release/26.08.3
+
+## Changes in 26.08.2 (2026-08-11)
+
+### What's Changed
+
+✨ Features
+* Allow tapping the avatar in the room member bottom sheet to view it fullscreen by @danderson-cont in https://github.com/element-hq/element-x-ios/pull/5989
+
+🙌 Improvements
+* Remove map tiler url from matrix wellknown by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5983
+* Combine the Server Selection screen into the Server Confirmation screen and add autocompletion when entering an account provider. by @mredig in https://github.com/element-hq/element-x-ios/pull/5949
+
+🐛 Bugfixes
+* Fix broken avatar aspect ratio in the share sheet and notifications by @ara4n in https://github.com/element-hq/element-x-ios/pull/5972
+* Fix Pro Max In Call Rotation Bug by @mredig in https://github.com/element-hq/element-x-ios/pull/5990
+* Update the SDK with a fix for read receipts. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5991
+* Fix tracing span panic when accessed from multiple threads by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5996
+* Make sure the Tab Rail's background matches the split view's detail background. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6003
+* Fix a simulcast bug in Element Call. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6009
+
+🗣 Translations
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/5999
+
+🧱 Build
+* Add an HTTP_PROXY environment variable too (also disabled). by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5984
+* Annotate failures for Github Actions so they're easier to spot. by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6004
+* Run XcodeGen by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/6006
+* Drop the `addressSanitizer` and `undefinedBehaviorSanitizer` from the Accessibility and UI tests by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6008
+* Reinforce text typing within XCUITests by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6007
+
+🚧 In development 🚧
+* Add timeouts after verifying the device owner when linking a new device. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5970
+* Show loading/failure states when setting/clearing user status. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5993
+* Enable automatic call status under the User Status feature flag. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5994
+
+Others
+* Update dependency pointfreeco/swift-snapshot-testing to v1.19.4 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5981
+* Add hooks for the RoomDetails, RoomMemberDetails and UserProfile screens. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5980
+* Improve the room member part of the UI test user session flows by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5985
+* Update the SDK and handle some API breaks. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5986
+* Update Contributing.md with snapshot testing instructions by @mredig in https://github.com/element-hq/element-x-ios/pull/5974
+* Update zizmorcore/zizmor-action action to v0.6.2 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5998
+* Set the finalised OAuth Client URI path to match the new EXI page. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5992
+* Improve integration test diagnostics in an attempt to catch run crashes by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6000
+* Prevent invalid snapshots on timeline replies by waiting for the keyboard to appear for longer by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/6001
+* Update the SDK. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/6010
+
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.08.1...release/26.08.2
+
+## Changes in 26.08.1 (2026-08-04)
+
+### What's Changed
+
+✨ Features
+* Render replies to gallery items by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5942
+* Render gallery items in the media browser/gallery by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5955
+
+🙌 Improvements
+* Allow previews in the timeline to include filtered galleries by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5943
+* Set gallery sending limit to 60 when the gallery ff is on by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5960
+* Add a custom TabRail on iPad instead of the top tab bar. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5964
+* Small gallery tweaks by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5957
+* Add call icon next to members in call by @nankeen by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5968
+
+🐛 Bugfixes
+* Fix rageshake upload progress bar by @danderson-cont in https://github.com/element-hq/element-x-ios/pull/5950
+* Fix for pagination getting stuck loading when swiping media previews in the timeline by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5963
+* Manually publish room list range updates when the content isn't scrollable by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5956
+
+🗣 Translations
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/5965
+
+🦻 Accessibility
+* A11y for Galleries by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5969
+
+🚧 In development 🚧
+* Fix a couple of missing `UserStatus` values. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5944
+* Allow clearing your own call status. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5959
+
+Others
+* Fix for some flaky tests part 2 by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5939
+* Update the Enterprise submodule. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5953
+* Update zizmorcore/zizmor-action action to v0.6.1 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5961
+* Update Project Dependencies by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5940
+* Update actions/stale action to v11 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5971
+* Accessibility tests fixes by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5976
+* Disable the store pausing feature as we encountered cases in which it doesn't work properly by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5977
+* Fix various UI test snapshots by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5975
+* Tweak the stalebot configuration by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5978
+
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.08.0...release/26.08.1
+
+## Changes in 26.08.0 (2026-07-28)
+
+### What's Changed
+
+✨ Features
+* Add support for active call item rendering in timeline by @BillCarsonFr in https://github.com/element-hq/element-x-ios/pull/5775
+* Add content scanner to the NSE Client by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5926
+* Render image and video in galleries as a grid by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5929
+* Render galleries with non-visual attachments as a list by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5932
+* Open a full-screen preview when tapping a gallery item by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5936
+
+🙌 Improvements
+* Report user presence on app lifecycle transitions by @lhjt in https://github.com/element-hq/element-x-ios/pull/5838
+* Content scanner also checks for thumbnails by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5911
+* Remove the requiresExtraAccountSetup badge. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5921
+* Implements push notifications for LLS via MSC4505 by @ara4n in https://github.com/element-hq/element-x-ios/pull/5872
+
+🐛 Bugfixes
+* Enable client pausing and resuming for all builds by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5904
+
+🗣 Translations
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/5901
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/5931
+
+🧱 Build
+* Re-run xcodegen. by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/5907
+* Bump the calendar version ready for the next release by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/5937
+
+📄 Documentation
+* Group Element Pro changes into a dedicated release notes section by @manuroe in https://github.com/element-hq/element-x-ios/pull/5899
+
+🚧 In development 🚧
+* Add the UI for your own user status in the Settings screen. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5888
+* Support sending gallery messages behind a feature flag by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5909
+* Update the SDK and hook up the status from Room Heroes. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5905
+* Hook up the emoji picker to the custom status row. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5902
+* Search tab tweaks by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5910
+* Add support for showing the user's own status over their avatar on the app's Settings button. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5912
+* Add a warning to the Link New Device instructions. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5916
+* Add the gallery timeline item rendered as a placeholder by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5928
+* Gate user status behind server support as well as the feature flag. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5920
+
+Others
+* Update dependency pointfreeco/swift-snapshot-testing to v1.19.3 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5892
+* Update enterprise by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5894
+* Update dependency Sentry to v9.21.0 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5891
+* Update actions/stale action to v10.4.0 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5898
+* Several small, independent accessibility fixes (VoiceOver labels/traits, contrast) by @unclejay80 in https://github.com/element-hq/element-x-ios/pull/5890
+* Periphery cleanup by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5893
+* Various project warning fixes by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5908
+* Add signed in flag to the developer options screen hook by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5914
+* Update zizmorcore/zizmor-action action to v0.6.0 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5917
+* Update SDK to 26.07.22 by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5919
+* Small tweaks to the Presence feature. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5918
+* Fix call timeline item snapshots. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5923
+* Bump the RustSDK to v26.07.23 by @stefanceriu in https://github.com/element-hq/element-x-ios/pull/5925
+* Update actions/checkout action to v7.0.1 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5935
+* Add an `oAuthClientURIPath` option to AppSettings. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5934
+* update sdk to 26-7-28 by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5938
+
+### New Contributors
+* @unclejay80 made their first contribution in https://github.com/element-hq/element-x-ios/pull/5890
+* @lhjt made their first contribution in https://github.com/element-hq/element-x-ios/pull/5838
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.07.4...release/26.08.0
+
+## Changes in 26.07.4 (2026-07-15)
+
+### What's Changed
+
+✨ Features
+* Force Disable E2EE for Element Pro by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5866
+
+🙌 Improvements
+* Use dark theme for Element Call by @toger5 in https://github.com/element-hq/element-x-ios/pull/5860
+
+🐛 Bugfixes
+* Fix for NSE and ShareExtension individual builds by @mredig in https://github.com/element-hq/element-x-ios/pull/5856
+* Fix CurrentValuePublisher.map dropping updates when the mapped publisher is chained inline by @ara4n in https://github.com/element-hq/element-x-ios/pull/5870
+* Fix a bug where rooms couldn't be opened when returning to the foreground whilst offline. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5867
+
+🗣 Translations
+* Translations update by @RiotRobot in https://github.com/element-hq/element-x-ios/pull/5865
+
+🧱 Build
+* Fix UI tests by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5862
+* Add CurrentValuePublisherTests to the UnitTests target by @ara4n in https://github.com/element-hq/element-x-ios/pull/5884
+
+🚧 In development 🚧
+* Display other users' User Status. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5859
+
+Others
+* Update the SDK and Compound tokens. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5857
+* Use deferFulfillment in flow coordinator tests by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5861
+* Update the SDK and handle API breaks. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5871
+* Fix for flaky tests by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5869
+* Constrained tests tool implementation + skill by @Velin92 in https://github.com/element-hq/element-x-ios/pull/5873
+* Update dependency Mantis to v3 by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5887
+* Update Project Dependencies by @renovate[bot] in https://github.com/element-hq/element-x-ios/pull/5886
+* Update the SDK. by @pixlwave in https://github.com/element-hq/element-x-ios/pull/5889
+
+
+**Full Changelog**: https://github.com/element-hq/element-x-ios/compare/release/26.07.3...release/26.07.4
+
 ## Changes in 26.07.3 (2026-07-09)

 ### What's Changed
@@ -30,7 +30,7 @@ Only once all of the above is met should you open a PR with your proposed change
 	* Don't submit large PRs, especially if not previously talked about. Anything above 200 lines is large (excluding generated code e.g. tests, translations, mocks)
 	* Please don't open unfinished PRs and expect us to fill in the details
 	* If you would like our opinion/direction on unfinished code please link your branch or idea in the ticket
-	* Please limit the number of commits in a single PR. We are perfectly happy with splitting work across multiple sessions as long as they're logically independant and show promise of progress (ideally expressed through a ticket)
+	* Please limit the number of commits in a single PR. We are perfectly happy with splitting work across multiple sessions as long as they're logically independent and show promise of progress (ideally expressed through a ticket)
 	* Each and every commit should stand on its own, clearly explaining what it does and why
 * Once a PR goes into review please don't rewrite the history unless agreed so with the reviewer.
 	* Tweaks and fixes following review can be directly committed (to be interactively rebased later) or as fixups
@@ -95,6 +95,14 @@ git lfs install

 If you make changes to the UI you may cause existing UI and Preview test snapshots to fail. The UITests run user flows and record snapshots while doing so using the settings defined under [checkEnvironments](https://github.com/element-hq/element-x-ios/blob/c29175d1f924e58b9646a200dbab0301fce3c258/UITests/Sources/Application.swift#L35-L37) while the PreviewTests use the settings defined in [PreviewTests.swift](https://github.com/element-hq/element-x-ios/blob/c29175d1f924e58b9646a200dbab0301fce3c258/PreviewTests/Sources/PreviewTests.swift#L18-L20). The snapshots are stored under `Sources/__Snapshots__` in their respective target's folder. 

+To run the preview tests:
+
+1. Use an iPhone SE (3rd generation) simulator running iOS 27.0.
+2. On that simulator, go to Settings -> General -> Language & Region and select United States as the region, with English (US) as the only preferred language. This is a one time setup, as long as you keep using the same simulator.
+3. Select the `PreviewTests` scheme and run the tests.
+
+Newly created screens will automatically have their screenshots added based off their `TestablePreview` Swift previews. If you are modifying an existing screen, you will first need to delete the old snapshots for that screen before running the tests. Alternatively, if you enable `RECORD_FAILURES` in the preview test plans's environment variables (`PreviewTests/SupportingFiles/Previewtests.xctestplan`), it will overwrite snapshot failures with the updated screenshot.
+
 ### Githooks

 The project uses its own shared githooks stored in the .githooks folder, you will need to configure git to use such folder, this is already done if you have run the setup tool with `swift run tools setup-project` otherwise you would need to run:
@@ -142,7 +150,7 @@ Our [changelog](CHANGES.md) is automatically generated by GitHub, based on the P
 For Swift coding style we use [SwiftLint](https://github.com/realm/SwiftLint) to check some conventions at compile time (rules are located in the `.swiftlint.yml` file). 
 Otherwise please have a look to [Apple Swift conventions](https://swift.org/documentation/api-design-guidelines.html#conventions). We are also using some of the conventions of [raywenderlich.com Swift style guide](https://github.com/raywenderlich/swift-style-guide).

-We enforce the coding style by running checks on the CI for every PR through [Danger](Dangerfile.swift), [SwiftLint](.swiftlint.yml), [SwiftFormat](.swiftformat) and [SonarCloud](https://sonarcloud.io/project/overview?id=element-x-ios)
+We enforce the coding style by running checks on the CI for every PR through [PR Checks](.github/workflows/pr-checks.yml), [SwiftLint](.swiftlint.yml), [SwiftFormat](.swiftformat) and [SonarCloud](https://sonarcloud.io/project/overview?id=element-x-ios)

 We also gather coverage reports on every PR through [Codecov](https://app.codecov.io/gh/element-hq/element-x-ios) and will eventually start enforcing minimums.

@@ -6,8 +6,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/swiftlang/swift-syntax",
      "state" : {
-        "revision" : "79e4b74a295b6eb74a8b585e3a39d29e70c1dbd1",
-        "version" : "603.0.2"
+        "revision" : "050f1a346fbbac0ca2cfb15a95274f7bd1cf0ccf",
+        "version" : "604.0.0"
      }
    }
  ],
@@ -5,12 +5,15 @@ import PackageDescription

 let package = Package(
    name: "BuildExtensions",
-    platforms: [.macOS(.v15)],
+    platforms: [
+        .macOS(.v15),
+        .iOS(.v18) // Only necessary for Previews
+    ],
    products: [
        .library(name: "Macros", targets: ["Macros"])
    ],
    dependencies: [
-        .package(url: "https://github.com/swiftlang/swift-syntax", from: "603.0.2")
+        .package(url: "https://github.com/swiftlang/swift-syntax", from: "604.0.0")
    ],
    targets: [
        // The public macro declarations imported by the app.
@@ -0,0 +1,16 @@
+//
+// Copyright 2026 Element Creations Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+/// Exposes a `Mutex`-backed hook as a read-only computed property, alongside a `register<Name>`
+/// peer that swaps in a replacement hook.
+///
+/// The `default` argument provides the hook used until (and unless) a replacement is registered.
+/// The enclosing type must have `Synchronization` in scope for the generated `Mutex` storage.
+@attached(accessor)
+@attached(peer, names: arbitrary)
+public macro AppHook<Value>(default: Value) =
+    #externalMacro(module: "MacrosImplementation", type: "AppHookMacro")
@@ -16,7 +16,7 @@
 /// persisted under a legacy key).
 ///
 /// A `reset<Name>()` method is also generated, which clears the stored value so it reverts to the
-/// default.
+/// default. Non-volatile preferences also get a `<name>Key` property exposing the storage key.
@attached(accessor)
@attached(peer, names: arbitrary)
 public macro UserPreference<Value>(key: String? = nil, defaultValue: Value, volatile: Bool = false) =
@@ -27,3 +27,13 @@ public macro UserPreference<Value>(key: String? = nil, defaultValue: Value, vola
@attached(peer, names: arbitrary)
 public macro UserPreference(key: String? = nil, volatile: Bool = false) =
    #externalMacro(module: "MacrosImplementation", type: "UserPreferenceMacro")
+
+/// The storage key of a `@UserPreference`, distinct from `String` so that only a generated
+/// `<name>Key` property can be passed where a preference key is expected.
+public struct UserPreferenceKey: Sendable {
+    public let rawValue: String
+    
+    public init(_ rawValue: String) {
+        self.rawValue = rawValue
+    }
+}
@@ -0,0 +1,98 @@
+//
+// Copyright 2026 Element Creations Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+import SwiftSyntax
+import SwiftSyntaxMacros
+
+/// Implements `@AppHook`. The generated property reads through a `Mutex`-backed store, and a
+/// generated `register<Name>` method swaps in a replacement hook.
+enum AppHookMacro {
+    enum DiagnosticError: Error, CustomStringConvertible {
+        case notAStoredProperty
+        case missingTypeAnnotation
+        case missingDefault
+        
+        var description: String {
+            switch self {
+            case .notAStoredProperty:
+                "@AppHook can only be applied to a stored property."
+            case .missingTypeAnnotation:
+                "@AppHook requires an explicit type annotation."
+            case .missingDefault:
+                "@AppHook requires a default value."
+            }
+        }
+    }
+    
+    private struct AppHook {
+        let name: String
+        let type: TypeSyntax
+        let defaultValue: ExprSyntax
+        
+        var storageName: TokenSyntax {
+            "_\(raw: name)"
+        }
+        
+        var registerMethodName: TokenSyntax {
+            "register\(raw: name.prefix(1).uppercased() + name.dropFirst())"
+        }
+    }
+    
+    private static func appHook(for declaration: some DeclSyntaxProtocol, node: AttributeSyntax) throws -> AppHook {
+        guard let variable = declaration.as(VariableDeclSyntax.self),
+              let binding = variable.bindings.first,
+              let identifier = binding.pattern.as(IdentifierPatternSyntax.self)?.identifier else {
+            throw DiagnosticError.notAStoredProperty
+        }
+        guard let type = binding.typeAnnotation?.type.trimmed else {
+            throw DiagnosticError.missingTypeAnnotation
+        }
+        
+        var defaultValue: ExprSyntax?
+        if let list = node.arguments?.as(LabeledExprListSyntax.self) {
+            for argument in list where argument.label?.text == "default" {
+                defaultValue = argument.expression
+            }
+        }
+        guard let defaultValue else {
+            throw DiagnosticError.missingDefault
+        }
+        
+        return AppHook(name: identifier.text, type: type, defaultValue: defaultValue)
+    }
+}
+
+extension AppHookMacro: AccessorMacro {
+    static func expansion(of node: AttributeSyntax,
+                          providingAccessorsOf declaration: some DeclSyntaxProtocol,
+                          in context: some MacroExpansionContext) throws -> [AccessorDeclSyntax] {
+        let appHook = try appHook(for: declaration, node: node)
+        return [
+            """
+            get {
+                \(appHook.storageName).withLock { $0 }
+            }
+            """
+        ]
+    }
+}
+
+extension AppHookMacro: PeerMacro {
+    static func expansion(of node: AttributeSyntax,
+                          providingPeersOf declaration: some DeclSyntaxProtocol,
+                          in context: some MacroExpansionContext) throws -> [DeclSyntax] {
+        let appHook = try appHook(for: declaration, node: node)
+        return [
+            "private let \(appHook.storageName) = Mutex<\(appHook.type)>(\(appHook.defaultValue))",
+            """
+            func \(appHook.registerMethodName)(_ hook: \(appHook.type)) {
+                \(appHook.storageName).withLock { $0 = hook }
+            }
+            """
+        ]
+    }
+}
@@ -10,5 +10,5 @@ import SwiftSyntaxMacros

@main
 struct BuildExtensionsPlugin: CompilerPlugin {
-    let providingMacros: [Macro.Type] = [UserPreferenceMacro.self]
+    let providingMacros: [Macro.Type] = [UserPreferenceMacro.self, AppHookMacro.self]
 }
@@ -14,7 +14,7 @@ import SwiftSyntaxMacros
 ///
 /// A `volatile` preference instead reads and writes through a generated in-memory store, so its
 /// value is never persisted and resets on each launch.
-public enum UserPreferenceMacro {
+enum UserPreferenceMacro {
    enum DiagnosticError: Error, CustomStringConvertible {
        case notAStoredProperty
        case missingTypeAnnotation
@@ -45,6 +45,10 @@ public enum UserPreferenceMacro {
            "_\(raw: name)VolatileValue"
        }
        
+        var keyPropertyName: TokenSyntax {
+            "\(raw: name)Key"
+        }
+        
        var resetMethodName: TokenSyntax {
            "reset\(raw: name.prefix(1).uppercased() + name.dropFirst())"
        }
@@ -85,9 +89,9 @@ public enum UserPreferenceMacro {
 }

 extension UserPreferenceMacro: AccessorMacro {
-    public static func expansion(of node: AttributeSyntax,
-                                 providingAccessorsOf declaration: some DeclSyntaxProtocol,
-                                 in context: some MacroExpansionContext) throws -> [AccessorDeclSyntax] {
+    static func expansion(of node: AttributeSyntax,
+                          providingAccessorsOf declaration: some DeclSyntaxProtocol,
+                          in context: some MacroExpansionContext) throws -> [AccessorDeclSyntax] {
        let preference = try preference(for: declaration, node: node)
        
        if preference.isVolatile {
@@ -137,9 +141,9 @@ extension UserPreferenceMacro: AccessorMacro {
 }

 extension UserPreferenceMacro: PeerMacro {
-    public static func expansion(of node: AttributeSyntax,
-                                 providingPeersOf declaration: some DeclSyntaxProtocol,
-                                 in context: some MacroExpansionContext) throws -> [DeclSyntax] {
+    static func expansion(of node: AttributeSyntax,
+                          providingPeersOf declaration: some DeclSyntaxProtocol,
+                          in context: some MacroExpansionContext) throws -> [DeclSyntax] {
        let preference = try preference(for: declaration, node: node)
        let type = preference.type
        let name = preference.name
@@ -157,6 +161,14 @@ extension UserPreferenceMacro: PeerMacro {
        }
        """)
        
+        if !preference.isVolatile {
+            peers.append("""
+            var \(preference.keyPropertyName): UserPreferenceKey {
+                .init(\(preference.key))
+            }
+            """)
+        }
+        
        peers.append(resetMethod(for: preference))
        
        return peers
@@ -5,7 +5,7 @@
 // Please see LICENSE files in the repository root for full details.
 //

-import MacrosImplementation
+@testable import MacrosImplementation
 import SwiftSyntaxMacrosTestSupport
 import XCTest

@@ -35,6 +35,10 @@ final class UserPreferenceMacroTests: XCTestCase {
                                 _hasSeenNewSoundBannerSubject.prepend(hasSeenNewSoundBanner).eraseToAnyPublisher()
                             }
                             
+                             var hasSeenNewSoundBannerKey: UserPreferenceKey {
+                                 .init("hasSeenNewSoundBanner")
+                             }
+                             
                             func resetHasSeenNewSoundBanner() {
                                 store.removeObject(forKey: "hasSeenNewSoundBanner")
                             }
@@ -65,6 +69,10 @@ final class UserPreferenceMacroTests: XCTestCase {
                                 _liveLocationSharingSessionsByRoomIDSubject.prepend(liveLocationSharingSessionsByRoomID).eraseToAnyPublisher()
                             }
                             
+                             var liveLocationSharingSessionsByRoomIDKey: UserPreferenceKey {
+                                 .init("liveLocationSharingTimeoutDatesByRoomID")
+                             }
+                             
                             func resetLiveLocationSharingSessionsByRoomID() {
                                 store.removeObject(forKey: "liveLocationSharingTimeoutDatesByRoomID")
                             }
@@ -95,6 +103,10 @@ final class UserPreferenceMacroTests: XCTestCase {
                                 _pusherProfileTagSubject.prepend(pusherProfileTag).eraseToAnyPublisher()
                             }
                             
+                             var pusherProfileTagKey: UserPreferenceKey {
+                                 .init("pusherProfileTag")
+                             }
+                             
                             func resetPusherProfileTag() {
                                 store.removeObject(forKey: "pusherProfileTag")
                             }
@@ -125,6 +137,10 @@ final class UserPreferenceMacroTests: XCTestCase {
                                 _viewSourceEnabledSubject.prepend(viewSourceEnabled).eraseToAnyPublisher()
                             }
                             
+                             var viewSourceEnabledKey: UserPreferenceKey {
+                                 .init("viewSourceEnabled")
+                             }
+                             
                             func resetViewSourceEnabled() {
                                 store.removeObject(forKey: "viewSourceEnabled")
                             }
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0b1465b1e379f4356e0cbde2ecc1a9cd2a58c7a69be7ca9f7b3b2df2e911e60c
+size 2004302
@@ -0,0 +1,19 @@
+//
+// Copyright 2026 Element Creations Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+import SwiftUI
+
+/// Implemented by MapLibreShim's entry point, which the app instantiates after
+/// `dlopen`-ing the framework.
+public protocol MapLibreShimProtocol {
+    /// Routes MapLibre's logs into the app's logger. Call once after loading the shim.
+    func configureLogging(_ handler: @escaping @Sendable (MapLogSeverity, String) -> Void)
+    
+    /// Builds the interactive map view. The app-side `MapLibreMapView` forwards every
+    /// body evaluation here so SwiftUI updates flow through to the underlying map.
+    func makeMapView(configuration: MapViewConfiguration) -> AnyView
+}
@@ -0,0 +1,56 @@
+//
+// Copyright 2026 Element Creations Ltd.
+// Copyright 2023-2025 New Vector Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+import CoreLocation
+import Foundation
+
+/**
+ Behavior mode of the current user's location, can be hidden, only shown and shown following the user
+ */
+public enum ShowUserLocationMode: Equatable {
+    /// this mode will show the user pin in map
+    case show
+    /// this mode will show the user pin in map and track him, panning the map automatically
+    case showAndFollow
+    /// this mode will not show the user pin in map
+    case hide
+    /// this mode will not show the user pin in map and will follow the marker with the given id,
+    /// panning the map automatically.
+    case hideAndFollowMarker(id: String)
+    
+    /// The id of the marker the map should follow when in the `hideAndFollowMarker` mode, nil otherwise.
+    public var followedMarkerID: String? {
+        guard case .hideAndFollowMarker(let id) = self else { return nil }
+        return id
+    }
+}
+
+public enum MapLibreError: Error, Hashable {
+    case failedLoadingMap
+    case failedLocatingUser
+}
+
+/// The severity of a map log message forwarded to the app.
+public enum MapLogSeverity {
+    case error
+    case warning
+    case info
+    case debug
+    case verbose
+}
+
+/// A marker shown on the map, identified so that it can be moved in place when its coordinate changes.
+public struct MapAnnotation {
+    public let id: String
+    public let coordinate: CLLocationCoordinate2D
+    
+    public init(id: String, coordinate: CLLocationCoordinate2D) {
+        self.id = id
+        self.coordinate = coordinate
+    }
+}
@@ -0,0 +1,76 @@
+//
+// Copyright 2026 Element Creations Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+import CoreLocation
+import SwiftUI
+
+/// Everything the map implementation needs in order to render, expressed without app
+/// types so that the implementation framework can be loaded on demand.
+public struct MapViewConfiguration {
+    /// the final zoom level used when the first user location emit
+    public let zoomLevel: Double
+    /// The initial zoom level used when the map it firstly loaded and the user location is not yet available, in case of annotations this property is not being used
+    public let initialZoomLevel: Double
+    
+    /// The initial map center
+    public let mapCenter: CLLocationCoordinate2D
+    
+    /// Map annotations
+    public let annotations: [MapAnnotation]
+    
+    /// The style to load the map with, for either the dark or the light appearance.
+    public let styleURL: (_ isDark: Bool) -> URL?
+    
+    public let tintColor: UIColor
+    
+    /// The content of the marker representing the annotation with the given id.
+    public let markerView: (_ annotationID: String) -> AnyView?
+    
+    /// Behavior mode of the current user's location, can be hidden, only shown and shown following the user
+    public let showsUserLocationMode: Binding<ShowUserLocationMode>
+    /// Bind view errors if any
+    public let error: Binding<MapLibreError?>
+    /// Coordinate of the center of the map
+    public let mapCenterCoordinate: Binding<CLLocationCoordinate2D?>
+    public let hasLoadedUserLocation: Binding<Bool>
+    public let isLocationAuthorized: Binding<Bool?>
+    /// The radius of uncertainty for the location, measured in meters.
+    public let geolocationUncertainty: Binding<CLLocationAccuracy?>
+    
+    /// Called when the user pan on the map
+    public let userDidPan: (() -> Void)?
+    
+    public init(zoomLevel: Double,
+                initialZoomLevel: Double,
+                mapCenter: CLLocationCoordinate2D,
+                annotations: [MapAnnotation] = [],
+                styleURL: @escaping (_ isDark: Bool) -> URL?,
+                tintColor: UIColor,
+                markerView: @escaping (_ annotationID: String) -> AnyView?,
+                showsUserLocationMode: Binding<ShowUserLocationMode>,
+                error: Binding<MapLibreError?>,
+                mapCenterCoordinate: Binding<CLLocationCoordinate2D?>,
+                hasLoadedUserLocation: Binding<Bool>,
+                isLocationAuthorized: Binding<Bool?>,
+                geolocationUncertainty: Binding<CLLocationAccuracy?>,
+                userDidPan: (() -> Void)? = nil) {
+        self.zoomLevel = zoomLevel
+        self.initialZoomLevel = initialZoomLevel
+        self.mapCenter = mapCenter
+        self.annotations = annotations
+        self.styleURL = styleURL
+        self.tintColor = tintColor
+        self.markerView = markerView
+        self.showsUserLocationMode = showsUserLocationMode
+        self.error = error
+        self.mapCenterCoordinate = mapCenterCoordinate
+        self.hasLoadedUserLocation = hasLoadedUserLocation
+        self.isLocationAuthorized = isLocationAuthorized
+        self.geolocationUncertainty = geolocationUncertainty
+        self.userDidPan = userDidPan
+    }
+}
@@ -0,0 +1,19 @@
+# The types shared between the app and the MapLibreShim framework. The app links this
+# (tiny, initialiser-free) framework instead of MapLibre, see MapLibreShim's target.yml.
+name: MapLibreInterface
+
+targets:
+  MapLibreInterface:
+    type: framework
+    platform: iOS
+
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: $(BASE_BUNDLE_IDENTIFIER).maplibre-interface
+        GENERATE_INFOPLIST_FILE: YES
+        SWIFT_VERSION: 6
+        SWIFT_APPROACHABLE_CONCURRENCY: YES
+        SWIFT_DEFAULT_ACTOR_ISOLATION: MainActor
+
+    sources:
+    - path: ../Sources
@@ -8,7 +8,7 @@
 import CoreLocation
 import QuartzCore

-/// Smoothly animates a `LocationAnnotation`'s coordinate from its current
+/// Smoothly animates a `MapLibreAnnotation`'s coordinate from its current
 /// position to a new one using a `CADisplayLink` for frame-accurate updates.
 ///
 /// ## How it works
@@ -26,7 +26,7 @@ import QuartzCore
 /// cancels the previous one and begins from the annotation's current position.
 final class CoordinateAnimator {
    private var displayLink: CADisplayLink?
-    private weak var annotation: LocationAnnotation?
+    private weak var annotation: MapLibreAnnotation?
    private let startCoordinate: CLLocationCoordinate2D
    private let endCoordinate: CLLocationCoordinate2D
    private let duration: CFTimeInterval
@@ -36,7 +36,7 @@ final class CoordinateAnimator {
    /// while the display link is running. Keyed by annotation ID.
    private static var activeAnimators: [String: CoordinateAnimator] = [:]
    
-    private init(annotation: LocationAnnotation,
+    private init(annotation: MapLibreAnnotation,
                 to end: CLLocationCoordinate2D,
                 duration: CFTimeInterval) {
        self.annotation = annotation
@@ -48,7 +48,7 @@ final class CoordinateAnimator {
    /// Starts animating the annotation's coordinate to `end` over `duration` seconds.
    /// If the annotation is already being animated, the in-flight animation is
    /// cancelled and a new one starts from the current position.
-    static func animate(annotation: LocationAnnotation,
+    static func animate(annotation: MapLibreAnnotation,
                        to end: CLLocationCoordinate2D,
                        duration: CFTimeInterval) {
        guard annotation.coordinate.latitude != end.latitude
@@ -0,0 +1,60 @@
+//
+// Copyright 2026 Element Creations Ltd.
+// Copyright 2023-2025 New Vector Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+import CoreLocation
+import MapLibre
+import MapLibreInterface
+import SwiftUI
+
+final class MapLibreAnnotation: NSObject, MLNAnnotation, Identifiable {
+    let id: String
+    // @objc dynamic is required to make animations work
+    @objc dynamic var coordinate: CLLocationCoordinate2D
+    
+    // MARK: - Setup
+    
+    init(_ annotation: MapAnnotation) {
+        id = annotation.id
+        coordinate = annotation.coordinate
+        super.init()
+    }
+}
+
+final class MapLibreAnnotationView: MLNUserLocationAnnotationView {
+    private var hostingController: UIHostingController<AnyView>?
+    
+    // MARK: - Setup
+    
+    override init(annotation: MLNAnnotation?, reuseIdentifier: String?) {
+        super.init(annotation: annotation, reuseIdentifier:
+            reuseIdentifier)
+    }
+    
+    convenience init(annotation: MapLibreAnnotation, content: AnyView?) {
+        self.init(annotation: annotation, reuseIdentifier: "\(Self.self)")
+        let hostingController = UIHostingController(rootView: content ?? AnyView(EmptyView()))
+        self.hostingController = hostingController
+        let view: UIView = hostingController.view
+        view.backgroundColor = .clear
+        view.anchorPoint = .init(x: 0.5, y: 1.0)
+        addSubview(view)
+        view.bounds.size = view.intrinsicContentSize
+    }
+    
+    func updateContent(_ content: AnyView?) {
+        hostingController?.rootView = content ?? AnyView(EmptyView())
+        if let hostedView = hostingController?.view {
+            hostedView.bounds.size = hostedView.intrinsicContentSize
+        }
+    }
+    
+    @available(*, unavailable)
+    required init?(coder: NSCoder) {
+        fatalError()
+    }
+}
@@ -0,0 +1,297 @@
+//
+// Copyright 2026 Element Creations Ltd.
+// Copyright 2023-2025 New Vector Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+import MapLibre
+import MapLibreInterface
+import SwiftUI
+
+struct MapLibreMapView: UIViewRepresentable {
+    // MARK: - Properties
+    
+    @Environment(\.colorScheme) private var colorScheme
+    
+    let configuration: MapViewConfiguration
+    
+    // MARK: - UIViewRepresentable
+    
+    func makeUIView(context: Context) -> MLNMapView {
+        let mapView = makeMapView()
+        mapView.delegate = context.coordinator
+        setupMap(mapView: mapView)
+        return mapView
+    }
+    
+    func updateUIView(_ mapView: MLNMapView, context: Context) {
+        // Don't set the same value twice. Otherwise, if there is an error loading the map, a loop
+        // is caused as the `error` binding being set, which triggers this update, which sets a
+        // new URL, which causes another error, and so it goes on round and round in a circle.
+        let dynamicMapURL = configuration.styleURL(colorScheme == .dark)
+        if mapView.styleURL != dynamicMapURL {
+            mapView.styleURL = dynamicMapURL
+        }
+        
+        // If the center coordinate was updated externally (not by the map itself), move the map.
+        // Not applied while following a marker, where the camera is driven by the marker's position.
+        if configuration.showsUserLocationMode.wrappedValue.followedMarkerID == nil,
+           let newCenter = configuration.mapCenterCoordinate.wrappedValue,
+           newCenter.latitude != context.coordinator.lastReportedCenter?.latitude
+           || newCenter.longitude != context.coordinator.lastReportedCenter?.longitude {
+            context.coordinator.lastReportedCenter = newCenter
+            mapView.setCenter(newCenter, animated: true)
+        }
+        
+        // Update existing annotation views with fresh SwiftUI content.
+        // This handles the case where the annotation's view data changes after
+        // the annotation was initially placed (e.g. user avatar loads asynchronously).
+        updateAnnotations(in: mapView)
+        
+        showUserLocation(in: mapView)
+        
+        context.coordinator.updateMarkerFollowing(in: mapView, markerID: configuration.showsUserLocationMode.wrappedValue.followedMarkerID)
+    }
+    
+    func makeCoordinator() -> Coordinator {
+        Coordinator(self)
+    }
+    
+    // MARK: - Private
+    
+    private func setupMap(mapView: MLNMapView) {
+        mapView.addAnnotations(configuration.annotations.map(MapLibreAnnotation.init))
+        mapView.zoomLevel = configuration.annotations.isEmpty ? configuration.initialZoomLevel : configuration.zoomLevel
+        mapView.centerCoordinate = configuration.mapCenter
+    }
+    
+    private func updateAnnotations(in mapView: MLNMapView) {
+        let existingByID = Dictionary(uniqueKeysWithValues:
+            (mapView.annotations ?? []).compactMap { $0 as? MapLibreAnnotation }.map { ($0.id, $0) })
+        let updatedByID = Dictionary(uniqueKeysWithValues: configuration.annotations.map { ($0.id, $0) })
+        
+        let existingIDs = Set(existingByID.keys)
+        let updatedIDs = Set(updatedByID.keys)
+        
+        // Remove annotations that are no longer present
+        let removedIDs = existingIDs.subtracting(updatedIDs)
+        if !removedIDs.isEmpty {
+            let toRemove = removedIDs.compactMap { existingByID[$0] }
+            mapView.removeAnnotations(toRemove)
+        }
+        
+        // Add new annotations
+        let addedIDs = updatedIDs.subtracting(existingIDs)
+        if !addedIDs.isEmpty {
+            let toAdd = addedIDs.compactMap { updatedByID[$0] }.map(MapLibreAnnotation.init)
+            mapView.addAnnotations(toAdd)
+        }
+        
+        // Update existing annotations that are still present
+        let keptIDs = existingIDs.intersection(updatedIDs)
+        for id in keptIDs {
+            guard let existingAnnotation = existingByID[id],
+                  let updatedAnnotation = updatedByID[id] else {
+                continue
+            }
+            CoordinateAnimator.animate(annotation: existingAnnotation,
+                                       to: updatedAnnotation.coordinate,
+                                       duration: 1.0)
+            if let annotationView = mapView.view(for: existingAnnotation) as? MapLibreAnnotationView {
+                annotationView.updateContent(configuration.markerView(id))
+            }
+        }
+    }
+    
+    private func makeMapView() -> MLNMapView {
+        let mapView = MLNMapView(frame: .zero, styleURL: configuration.styleURL(colorScheme == .dark))
+        mapView.logoViewPosition = .topLeft
+        mapView.attributionButtonPosition = .topLeft
+        mapView.attributionButtonMargins = .init(x: mapView.logoView.frame.maxX + 8, y: mapView.logoView.center.y / 2)
+        mapView.tintColor = configuration.tintColor
+        mapView.allowsRotating = false
+        mapView.allowsTilting = false
+        return mapView
+    }
+    
+    private func showUserLocation(in mapView: MLNMapView) {
+        switch (configuration.showsUserLocationMode.wrappedValue, configuration.annotations) {
+        case (.showAndFollow, _):
+            mapView.userTrackingMode = .follow
+        case (.show, let annotations) where !annotations.isEmpty:
+            // In the show mode, if there are annotations, we check the authorizationStatus,
+            // if it's not determined, we wont prompt the user with a request for permissions,
+            // because they should be able to see the annotations without sharing their location information.
+            guard mapView.locationManager.authorizationStatus != .notDetermined else { return }
+            fallthrough
+        case (.show, _):
+            mapView.showsUserLocation = true
+            mapView.setUserTrackingMode(.none, animated: false, completionHandler: nil)
+        case (.hide, _), (.hideAndFollowMarker, _):
+            // In hideAndFollowMarker mode the camera following is handled by the coordinator.
+            mapView.showsUserLocation = false
+            mapView.setUserTrackingMode(.none, animated: false, completionHandler: nil)
+        }
+    }
+}
+
+// MARK: - Coordinator
+
+extension MapLibreMapView {
+    class Coordinator: NSObject, MLNMapViewDelegate {
+        // MARK: - Properties
+        
+        var mapLibreView: MapLibreMapView
+        
+        private var previousUserLocation: MLNUserLocation?
+        /// Tracks the last center coordinate reported by the map (or set programmatically),
+        /// so that `updateUIView` can tell apart external binding changes from internal ones.
+        var lastReportedCenter: CLLocationCoordinate2D?
+        
+        /// The annotation the camera is currently locked on while in the `hideAndFollowMarker` mode.
+        private weak var followedAnnotation: MapLibreAnnotation?
+        /// Observes the followed annotation's coordinate, updated every frame by the `CoordinateAnimator`.
+        private var followedAnnotationObservation: NSKeyValueObservation?
+        
+        // MARK: - Setup
+        
+        init(_ mapLibreView: MapLibreMapView) {
+            self.mapLibreView = mapLibreView
+        }
+        
+        // MARK: - Marker following
+        
+        /// Keeps the camera locked on the marker with the given id, or stops following when nil.
+        func updateMarkerFollowing(in mapView: MLNMapView, markerID: String?) {
+            guard let markerID else {
+                stopFollowingMarker()
+                return
+            }
+            
+            guard let annotation = (mapView.annotations ?? [])
+                .compactMap({ $0 as? MapLibreAnnotation })
+                .first(where: { $0.id == markerID }) else {
+                // The marker isn't on the map (yet), resolve it again on the next update.
+                stopFollowingMarker()
+                return
+            }
+            
+            guard annotation !== followedAnnotation else { return }
+            startFollowingMarker(annotation, in: mapView)
+        }
+        
+        private func startFollowingMarker(_ annotation: MapLibreAnnotation, in mapView: MLNMapView) {
+            followedAnnotation = annotation
+            followedAnnotationObservation = nil
+            
+            // Animate to the marker first, attaching the per-frame tracking only on completion
+            // so that it doesn't cancel the transition.
+            mapView.setCenter(annotation.coordinate,
+                              zoomLevel: mapView.zoomLevel,
+                              direction: -1, // negative value keeps the current direction
+                              animated: true) { [weak self, weak annotation, weak mapView] in
+                guard let self, let annotation, let mapView, annotation === followedAnnotation else { return }
+                
+                // Mirror every animated coordinate update to keep the camera as smooth as the marker.
+                followedAnnotationObservation = annotation.observe(\.coordinate) { [weak mapView] annotation, _ in
+                    // The coordinate is only ever updated by SwiftUI so KVO fires on the main actor.
+                    MainActor.assumeIsolated {
+                        mapView?.setCenter(annotation.coordinate, animated: false)
+                    }
+                }
+            }
+        }
+        
+        private func stopFollowingMarker() {
+            followedAnnotation = nil
+            followedAnnotationObservation = nil
+        }
+        
+        // MARK: - MLNMapViewDelegate
+        
+        func mapView(_ mapView: MLNMapView, viewFor annotation: MLNAnnotation) -> MLNAnnotationView? {
+            guard let annotation = annotation as? MapLibreAnnotation else {
+                return nil
+            }
+            return MapLibreAnnotationView(annotation: annotation, content: mapLibreView.configuration.markerView(annotation.id))
+        }
+        
+        func mapViewDidFailLoadingMap(_ mapView: MLNMapView, withError error: Error) {
+            if mapLibreView.configuration.error.wrappedValue != .failedLoadingMap {
+                mapLibreView.configuration.error.wrappedValue = .failedLoadingMap
+            }
+        }
+        
+        func mapView(_ mapView: MLNMapView, didUpdate userLocation: MLNUserLocation?) {
+            guard let userLocation else { return }
+            mapLibreView.configuration.hasLoadedUserLocation.wrappedValue = true
+            
+            if previousUserLocation == nil, mapLibreView.configuration.annotations.isEmpty {
+                DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
+                    mapView.setCenter(userLocation.coordinate, zoomLevel: self.mapLibreView.configuration.zoomLevel, animated: true)
+                }
+            }
+            
+            previousUserLocation = userLocation
+            updateGeolocationUncertainty(location: userLocation)
+        }
+        
+        func mapView(_ mapView: MLNMapView, didChangeLocationManagerAuthorization manager: MLNLocationManager) {
+            switch manager.authorizationStatus {
+            case .denied, .restricted:
+                mapLibreView.configuration.isLocationAuthorized.wrappedValue = false
+            case .authorizedAlways, .authorizedWhenInUse:
+                mapLibreView.configuration.isLocationAuthorized.wrappedValue = true
+            case .notDetermined:
+                mapLibreView.configuration.isLocationAuthorized.wrappedValue = nil
+            @unknown default:
+                break
+            }
+        }
+        
+        func mapView(_ mapView: MLNMapView, regionDidChangeAnimated animated: Bool) {
+            // While following a marker, don't flood the center binding with per-frame camera updates.
+            // Leaving `lastReportedCenter` untouched avoids an external re-centering when following stops.
+            guard mapLibreView.configuration.showsUserLocationMode.wrappedValue.followedMarkerID == nil else { return }
+            
+            // Avoid `Publishing changes from within view update` warnings
+            DispatchQueue.main.async { [mapLibreView, weak self] in
+                let center = mapView.centerCoordinate
+                self?.lastReportedCenter = center
+                mapLibreView.configuration.mapCenterCoordinate.wrappedValue = center
+            }
+        }
+        
+        func mapView(_ mapView: MLNMapView, shouldChangeFrom oldCamera: MLNMapCamera, to newCamera: MLNMapCamera, reason: MLNCameraChangeReason) -> Bool {
+            // Send userDidPan only for gestures that actually change the map center. The reason
+            // is an option set and gestures can come combined with other reasons, so check for
+            // containment instead of an exact match.
+            let centerChangingGestures: MLNCameraChangeReason = [.gesturePan, .gesturePinch, .gestureRotate]
+            if !reason.isDisjoint(with: centerChangingGestures) {
+                // Stop following immediately, the camera would fight the gesture otherwise.
+                stopFollowingMarker()
+                mapLibreView.configuration.userDidPan?()
+            }
+            return true
+        }
+        
+        // MARK: Callout
+        
+        func mapView(_ mapView: MLNMapView, annotationCanShowCallout annotation: MLNAnnotation) -> Bool {
+            false
+        }
+        
+        // MARK: Private
+        
+        private func updateGeolocationUncertainty(location: MLNUserLocation) {
+            guard let clLocation = location.location, clLocation.horizontalAccuracy >= 0 else {
+                mapLibreView.configuration.geolocationUncertainty.wrappedValue = nil
+                return
+            }
+            
+            mapLibreView.configuration.geolocationUncertainty.wrappedValue = clLocation.horizontalAccuracy
+        }
+    }
+}
@@ -0,0 +1,39 @@
+//
+// Copyright 2026 Element Creations Ltd.
+//
+// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
+// Please see LICENSE files in the repository root for full details.
+//
+
+import MapLibre
+import MapLibreInterface
+import SwiftUI
+
+/// The shim's entry point: the app looks this class up by name through the ObjC runtime
+/// after `dlopen`-ing the framework, keeping MapLibre off the app's launch path.
+@objc(MapLibreShim)
+public final class MapLibreShim: NSObject, MapLibreShimProtocol {
+    public func configureLogging(_ handler: @escaping @Sendable (MapLogSeverity, String) -> Void) {
+        MLNLoggingConfiguration.shared.loggingLevel = .debug
+        MLNLoggingConfiguration.shared.handler = { loggingLevel, _, _, message in
+            switch loggingLevel {
+            case .error:
+                handler(.error, message)
+            case .warning:
+                handler(.warning, message)
+            case .info:
+                handler(.info, message)
+            case .debug:
+                handler(.debug, message)
+            case .verbose:
+                handler(.verbose, message)
+            default:
+                break
+            }
+        }
+    }
+    
+    public func makeMapView(configuration: MapViewConfiguration) -> AnyView {
+        AnyView(MapLibreMapView(configuration: configuration))
+    }
+}
@@ -0,0 +1,26 @@
+# The interactive map, split out of the app so MapLibre's static initialisers stay off the
+# launch path: the app links only the tiny MapLibreInterface framework, while MapLibreShim (the
+# only image linking MapLibre) is embedded unlinked and dlopen'd on first map use.
+name: MapLibreShim
+
+targets:
+  MapLibreShim:
+    type: framework
+    platform: iOS
+
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: $(BASE_BUNDLE_IDENTIFIER).maplibre-shim
+        GENERATE_INFOPLIST_FILE: YES
+        SWIFT_VERSION: 6
+        SWIFT_APPROACHABLE_CONCURRENCY: YES
+        SWIFT_DEFAULT_ACTOR_ISOLATION: MainActor
+
+    dependencies:
+    - target: MapLibreInterface
+      embed: false
+    - package: MapLibre
+      embed: false
+
+    sources:
+    - path: ../Sources
@@ -0,0 +1,9 @@
+nonisolated enum Secrets {
+    static let sentryDSN: String? = nil
+    static let sentryRustDSN: String? = nil
+    static let postHogHost: String? = nil
+    static let postHogAPIKey: String? = nil
+    static let rageshakeURL: String? = nil
+    static let mapLibreAPIKey: String? = "your_key"
+
+}
@@ -1,52 +0,0 @@
-import Danger
-import Foundation
-
-SwiftLint.lint(.modifiedAndCreatedFiles(directory: nil),
-               inline: true,
-               configFile: nil,
-               strict: false,
-               quiet: true,
-               swiftlintPath: nil,
-               markdownAction: { _ in })
-
-let danger = Danger()
-
-/// All of the new and modified files together.
-let editedFiles = danger.git.modifiedFiles + danger.git.createdFiles
-
-// Warn when there is a big PR
-if (danger.github.pullRequest.additions ?? 0) > 1000 {
-    warn("This pull request seems relatively large. Please consider splitting it into multiple smaller ones.")
-}
-
-// Check that the PR has a description
-if danger.github.pullRequest.body?.isEmpty ?? true {
-    warn("Please provide a description for this PR.")
-}
-
-/// Check for screenshots on view changes
-let hasChangedViews = editedFiles.contains { $0.lowercased().contains("/view") }
-if hasChangedViews {
-    if (danger.github.pullRequest.body?.contains("user-attachments") ?? false) == false {
-        warn("You seem to have made changes to views. Please consider adding screenshots.")
-    }
-}
-
-/// Check for pngs on resources
-let hasPngs = editedFiles.contains { $0.lowercased().contains(".xcassets") && $0.lowercased().hasSuffix(".png") }
-if hasPngs {
-    warn("You seem to have made changes to some resource images. Please consider using an SVG or PDF.")
-}
-
-// Check for nice PR titles
-let prTitle = danger.github.pullRequest.title
-let fixesRegex = try! Regex("(Fixes|Fix) #\\d+")
-let semanticRegex = try! Regex("\\w+\\(\\w+\\):")
-if prTitle.hasSuffix("…") || prTitle.starts(with: fixesRegex) || prTitle.starts(with: semanticRegex) {
-    fail("Please provide a complete title that can be used as a changelog entry.")
-}
-
-// Check for changelog tags
-if danger.github.issue.labels.filter({ $0.name.hasPrefix("pr-") }).count != 1 {
-    fail("Please add a `pr-` label to categorise the changelog entry.")
-}
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:cc39671ee91a08779e4149589a4635fa6b91519b07bfb2dee621ccab031a75c5
-size 5825201
@@ -1,13 +1,13 @@
 {
-  "originHash" : "b2bcfd4f704c144b36ac18bb17859627163be8018ed52c4ec3cbf11d3e3f4469",
+  "originHash" : "fbdb76ae8c78e5a86db4812456fcb4da5795eed4bc8f6715726fec41e87a1e0f",
  "pins" : [
    {
      "identity" : "compound-design-tokens",
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/element-hq/compound-design-tokens",
      "state" : {
-        "revision" : "bc390b74b53447f04bc0a7a07adaecbb90e02e25",
-        "version" : "10.2.3"
+        "revision" : "28b921601ac0ff49a572b6f18526d97bd14e5d91",
+        "version" : "11.3.1"
      }
    },
    {
@@ -15,8 +15,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/devicekit/DeviceKit",
      "state" : {
-        "revision" : "56b997e8a61707218f9af09f32b2a1d1806fd792",
-        "version" : "5.8.0"
+        "revision" : "19528aa07e1426626ea9fb2c4a161edf43c4f9e8",
+        "version" : "5.9.0"
      }
    },
    {
@@ -55,13 +55,22 @@
        "version" : "1.2.0"
      }
    },
+    {
+      "identity" : "element-call-ios",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/element-hq/element-call-ios",
+      "state" : {
+        "revision" : "d77b4ee326582083cabe53ffbd872a751c3cb989",
+        "version" : "0.1.0-rc.11"
+      }
+    },
    {
      "identity" : "element-call-swift",
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/element-hq/element-call-swift",
      "state" : {
-        "revision" : "d2ecef5a54e5718ed6344dde6f72a4da42f1fcd9",
-        "version" : "0.20.2"
+        "revision" : "befb5d37a7859ad38cf83719cbfd4abaffa04d82",
+        "version" : "0.26.1"
      }
    },
    {
@@ -95,8 +104,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/onevcat/Kingfisher",
      "state" : {
-        "revision" : "ac632bd26a1c00f139ff62fd01806f21cf67325e",
-        "version" : "8.10.0"
+        "revision" : "8648fe649c5d62be38721110f835821906e9242a",
+        "version" : "8.13.0"
      }
    },
    {
@@ -122,8 +131,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/nicklockwood/LRUCache",
      "state" : {
-        "revision" : "cb5b2bd0da83ad29c0bec762d39f41c8ad0eaf3e",
-        "version" : "1.2.1"
+        "revision" : "f0570e943ea4445d258113ba73f50cb2b7e564ac",
+        "version" : "1.3.0"
      }
    },
    {
@@ -131,8 +140,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/guoyingtao/Mantis",
      "state" : {
-        "revision" : "b3c237aff54b8307440157a2f5956bdea2e76791",
-        "version" : "2.31.2"
+        "revision" : "0960be1feed2e62f62a5fddbb8d72b26008db881",
+        "version" : "3.1.0"
      }
    },
    {
@@ -140,8 +149,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/maplibre/maplibre-gl-native-distribution",
      "state" : {
-        "revision" : "84a79bc375a301169390ac110c868f06c857b83f",
-        "version" : "6.27.0"
+        "revision" : "13e41ab3d77ff5113e7e5d4ee87803b1f81f5683",
+        "version" : "6.31.0"
      }
    },
    {
@@ -149,8 +158,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/matrix-org/matrix-analytics-events",
      "state" : {
-        "revision" : "4b143b14a16a231bd4fc3c6705845f852177abe3",
-        "version" : "0.37.0"
+        "revision" : "7d668b3e4be493843805b8a1ff4e13b261a19965",
+        "version" : "0.38.0"
      }
    },
    {
@@ -158,8 +167,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/element-hq/matrix-rich-text-editor-swift",
      "state" : {
-        "revision" : "c0877fb9323d1ec2de56e4fe2da97f73cac36c38",
-        "version" : "2.42.0"
+        "revision" : "56077711bf495db926ec3f3efd36ed127fb9ceb1",
+        "version" : "2.42.1"
      }
    },
    {
@@ -167,8 +176,17 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/element-hq/matrix-rust-components-swift",
      "state" : {
-        "revision" : "b286aeac2774f516839abcb91bbac1450188a591",
-        "version" : "26.7.8"
+        "revision" : "dbdf59e13d0eade7fd9cbd01cfd564693b85b761",
+        "version" : "26.10.15"
+      }
+    },
+    {
+      "identity" : "matrix-rust-rtc",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/element-hq/matrix-rust-rtc",
+      "state" : {
+        "revision" : "c7a81b6742dc5e571b90b05f5109677384efb933",
+        "version" : "0.5.0-rc.5"
      }
    },
    {
@@ -194,8 +212,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/PostHog/posthog-ios",
      "state" : {
-        "revision" : "6e70aa24bbd3778182fe039f7f5800a17674a6d6",
-        "version" : "3.61.1"
+        "revision" : "d97d9a0babda42ecee026bd0a5a9ea1756349dc1",
+        "version" : "3.85.3"
      }
    },
    {
@@ -203,8 +221,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/getsentry/sentry-cocoa",
      "state" : {
-        "revision" : "43abfbf9a26089ad34604c718ad0935440caf1d4",
-        "version" : "9.18.0"
+        "revision" : "8689e780a295dfdc6501ac0dbb502461e16d6551",
+        "version" : "9.29.2"
      }
    },
    {
@@ -230,17 +248,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/apple/swift-async-algorithms",
      "state" : {
-        "revision" : "d0b4a06d0f173a2f3be27d3ea21b3c3aa18db440",
-        "version" : "1.1.4"
-      }
-    },
-    {
-      "identity" : "swift-clocks",
-      "kind" : "remoteSourceControl",
-      "location" : "https://github.com/pointfreeco/swift-clocks",
-      "state" : {
-        "revision" : "72d749bf341b78851203066ab421869b783ec42a",
-        "version" : "1.1.0"
+        "revision" : "789dcf1f3d3f00251482f40a432ab7144c181987",
+        "version" : "1.1.6"
      }
    },
    {
@@ -248,17 +257,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/apple/swift-collections",
      "state" : {
-        "revision" : "a0cb0954ecb21e4e31b0070e6ed5674e8556685a",
-        "version" : "1.6.0"
-      }
-    },
-    {
-      "identity" : "swift-concurrency-extras",
-      "kind" : "remoteSourceControl",
-      "location" : "https://github.com/pointfreeco/swift-concurrency-extras",
-      "state" : {
-        "revision" : "5a3825302b1a0d744183200915a47b508c828e6f",
-        "version" : "1.3.2"
+        "revision" : "98ef3c98609a1e31b7e157b5b619579001a789d6",
+        "version" : "1.7.1"
      }
    },
    {
@@ -293,8 +293,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/pointfreeco/swift-snapshot-testing",
      "state" : {
-        "revision" : "ad5e3190cc63dc288f28546f9c6827efc1e9d495",
-        "version" : "1.19.2"
+        "revision" : "28e5de025e3fd98991791bfbf83023ab3708da03",
+        "version" : "1.19.6"
      }
    },
    {
@@ -302,8 +302,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/swiftlang/swift-syntax",
      "state" : {
-        "revision" : "79e4b74a295b6eb74a8b585e3a39d29e70c1dbd1",
-        "version" : "603.0.2"
+        "revision" : "050f1a346fbbac0ca2cfb15a95274f7bd1cf0ccf",
+        "version" : "604.0.0"
      }
    },
    {
@@ -311,8 +311,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/scinfu/SwiftSoup.git",
      "state" : {
-        "revision" : "49dcadd93161f4a44b4994d3a3e8de9f085aface",
-        "version" : "2.13.5"
+        "revision" : "18b80329749eca5ea29fc50211dca5c7eff5bfec",
+        "version" : "2.13.9"
      }
    },
    {
@@ -329,8 +329,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/tevelee/SwiftUI-Flow.git",
      "state" : {
-        "revision" : "798364823cdfc6afb4aff43eff5a3ddbca89b54f",
-        "version" : "3.4.0"
+        "revision" : "19e86b750b3c67260cbb28c459004c0dfdb11899",
+        "version" : "3.5.1"
      }
    },
    {
@@ -338,8 +338,8 @@
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/siteline/SwiftUI-Introspect",
      "state" : {
-        "revision" : "26986a57e31c813f98262ddb62d4b07d40008535",
-        "version" : "26.0.1"
+        "revision" : "a37eca1db7bebc9437ee89508e7b4433ff34adb4",
+        "version" : "27.0.0"
      }
    },
    {
@@ -4,8 +4,7 @@
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      runPostActionsOnFailure = "NO">
+      buildImplicitDependencies = "YES">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
@@ -27,14 +26,7 @@
      buildConfiguration = "Debug"
      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
-      shouldUseLaunchSchemeArgsEnv = "YES"
-      onlyGenerateCoverageForSpecifiedTargets = "NO">
-      <TestPlans>
-         <TestPlanReference
-            default = "YES"
-            reference = "container:AccessibilityTests/SupportingFiles/AccessibilityTests.xctestplan">
-         </TestPlanReference>
-      </TestPlans>
+      shouldUseLaunchSchemeArgsEnv = "YES">
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -44,10 +36,12 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <Testables>
-      </Testables>
-      <CommandLineArguments>
-      </CommandLineArguments>
+      <TestPlans>
+         <TestPlanReference
+            reference = "container:AccessibilityTests/SupportingFiles/AccessibilityTests.xctestplan"
+            default = "YES">
+         </TestPlanReference>
+      </TestPlans>
   </TestAction>
   <LaunchAction
      buildConfiguration = "Debug"
@@ -68,8 +62,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </LaunchAction>
   <ProfileAction
      buildConfiguration = "Release"
@@ -77,8 +69,6 @@
      savedToolIdentifier = ""
      useCustomWorkingDirectory = "NO"
      debugDocumentVersioning = "YES">
-      <CommandLineArguments>
-      </CommandLineArguments>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -4,8 +4,7 @@
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      runPostActionsOnFailure = "NO">
+      buildImplicitDependencies = "YES">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
@@ -30,12 +29,6 @@
      shouldUseLaunchSchemeArgsEnv = "YES"
      codeCoverageEnabled = "YES"
      onlyGenerateCoverageForSpecifiedTargets = "YES">
-      <TestPlans>
-         <TestPlanReference
-            default = "YES"
-            reference = "container:UnitTests/SupportingFiles/UnitTests.xctestplan">
-         </TestPlanReference>
-      </TestPlans>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -45,10 +38,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <Testables>
-      </Testables>
-      <CommandLineArguments>
-      </CommandLineArguments>
      <CodeCoverageTargets>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -58,6 +47,12 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </CodeCoverageTargets>
+      <TestPlans>
+         <TestPlanReference
+            reference = "container:UnitTests/SupportingFiles/UnitTests.xctestplan"
+            default = "YES">
+         </TestPlanReference>
+      </TestPlans>
   </TestAction>
   <LaunchAction
      buildConfiguration = "Debug"
@@ -79,14 +74,17 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </BuildableProductRunnable>
-      <CommandLineArguments>
-      </CommandLineArguments>
      <EnvironmentVariables>
         <EnvironmentVariable
            key = "HTTPS_PROXY"
            value = "localhost:9090"
            isEnabled = "NO">
         </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "HTTP_PROXY"
+            value = "localhost:9090"
+            isEnabled = "NO">
+         </EnvironmentVariable>
         <EnvironmentVariable
            key = "UI_TESTS_SCREEN"
            value = ""
@@ -115,8 +113,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </BuildableProductRunnable>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </ProfileAction>
   <AnalyzeAction
      buildConfiguration = "Debug">
@@ -4,8 +4,7 @@
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      runPostActionsOnFailure = "NO">
+      buildImplicitDependencies = "YES">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
@@ -30,12 +29,6 @@
      shouldUseLaunchSchemeArgsEnv = "YES"
      codeCoverageEnabled = "YES"
      onlyGenerateCoverageForSpecifiedTargets = "YES">
-      <TestPlans>
-         <TestPlanReference
-            default = "YES"
-            reference = "container:IntegrationTests/SupportingFiles/IntegrationTests.xctestplan">
-         </TestPlanReference>
-      </TestPlans>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -45,10 +38,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <Testables>
-      </Testables>
-      <CommandLineArguments>
-      </CommandLineArguments>
      <CodeCoverageTargets>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -58,6 +47,12 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </CodeCoverageTargets>
+      <TestPlans>
+         <TestPlanReference
+            reference = "container:IntegrationTests/SupportingFiles/IntegrationTests.xctestplan"
+            default = "YES">
+         </TestPlanReference>
+      </TestPlans>
   </TestAction>
   <LaunchAction
      buildConfiguration = "Debug"
@@ -78,8 +73,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </LaunchAction>
   <ProfileAction
      buildConfiguration = "Release"
@@ -87,8 +80,6 @@
      savedToolIdentifier = ""
      useCustomWorkingDirectory = "NO"
      debugDocumentVersioning = "YES">
-      <CommandLineArguments>
-      </CommandLineArguments>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -5,8 +5,7 @@
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      runPostActionsOnFailure = "NO">
+      buildImplicitDependencies = "YES">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
@@ -28,8 +27,7 @@
      buildConfiguration = "Debug"
      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
-      shouldUseLaunchSchemeArgsEnv = "YES"
-      onlyGenerateCoverageForSpecifiedTargets = "NO">
+      shouldUseLaunchSchemeArgsEnv = "YES">
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -41,8 +39,6 @@
      </MacroExpansion>
      <Testables>
      </Testables>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </TestAction>
   <LaunchAction
      buildConfiguration = "Debug"
@@ -66,8 +62,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </BuildableProductRunnable>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </LaunchAction>
   <ProfileAction
      buildConfiguration = "Release"
@@ -85,8 +79,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </BuildableProductRunnable>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </ProfileAction>
   <AnalyzeAction
      buildConfiguration = "Debug">
@@ -4,8 +4,7 @@
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      runPostActionsOnFailure = "NO">
+      buildImplicitDependencies = "YES">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
@@ -30,12 +29,6 @@
      shouldUseLaunchSchemeArgsEnv = "YES"
      codeCoverageEnabled = "YES"
      onlyGenerateCoverageForSpecifiedTargets = "YES">
-      <TestPlans>
-         <TestPlanReference
-            default = "YES"
-            reference = "container:PreviewTests/SupportingFiles/PreviewTests.xctestplan">
-         </TestPlanReference>
-      </TestPlans>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -45,10 +38,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <Testables>
-      </Testables>
-      <CommandLineArguments>
-      </CommandLineArguments>
      <CodeCoverageTargets>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -58,6 +47,12 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </CodeCoverageTargets>
+      <TestPlans>
+         <TestPlanReference
+            reference = "container:PreviewTests/SupportingFiles/PreviewTests.xctestplan"
+            default = "YES">
+         </TestPlanReference>
+      </TestPlans>
   </TestAction>
   <LaunchAction
      buildConfiguration = "Debug"
@@ -78,8 +73,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </LaunchAction>
   <ProfileAction
      buildConfiguration = "Release"
@@ -87,8 +80,6 @@
      savedToolIdentifier = ""
      useCustomWorkingDirectory = "NO"
      debugDocumentVersioning = "YES">
-      <CommandLineArguments>
-      </CommandLineArguments>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -5,8 +5,7 @@
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      runPostActionsOnFailure = "NO">
+      buildImplicitDependencies = "YES">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
@@ -28,8 +27,7 @@
      buildConfiguration = "Debug"
      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
-      shouldUseLaunchSchemeArgsEnv = "YES"
-      onlyGenerateCoverageForSpecifiedTargets = "NO">
+      shouldUseLaunchSchemeArgsEnv = "YES">
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -41,8 +39,6 @@
      </MacroExpansion>
      <Testables>
      </Testables>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </TestAction>
   <LaunchAction
      buildConfiguration = "Debug"
@@ -66,8 +62,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </BuildableProductRunnable>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </LaunchAction>
   <ProfileAction
      buildConfiguration = "Release"
@@ -85,8 +79,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </BuildableProductRunnable>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </ProfileAction>
   <AnalyzeAction
      buildConfiguration = "Debug">
@@ -4,8 +4,7 @@
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      runPostActionsOnFailure = "NO">
+      buildImplicitDependencies = "YES">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
@@ -27,14 +26,7 @@
      buildConfiguration = "Debug"
      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
-      shouldUseLaunchSchemeArgsEnv = "YES"
-      onlyGenerateCoverageForSpecifiedTargets = "NO">
-      <TestPlans>
-         <TestPlanReference
-            default = "YES"
-            reference = "container:UITests/SupportingFiles/UITests.xctestplan">
-         </TestPlanReference>
-      </TestPlans>
+      shouldUseLaunchSchemeArgsEnv = "YES">
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -44,10 +36,12 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <Testables>
-      </Testables>
-      <CommandLineArguments>
-      </CommandLineArguments>
+      <TestPlans>
+         <TestPlanReference
+            reference = "container:UITests/SupportingFiles/UITests.xctestplan"
+            default = "YES">
+         </TestPlanReference>
+      </TestPlans>
   </TestAction>
   <LaunchAction
      buildConfiguration = "Debug"
@@ -68,8 +62,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </LaunchAction>
   <ProfileAction
      buildConfiguration = "Release"
@@ -77,8 +69,6 @@
      savedToolIdentifier = ""
      useCustomWorkingDirectory = "NO"
      debugDocumentVersioning = "YES">
-      <CommandLineArguments>
-      </CommandLineArguments>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -4,8 +4,7 @@
   version = "1.7">
   <BuildAction
      parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      runPostActionsOnFailure = "NO">
+      buildImplicitDependencies = "YES">
      <BuildActionEntries>
         <BuildActionEntry
            buildForTesting = "YES"
@@ -30,12 +29,6 @@
      shouldUseLaunchSchemeArgsEnv = "YES"
      codeCoverageEnabled = "YES"
      onlyGenerateCoverageForSpecifiedTargets = "YES">
-      <TestPlans>
-         <TestPlanReference
-            default = "YES"
-            reference = "container:UnitTests/SupportingFiles/UnitTests.xctestplan">
-         </TestPlanReference>
-      </TestPlans>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -45,10 +38,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <Testables>
-      </Testables>
-      <CommandLineArguments>
-      </CommandLineArguments>
      <CodeCoverageTargets>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -58,6 +47,12 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </CodeCoverageTargets>
+      <TestPlans>
+         <TestPlanReference
+            reference = "container:UnitTests/SupportingFiles/UnitTests.xctestplan"
+            default = "YES">
+         </TestPlanReference>
+      </TestPlans>
   </TestAction>
   <LaunchAction
      buildConfiguration = "Debug"
@@ -78,8 +73,6 @@
            ReferencedContainer = "container:ElementX.xcodeproj">
         </BuildableReference>
      </MacroExpansion>
-      <CommandLineArguments>
-      </CommandLineArguments>
   </LaunchAction>
   <ProfileAction
      buildConfiguration = "Release"
@@ -87,8 +80,6 @@
      savedToolIdentifier = ""
      useCustomWorkingDirectory = "NO"
      debugDocumentVersioning = "YES">
-      <CommandLineArguments>
-      </CommandLineArguments>
      <MacroExpansion>
         <BuildableReference
            BuildableIdentifier = "primary"
@@ -1,15 +1,23 @@
 {
  "images" : [
    {
-      "filename" : "app-logo.pdf",
-      "idiom" : "universal"
+      "filename" : "app-logo.png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "app-logo@2x.png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "app-logo@3x.png",
+      "idiom" : "universal",
+      "scale" : "3x"
    }
  ],
  "info" : {
    "author" : "xcode",
    "version" : 1
-  },
-  "properties" : {
-    "preserves-vector-representation" : true
  }
 }
@@ -0,0 +1,6 @@
+"NSCameraUsageDescription" = "يحتاج Element X إلى الوصول إلى الكاميرا لالتقاط الصور أو مقاطع الفيديو وإرسالها كرسائل.";
+"NSFaceIDUsageDescription" = "يُستخدم Face ID لحماية الوصول إلى حسابك.";
+"NSLocationAlwaysAndWhenInUseUsageDescription" = "لمشاركة موقعك المباشر، يحتاج Element X إلى الوصول إلى الموقع عندما يكون التطبيق في الخلفية.";
+"NSLocationWhenInUseUsageDescription" = "امنح الوصول إلى الموقع حتى يتمكن Element X من مشاركة موقعك.";
+"NSMicrophoneUsageDescription" = "يحتاج Element X إلى الوصول إلى الميكروفون لتسجيل الرسائل الصوتية وإرسالها.";
+"NSPhotoLibraryUsageDescription" = "يتيح لك هذا حفظ الصور ومقاطع الفيديو في مكتبة الصور لديك.";
--- a/Show More
+++ b/Show More