diff --git a/packages/framework/README.md b/packages/framework/README.md
new file mode 100644
index 0000000..c93046c
--- /dev/null
+++ b/packages/framework/README.md
@@ -0,0 +1,5 @@
+# `📦framework`
+This directory consists of the core frameworks for both JavaScript and TypeScript, including a shared `tsconfig.json`.
+
+## Development
+Running a standalone development server for the TypeScript framework first requires dependencies for the shared tsconfig installed. Dependencies for all packages can be globally installed by running `pnpm i` in the monorepo root.