diff --git a/research/ui/README.md b/research/ui/README.md
new file mode 100644
index 0000000..2db2c75
--- /dev/null
+++ b/research/ui/README.md
@@ -0,0 +1,18 @@
+# UI references
+
+| File | What |
+|---|---|
+| `reference-dashboard.png` | Look and layout we like (generated mockup, 2026-10-23). A style reference, not a spec of our installation. |
+
+Differences from our installation, to respect when designing from it:
+
+- Heat pump: ground source with **boreholes**, indoor unit; no outdoor air unit with a fan.
+- Solar on the roof is **thermal** (heats the CWU tank), not photovoltaic: no solar kW.
+- The controller gives no power or energy figures, and no CO return, solar collector or well
+  temperature, and no mixing valve. Electricity can only come from a separate meter in InfluxDB.
+- Weekly program hours need selector writes to read (see `docs/roadmap.md`), so they are not
+  on the overview for now.
+
+Available from the controller for such a screen: outdoor, indoor, CO, CWU, ground in/out and
+pump outlet temperatures; targets 4201–4203; pump state 4227; compressor stage and every pump
+4112–4118; operating mode 4123 (summer/winter/auto); heating curve 4134; alarm 4221.
diff --git a/research/ui/reference-dashboard.png b/research/ui/reference-dashboard.png
new file mode 100644
index 0000000..186daae
Binary files /dev/null and b/research/ui/reference-dashboard.png differ