diff --git a/vite.config.js b/vite.config.js
index 94a1206a..72c81bac 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -25,6 +25,9 @@ export default {
     },
     resolve: {
         alias: {
+            // these should only be imported by the base-x package in any runtime code
+            // and works in the browser with a Uint8Array shim,
+            // rather than including a ton of polyfill code
             "safe-buffer": "./scripts/package-overrides/safe-buffer/index.js",
             "buffer": "./scripts/package-overrides/buffer/index.js",
         }