PagerKit

What This Skill Does

The PagerKit skill acts as an expert technical companion for the PagerKit SwiftUI library. It empowers developers to implement advanced, customizable page-based navigation with ease. The skill provides deep architectural insights into PKPagesView and PKPage components, ensuring that developers can handle dynamic content, complex state management, and platform-specific UI configurations effectively. Whether you are building an onboarding flow for iOS, a documentation carousel for macOS, or a custom tabbed experience, this skill offers idiomatic solutions that adhere to SwiftUI best practices, ensuring your code remains clean, maintainable, and highly performant.

Installation

To integrate this skill into your environment, use the OpenClaw CLI tool to fetch the package from the official source repository:

clawhub install openclaw/skills/skills/szpakkamil/pagerkit

Ensure that your project meets the minimum requirements: Swift 5.9 or higher, and a deployment target of at least iOS 14.0, iPadOS 14.0, macOS 14.0, tvOS 14.0, watchOS 10.0, or visionOS 1.0.

Use Cases

• Dynamic Content: Efficiently rendering a list of data objects into individual PKPage instances using ForEach or PKPageBuilder.
• Custom UI Components: Creating bespoke page indicators, navigation controls, or transition effects that integrate seamlessly with PKPagesView.
• Cross-Platform Consistency: Managing page layouts that need to function identically across iPhone, iPad, and macOS, while gracefully handling platform-specific constraints.
• Complex Navigation Flow: Implementing conditional page rendering based on user interaction or state shifts within the application.
• Event Handling: Wiring up programmatic navigation and observing page change events to trigger analytics or business logic.

Example Prompts

1. "How can I dynamically render a list of 10 items into a horizontally scrolling PKPagesView while updating a custom indicator based on the current page index?"
2. "I need to implement a vertical paging layout for my macOS app using PagerKit. What modifier should I use to switch the navigation orientation, and are there any specific quirks for the macOS target?"
3. "Show me the best way to use PKPageBuilder to include an optional 'Terms of Service' page only if the user hasn't accepted it yet."

Tips & Limitations

• Stay Idiomatic: Always prefer PKPageBuilder for structured content. Avoid complex view hierarchies inside PKPage that bypass standard SwiftUI data flow (like @State or @Binding).
• Platform awareness: Always use #if os(...) blocks when working with native controllers that aren't available across all Apple devices. PagerKit abstracts much of this, but deep customization may still require platform-specific tuning.
• Performance: When dealing with large datasets, ensure that the data backing your PKPagesView is efficient, and use lazy loading patterns where applicable to keep the main thread responsive during swipe interactions.
• Documentation: The library is strictly SwiftUI; do not attempt to force UIKit-specific controller logic outside of the supported modifiers.