Skip to content

A drop-in UIView extension for showing empty datasets whenever the view has no content to display.

License

Notifications You must be signed in to change notification settings

liam-i/BlankSlate

Repository files navigation

BlankSlate

Swift Platforms CocoaPods SPM Carthage License

BlankSlate is a drop-in UIView extension for showing empty datasets whenever the view has no content to display.

ScreenShots

Requirements

  • iOS 12.0+
  • tvOS 12.0+
  • Xcode 14.1+
  • Swift 5.7.1+

Installation

Swift Package Manager

...using swift build

If you are using the Swift Package Manager, add a dependency to your Package.swift file and import the BlankSlate library into the desired targets:

dependencies: [
    .package(url: "https://github.com/liam-i/BlankSlate.git", from: "0.7.1")
],
targets: [
    .target(
        name: "MyTarget", dependencies: [
            .product(name: "BlankSlate", package: "BlankSlate")
        ])
]

...using Xcode

If you are using Xcode, then you should:

  • File > Swift Packages > Add Package Dependency
  • Add https://github.com/liam-i/BlankSlate.git
  • Select "Up to Next Minor" with "0.7.1"

Tip

For detailed tutorials, see: Apple Docs

CocoaPods

If you're using CocoaPods, add this to your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
# Or use CND source
# source 'https://cdn.cocoapods.org/'
platform :ios, '12.0'
use_frameworks!

target 'MyApp' do
  pod 'BlankSlate', '~> 0.7.1'
end

And run pod install.

Important

CocoaPods 1.13.0 or newer is required.

Carthage

If you're using Carthage, add this to your Cartfile:

github "liam-i/BlankSlate" ~> 0.7.1

And run carthage update --platform iOS --use-xcframeworks.

Example

To run the example project, first clone the repo, then cd to the root directory and run pod install. Then open BlankSlate.xcworkspace in Xcode.

Credits and thanks

License

BlankSlate is available under the MIT license. See the LICENSE file for more info.