From 3f4d427be881c3ecc7742b43e491595287f96ebb Mon Sep 17 00:00:00 2001
From: Jiyong Jung <hickerd@sch.ac.kr>
Date: Thu, 26 Mar 2026 19:25:34 +0900
Subject: [PATCH] docs: fix README.md - #220

---
 README.md | 92 ++++++++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 78 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 12a1d499..9e641a55 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,84 @@
-# Reed
+<div align="center">
 
-<div align=center>
-<img width="1024" height="500" alt="keepiluv_graphic" src="https://github.com/user-attachments/assets/c0b9e262-1b09-4b7f-b7f6-ad20eebf5df5" />
+<img src="https://img.shields.io/badge/Platform-iOS-000000?style=for-the-badge&logo=apple&logoColor=white"/>
+<img src="https://img.shields.io/badge/Language-Swift-F05138?style=for-the-badge&logo=swift&logoColor=white"/>
+<img src="https://img.shields.io/badge/UI-SwiftUI-007AFF?style=for-the-badge&logo=swift&logoColor=white"/>
+<img src="https://img.shields.io/badge/Architecture-TCA-8B5CF6?style=for-the-badge"/>
 
-> **서로를 원동력으로, 멈추지 않는 우리. keep it luv!**
-> 공동 목표 달성부터 관계의 재미까지. 메이트와 함께 작심삼일을 극복하고 갓생 루틴을 만들어보세요.
+<br/><br/>
+
+> ### *"서로를 원동력으로, 멈추지 않는 우리."*
+> **keep it luv! 💘**
+
+<br/>
+
+<img src="https://github.com/user-attachments/assets/6740fce9-7cda-44dc-87d1-2caeed53dd73" width="700"/>
+
+<br/>
 
 </div>
 
-## 🛠 Development Environment
-[![Swift](https://img.shields.io/badge/Swift-5.9-orange.svg)](https://swift.org)
-[![Tuist](https://img.shields.io/badge/Tuist-4.118.0-green.svg)](https://tuist.io)
-[![iOS](https://img.shields.io/badge/iOS-17.0+-black.svg)](https://www.apple.com/ios)
-[![SPM](https://img.shields.io/badge/SPM-compatible-brightgreen.svg)](https://swift.org/package-manager/)
+<br/>
+
+> 우리는 더 나은 내일을 꿈꾸며 목표를 세웁니다.
+>
+> 하지만 혼자만의 다짐은 쉽게 무너지곤 하죠.
+>
+> 키피럽은 **'함께'** 라는 가장 강력한 무기를 쥐여줍니다.
+
+## ⚡️ Synergy — 둘이 함께라면 폭발한다
+
+> 키피럽은 연인 사이의 긍정적인 에너지가 어떻게 **'시너지'** 로 폭발하는지 보여줍니다.
+
+<div align="center">
+<img src="https://github.com/user-attachments/assets/bf40b2d6-f1d1-406d-9e2b-7866bf11cf87" width="700"/>
+</div>
+
+<br/>
+
+## 🛠 Tech Stack
 
-## 🍎 Developers
-| [정지용](https://github.com/clxxrlove) | [정지훈](https://github.com/jihun32) |
-|:---:|:---:|
-| <img width="144" src="https://avatars.githubusercontent.com/u/70135292?v=4"> | <img width="144" src="https://avatars.githubusercontent.com/u/75370733?v=4"> |
+<div align="center">
+
+| 영역 | 기술 |
+|:---:|:---|
+| **Language** | ![Swift](https://img.shields.io/badge/Swift-F05138?style=flat-square&logo=swift&logoColor=white) |
+| **UI** | ![SwiftUI](https://img.shields.io/badge/SwiftUI-007AFF?style=flat-square&logo=swift&logoColor=white) |
+| **Architecture** | ![TCA](https://img.shields.io/badge/TCA-8B5CF6?style=flat-square) |
+| **Build System** | ![Tuist](https://img.shields.io/badge/Tuist-6236FF?style=flat-square) |
+| **DI** | ![TCA](https://img.shields.io/badge/TCA%20Dependency-8B5CF6?style=flat-square) |
+| **Network** | ![URLSession](https://img.shields.io/badge/URLSession-007AFF?style=flat-square&logo=apple&logoColor=white) |
+| **Storage** | ![Keychain](https://img.shields.io/badge/Keychain-000000?style=flat-square&logo=apple&logoColor=white) ![UserDefaults](https://img.shields.io/badge/UserDefaults-007AFF?style=flat-square&logo=apple&logoColor=white) |
+| **Camera** | ![AVFoundation](https://img.shields.io/badge/AVFoundation-000000?style=flat-square&logo=apple&logoColor=white) |
+| **Image** | ![Kingfisher](https://img.shields.io/badge/Kingfisher-FF6B6B?style=flat-square) |
+| **Auth** | ![Kakao](https://img.shields.io/badge/KakaoSDK-FFCD00?style=flat-square&logo=kakao&logoColor=black) ![Google](https://img.shields.io/badge/GoogleSignIn-4285F4?style=flat-square&logo=google&logoColor=white) |
+| **Push** | ![Firebase](https://img.shields.io/badge/Firebase%20Messaging-FFCA28?style=flat-square&logo=firebase&logoColor=black) |
+
+</div>
+
+<br/>
+
+## Contributors
+
+<div align="center">
+
+### 함께이기에 더 강한, 키피럽을 만든 두 사람
+
+<table>
+  <tr>
+    <td align="center" width="160">
+      <a href="https://github.com/clxxrlove">
+        <img src="https://github.com/clxxrlove.png" width="150px" style="border-radius:50%"/><br/>
+        <sub><b>정지용</b></sub>
+      </a>
+    </td>
+    <td align="center" width="160">
+      <a href="https://github.com/jihun32">
+        <img src="https://github.com/jihun32.png" width="150px" style="border-radius:50%"/><br/>
+        <sub><b>정지훈</b></sub>
+      </a>
+    </td>
+  </tr>
+</table>
+
+</div>