feat(ui): button component

.gitattributes

@@ -0,0 +1 @@
+**/goldens/ci/*.png filter=lfs diff=lfs merge=lfs -text

.github/workflows/stream_core_flutter_workflow.yml

@@ -23,11 +23,14 @@ 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
+          lfs: 'true'
 
       - name: Install Flutter
         uses: subosito/flutter-action@v2

.github/workflows/update_goldens.yml

@@ -0,0 +1,39 @@
+name: update_goldens
+
+on: workflow_dispatch
+
+jobs:
+  update_goldens:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 📚 Checkout branch
+        uses: actions/checkout@v6
+        with:
+          ssh-key: ${{ secrets.BOT_SSH_PRIVATE_KEY }}
+          lfs: 'true'
+
+      - 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
+        run: flutter pub global activate melos
+
+      - name: 🔧 Bootstrap Workspace
+        run: melos bootstrap --verbose
+
+      - name: 🖼️ Update Goldens
+        continue-on-error: true
+        run: melos run update:goldens
+
+      - name: 📤 Commit Changes
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          commit_message: "chore: Update Goldens"
+          file_pattern: "**/test/**/goldens/*.png"
+          commit_user_name: "Stream SDK Bot"
+          commit_user_email: "60655709+Stream-SDK-Bot@users.noreply.github.com"

apps/design_system_gallery/lib/app/gallery_app.directories.g.dart

@@ -10,6 +10,8 @@
 // **************************************************************************
 
 // ignore_for_file: no_leading_underscores_for_library_prefixes
+import 'package:design_system_gallery/components/button.dart'
+    as _design_system_gallery_components_button;
 import 'package:design_system_gallery/components/stream_avatar.dart'
     as _design_system_gallery_components_stream_avatar;
 import 'package:design_system_gallery/components/stream_avatar_stack.dart'
@@ -31,6 +33,7 @@ import 'package:widgetbook/widgetbook.dart' as _widgetbook;
 final directories = <_widgetbook.WidgetbookNode>[
   _widgetbook.WidgetbookCategory(
     name: 'App Foundation',
+    isInitiallyExpanded: false,
     children: [
       _widgetbook.WidgetbookFolder(
         name: 'Primitives',
@@ -124,6 +127,7 @@ final directories = <_widgetbook.WidgetbookNode>[
     children: [
       _widgetbook.WidgetbookFolder(
         name: 'Avatar',
+        isInitiallyExpanded: false,
         children: [
           _widgetbook.WidgetbookComponent(
             name: 'StreamAvatar',
@@ -157,8 +161,45 @@ final directories = <_widgetbook.WidgetbookNode>[
           ),
         ],
       ),
+      _widgetbook.WidgetbookFolder(
+        name: 'Button',
+        isInitiallyExpanded: false,
+        children: [
+          _widgetbook.WidgetbookComponent(
+            name: 'StreamButton',
+            useCases: [
+              _widgetbook.WidgetbookUseCase(
+                name: 'Playground',
+                builder: _design_system_gallery_components_button
+                    .buildStreamButtonPlayground,
+              ),
+              _widgetbook.WidgetbookUseCase(
+                name: 'Real-world Example',
+                builder: _design_system_gallery_components_button
+                    .buildStreamButtonExample,
+              ),
+              _widgetbook.WidgetbookUseCase(
+                name: 'Size Variants',
+                builder: _design_system_gallery_components_button
+                    .buildStreamButtonSizes,
+              ),
+              _widgetbook.WidgetbookUseCase(
+                name: 'Type Variants',
+                builder: _design_system_gallery_components_button
+                    .buildStreamButtonTypes,
+              ),
+              _widgetbook.WidgetbookUseCase(
+                name: 'With Icons',
+                builder: _design_system_gallery_components_button
+                    .buildStreamButtonWithIcons,
+              ),
+            ],
+          ),
+        ],
+      ),
       _widgetbook.WidgetbookFolder(
         name: 'Indicator',
+        isInitiallyExpanded: false,
         children: [
           _widgetbook.WidgetbookComponent(
             name: 'StreamOnlineIndicator',