SwiftUI

The Tanrei Swift package provides SwiftUI views, a theme environment and generated token constants. It supports iOS 17 and macOS 14 or later, and is written for Swift 6 language mode.

Not published yet

Tanrei is not on Swift Package Manager yet. A platform is published once it has caught up with the current specs, and SwiftUI’s CI is paused until then. “From source” below shows how the package is added from chnotchy/tanrei; “Once it is published” shows how installing will work then.

Install

link

From source

link

Does not build today

The SwiftUI package has not caught up with the current specs and tokens: its sources were written against an earlier version of the generated token code and do not compile against today’s. Its CI is paused until it catches up, and the status page marks its components lagging. The steps below are how it is added to an app; they work once the package has caught up.

Clone the repository next to your app and add the clone as a local package: in Xcode, File → Add Package Dependencies… → Add Local… and choose the folder that holds Package.swift, or in your own Package.swift:

dependencies: [
  .package(path: "../tanrei")
],
targets: [
  .target(name: "App", dependencies: [.product(name: "Tanrei", package: "tanrei")])
]

.package(url: "https://github.com/chnotchy/tanrei", branch: "main") follows the repository instead of a local clone.

Once it is published

link

In Xcode choose File → Add Package Dependencies… and enter the repository URL, or add it to Package.swift:

dependencies: [
  .package(url: "https://github.com/chnotchy/tanrei", from: "<version>")
],
targets: [
  .target(name: "App", dependencies: [.product(name: "Tanrei", package: "tanrei")])
]

The package manifest sits at the repository root because Swift Package Manager resolves Git dependencies from there. Swift releases will be tagged with plain semantic versions.

Use

link

import SwiftUI
import Tanrei

struct DeployView: View {
  @State private var isDeploying = false

  var body: some View {
    TanreiButton("Deploy", variant: .filled, action: { isDeploying = true })
      .disabled(isDeploying)
  }
}

action: is the spec’s click; a trailing closure is the icon: slot (TanreiButton("Deploy", action: deploy) { Image(systemName: "arrow.up") }). There is no disabled parameter. Tanrei follows SwiftUI’s own .disabled(_:) environment, so disabling a container disables the buttons inside it, as it would for a system control.

Theme and contrast

link

By default Tanrei follows the system color scheme and the Increase Contrast accessibility setting. Override either with the theme modifier:

ContentView()
  .tanreiTheme(TanreiTheme(appearance: .dark, contrast: .high))

Fonts

link

The typescale uses Inter (Noto Sans JP for Japanese, Roboto Mono for code) when the fonts are registered with your app and falls back to the system font otherwise. Text styles are named by level and live on the system in the environment (@Environment(\.tanreiSystem) private var system): .tanreiTextStyle(system.typescale.heading2) for a section title, system.typescale.body for running text, system.typescale.label for a control — and they scale with Dynamic Type; .tanreiTextStyle(system.typescale.heading1, emphasized: true) adds the heading family’s emphasis step to the weight. Corners follow system.shape.cornerSmoothing: .circular at 0, the OS’s .continuous corner for any amount above 0.