feat: add Clear Skies sample app for Shorebird FlutterCon live demo

.github/workflows/shorebird_ci.yaml

@@ -19,6 +19,7 @@ jobs:
       my_flutter_module: ${{ steps.filter.outputs.my_flutter_module }}
       progressive_rollout_demo: ${{ steps.filter.outputs.progressive_rollout_demo }}
       shorebird_fintech_wallet: ${{ steps.filter.outputs.shorebird_fintech_wallet }}
+      clear_skies: ${{ steps.filter.outputs.clear_skies }}
     steps:
       - uses: actions/checkout@v7
         with:
@@ -42,6 +43,8 @@ jobs:
               - progressive_rollout_demo/**
             shorebird_fintech_wallet:
               - shorebird_fintech_wallet/**
+            clear_skies:
+              - clear_skies/**
 
   flavors:
     needs: changes
@@ -108,6 +111,19 @@ jobs:
       flutter_version: ""
       has_integration_tests: false
 
+  clear_skies:
+    needs: changes
+    if: needs.changes.outputs.clear_skies == 'true'
+    uses: ./.github/workflows/_shorebird_ci_flutter.yaml
+    with:
+      package_name: clear_skies
+      package_path: clear_skies
+      has_bloc_lint: false
+      has_unit_tests: true
+      subpackages: ""
+      flutter_version: ""
+      has_integration_tests: false
+
   required:
     name: required
     if: ${{ always() }}
@@ -118,6 +134,7 @@ jobs:
       - my_flutter_module
       - progressive_rollout_demo
       - shorebird_fintech_wallet
+      - clear_skies
     runs-on: ubuntu-latest
     steps:
       - name: Check required jobs

.vscode/launch.json

@@ -0,0 +1,148 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "clear_skies",
+            "cwd": "clear_skies",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "clear_skies (profile mode)",
+            "cwd": "clear_skies",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "clear_skies (release mode)",
+            "cwd": "clear_skies",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "firebase_test",
+            "cwd": "firebase_test",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "firebase_test (profile mode)",
+            "cwd": "firebase_test",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "firebase_test (release mode)",
+            "cwd": "firebase_test",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "flavors",
+            "cwd": "flavors",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "flavors (profile mode)",
+            "cwd": "flavors",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "flavors (release mode)",
+            "cwd": "flavors",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "multi_dimensional_flavors",
+            "cwd": "multi_dimensional_flavors",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "multi_dimensional_flavors (profile mode)",
+            "cwd": "multi_dimensional_flavors",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "multi_dimensional_flavors (release mode)",
+            "cwd": "multi_dimensional_flavors",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "progressive_rollout_demo",
+            "cwd": "progressive_rollout_demo",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "progressive_rollout_demo (profile mode)",
+            "cwd": "progressive_rollout_demo",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "progressive_rollout_demo (release mode)",
+            "cwd": "progressive_rollout_demo",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "shorebird_fintech_wallet",
+            "cwd": "shorebird_fintech_wallet",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "shorebird_fintech_wallet (profile mode)",
+            "cwd": "shorebird_fintech_wallet",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "shorebird_fintech_wallet (release mode)",
+            "cwd": "shorebird_fintech_wallet",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        },
+        {
+            "name": "my_flutter_module",
+            "cwd": "add_to_app/my_flutter_module",
+            "request": "launch",
+            "type": "dart"
+        },
+        {
+            "name": "my_flutter_module (profile mode)",
+            "cwd": "add_to_app/my_flutter_module",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "profile"
+        },
+        {
+            "name": "my_flutter_module (release mode)",
+            "cwd": "add_to_app/my_flutter_module",
+            "request": "launch",
+            "type": "dart",
+            "flutterMode": "release"
+        }
+    ]
+}

README.md

@@ -15,6 +15,7 @@ Below is a list of the available samples. Each directory contains a specific use
 | [**Add-to-App**](./add_to_app) | Shows how to seamlessly patch a Shorebird Flutter module embedded inside a native Android or iOS application. |
 | [**Progressive Rollout Demo**](./progressive_rollout_demo) | Illustrates how to mitigate risk by performing percentage-based patch rollouts using Shorebird tracks. |
 | [**Shorebird Fintech Wallet**](./shorebird_fintech_wallet) | An enterprise-grade example of a logic-level hotfix using a decoupled Reactive Store + BLoC architecture. |
+| [**Clear Skies**](./clear_skies) | A beautifully designed, premium weather application with dynamic glassmorphic UI. |
 
 ## 🛠 Getting Started
 

clear_skies/.gitignore

@@ -0,0 +1,45 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.build/
+.buildlog/
+.history
+.svn/
+.swiftpm/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins-dependencies
+.pub-cache/
+.pub/
+/build/
+/coverage/
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release

clear_skies/.metadata

@@ -0,0 +1,45 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "9f9f19aaac8f092532e59f3447c501b4d4089efb"
+  channel: "[user-branch]"
+
+project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+      base_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+    - platform: android
+      create_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+      base_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+    - platform: ios
+      create_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+      base_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+    - platform: linux
+      create_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+      base_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+    - platform: macos
+      create_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+      base_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+    - platform: web
+      create_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+      base_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+    - platform: windows
+      create_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+      base_revision: 9f9f19aaac8f092532e59f3447c501b4d4089efb
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

clear_skies/FLUTTERCON_DEMO.md

@@ -0,0 +1,86 @@
+# 🦅 Shorebird FlutterCon USA Live Demo Guide
+
+This guide provides step-by-step instructions for the team on stage to execute the **Clear Skies** live OTA update demo using Shorebird.
+
+---
+
+## 🛠️ Step 1: Pre-requisites & Setup (Before the Demo)
+
+1. **Clone the Repository**
+   Ensure you have the latest code pulled on your presentation machine:
+   ```bash
+   git clone https://github.com/shorebirdtech/samples.git
+   cd samples/clear_skies
+   flutter pub get
+   ```
+
+2. **Install the Buggy Release APK**
+   We have already pre-built the Shorebird release containing the intentional bugs and pushed it to the repository. The APK is located specifically at `samples/clear_skies/output/app-release.apk`. 
+
+   You can either drag and drop this file into your emulator, or install it via terminal:
+   ```bash
+   # Make sure your device/emulator is connected
+   adb install output/app-release.apk
+   ```
+
+---
+
+## 🎤 Step 2: The Presentation (On Stage)
+
+### 1. Show the "Broken" Production App
+1. Open the **Unclear Skies** app on the projector.
+2. Point out the hilarious bugs we accidentally shipped to production:
+   - The app title says **"Unclear Skies - Discover the world's worst weather"**.
+   - The background is a glaring, toxic Neon Green and Bright Red gradient.
+   - Tap the **"Tokyo"** popular destination chip, and show how it incorrectly fetches the weather for **Antarctica**.
+3. **The Hook:** *"Normally, fixing this means a 2-day wait for App Store / Play Store review. Let's fix this right now with Shorebird."*
+
+### 2. Fix the Code Live
+Open your IDE (VS Code / Android Studio) and use **Global Search** for the keyword:
+👉 `TODO(Demo)`
+
+This will instantly take you to the three bugs. Revert them back to their correct state:
+
+- **Bug 1: `lib/core/constants/app_strings.dart`**
+  ```diff
+  - static const String appName = 'Unclear Skies';
+  + static const String appName = 'Clear Skies';
+
+  - static const String welcomeTitle = 'Welcome to Unclear Skies';
+  - static const String welcomeSubtitle = 'Discover the world\'s worst weather';
+  + static const String welcomeTitle = 'Welcome to Clear Skies';
+  + static const String welcomeSubtitle = 'Discover the world\'s weather';
+  ```
+
+- **Bug 2: `lib/core/constants/app_colors.dart`**
+  ```diff
+  - Color(0xFF39FF14), // Neon Green
+  - Color(0xFFF0FF00), // Toxic Yellow
+  - Color(0xFFFF0000), // Bright Red
+  + Color(0xFF4CA1AF), // Vibrant Sky Blue
+  + Color(0xFF90C8D1), // Mid Cyan
+  + Color(0xFFC4E0E5), // Soft Horizon Cyan
+  ```
+
+- **Bug 3: `lib/features/weather/ui/widgets/welcome_hero_widget.dart`**
+  ```diff
+  - widget.onCityTapped!('Antarctica');
+  + widget.onCityTapped!(city);
+  ```
+
+### 3. Push the Patch via Shorebird
+In your terminal, run the patch command to send the fix over the air:
+
+```bash
+shorebird patch android
+```
+*(Wait a few seconds for the patch to build and upload).*
+
+### 4. The Magic Moment 🪄
+1. Once the patch is published, go back to the demo device.
+2. Force-close the app (swipe it away from recents) and open it again.
+3. **Boom!** The toxic green is gone, the title is "Clear Skies", and Tokyo brings up Tokyo's weather. No app store update required!
+
+> [!TIP]
+> **Need to run the demo multiple times?** 
+> If you need to practice or do the demo again for a different audience, you can easily downgrade the app on the device by uninstalling it and re-running the `adb install` command with the original buggy APK (Step 1.2), then reverting your local code changes back to the buggy state.