diff --git a/crates/js/build.rs b/crates/js/build.rs
index b56ecd4f..3c228502 100644
--- a/crates/js/build.rs
+++ b/crates/js/build.rs
@@ -42,7 +42,7 @@ fn main() {
         if let Some(npm_path) = npm.as_deref() {
             if !ts_dir.join("node_modules").exists() {
                 let status = Command::new(npm_path)
-                    .arg("install")
+                    .arg("ci")
                     .current_dir(&ts_dir)
                     .status();
                 if !status
@@ -50,7 +50,7 @@ fn main() {
                     .map(std::process::ExitStatus::success)
                     .unwrap_or(false)
                 {
-                    warn!("tsjs: npm install failed; using existing dist if available");
+                    warn!("tsjs: npm ci failed; using existing dist if available");
                 }
             }
         }
diff --git a/docs/README.md b/docs/README.md
index 0be0eb3b..072ab9db 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -13,7 +13,7 @@ VitePress documentation site for Trusted Server.
 
 ```bash
 # Install dependencies
-npm install
+npm ci
 
 # Start dev server (available at localhost:5173)
 npm run dev
diff --git a/docs/guide/error-reference.md b/docs/guide/error-reference.md
index e1c91ecf..c75988e9 100644
--- a/docs/guide/error-reference.md
+++ b/docs/guide/error-reference.md
@@ -589,7 +589,7 @@ ERROR: npm run build:custom failed
 
 ```bash
 cd crates/js/lib
-npm install
+npm ci
 ```
 
 2. Test build manually: