What is the primary advantage of TextKit 2 over TextKit 1?

TextKit 2 replaces glyph-based logic with a more robust element-based architecture, offering better support for international scripts, thread-safety through value semantics, and improved performance via noncontiguous viewport layout.

Can I use this skill for macOS or visionOS development?

Yes, TextKit 2 is a cross-platform framework for all modern xOS environments, and this skill provides patterns applicable to both UIKit and AppKit implementations.

Does this skill provide code for NSRange to NSTextRange conversion?

Yes, it includes specific API naming heuristics and code snippets for bidirectional conversion between legacy NSRange and modern NSTextRange/NSTextLocation systems.

How do I avoid the TextKit 1 compatibility mode fallback?

The skill details how to properly initialize UITextView or NSTextView using the 'usingTextLayoutManager' flag and how to safely check for textLayoutManager before accessing legacy properties that trigger fallback.

Axiom TextKit 2 Reference

Name: Axiom TextKit 2 Reference
Author: CharlesWiltgen

byCharlesWiltgen

•

233

•

Mobile Development

Provides comprehensive architectural guidance and migration patterns for Apple's TextKit 2 framework through iOS 26.

This skill acts as a definitive technical resource for developers building sophisticated text-based interfaces on Apple platforms using TextKit 2. It covers the fundamental shift from legacy glyph-based APIs to modern element-based architectures, offering ready-to-use patterns for viewport layout, thread-safe value semantics, and international script handling. Whether you are migrating a legacy TextKit 1 codebase, implementing custom rendering surfaces, or integrating with Apple's latest Writing Tools, this skill provides the deep technical context and implementation shortcuts needed for high-performance text rendering across iOS, macOS, and visionOS.

Key Features

01Optimized viewport layout patterns for managing visible-only text rendering and performance.

02Best practices for preventing accidental fallback to legacy TextKit 1 compatibility mode.

03Technical guidance for Writing Tools integration and SwiftUI TextEditor customization.

04Deep architectural mapping of TextKit 2's Model-Controller-View layers and object-based ranges.

05233 GitHub stars

06Proven migration strategies for converting NSRange-based logic to modern NSTextLocation systems.

Use Cases

01Implementing specialized text interaction models that support international scripts and bidirectional text.

02Modernizing enterprise iOS applications from TextKit 1 to the performant TextKit 2 framework.

03Creating custom text editors with complex rendering requirements like bubble backgrounds or syntax highlighting.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add charleswiltgen/axiom axiom-textkit-ref

For use in Claude.ai and ChatGPT

Download Skill