Skip to content
thesteadycompanyPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SteadyUI

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.

Requirements

  • 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

Add the Package

Until the first tagged release, add this repository as a local Swift package in Xcode and import the library where it is used:

import SteadyUI

Apply the Default Theme

import SteadyUI
import SwiftUI

@main
struct ExampleApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        .environment(\.theme, .default)
    }
  }
}

Use Components

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.

Verify Changes

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 json

GitHub 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.

Roadmap

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages