diff --git a/docs/minimal-client.md b/docs/minimal-client.md
new file mode 100644
index 000000000..fb2e5a936
--- /dev/null
+++ b/docs/minimal-client.md
@@ -0,0 +1,13 @@
+# Minimal Client Example (Concept)
+
+This file is a quick reference to verify the library wiring.
+
+## Goal
+- connect
+- send a heartbeat/logon sequence (depending on your setup)
+- confirm you can read incoming messages
+
+## Notes
+- Keep credentials out of git
+- Use a dedicated test environment
+- Log raw FIX messages during debugging