Paperkit
Add drawings, shapes, and a consistent markup experience using PaperKit.
Install
npx skills add dpearson2699/swift-ios-skills --skill paperkit -g -a claude-code -y- Repository
- dpearson2699/swift-ios-skills1.3k
- Category
- AI and agents
- Updated
- 3mo ago
- License
- See repository
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Add drawings, shapes, and a consistent markup experience using PaperKit. Use when integrating PaperMarkupViewController for markup editing, adding shape recognition, working with PaperMarkup data models, embedding markup tools in document editors, or building annotation features that need the system-standard markup toolbar. New in iOS 26.
PaperKit
Beta-sensitive. PaperKit is new in iOS/iPadOS 26, macOS 26, and visionOS 26. API surface may change. Verify details against current Apple documentation before shipping.
PaperKit combines PencilKit drawing with structured markup elements such as shapes, text, images, and lines in a canvas managed by PaperMarkupViewController.
Contents
- Setup
- Workflow
- PaperMarkupViewController
- PaperMarkup Data Model
- Insertion Controllers
- FeatureSet Configuration
- Integration with PencilKit
- SwiftUI Integration
- Common Mistakes
- Review Checklist
- References
Workflow
- Choose the document bounds, supported
FeatureSet, and persistence version before constructing UI. - Create
PaperMarkup, embedPaperMarkupViewController, and keep the controller, tool picker, and insertion controller alive for the view lifetime. - Use the platform-appropriate insertion surface and keep PencilKit drawing inside the PaperKit document boundary.
- Save off the main thread, retain a thumbnail for forward-incompatible content, and test round-trip loading with the same feature set.
- On failure, restore the original document bytes, fix the feature-set/version/controller mismatch, and rerun edit, save, relaunch, load, thumbnail fallback, and undo checks.
Load references/paperkit-patterns.md for full platform setup, tool picker wiring, persistence, thumbnails, custom feature sets, programmatic construction, and migration.
Setup
PaperKit requires no entitlements or special Info.plist entries.
import PaperKit
Platform availability: iOS 26.0+, iPadOS 26.0+, Mac Catalyst 26.0+, macOS 26.0+, visionOS 26.0+.
Three core components:
