SteadyUI is a SwiftUI design-system package for iOS 18 and later. The package is in pre-1.0 development and validates new APIs in the bundled MobileExample before release.
- Xcode 26.4.1
- Swift 6.3.1
- iOS 18 or later
- Node.js 20.19.0 or later
- XcodeBuildMCP 2.1.0 installed from the repository lockfile with
npm ci --ignore-scripts
Until the first tagged release, add this repository as a local Swift package in Xcode and import the library where it is used:
import SteadyUIimport SteadyUI
import SwiftUI
@main
struct ExampleApp: App {
var body: some Scene {
WindowGroup {
ContentView()
.environment(\.theme, .default)
}
}
}import SteadyUI
import SwiftUI
struct AccountStatusView: View {
var body: some View {
VStack {
SteadyBadge(
"Active",
role: .success,
emphasis: .secondary
)
Button("Save") {}
.buttonStyle(.steadyFilled(width: .expanded))
Button("Reset") {}
.buttonStyle(.steadyPlain(tone: .neutral))
Button("Delete", role: .destructive) {}
.buttonStyle(.steadyOutlined)
}
}
}Use SteadyListRow for row content while the native control keeps the action,
navigation, or selection meaning:
Button {} label: {
SteadyListRow(
leading: { Image(systemName: "arrow.clockwise") },
content: { Text("Refresh account") },
supporting: { Text("Sync the latest account data") },
trailing: { Image(systemName: "chevron.right") }
)
}
.buttonStyle(.steadyListRow)Use .steadyCard() for a static card that contains independent controls. Use
.buttonStyle(.steadyCard) only when the entire card has one action and no
nested controls.
Run the minimum supported runtime before requesting review:
npm ci --ignore-scripts
export PATH="$PWD/node_modules/.bin:$PATH"
./Scripts/verify environment --profile minimum --output json
./Scripts/verify ios --profile minimum --output jsonGitHub Actions runs the same entry point with the hosted-runner profile:
./Scripts/verify ios --profile ci --output json./Scripts/verify host --output json records the result of swift test for diagnostics. SteadyUI is iOS-only, so the host command is not a merge or release gate.
See ROADMAP.md for the current item, dependencies, acceptance criteria, and verification evidence. Contributors and agents must also follow AGENTS.md.
Public UI APIs follow the shared state, sizing, motion, accessibility, and abstraction rules in Component Contracts.