diff --git a/settings.gradle.kts b/settings.gradle.kts
index 9444a8388c..b61afb33b1 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -144,6 +144,24 @@ dependencyResolutionManagement {
 
 }
 
+// Optional local composite build for the Blockchain SDK.
+// Enable it from local.properties (which is git-ignored, so it never reaches CI/develop):
+//
+//   blockchainSdk.local=true
+//   blockchainSdk.path=../blockchain-sdk-kotlin   # optional, this is the default
+//
+// When enabled, com.tangem:blockchain is resolved from local sources instead of the
+// published Maven artifact (tangemBlockchainSdk in gradle/tangem_dependencies.toml).
+if (properties.getProperty("blockchainSdk.local").toBoolean()) {
+    val blockchainSdkPath = properties.getProperty("blockchainSdk.path") ?: "../blockchain-sdk-kotlin"
+    println("Blockchain SDK: using local composite build from '$blockchainSdkPath'")
+    includeBuild(blockchainSdkPath) {
+        dependencySubstitution {
+            substitute(module("com.tangem:blockchain")).using(project(":blockchain"))
+        }
+    }
+}
+
 enableFeaturePreview("TYPESAFE_PROJECT_ACCESSORS")
 
 include(":app")