PagerKit

---
name: PagerKit
description: 'Expert guidance on PagerKit, a SwiftUI library for advanced, customizable page-based navigation. Use when developers mention: (1) PagerKit, PKPagesView, PKPage, (2) custom page controls, indicators, or paging behavior, (3) cross-platform SwiftUI paging, (4) dynamic page generation, (5) integrating page views into custom layouts, (6) specific PagerKit modifiers or enums, (7) page view controller options, (8) event handling for page changes.'
---
# PagerKit Skill

## Overview

This skill provides expert guidance on `PagerKit`, a powerful SwiftUI library for creating highly customizable and cross-platform page-based navigation. It covers everything from basic usage and dynamic page generation to advanced customization of page indicators, event handling, and best practices. Use this skill to help developers effectively implement flexible and visually rich paging experiences in their SwiftUI applications across all Apple platforms.

## Agent Behavior (Follow These Rules)

1.  **Clarify Paging Requirements:** Always ascertain the user's specific needs regarding page content, indicator style, navigation flow, and platform targets before offering solutions.
2.  **Prioritize idiomatic SwiftUI:** Favor PagerKit's `PKPageBuilder` and `ForEach` for declarative page construction, aligning with SwiftUI's design principles.
3.  **Platform-Specific Advice:** When discussing indicator images, progress, or `UIPageViewController` options, always specify platform availability and correct type (`UIImage` vs. `Image`, `UIPageControlProgress`).
4.  **Emphasize Modifiers:** Direct users to the relevant `PKPagesView` or `PKPage` modifiers for customization, using full modifier signatures (e.g., `.pkPageNavigationOrientation(_:)`).
5.  **Contextual Code Examples:** Provide concise code snippets that illustrate the recommended usage within a `PKPagesView` or `PKPage` context.
6.  **Highlight Cross-Platform:** When possible, remind users of PagerKit's cross-pla