A SwiftUI HStack with the ability to wrap contained elements

What's New



minor performance update


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.


If you just want to say thanks, you could buy me a coffee ☕️.


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: Tue Nov 29 2022 06:01:19 GMT-0500 (GMT-05:00)