diff --git a/package-lock.json b/package-lock.json
index c1a96325e..779f1c621 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -64,6 +64,12 @@
         "react-redux": "^7.1.1 || ^8.1.1",
         "react-router-dom": "^6.0.0",
         "redux": "^4.0.4"
+      },
+      "peerDependenciesMeta": {
+        "@openedx/frontend-build": {
+          "optional": true,
+          "reason": "This package is only a peer dependency to ensure using a compatible version that provides env.config and PARAGON_THEME support. It is not needed at runtime, and may be omitted with `--omit=optional`."
+        }
       }
     },
     "node_modules/@adobe/css-tools": {
diff --git a/package.json b/package.json
index ea95e60a2..88189a3f3 100644
--- a/package.json
+++ b/package.json
@@ -84,5 +84,11 @@
     "react-redux": "^7.1.1 || ^8.1.1",
     "react-router-dom": "^6.0.0",
     "redux": "^4.0.4"
+  },
+  "peerDependenciesMeta": {
+    "@openedx/frontend-build": {
+      "optional": true,
+      "reason": "This package is only a peer dependency to ensure using a minimum compatible version that provides env.config and PARAGON_THEME support. It is not needed at runtime, and may be omitted with `--omit=optional`."
+    }
   }
 }