🧪 Apple-Developer-Academy-Challenge3-Lab

---

📌 저장소 목적

Challenge3 팀 프로젝트에서 사용된 기능을 직접 재구현하며 학습하기 위한 개인 저장소

Apple Developer Academy @ POSTECH Challenge3 과정에서 개발 중인 팀 프로젝트의 기능들을 직접 다시 구현하며 학습하기 위한 저장소입니다.

이 저장소의 목적은 단순히 코드를 읽는 것이 아니라,

• 기능 분석
• 핵심 개념 이해
• 기능 재구현
• 구현 검증

과정을 통해 기능을 완전히 자신의 것으로 만드는 것입니다.

---

📚 목차

• 📌 저장소 목적
• 🛠 기술 스택
• 🎯 학습 목표
• 🔄 학습 워크플로우
• 🧱 폴더 구조
• 🔖 브랜치 전략
• 🌀 커밋 컨벤션
• ✅ 테스트 환경
• 🧑‍💻 작성자
• 📝 라이센스

---

🛠 기술 스택

Language & Frameworks

• Swift
• SwiftUI
• RealityKit
• ARKit
• SwiftData

---

Architecture

• MVVM

---

Tools

• Xcode
• Reality Composer Pro
• GitHub
• Notion
• Figma

---

🎯 학습 목표

Team Project Reconstruction

• 팀 프로젝트 기능 분석
• 핵심 개념 이해
• 기능 재구현
• 구현 검증

---

visionOS Understanding

• Spatial Computing 이해
• RealityKit 이해
• ARKit 이해
• World Anchor 이해
• Persistence 이해

---

Independent Development

• 기능을 직접 설계할 수 있는 수준 도달
• 기능을 처음부터 구현할 수 있는 수준 도달

---

🔄 학습 워크플로우

1. Team Project 기능 분석

↓

2. 핵심 개념 이해

↓

3. 브랜치 생성

↓

4. 기능 재구현

↓

5. 구현 검증

↓

6. Main 브랜치 병합

---

🧱 폴더 구조

📦 Apple-Developer-Academy-Challenge3-Lab
┣ 📂 Experiments
┃ ┗ 📂 SpatialBox
┃
┣ 📂 Assets
┃
┣ 📜 README.md
┗ 📜 .gitignore

---

🔖 브랜치 전략

main

• 안정적인 학습 기록 브랜치

feat/*

• 기능별 재구현 브랜치

예시

feat/box-spawn
feat/box-move
feat/box-hover

feat/plane-detection
feat/world-anchor
feat/persistence

feat/window-management
feat/swiftdata

---

🌀 커밋 컨벤션

English Message [한국어]

예시

Initialize SpatialBox experiment [SpatialBox 실험 프로젝트 생성]

Implement box spawning [박스 생성 구현]

Implement world anchor placement [월드 앵커 배치 구현]

Document SpatialBox README [SpatialBox README 작성]

---

✅ 테스트 환경

Hardware

• Apple Vision Pro M5

---

Development Environment

• Xcode
• visionOS Simulator
• Latest visionOS SDK

---

🧑‍💻 작성자

Shayne Ryu
UX/UI Designer & iOS Developer
Apple Developer Academy @ POSTECH (Cohort 2026)

---

📝 라이센스

이 저장소는 개인 학습 및 교육 목적을 위해 설계되었습니다.

---

📌 Repository Purpose

A personal repository for rebuilding and learning features used in the Challenge3 team project.

This repository was created to rebuild and understand features developed in the Challenge3 team project during the Apple Developer Academy @ POSTECH.

The goal is not simply to read code, but to:

• Analyze features
• Understand core concepts
• Rebuild implementations
• Validate functionality

and ultimately make each feature your own through hands-on implementation.

---

• 📌 Repository Purpose
• 🛠 Tech Stack
• 🎯 Learning Goals
• 🔄 Learning Workflow
• 🧱 Folder Structure
• 🔖 Branch Strategy
• 🌀 Commit Convention
• ✅ Testing Environment
• 🧑‍💻 Author
• 📝 License

---

🛠 Tech Stack

Language & Frameworks

• Swift
• SwiftUI
• RealityKit
• ARKit
• SwiftData

---

Architecture

• MVVM

---

Tools

• Xcode
• Reality Composer Pro
• GitHub
• Notion
• Figma

---

🎯 Learning Goals

Team Project Reconstruction

• Analyze team project features
• Understand core concepts
• Rebuild implementations
• Validate functionality

---

visionOS Understanding

• Understand Spatial Computing
• Understand RealityKit
• Understand ARKit
• Understand World Anchors
• Understand Persistence

---

Independent Development

• Reach a level where features can be designed independently
• Reach a level where features can be implemented from scratch

---

🔄 Learning Workflow

1. Analyze Team Project Features

↓

2. Understand Core Concepts

↓

3. Create a Branch

↓

4. Rebuild the Feature

↓

5. Validate Implementation

↓

6. Merge into Main Branch

---

🧱 Folder Structure

📦 Apple-Developer-Academy-Challenge3-Lab
┣ 📂 Experiments
┃ ┗ 📂 SpatialBox
┃
┣ 📂 Assets
┃
┣ 📜 README.md
┗ 📜 .gitignore

---

🔖 Branch Strategy

main

• Stable learning archive branch

feat/*

• Feature reconstruction branches

Example:

feat/box-spawn
feat/box-move
feat/box-hover

feat/plane-detection
feat/world-anchor
feat/persistence

feat/window-management
feat/swiftdata

---

🌀 Commit Convention

English Message [한국어]

Examples:

Initialize SpatialBox experiment [SpatialBox 실험 프로젝트 생성]

Implement box spawning [박스 생성 구현]

Implement world anchor placement [월드 앵커 배치 구현]

Document SpatialBox README [SpatialBox README 작성]

---

✅ Testing Environment

Hardware

• Apple Vision Pro M5

---

Development Environment

• Xcode
• visionOS Simulator
• Latest visionOS SDK

---

🧑‍💻 Author

Shayne Ryu
UX/UI Designer & iOS Developer
Apple Developer Academy @ POSTECH (Cohort 2026)

---

📝 License

This repository is intended for personal learning and educational