City Services Flutter Libraries

https://github.com/yandex/city-services-pub
Admin
A collection of reusable Flutter libraries developed by Yandex City Services for building mobile...
Tokens:79,942
Snippets:907
Trust Score:8.5
Update:1 month ago
Show doc for...
Tokens:
Raw
### Change to example directory

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/navigation_config_provider/README.md

Navigate to the example directory before launching the application.

```bash
cd example/
```

--------------------------------

### Minimal Flutter-first setup

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/README.md

A complete example showing how to define routes, create a RouterSchema, and integrate it with MaterialApp.router.

```dart
import 'dart:async';

import 'package:flutter/material.dart';
import 'package:yx_navigation/yx_navigation.dart';
import 'package:yx_navigation_flutter/yx_navigation_flutter.dart';

void main() {
  runApp(const DemoApp());
}

abstract final class Routes {
  static const home = YxRoute(id: 'home');
  static const detail = YxRoute(id: 'detail');
}

final class DemoSchema extends RouterSchema {
  DemoSchema()
      : super(
          initialNodeBuilder: (root) => root
            ..setChildren([
              Routes.home.toNode(),
            ]),
        );

  @override
  List<RouteDeclaration> get declarations => [
        RouteDeclaration.routeBuilder(
          route: Routes.home,
          routeBuilder: RouteBuilder.widget(
            builder: (context, state) => Scaffold(
              appBar: AppBar(title: const Text('Demo')),
              body: Center(
                child: IconButton(
                  icon: const Icon(Icons.navigate_next),
                  onPressed: () {
                    YxNavigation.navigatorOf(context).push(Routes.detail);
                  },
                ),
              ),
            ),
          ),
        ),
        RouteDeclaration.routeBuilder(
          route: Routes.detail,
          routeBuilder: RouteBuilder.widget(
            builder: (context, state) => Scaffold(
              appBar: AppBar(title: const Text('Detail')),
              body: const Center(child: Text('Detail')),
            ),
          ),
        ),
      ];
}

class DemoApp extends StatefulWidget {
  const DemoApp({super.key});

  @override
  State<DemoApp> createState() => _DemoAppState();
}

class _DemoAppState extends State<DemoApp> {
  late final YxRouterConfig _routerConfig;

  @override
  void initState() {
    super.initState();
    _routerConfig = DemoSchema().build();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp.router(
      routerConfig: _routerConfig,
    );
  }

  @override
  void dispose() {
    unawaited(_routerConfig.dispose());
    super.dispose();
  }
}
```

--------------------------------

### Run app from example root

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/01 - profile - flutter-first-scenario/README.md

Command to run the application from the example project root.

```bash
cd example
fvm flutter run -t "lib/src/quick_start/01 - profile - flutter-first-scenario/main.dart"
```

--------------------------------

### Full Implementation Example

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/README.md

A complete example showing how to set up the virtual device tools and implement a device picker in a Flutter app.

```dart
import 'package:flutter/material.dart';
import 'package:yx_virtual_device/yx_virtual_device.dart';

void main() {
  // Called before [runApp] to replace bindings.
  // It is good not to use it in the production.
  if (kProfileMode || kDebugMode) {
      VirtualDeviceDevtools.setup();
  }
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  DeviceInfo? _currentDevice;

  void _setDevice(DeviceInfo? device) {
    setState(() {
      _currentDevice = device;
      VirtualDeviceDevtools.setDevice(device);
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text(_currentDevice?.name ?? 'Real Device'),
        ),
        body: LayoutBuilder(
          builder: (context, constraints) {
            final mq = MediaQuery.of(context);
            return Center(
              child: Column(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  Text('Screen: ${mq.size.width.toInt()}×${mq.size.height.toInt()}'),
                  Text('Pixel Ratio: ${mq.devicePixelRatio}x'),
                  Text('Constraints: ${constraints.maxWidth.toInt()}×${constraints.maxHeight.toInt()}'),
                ],
              ),
            );
          },
        ),
        floatingActionButton: FloatingActionButton(
          onPressed: () => _showDevicePicker(context),
          child: const Icon(Icons.devices),
        ),
      ),
    );
  }

  void _showDevicePicker(BuildContext context) {
    showModalBottomSheet(
      context: context,
      builder: (context) {
        final devices = <DeviceInfo?>[
          null,
          ...Devices.standard.all,
          ...Devices.ios.all.take(5),
          ...Devices.android.all.take(5),
        ];

        return ListView.builder(
          itemCount: devices.length,
          itemBuilder: (context, index) {
            final device = devices[index];
            return ListTile(
              leading: Icon(device == null ? Icons.phone_android : Icons.devices),
              title: Text(device?.name ?? 'Real Device'),
              subtitle: device != null
                  ? Text('${device.screenSize.width.toInt()}×${device.screenSize.height.toInt()} @${device.pixelRatio}x')
                  : null,
              selected: device?.name == _currentDevice?.name,
              onTap: () {
                _setDevice(device);
                Navigator.pop(context);
              },
            );
          },
        );
      },
    );
  }
}
```

--------------------------------

### Installation Rules for Windows Bundle

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/windows/CMakeLists.txt

Configures the installation directory and rules for the executable, Flutter data, libraries, and native assets.

```cmake
# === Installation ===
# Support files are copied into place next to the executable, so that it can
# run in place. This is done instead of making a separate bundle (as on Linux)
# so that building and running from within Visual Studio will work.
set(BUILD_BUNDLE_DIR "$<TARGET_FILE_DIR:${BINARY_NAME}>")
# Make the "install" step default, as it's required to run.
set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1)
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()

set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

if(PLUGIN_BUNDLED_LIBRARIES)
  install(FILES "${PLUGIN_BUNDLED_LIBRARIES}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()

# Copy the native assets provided by the build.dart from all packages.
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)

# Fully re-copy the assets directory on each build to avoid having stale files
# from a previous install.
set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)

# Install the AOT library on non-Debug builds only.
install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  CONFIGURATIONS Profile;Release
  COMPONENT Runtime)
```

--------------------------------

### Define Installation Targets and Files

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/linux/CMakeLists.txt

Defines the installation paths for the binary, ICU data, Flutter library, and bundled plugin libraries.

```cmake
set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data")
set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib")

install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}"
  COMPONENT Runtime)

install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
  COMPONENT Runtime)

foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES})
  install(FILES "${bundled_library}"
    DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endforeach(bundled_library)
```

--------------------------------

### Install Native Assets

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/linux/CMakeLists.txt

Copies native assets generated by build.dart to the installation directory.

```cmake
set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/linux/")
install(DIRECTORY "${NATIVE_ASSETS_DIR}"
   DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
   COMPONENT Runtime)
```

--------------------------------

### Configure Installation Bundle Directory

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/linux/CMakeLists.txt

Sets the default installation prefix to a bundle directory within the build folder.

```cmake
set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle")
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
  set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE)
endif()
```

--------------------------------

### Project layout

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/01 - profile - flutter-first-scenario/README.md

The directory structure for the driver-profile quick start scenario.

```text
01 - profile - flutter-first-scenario/
  main.dart                       # App entry point
  profile_navigation_schema.dart # Navigation schema and routes
  profile_skeleton_page.dart     # Base page with skeleton UI
  README.md                      # This file
```

--------------------------------

### Run compatibility demo via command line

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/compatibility_demo/README.md

Execute the compatibility demo using the Flutter CLI from the example directory.

```bash
cd example
flutter run -t lib/src/compatibility_demo/main.dart
```

--------------------------------

### consider_dep_suffix rule examples

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/packages/yx_scope_linter/README.md

Examples of good and bad naming conventions for dependencies in the Scope Container.

```dart

late final myDep = dep(() => MyDep());
```

```dart

late final justMyString = dep(() => SomeDep());
```

--------------------------------

### Clean Build Bundle Directory

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/linux/CMakeLists.txt

Ensures the installation bundle directory is cleared before each installation process.

```cmake
install(CODE "
  file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\")
  " COMPONENT Runtime)
```

--------------------------------

### Linter Setup and Configuration

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/docs/complete_guide.md

Configuration for the yx_scope linter in pubspec.yaml and analysis_options.yaml.

```yaml
dev_dependencies:
  yx_scope_linter: ^1.0.0
  custom_lint: ^0.5.3
```

```yaml
analyzer:
  plugins:
    - custom_lint

custom_lint:
  rules:
    - consider_dep_suffix     # Check for Dep suffix
    - final_dep               # Check for late final on dependencies
    - dep_cycle               # Detect cyclic dependencies
```

--------------------------------

### Project file layout for NavigationConfigProvider

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/navigation_config_provider/README.md

The directory structure for the navigation_config_provider example, showing the separation between host and profile feature files.

```text
navigation_config_provider/
  main.dart                           # Main app entry point
  host_app_schema.dart                # Host app schema
  host_routes.dart                    # Host routes
  host_pages.dart                     # Host pages + mode switcher
  demo_configurations.dart            # Configurations for each mode
  custom_implementations.dart         # Custom implementations
  profile_feature/                    # Nested profile schema
    profile_schema.dart               # Profile schema
    profile_routes.dart               # Profile routes
    profile_pages.dart                # Profile pages
  README.md                           # This document
```

--------------------------------

### System Dependencies and Flutter Library Setup

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/linux/flutter/CMakeLists.txt

Finds required GTK, GLIB, and GIO packages and defines the Flutter library and header paths for the build process.

```cmake
# === Flutter Library ===
# System-level dependencies.
find_package(PkgConfig REQUIRED)
pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0)
pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0)
pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0)

set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/libflutter_linux_gtk.so")

# Published to parent scope for install step.
set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE)
set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE)
set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE)
set(AOT_LIBRARY "${PROJECT_DIR}/build/lib/libapp.so" PARENT_SCOPE)

list(APPEND FLUTTER_LIBRARY_HEADERS
  "fl_basic_message_channel.h"
  "fl_binary_codec.h"
  "fl_binary_messenger.h"
  "fl_dart_project.h"
  "fl_engine.h"
  "fl_json_message_codec.h"
  "fl_json_method_codec.h"
  "fl_message_codec.h"
  "fl_method_call.h"
  "fl_method_channel.h"
  "fl_method_codec.h"
  "fl_method_response.h"
  "fl_plugin_registrar.h"
  "fl_plugin_registry.h"
  "fl_standard_message_codec.h"
  "fl_standard_method_codec.h"
  "fl_string_codec.h"
  "fl_value.h"
  "fl_view.h"
  "flutter_linux.h"
)
list_prepend(FLUTTER_LIBRARY_HEADERS "${EPHEMERAL_DIR}/flutter_linux/")
add_library(flutter INTERFACE)
target_include_directories(flutter INTERFACE
  "${EPHEMERAL_DIR}"
)
target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}")
target_link_libraries(flutter INTERFACE
  PkgConfig::GTK
  PkgConfig::GLIB
  PkgConfig::GIO
)
add_dependencies(flutter flutter_assemble)
```

--------------------------------

### Use Cupertino PagesFactory

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/route_declarations.md

Example of using the Cupertino page factory for iOS-style transitions.

```dart
RouteBuilder.widget(
  builder: (context, routeNode) => SettingsPage(),
  pageFactory: const PagesFactory.cupertino(),
)
```

--------------------------------

### Install yx_navigation core

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/README.md

Add the core Dart-only navigation state package to your pubspec.yaml dependencies.

```yaml
dependencies:
  yx_navigation: ^1.0.0
```

--------------------------------

### Full example of RouteOutletBuilder with Scaffold

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/route_declarations.md

A complete declaration for AppRoutes.home using RouteBuilder.outlet, including a Scaffold with an AppBar and an info dialog.

```dart
/// Declaration for AppRoutes.home with nested outlet
///
/// RouteBuilder.outlet creates NavigatorOutlet,
/// which renders child pages as a stack.
///
/// outletBuilder lets you wrap the outlet with another widget,
/// for example to add a Scaffold with AppBar.
final homeDeclaration = RouteDeclaration.routeBuilder(
  route: AppRoutes.home,
  routeBuilder: RouteBuilder.outlet(
    outletBuilder: (context, routeNode, outlet) {
      // Wrap outlet in Scaffold for a shared AppBar
      return Scaffold(
        appBar: AppBar(
          title: const Text('Driver app'),
          actions: [
            IconButton(
              icon: const Icon(Icons.info_outline),
              onPressed: () {
                showDialog(
                  context: context,
                  builder: (context) => AlertDialog(
                    title: const Text('Info'),
                    content: const Text(
                      'This is an outlet navigation sample.\n\n'
                      'The outlet creates a nested Navigator '
                      'that renders a page stack.',
                    ),
                    actions: [
                      TextButton(
                        onPressed: () => Navigator.of(context).pop(),
                        child: const Text('OK'),
                      ),
                    ],
                  ),
                );
              },
              tooltip: 'Info',
            ),
          ],
        ),
        body: outlet, // Nested navigator
      );
    },
  ),
  declarations: [
    dashboardDeclaration,
    ordersDeclaration,
    mapDeclaration,
    messagesDeclaration,
  ],
);
```

--------------------------------

### Install yx_scope_linter dependencies

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/packages/yx_scope_linter/README.md

Add yx_scope_linter and custom_lint to your pubspec.yaml file.

```yaml
dev_dependencies:
    custom_lint:
    yx_scope_linter:
```

--------------------------------

### Run without FVM

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/01 - profile - flutter-first-scenario/README.md

Alternative command to run the application if FVM is not installed.

```bash
# Instead of: fvm flutter run -d chrome -t "lib/src/quick_start/01 - profile - flutter-first-scenario/main.dart"
flutter run -d chrome -t "lib/src/quick_start/01 - profile - flutter-first-scenario/main.dart"
```

--------------------------------

### Separation of Concerns in DI, Domain, and UI

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/docs/complete_guide.md

Example showing how to separate DI wiring, business logic, and UI presentation. Business logic and UI components should remain agnostic of DI implementation details.

```dart
// DI Layer — Wiring only
abstract class OrderScope implements Scope {
  OrderManager get orderManager;
  PaymentProcessor get paymentProcessor;
}

// Domain Layer — Business Logic
class OrderManager {
  final OrderRepository _orderRepository;
  final NotificationService _notificationService;
  
  OrderManager(this._orderRepository, this._notificationService);
  
  Future<void> processOrder(Order order) async {
    // Business logic without DI knowledge
  }
}

// UI Layer — Presentation
class OrderWidget extends StatelessWidget {
  final OrderScope orderScope;
  
  const OrderWidget({required this.orderScope, super.key});
  
  @override
  Widget build(BuildContext context) {
    // UI logic without DI knowledge
    return StreamBuilder<OrderStatus>(
      stream: orderScope.orderManager.statusStream,
      builder: (context, snapshot) => OrderStatusWidget(snapshot.data),
    );
  }
}
```

--------------------------------

### Mounting profile feature via RouteDeclaration

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/04 - schema declaration and business logic first scenario/profile_feature/README.md

Example of declaring the profile schema and providing the embedded navigation controller via the dependency scope.

```dart
final profileSchemaDeclaration = RouteDeclaration.scheme(
  route: DriverRoutes.profile,
  schema: ProfileNavigationSchema(),
  outletBuilder: (context, state, outlet) {
    final profileNavigationController =
        DriverAppDependenciesScope.of(context).profileNavigationController;

    return ProfileFeatureDependenciesScope.embedded(
      navigationController: profileNavigationController,
      child: outlet,
    );
  },
);
```

--------------------------------

### Combining Navigation Approaches

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/04 - schema declaration and business logic first scenario/README.md

Demonstrates the architectural setup for a shared state manager, scoped navigation controllers, and nested schema declarations.

```dart
// 1) Root state + guard wiring (see DriverAppDependencies factory).
final stateManager = RouteNodeStateManager(
  routeNode: DriverRoutes.login.toNode(),
  routeNodeGuard: routeNodeGuard,
);

// 2) Controller scoped to the profile subtree in the same RouteNodeStateManager.
final profileNavigationController = NavigationController.node(
  stateManager: stateManager,
  nodeResolver: RouteNodeResolver.id(route: DriverRoutes.profile),
);

// 3) Host interactor uses the root state manager as RouteNavigator.
final driverInteractor = DriverNavigationInteractor(
  stateManager: stateManager,
);

// 4) Nested profile schema (declared in driver_navigation_schema.dart).
RouteDeclaration.scheme(
  route: DriverRoutes.profile,
  schema: ProfileNavigationSchema(),
  outletBuilder: (context, state, outlet) {
    return ProfileFeatureDependenciesScope.embedded(
      navigationController: profileNavigationController,
      child: outlet,
    );
  },
);
```

--------------------------------

### Use Material PagesFactory

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/route_declarations.md

Examples of using the default Material page factory, including explicit configuration and fullscreen dialog settings.

```dart
RouteBuilder.widget(
  builder: (context, routeNode) => MyPage(),
  // pageFactory omitted = PagesFactory.material()
)

// Explicit
RouteBuilder.widget(
  builder: (context, routeNode) => MyPage(),
  pageFactory: const PagesFactory.material(),
)

// With fullscreenDialog
RouteBuilder.widget(
  builder: (context, routeNode) => DialogPage(),
  pageFactory: const PagesFactory.material(
    fullscreenDialog: true,
  ),
)
```

--------------------------------

### Install Flutter Assets with Cleanup

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/linux/CMakeLists.txt

Removes existing flutter_assets directory before copying new ones to ensure no stale files remain.

```cmake
set(FLUTTER_ASSET_DIR_NAME "flutter_assets")
install(CODE "
  file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\")
  " COMPONENT Runtime)
install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}"
  DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime)
```

--------------------------------

### Implementation of push method via mutate

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/quick_start.md

This example shows how high-level navigation methods like push are implemented using the underlying mutate operation to modify the navigation tree.

```dart
  @override
  void push(
    YxRoute route, {
    Map<String, String>? arguments,
    Map<String, Object?>? extra,
  }) =>
      mutate(
        (routeNode) {
          final value = RouteNode.fromRoute(
            route: route,
            arguments: arguments ?? const {},
            extra: extra ?? const {},
          );

          routeNode.add(value);
          return routeNode;
        },
      );
```

--------------------------------

### Maintain legacy Navigator 1.0 API usage

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/compatibility_architecture.md

Example showing that existing Navigator 1.0 code continues to function as-is within the compatibility architecture.

```dart
// Legacy code keeps working as-is
class MyOldWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: () {
        // Navigator 1.0 API
        Navigator.of(context).push(
          MaterialPageRoute(
            builder: (context) => OldScreen(),
          ),
        );
      },
      child: Text('Open Old Screen'),
    );
  }
}
```

--------------------------------

### VirtualDeviceDevtools.setup()

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/README.md

Initializes the virtual device bindings for the application environment.

```APIDOC
## VirtualDeviceDevtools.setup()

### Description
Initializes virtual device bindings to enable virtual device functionality within the application.

### Signature
`void setup()`
```

--------------------------------

### dep_cycle rule example

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/packages/yx_scope_linter/README.md

Example of a cyclical dependency that triggers the dep_cycle lint.

```dart
// The cycle is detected: my1Dep <- my3Dep <- my2Dep <- my1Dep (dep_cycle)
late final Dep<MyDep1> my1Dep = dep(() => MyDep1(my3Dep));
late final Dep<MyDep2> my2Dep = dep(() => MyDep2(my1Dep));
late final Dep<MyDep3> my3Dep = dep(() => MyDep3(my2Dep));
```

--------------------------------

### VirtualDeviceDevtools.setup()

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/README.md

Initializes the virtual device environment. This should be called before runApp, typically within a debug or profile mode check.

```APIDOC
## VirtualDeviceDevtools.setup()

### Description
Initializes the virtual device environment to replace standard Flutter bindings. It is recommended to use this only in debug or profile modes.

### Signature
`void VirtualDeviceDevtools.setup()`
```

--------------------------------

### final_dep rule examples

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/packages/yx_scope_linter/README.md

Examples of correct and incorrect usage of late final for dependency fields.

```dart

late final myDep = dep(() => MyDep());
```

```dart

final myDep = dep(() => SomeDep());

var myDep = dep(() => SomeDep());

late var myDep = dep(() => SomeDep());
```

--------------------------------

### Conditionally Install AOT Library

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/linux/CMakeLists.txt

Installs the AOT library only when the build type is not set to Debug.

```cmake
if(NOT CMAKE_BUILD_TYPE MATCHES "Debug")
  install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}"
    COMPONENT Runtime)
endif()
```

--------------------------------

### Initialize VirtualDeviceDevtools

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/README.md

Call VirtualDeviceDevtools.setup() before runApp in your main function to initialize the bindings.

```dart
import 'package:flutter/material.dart';
import 'package:yx_virtual_device/yx_virtual_device.dart';

void main() {
  VirtualDeviceDevtools.setup();
  runApp(const MyApp());
}
```

--------------------------------

### Launch the application

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/navigation_config_provider/README.md

Run the Flutter application using the specified main entry point.

```bash
flutter run lib/src/navigation_config_provider/main.dart
```

--------------------------------

### Tight Coupling Example (Bad Practice)

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/docs/complete_guide.md

An example of a child scope container directly accessing the internal dependencies of a parent container, leading to tight coupling.

```dart
// BAD — Tight coupling to concrete implementation
class OnlineScopeContainer extends ChildScopeContainer<AccountScopeContainer> {
  OnlineScopeContainer({required super.parent});

  late final acceptOrderManagerDep = dep(() => AcceptOrderManager(
    parent.orderRepositoryDep.get,  // Direct dependency on Dep
    parent.notificationServiceDep.get,
    parent.userManagerDep.get,
  ));
}
```

--------------------------------

### Configure Startup Stack of Multiple Pages

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/quick_start.md

Sets the initial navigation state to a stack of multiple pages.

```dart
node
..setChildren(
    [
    ProfileRoutes.home.toNode(),
    ProfileRoutes.driverProfile.toNode(),
    ProfileRoutes.tripsHistory.toNode(),
    ProfileRoutes.statistics.toNode(),
    ProfileRoutes.settings.toNode(),
    ProfileRoutes.documents.toNode(),
    ],
)
```

--------------------------------

### Wiring CustomRoutePageFactoryResolver

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/compatibility_architecture.md

Example of registering the custom resolver in the application configuration.

```dart
// In app main.dart
NavigationConfigProvider(
  navigatorOverrides: NavigatorCompatibilityOverrides(
    // Register custom resolver
    customRoutePageFactoryResolver: PageLessRoutePageFactoryResolver(),
  ),
  child: MaterialApp.router(
    routerConfig: config,
  ),
)
```

--------------------------------

### DeviceInfo Constructor

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/README.md

Creates a custom device configuration for simulation.

```APIDOC
## DeviceInfo Constructor

### Description
Defines a custom device profile including screen dimensions, pixel ratio, and safe area insets.

### Parameters
- **identifier** (DeviceIdentifier) - Required - Platform and type metadata.
- **name** (String) - Required - Display name of the device.
- **pixelRatio** (double) - Required - The device pixel ratio.
- **screenSize** (Size) - Required - The logical screen size.
- **safeAreas** (EdgeInsets) - Optional - Safe area insets for the device.
- **rotatedSafeAreas** (EdgeInsets) - Optional - Safe area insets when the device is rotated.
```

--------------------------------

### Using the AppScope Interface

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/docs/complete_guide.md

Demonstrates how business logic can interact with the domain interface without knowledge of yx_scope internals.

```dart
void businessLogic(AppScope appScope) {
  // Work only with domain entities
  final userManager = appScope.userManager;
  final authManager = appScope.authManager;
  
  // No access to dep, asyncDep methods
  // No knowledge of yx_scope specifics
}
```

--------------------------------

### Compatibility demo file layout

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/compatibility_demo/README.md

The directory structure for the compatibility demo project.

```text
compatibility_demo/
  main.dart                      # App entry point
  navigation_schema.dart         # Navigation schema
  routes.dart                    # Route declarations
  compatibility_observers.dart   # CompatibilityObserver examples
  pages/
    home_page.dart               # Home page with demo buttons
    legacy_detail_page.dart      # Legacy page (pageless route)
    profile_page.dart            # Page-based route for comparison
  README.md                      # This file
```

--------------------------------

### PageLessRoutePageFactoryResolver Implementation

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/compatibility_architecture.md

Example implementation of a custom resolver for a specific Route type.

```dart

final class PageLessRoutePageFactoryResolver
    implements CustomRoutePageFactoryResolver {

  const PageLessRoutePageFactoryResolver();

  @override
  bool hasResolverFor<T>(Route<T> route) {
    if (route is CustomModalRoute) {
      return true;
    }
...
    return false;
  }

  @override
  Page resolvePage<T>({
    required Completer<T?> routeCompleter,
    required Route<T> route,
    required LocalKey key,
  }) {
    // CustomModalRoute uses a dedicated adapter page
    if (route is CustomModalRoute) {
      return CustomModalRouteAdapterPage(
        key: key,
        route: route,
        routeCompleter: routeCompleter,
      );
    }

...
  }
}
```

--------------------------------

### Declare guards in RouteDeclaration

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/guards.md

Example of attaching guards to a specific route declaration.

```dart
RouteDeclaration.routeBuilder(
  route: AppRoutes.someRoute,
  guards: const [
    AuthGuard(),
    TabInitGuard(tabRoute: AppRoutes.someTab, childRoute: AppRoutes.content),
  ],
  routeBuilder: /* ... */,
)
```

--------------------------------

### Initialize Navigation in main.dart

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/04 - schema declaration and business logic first scenario/README.md

Demonstrates scheduling navigation logic before the MaterialApp is initialized.

```dart
void main() {
  final dependencies = DriverAppDependencies();

  // Demo: schedule navigation before MaterialApp (see main.dart).
  _demonstrateBusinessLogicNavigation(dependencies);

  runApp(
    DriverAppDependenciesScope(
      dependencies: dependencies,
      child: const DriverApp(),
    ),
  );
}
```

--------------------------------

### Check available devices

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/01 - profile - flutter-first-scenario/README.md

Command to list all connected devices.

```bash
cd example
fvm flutter devices
```

--------------------------------

### Basic Dart constant declaration

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/packages/yx_scope_linter/example/README.md

A simple example of declaring a constant variable in Dart.

```dart
const like = 'sample';
```

--------------------------------

### Project Initialization and Build Configuration

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/windows/CMakeLists.txt

Sets the minimum CMake version, project name, and configures build modes for Debug, Profile, and Release.

```cmake
cmake_minimum_required(VERSION 3.14)
project(example LANGUAGES CXX)

# The name of the executable created for the application. Change this to change
# the on-disk name of your application.
set(BINARY_NAME "example")

# Explicitly opt in to modern CMake behaviors to avoid warnings with recent
# versions of CMake.
cmake_policy(VERSION 3.14...3.25)

# Define build configuration option.
get_property(IS_MULTICONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
if(IS_MULTICONFIG)
  set(CMAKE_CONFIGURATION_TYPES "Debug;Profile;Release"
    CACHE STRING "" FORCE)
else()
  if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
    set(CMAKE_BUILD_TYPE "Debug" CACHE
      STRING "Flutter build mode" FORCE)
    set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS
      "Debug" "Profile" "Release")
  endif()
endif()
```

--------------------------------

### Project layout structure

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/02 - profile - business-logic-first-scenario/README.md

The file structure for the business-logic-first scenario.

```text
02 - profile - business-logic-first-scenario/
  main.dart                            # Entry point with a short demo
  dependencies.dart                     # Scope and Dependencies
  profile_navigation_interactor.dart    # Pure Dart business logic
  profile_navigation_schema.dart        # Navigation schema
  profile_routes.dart                   # Route constants
  profile_skeleton_page.dart            # UI page
  README.md                             # This file
```

--------------------------------

### Define RouteIndexedStackDeclaration

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/route_declarations.md

Example of defining a RouteIndexedStackDeclaration to automate child node creation for nested routes.

```dart
final homeDeclaration = RouteDeclaration.indexedStack(
  route: AppRoutes.home,
  routeBuilder: RouteIndexedStackBuilder(
    indexedBuilder: (context, routeNode, indexedStack, controller) {
      return Scaffold(
        body: indexedStack,
        bottomNavigationBar: BottomNavigationBar(
          currentIndex: tabs.indexOf(controller.activeRoute),
          onTap: (index) => controller.setActiveRoute(tabs[index]),
          items: [ /* tabs */ ],
        ),
      );
    },
  ),
  declarations: [
    // From nested declarations: when opening AppRoutes.home, two child nodes
    // for Map and Messages are created automatically
    mapTabDeclaration,
    messagesTabDeclaration,
  ],
);
```

--------------------------------

### Analyze project

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/01 - profile - flutter-first-scenario/README.md

Command to run static analysis on the project.

```bash
cd example
fvm flutter analyze
```

--------------------------------

### Declare guards in RouterSchema

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/guards.md

Example of declaring guards at the schema level within a RouterSchema class.

```dart
base class RouterSchema implements Schema {
...

  @override
  @internal
  final Iterable<RouteNodeGuard> guards;
```

--------------------------------

### Apply build settings and preprocessor definitions

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/windows/runner/CMakeLists.txt

Applies standard build settings and defines preprocessor macros for versioning and Windows compatibility.

```cmake
# Apply the standard set of build settings. This can be removed for applications
# that need different build settings.
apply_standard_settings(${BINARY_NAME})

# Add preprocessor definitions for the build version.
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}")
target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}")

# Disable Windows macros that collide with C++ standard library functions.
target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX")
```

--------------------------------

### Passing dependencies through the hierarchy

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/docs/complete_guide.md

Example of implementing parent and child scope containers to pass dependencies down the hierarchy.

```dart
class AppScopeContainer extends ScopeContainer implements AppScope, UserScopeParent {
  late final configServiceDep = dep(() => ConfigService());
  late final loggingServiceDep = dep(() => LoggingService());
  late final userRepositoryDep = dep(() => UserRepository());
  late final authServiceDep = dep(() => AuthService());

  // Implements both AppScope and UserScopeParent
  @override
  ConfigService get configService => configServiceDep.get;

  @override
  UserRepository get userRepository => userRepositoryDep.get;
  // ...
}

class UserScopeContainer extends ChildScopeContainer<UserScopeParent> 
    implements UserScope, FeatureScopeParent {
  UserScopeContainer({required super.parent});

  late final featureConfigServiceDep = dep(() => FeatureConfigService(
    parent.userRepository,
    parent.authService,
  ));

  // Implements FeatureScopeParent for child scopes
  @override
  FeatureConfigService get featureConfigService => featureConfigServiceDep.get;
}
```

--------------------------------

### Blocking a Route with willPushPagelessRoute

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/compatibility_architecture.md

Example implementation of willPushPagelessRoute to block unnamed routes, triggering a fallback to the native Navigator.

```dart
@override
bool willPushPagelessRoute({
  required RouteNodeReadable routeNodeReadable,
  required Route<dynamic> route,
  required String routeId,
}) {
  // Block unnamed routes
  if (route.settings.name == null) {
    debugPrint('⛔️ Blocked unnamed route: ${route.runtimeType}');
    return false; // → UnsupportedRouteException → fallback to native
  }
  return true;
}
```

--------------------------------

### Supported showMenu() usage

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/compatibility_demo/README.md

Demonstrates that showing and closing a menu via showMenu() and receiving a result works as expected.

```dart
await showMenu(...);           // Show the menu
Navigator.of(context).pop();   // Close the menu
// Receiving a result from pop() works
```

--------------------------------

### Implement AuthGuard with RouteNodeGuard

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/guards.md

An example of a navigation guard that checks authorization and redirects to a login route if the user is not authorized.

```dart
class AuthGuard implements RouteNodeGuard {
  // Checks whether route transition is allowed
  @override
  GuardResult call(...) {
    if (!isAuthorized()) {
      return GuardResult.redirect(target: loginRoute);
    }
    return GuardResult.next();
  }
}
```

--------------------------------

### Configure Flutter and System Dependencies

Source: https://github.com/yandex/city-services-pub/blob/main/yx_virtual_device/example/linux/CMakeLists.txt

Sets up the Flutter managed directory and checks for required GTK system dependencies.

```cmake
set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter")
add_subdirectory(${FLUTTER_MANAGED_DIR})

# System-level dependencies.
find_package(PkgConfig REQUIRED)
pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0)

add_definitions(-DAPPLICATION_ID="${APPLICATION_ID}")
```

--------------------------------

### Custom AnalyticsCompatibilityObserver Implementation

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/compatibility_demo/README.md

An example of extending CompatibilityObserver to track route lifecycle events for analytics and error reporting.

```dart
class AnalyticsCompatibilityObserver extends CompatibilityObserver {
  @override
  bool willPushPagelessRoute({
    required RouteNodeReadable routeNodeReadable,
    required Route<dynamic> route,
    required String routeId,
  }) {
    // Read the current navigation state.
    final currentState = routeNodeReadable.state;

    // Log the push attempt.
    analytics.trackEvent('route_will_push', {
      'route_id': routeId,
      'route_type': route.runtimeType.toString(),
      'current_route': currentState.path,
    });

    return true; // Allow processing.
  }

  @override
  void didCreatePagelessRoute({
    required RouteNodeReadable routeNodeReadable,
    required Route<dynamic> route,
    required String routeId,
    required String routeType,
    required RouteNode routeNode,
  }) {
    // Report a detailed analytics event.
    analytics.trackEvent(
      'legacy_route_created',
      properties: {
        'route_type': routeType,
        'route_name': route.settings.name,
        'route_path': routeNode.path,
        'has_children': routeNode.children.isNotEmpty,
        'parent_path': routeNodeReadable.state.path,
      },
    );
  }

  @override
  void didFailPagelessRoute({
    required RouteNodeReadable routeNodeReadable,
    required Route<dynamic> route,
    required Object error,
    required RouteNode? routeNode,
  }) {
    // Send the failure to error tracking.
    errorReporting.logError(
      'Route fallback to native Navigator',
      error: error,
      properties: {
        'route_type': route.runtimeType.toString(),
        'route_name': route.settings.name,
        'current_path': routeNodeReadable.state.path,
      },
    );
  }
}
```

--------------------------------

### Importing Schemas from Other Modules

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/03 - schema declaration usage scenario/README.md

Shows how to reuse a navigation schema defined in a different scenario.

```text
// Reuse ProfileNavigationSchema from scenario 01
import '../01 - profile - flutter-first-scenario/profile_navigation_schema.dart';
```

--------------------------------

### Install yx_navigation_flutter

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/README.md

Add the Flutter integration package to your pubspec.yaml dependencies. This package includes the core dependency automatically.

```yaml
dependencies:
  yx_navigation_flutter: ^1.0.0
```

--------------------------------

### RouteDeclaration with RouteWidgetBuilder

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/route_declarations.md

Example of declaring a simple page route using RouteWidgetBuilder, suitable for pages without nested navigation.

```dart
/// Profile page declaration
final profileDeclaration = RouteDeclaration.routeBuilder(
  route: AppRoutes.profile,
  routeBuilder: RouteBuilder.widget(
    builder: (context, routeNode) => SimplePage(
      title: 'Driver profile',
      backgroundColor: Colors.green[50],
    ),
  ),
);
```

--------------------------------

### Tracking Route Creation with didCreatePagelessRoute

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/compatibility_architecture.md

Example implementation of didCreatePagelessRoute to track successful route creation and emit analytics events.

```dart
@override
void didCreatePagelessRoute({
  required RouteNodeReadable routeNodeReadable,
  required Route<dynamic> route,
  required String routeId,
  required String routeType,
  required RouteNode routeNode,
}) {
  // Parent path context
  final parentPath = routeNodeReadable.state.path;

  // Analytics
  analytics.trackEvent('pageless_route_created', {
    'route_type': routeType,
    'route_path': routeNode.path,
    'parent_path': parentPath,
  });
}
```

--------------------------------

### Target path

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/01 - profile - flutter-first-scenario/README.md

The file path for the main entry point of the application.

```text
lib/src/quick_start/01 - profile - flutter-first-scenario/main.dart
```

--------------------------------

### Project Structure with Scopes

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/docs/complete_guide.md

Recommended directory layout for projects using yx_scope, separating DI, domain, data, and UI layers.

```text
lib/
├── di/                          # DI Layer
│   ├── app/
│   │   ├── app_scope.dart      # AppScope + AppScopeContainer + AppScopeHolder
│   │   └── app_modules.dart    # App modules
│   ├── user/
│   │   ├── user_scope.dart
│   │   └── user_modules.dart
│   └── feature/
│       ├── feature_scope.dart
│       └── feature_modules.dart
├── domain/                     # Domain Layer
│   ├── auth/
│   ├── user/
│   └── feature/
├── data/                       # Data Layer
└── ui/                         # UI Layer
```

--------------------------------

### Building YxRouterConfig in initState

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/03 - schema declaration usage scenario/README.md

Demonstrates initializing the navigation configuration within a widget's lifecycle.

```dart
// YxRouterConfig is built inside the widget's initState (see main.dart).
@override
void initState() {
  super.initState();
  debugPanelModeNotifier = DebugPanelModeNotifier(enableDebugPanel: true);

  final driverSchema = DriverNavigationSchema();
  config = driverSchema.build(
    debugConfiguration: NavigationDebugConfiguration(
      debugPanelModeNotifier: debugPanelModeNotifier,
    ),
  );
}
```

--------------------------------

### Handling Failures with didFailPagelessRoute

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/compatibility_architecture.md

Example implementation of didFailPagelessRoute to log errors or warnings based on the operation type when route creation fails.

```dart
@override
void didFailPagelessRoute({
  required RouteNodeReadable routeNodeReadable,
  required Route<dynamic> route,
  required Object error,
  required RouteNode? routeNode,
}) {
  // Log as error for replace ops, warning for push
  final isReplaceOperation = error.toString().contains('pushReplacement') ||
                             error.toString().contains('pushAndRemoveUntil');

  if (isReplaceOperation) {
    errorReporting.logError(
      'CRITICAL: Unsupported route in replace operation',
      error: error,
      properties: {
        'route_type': route.runtimeType.toString(),
        'current_path': routeNodeReadable.state.path,
      },
    );
  } else {
    errorReporting.logWarning(
      'Route fallback to native Navigator',
      error: error,
      properties: {
        'route_type': route.runtimeType.toString(),
        'current_path': routeNodeReadable.state.path,
      },
    );
  }
}
```

--------------------------------

### Run app for iOS simulator

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/01 - profile - flutter-first-scenario/README.md

Command to run the application on the iPhone Simulator.

```bash
cd example
fvm flutter run -d "iPhone Simulator" -t "lib/src/quick_start/01 - profile - flutter-first-scenario/main.dart"
```

--------------------------------

### Create page-based routes using Navigator 2.0 API

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/docs/compatibility_architecture.md

Example of creating a page-based route using the declarative RouteDeclaration approach.

```dart
RouteDeclaration.routeBuilder(
  route: AppRoutes.profile,
  routeBuilder: RouteBuilder.widget(...), // Page-based route
);
```

--------------------------------

### Run app for Android emulator

Source: https://github.com/yandex/city-services-pub/blob/main/yx_navigation/packages/yx_navigation_flutter/example/lib/src/quick_start/01 - profile - flutter-first-scenario/README.md

Command to run the application on an Android emulator.

```bash
cd example
fvm flutter run -d android -t "lib/src/quick_start/01 - profile - flutter-first-scenario/main.dart"
```

--------------------------------

### Define Asynchronous Dependencies in ScopeContainer

Source: https://github.com/yandex/city-services-pub/blob/main/yx_scope/docs/introduction.md

Example of declaring an asynchronous dependency using rawAsyncDep and specifying an initialization queue in a ScopeContainer subclass.

```dart
class AppScopeContainer extends ScopeContainer {

  @override
  List<Set<AsyncDep>> get initializeQueue =>
      [
        {
          appStateObserverDep,
        }
      ];

  late final routerDelegateDep = dep(() => AppRouterDelegate());

  late final appStateObserverDep = rawAsyncDep(
        () =>
        AppStateObserver(
          routerDelegateDep.get,
        ),
    init: (dep) async => dep.init(),
    dispose: (dep) async => dep.dispose(),
  );
}
```
Tokens:
Raw