Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bence-t0th/customalertkit

CustomAlertKit provides a customizable bottomsheet, snackbar and alert for any SwiftUI View. Available for CocoaPods and Swift Package Manager.
https://github.com/bence-t0th/customalertkit

cocoapod swift-package-manager swiftui

Last synced: 24 days ago
JSON representation

CustomAlertKit provides a customizable bottomsheet, snackbar and alert for any SwiftUI View. Available for CocoaPods and Swift Package Manager.

Awesome Lists containing this project

README

        

# CustomAlertKit

[![Version](https://img.shields.io/cocoapods/v/CustomAlertKit.svg?style=flat)](https://cocoapods.org/pods/CustomAlertKit)
[![License](https://img.shields.io/cocoapods/l/CustomAlertKit.svg?style=flat)](https://cocoapods.org/pods/CustomAlertKit)
[![Platform](https://img.shields.io/cocoapods/p/CustomAlertKit.svg?style=flat)](https://cocoapods.org/pods/CustomAlertKit)
[![SPM](https://img.shields.io/badge/SPM-supported-gree.svg?style=flat)](https://swift.org/package-manager/)

## Installation
CustomAlertKit supports [Swift Package Manager](https://www.swift.org/package-manager/) and [CocoaPods](https://cocoapods.org/).

### Swift Package Manager

To install CustomAlertKit using Swift Package Manager you can follow the [tutorial published by Apple](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app) using the URL for the repo:

1. In Xcode, select “File” → “Add Packages Dependencies”
1. Enter https://github.com/bence-t0th/CustomAlertKit.git

### CocoaPods

Add the pod to your Podfile:
```ruby
pod 'CustomAlertKit'
```
And then run:
```ruby
pod install
```
After installing the cocoapod into your project import CustomAlertKit with
```swift
import CustomAlertKit
```
## Usage

### Bottomsheet

![Bottomsheet](Gifs/bottomsheet.gif)

```swift
@State var bottomsheetVisible = false

var body: some View {
...
}
.bottomSheet(visible: $bottomsheetVisible, background: .blur(.regular), contentBackgroundColor: .white) {
Text("This is a bottomsheet with blurred background")
.frame(height: 250)
}
}
```

### Snackbar

![Snackbar](Gifs/snackbar.gif)

```swift
@State var snackbarVisible = false

var body: some View {
...
}
.snackbar(visible: $snackbarVisible) {
Text("This is a snackbar")
.padding(16)
.background(.green)
.clipShape(Capsule())
}
}
```

### Alert

![Alert](Gifs/alert.gif)

```swift
@State var alertVisible = false

var body: some View {
...
}
.alert(visible: $alertVisible, background: .color(.black.opacity(0.4))) {
VStack {
Text("This is an alert with opaque background")
Button(action: {
withAnimation {
alertVisible.toggle()
}
}, label: {
Text("Close")
})
}
.padding(32)
.background(.red)
}
}
```

## Requirements

CustomAlertKit requires iOS 15 deployment target, and it is compatible only with SwiftUI.

## Author

[Bence Tóth](https://linkedin.com/in/bence-t0th/)

## License

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