feat(repo)!: v10.0.0

.fvmrc

@@ -1,3 +1,3 @@
 {
-  "flutter": "3.27.4"
-}
+  "flutter": "3.38.1"
+}

.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_internal.yml

@@ -4,8 +4,8 @@ on:
   push:
     branches:
       - master
-      # TODO: Remove feat/design-refresh once merged to master
-      - feat/design-refresh
+      # TODO: Remove once merged to master
+      - v10.0.0
   workflow_dispatch:
     inputs:
       platform:

.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:
@@ -65,7 +65,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

@@ -43,6 +43,7 @@ jobs:
         with:
           filters: |
             relevant:
+              - 'docs/**'
               - 'packages/**'
               - 'sample_app/**'
               - '.github/workflows/stream_flutter_workflow.yml'

.github/workflows/update_goldens.yml

@@ -1,22 +1,82 @@
 name: update_goldens
 
-on: workflow_dispatch
+on:
+  workflow_dispatch:
+    inputs:
+      target:
+        description: "Which goldens to update"
+        required: true
+        type: choice
+        default: both
+        options:
+          - both
+          - sdk
+          - docs
 
 jobs:
-  update_goldens:
+  update_sdk_goldens:
+    if: inputs.target == 'sdk' || inputs.target == 'both'
     runs-on: ubuntu-latest
+    outputs:
+      changed: ${{ steps.detect.outputs.changed }}
     steps:
       - name: 📚 Checkout branch
         uses: actions/checkout@v6
+
+      - name: 🐦 Install Flutter
+        uses: subosito/flutter-action@v2
         with:
-          ssh-key: ${{ secrets.BOT_SSH_PRIVATE_KEY }}
+          flutter-version: "3.x"
+          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 --verbose
+
+      - name: 🖼️ Update SDK Goldens
+        continue-on-error: true
+        run: melos run update:goldens:sdk
+
+      - name: 🔍 Detect changed goldens
+        id: detect
+        run: |
+          if [[ -z "$(git status --porcelain -- 'packages/**/test/**/goldens/**/*.png')" ]]; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: 📦 Bundle SDK goldens
+        if: steps.detect.outputs.changed == 'true'
+        run: |
+          find packages -path '*/test/*/goldens/*' -name '*.png' -print0 \
+            | tar --null -czf sdk-goldens.tgz -T -
+
+      - name: 📤 Upload SDK goldens artifact
+        if: steps.detect.outputs.changed == 'true'
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdk-goldens
+          path: sdk-goldens.tgz
+          retention-days: 1
+
+  update_docs_goldens:
+    if: inputs.target == 'docs' || inputs.target == 'both'
+    runs-on: macos-latest
+    outputs:
+      changed: ${{ steps.detect.outputs.changed }}
+    steps:
+      - name: 📚 Checkout branch
+        uses: actions/checkout@v6
 
       - name: 🐦 Install Flutter
         uses: subosito/flutter-action@v2
         with:
           flutter-version: "3.x"
           channel: stable
-          cache: true
           cache-key: flutter-:os:-:channel:-:version:-:arch:-:hash:-${{ hashFiles('**/pubspec.lock') }}
 
       - name: 📦 Install Tools
@@ -25,14 +85,71 @@ jobs:
       - name: 🔧 Bootstrap Workspace
         run: melos bootstrap --verbose
 
-      - name: 🖼️ Update Goldens
+      - name: 🖼️ Update Docs Goldens
         continue-on-error: true
-        run: melos run update:goldens
+        run: melos run update:goldens:docs
+
+      - name: 🔍 Detect changed goldens
+        id: detect
+        run: |
+          if [[ -z "$(git status --porcelain -- 'docs/**/test/**/goldens/**/*.png')" ]]; then
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: 📦 Bundle docs goldens
+        if: steps.detect.outputs.changed == 'true'
+        run: |
+          find docs -path '*/test/*/goldens/*' -name '*.png' -print0 \
+            | tar --null -czf docs-goldens.tgz -T -
+
+      - name: 📤 Upload docs goldens artifact
+        if: steps.detect.outputs.changed == 'true'
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-goldens
+          path: docs-goldens.tgz
+          retention-days: 1
+
+  commit_goldens:
+    needs: [update_sdk_goldens, update_docs_goldens]
+    # `always()` lets this run even when one regen job was skipped (e.g. target=sdk).
+    # We commit only when at least one regen produced actual changes — no diff means
+    # no artifact uploaded, so a workflow run with no golden changes ends as a no-op.
+    if: |
+      always() &&
+      (needs.update_sdk_goldens.outputs.changed == 'true' ||
+       needs.update_docs_goldens.outputs.changed == 'true')
+    runs-on: ubuntu-latest
+    steps:
+      - name: 📚 Checkout branch
+        uses: actions/checkout@v6
+        with:
+          ssh-key: ${{ secrets.BOT_SSH_PRIVATE_KEY }}
+
+      - name: 📥 Download SDK goldens
+        if: needs.update_sdk_goldens.outputs.changed == 'true'
+        uses: actions/download-artifact@v4
+        with:
+          name: sdk-goldens
+
+      - name: 📥 Download docs goldens
+        if: needs.update_docs_goldens.outputs.changed == 'true'
+        uses: actions/download-artifact@v4
+        with:
+          name: docs-goldens
+
+      - name: 📦 Extract goldens
+        run: |
+          for tgz in sdk-goldens.tgz docs-goldens.tgz; do
+            [[ -f "$tgz" ]] && tar -xzf "$tgz" && rm "$tgz"
+          done
 
       - name: 📤 Commit Changes
         uses: stefanzweifel/git-auto-commit-action@v7
         with:
           commit_message: "chore: Update Goldens"
-          file_pattern: "**/test/**/goldens/*.png"
+          file_pattern: "**/test/**/goldens/**/*.png"
           commit_user_name: "Stream SDK Bot"
           commit_user_email: "60655709+Stream-SDK-Bot@users.noreply.github.com"

.gitignore

@@ -34,6 +34,7 @@ coverage_helper_test.dart
 **/doc/api/
 pubspec.lock
 pubspec_overrides.yaml
+devtools_options.yaml
 flutter_export_environment.sh
 generated_plugin_registrant.*
 GeneratedPluginRegistrant.*
@@ -66,6 +67,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
+- `StreamMessageComposer` (full-featured) / `StreamChatMessageInput` (new design system, UI-only) — 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`
+- `StreamChatMessageInput` — 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.