feat(repo)!: design refresh

.github/dependabot.yml

@@ -25,7 +25,6 @@ updates:
   # All packages grouped into a single configuration using multi-directory support
   - package-ecosystem: "pub"
     directories:
-      - "/sample_app"
       - "/packages/stream_chat"
       - "/packages/stream_chat_flutter_core"
       - "/packages/stream_chat_flutter"

.github/workflows/distribute_external.yml

@@ -71,7 +71,6 @@ jobs:
         with:
           flutter-version: ${{ env.FLUTTER_VERSION }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
 
       - name: Setup Ruby
@@ -109,7 +108,6 @@ jobs:
         with:
           flutter-version: ${{ env.FLUTTER_VERSION }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
 
       - name: Setup Ruby

.github/workflows/distribute_internal.yml

@@ -75,7 +75,6 @@ jobs:
         with:
           flutter-version: ${{ env.FLUTTER_VERSION }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
 
       - name: "Install Tools"
@@ -119,7 +118,6 @@ jobs:
         with:
           flutter-version: ${{ env.FLUTTER_VERSION }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
 
       - name: "Install Tools"
@@ -144,3 +142,46 @@ jobs:
           MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
           APPSTORE_API_KEY: ${{ secrets.APPSTORE_API_KEY }}
         run: bundle exec fastlane distribute_to_firebase
+
+  # TODO: Remove once feat/design-refresh is merged to master
+  ios_testflight:
+    needs: determine_platforms
+    if: ${{ needs.determine_platforms.outputs.run_ios == 'true' }}
+    runs-on: macos-15 # Requires xcode 15 or later
+    timeout-minutes: 30
+    steps:
+      - name: Connect Bot
+        uses: webfactory/ssh-agent@v0.9.1
+        with:
+          ssh-private-key: ${{ secrets.BOT_SSH_PRIVATE_KEY }}
+
+      - name: "Git Checkout"
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: "Install Flutter"
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: ${{ env.FLUTTER_VERSION }}
+          channel: stable
+          cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
+
+      - name: "Install Tools"
+        run: flutter pub global activate melos
+
+      - name: "Bootstrap Workspace"
+        run: melos bootstrap
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+          working-directory: sample_app/ios
+
+      - name: Distribute to TestFlight Internal
+        working-directory: sample_app/ios
+        env:
+          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
+          APPSTORE_API_KEY: ${{ secrets.APPSTORE_API_KEY }}
+        run: bundle exec fastlane distribute_to_testflight_internal

.github/workflows/legacy_version_analyze.yml

@@ -3,7 +3,7 @@ name: legacy_version_analyze
 env:
   # Note: The versions below should be manually updated after a new stable
   # version comes out.
-  flutter_version: "3.27.4"
+  flutter_version: "3.38.1"
 
 on:
   push:
@@ -44,7 +44,6 @@ jobs:
         with:
           flutter-version: ${{ env.flutter_version }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
 
       - name: 📊 Analyze and test packages

.github/workflows/stream_flutter_workflow.yml

@@ -38,7 +38,6 @@ jobs:
         with:
           flutter-version: ${{ env.flutter_version }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
       - name: "Install Tools"
         run: |
@@ -67,7 +66,6 @@ jobs:
         with:
           flutter-version: ${{ env.flutter_version }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
       - name: "Install Tools"
         run: |
@@ -94,7 +92,6 @@ jobs:
         with:
           flutter-version: ${{ env.flutter_version }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
       # This step is needed due to https://github.com/actions/runner-images/issues/11279
       - name: Install SQLite3
@@ -168,7 +165,6 @@ jobs:
         with:
           flutter-version: ${{ env.flutter_version }}
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
       - name: "Install Tools"
         run: flutter pub global activate melos

.github/workflows/update_goldens.yml

@@ -16,7 +16,6 @@ jobs:
         with:
           flutter-version: "3.x"
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
 
       - name: 📦 Install Tools

.gitignore

@@ -66,6 +66,7 @@ GeneratedPluginRegistrant.*
 **/ios/**/xcuserdata
 **/ios/.generated/
 **/ios/Flutter/App.framework
+**/ios/Flutter/ephemeral
 **/ios/Flutter/Flutter.framework
 **/ios/Flutter/Flutter.podspec
 **/ios/Flutter/Generated.xcconfig

CLAUDE.md

@@ -0,0 +1,148 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This is a Dart/Flutter monorepo for Stream Chat's official Flutter SDK, managed with [Melos](https://pub.dev/packages/melos). All packages live under `packages/`.
+
+## Common Commands
+
+### Setup
+```bash
+melos bootstrap          # Fetch and link all dependencies (equivalent to pub get for all packages)
+```
+
+### Testing
+```bash
+melos run test:all       # Run all Dart & Flutter tests
+melos run test:dart      # Run Dart-only tests
+melos run test:flutter   # Run Flutter tests
+# Run tests in a specific package:
+cd packages/stream_chat_flutter && flutter test
+cd packages/stream_chat_flutter && flutter test test/src/path/to/test_file.dart
+```
+
+### Golden Tests
+```bash
+melos run update:goldens    # Regenerate all golden image files
+# In CI, CI goldens are used; locally, platform goldens are used (configured via alchemist)
+```
+
+### Linting & Formatting
+```bash
+melos run lint:all       # Run analyze + format
+melos run analyze        # Run dart analyze --fatal-infos on all packages
+melos run format   # Check formatting (page width: 120)
+```
+
+### Code Generation
+```bash
+melos run generate:all      # Run build_runner for all packages
+melos run generate:flutter  # Run build_runner for Flutter packages only
+melos run generate:dart     # Run build_runner for Dart packages only
+```
+
+### Versioning
+```bash
+melos run version:update    # Regenerate version.dart from pubspec.yaml (runs automatically after bootstrap)
+```
+
+## Package Architecture
+
+The SDK is layered — each package builds on top of the previous:
+
+```
+stream_chat                    # Pure Dart, no Flutter dependency
+  └── stream_chat_persistence  # Local disk cache using Drift (optional)
+      └── stream_chat_flutter_core  # Flutter business logic, no UI
+          └── stream_chat_flutter  # Full UI component library
+              └── stream_chat_localizations  # i18n for UI components
+```
+
+### `stream_chat`
+Low-level Dart client. Key types:
+- `StreamChatClient` — central API client, manages WebSocket, REST, and state
+- `Channel` — represents a chat channel, has its own state and streaming APIs
+- Models in `lib/src/core/models/`: `Message`, `User`, `Member`, `Reaction`, `Poll`, `Event`, `Attachment`, `Draft`, etc.
+- Generated code (`.g.dart`, `.freezed.dart`) for JSON serialization/immutable models — do not edit manually
+
+### `stream_chat_flutter_core`
+Business logic layer. Key types:
+- `StreamChatCore` — root widget, manages app lifecycle, WebSocket reconnection, and connectivity
+- `StreamChannel` — provides a `Channel` to the widget tree via `StreamChannel.of(context)`
+- `PagedValueNotifier<Key, Value>` — base class for all list controllers
+- Controllers: `StreamChannelListController`, `StreamMessageListController` (via `MessageListCore`), `StreamUserListController`, `StreamMemberListController`, `StreamThreadListController`, `StreamDraftListController`, `StreamMessageReminderListController`, `StreamPollController`
+- `BetterStreamBuilder<T>` — efficient StreamBuilder that only rebuilds when data changes
+
+### `stream_chat_flutter`
+Full UI package. Key architectural points:
+
+**Root widget hierarchy:**
+`StreamChat` → `StreamChatTheme` → `StreamChatConfiguration` → `StreamChatCore` → app content
+
+**Theming:** `StreamChatThemeData` (accessed via `StreamChatTheme.of(context)`) contains per-component theme data objects. Components read their theme from context. `StreamChatConfigurationData` holds non-theme UI config.
+
+**Widget tree integration pattern:**
+- `StreamChat.of(context)` — get the chat state (current user, client)
+- `StreamChannel.of(context)` — get the current channel state
+- `StreamChatTheme.of(context)` — get current theme data
+
+**Key UI components:**
+- `StreamChannelListView` + `StreamChannelListTile` — channel list using `StreamChannelListController`
+- `StreamMessageListView` — message list with floating date dividers, unread indicators, thread separators
+- `StreamMessageInput` (legacy) / `StreamChatMessageComposer` (new design system) — message composition
+- `StreamMessageWidget` — renders individual messages with attachments, reactions, threads
+- Scroll views in `lib/src/scroll_view/` — generic paged scroll views for channels, threads, members, users, drafts, polls
+
+**New design system components** (`lib/src/components/`):
+- `StreamUserAvatar`, `StreamChannelAvatar`, `StreamUserAvatarGroup` — avatar components; these are chat-domain wrappers around the base components in `stream_core_flutter`
+- `StreamChatMessageComposer` — new composer using `MessageComposerFactory` for custom layouts
+
+**Golden tests:** Use `alchemist` package. Platform goldens used locally, CI goldens used in CI (detected via `CI`/`GITHUB_ACTIONS` env vars). Goldens stored alongside tests in `goldens/` subdirectories.
+
+### `stream_chat_localizations`
+Provides `StreamChatLocalizations` — Flutter localizations delegate with translations for all UI strings.
+
+### `stream_chat_persistence`
+Optional local persistence using Drift (SQLite). Implements `ChatPersistenceClient` from `stream_chat`.
+
+## Code Style
+
+- Line length: **120 characters** (configured in `analysis_options.yaml`)
+- Imports: always use package imports (`always_use_package_imports`), not relative imports
+- All public APIs **must** have doc comments (`public_member_api_docs`)
+- Sort constructors first, unnamed constructors before named
+- Prefer `const` constructors, `final` locals, single quotes
+- Trailing commas: `preserve` (formatter setting)
+- Generated files (`.g.dart`, `.freezed.dart`) are excluded from analysis
+
+## PR & Commit Conventions
+
+PR titles follow [Conventional Commits](https://www.conventionalcommits.org/):
+- `fix(scope): description` — bug fix
+- `feat(scope): description` — new feature
+- `refactor(scope)!: description` — breaking change
+- `chore(scope): description`, `docs:`, `test:`, etc.
+
+After modifying any package, update its `CHANGELOG.md`.
+
+## Figma Designs
+
+UI designs for this SDK are in the **Chat SDK Design system** Figma project. Use the Figma MCP server to look up designs when implementing or updating UI components.
+
+## `stream_core_flutter` (external sibling repo)
+
+Basic UI components that can be shared across Stream products live in the `stream_core_flutter` package in the **stream-core-flutter** repository (a sibling repo, not inside this monorepo). These components:
+- Never depend on chat domain models (`Channel`, `Message`, `User`, etc.)
+- Provide primitive building blocks: avatars, layout primitives, theming tokens, etc.
+
+Components in this repo can be wrappers around those base components, adding chat domain models and extra logic on top. For example, `StreamChannelAvatar` wraps the base `StreamAvatarGroup` from `stream_core_flutter` and adds channel-specific member resolution logic.
+
+`stream_core_flutter` types used here are re-exported via a `show` allowlist in `lib/stream_chat_flutter.dart`. When adding a new type from `stream_core_flutter`, add it to that allowlist.
+
+## Dependency Management
+
+Dependencies are centrally managed in `melos.yaml` under `command.bootstrap.dependencies`. Do **not** edit version constraints directly in individual `pubspec.yaml` files — update `melos.yaml` and run `melos bootstrap`.
+
+> Note: `stream_chat_flutter` uses a local path dependency to `stream_core_flutter` (pointing to the sibling repo) when making changes to both repos together. Use a git dependency when no local changes to `stream_core_flutter` are needed.

analysis_options.yaml

@@ -4,6 +4,10 @@ analyzer:
     - packages/*/lib/scrollable_positioned_list/**
     - packages/*/lib/**/*.freezed.dart
 
+formatter:
+  page_width: 120
+  trailing_commas: preserve
+
 linter:
   rules:
     # these rules are documented on and in the same order as
@@ -19,7 +23,6 @@ linter:
     - control_flow_in_finally
     - empty_statements
     - hash_and_equals
-    - invariant_booleans
     - literal_only_boolean_expressions
     - no_adjacent_strings_in_list
     - no_duplicate_case_values
@@ -40,7 +43,9 @@ linter:
     - avoid_null_checks_in_equality_operators
     - avoid_positional_boolean_parameters
     - avoid_private_typedef_functions
-    - avoid_redundant_argument_values
+    # Does not always make sense to remove them; it also makes it hard
+    # to notice future breaking changes.
+    # - avoid_redundant_argument_values
     - avoid_return_types_on_setters
     - avoid_returning_null_for_void
     - avoid_shadowing_type_parameters
@@ -64,7 +69,6 @@ linter:
     - leading_newlines_in_multiline_strings
     - library_names
     - library_prefixes
-    - lines_longer_than_80_chars
     - missing_whitespace_between_adjacent_strings
     - non_constant_identifier_names
     - null_closures
@@ -81,7 +85,6 @@ linter:
     - prefer_const_declarations
     - prefer_const_literals_to_create_immutables
     - prefer_contains
-    - prefer_equal_for_default_values
     - prefer_final_fields
     - prefer_final_in_for_each
     - prefer_final_locals

melos.yaml

@@ -1,4 +1,4 @@
-name: stream_chat_flutter
+name: stream_chat_flutter_workspace
 repository: https://github.com/GetStream/stream-chat-flutter
 
 packages:
@@ -18,9 +18,9 @@ command:
   bootstrap:
     # Dart and Flutter environment used in the project.
     environment:
-      sdk: ^3.6.2
+      sdk: ^3.10.0
       # We are not using carat '^' syntax here because flutter don't follow semantic versioning.
-      flutter: ">=3.27.4"
+      flutter: ">=3.38.1"
 
     # List of all the dependencies used in the project.
     dependencies:
@@ -73,7 +73,7 @@ command:
       package_info_plus: ">=8.3.0 <10.0.0"
       path: ^1.8.3
       path_provider: ^2.1.3
-      photo_manager: ^3.2.0
+      photo_manager: ^3.8.3
       photo_view: ^0.15.0
       provider: ^6.0.5
       rate_limiter: ^1.0.0
@@ -91,6 +91,12 @@ command:
       stream_chat_persistence: ^10.0.0-beta.12
       streaming_shared_preferences: ^2.0.0
       svg_icon_widget: ^0.0.1
+      # TODO: Replace with hosted version before merging PR
+      stream_core_flutter:
+        git:
+          url: https://github.com/GetStream/stream-core-flutter.git
+          ref: 8057a775c2ed764dbd5cbabd2dd60d3cd68d2f08
+          path: packages/stream_core_flutter
       synchronized: ^3.1.0+1
       thumblr: ^0.0.4
       url_launcher: ^6.3.0
@@ -100,7 +106,7 @@ command:
 
     # List of all the dev_dependencies used in the project.
     dev_dependencies:
-      alchemist: ">=0.11.0 <0.14.0"
+      alchemist: ^0.13.0
       build_runner: ^2.4.9
       connectivity_plus_platform_interface: ^2.0.0
       drift_dev: ^2.28.0