diff --git a/README.md b/README.md
index a2fb8d0..a21e1a8 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,241 @@
-# 27th-App-Team-1-iOS
+# NDGL-iOS
+
+
+
+
+
+
+
+
+## π± νλ‘μ νΈ μκ°
+
+NDGLμ μ¬ν μ½ν
μΈ λ₯Ό λ°λΌκ°λ©° λλ§μ μ¬νμ κ³νν μ μλ iOS μ±μ
λλ€.
+
+## π κΈ°μ μ€ν
+
+| κ΅¬λΆ | κΈ°μ |
+|:---:|:---|
+| **Architecture** | RIBs (Router-Interactor-Builder-Presenter) |
+| **UI** | UIKit, SnapKit, Then |
+| **Reactive** | RxSwift, RxCocoa |
+| **Network** | Moya, Alamofire |
+| **Image** | Kingfisher |
+| **Animation** | Lottie |
+| **Push** | Firebase Cloud Messaging (FCM) |
+| **Project** | Tuist |
+| **CI/CD** | GitHub Actions, Fastlane |
+
+## π λͺ¨λ ꡬ쑰
+
+```
+NDGL-iOS
+βββ Projects
+β βββ App # μ± νκ²
+β βββ Features # Feature λͺ¨λ
+β β βββ RootFeature # μ± μ§μ
μ RIB
+β β βββ TabBarFeature # νλ° RIB
+β β βββ HomeFeature # ν νλ©΄
+β β βββ FollowFeature # λ°λΌκ°κΈ° μ½ν
μΈ
+β β βββ TravelFeature # λ€κ°μ€λ μ¬ν
+β β βββ BaseFeatureDependency
+β βββ Domain # Entity, UseCase, Repository Interface
+β βββ Data # Repository ꡬν체, DTO
+β βββ Core # κ³΅ν΅ μ νΈλ¦¬ν°
+β βββ Modules
+β βββ DSKit # λμμΈ μμ€ν
(Color, Font, Component)
+β βββ Networks # λ€νΈμν¬ λ μ΄μ΄
+β βββ ThirdPartyLibs # μΈλΆ λΌμ΄λΈλ¬λ¦¬ μμ‘΄μ±
+βββ Plugins
+β βββ EnvPlugin # νκ²½ μ€μ νλ¬κ·ΈμΈ
+βββ Tuist # Tuist μ€μ
+βββ fastlane # CI/CD μ€ν¬λ¦½νΈ
+βββ Scripts # λΉλ μ€ν¬λ¦½νΈ
+```
+
+## π μν€ν
μ²
+
+### RIBs Architecture
+
+```
+βββββββββββββββββββββββββββββββββββββββββββββββββββ
+β Router β
+β (νλ©΄ μ ν, Child RIB Attach/Detach) β
+βββββββββββββββββββββββββββββββββββββββββββββββββββ
+ β
+ βΌ
+βββββββββββββββββββββββββββββββββββββββββββββββββββ
+β Interactor β
+β (λΉμ¦λμ€ λ‘μ§, μν κ΄λ¦¬) β
+βββββββββββββββββββββββββββββββββββββββββββββββββββ
+ β
+ ββββββββββββ΄βββββββββββ
+ βΌ βΌ
+ββββββββββββββββββββ ββββββββββββββββββββ
+β Presenter β β Builder β
+β (View β ν΅μ ) β β (DI, RIB μμ±) β
+ββββββββββββββββββββ ββββββββββββββββββββ
+ β
+ βΌ
+ββββββββββββββββββββ
+β ViewController β
+β (UI λ λλ§) β
+ββββββββββββββββββββ
+```
+
+### λͺ¨λ μμ‘΄μ±
+
+```
+ βββββββββββ
+ β App β
+ ββββββ¬βββββ
+ β
+ ββββββββββββββββββββββΌβββββββββββββββββββββ
+ βΌ βΌ βΌ
+ ββββββββββββ ββββββββββββ βββββββββββββ
+ β Data β β Networks β β Root β
+ ββββββ¬ββββββ ββββββ¬ββββββ β Feature β
+ β β βββββββ¬ββββββ
+ β ββββββ΄βββββ β
+ β βΌ βΌ βΌ
+ β ββββββββββββββββββββ βββββββββββββ
+ β β Domain ββ Core β β TabBar β
+ β ββββββββββββββββββββ β Feature β
+ β βββββββ¬ββββββ
+ β β
+ βΌ βΌ
+ ββββββββββββ βββββββββββββ
+ β Domain β β Home β
+ β Networks β β Feature β
+ ββββββββββββ βββββββ¬ββββββ
+ β
+ βΌ
+ βββββββββββββββββββββββ
+ β BaseFeatureDependencyβ
+ ββββββββββββ¬βββββββββββ
+ β
+ βββββββββββββββββΌββββββββββββββββ
+ βΌ βΌ βΌ
+ ββββββββββ ββββββββββ βββββββββ
+ β Core β β Domain β β DSKit β
+ ββββββ¬ββββ ββββββ¬ββββ βββββ¬ββββ
+ β β β
+ ββββββββββββββββ΄βββββββββββββββ
+ β
+ βΌ
+ ββββββββββ
+ β Core β
+ ββββββ¬ββββ
+ β
+ βΌ
+ βββββββββββββββββ
+ β ThirdPartyLibsβ
+ βββββββββββββββββ
+```
+
+### μ£Όμ μμ‘΄μ± κ΄κ³
+
+| λͺ¨λ | μμ‘΄μ± |
+|:---:|:---|
+| **App** | Data, Networks, RootFeature |
+| **RootFeature** | TabBarFeature |
+| **TabBarFeature** | HomeFeature |
+| **HomeFeature** | BaseFeatureDependency |
+| **BaseFeatureDependency** | Core, Domain, DSKit |
+| **Data** | Domain, Networks |
+| **Networks** | Core, Domain |
+| **Domain** | Core |
+| **DSKit** | Core |
+| **Core** | ThirdPartyLibs (RxSwift, RIBs, SnapKit, Then, Moya, Kingfisher) |
+
+## πΏ λΈλμΉ μ λ΅
+
+| λΈλμΉ | μ€λͺ
|
+|:---:|:---|
+| `main` | νλ‘λμ
λ°°ν¬ λΈλμΉ |
+| `develop` | κ°λ° ν΅ν© λΈλμΉ |
+| `feat/#μ΄μλ²νΈ-μμ
λ΄μ©` | κΈ°λ₯ κ°λ° λΈλμΉ |
+| `fix/#μ΄μλ²νΈ-μμ
λ΄μ©` | λ²κ·Έ μμ λΈλμΉ |
+| `hotfix/#μ΄μλ²νΈ-μμ
λ΄μ©` | κΈ΄κΈ μμ λΈλμΉ (developμμ λΆκΈ°) |
+
+### PR κ·μΉ
+- **2λͺ
μ΄μ μΉμΈ** μ λ¨Έμ§ κ°λ₯
+- CI ν΅κ³Ό νμ
+
+## π CI/CD
+
+| νκ²½ | νΈλ¦¬κ±° | λμ |
+|:---:|:---:|:---|
+| **CI** | `develop` PR/Push | λΉλ 체ν¬, λ¦°νΈ κ²μ¬ |
+| **CD** | `main` Push | Fastlaneμ ν΅ν TestFlight λ°°ν¬ |
+
+## π μ»€λ° μ»¨λ²€μ
+
+```
+feat: #μ΄μλ²νΈ - μμ
λ΄μ©
+```
+
+| νμ
| μ€λͺ
|
+|:---:|:---|
+| `feat` | μλ‘μ΄ κΈ°λ₯ μΆκ° |
+| `fix` | λ²κ·Έ μμ |
+| `docs` | λ¬Έμ μμ |
+| `style` | μ½λ ν¬λ§·ν
(κΈ°λ₯ λ³κ²½ μμ) |
+| `refactor` | μ½λ 리ν©ν λ§ |
+| `test` | ν
μ€νΈ μ½λ μΆκ°/μμ |
+| `chore` | λΉλ, ν¨ν€μ§ λ§€λμ μ€μ |
+| `design` | UI/UX λμμΈ λ³κ²½ |
+
+## π μ½λ 컨벀μ
+
+[StyleShare Swift Style Guide](https://github.com/StyleShare/swift-style-guide) μ€μ
+
+### SwiftLint
+νλ‘μ νΈ λ£¨νΈμ `.swiftlint.yml` μ€μ νμΌ μ¬μ©
+
+## π μμνκΈ°
+
+### μꡬμ¬ν
+- Xcode 16.0+
+- iOS 17.0+
+- [mise](https://mise.jdx.dev/) (Tuist, Ruby λ²μ κ΄λ¦¬)
+
+### μ€μΉ λ° μ€ν
+
+```bash
+# 1. μ μ₯μ ν΄λ‘
+git clone https://github.com/YourOrg/NDGL-iOS.git
+cd NDGL-iOS
+
+# 2. miseλ‘ λꡬ μ€μΉ
+mise install
+
+# 3. μμ‘΄μ± μ€μΉ
+bundle install
+tuist install
+
+# 4. νλ‘μ νΈ μμ±
+tuist generate
+
+# 5. Xcodeμμ NDGL-iOS.xcworkspace μ΄κΈ°
+```
+
+## π₯ νμ
+
+