jshep23 · Apr 21, 2026 · Apr 19, 2026 · Apr 19, 2026 · Apr 19, 2026 · Apr 19, 2026
diff --git a/README.md b/README.md
diff --git a/example/.metadata b/example/.metadata
@@ -1,38 +1,23 @@
 # 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.
+# This file should be version controlled and should not be manually edited.
 
 version:
-  revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-  channel: stable
+  revision: "cc0734ac716fbb8b90f3f9db8020958b1553afa7"
+  channel: "stable"
 
 project_type: app
 
 # Tracks metadata for the flutter migrate command
 migration:
   platforms:
     - platform: root
-      create_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-      base_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-    - platform: android
-      create_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-      base_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-    - platform: ios
-      create_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-      base_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-    - platform: linux
-      create_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-      base_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-    - platform: macos
-      create_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-      base_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
+      create_revision: cc0734ac716fbb8b90f3f9db8020958b1553afa7
+      base_revision: cc0734ac716fbb8b90f3f9db8020958b1553afa7
     - platform: web
-      create_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-      base_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-    - platform: windows
-      create_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
-      base_revision: fb57da5f945d02ef4f98dfd9409a72b7cce74268
+      create_revision: cc0734ac716fbb8b90f3f9db8020958b1553afa7
+      base_revision: cc0734ac716fbb8b90f3f9db8020958b1553afa7
 
   # User provided section
 

diff --git a/example/README.md b/example/README.md
@@ -1,7 +1,35 @@
-# Current Counter Example
+# Current Mission Control Example
 
-This is a version of the classic Flutter Counter App example, implemented using Current.
+This example is a multi-page mission-control showcase for Current. Instead of a simple counter app, it demonstrates how Current handles typed properties, shared app state, issue-based validation, text input binding, collection mutation, custom events, and instructional code snippets inside one responsive Flutter application.
+
+## What The App Demonstrates
+
+- Mission Overview: a guided summary of the main Current capabilities surfaced by the app.
+- Telemetry Lab: typed `CurrentProperty` values, dirty tracking, reset behavior, and batched updates.
+- Flight Forms: `CurrentTextController`, `CurrentFieldValidation`, `CurrentValidationGroup`, and issue-based validation rules.
+- Star Map Collections: reactive `CurrentListProperty` and `CurrentMapProperty` workflows.
+- Launch Events: custom `CurrentStateChanged` events, busy state listeners, and `doAsync` task handling.
+- Code Examples: smaller reference snippets that mirror the live demos.
 
 ## Running The Example
 
-Simply run `flutter pub get` then `flutter run` from the example folder. This example will work on all platforms.
+From the `example` folder:
+
+```bash
+flutter pub get
+flutter run
+```
+
+The example is configured for Android, iOS, macOS, Linux, Windows, and web. You can target a specific device the same way you would with any Flutter app, for example `flutter run -d macos` or `flutter run -d chrome`.
+
+## Where To Start
+
+- Open Flight Forms if you want to see the current validation and text-controller APIs in action.
+- Open Telemetry Lab if you want a compact tour of the primitive property types and reset semantics.
+- Open Launch Events if you want to inspect busy-state handling and custom event listeners.
+- Open Code Examples if you want short snippets before reading the package README.
+
+## Related Documentation
+
+- Package overview and API usage: [../README.md](../README.md)
+- API reference: https://pub.dev/documentation/current/latest/
diff --git a/example/assets/images/CurrentLogoFull.png b/example/assets/images/CurrentLogoFull.png
diff --git a/example/assets/images/CurrentLogoMD.png b/example/assets/images/CurrentLogoMD.png
diff --git a/example/assets/images/ThirdVersionLogo.png b/example/assets/images/ThirdVersionLogo.png
diff --git a/example/ios/Flutter/Debug.xcconfig b/example/ios/Flutter/Debug.xcconfig
@@ -1 +1,2 @@
+#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.debug.xcconfig"
 #include "Generated.xcconfig"
diff --git a/example/ios/Flutter/Release.xcconfig b/example/ios/Flutter/Release.xcconfig
@@ -1 +1,2 @@
+#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.release.xcconfig"
 #include "Generated.xcconfig"
diff --git a/example/ios/Podfile b/example/ios/Podfile
@@ -0,0 +1,43 @@
+# Uncomment this line to define a global platform for your project
+# platform :ios, '13.0'
+
+# CocoaPods analytics sends network stats synchronously affecting flutter build latency.
+ENV['COCOAPODS_DISABLE_STATS'] = 'true'
+
+project 'Runner', {
+  'Debug' => :debug,
+  'Profile' => :release,
+  'Release' => :release,
+}
+
+def flutter_root
+  generated_xcode_build_settings_path = File.expand_path(File.join('..', 'Flutter', 'Generated.xcconfig'), __FILE__)
+  unless File.exist?(generated_xcode_build_settings_path)
+    raise "#{generated_xcode_build_settings_path} must exist. If you're running pod install manually, make sure flutter pub get is executed first"
+  end
+
+  File.foreach(generated_xcode_build_settings_path) do |line|
+    matches = line.match(/FLUTTER_ROOT\=(.*)/)
+    return matches[1].strip if matches
+  end
+  raise "FLUTTER_ROOT not found in #{generated_xcode_build_settings_path}. Try deleting Generated.xcconfig, then run flutter pub get"
+end
+
+require File.expand_path(File.join('packages', 'flutter_tools', 'bin', 'podhelper'), flutter_root)
+
+flutter_ios_podfile_setup
+
+target 'Runner' do
+  use_frameworks!
+
+  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
+  target 'RunnerTests' do
+    inherit! :search_paths
+  end
+end
+
+post_install do |installer|
+  installer.pods_project.targets.each do |target|
+    flutter_additional_ios_build_settings(target)
+  end
+end
diff --git a/example/lib/answer_to_life_found_event.dart b/example/lib/answer_to_life_found_event.dart
diff --git a/example/lib/application_view_model.dart b/example/lib/application_view_model.dart
@@ -1,26 +1,51 @@
 import 'package:current/current.dart';
-import 'package:flutter/material.dart';
-import 'dart:math' as math;
+import 'package:current_counter_example/components/mission_section.dart';
 
 class ApplicationViewModel extends CurrentViewModel {
-  final backgroundColor = CurrentProperty(Colors.white);
+  final selectedSectionIndex = CurrentProperty.integer(
+    initialValue: 0,
+    propertyName: 'selectedSection',
+  );
 
-  final CurrentStringProperty title;
+  final starfieldEnabled = CurrentProperty.boolean(
+    initialValue: true,
+    propertyName: 'starfieldEnabled',
+  );
 
-  ApplicationViewModel(this.title);
+  final missionStatus = CurrentProperty.string(
+    initialValue: 'All systems nominal. Current is tracking every signal.',
+    propertyName: 'missionStatus',
+  );
 
   @override
-  Iterable<CurrentProperty> get currentProps => [backgroundColor, title];
+  Iterable<CurrentProperty> get currentProps => [
+        selectedSectionIndex,
+        starfieldEnabled,
+        missionStatus,
+      ];
 
-  void changeBackgroundColor(Color color) => backgroundColor(color);
+  MissionSection get selectedSection =>
+      MissionSection.values[selectedSectionIndex.value];
 
-  void randomizeBackgroundColor() {
-    final color = Color((math.Random().nextDouble() * 0xFFFFFF).toInt())
-        .withValues(alpha: 1);
-    backgroundColor(color);
+  void selectSection(MissionSection section) {
+    selectedSectionIndex.value = section.index;
+    missionStatus.value = switch (section) {
+      MissionSection.overview =>
+        'Mission control online. Review every Current capability at a glance.',
+      MissionSection.telemetry =>
+        'Telemetry is streaming through typed CurrentProperty values.',
+      MissionSection.flightForms =>
+        'Launch approval is running through CurrentTextController and validation.',
+      MissionSection.starMap =>
+        'Orbital inventory is reacting through list and map properties.',
+      MissionSection.launchEvents =>
+        'Mission event handlers are listening for milestones, busy states, and anomalies.',
+      MissionSection.codeExamples =>
+        'Reference snippets are online to show how Current features fit together in code.',
+    };
   }
 
-  void reset() {
-    backgroundColor.reset();
+  void toggleStarfield() {
+    starfieldEnabled.value = !starfieldEnabled.value;
   }
 }
Original file line number	Diff line number	Diff line change
		@@ -1 +1,2 @@
		#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.debug.xcconfig"
		#include "Generated.xcconfig"