Fragment

A native iOS and macOS app for managing GitHub Gists with a code-focused editor, offline-friendly cache, and shared SwiftUI codebase.

Highlights

• Native SwiftUI app for iOS and macOS
• GitHub gist authentication via personal access token stored in Keychain
• Local cached gist browsing when GitHub is unavailable
• Search with power-user filters like ext:swift, visibility:public, and state:cached
• Save review flow with diff summaries and remote conflict checks
• Shared logic tests for caching, search, and diff behavior

Requirements

• iOS 26.0+ or macOS 26.0+
• Xcode 26.0+
• A GitHub personal access token with the gist scope

Build

xcodebuild -scheme macOS -configuration Debug build
xcodebuild -scheme iOS -configuration Debug build

Test

xcodebuild test -scheme macOS
xcodebuild test -scheme iOS -destination "platform=iOS Simulator,name=iPhone 16 Pro"

Architecture

The app uses a shared SwiftUI codebase with a small coordinator/service split:

• SessionHandler coordinates app state
• GistDocument is the app-owned gist model
• AuthenticationService and GistService wrap GitHub API work
• GistCacheStore handles the offline snapshot

Start with docs/architecture.md for more detail.

Repo guide

• Contributing
• Architecture
• Testing
• AI readiness
• Roadmap

Dependencies

• OctoKit
• KeychainAccess
• CodeEditor
• Highlightr
• SFSafeSymbols
• DHCacheKit

SwifterSwift is no longer used in this repo.

Community

• Report bugs
• Request features
• Contributing
• Code of conduct
• Project roadmap