Restructure command_it getting_started documentation

- Move installation section to beginning
- Update all examples to use watch_it (recommended approach)
- Add info box explaining ValueListenableBuilder alternative
- Create dedicated "Without watch_it" documentation page
- Fix command properties descriptions (value, isRunning, errors types)
- Update error handling example to use listen_it operators
- Fix SVG flow diagram (Execute -> Run, isExecuting -> isRunning)
- Create Weather App Tutorial for real-world example
- Update Next Steps to link to tutorial instead of integration docs
- Inline GetIt.instance calls when used once
- Use registerSingleton instead of registerLazySingleton
- Add explanatory comments for different command calling patterns
- Format all command_it code samples
- Add AI warning banner to tutorial

Author: escamoteur

code_samples/lib/command_it/counter_simple_sync.dart

@@ -0,0 +1,55 @@
+import 'package:command_it/command_it.dart';
+import 'package:flutter/material.dart';
+
+// #region example
+class CounterModel {
+  int _count = 0;
+
+  // Command wraps a function and acts as a ValueListenable
+  late final incrementCommand = Command.createSyncNoParam<String>(
+    () {
+      _count++;
+      return _count.toString();
+    },
+    initialValue: '0',
+  );
+}
+
+class CounterWidget extends StatelessWidget {
+  CounterWidget({super.key});
+
+  final model = CounterModel();
+
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      mainAxisAlignment: MainAxisAlignment.center,
+      children: [
+        Text('You have pushed the button this many times:'),
+        // Command is a ValueListenable - use ValueListenableBuilder
+        ValueListenableBuilder<String>(
+          valueListenable: model.incrementCommand,
+          builder: (context, value, _) => Text(
+            value,
+            style: Theme.of(context).textTheme.headlineMedium,
+          ),
+        ),
+        SizedBox(height: 16),
+        // Command has a .run method - use it as tearoff for onPressed
+        ElevatedButton(
+          onPressed: model.incrementCommand.run,
+          child: Text('Increment'),
+        ),
+      ],
+    );
+  }
+}
+// #endregion example
+
+void main() {
+  runApp(MaterialApp(
+    home: Scaffold(
+      body: Center(child: CounterWidget()),
+    ),
+  ));
+}

code_samples/lib/command_it/counter_watch_it.dart

@@ -0,0 +1,61 @@
+import 'package:command_it/command_it.dart';
+import 'package:flutter/material.dart';
+import 'package:get_it/get_it.dart';
+import 'package:watch_it/watch_it.dart';
+
+// #region example
+class CounterService {
+  int _count = 0;
+
+  // Command wraps a function and acts as a ValueListenable
+  late final incrementCommand = Command.createSyncNoParam<String>(
+    () {
+      _count++;
+      return _count.toString();
+    },
+    initialValue: '0',
+  );
+}
+
+// Register with get_it (call this in main())
+void setup() {
+  GetIt.instance.registerSingleton(CounterService());
+}
+
+// Use watch_it to observe the command
+class CounterWidget extends WatchingWidget {
+  const CounterWidget({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    // Watch the command value - rebuilds when it changes
+    final count = watchValue((CounterService s) => s.incrementCommand);
+
+    return Column(
+      mainAxisAlignment: MainAxisAlignment.center,
+      children: [
+        Text('You have pushed the button this many times:'),
+        Text(
+          count,
+          style: Theme.of(context).textTheme.headlineMedium,
+        ),
+        SizedBox(height: 16),
+        // No parameters - use .run as tearoff
+        ElevatedButton(
+          onPressed: GetIt.instance<CounterService>().incrementCommand.run,
+          child: Text('Increment'),
+        ),
+      ],
+    );
+  }
+}
+// #endregion example
+
+void main() {
+  setup();
+  runApp(MaterialApp(
+    home: Scaffold(
+      body: Center(child: CounterWidget()),
+    ),
+  ));
+}

code_samples/lib/command_it/watch_it_simple.dart

@@ -0,0 +1,59 @@
+import 'package:command_it/command_it.dart';
+import 'package:flutter/material.dart';
+import 'package:get_it/get_it.dart';
+import 'package:watch_it/watch_it.dart';
+import '_shared/stubs.dart';
+
+// #region example
+class WeatherService {
+  late final loadWeatherCommand = Command.createAsync<String, String>(
+    (city) async {
+      await simulateDelay(1000);
+      return 'Weather in $city: Sunny, 72°F';
+    },
+    initialValue: 'No data loaded',
+  );
+}
+
+// Register service with get_it (call this in main())
+void setup() {
+  GetIt.instance.registerSingleton(WeatherService());
+}
+
+// Use watch_it to observe commands without ValueListenableBuilder
+class WeatherWidget extends WatchingWidget {
+  const WeatherWidget({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    // Watch the command value directly
+    final weather = watchValue((WeatherService s) => s.loadWeatherCommand);
+
+    // Watch the loading state
+    final isLoading =
+        watchValue((WeatherService s) => s.loadWeatherCommand.isRunning);
+
+    return Column(
+      mainAxisAlignment: MainAxisAlignment.center,
+      children: [
+        if (isLoading)
+          CircularProgressIndicator()
+        else
+          Text(weather, style: TextStyle(fontSize: 18)),
+        SizedBox(height: 16),
+        // With parameters - call command directly (it's callable)
+        ElevatedButton(
+          onPressed: () =>
+              GetIt.instance<WeatherService>().loadWeatherCommand('London'),
+          child: Text('Load Weather'),
+        ),
+      ],
+    );
+  }
+}
+// #endregion example
+
+void main() {
+  setup();
+  runApp(MaterialApp(home: Scaffold(body: Center(child: WeatherWidget()))));
+}

docs/.vitepress/config.mts

@@ -97,6 +97,7 @@ export default defineConfig({
               { text: 'Restrictions', link: '/documentation/command_it/restrictions.md' },
               { text: 'Testing', link: '/documentation/command_it/testing.md' },
               { text: 'watch_it Integration', link: '/documentation/command_it/watch_it_integration.md' },
+              { text: 'Without watch_it', link: '/documentation/command_it/without_watch_it.md' },
               { text: 'Best Practices', link: '/documentation/command_it/best_practices.md' }
             ]
           },