From 54798a89cd97eef18111fa3ca29c505ecf1d0f17 Mon Sep 17 00:00:00 2001
From: hanminjae <hanminjae131@gmail.com>
Date: Fri, 2 Jan 2026 18:18:56 +0900
Subject: [PATCH 1/4] docs: update README

---
 README.ko.md | 19 +++++++++++++++++++
 README.md    | 21 ++++++++++++++++++++-
 2 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/README.ko.md b/README.ko.md
index 0725746..9c32133 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -149,6 +149,25 @@ val uri = "app://wisp/product/user?productId=123&userId=99".toUri()
 navController.navigateTo(uri)
 ```
 
+## 🧪 테스트 방법 (Testing)
+
+### 샘플 앱 실행하기
+
+1.  이 리포지토리를 클론하여 Android Studio에서 엽니다.
+2.  `app` 실행 구성을 선택하고 에뮬레이터나 실제 기기에서 실행합니다.
+3.  앱 내의 버튼을 눌러 내비게이션을 테스트합니다.
+
+### ADB로 테스트하기
+
+`adb`를 사용하여 커맨드 라인에서 직접 딥링크를 테스트할 수 있습니다. 이는 외부 소스로부터의 링크 클릭을 시뮬레이션하는 좋은 방법입니다.
+
+**중요:** 커맨드 라인에서 여러 파라미터를 테스트할 때는 `&` 문자가 백그라운드 실행 명령으로 인식되지 않도록 `\&`로 이스케이프하거나 전체 URI를 따옴표로 감싸야 합니다.
+
+```bash
+# '&' 문자를 백슬래시(\)로 이스케이프합니다
+adb shell am start -a android.intent.action.VIEW -d "app://wisp/product/user?productId=123\&userId=99"
+```
+
 ## 고급 사용법 (Advanced Usage)
 
 ### 커스텀 URI 파서
diff --git a/README.md b/README.md
index 6bee796..a595ff4 100644
--- a/README.md
+++ b/README.md
@@ -150,6 +150,25 @@ val uri = "app://wisp/product/user?productId=123&userId=99".toUri()
 navController.navigateTo(uri)
 ```
 
+## 🧪 Testing
+
+### Running the Sample App
+
+1.  Clone this repository and open it in Android Studio.
+2.  Select the `app` run configuration and run it on an emulator or a physical device.
+3.  Use the buttons in the app to test navigation.
+
+### Testing with ADB
+
+You can test your deep links directly from the command line using `adb`. This is a great way to simulate a link click from an external source.
+
+**Important:** When testing multiple parameters on the command line, you must escape the `&` character (`\&`) or wrap the entire URI in single quotes to prevent the shell from interpreting it as a background command.
+
+```bash
+# Escape the '&' character with a backslash
+adb shell am start -a android.intent.action.VIEW -d "app://wisp/product/user?productId=123\&userId=99"
+```
+
 ## Advanced Usage
 
 ### Custom URI Parser
@@ -183,4 +202,4 @@ distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-```
+```
\ No newline at end of file

From 0ad51c856c0f9cf726a1c7d072b782350a3749b8 Mon Sep 17 00:00:00 2001
From: hanminjae <hanminjae131@gmail.com>
Date: Fri, 2 Jan 2026 18:20:50 +0900
Subject: [PATCH 2/4] refactor: update splash screen navigation logic to handle
 deep links more effectively

---
 .../java/com/angrypodo/wisp/ui/main/MainActivity.kt   | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/app/src/main/java/com/angrypodo/wisp/ui/main/MainActivity.kt b/app/src/main/java/com/angrypodo/wisp/ui/main/MainActivity.kt
index 0d72656..6819dc7 100644
--- a/app/src/main/java/com/angrypodo/wisp/ui/main/MainActivity.kt
+++ b/app/src/main/java/com/angrypodo/wisp/ui/main/MainActivity.kt
@@ -51,8 +51,15 @@ private fun WispNavHost(deepLinkUri: Uri?) {
     NavHost(navController = navController, startDestination = Splash) {
         composable<Splash> {
             SplashScreen(
-                navController = navController,
-                uri = deepLinkUri
+                onSplashFinished = {
+                    if (deepLinkUri != null) {
+                        navController.navigateTo(deepLinkUri)
+                    } else {
+                        navController.navigate(Home) {
+                            popUpTo(Splash) { inclusive = true }
+                        }
+                    }
+                }
             )
         }
 

From 8579852e183490eac435cc1d578a8931df885479 Mon Sep 17 00:00:00 2001
From: hanminjae <hanminjae131@gmail.com>
Date: Fri, 2 Jan 2026 18:20:59 +0900
Subject: [PATCH 3/4] refactor: remove deep link handling from splash screen to
 simplify navigation logic

---
 .../wisp/ui/screens/SampleScreens.kt          | 23 ++-----------------
 1 file changed, 2 insertions(+), 21 deletions(-)

diff --git a/app/src/main/java/com/angrypodo/wisp/ui/screens/SampleScreens.kt b/app/src/main/java/com/angrypodo/wisp/ui/screens/SampleScreens.kt
index 09611a2..47ceec6 100644
--- a/app/src/main/java/com/angrypodo/wisp/ui/screens/SampleScreens.kt
+++ b/app/src/main/java/com/angrypodo/wisp/ui/screens/SampleScreens.kt
@@ -1,6 +1,5 @@
 package com.angrypodo.wisp.ui.screens
 
-import android.net.Uri
 import androidx.compose.foundation.layout.Arrangement
 import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.Spacer
@@ -14,9 +13,6 @@ import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.unit.dp
 import androidx.compose.ui.unit.sp
-import androidx.navigation.NavController
-import com.angrypodo.wisp.navigation.Home
-import com.angrypodo.wisp.runtime.Wisp
 import kotlinx.coroutines.delay
 
 @Composable
@@ -86,28 +82,13 @@ fun UserScreen(userId: Int) {
 
 @Composable
 fun SplashScreen(
-    navController: NavController,
-    uri: Uri?
+    onSplashFinished: () -> Unit
 ) {
-    val wisp = Wisp.getDefaultInstance()
-
     // A real app would check login status, fetch initial data, etc.
     // Here we just simulate a delay.
     LaunchedEffect(Unit) {
         delay(1500)
-
-        val routes = uri?.let { wisp.resolveRoutes(it) }
-
-        if (routes.isNullOrEmpty()) {
-            // No deep link, navigate to home as usual.
-            navController.navigate(Home) {
-                popUpTo(navController.graph.id) { inclusive = true }
-            }
-        } else {
-            // Deep link found.
-            // Navigate to the parsed stack.
-            wisp.navigateTo(navController, routes)
-        }
+        onSplashFinished()
     }
 
     Column(

From 3ef4b17fd47f3d2a5c210979282930f15a356d12 Mon Sep 17 00:00:00 2001
From: hanminjae <hanminjae131@gmail.com>
Date: Fri, 2 Jan 2026 18:42:40 +0900
Subject: [PATCH 4/4] docs: update README

---
 README.ko.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.ko.md b/README.ko.md
index 9c32133..4edefb6 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -25,7 +25,7 @@ Wisp는 URI의 경로 세그먼트(path segments)로부터 전체 백스택을 
 
 ## 🏛️ 아키텍처 및 요구사항
 
-- **싱글 액티비티 아키텍처:** Wisp는 **싱글 액티비티 구조(Single-Activity Architecture)**를 위해 설계되었으며, 여러 Activity 간의 내비게이션은 지원하지 않습니다. 이는 Jetpack Compose에 권장되는 최신 안드로이드 개발 방식과 일치합니다.
+- **싱글 액티비티 아키텍처:** Wisp는 싱글 액티비티 구조(Single-Activity Architecture)를 위해 설계되었으며, 여러 Activity 간의 내비게이션은 지원하지 않습니다. 이는 Jetpack Compose에 권장되는 최신 안드로이드 개발 방식과 일치합니다.
 - **Jetpack Navigation 및 타입 안정성:** 이 라이브러리는 Jetpack Navigation Compose의 **타입 세이프(type-safe) 내비게이션** 패러다임 전용으로 설계되었습니다. `NavController`가 반드시 필요하며, 전통적인 문자열 기반의 라우트는 지원하지 않습니다.
 - **멀티 모듈 지원:** Wisp는 멀티 모듈 프로젝트를 완벽하게 지원합니다. `ServiceLoader` 패턴을 사용하여, 라이브러리가 포함된 모든 모듈로부터 `@Wisp` 라우트 정의를 자동으로 탐지합니다.
 - **최소 요구사항:**
@@ -84,7 +84,7 @@ dependencies {
 
 `@Serializable` 어노테이션이 달린 `data class`나 `object`에 `@Wisp` 어노테이션을 추가하여 딥링크 대상을 지정합니다.
 
-라우트 클래스의 속성들은 URI의 **쿼리 파라미터**로부터 자동으로 값이 채워집니다. 만약 속성에 **기본값(default value)**이 있다면, 해당 속성은 선택적(optional)인 값이 됩니다.
+라우트 클래스의 속성들은 URI의 **쿼리 파라미터**로부터 자동으로 값이 채워집니다. 만약 속성에 기본값(default value)이 있다면, 해당 속성은 선택적(optional)인 값이 됩니다.
 
 ```kotlin
 // 내비게이션 또는 기능 모듈 내부