🍎 HIG Lab

Apple Frameworks를 코드로 실습하는 곳

🇰🇷 한국어 | 🇺🇸 English

Apple의 367개 프레임워크 중 핵심 50개를 실전 중심으로 학습합니다. 각 기술별로 4가지를 제공:

📝 블로그 포스트 — HIG 가이드라인 한글 해설 + 실전 예제
📚 DocC 튜토리얼 — Xcode에서 바로 실습 가능한 step-by-step 가이드 (10챕터)
💻 샘플 프로젝트 — 시니어급 완성도의 SwiftUI 앱 (평균 5,000줄+)
🛠️ AI Skills — Claude Code, Cursor, Copilot에서 바로 사용 가능한 설정 파일

🌱 주니어 개발자라면? → 시작 가이드 (GETTING_STARTED.md)를 먼저 읽어보세요!

📊 진행 상황

구분	완료	진행률
📝 블로그	50/50	100% ✅
📚 DocC	50/50 (10챕터+)	100% ✅
💻 샘플	43개 (50기술 커버)	100% ✅
🛠️ Skills	3종 (Claude/Cursor/Copilot)	100% ✅

🎉 프로젝트 완성! 50개 기술 전체 커버리지 달성

📈 프로젝트 규모

총 샘플 프로젝트: 43개
총 Swift 파일: 468개
총 코드 라인: 148,411줄
평균 샘플 규모: 3,450줄 (시니어급 품질)

💻 샘플 프로젝트 (43개)

🚀 Phase 1: App Frameworks

샘플	기술	규모	설명
WeatherWidget	WidgetKit, WeatherKit	5,577줄	모든 위젯 크기 + 인터랙티브
TaskMaster	SwiftUI, SwiftData, Observation	1,647줄	CRUD + 동기화
DeliveryTracker	ActivityKit	1,766줄	Live Activity + Dynamic Island
SiriTodo	App Intents	5,689줄	12종 인텐트 + 위젯
AIChatbot	Foundation Models	6,285줄	Tool 사용 + 스트리밍

💳 Phase 2: App Services

샘플	기술	규모	설명
SubscriptionApp	StoreKit 2	2,043줄	구독 + 인앱결제
PremiumApp	StoreKit 2	1,900줄	인앱결제 + 복원
CartFlow	PassKit	5,391줄	Apple Pay 완전 구현
CloudNotes	CloudKit	1,952줄	iCloud 동기화
SecureVault	AuthServices, LocalAuth, CryptoKit	5,935줄	Sign in with Apple + 생체인증 + 암호화
HealthTracker	HealthKit	3,929줄	걸음수/심박수/수면/운동
PlaceExplorer	MapKit	1,793줄	지도 + POI
LocationTracker	Core Location	3,429줄	GPS + 지오펜싱
MLClassifier	Core ML	5,502줄	Vision + 실시간 분류
VisionScanner	Vision, Visual Intelligence	2,131줄	OCR + 객체 인식
NotifyMe	User Notifications	2,684줄	로컬/푸시 알림
TipShowcase	TipKit	6,694줄	전체 시나리오
WatchParty	SharePlay	3,296줄	GroupActivity + 동기화 재생

🎮 Phase 3: Graphics & Media

샘플	기술	규모	설명
ARFurniture	ARKit, RealityKit	2,064줄	AR 가구 배치
SpaceShooter	SpriteKit	2,804줄	2D 슈팅 게임
FilterLab	Core Image	2,516줄	30+ 필터 + Metal 커널
SketchPad	PencilKit	1,750줄	드로잉 앱
PDFReader	PDFKit	3,057줄	PDF 뷰어/편집
CameraApp	AVFoundation	6,046줄	전체 카메라 기능
MusicPlayer	MusicKit, AVKit	1,591줄	Apple Music 연동
PhotoGallery	PhotosUI	6,326줄	갤러리 + 편집
HapticDemo	Core Haptics	2,757줄	햅틱 패턴 에디터
SoundMatch	ShazamKit	5,484줄	음악 인식 + MusicKit
ImageMaker	Image Playground	2,775줄	AI 이미지 생성

🔧 Phase 4: System & Network

샘플	기술	규모	설명
BLEScanner	Core Bluetooth	2,237줄	BLE 기기 연결
NFCReader	Core NFC	3,599줄	태그 읽기/쓰기
PeerChat	MultipeerConnectivity	2,677줄	P2P 채팅
NetMonitor	Network	2,447줄	네트워크 모니터링
VoIPPhone	CallKit	2,840줄	VoIP 전화
CalendarPlus	EventKit	3,306줄	캘린더 + 리마인더
ContactBook	Contacts	3,330줄	연락처 관리
DirectShare	Wi-Fi Aware	2,718줄	AP 없는 P2P 전송

🆕 Phase 5: iOS 26

샘플	기술	규모	설명
WakeUp	AlarmKit	2,761줄	시스템 알람
GreenCharge	EnergyKit	4,399줄	전력망 예보
PermissionHub	PermissionKit	3,497줄	통합 권한 관리
SmartFeed	RelevanceKit	3,921줄	콘텐츠 추천
DevicePair	AccessorySetupKit	2,729줄	액세서리 페어링
SmartCrop	ExtensibleImage	3,137줄	AI 이미지 편집

📚 DocC 튜토리얼 (50개)

모든 튜토리얼은 10챕터 이상으로 구성되어 있습니다.

# 튜토리얼 실행 예시
cd tutorials/widgets
swift package generate-documentation --target HIGWidgets

🏆 시니어급 코드 품질

모든 샘플 프로젝트는 10년차 Apple 개발자 기준 9/10 품질을 목표로 합니다:

✅ 핵심 API 완전 활용 — 각 프레임워크의 주요 클래스/프로토콜 사용
✅ 에러 처리 — 커스텀 에러 타입 + LocalizedError
✅ Swift Concurrency — async/await + Actor 패턴
✅ Accessibility — VoiceOver 지원
✅ 문서화 — /// 주석 완비
✅ SwiftUI Previews — #Preview 매크로 활용

📁 프로젝트 구조

HIGLab/
├── site/                    # 📝 블로그 (50개)
│   ├── index.html
│   └── {framework}/01-*.html
├── tutorials/              # 📚 DocC 튜토리얼 (50개)
│   └── {framework}/        # Swift Package + DocC
├── samples/               # 💻 샘플 프로젝트 (43개)
│   └── {SampleName}/      # 완성된 SwiftUI 앱
├── ai-reference/          # 🤖 AI Reference (50개)
│   └── {framework}.md
├── skills/                # 🛠️ AI Skills (Claude/Cursor/Copilot)
│   ├── claude-code/
│   ├── cursor/
│   └── copilot/
└── SSOT.json              # Single Source of Truth

🤖 AI Reference (50개)

AI가 iOS 코드를 정확하게 생성할 수 있도록 설계된 참조 문서입니다.

👉 사용 가이드 보기 — 프롬프트 작성법, 실전 예제, 문제 해결 팁 👉 전체 문서 목록 — 50개 AI Reference 카탈로그

App Frameworks (8개)

문서	설명
swiftui.md	SwiftUI 기본
swiftui-observation.md	@Observable 상태 관리
swiftdata.md	SwiftData CRUD
widgets.md	WidgetKit 위젯 구현
activitykit.md	Live Activity, Dynamic Island
appintents.md	Siri, 단축어 통합
foundation-models.md	온디바이스 LLM
tipkit.md	기능 팁, 온보딩

App Services (16개)

문서	설명
storekit.md	인앱결제, 구독
passkit.md	Apple Pay, Wallet
cloudkit.md	iCloud 동기화
authservices.md	Sign in with Apple
localauth.md	Face ID / Touch ID
cryptokit.md	암호화/해싱
healthkit.md	건강 데이터
mapkit.md	지도, POI
corelocation.md	GPS, 지오펜싱
coreml.md	온디바이스 ML
vision.md	이미지 분석, OCR
notifications.md	푸시/로컬 알림
shareplay.md	FaceTime 함께 보기
eventkit.md	캘린더/리마인더
contacts.md	연락처 관리
musickit.md	Apple Music 통합

Graphics & Media (13개)

문서	설명
arkit.md	증강현실
realitykit.md	3D 렌더링
spritekit.md	2D 게임 엔진
coreimage.md	이미지 필터
pencilkit.md	Apple Pencil 드로잉
pdfkit.md	PDF 뷰어/편집
avfoundation.md	카메라, 오디오
avkit.md	비디오 재생
photosui.md	사진 라이브러리
corehaptics.md	햅틱 피드백
shazamkit.md	음악 인식
image-playground.md	AI 이미지 생성
weatherkit.md	날씨 데이터

System & Network (6개)

문서	설명
core-bluetooth.md	BLE 기기 연결
core-nfc.md	NFC 태그 읽기/쓰기
multipeerconnectivity.md	P2P 통신
network.md	저수준 네트워크
callkit.md	VoIP 통화
wifi-aware.md	Wi-Fi 직접 연결

iOS 18+ Apple Intelligence (7개)

문서	설명
visual-intelligence.md	시각 분석
alarmkit.md	알람 시계
energykit.md	에너지 데이터
permissionkit.md	통합 권한 관리
relevancekit.md	맥락 기반 추천
accessorysetupkit.md	액세서리 페어링
extensibleimage.md	이미지 편집 확장

💡 Claude, GPT, Cursor 등에 문서를 제공하면 정확한 iOS 코드 생성 가능!

📁 프로젝트 구조

HIGLab/
├── site/                    # 📝 블로그 (50개)
│   ├── index.html
│   └── {framework}/
├── tutorials/              # 📚 DocC 튜토리얼 (50개)
│   └── {framework}/        # Swift Package + DocC
├── samples/               # 💻 샘플 프로젝트 (43개)
│   └── {SampleName}/      # 완성된 SwiftUI 앱 + README.md
├── ai-reference/          # 🤖 AI Reference (50개)
│   └── {framework}.md
├── skills/                # 🛠️ AI Skills (Claude/Cursor/Copilot)
│   ├── claude-code/
│   ├── cursor/
│   └── copilot/
└── SSOT.json              # Single Source of Truth

🚀 시작하기

블로그 보기

open https://m1zz.github.io/HIGLab/

DocC 튜토리얼 실행

cd tutorials/widgets
swift package --disable-sandbox preview-documentation --target HIGWidgets

샘플 프로젝트 실행

각 샘플 폴더의 README.md를 참고하세요.

cd samples/WeatherWidget
cat README.md

🛠️ AI Skills — AI 코딩 도구 연동

Skills가 뭔가요?

AI 코딩 도구(Claude Code, Cursor, Copilot)가 iOS 코드를 더 정확하게 생성하도록 도와주는 설정 파일입니다.

문제: AI는 종종 deprecated API를 사용하거나, iOS 17+ 최신 패턴(@Observable, SwiftData)을 모릅니다.
해결: HIG Lab의 AI Reference를 Skills로 연동하면, AI가 50개 Apple 프레임워크의 최신 베스트 프랙티스를 참고합니다.

👉 상세 설치 가이드

📦 빠른 설치

Claude Code — `/hig` 커맨드

# 전역 설치 (모든 프로젝트에서 사용)
mkdir -p ~/.claude/commands
curl -o ~/.claude/commands/hig.md https://raw.githubusercontent.com/M1zz/HIGLab/main/skills/claude-code/hig.md

Cursor

# 프로젝트 루트에 복사
curl -o .cursorrules https://raw.githubusercontent.com/M1zz/HIGLab/main/skills/cursor/.cursorrules

GitHub Copilot

mkdir -p .github
curl -o .github/copilot-instructions.md https://raw.githubusercontent.com/M1zz/HIGLab/main/skills/copilot/copilot-instructions.md

💡 사용 예시

Claude Code에서 `/hig` 커맨드 사용

You: /hig storekit
     인앱결제 기능을 추가해줘

AI:  (StoreKit 2 AI Reference를 자동으로 불러온 후)
     Product.products(for:)와 @Observable 패턴으로 구현합니다...

한국어 키워드도 지원합니다:

/hig 인앱결제    → StoreKit 2
/hig 위젯       → WidgetKit
/hig 생체인증    → LocalAuthentication
/hig list      → 50개 프레임워크 전체 목록

Before & After

	Before (Skills 없이)	After (Skills 적용)
상태관리	`@StateObject`, `ObservableObject`	✅ `@Observable` (iOS 17+)
데이터	Core Data + `@FetchRequest`	✅ SwiftData + `@Query`
인앱결제	StoreKit 1 completion handler	✅ StoreKit 2 async/await
에러처리	`print(error)`	✅ `LocalizedError` 프로토콜

🔧 지원 도구

도구	파일	설명
Claude Code	`skills/claude-code/hig.md`	`/hig` 슬래시 커맨드
Cursor	`skills/cursor/.cursorrules`	자동 컨텍스트 인식
GitHub Copilot	`skills/copilot/copilot-instructions.md`	VS Code 자동 적용
기타 AI	`llms.txt` / `llms-full.txt`	URL 제공: `https://m1zz.github.io/HIGLab/llms.txt`

💡 프로젝트를 클론하고 AI 코딩 도구로 열면, AI가 자동으로 50개 프레임워크 레퍼런스를 참고하여 정확한 iOS 코드를 생성합니다.

🤝 기여하기

PR 환영합니다!

📄 라이선스

MIT License. 자유롭게 사용하세요.

🤖 AI Agents 지원

AI 에이전트가 콘텐츠를 효율적으로 소비할 수 있도록 llms.txt 표준을 지원합니다.

엔드포인트	설명
`/llms.txt`	프로젝트 요약 + 50개 AI Reference 링크
`/llms-full.txt`	50개 AI Reference 합본 (마크다운)
`/ai-reference/*.md`	개별 프레임워크 참조 문서

💡 Claude, GPT, Cursor 등에서 llms.txt URL을 제공하면 정확한 iOS 코드 생성이 가능합니다.

Made with ❤️ by 개발자리

Name		Name	Last commit message	Last commit date
Latest commit History 122 Commits
.github		.github
ai-reference		ai-reference
docs		docs
npm		npm
roadmap-projects		roadmap-projects
samples		samples
scripts		scripts
site		site
skills		skills
tutorials		tutorials
.cursorrules		.cursorrules
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
GETTING_STARTED.md		GETTING_STARTED.md
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
todo.md		todo.md

Folders and files

Latest commit

History

Repository files navigation

🍎 HIG Lab

📊 진행 상황

📈 프로젝트 규모

💻 샘플 프로젝트 (43개)

🚀 Phase 1: App Frameworks

💳 Phase 2: App Services

🎮 Phase 3: Graphics & Media

🔧 Phase 4: System & Network

🆕 Phase 5: iOS 26

📚 DocC 튜토리얼 (50개)

🏆 시니어급 코드 품질

📁 프로젝트 구조

🤖 AI Reference (50개)

App Frameworks (8개)

App Services (16개)

Graphics & Media (13개)

System & Network (6개)

iOS 18+ Apple Intelligence (7개)

📁 프로젝트 구조

🚀 시작하기

블로그 보기

DocC 튜토리얼 실행

샘플 프로젝트 실행

🛠️ AI Skills — AI 코딩 도구 연동

Skills가 뭔가요?

📦 빠른 설치

Claude Code — /hig 커맨드

Cursor

GitHub Copilot

💡 사용 예시

Claude Code에서 /hig 커맨드 사용

Before & After

🔧 지원 도구

🤝 기여하기

📄 라이선스

🤖 AI Agents 지원

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Claude Code — `/hig` 커맨드

Claude Code에서 `/hig` 커맨드 사용

Packages