https://github.com/cmtrounce/SwURL

Lightweight and customisable async image loading in SwiftUI. Supports on-disk storage, placeholders and more!
https://github.com/cmtrounce/SwURL

asyncimage image-loading-from-server image-loading-library imageview placeholder-image swiftui

Last synced: about 1 month ago
JSON representation

Lightweight and customisable async image loading in SwiftUI. Supports on-disk storage, placeholders and more!

• Host: GitHub
• URL: https://github.com/cmtrounce/SwURL
• Owner: cmtrounce
• License: mit
• Created: 2019-06-05T18:10:34.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-07-06T21:28:25.000Z (over 1 year ago)
• Last Synced: 2024-10-30T17:13:53.304Z (about 2 months ago)
• Topics: asyncimage, image-loading-from-server, image-loading-library, imageview, placeholder-image, swiftui
• Language: Swift
• Homepage:
• Size: 218 KB
• Stars: 203
• Watchers: 9
• Forks: 17
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-swiftui-libraries - SwURL - Lightweight asynchronous image loading in SwiftUI. Fetch and display images from URLs. (Image / Content)
• awesome-swiftui - Async image loading

README

        


  



[![Build Status](https://app.bitrise.io/app/0cc93118a793b6f9/status.svg?token=6ITVosjDjjYgfYcVRGMuUw&branch=master)](https://app.bitrise.io/app/0cc93118a793b6f9)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)

Asyncrounously download and display images in Swift UI. Supports progress indicators, placeholders and image transitions.

# `SwURLImage`

Asyncrounously download and display images declaratively. Supports progress indicators, placeholders and image transitions. Flexible caching options. 

Flexible caching and image fetching done in background. Currently tested with basic `List` as seen in Example



## "But, `AsyncImage`"

It's great that Apple now has official support for async images, however:

Unlike `AsyncImage`,  `SwURLImage`:

- Is supported from iOS 13

- Supports caching (in memory, on disk, and custom)

- Supports progress indicators (including download fraction) and custom transitions

- Has in depth, customisable logging

# Getting Started

## Get it

SwURL is available only through `Swift Package Manager`

* Open Xcode

* Go to `File > Swift Packages > Add Package Dependency...`

* Paste this Github Repo URL ( https://github.com/cmtrounce/SwURL ) into the search bar. 

* Select the SwURL repo from the search results.

* Choose the branch/version you want to clone. The most recent release is the most stable but you can choose branches  `master` and `develop` for the most up to date changes.

* Confirm and enjoy!

## Read the Documentation

Get started by reading the documentation in your browser [here](https://cmtrounce.github.io/documentation/swurl/).

The documentation includes usage examples and makes the code easier to explore.

There is also an example project in this repo that you can give a try.

# Contact

Join the SwURL Gitter community at https://gitter.im/SwURL-package/community and message me directly. Recommended for quicker response time.

You can also follow/message me on Twitter at https://twitter.com/cmtrounce