A SwiftUI HStack with the ability to wrap contained elements

What's New



Updates for tvOS and VisionOS


WrappingHStack is a UI Element that works in a very similar way to HStack, but automatically positions overflowing elements on next lines.



WrappingHStack {
    Text("can handle different element types")
    Image(systemName: "scribble")
        .frame(width: 200, height: 20)
    Text("and loop")
    WrappingHStack(1...20, id:\.self) {
        Text("Item: \($0)")
    }.frame(minWidth: 250)


Requirements iOS 13+

Swift Package Manager

  1. In Xcode, open your project and navigate to File → Swift Packages → Add Package Dependency.
  2. Paste the repository URL (https://github.com/dkk/WrappingHStack) and click Next.
  3. For Rules, select version.
  4. Click Finish.

Swift Package

.package(url: "https://github.com/dkk/WrappingHStack", .upToNextMajor(from: "2.0.0"))


Simply add the following line to your Podfile:

pod 'WrappingHStack'


Import the WrappingHStack package to your view:

import WrappingHStack

use it like you would use HStack for single elements:

WrappingHStack {
    /* some views */
    NewLine() // Optional: Use NewLine to force the next element to be placed in a next line
    /* some more views */

or like a ForEach to loop over items:

WrappingHStack(1...30, id:\.self) {
    Text("Item: \($0)")

Item positioning

You control the position of the items by using the parameter alignment, which sets the HorizontalAlignment of the items. I.e. leading, trailing or centered.

For even more convenience and flexibility, WrappingHSTack offers the parameter spacing, that defines how the spacing will be calculated. It can be one of the following types:

  • .constant: for fixed spacing, each line starts with an item and the horizontal separation between any 2 items is the given value.
  • .dynamic: to have the items fill the width of the WrappingHSTack. You can pass a minimal spacing.
  • .dynamicIncludingBorders to fill the full width with equal spacing between items and from the items to the border. You can pass a minimal spacing.

Known Issues

  • Issue #15: Item sizes are calculated incorrectly when WrappingHStack has modifiers that change the size of its elements.
  • Issue #16: Workaround needed when using WrappingHStack in a NavigationLink (iOS16 only).
  • Issue #10: SPM cannot resolve the dependency (Xcode 11.3.1 only).


You can contribute to this project by helping me solve any reported issues or feature requests and creating a pull request.


Sponsor this project to get a reward and give me a moral boost.


WrappingHStack was originally developed by Daniel Klöck and is released under the MIT License.


  • Swift Tools 5.3.0
View More Packages from this Author


  • None
Last updated: Sat Jun 15 2024 18:02:00 GMT-0900 (Hawaii-Aleutian Daylight Time)