Header

iOS

import { View } from "react-native"
import { Button } from "@/components/ui/button"
import { Header, HeaderActions, HeaderBack, HeaderTitle } from "@/components/ui/header"
import { Text } from "@/components/ui/text"

export function HeaderExample() {
  return (
    <View className="-mx-4 -mt-4">
      <Header>
        <HeaderBack>Settings</HeaderBack>
        <HeaderTitle>Profile</HeaderTitle>
        <HeaderActions>
          <Button variant="plain" size="sm">
            <Text className="font-semibold">Edit</Text>
          </Button>
        </HeaderActions>
      </Header>
    </View>
  )
}

import EsuissUI
import SwiftUI

struct HeaderExample: View {
  var body: some View {
    Header {
      HeaderTitle("Profile")
    } leading: {
      HeaderBack("Settings")
    } trailing: {
      HeaderActions {
        Button {} label: {
          Text("Edit").fontWeight(.semibold)
        }
        .buttonStyle(.variant(.plain, size: .sm))
      }
    }
    .headerStoryBleed()
  }
}

import androidx.compose.foundation.layout.Column
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.layout.layout
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import com.esuiss.ui.components.Button
import com.esuiss.ui.components.ButtonSize
import com.esuiss.ui.components.ButtonVariant
import com.esuiss.ui.components.Header
import com.esuiss.ui.components.HeaderActions
import com.esuiss.ui.components.HeaderBack
import com.esuiss.ui.components.HeaderTitle
import com.esuiss.ui.components.Text

fun Modifier.headerBleed(): Modifier = layout { measurable, constraints ->
    val inset = 16.dp.roundToPx()
    val width = constraints.maxWidth + inset * 2
    val placeable = measurable.measure(constraints.copy(minWidth = width, maxWidth = width))
    layout(constraints.maxWidth, (placeable.height - inset).coerceAtLeast(0)) {
        placeable.place(-inset, -inset)
    }
}

@Composable
fun HeaderPlainAction(text: String) {
    Button(onClick = {}, variant = ButtonVariant.Plain, size = ButtonSize.Sm) {
        Text(text, style = TextStyle(fontWeight = FontWeight.SemiBold))
    }
}

@Composable
fun HeaderDefault() {
    Column(Modifier.headerBleed()) {
        Header {
            HeaderBack(onClick = {}, text = "Settings")
            HeaderTitle("Profile")
            HeaderActions { HeaderPlainAction("Edit") }
        }
    }
}

Header is a 44-point bar that sorts its children into three slots: HeaderBack and leading HeaderActions on the start side, HeaderTitle in the center, and everything else on the end side. The side slots share the remaining width equally, so the title stays centered.

For a large title, create a scroll state with useHeaderScroll(), pass it to both Header and HeaderScrollView, and put a HeaderLargeTitle at the top of the scroll view. As the large title scrolls away, the small title fades in and a hairline appears under the bar. Pulling down stretches the large title slightly.

Installation

$ pnpm dlx @esuiss/uim@latest add header

The CLI also adds what it builds on: Icon, Text.

Manual

Install the dependencies:

npx expo install cn phosphor-react-native react-native-reanimated react-native-svg react-native-worklets

Add the pieces it builds on: Icon, Text.
Copy the source into components/ui/header.tsx:

uniwind/components/ui/header.tsx

import { cn } from "cn"
import { CaretLeftIcon } from "phosphor-react-native"
import * as React from "react"
import {
  I18nManager,
  Pressable,
  type ScrollViewProps,
  View,
  type ViewProps,
} from "react-native"
import Animated, {
  interpolate,
  type SharedValue,
  useAnimatedScrollHandler,
  useAnimatedStyle,
  useSharedValue,

Update the import paths to match your project.

Install the dependencies:

npx expo install cn phosphor-react-native react-native-reanimated react-native-svg react-native-worklets

Add the pieces it builds on: Icon, Text.
Copy the source into components/ui/header.tsx:

nativewind/components/ui/header.tsx

import { cn } from "cn"
import { CaretLeftIcon } from "phosphor-react-native"
import * as React from "react"
import {
  I18nManager,
  Pressable,
  type ScrollViewProps,
  View,
  type ViewProps,
} from "react-native"
import Animated, {
  interpolate,
  type SharedValue,
  useAnimatedScrollHandler,
  useAnimatedStyle,
  useSharedValue,

Update the import paths to match your project.

Install the dependencies:

npx expo install phosphor-react-native react-native-reanimated react-native-svg react-native-worklets

Add the pieces it builds on: Icon, Text.
Copy the source into components/ui/header.tsx:

stylesheet/components/ui/header.tsx

import { CaretLeftIcon } from "phosphor-react-native"
import * as React from "react"
import {
  I18nManager,
  Pressable,
  type ScrollViewProps,
  type StyleProp,
  StyleSheet,
  type TextStyle,
  View,
  type ViewProps,
  type ViewStyle,
} from "react-native"
import Animated, {
  interpolate,
  type SharedValue,

Update the import paths to match your project.

Target iOS 17 or later.
Add the Swift package to your app:

Package.swift

.package(url: "https://github.com/phosphor-icons/swift", from: "2.1.0")

Copy the theme files every view uses:

swift/Theme/Theme.swift

import SwiftUI
import UIKit

struct RGBA: Sendable {
  let red: CGFloat
  let green: CGFloat
  let blue: CGFloat
  let alpha: CGFloat

  init(_ hex: UInt32, _ alpha: CGFloat = 1) {
    red = CGFloat((hex >> 16) & 0xFF) / 255
    green = CGFloat((hex >> 8) & 0xFF) / 255
    blue = CGFloat(hex & 0xFF) / 255
    self.alpha = alpha
  }

swift/Theme/Tokens.swift

import SwiftUI

extension Color {
  public static let surface = Color.adaptive(light: .init(0xFFFFFF), dark: .init(0x000000))
  public static let surfaceSecondary = Color.adaptive(light: .init(0xF5F5F7), dark: .init(0x161617))
  public static let surfaceTertiary = Color.adaptive(light: .init(0xE8E8ED), dark: .init(0x2C2C2E))
  public static let surfaceRaised = Color.adaptive(light: .init(0xFFFFFF), dark: .init(0x1D1D1F))
  public static let label = Color.adaptive(light: .init(0x1D1D1F), dark: .init(0xF5F5F7))
  public static let labelSecondary = Color.adaptive(light: .init(0x6E6E73), dark: .init(0xA1A1A6))
  public static let labelTertiary = Color.adaptive(light: .init(0x86868B), dark: .init(0x86868B))
  public static let labelQuaternary = Color.adaptive(light: .init(0xD2D2D7), dark: .init(0x424245))
  public static let control = Color.adaptive(light: .init(0x000000, 0.04), dark: .init(0xFFFFFF, 0.1))
  public static let controlPressed = Color.adaptive(light: .init(0x000000, 0.12), dark: .init(0xFFFFFF, 0.22))
  public static let controlSelected = Color.adaptive(light: .init(0x1D1D1F), dark: .init(0xF5F5F7))
  public static let controlDisabled = Color.adaptive(light: .init(0x000000, 0.03), dark: .init(0xFFFFFF, 0.05))
  public static let onControlSelected = Color.adaptive(light: .init(0xFFFFFF), dark: .init(0x000000))

Copy the source and every file it uses:

swift/Components/Header.swift

import PhosphorSwift
import SwiftUI

extension EnvironmentValues {
  @Entry var headerProgress: CGFloat?
  @Entry var headerReport: ((CGFloat) -> Void)?
}

enum HeaderMath {
  static func progress(minY: CGFloat, height: CGFloat) -> CGFloat {
    guard height > 0 else { return 0 }
    return min(max(-minY / height, 0), 1)
  }
}

public struct Header<Title: View, Leading: View, Trailing: View>: View {

swift/Components/Button.swift

import SwiftUI

public struct VariantButtonStyle: ButtonStyle {
  public enum Variant: CaseIterable, Sendable {
    case `default`, outline, secondary, tinted, ghost, plain, destructive, link
  }

  public enum Size: CaseIterable, Sendable {
    case `default`, xs, sm, lg, xl, icon, iconXs, iconSm, iconLg, iconXl

    var height: CGFloat {
      switch self {
      case .xs, .iconXs: 24
      case .sm, .iconSm: 32
      case .default, .icon: 36
      case .lg, .iconLg: 44

swift/Components/ButtonGroup.swift

import SwiftUI

extension EnvironmentValues {
  @Entry var buttonGroup: Axis? = nil
  @Entry var buttonGroupSize: CGSize = .zero
}

enum ButtonGroupSpace: Hashable {
  case group
}

struct ButtonGroupFrame {
  let bounds: Anchor<CGRect>
  let outlined: Bool
}

swift/Components/Checkbox.swift

import PhosphorSwift
import SwiftUI

extension Shadow {
  static let control = Shadow(color: .black.opacity(0.08), radius: 0.5, y: 0.5)
  static let thumb = Shadow(color: .black.opacity(0.12), radius: 1.5, y: 1)
}

struct SelectionIndicator<Mark: View>: View {
  let checked: Bool
  let pressed: Bool
  let cornerRadius: CGFloat
  let mark: Mark

  @Environment(\.isEnabled) private var isEnabled
  @Environment(\.isInvalid) private var invalid

swift/Components/Field.swift

import SwiftUI

extension EnvironmentValues {
  @Entry public var isInvalid = false
  @Entry var fieldInset = false
  @Entry var fieldGroupInset = false
  @Entry var fieldSetInset = false
}

extension View {
  public func invalid(_ isInvalid: Bool = true) -> some View {
    environment(\.isInvalid, isInvalid)
  }
}

public enum FieldOrientation: CaseIterable, Sendable {

swift/Components/Haptics.swift

import SwiftUI

extension EnvironmentValues {
  @Entry public var hapticsEnabled = true
}

extension View {
  public func haptics(_ enabled: Bool) -> some View {
    environment(\.hapticsEnabled, enabled)
  }

  func hapticFeedback<Trigger: Equatable>(_ feedback: SensoryFeedback, trigger: Trigger) -> some View {
    modifier(HapticFeedbackModifier(feedback: feedback, trigger: trigger) { _, _ in true })
  }

  func hapticFeedback<Trigger: Equatable>(

swift/Components/KeyboardScrollView.swift

import SwiftUI
import UIKit

public struct KeyboardScrollView<Content: View>: View {
  let showsIndicators: Bool
  let content: Content

  public init(showsIndicators: Bool = true, @ViewBuilder content: () -> Content) {
    self.showsIndicators = showsIndicators
    self.content = content()
  }

  public var body: some View {
    ScrollView(.vertical, showsIndicators: showsIndicators) {
      content
        .frame(maxWidth: .infinity, alignment: .topLeading)

swift/Components/Screen.swift

import SwiftUI

extension EnvironmentValues {
  @Entry var screenBackground: Color = .surface
}

public struct Screen<Content: View>: View {
  public enum Background: CaseIterable, Sendable {
    case surface, surfaceSecondary

    var color: Color {
      switch self {
      case .surface: .surface
      case .surfaceSecondary: .surfaceSecondary
      }
    }

swift/Components/Separator.swift

import SwiftUI

public struct Separator: View {
  let orientation: Axis

  public init(_ orientation: Axis = .horizontal) {
    self.orientation = orientation
  }

  public var body: some View {
    Rectangle()
      .fill(Color.separator)
      .frame(width: orientation == .vertical ? 1 : nil, height: orientation == .horizontal ? 1 : nil)
      .frame(maxWidth: orientation == .horizontal ? .infinity : nil, maxHeight: orientation == .vertical ? .infinity : nil)
      .accessibilityHidden(true)
  }

swift/Components/TextVariant.swift

import SwiftUI

public enum TextVariant: CaseIterable, Sendable {
  case `default`, h1, h2, h3, h4, p, blockquote, code, lead, large, small, muted

  var style: TextStyle {
    switch self {
    case .h1: .xl3
    case .h2: .xl2
    case .h3: .xl
    case .h4, .lead, .large: .lg
    case .code, .small, .muted: .sm
    default: .base
    }
  }

Add the files to your app target.

Set minSdk to 24 or higher and add the dependencies:

build.gradle.kts

implementation(platform("androidx.compose:compose-bom:2026.09.00"))
implementation("androidx.compose.foundation:foundation")
implementation("androidx.compose.ui:ui")
implementation("com.adamglin:phosphor-icon-android:1.0.0")

Copy the theme files every view uses:

kotlin/theme/Theme.kt

package com.esuiss.ui.theme

import androidx.compose.foundation.isSystemInDarkTheme
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.Immutable
import androidx.compose.runtime.staticCompositionLocalOf
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.dropShadow
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.Shape
import androidx.compose.ui.graphics.shadow.Shadow as DropShadow
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.text.style.LineHeightStyle
import androidx.compose.ui.unit.Dp
import androidx.compose.ui.unit.DpOffset

kotlin/theme/Tokens.kt

package com.esuiss.ui.theme

import androidx.compose.runtime.Immutable
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.unit.dp

@Immutable
data class Colors(
    val surface: Color,
    val surfaceSecondary: Color,
    val surfaceTertiary: Color,
    val surfaceRaised: Color,
    val label: Color,
    val labelSecondary: Color,
    val labelTertiary: Color,
    val labelQuaternary: Color,

Copy the source and every file it uses:

kotlin/components/Header.kt

package com.esuiss.ui.components

import androidx.compose.animation.core.animate
import androidx.compose.animation.core.animateFloatAsState
import androidx.compose.animation.core.tween
import androidx.compose.foundation.clickable
import androidx.compose.foundation.interaction.MutableInteractionSource
import androidx.compose.foundation.interaction.collectIsPressedAsState
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.RowScope
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.text.BasicText
import androidx.compose.runtime.Composable

kotlin/components/Button.kt

package com.esuiss.ui.components

import androidx.compose.foundation.background
import androidx.compose.foundation.border
import androidx.compose.foundation.clickable
import androidx.compose.foundation.interaction.MutableInteractionSource
import androidx.compose.foundation.interaction.collectIsPressedAsState
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.RowScope
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.shape.CircleShape
import androidx.compose.foundation.shape.RoundedCornerShape

kotlin/components/ButtonGroup.kt

package com.esuiss.ui.components

import androidx.compose.foundation.background
import androidx.compose.foundation.gestures.Orientation
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.RowScope
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.CircleShape
import androidx.compose.foundation.shape.CornerSize
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.Immutable

kotlin/components/Content.kt

package com.esuiss.ui.components

import androidx.compose.runtime.compositionLocalOf
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.unit.Dp
import androidx.compose.ui.unit.dp

val LocalContentStyle = compositionLocalOf { TextStyle.Default }

val LocalContentColor = compositionLocalOf { Color.Unspecified }

val LocalIconSize = compositionLocalOf { 20.dp }

kotlin/components/Icon.kt

package com.esuiss.ui.components

import androidx.compose.foundation.Image
import androidx.compose.foundation.layout.size
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.ColorFilter
import androidx.compose.ui.graphics.takeOrElse
import androidx.compose.ui.graphics.vector.ImageVector
import androidx.compose.ui.unit.Dp
import com.esuiss.ui.theme.EsuissTheme

@Composable
fun Icon(
    imageVector: ImageVector,

Update the com.esuiss.ui package names to match your project.

Usage

import { Header, HeaderTitle, HeaderLargeTitle, HeaderBack, HeaderActions, HeaderScrollView } from "@/components/ui/header"

<View className="-mx-4 -mt-4">
  <Header>
    <HeaderBack>Settings</HeaderBack>
    <HeaderTitle>Profile</HeaderTitle>
    <HeaderActions>
      <Button variant="plain" size="sm">
        <Text className="font-semibold">Edit</Text>
      </Button>
    </HeaderActions>
  </Header>
</View>

HeaderBack shows a caret and an optional text label such as the previous screen's name; wire onPress to your navigation. Group icon buttons in HeaderActions, and set side="leading" to place a group on the start side.

Both HeaderTitle and HeaderLargeTitle accept a subtitle. Plain strings are wrapped in Text and truncated to one line in the bar.

Without a large title, you can still pass the same scroll to Header and HeaderScrollView to show the hairline once content scrolls under the bar.

Examples

Large title

A large title that collapses into the bar on scroll.

iOS

Header (large title) on iOS in light mode

import { MagnifyingGlassIcon, PlusIcon } from "phosphor-react-native"
import { View } from "react-native"
import { Button } from "@/components/ui/button"
import { Header, HeaderActions, HeaderBack, HeaderLargeTitle, HeaderScrollView, HeaderTitle, useHeaderScroll } from "@/components/ui/header"
import { Icon } from "@/components/ui/icon"
import { Text } from "@/components/ui/text"

const messages = [
  "Lunch on Friday?",
  "The draft is ready for review",
  "Photos from the trip",
  "Invoice for September",
  "Your order has shipped",
  "Team sync moved to 3 PM",
  "Weekend plans",
  "Book club picks",
  "Flight confirmation",
  "New comment on your post",
  "Reminder: dentist at 10",
  "Quarterly report",
  "Welcome to the beta",
  "Parking update",
  "Recipe you asked for",
]

function MessageRows() {
  return (
    <View className="px-4">
      {messages.map((message, index) => (
        <View
          key={message}
          className={index > 0 ? "border-t border-separator py-3" : "py-3"}
        >
          <Text numberOfLines={1}>{message}</Text>
        </View>
      ))}
    </View>
  )
}

function TrailingActions() {
  return (
    <HeaderActions>
      <Button variant="ghost" size="icon" accessibilityLabel="Search">
        <Icon as={MagnifyingGlassIcon} className="size-5" />
      </Button>
      <Button variant="ghost" size="icon" accessibilityLabel="New message">
        <Icon as={PlusIcon} className="size-5" />
      </Button>
    </HeaderActions>
  )
}

function LargeTitleDemo({ subtitle }: { subtitle?: string }) {
  const scroll = useHeaderScroll()
  return (
    <View className="-m-4 flex-1">
      <Header scroll={scroll}>
        <HeaderBack>Mailboxes</HeaderBack>
        <HeaderTitle>Inbox</HeaderTitle>
        <TrailingActions />
      </Header>
      <HeaderScrollView scroll={scroll}>
        <HeaderLargeTitle subtitle={subtitle}>Inbox</HeaderLargeTitle>
        <MessageRows />
      </HeaderScrollView>
    </View>
  )
}

export function HeaderLargeTitleExample() {
  return (
    <LargeTitleDemo />
  )
}

import EsuissUI
import PhosphorSwift
import SwiftUI

let headerMessages = [
  "Lunch on Friday?",
  "The draft is ready for review",
  "Photos from the trip",
  "Invoice for September",
  "Your order has shipped",
  "Team sync moved to 3 PM",
  "Weekend plans",
  "Book club picks",
  "Flight confirmation",
  "New comment on your post",
  "Reminder: dentist at 10",
  "Quarterly report",
  "Welcome to the beta",
  "Parking update",
  "Recipe you asked for",
]

extension View {
  func headerStoryBleed() -> some View {
    padding(.horizontal, -16).padding(.top, -16)
  }
}

struct HeaderMessageRows: View {
  var body: some View {
    VStack(alignment: .leading, spacing: 0) {
      ForEach(Array(headerMessages.enumerated()), id: \.offset) { index, message in
        Text(LocalizedStringKey(message))
          .textStyle(.base)
          .foregroundStyle(Color.label)
          .lineLimit(1)
          .padding(.vertical, 12)
          .frame(maxWidth: .infinity, alignment: .leading)
          .overlay(alignment: .top) {
            if index > 0 {
              Color.separator.frame(height: 1)
            }
          }
      }
    }
    .padding(.horizontal, 16)
  }
}

struct HeaderIconButton: View {
  let icon: Image
  let label: LocalizedStringKey

  var body: some View {
    Button {} label: {
      icon.frame(width: 20, height: 20)
    }
    .accessibilityLabel(Text(label))
  }
}

struct HeaderTrailingActions: View {
  var body: some View {
    HeaderActions {
      HeaderIconButton(icon: Ph.magnifyingGlass.regular, label: "Search")
      HeaderIconButton(icon: Ph.plus.regular, label: "New message")
    }
  }
}

struct HeaderLargeTitleDemo: View {
  var subtitle: LocalizedStringKey?

  var body: some View {
    HeaderScrollView {
      HeaderLargeTitle("Inbox", subtitle: subtitle)
      HeaderMessageRows()
    } header: {
      Header {
        HeaderTitle("Inbox")
      } leading: {
        HeaderBack("Mailboxes")
      } trailing: {
        HeaderTrailingActions()
      }
    }
  }
}

import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.verticalScroll
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.input.nestedscroll.nestedScroll
import androidx.compose.ui.layout.layout
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.adamglin.PhosphorIcons
import com.adamglin.phosphoricons.Regular
import com.adamglin.phosphoricons.regular.MagnifyingGlass
import com.adamglin.phosphoricons.regular.Plus
import com.esuiss.ui.components.Button
import com.esuiss.ui.components.ButtonSize
import com.esuiss.ui.components.ButtonVariant
import com.esuiss.ui.components.Header
import com.esuiss.ui.components.HeaderActions
import com.esuiss.ui.components.HeaderBack
import com.esuiss.ui.components.HeaderLargeTitle
import com.esuiss.ui.components.HeaderTitle
import com.esuiss.ui.components.Icon
import com.esuiss.ui.components.Screen
import com.esuiss.ui.components.Separator
import com.esuiss.ui.components.Text
import com.esuiss.ui.components.rememberHeaderState

@Composable
fun HeaderLargeTitleExample() {
    HeaderLargeTitleDemo(subtitle = null)
}

val HeaderMessages = listOf(
    "Lunch on Friday?",
    "The draft is ready for review",
    "Photos from the trip",
    "Invoice for September",
    "Your order has shipped",
    "Team sync moved to 3 PM",
    "Weekend plans",
    "Book club picks",
    "Flight confirmation",
    "New comment on your post",
    "Reminder: dentist at 10",
    "Quarterly report",
    "Welcome to the beta",
    "Parking update",
    "Recipe you asked for",
)

fun Modifier.headerBleed(): Modifier = layout { measurable, constraints ->
    val inset = 16.dp.roundToPx()
    val width = constraints.maxWidth + inset * 2
    val placeable = measurable.measure(constraints.copy(minWidth = width, maxWidth = width))
    layout(constraints.maxWidth, (placeable.height - inset).coerceAtLeast(0)) {
        placeable.place(-inset, -inset)
    }
}

@Composable
fun HeaderMessageRows() {
    Column(Modifier.fillMaxWidth().padding(horizontal = 16.dp)) {
        HeaderMessages.forEachIndexed { index, message ->
            if (index > 0) Separator()
            Text(
                message,
                modifier = Modifier.fillMaxWidth().padding(vertical = 12.dp),
                maxLines = 1,
                overflow = TextOverflow.Ellipsis,
            )
        }
    }
}

@Composable
fun HeaderTrailingActions() {
    HeaderActions {
        Button(onClick = {}, variant = ButtonVariant.Ghost, size = ButtonSize.Icon) {
            Icon(PhosphorIcons.Regular.MagnifyingGlass, contentDescription = "Search")
        }
        Button(onClick = {}, variant = ButtonVariant.Ghost, size = ButtonSize.Icon) {
            Icon(PhosphorIcons.Regular.Plus, contentDescription = "New message")
        }
    }
}

@Composable
fun HeaderLargeTitleDemo(subtitle: String?) {
    val state = rememberHeaderState()
    Screen {
        Column(Modifier.fillMaxSize().nestedScroll(state.nestedScrollConnection)) {
            Header(state = state) {
                HeaderBack(onClick = {}, text = "Mailboxes")
                HeaderTitle("Inbox")
                HeaderLargeTitle("Inbox", subtitle = subtitle)
                HeaderTrailingActions()
            }
            Column(Modifier.weight(1f).fillMaxWidth().verticalScroll(rememberScrollState())) {
                HeaderMessageRows()
            }
        }
    }
}

Large title with subtitle

A large title with a subtitle.

iOS

Header (large title with subtitle) on iOS in light mode

import { MagnifyingGlassIcon, PlusIcon } from "phosphor-react-native"
import { View } from "react-native"
import { Button } from "@/components/ui/button"
import { Header, HeaderActions, HeaderBack, HeaderLargeTitle, HeaderScrollView, HeaderTitle, useHeaderScroll } from "@/components/ui/header"
import { Icon } from "@/components/ui/icon"
import { Text } from "@/components/ui/text"

const messages = [
  "Lunch on Friday?",
  "The draft is ready for review",
  "Photos from the trip",
  "Invoice for September",
  "Your order has shipped",
  "Team sync moved to 3 PM",
  "Weekend plans",
  "Book club picks",
  "Flight confirmation",
  "New comment on your post",
  "Reminder: dentist at 10",
  "Quarterly report",
  "Welcome to the beta",
  "Parking update",
  "Recipe you asked for",
]

function MessageRows() {
  return (
    <View className="px-4">
      {messages.map((message, index) => (
        <View
          key={message}
          className={index > 0 ? "border-t border-separator py-3" : "py-3"}
        >
          <Text numberOfLines={1}>{message}</Text>
        </View>
      ))}
    </View>
  )
}

function TrailingActions() {
  return (
    <HeaderActions>
      <Button variant="ghost" size="icon" accessibilityLabel="Search">
        <Icon as={MagnifyingGlassIcon} className="size-5" />
      </Button>
      <Button variant="ghost" size="icon" accessibilityLabel="New message">
        <Icon as={PlusIcon} className="size-5" />
      </Button>
    </HeaderActions>
  )
}

function LargeTitleDemo({ subtitle }: { subtitle?: string }) {
  const scroll = useHeaderScroll()
  return (
    <View className="-m-4 flex-1">
      <Header scroll={scroll}>
        <HeaderBack>Mailboxes</HeaderBack>
        <HeaderTitle>Inbox</HeaderTitle>
        <TrailingActions />
      </Header>
      <HeaderScrollView scroll={scroll}>
        <HeaderLargeTitle subtitle={subtitle}>Inbox</HeaderLargeTitle>
        <MessageRows />
      </HeaderScrollView>
    </View>
  )
}

export function HeaderLargeTitleWithSubtitleExample() {
  return (
    <LargeTitleDemo subtitle="3 unread" />
  )
}

import EsuissUI
import PhosphorSwift
import SwiftUI

struct HeaderLargeTitleWithSubtitleExample: View {
  var body: some View {
    HeaderLargeTitleDemo(subtitle: "3 unread")
  }
}

let headerMessages = [
  "Lunch on Friday?",
  "The draft is ready for review",
  "Photos from the trip",
  "Invoice for September",
  "Your order has shipped",
  "Team sync moved to 3 PM",
  "Weekend plans",
  "Book club picks",
  "Flight confirmation",
  "New comment on your post",
  "Reminder: dentist at 10",
  "Quarterly report",
  "Welcome to the beta",
  "Parking update",
  "Recipe you asked for",
]

extension View {
  func headerStoryBleed() -> some View {
    padding(.horizontal, -16).padding(.top, -16)
  }
}

struct HeaderMessageRows: View {
  var body: some View {
    VStack(alignment: .leading, spacing: 0) {
      ForEach(Array(headerMessages.enumerated()), id: \.offset) { index, message in
        Text(LocalizedStringKey(message))
          .textStyle(.base)
          .foregroundStyle(Color.label)
          .lineLimit(1)
          .padding(.vertical, 12)
          .frame(maxWidth: .infinity, alignment: .leading)
          .overlay(alignment: .top) {
            if index > 0 {
              Color.separator.frame(height: 1)
            }
          }
      }
    }
    .padding(.horizontal, 16)
  }
}

struct HeaderIconButton: View {
  let icon: Image
  let label: LocalizedStringKey

  var body: some View {
    Button {} label: {
      icon.frame(width: 20, height: 20)
    }
    .accessibilityLabel(Text(label))
  }
}

struct HeaderTrailingActions: View {
  var body: some View {
    HeaderActions {
      HeaderIconButton(icon: Ph.magnifyingGlass.regular, label: "Search")
      HeaderIconButton(icon: Ph.plus.regular, label: "New message")
    }
  }
}

struct HeaderLargeTitleDemo: View {
  var subtitle: LocalizedStringKey?

  var body: some View {
    HeaderScrollView {
      HeaderLargeTitle("Inbox", subtitle: subtitle)
      HeaderMessageRows()
    } header: {
      Header {
        HeaderTitle("Inbox")
      } leading: {
        HeaderBack("Mailboxes")
      } trailing: {
        HeaderTrailingActions()
      }
    }
  }
}

import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.verticalScroll
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.input.nestedscroll.nestedScroll
import androidx.compose.ui.layout.layout
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.adamglin.PhosphorIcons
import com.adamglin.phosphoricons.Regular
import com.adamglin.phosphoricons.regular.MagnifyingGlass
import com.adamglin.phosphoricons.regular.Plus
import com.esuiss.ui.components.Button
import com.esuiss.ui.components.ButtonSize
import com.esuiss.ui.components.ButtonVariant
import com.esuiss.ui.components.Header
import com.esuiss.ui.components.HeaderActions
import com.esuiss.ui.components.HeaderBack
import com.esuiss.ui.components.HeaderLargeTitle
import com.esuiss.ui.components.HeaderTitle
import com.esuiss.ui.components.Icon
import com.esuiss.ui.components.Screen
import com.esuiss.ui.components.Separator
import com.esuiss.ui.components.Text
import com.esuiss.ui.components.rememberHeaderState

@Composable
fun HeaderLargeTitleWithSubtitleExample() {
    HeaderLargeTitleDemo(subtitle = "3 unread")
}

val HeaderMessages = listOf(
    "Lunch on Friday?",
    "The draft is ready for review",
    "Photos from the trip",
    "Invoice for September",
    "Your order has shipped",
    "Team sync moved to 3 PM",
    "Weekend plans",
    "Book club picks",
    "Flight confirmation",
    "New comment on your post",
    "Reminder: dentist at 10",
    "Quarterly report",
    "Welcome to the beta",
    "Parking update",
    "Recipe you asked for",
)

fun Modifier.headerBleed(): Modifier = layout { measurable, constraints ->
    val inset = 16.dp.roundToPx()
    val width = constraints.maxWidth + inset * 2
    val placeable = measurable.measure(constraints.copy(minWidth = width, maxWidth = width))
    layout(constraints.maxWidth, (placeable.height - inset).coerceAtLeast(0)) {
        placeable.place(-inset, -inset)
    }
}

@Composable
fun HeaderMessageRows() {
    Column(Modifier.fillMaxWidth().padding(horizontal = 16.dp)) {
        HeaderMessages.forEachIndexed { index, message ->
            if (index > 0) Separator()
            Text(
                message,
                modifier = Modifier.fillMaxWidth().padding(vertical = 12.dp),
                maxLines = 1,
                overflow = TextOverflow.Ellipsis,
            )
        }
    }
}

@Composable
fun HeaderTrailingActions() {
    HeaderActions {
        Button(onClick = {}, variant = ButtonVariant.Ghost, size = ButtonSize.Icon) {
            Icon(PhosphorIcons.Regular.MagnifyingGlass, contentDescription = "Search")
        }
        Button(onClick = {}, variant = ButtonVariant.Ghost, size = ButtonSize.Icon) {
            Icon(PhosphorIcons.Regular.Plus, contentDescription = "New message")
        }
    }
}

@Composable
fun HeaderLargeTitleDemo(subtitle: String?) {
    val state = rememberHeaderState()
    Screen {
        Column(Modifier.fillMaxSize().nestedScroll(state.nestedScrollConnection)) {
            Header(state = state) {
                HeaderBack(onClick = {}, text = "Mailboxes")
                HeaderTitle("Inbox")
                HeaderLargeTitle("Inbox", subtitle = subtitle)
                HeaderTrailingActions()
            }
            Column(Modifier.weight(1f).fillMaxWidth().verticalScroll(rememberScrollState())) {
                HeaderMessageRows()
            }
        }
    }
}

Compact with scroll

A compact title whose hairline appears on scroll.

iOS

Header (compact with scroll) on iOS in light mode

import { DotsThreeIcon } from "phosphor-react-native"
import { View } from "react-native"
import { Button } from "@/components/ui/button"
import { Header, HeaderActions, HeaderBack, HeaderScrollView, HeaderTitle, useHeaderScroll } from "@/components/ui/header"
import { Icon } from "@/components/ui/icon"
import { Text } from "@/components/ui/text"

const messages = [
  "Lunch on Friday?",
  "The draft is ready for review",
  "Photos from the trip",
  "Invoice for September",
  "Your order has shipped",
  "Team sync moved to 3 PM",
  "Weekend plans",
  "Book club picks",
  "Flight confirmation",
  "New comment on your post",
  "Reminder: dentist at 10",
  "Quarterly report",
  "Welcome to the beta",
  "Parking update",
  "Recipe you asked for",
]

function MessageRows() {
  return (
    <View className="px-4">
      {messages.map((message, index) => (
        <View
          key={message}
          className={index > 0 ? "border-t border-separator py-3" : "py-3"}
        >
          <Text numberOfLines={1}>{message}</Text>
        </View>
      ))}
    </View>
  )
}

function CompactScrollDemo() {
  const scroll = useHeaderScroll()
  return (
    <View className="-m-4 flex-1">
      <Header scroll={scroll}>
        <HeaderBack />
        <HeaderTitle subtitle="15 messages">Inbox</HeaderTitle>
        <HeaderActions>
          <Button variant="ghost" size="icon" accessibilityLabel="More">
            <Icon as={DotsThreeIcon} weight="bold" className="size-5" />
          </Button>
        </HeaderActions>
      </Header>
      <HeaderScrollView scroll={scroll}>
        <MessageRows />
      </HeaderScrollView>
    </View>
  )
}

export function HeaderCompactWithScrollExample() {
  return (
    <CompactScrollDemo />
  )
}

import EsuissUI
import PhosphorSwift
import SwiftUI

struct HeaderCompactWithScrollExample: View {
  var body: some View {
    HeaderScrollView {
      HeaderMessageRows()
    } header: {
      Header {
        HeaderTitle("Inbox", subtitle: "15 messages")
      } leading: {
        HeaderBack()
      } trailing: {
        HeaderActions {
          HeaderIconButton(icon: Ph.dotsThree.bold, label: "More")
        }
      }
    }
  }
}

let headerMessages = [
  "Lunch on Friday?",
  "The draft is ready for review",
  "Photos from the trip",
  "Invoice for September",
  "Your order has shipped",
  "Team sync moved to 3 PM",
  "Weekend plans",
  "Book club picks",
  "Flight confirmation",
  "New comment on your post",
  "Reminder: dentist at 10",
  "Quarterly report",
  "Welcome to the beta",
  "Parking update",
  "Recipe you asked for",
]

extension View {
  func headerStoryBleed() -> some View {
    padding(.horizontal, -16).padding(.top, -16)
  }
}

struct HeaderMessageRows: View {
  var body: some View {
    VStack(alignment: .leading, spacing: 0) {
      ForEach(Array(headerMessages.enumerated()), id: \.offset) { index, message in
        Text(LocalizedStringKey(message))
          .textStyle(.base)
          .foregroundStyle(Color.label)
          .lineLimit(1)
          .padding(.vertical, 12)
          .frame(maxWidth: .infinity, alignment: .leading)
          .overlay(alignment: .top) {
            if index > 0 {
              Color.separator.frame(height: 1)
            }
          }
      }
    }
    .padding(.horizontal, 16)
  }
}

struct HeaderIconButton: View {
  let icon: Image
  let label: LocalizedStringKey

  var body: some View {
    Button {} label: {
      icon.frame(width: 20, height: 20)
    }
    .accessibilityLabel(Text(label))
  }
}

import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.verticalScroll
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.layout.layout
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.adamglin.PhosphorIcons
import com.adamglin.phosphoricons.Bold
import com.adamglin.phosphoricons.bold.DotsThree
import com.esuiss.ui.components.Button
import com.esuiss.ui.components.ButtonSize
import com.esuiss.ui.components.ButtonVariant
import com.esuiss.ui.components.Header
import com.esuiss.ui.components.HeaderActions
import com.esuiss.ui.components.HeaderBack
import com.esuiss.ui.components.HeaderTitle
import com.esuiss.ui.components.Icon
import com.esuiss.ui.components.Screen
import com.esuiss.ui.components.Separator
import com.esuiss.ui.components.Text

val HeaderMessages = listOf(
    "Lunch on Friday?",
    "The draft is ready for review",
    "Photos from the trip",
    "Invoice for September",
    "Your order has shipped",
    "Team sync moved to 3 PM",
    "Weekend plans",
    "Book club picks",
    "Flight confirmation",
    "New comment on your post",
    "Reminder: dentist at 10",
    "Quarterly report",
    "Welcome to the beta",
    "Parking update",
    "Recipe you asked for",
)

fun Modifier.headerBleed(): Modifier = layout { measurable, constraints ->
    val inset = 16.dp.roundToPx()
    val width = constraints.maxWidth + inset * 2
    val placeable = measurable.measure(constraints.copy(minWidth = width, maxWidth = width))
    layout(constraints.maxWidth, (placeable.height - inset).coerceAtLeast(0)) {
        placeable.place(-inset, -inset)
    }
}

@Composable
fun HeaderMessageRows() {
    Column(Modifier.fillMaxWidth().padding(horizontal = 16.dp)) {
        HeaderMessages.forEachIndexed { index, message ->
            if (index > 0) Separator()
            Text(
                message,
                modifier = Modifier.fillMaxWidth().padding(vertical = 12.dp),
                maxLines = 1,
                overflow = TextOverflow.Ellipsis,
            )
        }
    }
}

@Composable
fun HeaderCompactScroll() {
    Screen {
        Column(Modifier.fillMaxSize()) {
            Header {
                HeaderBack(onClick = {}, text = null)
                HeaderTitle("Inbox", subtitle = "15 messages")
                HeaderActions {
                    Button(onClick = {}, variant = ButtonVariant.Ghost, size = ButtonSize.Icon) {
                        Icon(PhosphorIcons.Bold.DotsThree, contentDescription = "More")
                    }
                }
            }
            Column(Modifier.weight(1f).fillMaxWidth().verticalScroll(rememberScrollState())) {
                HeaderMessageRows()
            }
        }
    }
}

Subtitle

A two-line title with a subtitle.

iOS

import { MagnifyingGlassIcon, PlusIcon } from "phosphor-react-native"
import { View } from "react-native"
import { Button } from "@/components/ui/button"
import { Header, HeaderActions, HeaderBack, HeaderTitle } from "@/components/ui/header"
import { Icon } from "@/components/ui/icon"

function TrailingActions() {
  return (
    <HeaderActions>
      <Button variant="ghost" size="icon" accessibilityLabel="Search">
        <Icon as={MagnifyingGlassIcon} className="size-5" />
      </Button>
      <Button variant="ghost" size="icon" accessibilityLabel="New message">
        <Icon as={PlusIcon} className="size-5" />
      </Button>
    </HeaderActions>
  )
}

export function HeaderSubtitleExample() {
  return (
    <View className="-mx-4 -mt-4">
      <Header>
        <HeaderBack />
        <HeaderTitle subtitle="Last seen today">Alex Morgan</HeaderTitle>
        <TrailingActions />
      </Header>
    </View>
  )
}

import EsuissUI
import PhosphorSwift
import SwiftUI

struct HeaderSubtitleExample: View {
  var body: some View {
    Header {
      HeaderTitle("Alex Morgan", subtitle: "Last seen today")
    } leading: {
      HeaderBack()
    } trailing: {
      HeaderTrailingActions()
    }
    .headerStoryBleed()
  }
}

extension View {
  func headerStoryBleed() -> some View {
    padding(.horizontal, -16).padding(.top, -16)
  }
}

struct HeaderIconButton: View {
  let icon: Image
  let label: LocalizedStringKey

  var body: some View {
    Button {} label: {
      icon.frame(width: 20, height: 20)
    }
    .accessibilityLabel(Text(label))
  }
}

struct HeaderTrailingActions: View {
  var body: some View {
    HeaderActions {
      HeaderIconButton(icon: Ph.magnifyingGlass.regular, label: "Search")
      HeaderIconButton(icon: Ph.plus.regular, label: "New message")
    }
  }
}

import androidx.compose.foundation.layout.Column
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.layout.layout
import androidx.compose.ui.unit.dp
import com.adamglin.PhosphorIcons
import com.adamglin.phosphoricons.Regular
import com.adamglin.phosphoricons.regular.MagnifyingGlass
import com.adamglin.phosphoricons.regular.Plus
import com.esuiss.ui.components.Button
import com.esuiss.ui.components.ButtonSize
import com.esuiss.ui.components.ButtonVariant
import com.esuiss.ui.components.Header
import com.esuiss.ui.components.HeaderActions
import com.esuiss.ui.components.HeaderBack
import com.esuiss.ui.components.HeaderTitle
import com.esuiss.ui.components.Icon

fun Modifier.headerBleed(): Modifier = layout { measurable, constraints ->
    val inset = 16.dp.roundToPx()
    val width = constraints.maxWidth + inset * 2
    val placeable = measurable.measure(constraints.copy(minWidth = width, maxWidth = width))
    layout(constraints.maxWidth, (placeable.height - inset).coerceAtLeast(0)) {
        placeable.place(-inset, -inset)
    }
}

@Composable
fun HeaderTrailingActions() {
    HeaderActions {
        Button(onClick = {}, variant = ButtonVariant.Ghost, size = ButtonSize.Icon) {
            Icon(PhosphorIcons.Regular.MagnifyingGlass, contentDescription = "Search")
        }
        Button(onClick = {}, variant = ButtonVariant.Ghost, size = ButtonSize.Icon) {
            Icon(PhosphorIcons.Regular.Plus, contentDescription = "New message")
        }
    }
}

@Composable
fun HeaderSubtitle() {
    Column(Modifier.headerBleed()) {
        Header {
            HeaderBack(onClick = {}, text = null)
            HeaderTitle("Alex Morgan", subtitle = "Last seen today")
            HeaderTrailingActions()
        }
    }
}

Leading actions

Actions on both sides of the title.

iOS

Header (leading actions) on iOS in light mode

import { ListIcon } from "phosphor-react-native"
import { View } from "react-native"
import { Button } from "@/components/ui/button"
import { Header, HeaderActions, HeaderTitle } from "@/components/ui/header"
import { Icon } from "@/components/ui/icon"
import { Text } from "@/components/ui/text"

export function HeaderLeadingActionsExample() {
  return (
    <View className="-mx-4 -mt-4">
      <Header>
        <HeaderActions side="leading">
          <Button variant="ghost" size="icon" accessibilityLabel="Menu">
            <Icon as={ListIcon} className="size-5" />
          </Button>
        </HeaderActions>
        <HeaderTitle>Library</HeaderTitle>
        <HeaderActions>
          <Button variant="plain" size="sm">
            <Text className="font-semibold">Done</Text>
          </Button>
        </HeaderActions>
      </Header>
    </View>
  )
}

import EsuissUI
import PhosphorSwift
import SwiftUI

struct HeaderLeadingActionsExample: View {
  var body: some View {
    Header {
      HeaderTitle("Library")
    } leading: {
      HeaderActions {
        HeaderIconButton(icon: Ph.list.regular, label: "Menu")
      }
    } trailing: {
      HeaderActions {
        Button {} label: {
          Text("Done").fontWeight(.semibold)
        }
        .buttonStyle(.variant(.plain, size: .sm))
      }
    }
    .headerStoryBleed()
  }
}

extension View {
  func headerStoryBleed() -> some View {
    padding(.horizontal, -16).padding(.top, -16)
  }
}

struct HeaderIconButton: View {
  let icon: Image
  let label: LocalizedStringKey

  var body: some View {
    Button {} label: {
      icon.frame(width: 20, height: 20)
    }
    .accessibilityLabel(Text(label))
  }
}

import androidx.compose.foundation.layout.Column
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.layout.layout
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import com.adamglin.PhosphorIcons
import com.adamglin.phosphoricons.Regular
import com.adamglin.phosphoricons.regular.List
import com.esuiss.ui.components.Button
import com.esuiss.ui.components.ButtonSize
import com.esuiss.ui.components.ButtonVariant
import com.esuiss.ui.components.Header
import com.esuiss.ui.components.HeaderActions
import com.esuiss.ui.components.HeaderActionsSide
import com.esuiss.ui.components.HeaderTitle
import com.esuiss.ui.components.Icon
import com.esuiss.ui.components.Text

fun Modifier.headerBleed(): Modifier = layout { measurable, constraints ->
    val inset = 16.dp.roundToPx()
    val width = constraints.maxWidth + inset * 2
    val placeable = measurable.measure(constraints.copy(minWidth = width, maxWidth = width))
    layout(constraints.maxWidth, (placeable.height - inset).coerceAtLeast(0)) {
        placeable.place(-inset, -inset)
    }
}

@Composable
fun HeaderPlainAction(text: String) {
    Button(onClick = {}, variant = ButtonVariant.Plain, size = ButtonSize.Sm) {
        Text(text, style = TextStyle(fontWeight = FontWeight.SemiBold))
    }
}

@Composable
fun HeaderLeadingActions() {
    Column(Modifier.headerBleed()) {
        Header {
            HeaderActions(side = HeaderActionsSide.Leading) {
                Button(onClick = {}, variant = ButtonVariant.Ghost, size = ButtonSize.Icon) {
                    Icon(PhosphorIcons.Regular.List, contentDescription = "Menu")
                }
            }
            HeaderTitle("Library")
            HeaderActions { HeaderPlainAction("Done") }
        }
    }
}

Back only

A long back label that truncates.

iOS

import { View } from "react-native"
import { Header, HeaderBack, HeaderTitle } from "@/components/ui/header"

export function HeaderBackOnlyExample() {
  return (
    <View className="-mx-4 -mt-4">
      <Header>
        <HeaderBack>A very long previous screen title</HeaderBack>
        <HeaderTitle>Details</HeaderTitle>
      </Header>
    </View>
  )
}

import EsuissUI
import SwiftUI

struct HeaderBackOnlyExample: View {
  var body: some View {
    Header {
      HeaderTitle("Details")
    } leading: {
      HeaderBack("A very long previous screen title")
    }
    .headerStoryBleed()
  }
}

import androidx.compose.foundation.layout.Column
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.layout.layout
import androidx.compose.ui.unit.dp
import com.esuiss.ui.components.Header
import com.esuiss.ui.components.HeaderBack
import com.esuiss.ui.components.HeaderTitle

fun Modifier.headerBleed(): Modifier = layout { measurable, constraints ->
    val inset = 16.dp.roundToPx()
    val width = constraints.maxWidth + inset * 2
    val placeable = measurable.measure(constraints.copy(minWidth = width, maxWidth = width))
    layout(constraints.maxWidth, (placeable.height - inset).coerceAtLeast(0)) {
        placeable.place(-inset, -inset)
    }
}

@Composable
fun HeaderBackOnly() {
    Column(Modifier.headerBleed()) {
        Header {
            HeaderBack(onClick = {}, text = "A very long previous screen title")
            HeaderTitle("Details")
        }
    }
}

API Reference

Bar that lays out the back button, title and actions.

ExtendsViewProps

PropTypeDefault

About: Scroll state from useHeaderScroll().
Type: HeaderScroll
Default: —

HeaderTitle

Centered title with optional subtitle.

ExtendsViewProps

PropTypeDefault

About: Second line under the title.
Type: React.ReactNode
Default: —

HeaderLargeTitle

Large title at the top of the scroll content.

ExtendsViewProps

PropTypeDefault

About: Line under the large title.
Type: React.ReactNode
Default: —

HeaderBack

Back button with a caret and optional label.

ExtendsReact.ComponentProps<typeof Pressable>

PropTypeDefault

Type: React.ReactNode
Default: —

HeaderActions

Row of actions for either side.

ExtendsViewProps

PropTypeDefault

About: leading or trailing. Defaults to trailing.
Type: "leading""trailing"
Default: "trailing"

HeaderScrollView

Scroll view that drives the header animations.

ExtendsScrollViewProps

PropTypeDefault

About: Scroll state from useHeaderScroll().
Type: HeaderScroll
Default: required

Accessibility

HeaderTitle and a string HeaderLargeTitle have the heading role.
HeaderBack has the button role and is labelled with its text, or "Back" when it has none.
Give icon-only actions an accessibilityLabel.

Notes

The back caret rotates and the large title scales from the correct edge in right-to-left layouts.
Uses text-link, bg-separator and bg-item-pressed tokens; light and dark follow the system appearance.