apple / swift-temporal-sdk

Temporal Swift SDK 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 📖 Overview 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 • 📊 **Observability**: Built-in support for logging, metrics and tracing • 🔧 **Macro-based APIs**: Simple and macros to avoid boilerplate • 🧪 **Testing Support**: Easily test your workflows and activities ⚙️ Use Cases 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 🏁 Getting Started Prerequisites • Swift version: Swift 6.2+ To install/upgrade Swift, see https://www.swift.org/install/ Adding as a dependency To use the Swift Temporal SDK in your Swift project, add it as a dependency in your file: Running the project • **Clone the repository** • **Build the package** • **Run tests** • **Run an example** Usage Here's a simple example showing how to create a workflow and activity: 📘 Documentation • API Documentation - Complete API reference and guides • Examples • Sample projects demonstrating various features 🧰 Release Info > [!NOTE] > This SDK is currently under active development. • Release Cadence: Ad-hoc whenever changes land on • Version Compatibility: Swift 6.2+ and macOS 15.0+ only 🛠️ Support If you have any questions or need help, feel free to reach out by opening an issue.