- Notifications
You must be signed in to change notification settings - Fork537
kean/Nuke
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Serving Images Since 2015
Load images from different sources and display them in your app using simple and flexible APIs. Take advantage of the powerful image processing capabilities and a robust caching system.
The framework is lean and compiles in under 2 seconds¹. It has an automated test suite 2x the codebase size, ensuring excellent reliability. Nuke is optimized forperformance, and its advanced architecture enables virtually unlimited possibilities for customization.
Memory and Disk Cache ·Image Processing & Decompression ·Request Coalescing & Priority ·Prefetching ·Resumable Downloads ·Progressive JPEG ·HEIF, WebP, GIF ·SwiftUI ·Async/Await
Lapse: friendsnot followers.
Nuke is also supported by:
Proxyman | Backspace Travel |
Nuke supportsSwift Package Manager, which is the recommended option. If that doesn't work for you, you can use binary frameworks attached to thereleases.
The package ships with four modules that you can install depending on your needs:
Module | Description |
---|---|
Nuke | The lean core framework withImagePipeline ,ImageRequest , and more |
NukeUI | The UI components:LazyImage (SwiftUI) andImageView (UIKit, AppKit) |
NukeExtensions | The extensions forUIImageView (UIKit, AppKit) |
NukeVideo | The components for decoding and playing short videos |
Nuke is easy to learn and use, thanks to its extensive documentation and a modern API.
You can load images usingImagePipeline
from the lean coreNuke module:
func loadImage()asyncthrows{letimageTask=ImagePipeline.shared.imageTask(with: url)forawaitprogressin imageTask.progress{ // Update progress} imageView.image=tryawait imageTask.image}
Or you can use the built-in UI components from theNukeUI module:
structContentView:View{varbody:someView{LazyImage(url:URL(string:"https://example.com/image.jpeg"))}}
TheGetting Started guide is the best place to start learning about these and many other APIs provided by the framework. Check outNuke Demo for more usage examples.

The image pipeline is easy to customize and extend. Check out the following first-class extensions and packages built by the community.
Name | Description |
---|---|
Alamofire Plugin | Replace networking layer withAlamofire |
NukeWebP | Community.WebP support, built byMaxim Kolesnik |
WebP Plugin | Community.WebP support, built byRyo Kosuge |
AVIF Plugin | Community.AVIF support, built byDenis |
RxNuke | RxSwift extensions for Nuke with examples |
Looking for a way to log your network requests, including image requests? Check outPulse.
Upgrading from the previous version? Use aMigration Guide.
Nuke | Date | Swift | Xcode | Platforms |
---|---|---|---|---|
Nuke 12.0 | Mar 4, 2023 | Swift 5.7 | Xcode 15.0 | iOS 13.0, watchOS 6.0, macOS 10.15, tvOS 13.0 |
Nuke 11.0 | Jul 20, 2022 | Swift 5.6 | Xcode 13.3 | iOS 13.0, watchOS 6.0, macOS 10.15, tvOS 13.0 |
Nuke 10.0 | Jun 1, 2021 | Swift 5.3 | Xcode 12.0 | iOS 11.0, watchOS 4.0, macOS 10.13, tvOS 11.0 |
Starting with version 12.3, Nuke also ships with visionOS support (in beta)
Nuke is available under the MIT license. See the LICENSE file for more info.
¹ Measured on MacBook Pro 14" 2021 (10-core M1 Pro)
About
Image loading system