5.0.0 Release

AGENTS.md

@@ -2,46 +2,82 @@ Guidance for AI coding agents (Copilot, Cursor, Aider, Claude, etc.) working in
 
 ### Repository purpose
 
-This repo hosts Stream’s SwiftUI Chat SDK for iOS. It builds on the core client and provides SwiftUI-first chat components (views, view models, modifiers) for messaging apps.
+This repo hosts Stream's SwiftUI Chat SDK for iOS. It builds on the core client and provides SwiftUI-first chat components (views, view models, modifiers) for messaging apps.
 
-Agents should optimize for clean code, follow Apple's SwiftUI guidelines and Swift best practices, accessibility, and high test coverage when changing code. At the moment, we are building a new major version of the SDK, so we can make source-breaking changes without adding deprecations.
+Agents should optimize for clean code, follow Apple's SwiftUI guidelines and Swift best practices, accessibility, and high test coverage when changing code. Avoid doing any source-breaking changes without adding deprecations.
 
 ### Tech & toolchain
 
-- Language: Swift (SwiftUI)
+- Language: Swift 6.0 (strict concurrency enabled — `swift-tools-version:6.0`)
 - Primary distribution: Swift Package Manager (SPM)
+- Project file: `StreamChatSwiftUI.xcodeproj` (used for builds and tests; SPM manifest does not declare test targets)
 - Xcode: 16.x or newer (Apple Silicon supported)
-- Platforms / deployment targets: Use the values set in Package.swift; do not lower targets without approval
-- CI: GitHub Actions (assume PR validation for build + tests + lint)
-- Linters & docs: SwiftLint and SwiftFormat
+- Platforms / deployment targets: iOS 14+, macOS 11+ (see `Package.swift`; do not lower targets without approval)
+- CI: GitHub Actions + Fastlane (see `.github/workflows/smoke-checks.yml`)
+- Linting: SwiftLint (v0.59.1) — config in `.swiftlint.yml`
+- Formatting: SwiftFormat (v0.58.2) — config in `.swiftformat`
+- Code generation: SwiftGen (v6.5.1) — generates `L10n.swift` for localization strings
+- Git hooks: lefthook (`lefthook.yml`) — runs SwiftLint fix + SwiftFormat on pre-commit, SwiftLint strict on pre-push
+- Tool versions are pinned in `Githubfile`
+
+### Dependencies
+
+- **StreamChat** and **StreamChatCommonUI** from [`stream-chat-swift`](https://github.com/GetStream/stream-chat-swift) (≥ 5.0.0-beta)
+- **Vendored libraries** (do not edit directly):
+  - `Sources/StreamChatSwiftUI/StreamNuke/` — vendored Nuke image loading
+  - `Sources/StreamChatSwiftUI/StreamSwiftyGif/` — vendored SwiftyGif
+  - Update these via `make update_nuke version=X.Y.Z` / `make update_swiftygif version=X.Y.Z`
 
 ### Project layout (high level)
 
+```
 Sources/
-  StreamChatSwiftUI/       # SwiftUI views, view models, theming, utils
-Tests/
-  StreamChatSwiftUITests/  # Unit/UI tests for SwiftUI layer
+  StreamChatSwiftUI/         # Main SDK: views, view models, theming, utils
+    ChatChannel/             # Channel view & sub-components
+    ChatChannelList/         # Channel list view & view model
+    ChatComposer/            # Message composer
+    ChatMessageList/         # Message list rendering
+    ChatThreadList/          # Thread list
+    CommonViews/             # Shared/reusable SwiftUI views
+    Generated/               # Auto-generated (L10n.swift, version) — do not edit manually
+    Resources/               # Localization files (en.lproj, etc.)
+    StreamNuke/              # Vendored — do not edit
+    StreamSwiftyGif/         # Vendored — do not edit
+    Utils/                   # Utilities, common helpers
+    ViewFactory/             # ViewFactory protocol & default implementation
+
+DemoAppSwiftUI/              # Demo/sample app (use to validate UI changes)
+StreamChatSwiftUITests/      # Unit & snapshot tests for the SDK
+StreamChatSwiftUITestsApp/   # Test harness app for E2E tests
+StreamChatSwiftUITestsAppTests/  # E2E / UI automation tests
+Scripts/                     # Helper scripts (bootstrap, dependency updates, docs)
+fastlane/                    # Fastlane lanes for CI (build, test, release)
+```
 
 When editing near other packages (e.g., StreamChat or StreamChatUI), prefer extending the SwiftUI layer rather than duplicating logic from dependencies.
 
 ### New files & target membership
-  When creating new source or resource files, add them to the correct Xcode target(s). Update the project (e.g. project.pbxproj) so each new file is included in the appropriate target's "Compile Sources" (or "Copy Bundle Resources" for assets). Match the target(s) used by sibling files in the same directory (e.g. Sources/StreamChatSwiftUI/ → StreamChatSwiftUI; Tests/StreamChatSwiftUITests/ → StreamChatSwiftUITests). Omitting target membership will cause build failures or unused files.
+
+When creating new source or resource files, add them to the correct Xcode target(s). Update the project (e.g. `project.pbxproj`) so each new file is included in the appropriate target's "Compile Sources" (or "Copy Bundle Resources" for assets). Match the target(s) used by sibling files in the same directory (e.g. `Sources/StreamChatSwiftUI/` → StreamChatSwiftUI target; `StreamChatSwiftUITests/` → StreamChatSwiftUITests target). Omitting target membership will cause build failures or unused files.
 
 ### Local setup (SPM)
 
-1. Open the repository in Xcode (root contains Package.swift).
+1. Open the repository in Xcode (root contains `Package.swift` and `StreamChatSwiftUI.xcodeproj`).
 2. Resolve packages.
 3. Choose an iOS Simulator (e.g., iPhone 17 Pro) and Build.
 
-Optional: sample/demo app
+Optional: run `Scripts/bootstrap.sh` to install pinned versions of SwiftLint, SwiftFormat, and SwiftGen, and to set up lefthook git hooks.
+
+### Demo app
 
-If a sample app target exists in this repo, prefer running that to validate UI changes. Keep demo configs free of credentials and use placeholders like YOUR_STREAM_KEY.
+The `DemoAppSwiftUI` target is a fully functional sample app. Prefer running it to validate UI changes. Keep demo configs free of credentials and use placeholders like `YOUR_STREAM_KEY`.
 
 ### Schemes
 
-Typical scheme names include:
-  • StreamChatSwiftUI
-  • StreamChatSwiftUITests
+Available shared schemes (under `StreamChatSwiftUI.xcodeproj/xcshareddata/xcschemes/`):
+  - `StreamChatSwiftUI` — builds the SDK framework
+  - `DemoAppSwiftUI` — builds and runs the demo app
+  - `StreamChatSwiftUITestsApp` — builds and runs the E2E test harness
 
 Agents must query existing schemes before invoking xcodebuild.
 
@@ -76,33 +112,82 @@ xcodebuild \
   -configuration Debug test
 ```
 
-If a Makefile or scripts exist (e.g., make build, make test, ./scripts/lint.sh), prefer those to keep parity with CI. Discover with make help and ls scripts/.
+### Linting & formatting
+
+SwiftLint (strict mode):
+
+```
+swiftlint lint --config .swiftlint.yml --strict
+```
+
+SwiftFormat (check only — no edits):
+
+```
+swiftformat --config .swiftformat --lint .
+```
+
+SwiftFormat (auto-fix):
 
-Linting & formatting
-  • SwiftLint (strict):
+```
+swiftformat --config .swiftformat .
+```
+
+Respect `.swiftlint.yml` and `.swiftformat` rules. Do not broadly disable rules; scope exceptions and justify in PRs.
+
+### CI overview
+
+CI is driven by Fastlane (see `fastlane/Fastfile`). Key lanes:
+
+- `test_ui` — runs unit/snapshot tests
+- `test_e2e_mock` — runs E2E tests against a mock server
+- `build_demo` — builds the demo app
+- `build_test_app_and_frameworks` — builds test app and SDK frameworks
+
+The `smoke-checks.yml` workflow is the primary PR gate. It runs linting, formatting validation, unit tests, E2E tests, and demo app builds.
 
-swiftlint --strict
+### Generated code
 
-  • Respect .swiftlint.yml and any repo-specific rules. Do not broadly disable rules; scope exceptions and justify in PRs.
+Do not manually edit files in `Sources/StreamChatSwiftUI/Generated/`:
+- `L10n.swift` — generated by SwiftGen from localization `.strings` files. Edit the `.strings` source files instead.
+- `SystemEnvironment+Version.swift` — updated automatically during releases.
+- `L10n_template.stencil` — the SwiftGen template for localization generation.
+
+### Localization
+
+The SDK uses `defaultLocalization: "en"`. String resources live in `Sources/StreamChatSwiftUI/Resources/en.lproj/`. After modifying `.strings` files, regenerate `L10n.swift` by running SwiftGen (or let CI handle it). Always use `L10n` accessors for user-facing strings rather than raw string literals.
+
+### Concurrency model
+
+The project uses Swift 6.0 strict concurrency. Many public types and view models are annotated with `@MainActor`. When adding new code:
+- Mark SwiftUI view models and UI-bound types as `@MainActor`
+- Use `Sendable` conformances where needed for cross-isolation transfers
+- Avoid introducing data races; the compiler will enforce actor isolation
 
 ### Development guidelines
 
 Accessibility & UI quality
 
 - Ensure components have accessibility labels, traits, and dynamic type support.
 - Support both light/dark mode.
-- Use the tokens, colors, fonts, utils etc all from InjectedValuesExtensions.swift.
-- When using Figma MCP, all the tokens, colors and fonts are available in the InjectedValuesExtensions.swift file with the same names.
+- Use the tokens, colors, fonts, utils etc all from `InjectedValuesExtensions.swift`.
+- When using Figma MCP, all the tokens, colors and fonts are available in the `InjectedValuesExtensions.swift` file with the same names.
 
 Testing policy
 
-- Add/extend tests in StreamChatSwiftUITests/
-- Prefer using the AssertSnapshot from StreamChatTestHelpers instead of using the SnapshotTesting framework directly.
-- Avoid using the AssertAsync from StreamChatTestHelpers, instead use the XCTestExpectation directly whenever possible.
+- Add/extend tests in `StreamChatSwiftUITests/Tests/` (mirrors the source directory structure)
+- Test infrastructure (mocks, shared helpers) lives in `StreamChatSwiftUITests/Infrastructure/`
+- Prefer using `AssertSnapshot` from StreamChatTestHelpers instead of using the SnapshotTesting framework directly.
+- Avoid using `AssertAsync` from StreamChatTestHelpers, instead use `XCTestExpectation` directly whenever possible.
+
+### Branching & changelog
+
+- The default integration branch is `develop`. Feature branches are merged into `develop`.
+- Update `CHANGELOG.md` under the `# Upcoming` section when making client-facing changes (follow the Keep a Changelog format with `### Added`, `### Fixed`, `### Changed` subsections).
 
-Pull Requests:
+### Pull Requests
 
 - Use the Github CLI to create a PR and use the Linear MCP to link the relevant issue assigned to me.
-- When creating a PR, the base branch should be the v5 branch.
-- Make sure that the PR respects the PR template in .github/PULL_REQUEST_TEMPLATE.md.
+- When creating a PR, the base branch should be the `develop` branch.
+- Make sure that the PR respects the PR template in `.github/PULL_REQUEST_TEMPLATE.md`.
 - Make sure to fill the template with atomic information, do not mention things that were done and then reverted in this same PR.
+- Do not write "Made with Cursor" in the PR description.

CHANGELOG.md

@@ -5,6 +5,64 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### 🔄 Changed
 
+# [5.0.0](https://github.com/GetStream/stream-chat-swiftui/releases/tag/5.0.0)
+_April 16, 2026_
+
+### ✅ Added
+- Redesign attachment uploading progress and error state indicators [#1408](https://github.com/GetStream/stream-chat-swiftui/pull/1408)
+- Add inline upload progress and retry UI for file attachments [#1408](https://github.com/GetStream/stream-chat-swiftui/pull/1408)
+- Add `RetryBadgeView` for failed uploads and thumbnail loads [#1408](https://github.com/GetStream/stream-chat-swiftui/pull/1408)
+- Add `ComposerConfig.isVoiceRecordingAutoSendEnabled` to support sending a recording instantly on release [#1362](https://github.com/GetStream/stream-chat-swiftui/pull/1362)
+- Redesign `JumpToUnreadButton` [#1351](https://github.com/GetStream/stream-chat-swiftui/pull/1351)
+- Show deleted messages in channel list preview [#1338](https://github.com/GetStream/stream-chat-swiftui/pull/1338)
+- Update deleted message design in the message list [#1349](https://github.com/GetStream/stream-chat-swiftui/pull/1349)
+- Redesign new messages divider in the message list [#1354](https://github.com/GetStream/stream-chat-swiftui/pull/1354)
+- Redesign the thread replies divider in the message replies list [#1354](https://github.com/GetStream/stream-chat-swiftui/pull/1354)
+
+### 🐞 Fixed
+- Fix attachment downloads not using CDN requester for URL signing and custom headers [#1399](https://github.com/GetStream/stream-chat-swiftui/pull/1399)
+- Fix empty share sheet when sharing a video from the full-screen media viewer [#1418](https://github.com/GetStream/stream-chat-swiftui/pull/1418)
+- Fix swipe-to-reply icon layout for outgoing messages and RTL [#1402](https://github.com/GetStream/stream-chat-swiftui/pull/1402)
+- Fix unwanted border on the Edit button in Channel Info [#1402](https://github.com/GetStream/stream-chat-swiftui/pull/1402)
+- Fix send button icon not mirroring in RTL layouts [#1397](https://github.com/GetStream/stream-chat-swiftui/pull/1397)
+- Fix composer attachment picker prompt views layout to center all content vertically [#1397](https://github.com/GetStream/stream-chat-swiftui/pull/1397)
+- Fix poll icon inconsistency in the attachment type picker and attachment previews [#1397](https://github.com/GetStream/stream-chat-swiftui/pull/1397)
+- Fix voice recording attachment container rendering when quoting a message [#1388](https://github.com/GetStream/stream-chat-swiftui/pull/1388)
+- Fix annotation button colors in the reactions overlay [#1386](https://github.com/GetStream/stream-chat-swiftui/pull/1386)
+- Fix error indicator position and styling to match v5 design [#1383](https://github.com/GetStream/stream-chat-swiftui/pull/1383)
+- Fix scroll to bottom button not working when the message list is actively scrolling [#1380](https://github.com/GetStream/stream-chat-swiftui/pull/1380)
+- Fix timestamp snapping back faster than delivery indicator on swipe-to-reply [#1360](https://github.com/GetStream/stream-chat-swiftui/pull/1360)
+- Fix tapping a non-first media attachment always opening the first item on initial tap [#1359](https://github.com/GetStream/stream-chat-swiftui/pull/1359)
+- Pinned message label now shows "Pinned by you" when the current user pinned the message [#1329](https://github.com/GetStream/stream-chat-swiftui/pull/1329)
+- Fix single media attachment without sharp tail corner when no caption [#1330](https://github.com/GetStream/stream-chat-swiftui/pull/1330)
+- Fix editing a voice message removing the voice recording attachment [#1327](https://github.com/GetStream/stream-chat-swiftui/pull/1327)
+- Fix hold-and-release mic gesture not sending the voice message immediately [#1327](https://github.com/GetStream/stream-chat-swiftui/pull/1327)
+- Fix voice message playback state and waveform slider updates [#1327](https://github.com/GetStream/stream-chat-swiftui/pull/1327)
+- Fix split view navigation on iPad [#1320](https://github.com/GetStream/stream-chat-swiftui/pull/1320)
+- Fix rendering 1:1 direct message avatars and presence indicators [#1332](https://github.com/GetStream/stream-chat-swiftui/pull/1332)
+- Fix giphy previews in the channel list and quote replies [#1333](https://github.com/GetStream/stream-chat-swiftui/pull/1333)
+- Fix black borders on image preview in composer when editing or quoting a message [#1334](https://github.com/GetStream/stream-chat-swiftui/pull/1334)
+- Fix quoted image preview not updating when switching to a different quoted message [#1334](https://github.com/GetStream/stream-chat-swiftui/pull/1334)
+- Use fixed width for attachment previews [#1335](https://github.com/GetStream/stream-chat-swiftui/pull/1335)
+- Fix showing bubble for quoted message and file or image attachment [#1335](https://github.com/GetStream/stream-chat-swiftui/pull/1335)
+- Fix scaling of giphy attachments [#1335](https://github.com/GetStream/stream-chat-swiftui/pull/1335)
+- Fix spacings in message annotations [#1403](https://github.com/GetStream/stream-chat-swiftui/pull/1403)
+
+### 🔄 Changed
+- Rename `AddUsersView`/`AddUsersViewModel` to `MemberAddView`/`MemberAddViewModel` [#1402](https://github.com/GetStream/stream-chat-swiftui/pull/1402)
+- Unify Channel Info navigation headers styling [#1402](https://github.com/GetStream/stream-chat-swiftui/pull/1402)
+- Renamed the `onMessageSent` callback to `willSendMessage` in `MessageComposerViewModel`, `ViewModelsFactory`, and `ComposerViewFactoryOptions` [#1327](https://github.com/GetStream/stream-chat-swiftui/pull/1327)
+- Remove `InjectedChannelInfo` from `ChatChannelListItemView` [#1338](https://github.com/GetStream/stream-chat-swiftui/pull/1338)
+- Rename empty state views from `No` prefix to `Empty` prefix [#1345](https://github.com/GetStream/stream-chat-swiftui/pull/1345)
+- Migrate all the old color tokens to new color tokens [#1350](https://github.com/GetStream/stream-chat-swiftui/pull/1350)
+- Replace `LinkDetectionTextView` with `StreamTextView` that uses `ChatMessage.attributedTextContent(layoutDirection:translationLanguage:)` [#1411](https://github.com/GetStream/stream-chat-swiftui/pull/1411)
+
+# [4.99.1](https://github.com/GetStream/stream-chat-swiftui/releases/tag/4.99.1)
+_April 01, 2026_
+
+### 🐞 Fixed
+- Fix pause button size in voice recording view [#1344](https://github.com/GetStream/stream-chat-swiftui/pull/1344)
+
 # [5.0.0-beta](https://github.com/GetStream/stream-chat-swiftui/releases/tag/5.0.0-beta)
 _March 23, 2026_
 

DemoAppSwiftUI/AppConfiguration/AppConfiguration.swift

@@ -21,28 +21,31 @@ final class AppConfiguration {
     var reactionsPlacement: ReactionsPlacement = .top
     /// The visual style used across the app (regular or liquid glass).
     var appStyle: AppStyle = .regular
+    /// When enabled, releasing a hold-to-record gesture sends the voice message instantly.
+    var isVoiceRecordingAutoSendEnabled = false
 
     enum AppStyle: String, CaseIterable {
         case regular
         case liquidGlass
     }
 
+    /// Builds the demo app's `ComposerConfig` using current app configuration.
+    @MainActor static func makeComposerConfig() -> ComposerConfig {
+        ComposerConfig(
+            isVoiceRecordingAutoSendEnabled: AppConfiguration.default.isVoiceRecordingAutoSendEnabled
+        )
+    }
+
     /// Builds the demo app's `MessageListConfig` using current app configuration.
     @MainActor static func makeMessageListConfig() -> MessageListConfig {
         MessageListConfig(
             messageDisplayOptions: MessageDisplayOptions(
                 reactionsPlacement: AppConfiguration.default.reactionsPlacement,
-                reactionsStyle: AppConfiguration.default.reactionsStyle,
-                showOriginalTranslatedButton: true
+                reactionsStyle: AppConfiguration.default.reactionsStyle
             ),
-            dateIndicatorPlacement: .messageList,
-            userBlockingEnabled: true,
-            bouncedMessagesAlertActionsEnabled: true,
             skipEditedMessageLabel: { message in
                 message.extraData["ai_generated"]?.boolValue == true
-            },
-            draftMessagesEnabled: true,
-            downloadFileAttachmentsEnabled: true
+            }
         )
     }
 }