Apple HIG Mirror
A developer tool that turns Apple's browser-rendered Human Interface Guidelines into structured Markdown, with repeatable extraction, verification and scheduled updates.
Sole developer · March 2026View on GitHub (opens in a new tab)
In practice
What it does
- Discovers guideline pages and extracts their rendered content
- Normalises content into deterministic Markdown and frontmatter
- Rewrites internal links and generates a Mintlify preview configuration
- Verifies generated output and schedules incremental updates through GitHub Actions
Behind the work
The challenge
Extracting consistent content from a dynamic documentation site while preserving structure, keeping internal links useful and avoiding unnecessary changes in generated files.
What I learned
AI agents have become much better at retrieving context directly from live websites, and much better versed in Swift and Apple’s developer ecosystem. That changes the value of maintaining a separate documentation mirror. A useful lesson here is to keep reassessing the workarounds I build as the underlying capabilities improve.
Built with
- TypeScript
- Node.js
- Playwright
- Markdown
- GitHub Actions