GetStream
diff --git a/‎.github/workflows/legacy_version_analyze.yml‎
Lines changed: 1 addition & 1 deletion b/‎.github/workflows/legacy_version_analyze.yml‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.github/workflows/pr_title.yml‎
Lines changed: 3 additions & 2 deletions b/‎.github/workflows/pr_title.yml‎
Lines changed: 3 additions & 2 deletions
diff --git a/‎.github/workflows/publish_gallery.yml‎
Lines changed: 0 additions & 1 deletion b/‎.github/workflows/publish_gallery.yml‎
Lines changed: 0 additions & 1 deletion
diff --git a/‎.github/workflows/stream_core_flutter_workflow.yml‎
Lines changed: 3 additions & 1 deletion b/‎.github/workflows/stream_core_flutter_workflow.yml‎
Lines changed: 3 additions & 1 deletion
diff --git a/‎CLAUDE.md‎
Lines changed: 98 additions & 0 deletions b/‎CLAUDE.md‎
Lines changed: 98 additions & 0 deletions
diff --git a/‎all_lint_rules.yaml‎
Lines changed: 36 additions & 9 deletions b/‎all_lint_rules.yaml‎
Lines changed: 36 additions & 9 deletions
diff --git a/‎analysis_options.yaml‎
Lines changed: 18 additions & 2 deletions b/‎analysis_options.yaml‎
Lines changed: 18 additions & 2 deletions
@@ -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.10"
 
 on:
   push:
 
@@ -20,21 +20,22 @@ jobs:
         with: 
           scopes: |
             llc
+            ui
             repo
           requireScope: true
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
   semantic_changelog_update:
-    if: ${{ false }} # TODO: Enable after the first release
     needs: conventional_pr_title # Trigger after the [conventional_pr_title] completes
     runs-on: ubuntu-latest
     steps:
       - uses: GetStream/verify-semantic-changelog-update@main
         with:
           scopes: |
             {
-              "llc": "packages/stream_core"
+              "llc": "packages/stream_core",
+              "ui": "packages/stream_core_flutter"
             }
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -25,7 +25,6 @@ jobs:
         run: |
           git config --global user.email "$(git log --format='%ae' HEAD^!)"
           git config --global user.name "$(git log --format='%an' HEAD^!)"
-          git fetch origin gh-pages:gh-pages
 
       - name: Setup Flutter
         uses: subosito/flutter-action@v2
 
@@ -23,9 +23,11 @@ jobs:
   analyze:
     timeout-minutes: 15
     runs-on: ubuntu-latest
+    env:
+      IS_CI: 'true'
     steps:
       - name: Git Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
 
@@ -0,0 +1,98 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+A Flutter monorepo managed with **Melos** containing:
+- `packages/stream_core` — Pure Dart SDK (WebSocket, HTTP, models, utilities)
+- `packages/stream_core_flutter` — Flutter UI component library with a full design system
+- `apps/design_system_gallery` — Widgetbook-based interactive component showcase
+
+## Common Commands
+
+All commands use Melos and should be run from the repo root.
+
+```bash
+# Setup
+melos bootstrap
+
+# Linting & formatting
+melos run lint:all          # analyze + format check
+melos run analyze
+melos run format
+melos run format:verify     # check only, no changes
+
+# Testing
+melos run test:all          # all tests with coverage
+melos run test:dart         # stream_core only
+melos run test:flutter      # stream_core_flutter only
+
+# Golden tests
+melos run update:goldens    # regenerate golden images
+
+# Code generation (run after model/theme changes)
+melos run generate:all
+melos run generate:icons    # regenerate icon font from SVGs
+melos run gen-l10n          # regenerate localizations
+```
+
+### Icons
+
+Source SVGs in `packages/stream_core_flutter/assets_source/icons/` come from the [design-system-tokens](https://github.com/GetStream/design-system-tokens/tree/main/assets/icons) repository. When adding or updating icons, pull the latest SVGs from that repo first, then run `melos run generate:icons` to regenerate the icon font and Dart classes.
+
+**Line width:** 120 characters (set in `analysis_options.yaml`).
+
+## Design
+
+UI components are designed in **Figma**. When implementing or modifying components, use the **Figma MCP** to inspect designs directly — check spacing, colors, typography, and component structure from the source rather than guessing.
+
+## Architecture
+
+### Theme System (`stream_core_flutter/lib/src/theme/`)
+
+Uses `theme_extensions_builder` to generate Material 3 theme extensions. The hierarchy is:
+
+1. **Primitives** — raw design tokens: colors, typography, spacing, radius, icons
+2. **Semantics** — semantic mappings (e.g., `primaryColor`, `bodyText`)
+3. **Component themes** — per-widget theme classes (50+ components), defined in `theme/components/`
+4. **Tokens** — light/dark concrete values in `theme/tokens/`
+
+Generated files have `.g.theme.dart` extension. After modifying `.theme.dart` files, run `melos run generate:flutter`.
+
+### Component Structure (`stream_core_flutter/lib/src/components/`)
+
+Components are organized by category: `avatar/`, `buttons/`, `badge/`, `list/`, `message_composer/`, `emoji/`, `context_menu/`, `controls/`, `common/`, `accessories/`.
+
+Each component typically has:
+- A widget file
+- A theme file in `theme/components/`
+- A golden test in `test/components/<name>/`
+- A Widgetbook use-case in `apps/design_system_gallery/`
+
+### stream_core Package
+
+Pure Dart. Key modules:
+- `src/ws/` — WebSocket client with reconnect/backoff logic (RxDart-based)
+- `src/api/` — Dio HTTP client with interceptors
+- `src/attachment/` — File upload and CDN client
+- `src/query/` — Query builders and filter models
+- `src/logger/` — Structured logging
+- `src/user/` — User models and token management
+
+### Golden Testing
+
+Golden tests use **Alchemist** (`^0.13.0`). Goldens are stored under:
+- `test/components/<name>/goldens/ci/` — for CI
+- `test/components/<name>/goldens/macos/` — for local macOS development
+
+Golden tests are tagged with `golden` in `dart_test.yaml`. Run `melos run update:goldens` to regenerate after visual changes.
+
+### Code Generation
+
+- **json_serializable** — model serialization (`.g.dart` files)
+- **build_runner** — orchestrates all generation
+- **theme_extensions_builder** — generates theme extension classes (`.g.theme.dart`)
+- **widgetbook_generator** — auto-generates Widgetbook entries
+
+After any model or theme annotation changes, run the appropriate generate command before running tests.
@@ -3,10 +3,10 @@ linter:
     - always_declare_return_types
     - always_put_control_body_on_new_line
     - always_put_required_named_parameters_first
-    - always_require_non_null_named_parameters
     - always_specify_types
     - always_use_package_imports
     - annotate_overrides
+    - annotate_redeclares
     - avoid_annotating_with_dynamic
     - avoid_bool_literals_in_conditional_expressions
     - avoid_catches_without_on_clauses
@@ -20,6 +20,7 @@ linter:
     - avoid_field_initializers_in_const_classes
     - avoid_final_parameters
     - avoid_function_literals_in_foreach_calls
+    - avoid_futureor_void
     - avoid_implementing_value_types
     - avoid_init_to_null
     - avoid_js_rounded_ints
@@ -32,8 +33,6 @@ linter:
     - avoid_relative_lib_imports
     - avoid_renaming_method_parameters
     - avoid_return_types_on_setters
-    - avoid_returning_null
-    - avoid_returning_null_for_future
     - avoid_returning_null_for_void
     - avoid_returning_this
     - avoid_setters_without_getters
@@ -61,12 +60,15 @@ linter:
     - constant_identifier_names
     - control_flow_in_finally
     - curly_braces_in_flow_control_structures
+    - dangling_library_doc_comments
     - depend_on_referenced_packages
     - deprecated_consistency
+    - deprecated_member_use_from_same_package
     - diagnostic_describe_all_properties
     - directives_ordering
     - discarded_futures
     - do_not_use_environment
+    - document_ignores
     - empty_catches
     - empty_constructor_bodies
     - empty_statements
@@ -76,32 +78,41 @@ linter:
     - flutter_style_todos
     - hash_and_equals
     - implementation_imports
-    - iterable_contains_unrelated_type
+    - implicit_call_tearoffs
+    - implicit_reopen
+    - invalid_case_patterns
+    - invalid_runtime_check_with_js_interop_types
     - join_return_with_assignment
     - leading_newlines_in_multiline_strings
+    - library_annotations
     - library_names
     - library_prefixes
     - library_private_types_in_public_api
     - lines_longer_than_80_chars
-    - list_remove_unrelated_type
     - literal_only_boolean_expressions
+    - matching_super_parameters
+    - missing_code_block_language_in_doc_comment
     - missing_whitespace_between_adjacent_strings
     - no_adjacent_strings_in_list
     - no_default_cases
     - no_duplicate_case_values
     - no_leading_underscores_for_library_prefixes
     - no_leading_underscores_for_local_identifiers
+    - no_literal_bool_comparisons
     - no_logic_in_create_state
     - no_runtimeType_toString
+    - no_self_assignments
+    - no_wildcard_variable_uses
     - non_constant_identifier_names
     - noop_primitive_operations
     - null_check_on_nullable_type_parameter
     - null_closures
     - omit_local_variable_types
+    - omit_obvious_local_variable_types
+    - omit_obvious_property_types
     - one_member_abstracts
     - only_throw_errors
     - overridden_fields
-    - package_api_docs
     - package_names
     - package_prefixed_library_names
     - parameter_assignments
@@ -117,7 +128,6 @@ linter:
     - prefer_constructors_over_static_methods
     - prefer_contains
     - prefer_double_quotes
-    - prefer_equal_for_default_values
     - prefer_expression_function_bodies
     - prefer_final_fields
     - prefer_final_in_for_each
@@ -148,29 +158,42 @@ linter:
     - provide_deprecation_message
     - public_member_api_docs
     - recursive_getters
+    - remove_deprecations_in_breaking_versions
     - require_trailing_commas
     - secure_pubspec_urls
+    - simplify_variable_pattern
     - sized_box_for_whitespace
     - sized_box_shrink_expand
     - slash_for_doc_comments
     - sort_child_properties_last
     - sort_constructors_first
     - sort_pub_dependencies
     - sort_unnamed_constructors_first
+    - specify_nonobvious_local_variable_types
+    - specify_nonobvious_property_types
+    - strict_top_level_inference
+    - switch_on_type
     - test_types_in_equals
     - throw_in_finally
     - tighten_type_of_initializing_formals
     - type_annotate_public_apis
     - type_init_formals
+    - type_literal_in_constant_pattern
     - unawaited_futures
+    - unintended_html_in_doc_comment
+    - unnecessary_async
     - unnecessary_await_in_return
     - unnecessary_brace_in_string_interps
+    - unnecessary_breaks
     - unnecessary_const
     - unnecessary_constructor_name
     - unnecessary_final
     - unnecessary_getters_setters
+    - unnecessary_ignore
     - unnecessary_lambdas
     - unnecessary_late
+    - unnecessary_library_directive
+    - unnecessary_library_name
     - unnecessary_new
     - unnecessary_null_aware_assignments
     - unnecessary_null_aware_operator_on_extension_on_nullable
@@ -185,9 +208,11 @@ linter:
     - unnecessary_string_interpolations
     - unnecessary_this
     - unnecessary_to_list_in_spreads
+    - unnecessary_unawaited
+    - unnecessary_underscores
     - unreachable_from_main
     - unrelated_type_equality_checks
-    - unsafe_html
+    - unsafe_variance
     - use_build_context_synchronously
     - use_colored_box
     - use_decorated_box
@@ -199,6 +224,7 @@ linter:
     - use_key_in_widget_constructors
     - use_late_for_private_fields_and_variables
     - use_named_constants
+    - use_null_aware_elements
     - use_raw_strings
     - use_rethrow_when_possible
     - use_setters_to_change_properties
@@ -207,5 +233,6 @@ linter:
     - use_super_parameters
     - use_test_throws_matchers
     - use_to_and_as_if_applicable
+    - use_truncating_division
     - valid_regexps
-    - void_checks
+    - void_checks
@@ -10,17 +10,20 @@ analyzer:
     # We explicitly enabled even conflicting rules and are fixing the conflict
     # in this file.
     included_file_warning: ignore
-
-    todo: ignore
   exclude:
     # exclude all the generated files
     - packages/*/lib/**/*.*.dart
 
+formatter:
+  page_width: 120
+  trailing_commas: preserve
+
 linter:
   rules:
     ## Disabled rules because the repository doesn't respect them (yet)
     avoid_setters_without_getters: false
     discarded_futures: false
+    comment_references: false
 
     #############
 
@@ -93,6 +96,19 @@ linter:
     # There are situations where we use default in enums on purpose
     no_default_cases: false
 
+    # Sometimes static methods are more readable
+    prefer_constructors_over_static_methods: false
+
+    # Conflicts with `omit_local_variable_types`
+    specify_nonobvious_local_variable_types: false
+    specify_nonobvious_property_types: false
+
+    # Makes the code more verbose without adding much value
+    document_ignores: false
+
+    # False positives
+    unsafe_variance: false
+
     # Temporarily disabled to find more important issues
     public_member_api_docs: false
     avoid_print: false