Mihaela Mihaljevic
3eb01524a1
- Remove 39 .md poison stubs containing Apple's React 404 sub-view body
("The page you're looking for can't be found"). These predated the
cupertino JSON crawler and snuck in via an old AppleDocs-tool import.
- Remove 21 .md files whose .json sibling already covered the same URL
with richer content. The .json wins on every duplicate.
- Convert the remaining 43 .md gap-fillers to canonical
StructuredDocumentationPage JSON (source: appleWebKit). These covered
Apple URLs not present as .json: Metal sync guides, CGImageRef,
CoreImage transitions, StoreKit views, audiotoolbox render blocks,
several scenekit / metalperformanceshaders / cloudkit entry points.
The original markdown body is preserved verbatim in the rawMarkdown
field for full-text search.
- Source corpus is now JSON-only (412,523 files); the .md format is
retired.
Companion to the crawler-side defense merged at cupertino 0fcd246
(PR #432, #284 follow-up). Tagged v1.0.3 as the baseline for the
v1.0.3 bundle build.
|
||
|---|---|---|
| _archive/2026-03-13 | ||
| archive | ||
| docs | ||
| hig | ||
| packages | ||
| swift-evolution | ||
| swift-org | ||
| wwdc-research | ||
| .gitattributes | ||
| 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 Release: v0.9.0 — 234,331 documents across 287 frameworks
Contents
| Folder | Description | Source |
|---|---|---|
docs/ |
Apple Developer Documentation (287 frameworks) | developer.apple.com |
swift-evolution/ |
Swift Evolution Proposals | github.com/swiftlang/swift-evolution |
swift-org/ |
Swift.org Documentation | swift.org |
packages/ |
Swift Package Documentation | swiftpackageindex.com |
sample-code/ |
Apple Sample Code Projects | developer.apple.com |
archive/ |
Apple Legacy Archive Guides | developer.apple.com/library/archive |
Top Frameworks by Document Count
| Framework | Documents |
|---|---|
| Kernel | 24,747 |
| Matter | 22,013 |
| Swift | 17,466 |
| AppKit | 14,066 |
| Foundation | 10,988 |
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.