---
title: "ExpandedSurfaceBox, DroppyKit"
description: "Host-aligned container for an ExpandedSurfaceProviding view."
canonical: "https://getdroppy.app/docs/droppykit/api/expanded-surface-box"
last-updated: "2026-09-09"
---

# ExpandedSurfaceBox

Host-aligned container for an ExpandedSurfaceProviding view.

`@MainActor struct ExpandedSurfaceBox<Content> where Content : View`

Propagates [`ShelfWidgetLayout`](https://getdroppy.app/docs/droppykit/api/shelf-widget-layout) derived from the [`ExpandedSurfaceContext`](https://getdroppy.app/docs/droppykit/api/expanded-surface-context) (including any cutout-wrap bands) so [`ShelfWidgetHeader`](https://getdroppy.app/docs/droppykit/api/shelf-widget-header), [`ShelfWidgetScaffold`](https://getdroppy.app/docs/droppykit/api/shelf-widget-scaffold), [`ShelfWidgetStageScaffold`](https://getdroppy.app/docs/droppykit/api/shelf-widget-stage-scaffold), and Droppy wash controls mask and clear the camera cutout identically to shelf widgets.

Available from DroppyKit 1.24.0; a droplet that uses it declares `minAPI` 1.24.0.

## Initializers

### init(context:usesAdaptiveForegrounds:foreground:content:)

`@MainActor init(context: ExpandedSurfaceContext, usesAdaptiveForegrounds: Bool = false, foreground: Color? = nil, @ViewBuilder content: () -> Content)`

## Properties

### body

`@MainActor var body: some View { get }`
