Mihaela Mihaljevic
189190e571
Paired with mihaelamj/cupertino#1093 which splits swift-org and swift-book into independent fetchable sources. Migration: - cupertino-docs/swift-org/swift-book/ → cupertino-docs/swift-book/ - swift-book gets its own top-level corpus dir matching defaultOutputDirKey = .swiftBook - swift-org's metadata.json updated for the slimmer crawl Content refresh: - New cache snapshots from a forced fetch (8 minute crawl). All 43 topics now carry latest Apple content. Previously-orphan summaryofthegrammar + revisionhistory have fresh cache snapshots. swift-book.db consumers (cupertino save --source swift-book --clear) read from cupertino-docs/swift-book/ now, not from swift-org/swift-book/. |
||
|---|---|---|
| _archive/2026-03-13 | ||
| archive | ||
| docs | ||
| hig | ||
| swift-book | ||
| swift-evolution | ||
| swift-org | ||
| wwdc-research | ||
| .gitattributes | ||
| apple-constraints.json | ||
| LICENSE | ||
| README.md | ||
Cupertino Docs
Pre-crawled Apple and Swift documentation for use with Cupertino - an MCP server providing Apple Developer documentation for AI assistants.
Current corpus tag: v1.1.1 — 414,807 source files, 420 frameworks
Latest bundled release: v1.1.0 zip on Cupertino Releases — 285,735 indexed documents across 420 frameworks (next bundle, building from the v1.1.1 corpus, adds 2,285 new + 498 refreshed pages contributed by a sibling-Mac crawl, with 153 React-SPA-404 poison files filtered out at the merge boundary).
Contents
| Folder | Description | Source |
|---|---|---|
docs/ |
Apple Developer Documentation (420 frameworks) | developer.apple.com |
swift-evolution/ |
Swift Evolution Proposals (483 proposals) | github.com/swiftlang/swift-evolution |
swift-org/ |
Swift.org Documentation (196 pages) | swift.org |
hig/ |
Apple Human Interface Guidelines (173 pages) | developer.apple.com/design/human-interface-guidelines |
archive/ |
Apple Legacy Archive Guides (406 guides) | developer.apple.com/library/archive |
packages/ |
Swift Package READMEs (curated catalog) | swiftpackageindex.com |
sample-code/ |
Apple Sample Code Projects | developer.apple.com |
The bundled search.db indexes six sources (apple-docs, swift-evolution, swift-org, apple-archive, hig, swift-book). Swift Book content comes from the indexer's parse of the Swift Programming Language book; the raw book lives in swift-org/.
Top Frameworks by Document Count (v1.1.0 bundle)
| Framework | Documents |
|---|---|
| Kernel | 39,585 |
| Matter | 16,227 |
| Foundation | 10,372 |
| AppKit | 10,332 |
| UIKit | 9,078 |
| Swift | 9,026 |
| Accelerate | 7,863 |
| Security | 6,983 |
| CoreServices | 6,477 |
| SwiftUI | 6,440 |
Quick Start
Clone directly to the default Cupertino location:
git clone https://github.com/mihaelamj/cupertino-docs.git ~/.cupertino
Or download pre-built databases from Releases (~320 MB zip).
Updates
This repository is periodically updated with fresh crawls. Check releases for dated snapshots.
To crawl your own fresh copy, use the main Cupertino tool:
cupertino fetch --type all
Legal
This repository contains cached copies of publicly available documentation for offline use and AI training purposes.
- Apple documentation is © Apple Inc. See Apple's Terms of Use
- Swift Evolution proposals are © the respective authors, licensed under Apache 2.0
- Swift.org content is licensed under Apache 2.0
This repository is provided as-is for convenience. For authoritative documentation, refer to the original sources.