A SwiftUI component for creating customizable step indications for iOS and watchOS applications. It offers extensive visual customization options and a novel AI-powered generator that translates natural language prompts into functional StepperView code, simplifying the development of multi-step user interfaces.

How It Works

StepperView provides a declarative SwiftUI interface for building step indicators with support for both vertical and horizontal layouts. It allows deep customization of step elements, including circles, images, custom views, and animations, alongside configurable line styles, spacing, and an optional "pit stop" feature for intermediate stages. A standout feature is the AI-Powered StepperView Generator, which leverages Apple's on-device Foundation Models to generate SwiftUI code for StepperViews directly from user-defined natural language descriptions.

Quick Start & Requirements

• Installation: Available via CocoaPods (pod 'StepperView','~> 2.0'), Carthage (github "badrinathvm/stepperView" == 2.0), and Swift Package Manager (https://github.com/badrinathvm/StepperView.git, from: "2.0.0").
• Prerequisites: iOS 13.0+, watchOS 7.0+, macOS 10.15+, Xcode 16+, Swift 5.9+. Note: AI features require iOS 26.0+.
• Links: Example project available by cloning the repo and running pod install in the Example directory.

Highlighted Details

• AI-Powered StepperView Generator: Generates SwiftUI StepperViews from natural language prompts using on-device Apple Foundation Models (requires iOS 26.0+).
• Extensive Customization: Supports vertical/horizontal modes, various indicator types (numbered circles, SF Symbols, custom views, animations), customizable lines, spacing, and animations.
• Pit Stop Feature: Enables the inclusion of intermediate stages or detailed descriptions between main step indicators.
• Cross-Platform Support: Compatible with iOS and watchOS.

Maintenance & Community

Contributions in the form of feature requests, bug reports, and pull requests are welcomed. Specific community channels or active maintainer details are not detailed in the README.

Licensing & Compatibility

Licensed under the MIT license, permitting commercial use and integration into closed-source projects.

Limitations & Caveats

The advanced AI-Powered StepperView Generator functionality is contingent on iOS 26.0+, a future operating system version. The stated requirements for Xcode 16 and Swift 5.9 also point to future development tool versions.