From 1fc5ceb3d21a1dedbbd152c9dbf57768c1b05912 Mon Sep 17 00:00:00 2001 From: Book-on <266720604+dltldn1234@users.noreply.github.com> Date: Tue, 17 Nov 2026 14:29:34 +0900 Subject: [PATCH 1/3] =?UTF-8?q?chore=20::=20Tuist=20iOS=20=EC=95=B1=20?= =?UTF-8?q?=EA=B8=B0=EB=B3=B8=20=EA=B5=AC=EC=A1=B0=EC=99=80=20GitHub=20?= =?UTF-8?q?=ED=85=9C=ED=94=8C=EB=A6=BF=20=EC=B6=94=EA=B0=80=20#2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/work.md | 22 ++++++++++++++++++++++ .github/pull_request_template.md | 25 +++++++++++++++++++++++++ .gitignore | 16 ++++++++++++++++ .tool-versions | 1 + CONTRIBUTING.md | 22 ++++++++++++++++++++++ Project.swift | 29 +++++++++++++++++++++++++++++ README.md | 29 ++++++++++++++++++++++++++++- Sources/App/RefluaApp.swift | 12 ++++++++++++ Sources/App/RefluaAppDelegate.swift | 4 ++++ Sources/UI/RootView.swift | 7 +++++++ 10 files changed, 166 insertions(+), 1 deletion(-) create mode 100644 .github/ISSUE_TEMPLATE/work.md create mode 100644 .github/pull_request_template.md create mode 100644 .gitignore create mode 100644 .tool-versions create mode 100644 CONTRIBUTING.md create mode 100644 Project.swift create mode 100644 Sources/App/RefluaApp.swift create mode 100644 Sources/App/RefluaAppDelegate.swift create mode 100644 Sources/UI/RootView.swift diff --git a/.github/ISSUE_TEMPLATE/work.md b/.github/ISSUE_TEMPLATE/work.md new file mode 100644 index 0000000..b87a479 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/work.md @@ -0,0 +1,22 @@ +--- +name: 작업 이슈 +about: 기능, 수정, 디자인 변경 등 작업을 등록합니다. +title: "[type] 작업 내용" +labels: [] +assignees: [] +--- + +### 상세 내용 + +- 작업할 내용을 작성해주세요. + +### 작업 목록 + +- [ ] 작업 내용 1 +- [ ] 작업 내용 2 + +### 추가사항 + +- 관련 Figma, 문서, 참고사항을 작성해주세요. + +제목 형식: `[feat] 작업 내용` (`feat`, `fix`, `design`, `refactor`, `docs`, `chore`) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000..f6a86d9 --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,25 @@ +### 개요 + +- 이 PR의 목적과 변경사항을 간략하게 설명해주세요. +- 관련 Issue: `Closes #번호` 또는 `Refs #번호` + +### 작업 내용 + +- 주요 변경사항을 상세히 나열해주세요. + +### 스크린샷 + +- UI 변경이 있으면 실제 화면 스크린샷을 첨부해주세요. +- UI 변경이 없으면 `해당 없음`으로 적어주세요. + +### 질문사항 + +- 리뷰어에게 특별히 확인받고 싶은 부분을 작성해주세요. +- 없으면 `없음`으로 적어주세요. + +### 테스트 결과 + +- [ ] 코드가 정상적으로 컴파일되고 실행되는지 확인했습니다. +- [ ] `git diff --check`를 통과했습니다. +- [ ] 기존 기능이 정상적으로 작동하는지 확인했습니다. +- 실행하지 않은 검증 항목은 체크하지 말고 아래에 이유를 적어주세요. diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2e3cbfd --- /dev/null +++ b/.gitignore @@ -0,0 +1,16 @@ +# macOS and Xcode +.DS_Store +*.xcuserstate +*.xcuserdatad/ +DerivedData/ +Derived/ + +# Tuist generated files and caches +*.xcodeproj/ +*.xcworkspace/ +Tuist/Cache/ +.tuist-cache/ +.build/ + +# Swift Package Manager generated workspace data +.swiftpm/xcode/package.xcworkspace/ diff --git a/.tool-versions b/.tool-versions new file mode 100644 index 0000000..4029e48 --- /dev/null +++ b/.tool-versions @@ -0,0 +1 @@ +tuist 4.202.0 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..b9b24e7 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,22 @@ +# 기여 안내 + +## Issue + +코드 변경 전에 Issue를 만들고 작업 범위와 완료 조건을 적습니다. 제목 형식은 `[type] 작업 내용`이며 `feat`, `fix`, `design`, `refactor`, `docs`, `chore`를 사용합니다. + +## 브랜치와 커밋 + +- 브랜치: `feature/<짧은-kebab-case-작업명>` (예: `feature/project-setup`) +- 커밋: `type :: 작업 내용 #이슈번호` (예: `chore :: Tuist 앱 기본 구조 추가 #2`) +- 한 커밋에는 함께 검토하고 되돌릴 수 있는 변경만 담습니다. + +## Pull Request + +- 제목: `[type/#이슈번호] 작업 내용` (예: `[chore/#2] Tuist 앱 기본 구조 추가`) +- 기본 브랜치: 현재 저장소의 `main` +- 설명: 개요, 작업 내용, 스크린샷, 질문사항, 테스트 결과를 작성합니다. +- 화면을 바꿨다면 실제 화면 스크린샷을 첨부합니다. +- 실행하지 않은 빌드나 테스트는 통과한 것으로 표시하지 않습니다. +- Issue를 모두 마쳤을 때만 `Closes #번호`를 사용합니다. + +이 규칙은 Reflua 조직의 기존 웹 저장소에서 쓰는 Issue/PR 제목과 템플릿 형식을 참고해 시작했습니다. 저장소에 자동화된 브랜치 보호 규칙은 아직 설정되어 있지 않습니다. diff --git a/Project.swift b/Project.swift new file mode 100644 index 0000000..6f0ff29 --- /dev/null +++ b/Project.swift @@ -0,0 +1,29 @@ +import ProjectDescription + +let project = Project( + name: "Reflua", + organizationName: "Reflua", + targets: [ + .target( + name: "Reflua", + destinations: .iOS, + product: .app, + bundleId: "com.reflua.ios", + deploymentTargets: .iOS("17.0"), + infoPlist: .extendingDefault( + with: [ + "CFBundleDisplayName": "Reflua", + "UILaunchScreen": [:], + ] + ), + sources: ["Sources/**"], + dependencies: [], + settings: .settings( + base: [ + "SWIFT_VERSION": "6.0", + ], + defaultSettings: .recommended + ) + ), + ] +) diff --git a/README.md b/README.md index 0ce3470..c4cdf53 100644 --- a/README.md +++ b/README.md @@ -1 +1,28 @@ -# Reflua-iOS-v1 \ No newline at end of file +# Reflua iOS + +Reflua iOS 앱 저장소입니다. Tuist로 Xcode 프로젝트를 생성하며, 앱 화면은 SwiftUI를 기본으로 구성하고 UIKit은 앱 생명주기와 필요한 플랫폼 연동에 사용합니다. + +## 개발 환경 + +- Xcode 27+ +- Tuist 4.202.0 (`.tool-versions`에 고정) +- mise 사용 시 저장소 루트에서 `mise install` + +## 프로젝트 실행 + +```sh +tuist generate +open Reflua.xcworkspace +``` + +생성된 `Reflua` scheme을 선택해 시뮬레이터에서 실행합니다. Xcode 프로젝트 파일은 Tuist가 생성하므로 커밋하지 않습니다. + +## GitHub 작업 흐름 + +1. 작업 전에 Issue를 만들고 `[feat]`, `[fix]`, `[design]`, `[refactor]`, `[docs]`, `[chore]` 중 작업 유형을 제목에 표시합니다. +2. `feature/<작업명>` 형식의 브랜치에서 작업합니다. 예: `feature/project-setup`. +3. 커밋은 `type :: 작업 내용 #이슈번호` 형식을 사용합니다. +4. PR 제목은 `[type/#이슈번호] 작업 내용`으로 작성하고, Issue 링크와 실제 검증 결과를 포함합니다. +5. UI 변경 PR에는 변경 화면 스크린샷을 첨부합니다. + +PR 양식과 Issue 양식은 `.github` 아래 템플릿을 사용합니다. diff --git a/Sources/App/RefluaApp.swift b/Sources/App/RefluaApp.swift new file mode 100644 index 0000000..6b29fe7 --- /dev/null +++ b/Sources/App/RefluaApp.swift @@ -0,0 +1,12 @@ +import SwiftUI + +@main +struct RefluaApp: App { + @UIApplicationDelegateAdaptor(RefluaAppDelegate.self) private var appDelegate + + var body: some Scene { + WindowGroup { + RootView() + } + } +} diff --git a/Sources/App/RefluaAppDelegate.swift b/Sources/App/RefluaAppDelegate.swift new file mode 100644 index 0000000..14b9ae9 --- /dev/null +++ b/Sources/App/RefluaAppDelegate.swift @@ -0,0 +1,4 @@ +import UIKit + +@MainActor +final class RefluaAppDelegate: NSObject, UIApplicationDelegate {} diff --git a/Sources/UI/RootView.swift b/Sources/UI/RootView.swift new file mode 100644 index 0000000..9c49ad0 --- /dev/null +++ b/Sources/UI/RootView.swift @@ -0,0 +1,7 @@ +import SwiftUI + +struct RootView: View { + var body: some View { + Text("Reflua") + } +} From 2ea5f108d86276449d05e12a12d36484556c0a35 Mon Sep 17 00:00:00 2001 From: Book-on <266720604+dltldn1234@users.noreply.github.com> Date: Tue, 17 Nov 2026 14:34:53 +0900 Subject: [PATCH 2/3] =?UTF-8?q?chore=20::=20GitHub=20Actions=20iOS=20?= =?UTF-8?q?=EB=B9=8C=EB=93=9C=20=EC=B6=94=EA=B0=80=20#2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/ios-ci.yml | 40 ++++++++++++++++++++++++++++++++++++ README.md | 4 ++++ 2 files changed, 44 insertions(+) create mode 100644 .github/workflows/ios-ci.yml diff --git a/.github/workflows/ios-ci.yml b/.github/workflows/ios-ci.yml new file mode 100644 index 0000000..ed031f9 --- /dev/null +++ b/.github/workflows/ios-ci.yml @@ -0,0 +1,40 @@ +name: iOS CI + +on: + pull_request: + branches: + - main + push: + branches: + - main + +permissions: + contents: read + +concurrency: + group: ${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true + +jobs: + build: + name: Generate and build + runs-on: macos-26 + + steps: + - name: Check out source + uses: actions/checkout@v4 + + - name: Install pinned Tuist + uses: jdx/mise-action@v2 + + - name: Generate Xcode project + run: tuist generate --no-open + + - name: Build for iOS Simulator + run: >- + tuist xcodebuild build + -workspace Reflua.xcworkspace + -scheme Reflua + -configuration Debug + -destination 'generic/platform=iOS Simulator' + CODE_SIGNING_ALLOWED=NO diff --git a/README.md b/README.md index c4cdf53..9938551 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,10 @@ open Reflua.xcworkspace 생성된 `Reflua` scheme을 선택해 시뮬레이터에서 실행합니다. Xcode 프로젝트 파일은 Tuist가 생성하므로 커밋하지 않습니다. +## CI + +GitHub Actions는 `main` 대상 PR과 `main` 브랜치 푸시에서 Tuist 프로젝트를 생성하고 iOS Simulator용 Debug 빌드를 실행합니다. 현재 저장소에는 테스트 타깃이 없어 CI는 빌드까지 확인합니다. + ## GitHub 작업 흐름 1. 작업 전에 Issue를 만들고 `[feat]`, `[fix]`, `[design]`, `[refactor]`, `[docs]`, `[chore]` 중 작업 유형을 제목에 표시합니다. From 5a7b3782db45e3ecd9995f4d5f96d583130840b9 Mon Sep 17 00:00:00 2001 From: Book-on <266720604+dltldn1234@users.noreply.github.com> Date: Tue, 17 Nov 2026 14:37:18 +0900 Subject: [PATCH 3/3] =?UTF-8?q?chore=20::=20GitHub=20Actions=20Node=2024?= =?UTF-8?q?=20=ED=98=B8=ED=99=98=20=EC=97=85=EB=8D=B0=EC=9D=B4=ED=8A=B8=20?= =?UTF-8?q?#2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/ios-ci.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/ios-ci.yml b/.github/workflows/ios-ci.yml index ed031f9..d99fdca 100644 --- a/.github/workflows/ios-ci.yml +++ b/.github/workflows/ios-ci.yml @@ -22,10 +22,10 @@ jobs: steps: - name: Check out source - uses: actions/checkout@v4 + uses: actions/checkout@v7 - name: Install pinned Tuist - uses: jdx/mise-action@v2 + uses: jdx/mise-action@v4 - name: Generate Xcode project run: tuist generate --no-open