DITranquillity
A lightweight yet powerful dependency injection library for Swift on Apple platforms and Linux.
What is DITranquillity?
DITranquillity is a dependency injection library for Swift that helps manage object dependencies in applications across iOS, macOS, tvOS, watchOS, and Linux. It solves the problem of tightly coupled code by providing a declarative way to define and resolve dependencies, promoting modularity and testability. The library supports various injection types, scopes, and integrates with UI components like Storyboards.
Swift developers building applications for Apple platforms or Linux who need a robust, type-safe dependency injection solution to manage complex object graphs and improve code maintainability.
Developers choose DITranquillity for its comprehensive feature set—including circular dependency handling, graph validation, and UI integration—combined with a focus on simplicity and safety. Its declarative syntax and support for modern Swift concurrency make it a powerful alternative to manual dependency management or lighter DI frameworks.
Overview
Dependency injection for iOS (Swift)
Use Cases
Best For
- Implementing dependency injection in Swift-based iOS or macOS apps
- Managing complex object graphs with circular dependencies
- Building modular applications with separated dependency definitions
- Integrating dependency injection with Storyboards and UIKit/AppKit views
- Ensuring thread-safe dependency resolution in concurrent Swift code
- Debugging and validating dependency structures via graph APIs
Not Ideal For
- Projects relying exclusively on Cocoapods for dependency management, as support is dropped from version 5.0.0
- Teams needing visual dependency graph tools for debugging, since the visualization feature is not yet implemented
- Simple applications with minimal dependencies where manual injection or lighter frameworks would suffice
- SwiftUI-focused projects without UIKit/AppKit, as UI integration is optimized for Storyboards and traditional views
Pros & Cons
Pros
Supports initializer, property, and method injection with optional, tagged, and circular dependencies, enabling flexible dependency management as detailed in the core features.
Allows splitting dependency definitions into modules for better structure in large apps, promoting clean separation of concerns and maintainability.
Offers injection for Storyboards, view controllers, and subviews, making it easy to integrate dependency injection into iOS/macOS UI workflows without boilerplate code.
Provides APIs for dependency graph validation and retrieval, helping developers debug complex object relationships and ensure correct dependency resolution.
Cons
The dependency graph visualization feature is marked as not implemented in the README, limiting graphical debugging options compared to some alternatives.
Cocoapods is unsupported from version 5.0.0, forcing teams using this package manager to migrate to SwiftPM or Carthage, which can be disruptive.
The declarative style for dependency description, while powerful, requires a steep learning curve and deep understanding of DI concepts, which may overwhelm newcomers.
Frequently Asked Questions
Related Projects
SwinjectDependency injection framework for Swift with iOS/macOS/Linux
TyphoonPowerful dependency injection for Objective-C ✨✨ (https://github.com/appsquickly/pilgrim is the pure Swift successor to Typhoon!!)✨✨
DipSimple Swift Dependency container. Use protocols to resolve your dependencies and avoid singletons / sharedInstances!
WeaverDependency Injection framework for Swift (iOS/macOS/Linux)
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.