diff --git a/docs/.npmrc b/docs/.npmrc
new file mode 100644
index 0000000..8775e73
--- /dev/null
+++ b/docs/.npmrc
@@ -0,0 +1,8 @@
+# Suppress audit + funding noise during Docker builds — keeps the build log
+# focused on real errors and slightly speeds up `npm ci`.
+fund=false
+audit=false
+# Be lenient with peer-dep resolution. Astro 6 + Starlight 0.38 + the
+# vite-pwa plugin sometimes disagree about Vite peer ranges; npm's strict
+# resolver fails the install where the lockfile is fine.
+legacy-peer-deps=true