Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/alexisakers/BulletinBoard

General-purpose contextual cards for iOS
https://github.com/alexisakers/BulletinBoard

card configuration ios onboarding swift

Last synced: 3 months ago
JSON representation

General-purpose contextual cards for iOS

Host: GitHub
URL: https://github.com/alexisakers/BulletinBoard
Owner: alexisakers
License: mit
Created: 2017-09-26T07:43:43.000Z (about 7 years ago)
Default Branch: develop
Last Pushed: 2022-05-16T18:03:28.000Z (over 2 years ago)
Last Synced: 2024-05-04T10:41:18.045Z (6 months ago)
Topics: card, configuration, ios, onboarding, swift
Language: Swift
Homepage:
Size: 28.3 MB
Stars: 5,360
Watchers: 74
Forks: 305
Open Issues: 47
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-ios - BulletinBoard - Generate and Display Bottom Card Interfaces on iOS (UI / Alert & Action Sheet)
awesome-swift - BulletinBoard - Generates and manages contextual cards displayed at the bottom of the screen. (Libs / UI)
awesome-cocoa - BulletinBoard
fucking-awesome-swift - BulletinBoard - Generates and manages contextual cards displayed at the bottom of the screen. (Libs / UI)
awesome-swift - BulletinBoard - General-purpose contextual cards for iOS ` 📝 5 months ago ` (UI [🔝](#readme))

README

        # BulletinBoard

[![Version](https://img.shields.io/cocoapods/v/BulletinBoard.svg?style=flat)](https://cocoapods.org/pods/BulletinBoard)

[![License](https://img.shields.io/cocoapods/l/BulletinBoard.svg?style=flat)](https://cocoapods.org/pods/BulletinBoard)

[![Platform](https://img.shields.io/cocoapods/p/BulletinBoard.svg?style=flat)](https://cocoapods.org/pods/BulletinBoard)

[![Documentation](https://img.shields.io/badge/Documentation-available-blue.svg)](https://alexisakers.github.io/BulletinBoard)

[![Contact: @_alexaubry](https://raw.githubusercontent.com/alexaubry/BulletinBoard/main/.assets/twitter_badge.svg?sanitize=true)](https://twitter.com/_alexaubry)

BulletinBoard is an iOS library that generates and manages contextual cards displayed at the bottom of the screen. It is especially well suited for quick user interactions such as onboarding screens or configuration.

It has an interface similar to the cards displayed by iOS for AirPods, Apple TV/HomePod configuration and NFC tag scanning. It supports both the iPhone, iPhone X and the iPad.

It has built-in support for accessibility features such as VoiceOver and Switch Control.

Here are some screenshots showing what you can build with BulletinBoard:

![Demo Screenshots](https://raw.githubusercontent.com/alexaubry/BulletinBoard/main/.assets/demo_screenshots.png)

## Requirements

- Xcode 11 and later

- iOS 9 and later

- Swift 5.1 and later (also works with Objective-C).

## Demo

A demo project is included in the `BulletinBoard` workspace. It demonstrates how to:

- integrate the library (setup, data flow)

- create standard page cards

- create custom page subclasses to add features

- create custom cards from scratch

Two demo targets are available:

- `BB-Swift` (demo written in Swift)

- `BB-ObjC` (demo written in Objective-C)

Build and run the scheme for your favorite language to open the demo app.

## Installation

### Swift Package Manager

To install BulletinBoard using the [Swift Package Manager](https://swift.org/package-manager/), add this dependency to your `Package.swift` file:

~~~swift

.package(url: "https://github.com/alexaubry/BulletinBoard.git", from: "5.0.0")

~~~

### CocoaPods

To install BulletinBoard using [CocoaPods](https://cocoapods.org), add this line to your `Podfile`:

~~~ruby

pod 'BulletinBoard'

~~~

### Carthage

To install BulletinBoard using [Carthage](https://github.com/Carthage/Carthage), add this line to your `Cartfile`:

~~~

github "alexaubry/BulletinBoard"

~~~

## Documentation

- The full library documentation is available [here](https://alexisakers.github.io/BulletinBoard).

- To learn how to start using `BulletinBoard`, check out our [Getting Started](https://alexisakers.github.io/BulletinBoard/getting-started.html) guide.

## Contributing

Thank you for your interest in the project! Contributions are welcome and appreciated.

Make sure to read these guides before getting started:

- [Code of Conduct](https://github.com/alexaubry/BulletinBoard/blob/master/CODE_OF_CONDUCT.md)

- [Contribution Guidelines](https://github.com/alexaubry/BulletinBoard/blob/master/CONTRIBUTING.md)

## Author

Written by Alexis Aubry. You can [find me on Twitter](https://twitter.com/_alexaubry).

## License

BulletinBoard is available under the MIT license. See the [LICENSE](LICENSE) file for more info.