diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 0000000..74a1f7a
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,22 @@
+{
+    "workbench.colorCustomizations": {
+        "activityBar.activeBackground": "#ab307e",
+        "activityBar.background": "#ab307e",
+        "activityBar.foreground": "#e7e7e7",
+        "activityBar.inactiveForeground": "#e7e7e799",
+        "activityBarBadge.background": "#25320e",
+        "activityBarBadge.foreground": "#e7e7e7",
+        "commandCenter.border": "#e7e7e799",
+        "sash.hoverBorder": "#ab307e",
+        "statusBar.background": "#832561",
+        "statusBar.foreground": "#e7e7e7",
+        "statusBarItem.hoverBackground": "#ab307e",
+        "statusBarItem.remoteBackground": "#832561",
+        "statusBarItem.remoteForeground": "#e7e7e7",
+        "titleBar.activeBackground": "#832561",
+        "titleBar.activeForeground": "#e7e7e7",
+        "titleBar.inactiveBackground": "#83256199",
+        "titleBar.inactiveForeground": "#e7e7e799"
+    },
+    "peacock.color": "#832561"
+}
\ No newline at end of file
diff --git a/README-backstage-local.md b/README-backstage-local.md
new file mode 100644
index 0000000..6dbc293
--- /dev/null
+++ b/README-backstage-local.md
@@ -0,0 +1,52 @@
+# Backstage docs local
+
+Take this repo when you want to start editing documentation for Backstage techdocs independently from a central docs repo.
+
+For the PoC doc you first can *prepare* your docs here. 
+Later on they will go into a central docs repo.
+Then the cebntral docs repo will render and publish the docs into a running backstage app in a eDF platform.
+
+## How to 
+
+You need nodejs and npx. 
+
+### Use devbox if you want to keep your host clean
+
+If you need a devboxed nodejs environment, have [devbox installed](https://www.jetify.com/docs/devbox/installing_devbox/). Then run
+
+```bash
+devbox shell
+```
+
+When npx is available, run 
+
+```bash
+# in the repo root dir
+
+# use backstage theme and frame
+npx @techdocs/cli serve
+
+#use mkdocs theme
+npx @techdocs/cli serve:mkdocs
+```
+
+### Output
+
+You should see this screen:
+
+![alt text](./_assets/techdocs.png)
+
+## how this repo was generated
+
+```bash
+# get mocked content from techdocs-container (backsatge/packages/techdocs-cli is too slow to clone)
+mkdir tmp && cd tmp
+git clone https://github.com/backstage/techdocs-container.git
+cp -a mock-docs/* ..
+cd ..
+rm -rf tmp
+
+# provide nodejs env
+devbox init
+devbox add yarn nodejs
+```
diff --git a/devbox.json b/devbox.json
new file mode 100644
index 0000000..6819f7b
--- /dev/null
+++ b/devbox.json
@@ -0,0 +1,17 @@
+{
+  "$schema": "https://raw.githubusercontent.com/jetify-com/devbox/0.13.6/.schema/devbox.schema.json",
+  "packages": [
+    "nodejs@latest",
+    "yarn@latest"
+  ],
+  "shell": {
+    "init_hook": [
+      "echo 'Welcome to devbox!' > /dev/null"
+    ],
+    "scripts": {
+      "test": [
+        "echo \"Error: no test specified\" && exit 1"
+      ]
+    }
+  }
+}