How do I change the button icon in ConcentricOnboarding?

You can customize the next button icon by passing the 'nextIcon' parameter with a system icon name like 'chevron.forward', as shown in the README usage example. This allows quick alignment with your app's design language.

Is ConcentricOnboarding or a custom SwiftUI view better for onboarding?

ConcentricOnboarding saves time with pre-built animations and navigation for standard flows, but for highly unique designs or complex logic, a custom SwiftUI view might offer more control and flexibility.

Can I use ConcentricOnboarding with UIKit views?

No, it's built entirely with SwiftUI and doesn't natively support UIKit components. You'd need to wrap UIKit views in SwiftUI or look for alternative libraries that bridge both frameworks.

How to handle user input like text fields in ConcentricOnboarding?

The library focuses on tap-based navigation, so for input handling, integrate custom views with state management and use the provided closures or programmatic methods to control page transitions and logic.

What are the performance considerations with many onboarding pages?

While animations are smooth, having numerous pages or complex views could impact performance on older devices. It's advisable to test with your specific content and optimize views to maintain responsiveness.

Does ConcentricOnboarding support dynamic content loading?

No, it requires predefined pages and background colors in an array, so content must be static at runtime. For dynamic updates, you'd need to manually refresh the array or consider other solutions.

Open-Awesome

ConcentricOnboarding

MITSwift

A SwiftUI library for creating animated walkthrough or onboarding flows with tap actions for iOS apps.

GitHub

1.6k stars89 forks0 contributors

What is ConcentricOnboarding?

Concentric Onboarding is a SwiftUI library designed for iOS developers to create animated walkthrough or onboarding flows within their apps. It solves the problem of building engaging introductory experiences by providing a ready-to-use component with smooth, concentric animations and customizable pages. Developers can quickly implement onboarding that guides users through app features with tap-based navigation.

Target Audience

iOS developers using SwiftUI who need to add onboarding or walkthrough screens to their applications, particularly those targeting iOS 14 and above.

Value Proposition

Developers choose Concentric Onboarding for its simplicity, native SwiftUI integration, and visually appealing animations out of the box. It reduces the effort required to build custom onboarding flows while offering flexibility through programmatic navigation control and customizable closures.

Overview

SwiftUI library for a walkthrough or onboarding flow with tap actions

Use Cases

Best For

Adding animated onboarding screens to iOS apps
Creating walkthroughs for new app features
Building SwiftUI-based tutorial flows
Implementing tap-based navigation in onboarding
Developing iOS apps with engaging user introductions
Quickly prototyping onboarding experiences in SwiftUI

Not Ideal For

Projects targeting iOS versions below 14.0
Apps built with UIKit instead of SwiftUI
Teams needing server-driven onboarding content updates without app redeploys

Pros & Cons

Pros

Native SwiftUI Integration

Built entirely with SwiftUI, ensuring seamless integration with modern iOS development and declarative syntax, as highlighted in the Key Features.

Smooth Animated Transitions

Provides concentric animations with adjustable duration and customizable next button icons, offering a polished user experience out of the box, as demonstrated in the usage examples.

Flexible Navigation Control

Includes programmatic methods like goToNextPage and assignable closures for custom logic, allowing developers to tailor the flow precisely to app needs.

Easy Customization

Supports custom views and background colors for each page, making it straightforward to match app design without extensive modifications, as shown in the basic setup.

Cons

Limited Platform Support

Only compatible with iOS 14 and above, excluding older devices and other platforms like Android or macOS, which restricts cross-platform use.

Deprecated Installation Options

Cocoapods support is deprecated after version 1.0.5, forcing reliance on Swift Package Manager and potentially complicating dependency management for teams using other systems.

Fixed Animation Style

Centered on concentric animations, so projects requiring different animation patterns or complex interactions may find it inflexible without significant customization.

Frequently Asked Questions

Related Projects

Onboard

An iOS framework to easily create a beautiful and engaging onboarding experience with only a few lines of code.

Stars6,575

Forks750

Last commit1 year ago

JazzHands

A simple keyframe-based animation framework for UIKit. Perfect for scrolling app intros.

Stars6,363

Forks660

Last commit2 years ago

Instructions

Create walkthroughs and guided tours (coach marks) in a simple way, with Swift.

Stars5,199

Forks479