Temporal is a distributed, scalable, durable, and highly available orchestration engine used to execute asynchronous, long-running business logic in a scalable and resilient way.
- 🚀 Swift package for authoring Temporal workflows and activities
- 📦 Compatible with Swift Package Manager
- 📱 Supports Linux (including the static SDK), macOS, iOS
- 🔧 Built with Swift 6.2+ and Xcode 26+
🔗 Jump to:
- 📖 Overview
- ⚙️ Use Cases
- 🏁 Getting Started
- 📘 Documentation
- 🧰 Release Info
- 🛠️ Support
The Temporal Swift SDK provides a package for building distributed, durable workflows and activities using Swift's modern concurrency features. Temporal enables you to build reliable applications that recover from failures, scale dynamically, and maintain long-running business processes with confidence.
Key Features:
- 🔄 Durable Workflows: Build fault-tolerant workflows that survive infrastructure failures
- 🏗️ Scalable Architecture: Distribute workflow execution across multiple workers
- ⚡ Swift Concurrency: Native integration with Swift Structured Concurrency
- 🎯 Type Safety: Compile-time type checking for workflow and activity definitions, with struct-based workflows providing additional safety guarantees (queries can't mutate state, validators can't mutate state)
- 📊 Observability: Built-in support for logging, metrics and tracing
- 🔧 Macro-based APIs: Simple
@Workflowand@Activitymacros to avoid boilerplate - 🧪 Testing Support: Easily test your workflows and activities
The Temporal Swift SDK excels in scenarios requiring reliable, long-running business processes such as:
🛒 E-commerce & Payment Processing
- Order fulfillment workflows with inventory, payment, and shipping coordination
- Multi-step payment processing with automatic retry and rollback capabilities
- Subscription billing and recurring payment management
🔄 Data Processing & ETL
- Large-scale data transformation pipelines with fault tolerance
- Event-driven data processing with guaranteed delivery
- Batch processing jobs with progress tracking and resumption
🏢 Business Process Automation
- Approval workflows with human-in-the-loop interactions
- Multi-system integration and orchestration
- Document processing and compliance workflows
📊 Monitoring & Operations
- Health check orchestration across distributed systems
- Automated incident response and remediation
- Scheduled maintenance and cleanup tasks
- Swift version: Swift 6.2+
To install/upgrade Swift, see https://www.swift.org/install/
To use the Swift Temporal SDK in your Swift project, add it as a dependency in
your Package.swift file:
dependencies: [
.package(url: "https://github.com/apple/swift-temporal-sdk.git", .upToNextMinor(from: "0.6.0"))
]-
Clone the repository
git clone git@github.com:apple/swift-temporal-sdk.git
-
Build the package
swift build
-
Run tests
swift test -
Run an example
# Install Temporal CLI from https://temporal.io/setup/install-temporal-cli temporal server start-dev cd Examples/Greeting swift run GreetingExample
Here's a simple example showing how to create a workflow and activity:
import GRPCNIOTransportHTTP2Posix
import Logging
import Temporal
// Define an activity
@ActivityContainer
struct GreetingActivities {
@Activity
func sayHello(input: String) -> String {
"Hello, \(input)!"
}
}
// Define a workflow
@Workflow
struct GreetingWorkflow {
mutating func run(context: WorkflowContext<Self>, input: String) async throws -> String {
let greeting = try await context.executeActivity(
GreetingActivities.Activities.SayHello.self,
options: ActivityOptions(startToCloseTimeout: .seconds(30)),
input: input
)
return greeting
}
}
// Create worker and client
@main
struct MyApp {
static func main() async throws {
let worker = try TemporalWorker(
configuration: .init(
namespace: "default",
taskQueue: "greeting-queue",
instrumentation: .init(serverHostname: "127.0.0.1")
),
target: .ipv4(address: "127.0.0.1", port: 7233),
transportSecurity: .plaintext,
activityContainers: GreetingActivities(),
workflows: [GreetingWorkflow.self],
logger: Logger(label: "worker")
)
let client = try TemporalClient(
target: .ipv4(address: "127.0.0.1", port: 7233),
transportSecurity: .plaintext,
configuration: .init(instrumentation: .init(serverHostname: "127.0.0.1")),
logger: Logger(label: "client")
)
try await withThrowingTaskGroup { group in
group.addTask {
try await worker.run()
}
group.addTask {
try await client.run()
}
// Wait for the worker and client to run
try await Task.sleep(for: .seconds(1))
// Execute workflow
print("Executing workflow")
let result = try await client.executeWorkflow(
type: GreetingWorkflow.self,
options: .init(id: "greeting-1", taskQueue: "greeting-queue"),
input: "World"
)
print(result) // "Hello, World!"
// Cancel the client and worker
group.cancelAll()
}
}
}- API Documentation - Complete API reference and guides
- Examples
- Sample projects demonstrating various features
Note
This SDK is currently under active development.
- Release Cadence: Ad-hoc whenever changes land on
main - Version Compatibility: Swift 6.2+ and macOS 15.0+ only
If you have any questions or need help, feel free to reach out by opening an issue.