# Apple Developer Docs (mirror)

> A locally-indexed, search- and AI-friendly mirror of Apple's developer
> documentation, Human Interface Guidelines, WWDC transcripts, Swift Evolution
> proposals, and more. Optimised for ingestion by both classic search engines
> and large language models.

The corpus is rebuilt regularly from `developer.apple.com` and surfaced at
clean URLs that mirror Apple's own slugs. Every page links back to its
upstream original via `<link rel="alternate">`.

## Content licensing & attribution

The underlying content remains the property of Apple Inc. and is reproduced
under the limited-purpose terms permitted for documentation indexing and
research. AI ingestion is welcomed (`ai-input=yes`, `ai-train=yes` in
`robots.txt` content-signals); please attribute to `apple-docs.everest.mt`
and link back to the canonical Apple URL emitted on each page.

## Entry points

- [Homepage](https://apple-docs.everest.mt/) — index of every framework / kind.
- [Search page](https://apple-docs.everest.mt/search) — server- and client-side
  search across all 353 K+ documents, with filters by framework / language /
  platform / WWDC year.
- [Sitemap index](https://apple-docs.everest.mt/sitemap.xml) — points at one
  per-framework sitemap; preferred entry for crawlers.

## Bulk lookup endpoints

- [Title index](https://apple-docs.everest.mt/data/search/title-index.json) —
  columnar JSON with every document's `key`, `title`, `framework`, `kind`,
  `role_heading`, `abstract`. ~42 MB; cache-friendly under
  `Cache-Control: public, max-age=31536000, immutable` once content-hashed.
- [Search manifest](https://apple-docs.everest.mt/data/search/search-manifest.json)
  — small JSON pointing at the current hashed artifact filenames.

## Markdown for agents

Every documentation page is also available as Markdown: append `.md` to any
doc URL — e.g. <https://apple-docs.everest.mt/docs/swiftui/view.md> returns the
same body the MCP `read_doc` tool serves, as `text/markdown`, cached under its
own URL. Each HTML page advertises this with a
`<link rel="alternate" type="text/markdown">` in its head.

## Top frameworks

- [SwiftUI](https://apple-docs.everest.mt/docs/swiftui/)
- [UIKit](https://apple-docs.everest.mt/docs/uikit/)
- [AppKit](https://apple-docs.everest.mt/docs/appkit/)
- [Foundation](https://apple-docs.everest.mt/docs/foundation/)
- [Swift](https://apple-docs.everest.mt/docs/swift/)
- [Combine](https://apple-docs.everest.mt/docs/combine/)
- [Core Data](https://apple-docs.everest.mt/docs/coredata/)
- [SwiftData](https://apple-docs.everest.mt/docs/swiftdata/)
- [Metal](https://apple-docs.everest.mt/docs/metal/)
- [WebKit](https://apple-docs.everest.mt/docs/webkit/)
- [Human Interface Guidelines](https://apple-docs.everest.mt/docs/design/)
- [Swift Evolution Proposals](https://apple-docs.everest.mt/docs/swift-evolution/)
- [WWDC Sessions](https://apple-docs.everest.mt/docs/wwdc/)

## Crawl etiquette

- Honour `Cache-Control` headers; pages under `/docs/*` change at most a few
  times a week.
- Prefer the bulk endpoints (`/data/search/title-index.json`) over walking the
  link graph when doing large-scale ingestion.
- Per-IP rate-limited at the edge for `/api/search`; classic crawls of HTML
  pages are unrestricted but observed via Cloudflare metrics.

## Source

The mirror is generated by the `apple-docs` project:
<https://github.com/g-cqd/apple-docs>
