How do I create a custom card in BulletinBoard?

You can subclass BulletinPageItem or build a custom BulletinItem. The demo project includes examples in Swift and Objective-C showing how to add custom views and handle user interactions, with guidance in the documentation.

BulletinBoard vs native UIKit modals for onboarding?

BulletinBoard is optimized for bottom-screen cards with a native iOS feel, ideal for quick onboarding flows. Native modals offer more placement flexibility but require more code to achieve similar aesthetics and accessibility.

Does BulletinBoard work with SwiftUI?

BulletinBoard is built on UIKit, so it can be integrated into SwiftUI projects using UIViewControllerRepresentable. However, it's not natively designed for SwiftUI's declarative syntax, which may complicate modern app development.

Can I dismiss a BulletinBoard card programmatically?

Yes, cards can be dismissed programmatically by calling methods on the BulletinManager, such as `dismissCurrentBulletin(animated:)`. The documentation and demo apps provide specific examples for managing card flow.

Is BulletinBoard accessible for users with disabilities?

Yes, BulletinBoard has built-in support for accessibility features like VoiceOver and Switch Control, ensuring card interfaces are usable by all users without additional setup, as highlighted in the README.

What iOS versions does BulletinBoard support?

BulletinBoard supports iOS 9 and later, making it compatible with a wide range of devices. However, this broad support might mean it doesn't automatically leverage newer iOS APIs or design patterns.

Open-Awesome

BulletinBoard

MITSwift4.1.1

An iOS library for generating and managing contextual cards displayed at the bottom of the screen.

GitHub

5.3k stars301 forks0 contributors

What is BulletinBoard?

BulletinBoard is an iOS library that generates and manages contextual cards displayed at the bottom of the screen. It solves the need for quick, native-feeling user interactions like onboarding screens or configuration panels, mimicking iOS system card interfaces.

Target Audience

iOS developers building apps that require contextual user interactions, such as onboarding flows, configuration panels, or quick-action menus.

Value Proposition

Developers choose BulletinBoard for its native iOS-like card interface, built-in accessibility support, and compatibility with both Swift and Objective-C, making it easy to integrate into existing projects.

Overview

General-purpose contextual cards for iOS

Use Cases

Best For

Creating onboarding screens for iOS apps
Building configuration panels that slide up from the bottom
Implementing quick-action menus similar to iOS system interfaces
Developing accessible user interfaces with VoiceOver support
Adding contextual user interactions in Swift or Objective-C projects
Designing card-based UI components for iPhone and iPad

Not Ideal For

Apps requiring full-screen modal presentations or complex navigation flows
Cross-platform projects targeting Android or web alongside iOS
Teams wanting drop-in, pre-styled components without any subclassing or customization work

Pros & Cons

Pros

Native iOS Aesthetics

Cards mimic system interfaces like AirPods setup, ensuring design consistency with iOS, as shown in the demo screenshots.

Broad Device Support

Compatible with iPhone, iPhone X, and iPad, adapting automatically to different screen sizes per the README.

Built-in Accessibility

Supports VoiceOver and Switch Control out of the box, making apps inclusive without extra configuration.

Dual Language Compatibility

Works with both Swift 5.1+ and Objective-C, easing integration into diverse codebases, with demos provided for both.

Cons

Bottom-Screen Only

Cards are confined to the bottom of the screen, limiting use for modals that need to appear in other locations like the center or top.

iOS Exclusive

Only available for iOS with no support for other platforms, restricting its use in cross-platform or multi-OS projects.

Customization Overhead

Creating highly custom cards requires subclassing or building from scratch, which can be time-consuming compared to more plug-and-play solutions.

Frequently Asked Questions

Related Projects

SkeletonView

☠️ An elegant way to show users that something is happening and also prepare them to which contents they are awaiting

Stars12,890

Forks1,122

Last commit4 months ago

Material

A UI/UX framework for creating beautiful applications.

Stars12,017

Forks1,260

Last commit4 years ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,700

Forks1,153

Last commit7 months ago

SwiftMessages

A very flexible message bar for UIKit and SwiftUI.

Stars7,544

Forks765

Last commit9 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub