🎪🎭 뮤꾸 Mukku 📱⌚️

"좋아하는 것을 언제나 내 곁에"

뮤지컬 덕후가 위젯과 다이나믹 아일랜드를 활용해서 아이폰 화면을 꾸밀 수 있는 앱

🎭 팀원 소개

🍎 애플 디벨로퍼 아카데미 2기 MC2 YES, 인정

강다은	김민지	김혜린	노기현	문서희	윤재호
Tech	Design	Domain	Tech	Tech	Tech

🎪 프로젝트 소개

• Mukku 는 위젯과 다이나믹 아일랜드를 활용해서 아이폰 화면을 꾸밀 수 있는 서비스 입니다.
• 사용자가 원하는 뮤지컬 아이콘을 선택시, 위젯과 다이나믹 아일랜드에서 선택한 아이콘을 보여줍니다.
• 다양한 배경 화면을 제공하여 위젯 배경화면을 사용자 선택에 따라 바꿔줍니다.

1. 🛠️ 기술 스택

2. 📂 파일 구조

  Mukku
    ├── Localizable                          # 다국어 적용
    ├── Mukku                                # 앱
    │     ├── Utils                          # 위젯 배경 이미지 관련
    │     ├── Model                          # 뮤지컬 데이터 관련
    │     │      └── ...
    │     ├── View                           # 앱 화면 관련
    │     │      └── ...
    │     ├── Preview Content                # 미리보기
    │     │      └── ...
    ├── MukkuWidgets                         # 위젯
    │     ├── LiveActivity                   # 다이나믹 아일랜드 관련
    │     ├── HomeWidgets                    # 홈 위젯 관련
    │     ├── LockScreenWidgets              # 다이나믹 아일랜드 관련
    ├── MukkuWatch Watch App                 # 워치 큰 화면
    │     ├── Preview Content                # 미리보기
    │     │      └── ...
    ├── MukkuWatchExtension                  # 워치 작은 화면
    │     ├── WatchView                      # 워치 화면 관련
    │     │      └── ...
    └── Frameworks                           
          └── ...

3. ✏️ 규칙

코딩 컨벤션

Swift API Design Guidelines 에 따라 작성하였습니다.

commit 메시지 규칙

type	Emoji	Emoji Name	Description	Example
feat	✨	sparkles	새로운 기능 추가, 구현	✨ feat : 로그인 기능 구현
edit	✏️	pencil2	단순 오타 수정	✏️ edit : 로그인 캐시 처리 방식 수정
style	💄	lipstick	UI작업, 스타일 관련 파일 추가 및 수정	💄 style : 폰트 등록
add	🍱	bento	asset 파일(이미지, 아이콘 등) 추가	🍱 add : 위젯 이미지 추가
chore	🚚	truck	파일, 경로를 옮기거나 이름 변경	🚚 chore : feet -> feat 이름 변경
merge	🔀	twisted_rightwards_arrows	브랜치 병합(merge)	🔀 merge : feat-kihyun → main 브랜치 병합
fix	🐛	bug	버그 픽스	🐛 fix : Color 버그 수정
docs	📝	memo	문서 작업	📝 docs : Readme 작성
refactor	♻️	recycle	코드 리팩토링	♻️ refactor : 변수명 수정
model	🗃️	card_file_box	데이터베이스(모델) 작업	🗃️ model : 데이터 모델 생성
init	🎉	tada	프로젝트 생성	🎉 init : 프로젝트 생성
빌드관련
build	🔨	hammer	재빌드	🔨 build: 동일버전 재빌드(x.xx)
version	🏗️	building construction	버전 업	🏗️ version : 버전 업

4. 📂 기능 구현

다이나믹 아일랜드

• 다이나믹 아일랜드 안에 나타나는 뮤지컬 오브젝트

홈 위젯

• 원하는 오브젝트와 배경 커스트마이징
• 움직이는 오브젝트

잠금 위젯

• 세가지의 위젯 패밀리 지원
• 움직이는 오브젝트

워치 위젯

• 애플워치 컴플리케이션 설정
• 네가지의 위젯 패밀리 지원
• 워치 페이스 색상에 따른 위젯의 컬러 변화

5. 📹 프로젝트 소개 영상

6. ✈️ TestFlight 링크