From 020020f532930487f6c49bb9b581e80152e6ddac Mon Sep 17 00:00:00 2001
From: Krzysztof Ligarski <krzysztof.ligarski@swmansion.com>
Date: Tue, 28 Apr 2026 12:59:08 +0200
Subject: [PATCH 1/5] add commands skeleton

---
 .../config/StackHeaderConfigViewManager.kt    | 14 +++++++
 .../header/StackHeaderConfig.android.tsx      | 31 +++++++++++++-
 ...StackHeaderConfigAndroidNativeComponent.ts | 40 ++++++++++++++++++-
 3 files changed, 82 insertions(+), 3 deletions(-)

diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
index aa7ac413a7..0adcf0d634 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
@@ -2,6 +2,7 @@ package com.swmansion.rnscreens.gamma.stack.header.config
 
 import android.view.View
 import com.facebook.react.bridge.JSApplicationIllegalArgumentException
+import com.facebook.react.bridge.ReadableArray
 import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.module.annotations.ReactModule
 import com.facebook.react.uimanager.ReactStylesDiffMap
@@ -186,6 +187,19 @@ open class StackHeaderConfigViewManager :
         view.scrollFlagSnap = value
     }
 
+    override fun setToolbarMenuItems(
+        view: StackHeaderConfig,
+        value: ReadableArray?,
+    ) = Unit
+
+    override fun setToolbarMenuItemOptions(
+        view: StackHeaderConfig,
+        id: String,
+        options: ReadableArray,
+    ) {
+        println("[StackHeaderConfigViewManager] " + options.getMap(0))
+    }
+
     companion object {
         const val REACT_CLASS = "RNSStackHeaderConfigAndroid"
     }
diff --git a/src/components/gamma/stack/header/StackHeaderConfig.android.tsx b/src/components/gamma/stack/header/StackHeaderConfig.android.tsx
index 4b7954a11d..7cac35d4a4 100644
--- a/src/components/gamma/stack/header/StackHeaderConfig.android.tsx
+++ b/src/components/gamma/stack/header/StackHeaderConfig.android.tsx
@@ -1,7 +1,9 @@
-import React from 'react';
+import React, { ComponentRef, useEffect, useRef } from 'react';
 import { Image, StyleSheet } from 'react-native';
 import type { StackHeaderConfigProps } from './StackHeaderConfig.types';
-import StackHeaderConfigAndroidNativeComponent from '../../../../fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent';
+import StackHeaderConfigAndroidNativeComponent, {
+  Commands as StackHeaderConfigAndroidNativeCommands,
+} from '../../../../fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent';
 import type { NativeProps as StackHeaderConfigAndroidNativeComponentProps } from '../../../../fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent';
 import StackHeaderSubview from './android/StackHeaderSubview.android';
 import type {
@@ -17,6 +19,30 @@ function StackHeaderConfig(props: StackHeaderConfigProps) {
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const { android, ios, ...baseProps } = props;
 
+  const ref = useRef<ComponentRef<
+    typeof StackHeaderConfigAndroidNativeComponent
+  > | null>(null);
+
+  useEffect(() => {
+    const handle = setTimeout(() => {
+      if (!ref.current) {
+        return;
+      }
+
+      StackHeaderConfigAndroidNativeCommands.setToolbarMenuItemOptions(
+        ref.current,
+        'someItemId',
+        [
+          {
+            title: 'Hello!',
+          },
+        ],
+      );
+    }, 5000);
+
+    return () => clearTimeout(handle);
+  }, []);
+
   const {
     backgroundSubview,
     leadingSubview,
@@ -42,6 +68,7 @@ function StackHeaderConfig(props: StackHeaderConfigProps) {
 
   return (
     <StackHeaderConfigAndroidNativeComponent
+      ref={ref}
       collapsable={false}
       style={StyleSheet.absoluteFill}
       {...baseProps}
diff --git a/src/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.ts b/src/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.ts
index 9d0706a7b9..3fe26a2f2a 100644
--- a/src/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.ts
+++ b/src/fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent.ts
@@ -3,13 +3,26 @@
 import type {
   ColorValue,
   CodegenTypes as CT,
+  HostComponent,
   ImageSource,
   ViewProps,
 } from 'react-native';
-import { codegenNativeComponent } from 'react-native';
+import { codegenNativeCommands, codegenNativeComponent } from 'react-native';
 
 type StackHeaderTypeAndroid = 'small' | 'medium' | 'large';
 
+type ToolbarMenuItemClickedEvent = Readonly<{
+  id: string;
+}>;
+
+export interface ToolbarMenuItemAndroid {
+  id: string;
+  title: string;
+  hidden?: CT.WithDefault<boolean, false>;
+
+  // TODO: add Menu
+}
+
 export interface NativeProps extends ViewProps {
   title?: string | undefined;
   hidden?: CT.WithDefault<boolean, false>;
@@ -28,8 +41,33 @@ export interface NativeProps extends ViewProps {
   scrollFlagEnterAlwaysCollapsed?: CT.WithDefault<boolean, false>;
   scrollFlagExitUntilCollapsed?: CT.WithDefault<boolean, false>;
   scrollFlagSnap?: CT.WithDefault<boolean, false>;
+
+  toolbarMenuItems?: ToolbarMenuItemAndroid[] | undefined;
+  onToolbarMenuItemClicked?:
+    | CT.DirectEventHandler<ToolbarMenuItemClickedEvent>
+    | undefined;
 }
 
+type ComponentType = HostComponent<NativeProps>;
+
+export type ToolbarMenuItemOptionsAndroid = Partial<
+  Omit<ToolbarMenuItemAndroid, 'id'>
+>;
+
+export interface NativeCommands {
+  setToolbarMenuItemOptions: (
+    viewRef: React.ComponentRef<ComponentType>,
+    id: string,
+    // We use the array here only due to codegen limitation. We're using only
+    // the first index of the array.
+    options: ToolbarMenuItemOptionsAndroid[],
+  ) => void;
+}
+
+export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
+  supportedCommands: ['setToolbarMenuItemOptions'],
+});
+
 export default codegenNativeComponent<NativeProps>(
   'RNSStackHeaderConfigAndroid',
   {

From af0b92d6b79afd7673be12d2e11c4776a88bfbd5 Mon Sep 17 00:00:00 2001
From: Krzysztof Ligarski <krzysztof.ligarski@swmansion.com>
Date: Tue, 28 Apr 2026 15:22:35 +0200
Subject: [PATCH 2/5] add sft skeleton

---
 .../single-feature-tests/stack-v5/index.ts    |   2 +
 .../index.tsx                                 | 161 ++++++++++++++++++
 .../scenario.md                               |   1 +
 3 files changed, 164 insertions(+)
 create mode 100644 apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/index.tsx
 create mode 100644 apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/scenario.md

diff --git a/apps/src/tests/single-feature-tests/stack-v5/index.ts b/apps/src/tests/single-feature-tests/stack-v5/index.ts
index 5c6f505d04..dfd06528ae 100644
--- a/apps/src/tests/single-feature-tests/stack-v5/index.ts
+++ b/apps/src/tests/single-feature-tests/stack-v5/index.ts
@@ -5,6 +5,7 @@ import AnimationAndroid from './test-animation-android';
 import TestStackSimpleNav from './test-stack-simple-nav';
 import TestStackSubviews from './test-stack-subviews-android';
 import TestStackBackButton from './test-stack-back-button-android';
+import TestStackToolbarMenuCommands from './test-stack-toolbar-menu-commands';
 
 const scenarios = {
   PreventNativeDismissSingleStack,
@@ -13,6 +14,7 @@ const scenarios = {
   TestStackSimpleNav,
   TestStackSubviews,
   TestStackBackButton,
+  TestStackToolbarMenuCommands,
 };
 
 const StackScenarioGroup: ScenarioGroup<keyof typeof scenarios> = {
diff --git a/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/index.tsx b/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/index.tsx
new file mode 100644
index 0000000000..cd01e2ec82
--- /dev/null
+++ b/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/index.tsx
@@ -0,0 +1,161 @@
+import React, { useCallback, useEffect, useMemo, useState } from 'react';
+import { Button, ScrollView, StyleSheet, Text } from 'react-native';
+import {
+  createScenario,
+  ScenarioDescription,
+} from '@apps/tests/shared/helpers';
+import {
+  StackContainer,
+  useStackNavigationContext,
+} from '@apps/shared/gamma/containers/stack';
+import { Colors } from '@apps/shared/styling';
+import type { StackHeaderConfigProps } from 'react-native-screens/experimental';
+
+const scenarioDescription: ScenarioDescription = {
+  name: 'Stack Toolbar Menu Commands',
+  key: 'test-stack-toolbar-menu-commands',
+  details: 'Tests changes to toolbar menu in runtime.',
+  platforms: ['android'],
+};
+
+interface Config {
+  // backButtonHidden: boolean;
+  // tintColor: TintColorOption;
+  // icon: IconOption;
+}
+
+const DEFAULT_CONFIG: Config = {
+  // backButtonHidden: false,
+  // tintColor: 'default',
+  // icon: 'default',
+};
+
+const ConfigContext = React.createContext<{
+  config: Config;
+  updateConfig: <K extends keyof Config>(key: K, value: Config[K]) => void;
+}>({
+  config: DEFAULT_CONFIG,
+  updateConfig: () => {},
+});
+
+function buildHeaderConfig(config: Config): StackHeaderConfigProps {
+  return {
+    title: 'Toolbar Menu Commands Test',
+    // backButtonHidden: config.backButtonHidden,
+    // android: {
+    //   backButtonTintColor: resolveTintColor(config.tintColor),
+    //   backButtonIcon: resolveIcon(config.icon),
+    // },
+  };
+}
+
+export function App() {
+  const [config, setConfig] = useState<Config>(DEFAULT_CONFIG);
+
+  const updateConfig = useCallback(
+    <K extends keyof Config>(key: K, value: Config[K]) => {
+      setConfig(prev => ({ ...prev, [key]: value }));
+    },
+    [],
+  );
+
+  return (
+    <ConfigContext.Provider value={{ config, updateConfig }}>
+      <StackContainer
+        routeConfigs={[
+          {
+            name: 'Root',
+            Component: RootScreen,
+            options: {},
+          },
+          {
+            name: 'Pushed',
+            Component: PushedScreen,
+            options: {},
+          },
+        ]}
+      />
+    </ConfigContext.Provider>
+  );
+}
+
+function ConfigControls() {
+  const { config, updateConfig } = React.useContext(ConfigContext);
+
+  return (
+    <>
+      <Text style={styles.heading}>Toolbar Menu</Text>
+      {/*<SettingsSwitch
+        label="backButtonHidden"
+        value={config.backButtonHidden}
+        onValueChange={v => updateConfig('backButtonHidden', v)}
+      />
+      <SettingsPicker<TintColorOption>
+        label="tintColor"
+        value={config.tintColor}
+        onValueChange={v => updateConfig('tintColor', v)}
+        items={TINT_COLOR_OPTIONS}
+      />
+      <SettingsPicker<IconOption>
+        label="icon"
+        value={config.icon}
+        onValueChange={v => updateConfig('icon', v)}
+        items={ICON_OPTIONS}
+      />*/}
+    </>
+  );
+}
+
+function useApplyHeaderConfig() {
+  const { config } = React.useContext(ConfigContext);
+  const { setRouteOptions, routeKey } = useStackNavigationContext();
+  const headerConfig = useMemo(() => buildHeaderConfig(config), [config]);
+
+  useEffect(() => {
+    setRouteOptions(routeKey, { headerConfig });
+  }, [headerConfig, setRouteOptions, routeKey]);
+}
+
+function RootScreen() {
+  const { push } = useStackNavigationContext();
+  useApplyHeaderConfig();
+
+  return (
+    <ScrollView style={styles.scroll} contentContainerStyle={styles.content}>
+      <ConfigControls />
+      <Text style={styles.heading}>Navigation</Text>
+      <Button title="Push screen" onPress={() => push('Pushed')} />
+    </ScrollView>
+  );
+}
+
+function PushedScreen() {
+  const { push } = useStackNavigationContext();
+  useApplyHeaderConfig();
+
+  return (
+    <ScrollView style={styles.scroll} contentContainerStyle={styles.content}>
+      <ConfigControls />
+      <Text style={styles.heading}>Navigation</Text>
+      <Button title="Push another" onPress={() => push('Pushed')} />
+    </ScrollView>
+  );
+}
+
+const styles = StyleSheet.create({
+  scroll: {
+    backgroundColor: Colors.cardBackground,
+  },
+  content: {
+    padding: 16,
+    gap: 6,
+  },
+  heading: {
+    fontSize: 20,
+    fontWeight: 'bold',
+    marginTop: 12,
+    marginBottom: 4,
+  },
+});
+
+export default createScenario(App, scenarioDescription);
diff --git a/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/scenario.md b/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/scenario.md
new file mode 100644
index 0000000000..1333ed77b7
--- /dev/null
+++ b/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/scenario.md
@@ -0,0 +1 @@
+TODO

From a6ee303cf9842d50b814ff99e07a76e519a588cc Mon Sep 17 00:00:00 2001
From: Krzysztof Ligarski <krzysztof.ligarski@swmansion.com>
Date: Mon, 4 May 2026 12:59:28 +0200
Subject: [PATCH 3/5] expose ref, add test screen for view commands

---
 .../config/StackHeaderConfigViewManager.kt    |   2 +-
 .../gamma/containers/stack/StackContainer.tsx |   4 +-
 .../containers/stack/StackContainer.types.ts  |   2 +
 .../single-feature-tests/stack-v5/index.ts    |   2 +-
 .../index.tsx                                 | 268 ++++++++++++++++++
 .../scenario.md                               |   0
 .../index.tsx                                 | 161 -----------
 .../header/StackHeaderConfig.android.tsx      | 104 +++++--
 .../header/StackHeaderConfig.android.types.ts |  29 ++
 .../gamma/stack/header/StackHeaderConfig.d.ts |  13 +-
 .../header/StackHeaderConfig.ios.types.ts     |   3 +
 .../stack/header/StackHeaderConfig.types.ts   |   7 +
 src/components/gamma/stack/index.ts           |   5 +
 13 files changed, 402 insertions(+), 198 deletions(-)
 create mode 100644 apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands-android/index.tsx
 rename apps/src/tests/single-feature-tests/stack-v5/{test-stack-toolbar-menu-commands => test-stack-toolbar-menu-commands-android}/scenario.md (100%)
 delete mode 100644 apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/index.tsx

diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
index 0adcf0d634..6ba16cdbee 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
@@ -197,7 +197,7 @@ open class StackHeaderConfigViewManager :
         id: String,
         options: ReadableArray,
     ) {
-        println("[StackHeaderConfigViewManager] " + options.getMap(0))
+        println("[StackHeaderConfigViewManager] $id: ${options.getMap(0)}")
     }
 
     companion object {
diff --git a/apps/src/shared/gamma/containers/stack/StackContainer.tsx b/apps/src/shared/gamma/containers/stack/StackContainer.tsx
index 950827ef7d..f0993fb23c 100644
--- a/apps/src/shared/gamma/containers/stack/StackContainer.tsx
+++ b/apps/src/shared/gamma/containers/stack/StackContainer.tsx
@@ -65,7 +65,7 @@ export function StackContainer({ routeConfigs }: StackContainerProps) {
   return (
     <Stack.Host ref={hostRef}>
       {stackNavState.stack.map(
-        ({ options: { headerConfig, ...options }, activityMode, routeKey, name }) => {
+        ({ options: { headerConfig, headerConfigRef, ...options }, activityMode, routeKey, name }) => {
           const stackNavigationContext: StackNavigationContextPayload = {
             routeKey,
             routeOptions: { ...options },
@@ -94,7 +94,7 @@ export function StackContainer({ routeConfigs }: StackContainerProps) {
               <StackNavigationContext.Provider value={stackNavigationContext}>
                 <Component />
                 {headerConfig !== undefined && (
-                  <Stack.HeaderConfig {...headerConfig} />
+                  <Stack.HeaderConfig ref={headerConfigRef} {...headerConfig} />
                 )}
               </StackNavigationContext.Provider>
             </Stack.Screen>
diff --git a/apps/src/shared/gamma/containers/stack/StackContainer.types.ts b/apps/src/shared/gamma/containers/stack/StackContainer.types.ts
index 15cd96e543..459e0eec1a 100644
--- a/apps/src/shared/gamma/containers/stack/StackContainer.types.ts
+++ b/apps/src/shared/gamma/containers/stack/StackContainer.types.ts
@@ -2,6 +2,7 @@ import React from 'react';
 import {
   StackScreenProps,
   StackHeaderConfigProps,
+  StackHeaderConfigRef,
 } from 'react-native-screens/experimental';
 
 /// Route definition
@@ -11,6 +12,7 @@ export type StackRouteOptions = Omit<
   'children' | 'activityMode' | 'screenKey'
 > & {
   headerConfig?: StackHeaderConfigProps | undefined;
+  headerConfigRef?: React.Ref<StackHeaderConfigRef> | undefined;
 };
 
 /**
diff --git a/apps/src/tests/single-feature-tests/stack-v5/index.ts b/apps/src/tests/single-feature-tests/stack-v5/index.ts
index dfd06528ae..7074bc5ac9 100644
--- a/apps/src/tests/single-feature-tests/stack-v5/index.ts
+++ b/apps/src/tests/single-feature-tests/stack-v5/index.ts
@@ -5,7 +5,7 @@ import AnimationAndroid from './test-animation-android';
 import TestStackSimpleNav from './test-stack-simple-nav';
 import TestStackSubviews from './test-stack-subviews-android';
 import TestStackBackButton from './test-stack-back-button-android';
-import TestStackToolbarMenuCommands from './test-stack-toolbar-menu-commands';
+import TestStackToolbarMenuCommands from './test-stack-toolbar-menu-commands-android';
 
 const scenarios = {
   PreventNativeDismissSingleStack,
diff --git a/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands-android/index.tsx b/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands-android/index.tsx
new file mode 100644
index 0000000000..717d014768
--- /dev/null
+++ b/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands-android/index.tsx
@@ -0,0 +1,268 @@
+import React, {
+  useCallback,
+  useEffect,
+  useLayoutEffect,
+  useRef,
+  useState,
+} from 'react';
+import { Button, ScrollView, StyleSheet, Text } from 'react-native';
+import {
+  createScenario,
+  ScenarioDescription,
+} from '@apps/tests/shared/helpers';
+import {
+  StackContainerWithDynamicRouteConfigs,
+  useStackNavigationContext,
+  useStackRouteConfigContext,
+} from '@apps/shared/gamma/containers/stack';
+import { SettingsPicker, SettingsSwitch } from '@apps/shared';
+import { Colors } from '@apps/shared/styling';
+import {
+  type StackHeaderConfigRef,
+  type ToolbarMenuItemOptionsAndroid,
+} from 'react-native-screens/experimental';
+
+const scenarioDescription: ScenarioDescription = {
+  name: 'Stack Toolbar Menu Commands',
+  key: 'test-stack-toolbar-menu-commands-android',
+  details: 'Tests toolbar menu items prop config and imperative commands.',
+  platforms: ['android'],
+};
+
+type IdOption = 'item-1' | 'item-2' | 'item-3';
+type TitleOption = 'Title A' | 'Title B' | 'Title C' | 'Long Title' | 'Changed';
+
+const ID_OPTIONS: IdOption[] = ['item-1', 'item-2', 'item-3'];
+const TITLE_OPTIONS: TitleOption[] = [
+  'Title A',
+  'Title B',
+  'Title C',
+  'Long Title',
+  'Changed',
+];
+
+interface SlotConfig {
+  include: boolean;
+  id: IdOption;
+  title: TitleOption;
+  hidden: boolean;
+}
+
+type Slots = [SlotConfig, SlotConfig, SlotConfig];
+
+const DEFAULT_SLOTS: Slots = [
+  { include: true, id: 'item-1', title: 'Title A', hidden: false },
+  { include: true, id: 'item-2', title: 'Title B', hidden: false },
+  { include: true, id: 'item-3', title: 'Title C', hidden: false },
+];
+
+function buildItems(slots: Slots) {
+  return slots
+    .filter(s => s.include)
+    .map(({ id, title, hidden }) => ({ id, title, hidden }));
+}
+
+function updateSlotAt(
+  slots: Slots,
+  index: number,
+  patch: Partial<SlotConfig>,
+): Slots {
+  return slots.map((s, i) => (i === index ? { ...s, ...patch } : s)) as Slots;
+}
+
+const InitialSlotsContext = React.createContext<{
+  initialSlots: Slots;
+  setInitialSlots: React.Dispatch<React.SetStateAction<Slots>>;
+}>({
+  initialSlots: DEFAULT_SLOTS,
+  setInitialSlots: () => {},
+});
+
+export function App() {
+  const [initialSlots, setInitialSlots] = useState<Slots>(DEFAULT_SLOTS);
+
+  return (
+    <InitialSlotsContext.Provider value={{ initialSlots, setInitialSlots }}>
+      <StackContainerWithDynamicRouteConfigs
+        routeConfigs={[
+          { name: 'Root', Component: RootScreen, options: {} },
+          { name: 'Pushed', Component: PushedScreen, options: {} },
+        ]}
+      />
+    </InitialSlotsContext.Provider>
+  );
+}
+
+function RootScreen() {
+  const { initialSlots, setInitialSlots } =
+    React.useContext(InitialSlotsContext);
+  const { updateRouteConfigWithOptions } = useStackRouteConfigContext();
+  const { push, setRouteOptions, routeKey } = useStackNavigationContext();
+
+  useEffect(() => {
+    setRouteOptions(routeKey, {
+      headerConfig: { title: 'Menu Commands Test' },
+    });
+  }, [setRouteOptions, routeKey]);
+
+  useEffect(() => {
+    updateRouteConfigWithOptions('Pushed', {
+      headerConfig: {
+        title: 'Toolbar Menu Commands Test',
+        android: { toolbarMenuItems: buildItems(initialSlots) },
+      },
+    });
+  }, [initialSlots, updateRouteConfigWithOptions]);
+
+  return (
+    <ScrollView style={styles.scroll} contentContainerStyle={styles.content}>
+      <Text style={styles.heading}>Initial Items for Screen 2</Text>
+      <SlotControls
+        slots={initialSlots}
+        updateSlot={(i, patch) =>
+          setInitialSlots(prev => updateSlotAt(prev, i, patch))
+        }
+      />
+      <Text style={styles.heading}>Navigation</Text>
+      <Button title="Push Screen 2" onPress={() => push('Pushed')} />
+    </ScrollView>
+  );
+}
+
+function PushedScreen() {
+  const { initialSlots } = React.useContext(InitialSlotsContext);
+  const [slots, setSlots] = useState<Slots>(() => initialSlots);
+  const [lastClicked, setLastClicked] = useState<string | null>(null);
+
+  const [cmdTargetId, setCmdTargetId] = useState<IdOption>('item-1');
+  const [cmdTitle, setCmdTitle] = useState<TitleOption>('Changed');
+  const [cmdHidden, setCmdHidden] = useState(false);
+
+  const headerConfigRef = useRef<StackHeaderConfigRef>(null);
+  const { setRouteOptions, routeKey } = useStackNavigationContext();
+
+  useLayoutEffect(() => {
+    setRouteOptions(routeKey, { headerConfigRef });
+  }, [setRouteOptions, routeKey]);
+
+  useEffect(() => {
+    setRouteOptions(routeKey, {
+      headerConfig: {
+        title: 'Toolbar Menu Commands Test',
+        android: {
+          toolbarMenuItems: buildItems(slots),
+          onToolbarMenuItemClicked: id => setLastClicked(id),
+        },
+      },
+    });
+  }, [slots, setRouteOptions, routeKey]);
+
+  const sendCommand = useCallback(() => {
+    const options: ToolbarMenuItemOptionsAndroid = {
+      title: cmdTitle,
+      hidden: cmdHidden,
+    };
+    headerConfigRef.current?.android?.setToolbarMenuItemOptions(
+      cmdTargetId,
+      options,
+    );
+  }, [cmdTargetId, cmdTitle, cmdHidden]);
+
+  return (
+    <ScrollView style={styles.scroll} contentContainerStyle={styles.content}>
+      <Text style={styles.heading}>Send Command</Text>
+      <SettingsPicker<IdOption>
+        label="target id"
+        value={cmdTargetId}
+        items={ID_OPTIONS}
+        onValueChange={setCmdTargetId}
+      />
+      <SettingsPicker<TitleOption>
+        label="title"
+        value={cmdTitle}
+        items={TITLE_OPTIONS}
+        onValueChange={setCmdTitle}
+      />
+      <SettingsSwitch
+        label="hidden"
+        value={cmdHidden}
+        onValueChange={setCmdHidden}
+      />
+      <Button title="Send Command" onPress={sendCommand} />
+
+      <Text style={styles.heading}>Result</Text>
+      <Text style={styles.result}>Last clicked: {lastClicked ?? '—'}</Text>
+
+      <Text style={styles.heading}>Menu Items — Props</Text>
+      <SlotControls
+        slots={slots}
+        updateSlot={(i, patch) =>
+          setSlots(prev => updateSlotAt(prev, i, patch))
+        }
+      />
+    </ScrollView>
+  );
+}
+
+interface SlotControlsProps {
+  slots: Slots;
+  updateSlot: (index: number, patch: Partial<SlotConfig>) => void;
+}
+
+function SlotControls({ slots, updateSlot }: SlotControlsProps) {
+  return (
+    <>
+      {slots.map((slot, i) => (
+        <React.Fragment key={i}>
+          <Text style={styles.slotLabel}>
+            Slot {i + 1} (item-{i + 1})
+          </Text>
+          <SettingsSwitch
+            label="include"
+            value={slot.include}
+            onValueChange={v => updateSlot(i, { include: v })}
+          />
+          <SettingsPicker<TitleOption>
+            label="title"
+            value={slot.title}
+            items={TITLE_OPTIONS}
+            onValueChange={v => updateSlot(i, { title: v })}
+          />
+          <SettingsSwitch
+            label="hidden"
+            value={slot.hidden}
+            onValueChange={v => updateSlot(i, { hidden: v })}
+          />
+        </React.Fragment>
+      ))}
+    </>
+  );
+}
+
+const styles = StyleSheet.create({
+  scroll: {
+    backgroundColor: Colors.cardBackground,
+  },
+  content: {
+    padding: 10,
+    paddingBottom: 50,
+    gap: 6,
+  },
+  heading: {
+    fontSize: 20,
+    fontWeight: 'bold',
+    marginTop: 12,
+    marginBottom: 4,
+  },
+  slotLabel: {
+    fontSize: 16,
+    fontWeight: '600',
+    marginTop: 8,
+  },
+  result: {
+    fontSize: 15,
+    paddingHorizontal: 10,
+  },
+});
+
+export default createScenario(App, scenarioDescription);
diff --git a/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/scenario.md b/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands-android/scenario.md
similarity index 100%
rename from apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/scenario.md
rename to apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands-android/scenario.md
diff --git a/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/index.tsx b/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/index.tsx
deleted file mode 100644
index cd01e2ec82..0000000000
--- a/apps/src/tests/single-feature-tests/stack-v5/test-stack-toolbar-menu-commands/index.tsx
+++ /dev/null
@@ -1,161 +0,0 @@
-import React, { useCallback, useEffect, useMemo, useState } from 'react';
-import { Button, ScrollView, StyleSheet, Text } from 'react-native';
-import {
-  createScenario,
-  ScenarioDescription,
-} from '@apps/tests/shared/helpers';
-import {
-  StackContainer,
-  useStackNavigationContext,
-} from '@apps/shared/gamma/containers/stack';
-import { Colors } from '@apps/shared/styling';
-import type { StackHeaderConfigProps } from 'react-native-screens/experimental';
-
-const scenarioDescription: ScenarioDescription = {
-  name: 'Stack Toolbar Menu Commands',
-  key: 'test-stack-toolbar-menu-commands',
-  details: 'Tests changes to toolbar menu in runtime.',
-  platforms: ['android'],
-};
-
-interface Config {
-  // backButtonHidden: boolean;
-  // tintColor: TintColorOption;
-  // icon: IconOption;
-}
-
-const DEFAULT_CONFIG: Config = {
-  // backButtonHidden: false,
-  // tintColor: 'default',
-  // icon: 'default',
-};
-
-const ConfigContext = React.createContext<{
-  config: Config;
-  updateConfig: <K extends keyof Config>(key: K, value: Config[K]) => void;
-}>({
-  config: DEFAULT_CONFIG,
-  updateConfig: () => {},
-});
-
-function buildHeaderConfig(config: Config): StackHeaderConfigProps {
-  return {
-    title: 'Toolbar Menu Commands Test',
-    // backButtonHidden: config.backButtonHidden,
-    // android: {
-    //   backButtonTintColor: resolveTintColor(config.tintColor),
-    //   backButtonIcon: resolveIcon(config.icon),
-    // },
-  };
-}
-
-export function App() {
-  const [config, setConfig] = useState<Config>(DEFAULT_CONFIG);
-
-  const updateConfig = useCallback(
-    <K extends keyof Config>(key: K, value: Config[K]) => {
-      setConfig(prev => ({ ...prev, [key]: value }));
-    },
-    [],
-  );
-
-  return (
-    <ConfigContext.Provider value={{ config, updateConfig }}>
-      <StackContainer
-        routeConfigs={[
-          {
-            name: 'Root',
-            Component: RootScreen,
-            options: {},
-          },
-          {
-            name: 'Pushed',
-            Component: PushedScreen,
-            options: {},
-          },
-        ]}
-      />
-    </ConfigContext.Provider>
-  );
-}
-
-function ConfigControls() {
-  const { config, updateConfig } = React.useContext(ConfigContext);
-
-  return (
-    <>
-      <Text style={styles.heading}>Toolbar Menu</Text>
-      {/*<SettingsSwitch
-        label="backButtonHidden"
-        value={config.backButtonHidden}
-        onValueChange={v => updateConfig('backButtonHidden', v)}
-      />
-      <SettingsPicker<TintColorOption>
-        label="tintColor"
-        value={config.tintColor}
-        onValueChange={v => updateConfig('tintColor', v)}
-        items={TINT_COLOR_OPTIONS}
-      />
-      <SettingsPicker<IconOption>
-        label="icon"
-        value={config.icon}
-        onValueChange={v => updateConfig('icon', v)}
-        items={ICON_OPTIONS}
-      />*/}
-    </>
-  );
-}
-
-function useApplyHeaderConfig() {
-  const { config } = React.useContext(ConfigContext);
-  const { setRouteOptions, routeKey } = useStackNavigationContext();
-  const headerConfig = useMemo(() => buildHeaderConfig(config), [config]);
-
-  useEffect(() => {
-    setRouteOptions(routeKey, { headerConfig });
-  }, [headerConfig, setRouteOptions, routeKey]);
-}
-
-function RootScreen() {
-  const { push } = useStackNavigationContext();
-  useApplyHeaderConfig();
-
-  return (
-    <ScrollView style={styles.scroll} contentContainerStyle={styles.content}>
-      <ConfigControls />
-      <Text style={styles.heading}>Navigation</Text>
-      <Button title="Push screen" onPress={() => push('Pushed')} />
-    </ScrollView>
-  );
-}
-
-function PushedScreen() {
-  const { push } = useStackNavigationContext();
-  useApplyHeaderConfig();
-
-  return (
-    <ScrollView style={styles.scroll} contentContainerStyle={styles.content}>
-      <ConfigControls />
-      <Text style={styles.heading}>Navigation</Text>
-      <Button title="Push another" onPress={() => push('Pushed')} />
-    </ScrollView>
-  );
-}
-
-const styles = StyleSheet.create({
-  scroll: {
-    backgroundColor: Colors.cardBackground,
-  },
-  content: {
-    padding: 16,
-    gap: 6,
-  },
-  heading: {
-    fontSize: 20,
-    fontWeight: 'bold',
-    marginTop: 12,
-    marginBottom: 4,
-  },
-});
-
-export default createScenario(App, scenarioDescription);
diff --git a/src/components/gamma/stack/header/StackHeaderConfig.android.tsx b/src/components/gamma/stack/header/StackHeaderConfig.android.tsx
index 7cac35d4a4..04d53dd0a2 100644
--- a/src/components/gamma/stack/header/StackHeaderConfig.android.tsx
+++ b/src/components/gamma/stack/header/StackHeaderConfig.android.tsx
@@ -1,47 +1,41 @@
-import React, { ComponentRef, useEffect, useRef } from 'react';
+import React, {
+  ComponentRef,
+  forwardRef,
+  Ref,
+  useImperativeHandle,
+  useRef,
+} from 'react';
 import { Image, StyleSheet } from 'react-native';
-import type { StackHeaderConfigProps } from './StackHeaderConfig.types';
+import type {
+  StackHeaderConfigProps,
+  StackHeaderConfigRef,
+} from './StackHeaderConfig.types';
 import StackHeaderConfigAndroidNativeComponent, {
   Commands as StackHeaderConfigAndroidNativeCommands,
 } from '../../../../fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent';
-import type { NativeProps as StackHeaderConfigAndroidNativeComponentProps } from '../../../../fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent';
+import type {
+  NativeProps as StackHeaderConfigAndroidNativeComponentProps,
+  ToolbarMenuItemOptionsAndroid as NativeToolbarMenuItemOptionsAndroid,
+} from '../../../../fabric/gamma/stack/StackHeaderConfigAndroidNativeComponent';
 import StackHeaderSubview from './android/StackHeaderSubview.android';
 import type {
   StackHeaderConfigPropsAndroid,
   StackHeaderTypeAndroid,
+  ToolbarMenuItemOptionsAndroid,
 } from './StackHeaderConfig.android.types';
 
 /**
  * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
  */
-function StackHeaderConfig(props: StackHeaderConfigProps) {
+function StackHeaderConfig(
+  props: StackHeaderConfigProps,
+  forwardedRef: Ref<StackHeaderConfigRef>,
+) {
   // ios props are safely dropped
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const { android, ios, ...baseProps } = props;
 
-  const ref = useRef<ComponentRef<
-    typeof StackHeaderConfigAndroidNativeComponent
-  > | null>(null);
-
-  useEffect(() => {
-    const handle = setTimeout(() => {
-      if (!ref.current) {
-        return;
-      }
-
-      StackHeaderConfigAndroidNativeCommands.setToolbarMenuItemOptions(
-        ref.current,
-        'someItemId',
-        [
-          {
-            title: 'Hello!',
-          },
-        ],
-      );
-    }, 5000);
-
-    return () => clearTimeout(handle);
-  }, []);
+  const ref = useHeaderConfigRef(forwardedRef);
 
   const {
     backgroundSubview,
@@ -54,6 +48,7 @@ function StackHeaderConfig(props: StackHeaderConfigProps) {
     scrollFlagEnterAlwaysCollapsed,
     scrollFlagExitUntilCollapsed,
     scrollFlagSnap,
+    onToolbarMenuItemClicked,
     ...filteredAndroidProps
   } = android ?? {};
 
@@ -66,6 +61,11 @@ function StackHeaderConfig(props: StackHeaderConfigProps) {
     scrollFlagSnap,
   });
 
+  const nativeOnToolbarMenuItemClicked = onToolbarMenuItemClicked
+    ? (event: { nativeEvent: { id: string } }) =>
+        onToolbarMenuItemClicked(event.nativeEvent.id)
+    : undefined;
+
   return (
     <StackHeaderConfigAndroidNativeComponent
       ref={ref}
@@ -74,7 +74,8 @@ function StackHeaderConfig(props: StackHeaderConfigProps) {
       {...baseProps}
       {...filteredAndroidProps}
       {...backButtonIconProps}
-      {...scrollFlagProps}>
+      {...scrollFlagProps}
+      onToolbarMenuItemClicked={nativeOnToolbarMenuItemClicked}>
       {/*
         Please note that the order of the subviews MUST match
         the order in native StackHeaderConfig.getConfigSubviewAt.
@@ -190,4 +191,49 @@ function resolveScrollFlags(
   };
 }
 
-export default StackHeaderConfig;
+function useHeaderConfigRef(forwardedRef: Ref<StackHeaderConfigRef>) {
+  const ref =
+    useRef<ComponentRef<typeof StackHeaderConfigAndroidNativeComponent>>(null);
+
+  useImperativeHandle(forwardedRef, () => ({
+    android: {
+      setToolbarMenuItemOptions: (id, options) => {
+        if (!ref.current) {
+          console.warn(
+            '[RNScreens] Reference to native header config component has not been updated yet.',
+          );
+          return;
+        }
+
+        StackHeaderConfigAndroidNativeCommands.setToolbarMenuItemOptions(
+          ref.current,
+          id,
+          parseToolbarMenuItemOptionsToNativeProps(options),
+        );
+      },
+    },
+  }));
+
+  return ref;
+}
+
+// Doesn't support nested props.
+function parseToolbarMenuItemOptionsToNativeProps(
+  options: ToolbarMenuItemOptionsAndroid,
+): NativeToolbarMenuItemOptionsAndroid[] {
+  const nativeOptions: NativeToolbarMenuItemOptionsAndroid = Object.fromEntries(
+    Object.entries(options).map(([key, value]) => [
+      key,
+      // We need to replace explicit `undefined` with `null`
+      // so that we're able to read that information on the native side.
+      value === undefined ? null : value,
+    ]),
+  );
+
+  // For some reason Codegen requires passing an array (we can't use plain object).
+  return [nativeOptions];
+}
+
+export default forwardRef<StackHeaderConfigRef, StackHeaderConfigProps>(
+  StackHeaderConfig,
+);
diff --git a/src/components/gamma/stack/header/StackHeaderConfig.android.types.ts b/src/components/gamma/stack/header/StackHeaderConfig.android.types.ts
index 134f74ea43..c4aabf6da3 100644
--- a/src/components/gamma/stack/header/StackHeaderConfig.android.types.ts
+++ b/src/components/gamma/stack/header/StackHeaderConfig.android.types.ts
@@ -61,6 +61,23 @@ export interface StackHeaderBackgroundSubviewAndroid {
   Component: NonNullable<ReactNode>;
 }
 
+export interface ToolbarMenuItemAndroid {
+  id: string;
+  title: string;
+  hidden?: boolean | undefined; // default: false
+}
+
+export type ToolbarMenuItemOptionsAndroid = Partial<
+  Omit<ToolbarMenuItemAndroid, 'id'>
+>;
+
+export interface StackHeaderConfigCommandsAndroid {
+  setToolbarMenuItemOptions: (
+    id: string,
+    options: ToolbarMenuItemOptionsAndroid,
+  ) => void;
+}
+
 export interface StackHeaderConfigPropsAndroid {
   /**
    * @summary Specifies the type of the Material 3 app bar.
@@ -210,4 +227,16 @@ export interface StackHeaderConfigPropsAndroid {
    * @platform android
    */
   scrollFlagSnap?: boolean | undefined;
+  /**
+   * @summary Menu items displayed in the toolbar menu.
+   *
+   * @platform android
+   */
+  toolbarMenuItems?: ToolbarMenuItemAndroid[] | undefined;
+  /**
+   * @summary Callback invoked when a toolbar menu item is clicked.
+   *
+   * @platform android
+   */
+  onToolbarMenuItemClicked?: ((id: string) => void) | undefined;
 }
diff --git a/src/components/gamma/stack/header/StackHeaderConfig.d.ts b/src/components/gamma/stack/header/StackHeaderConfig.d.ts
index 249ff64b2b..0c8f91557c 100644
--- a/src/components/gamma/stack/header/StackHeaderConfig.d.ts
+++ b/src/components/gamma/stack/header/StackHeaderConfig.d.ts
@@ -7,11 +7,16 @@
  */
 
 import React from 'react';
-import { StackHeaderConfigProps } from './StackHeaderConfig.types';
+import type {
+  StackHeaderConfigProps,
+  StackHeaderConfigRef,
+} from './StackHeaderConfig.types';
 
 /**
  * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
  */
-export default function StackHeaderConfig(
-  props: StackHeaderConfigProps,
-): React.JSX.Element;
+declare const StackHeaderConfig: React.ForwardRefExoticComponent<
+  StackHeaderConfigProps & React.RefAttributes<StackHeaderConfigRef>
+>;
+
+export default StackHeaderConfig;
diff --git a/src/components/gamma/stack/header/StackHeaderConfig.ios.types.ts b/src/components/gamma/stack/header/StackHeaderConfig.ios.types.ts
index a260512367..c1e34a8c79 100644
--- a/src/components/gamma/stack/header/StackHeaderConfig.ios.types.ts
+++ b/src/components/gamma/stack/header/StackHeaderConfig.ios.types.ts
@@ -1,2 +1,5 @@
 // eslint-disable-next-line @typescript-eslint/no-empty-interface
 export interface StackHeaderConfigPropsIOS {}
+
+// eslint-disable-next-line @typescript-eslint/no-empty-interface
+export interface StackHeaderConfigCommandsIOS {}
diff --git a/src/components/gamma/stack/header/StackHeaderConfig.types.ts b/src/components/gamma/stack/header/StackHeaderConfig.types.ts
index dc6090a81b..ad2db8739e 100644
--- a/src/components/gamma/stack/header/StackHeaderConfig.types.ts
+++ b/src/components/gamma/stack/header/StackHeaderConfig.types.ts
@@ -1,4 +1,6 @@
+import type { StackHeaderConfigCommandsAndroid } from './StackHeaderConfig.android.types';
 import { StackHeaderConfigPropsAndroid } from './StackHeaderConfig.android.types';
+import type { StackHeaderConfigCommandsIOS } from './StackHeaderConfig.ios.types';
 import { StackHeaderConfigPropsIOS } from './StackHeaderConfig.ios.types';
 
 export interface StackHeaderConfigPropsBase {
@@ -49,3 +51,8 @@ export interface StackHeaderConfigProps extends StackHeaderConfigPropsBase {
   android?: StackHeaderConfigPropsAndroid | undefined;
   ios?: StackHeaderConfigPropsIOS | undefined;
 }
+
+export interface StackHeaderConfigRef {
+  android?: StackHeaderConfigCommandsAndroid;
+  ios?: StackHeaderConfigCommandsIOS;
+}
diff --git a/src/components/gamma/stack/index.ts b/src/components/gamma/stack/index.ts
index 00899c11cc..f820416353 100644
--- a/src/components/gamma/stack/index.ts
+++ b/src/components/gamma/stack/index.ts
@@ -16,14 +16,19 @@ export type {
 export type {
   StackHeaderConfigPropsBase,
   StackHeaderConfigProps,
+  StackHeaderConfigRef,
   // Android
   StackHeaderTypeAndroid,
   StackHeaderBackgroundSubviewCollapseModeAndroid,
   StackHeaderToolbarSubviewAndroid,
   StackHeaderBackgroundSubviewAndroid,
   StackHeaderConfigPropsAndroid,
+  StackHeaderConfigCommandsAndroid,
+  ToolbarMenuItemAndroid,
+  ToolbarMenuItemOptionsAndroid,
   // iOS
   StackHeaderConfigPropsIOS,
+  StackHeaderConfigCommandsIOS,
 } from './header';
 
 /**

From 0e236089688bd08856424c77449bef55917a5465 Mon Sep 17 00:00:00 2001
From: Krzysztof Ligarski <krzysztof.ligarski@swmansion.com>
Date: Tue, 5 May 2026 10:33:50 +0200
Subject: [PATCH 4/5] refactor config change listener into delegate with menu
 item update method

---
 .../stack/header/StackHeaderCoordinator.kt    |  6 +++
 .../header/StackHeaderCoordinatorLayout.kt    | 38 +++++++++++--------
 .../config/OnHeaderConfigChangeListener.kt    |  5 ---
 .../stack/header/config/StackHeaderConfig.kt  | 21 ++++++++--
 .../config/StackHeaderConfigDelegate.kt       |  8 ++++
 .../config/StackHeaderConfigProviding.kt      |  6 ++-
 .../StackHeaderToolbarMenuItemConfig.kt       |  7 ++++
 .../StackHeaderToolbarMenuItemFieldUpdate.kt  | 23 +++++++++++
 .../StackHeaderToolbarMenuItemOptions.kt      |  6 +++
 .../StackHeaderToolbarMenuItemClickedEvent.kt | 30 +++++++++++++++
 10 files changed, 125 insertions(+), 25 deletions(-)
 delete mode 100644 android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/OnHeaderConfigChangeListener.kt
 create mode 100644 android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigDelegate.kt
 create mode 100644 android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemConfig.kt
 create mode 100644 android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemFieldUpdate.kt
 create mode 100644 android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemOptions.kt
 create mode 100644 android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/event/StackHeaderToolbarMenuItemClickedEvent.kt

diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinator.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinator.kt
index 03a1f79238..da2dd8edd2 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinator.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinator.kt
@@ -29,6 +29,7 @@ import com.swmansion.rnscreens.gamma.stack.header.config.StackHeaderType
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubview
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubviewCollapseMode
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubviewProviding
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemOptions
 import com.swmansion.rnscreens.utils.resolveDrawableAttr
 
 internal class StackHeaderCoordinator(
@@ -581,6 +582,11 @@ internal class StackHeaderCoordinator(
         }
     }
 
+    internal fun handleMenuItemUpdate(
+        id: String,
+        options: StackHeaderToolbarMenuItemOptions,
+    ) = Unit
+
     private fun resolveDefaultBackButtonIcon(): Drawable? = resolveDrawableAttr(wrappedContext, androidx.appcompat.R.attr.homeAsUpIndicator)
 
     companion object {
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinatorLayout.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinatorLayout.kt
index eb5ece9069..21b58fb1d4 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinatorLayout.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinatorLayout.kt
@@ -8,8 +8,9 @@ import androidx.activity.OnBackPressedDispatcherOwner
 import androidx.coordinatorlayout.widget.CoordinatorLayout
 import com.facebook.react.bridge.ReactContext
 import com.swmansion.rnscreens.gamma.stack.header.config.OnHeaderConfigAttachListener
-import com.swmansion.rnscreens.gamma.stack.header.config.OnHeaderConfigChangeListener
+import com.swmansion.rnscreens.gamma.stack.header.config.StackHeaderConfigDelegate
 import com.swmansion.rnscreens.gamma.stack.header.config.StackHeaderConfigProviding
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemOptions
 import com.swmansion.rnscreens.gamma.stack.screen.StackScreen
 import java.lang.ref.WeakReference
 
@@ -36,7 +37,7 @@ internal class StackHeaderCoordinatorLayout(
 
     /**
      * This callback is used to detect when header config is attached.
-     * This allows us to configure listener for header config changes.
+     * This allows us to configure the delegate for header config interactions.
      */
     private val onHeaderConfigAttach =
         OnHeaderConfigAttachListener { config ->
@@ -46,20 +47,27 @@ internal class StackHeaderCoordinatorLayout(
     private var isHeaderUpdatePending = false
 
     /**
-     * This callback is used to listen for header config changes.
-     * We use [isHeaderUpdatePending] to batch changes and pass them to [headerCoordinator].
+     * Single delegate that owns all interactions flowing from [StackHeaderConfig] to this layout.
+     * [onConfigChange] is batched via [post] to coalesce rapid updates.
+     * [onMenuItemUpdate] is dispatched immediately — commands must not be deferred.
      */
-    private val onHeaderConfigChange =
-        OnHeaderConfigChangeListener {
-            if (!isHeaderUpdatePending) {
-                isHeaderUpdatePending = true
-                // Read currentConfig when the runnable executes, not when it's posted,
-                // to avoid applying a stale config that was swapped out in the meantime.
-                post {
-                    isHeaderUpdatePending = false
-                    headerCoordinator.applyHeaderConfig(this, currentConfig)
+    private val headerConfigDelegate =
+        object : StackHeaderConfigDelegate {
+            override fun onConfigChange(config: StackHeaderConfigProviding) {
+                if (!isHeaderUpdatePending) {
+                    isHeaderUpdatePending = true
+                    // Read currentConfig when the runnable executes, not when it's posted,
+                    // to avoid applying a stale config that was swapped out in the meantime.
+                    post {
+                        isHeaderUpdatePending = false
+                        headerCoordinator.applyHeaderConfig(this@StackHeaderCoordinatorLayout, currentConfig)
+                    }
                 }
             }
+
+            override fun onMenuItemUpdate(id: String, options: StackHeaderToolbarMenuItemOptions) {
+                headerCoordinator.handleMenuItemUpdate(id, options)
+            }
         }
 
     private var currentConfig: StackHeaderConfigProviding? = null
@@ -88,10 +96,10 @@ internal class StackHeaderCoordinatorLayout(
 
     private fun handleHeaderConfigAttach(config: StackHeaderConfigProviding?) {
         // Disconnect old config to prevent spurious updates from a detached config
-        currentConfig?.setOnConfigChangeListener(null)
+        currentConfig?.setDelegate(null)
         currentConfig = config
 
-        config?.setOnConfigChangeListener(onHeaderConfigChange)
+        config?.setDelegate(headerConfigDelegate)
 
         // We run this even if config is null to properly remove the header if config
         // is removed in runtime.
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/OnHeaderConfigChangeListener.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/OnHeaderConfigChangeListener.kt
deleted file mode 100644
index c597482ea7..0000000000
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/OnHeaderConfigChangeListener.kt
+++ /dev/null
@@ -1,5 +0,0 @@
-package com.swmansion.rnscreens.gamma.stack.header.config
-
-fun interface OnHeaderConfigChangeListener {
-    fun onHeaderConfigChange(config: StackHeaderConfigProviding)
-}
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfig.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfig.kt
index 74f3e56533..0b2c7853d9 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfig.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfig.kt
@@ -4,6 +4,7 @@ import android.annotation.SuppressLint
 import android.graphics.drawable.Drawable
 import android.util.LayoutDirection
 import com.facebook.react.bridge.ReactContext
+import com.facebook.react.uimanager.UIManagerHelper
 import com.facebook.react.views.view.ReactViewGroup
 import com.swmansion.rnscreens.gamma.common.ShadowStateProxy
 import com.swmansion.rnscreens.gamma.helpers.getSystemDrawableResource
@@ -11,6 +12,9 @@ import com.swmansion.rnscreens.gamma.helpers.loadImage
 import com.swmansion.rnscreens.gamma.stack.header.subview.OnStackHeaderSubviewChangeListener
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubview
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubviewType
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemConfig
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.event.StackHeaderToolbarMenuItemClickedEvent
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemOptions
 import java.lang.ref.WeakReference
 
 @SuppressLint("ViewConstructor")
@@ -45,6 +49,9 @@ class StackHeaderConfig(
     override var scrollFlagSnap: Boolean = false
         internal set
 
+    override var toolbarMenuItems: List<StackHeaderToolbarMenuItemConfig> = emptyList()
+        internal set
+
     // Staging fields for back button icon resolution.
     // Both props may arrive in any order within a single update batch.
     // Resolution happens in resolveBackButtonIconIfNeeded(), called from onAfterUpdateTransaction.
@@ -109,14 +116,20 @@ class StackHeaderConfig(
         )
     }
 
-    private var onConfigChangeListener: WeakReference<OnHeaderConfigChangeListener>? = null
+    override fun onMenuItemClick(id: String) = Unit
+
+    private var delegate: WeakReference<StackHeaderConfigDelegate>? = null
 
-    override fun setOnConfigChangeListener(listener: OnHeaderConfigChangeListener?) {
-        onConfigChangeListener = listener?.let { WeakReference(it) }
+    override fun setDelegate(delegate: StackHeaderConfigDelegate?) {
+        this.delegate = delegate?.let { WeakReference(it) }
     }
 
     internal fun notifyConfigChanged() {
-        onConfigChangeListener?.get()?.onHeaderConfigChange(this)
+        delegate?.get()?.onConfigChange(this)
+    }
+
+    internal fun dispatchMenuItemUpdate(id: String, options: StackHeaderToolbarMenuItemOptions) {
+        delegate?.get()?.onMenuItemUpdate(id, options)
     }
 
     override fun onStackHeaderSubviewChange() = notifyConfigChanged()
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigDelegate.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigDelegate.kt
new file mode 100644
index 0000000000..760bc2fd77
--- /dev/null
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigDelegate.kt
@@ -0,0 +1,8 @@
+package com.swmansion.rnscreens.gamma.stack.header.config
+
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemOptions
+
+interface StackHeaderConfigDelegate {
+    fun onConfigChange(config: StackHeaderConfigProviding)
+    fun onMenuItemUpdate(id: String, options: StackHeaderToolbarMenuItemOptions)
+}
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigProviding.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigProviding.kt
index abda960a8a..e1a6321704 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigProviding.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigProviding.kt
@@ -2,6 +2,7 @@ package com.swmansion.rnscreens.gamma.stack.header.config
 
 import android.graphics.drawable.Drawable
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubviewProviding
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemConfig
 
 interface StackHeaderConfigProviding {
     val type: StackHeaderType
@@ -20,6 +21,7 @@ interface StackHeaderConfigProviding {
     val centerSubview: StackHeaderSubviewProviding?
     val trailingSubview: StackHeaderSubviewProviding?
     val backgroundSubview: StackHeaderSubviewProviding?
+    val toolbarMenuItems: List<StackHeaderToolbarMenuItemConfig>
 
     val isRTL: Boolean
 
@@ -29,5 +31,7 @@ interface StackHeaderConfigProviding {
         contentOffsetY: Int,
     )
 
-    fun setOnConfigChangeListener(listener: OnHeaderConfigChangeListener?)
+    fun onMenuItemClick(id: String)
+
+    fun setDelegate(delegate: StackHeaderConfigDelegate?)
 }
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemConfig.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemConfig.kt
new file mode 100644
index 0000000000..4ab74ee17d
--- /dev/null
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemConfig.kt
@@ -0,0 +1,7 @@
+package com.swmansion.rnscreens.gamma.stack.header.toolbar
+
+data class StackHeaderToolbarMenuItemConfig(
+    val id: String,
+    val title: String,
+    val hidden: Boolean,
+)
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemFieldUpdate.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemFieldUpdate.kt
new file mode 100644
index 0000000000..ec2c5f7302
--- /dev/null
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemFieldUpdate.kt
@@ -0,0 +1,23 @@
+package com.swmansion.rnscreens.gamma.stack.header.toolbar
+
+import com.facebook.react.bridge.ReadableMap
+
+sealed interface StackHeaderToolbarMenuItemFieldUpdate<out T> {
+    data object Absent : StackHeaderToolbarMenuItemFieldUpdate<Nothing>
+    data object Reset : StackHeaderToolbarMenuItemFieldUpdate<Nothing>
+    data class Set<T>(val value: T) : StackHeaderToolbarMenuItemFieldUpdate<T>
+}
+
+internal fun readStringUpdate(map: ReadableMap, key: String): StackHeaderToolbarMenuItemFieldUpdate<String> =
+    when {
+        !map.hasKey(key) -> StackHeaderToolbarMenuItemFieldUpdate.Absent
+        map.isNull(key) -> StackHeaderToolbarMenuItemFieldUpdate.Reset
+        else -> StackHeaderToolbarMenuItemFieldUpdate.Set(map.getString(key)!!)
+    }
+
+internal fun readBooleanUpdate(map: ReadableMap, key: String): StackHeaderToolbarMenuItemFieldUpdate<Boolean> =
+    when {
+        !map.hasKey(key) -> StackHeaderToolbarMenuItemFieldUpdate.Absent
+        map.isNull(key) -> StackHeaderToolbarMenuItemFieldUpdate.Reset
+        else -> StackHeaderToolbarMenuItemFieldUpdate.Set(map.getBoolean(key))
+    }
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemOptions.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemOptions.kt
new file mode 100644
index 0000000000..b52fd538a4
--- /dev/null
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemOptions.kt
@@ -0,0 +1,6 @@
+package com.swmansion.rnscreens.gamma.stack.header.toolbar
+
+data class StackHeaderToolbarMenuItemOptions(
+    val title: StackHeaderToolbarMenuItemFieldUpdate<String>,
+    val hidden: StackHeaderToolbarMenuItemFieldUpdate<Boolean>,
+)
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/event/StackHeaderToolbarMenuItemClickedEvent.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/event/StackHeaderToolbarMenuItemClickedEvent.kt
new file mode 100644
index 0000000000..be71f8fe30
--- /dev/null
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/event/StackHeaderToolbarMenuItemClickedEvent.kt
@@ -0,0 +1,30 @@
+package com.swmansion.rnscreens.gamma.stack.header.toolbar.event
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.uimanager.events.Event
+import com.swmansion.rnscreens.gamma.common.event.NamingAwareEventType
+
+class StackHeaderToolbarMenuItemClickedEvent(
+    surfaceId: Int,
+    viewTag: Int,
+    private val id: String,
+) : Event<StackHeaderToolbarMenuItemClickedEvent>(surfaceId, viewTag), NamingAwareEventType {
+    override fun getEventName() = EVENT_NAME
+
+    override fun getEventRegistrationName() = EVENT_REGISTRATION_NAME
+
+    override fun canCoalesce(): Boolean = false
+
+    override fun getEventData() = Arguments.createMap().apply { putString(EK_ID, id) }
+
+    companion object : NamingAwareEventType {
+        const val EVENT_NAME = "topToolbarMenuItemClicked"
+        const val EVENT_REGISTRATION_NAME = "onToolbarMenuItemClicked"
+
+        private const val EK_ID = "id"
+
+        override fun getEventName() = EVENT_NAME
+
+        override fun getEventRegistrationName() = EVENT_REGISTRATION_NAME
+    }
+}
\ No newline at end of file

From 5b0db9ee37da29ae8db1a486508272492a32500f Mon Sep 17 00:00:00 2001
From: Krzysztof Ligarski <krzysztof.ligarski@swmansion.com>
Date: Tue, 5 May 2026 11:23:30 +0200
Subject: [PATCH 5/5] handle updates and events

---
 .../stack/header/StackHeaderCoordinator.kt    | 19 +++-
 .../stack/header/config/StackHeaderConfig.kt  | 13 ++-
 .../config/StackHeaderConfigEventEmitter.kt   | 16 ++++
 .../config/StackHeaderConfigViewManager.kt    | 58 +++++++++++-
 .../StackHeaderToolbarMenuCoordinator.kt      | 88 +++++++++++++++++++
 .../StackHeaderToolbarMenuItemFieldUpdate.kt  | 16 ----
 6 files changed, 188 insertions(+), 22 deletions(-)
 create mode 100644 android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigEventEmitter.kt
 create mode 100644 android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuCoordinator.kt

diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinator.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinator.kt
index da2dd8edd2..872c5603e4 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinator.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/StackHeaderCoordinator.kt
@@ -29,6 +29,7 @@ import com.swmansion.rnscreens.gamma.stack.header.config.StackHeaderType
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubview
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubviewCollapseMode
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubviewProviding
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuCoordinator
 import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemOptions
 import com.swmansion.rnscreens.utils.resolveDrawableAttr
 
@@ -47,6 +48,11 @@ internal class StackHeaderCoordinator(
     private var appBarLayout: StackHeaderAppBarLayout? = null
     private var currentConfig: StackHeaderConfigProviding? = null
 
+    private val toolbarMenuCoordinator =
+        StackHeaderToolbarMenuCoordinator { id ->
+            currentConfig?.onMenuItemClick(id)
+        }
+
     // Cached values used by requiresRebuild() to detect when the header
     // hierarchy needs to be torn down and recreated.
     private var lastHeaderType: StackHeaderType? = null
@@ -164,6 +170,7 @@ internal class StackHeaderCoordinator(
         lastBackButtonIcon = null
         lastScrollFlags = null
         clearCachedRebuildTriggers()
+        toolbarMenuCoordinator.clear()
     }
 
     private fun cacheRebuildTriggers(config: StackHeaderConfigProviding) {
@@ -334,6 +341,14 @@ internal class StackHeaderCoordinator(
 
         applyScrollFlags(appBar, config)
         applyBackButton(appBar.toolbar, config)
+        applyToolbarMenu(appBar.toolbar, config)
+    }
+
+    private fun applyToolbarMenu(
+        toolbar: MaterialToolbar,
+        config: StackHeaderConfigProviding,
+    ) {
+        toolbarMenuCoordinator.buildMenu(toolbar, config.toolbarMenuItems)
     }
 
     private fun applyBackgroundCollapseMode(config: StackHeaderConfigProviding) {
@@ -585,7 +600,9 @@ internal class StackHeaderCoordinator(
     internal fun handleMenuItemUpdate(
         id: String,
         options: StackHeaderToolbarMenuItemOptions,
-    ) = Unit
+    ) {
+        toolbarMenuCoordinator.updateItem(id, options)
+    }
 
     private fun resolveDefaultBackButtonIcon(): Drawable? = resolveDrawableAttr(wrappedContext, androidx.appcompat.R.attr.homeAsUpIndicator)
 
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfig.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfig.kt
index 0b2c7853d9..8ca3f7c08e 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfig.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfig.kt
@@ -4,7 +4,6 @@ import android.annotation.SuppressLint
 import android.graphics.drawable.Drawable
 import android.util.LayoutDirection
 import com.facebook.react.bridge.ReactContext
-import com.facebook.react.uimanager.UIManagerHelper
 import com.facebook.react.views.view.ReactViewGroup
 import com.swmansion.rnscreens.gamma.common.ShadowStateProxy
 import com.swmansion.rnscreens.gamma.helpers.getSystemDrawableResource
@@ -13,7 +12,6 @@ import com.swmansion.rnscreens.gamma.stack.header.subview.OnStackHeaderSubviewCh
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubview
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubviewType
 import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemConfig
-import com.swmansion.rnscreens.gamma.stack.header.toolbar.event.StackHeaderToolbarMenuItemClickedEvent
 import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemOptions
 import java.lang.ref.WeakReference
 
@@ -116,7 +114,16 @@ class StackHeaderConfig(
         )
     }
 
-    override fun onMenuItemClick(id: String) = Unit
+    internal lateinit var eventEmitter: StackHeaderConfigEventEmitter
+
+    internal fun onViewManagerAddEventEmitters() {
+        check(id != NO_ID) { "[RNScreens] StackHeaderConfig must have its tag set when registering event emitters" }
+        eventEmitter = StackHeaderConfigEventEmitter(reactContext, id)
+    }
+
+    override fun onMenuItemClick(id: String) {
+        eventEmitter.emitOnToolbarMenuItemClicked(id)
+    }
 
     private var delegate: WeakReference<StackHeaderConfigDelegate>? = null
 
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigEventEmitter.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigEventEmitter.kt
new file mode 100644
index 0000000000..4f7dc312cb
--- /dev/null
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigEventEmitter.kt
@@ -0,0 +1,16 @@
+package com.swmansion.rnscreens.gamma.stack.header.config
+
+import com.facebook.react.bridge.ReactContext
+import com.swmansion.rnscreens.gamma.common.event.BaseEventEmitter
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.event.StackHeaderToolbarMenuItemClickedEvent
+
+internal class StackHeaderConfigEventEmitter(
+    reactContext: ReactContext,
+    viewTag: Int,
+) : BaseEventEmitter(reactContext, viewTag) {
+    internal fun emitOnToolbarMenuItemClicked(id: String) {
+        reactEventDispatcher.dispatchEvent(
+            StackHeaderToolbarMenuItemClickedEvent(surfaceId, viewTag, id),
+        )
+    }
+}
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
index 6ba16cdbee..de902f87be 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/config/StackHeaderConfigViewManager.kt
@@ -13,6 +13,9 @@ import com.facebook.react.uimanager.ViewManagerDelegate
 import com.facebook.react.viewmanagers.RNSStackHeaderConfigAndroidManagerDelegate
 import com.facebook.react.viewmanagers.RNSStackHeaderConfigAndroidManagerInterface
 import com.swmansion.rnscreens.gamma.stack.header.subview.StackHeaderSubview
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemConfig
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemFieldUpdate
+import com.swmansion.rnscreens.gamma.stack.header.toolbar.StackHeaderToolbarMenuItemOptions
 
 @ReactModule(name = StackHeaderConfigViewManager.REACT_CLASS)
 open class StackHeaderConfigViewManager :
@@ -28,6 +31,14 @@ open class StackHeaderConfigViewManager :
 
     override fun createViewInstance(reactContext: ThemedReactContext) = StackHeaderConfig(reactContext)
 
+    override fun addEventEmitters(
+        reactContext: ThemedReactContext,
+        view: StackHeaderConfig,
+    ) {
+        super.addEventEmitters(reactContext, view)
+        view.onViewManagerAddEventEmitters()
+    }
+
     override fun getDelegate(): ViewManagerDelegate<StackHeaderConfig> = delegate
 
     /**
@@ -190,17 +201,60 @@ open class StackHeaderConfigViewManager :
     override fun setToolbarMenuItems(
         view: StackHeaderConfig,
         value: ReadableArray?,
-    ) = Unit
+    ) {
+        view.toolbarMenuItems =
+            value?.let { array ->
+                (0 until array.size()).map { i ->
+                    val item = requireNotNull(array.getMap(i))
+                    StackHeaderToolbarMenuItemConfig(
+                        id = item.requireNotNullString("id"),
+                        title = item.requireNotNullString("title"),
+                        hidden = item.getBoolean("hidden"),
+                    )
+                }
+            } ?: emptyList()
+    }
 
     override fun setToolbarMenuItemOptions(
         view: StackHeaderConfig,
         id: String,
         options: ReadableArray,
     ) {
-        println("[StackHeaderConfigViewManager] $id: ${options.getMap(0)}")
+        val map = options.getMap(0) ?: return
+        view.dispatchMenuItemUpdate(
+            id,
+            StackHeaderToolbarMenuItemOptions(
+                title = map.readStringFieldUpdate("title"),
+                hidden = map.readBooleanFieldUpdate("hidden"),
+            ),
+        )
     }
 
     companion object {
         const val REACT_CLASS = "RNSStackHeaderConfigAndroid"
     }
 }
+
+private fun ReadableMap.requireNotNullString(key: String): String {
+    return requireNotNull(this.getString(key)) {
+        "[RNScreens] toolbarMenuItem $key property must not be null."
+    }
+}
+
+private fun ReadableMap.readStringFieldUpdate(
+    key: String,
+): StackHeaderToolbarMenuItemFieldUpdate<String> =
+    when {
+        !this.hasKey(key) -> StackHeaderToolbarMenuItemFieldUpdate.Absent
+        this.isNull(key) -> StackHeaderToolbarMenuItemFieldUpdate.Reset
+        else -> StackHeaderToolbarMenuItemFieldUpdate.Set(this.getString(key)!!)
+    }
+
+private fun ReadableMap.readBooleanFieldUpdate(
+    key: String,
+): StackHeaderToolbarMenuItemFieldUpdate<Boolean> =
+    when {
+        !this.hasKey(key) -> StackHeaderToolbarMenuItemFieldUpdate.Absent
+        this.isNull(key) -> StackHeaderToolbarMenuItemFieldUpdate.Reset
+        else -> StackHeaderToolbarMenuItemFieldUpdate.Set(this.getBoolean(key))
+    }
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuCoordinator.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuCoordinator.kt
new file mode 100644
index 0000000000..9ef719b248
--- /dev/null
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuCoordinator.kt
@@ -0,0 +1,88 @@
+package com.swmansion.rnscreens.gamma.stack.header.toolbar
+
+import android.util.Log
+import android.view.Menu
+import com.google.android.material.appbar.MaterialToolbar
+
+internal class StackHeaderToolbarMenuCoordinator(
+    private val onItemClicked: (id: String) -> Unit,
+) {
+    private var currentMenu: Menu? = null
+    private val forwardIdMap = HashMap<String, Int>()
+    private val reverseIdMap = HashMap<Int, String>()
+    private var lastMenuItems: List<StackHeaderToolbarMenuItemConfig> = emptyList()
+
+    internal fun buildMenu(
+        toolbar: MaterialToolbar,
+        items: List<StackHeaderToolbarMenuItemConfig>,
+    ) {
+        if (items == lastMenuItems) return
+
+        toolbar.menu.clear()
+        forwardIdMap.clear()
+        reverseIdMap.clear()
+
+        items.forEachIndexed { index, item ->
+            // We use IDs > 0 because 0 is Menu.NONE.
+            val nativeId = index + 1
+            forwardIdMap[item.id] = nativeId
+            reverseIdMap[nativeId] = item.id
+            toolbar.menu
+                .add(Menu.NONE, nativeId, index, item.title)
+                .apply {
+                    isVisible = !item.hidden
+
+                    // This property will be exposed to the user in the future
+                    setShowAsAction(android.view.MenuItem.SHOW_AS_ACTION_NEVER)
+                }
+        }
+
+        toolbar.setOnMenuItemClickListener { menuItem ->
+            reverseIdMap[menuItem.itemId]?.let(onItemClicked)
+            true
+        }
+
+        currentMenu = toolbar.menu
+        lastMenuItems = items
+    }
+
+    fun clear() {
+        currentMenu?.clear()
+        currentMenu = null
+        forwardIdMap.clear()
+        reverseIdMap.clear()
+        lastMenuItems = emptyList()
+    }
+
+    fun updateItem(
+        id: String,
+        options: StackHeaderToolbarMenuItemOptions,
+    ) {
+        val menu = currentMenu
+        if (menu == null) {
+            Log.e(TAG, "[RNScreens] Attempted to update item in non-existing menu.")
+            return
+        }
+
+        val item = forwardIdMap[id]?.let { menu.findItem(it) } ?: run {
+            Log.e(TAG, "[RNScreens] Unable to find menu item.")
+            return
+        }
+
+        when (val title = options.title) {
+            StackHeaderToolbarMenuItemFieldUpdate.Absent -> Unit
+            StackHeaderToolbarMenuItemFieldUpdate.Reset -> item.title = ""
+            is StackHeaderToolbarMenuItemFieldUpdate.Set -> item.title = title.value
+        }
+
+        when (val hidden = options.hidden) {
+            StackHeaderToolbarMenuItemFieldUpdate.Absent -> Unit
+            StackHeaderToolbarMenuItemFieldUpdate.Reset -> item.isVisible = true
+            is StackHeaderToolbarMenuItemFieldUpdate.Set -> item.isVisible = !hidden.value
+        }
+    }
+
+    companion object {
+        private const val TAG = "StackHeaderToolbarMenuCoordinator"
+    }
+}
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemFieldUpdate.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemFieldUpdate.kt
index ec2c5f7302..bb3532f679 100644
--- a/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemFieldUpdate.kt
+++ b/android/src/main/java/com/swmansion/rnscreens/gamma/stack/header/toolbar/StackHeaderToolbarMenuItemFieldUpdate.kt
@@ -1,23 +1,7 @@
 package com.swmansion.rnscreens.gamma.stack.header.toolbar
 
-import com.facebook.react.bridge.ReadableMap
-
 sealed interface StackHeaderToolbarMenuItemFieldUpdate<out T> {
     data object Absent : StackHeaderToolbarMenuItemFieldUpdate<Nothing>
     data object Reset : StackHeaderToolbarMenuItemFieldUpdate<Nothing>
     data class Set<T>(val value: T) : StackHeaderToolbarMenuItemFieldUpdate<T>
 }
-
-internal fun readStringUpdate(map: ReadableMap, key: String): StackHeaderToolbarMenuItemFieldUpdate<String> =
-    when {
-        !map.hasKey(key) -> StackHeaderToolbarMenuItemFieldUpdate.Absent
-        map.isNull(key) -> StackHeaderToolbarMenuItemFieldUpdate.Reset
-        else -> StackHeaderToolbarMenuItemFieldUpdate.Set(map.getString(key)!!)
-    }
-
-internal fun readBooleanUpdate(map: ReadableMap, key: String): StackHeaderToolbarMenuItemFieldUpdate<Boolean> =
-    when {
-        !map.hasKey(key) -> StackHeaderToolbarMenuItemFieldUpdate.Absent
-        map.isNull(key) -> StackHeaderToolbarMenuItemFieldUpdate.Reset
-        else -> StackHeaderToolbarMenuItemFieldUpdate.Set(map.getBoolean(key))
-    }