diff --git a/docs/tsconfig.json b/docs/tsconfig.json
new file mode 100644
index 00000000..bfeffffc
--- /dev/null
+++ b/docs/tsconfig.json
@@ -0,0 +1,15 @@
+{
+  // see https://www.typescriptlang.org/tsconfig to better understand tsconfigs
+  "include": ["../src"],
+  "compilerOptions": {
+    "lib": ["esnext"],
+    "allowJs": true,
+    "target": "esnext",
+    "resolveJsonModule": true,
+    // match output dir to input dir. e.g. dist/index instead of dist/src/index
+    "rootDir": "../",
+    // use Node's module resolution algorithm, instead of the legacy TS one
+    "moduleResolution": "nodenext",
+    "module": "nodenext",
+  }
+}
diff --git a/tsconfig.json b/tsconfig.json
index a3772110..2d23ec22 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -11,7 +11,7 @@
     // output .js.map sourcemap files for consumers
     "sourceMap": true,
     // match output dir to input dir. e.g. dist/index instead of dist/src/index
-    // "rootDir": "./src",
+    "rootDir": "./src",
     // stricter type-checking for stronger correctness. Recommended by TS
     "strict": false,
     // linter checks for common issues