diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..5ffc26b4686536a7a8390a84e8d54258141a58fd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# Qt Examples
+
+Various little examples to help you start developing with Qt.  
+Feel free to contribute to this repo with more examples, widgets, layouts, configuration and so on.
+
+## Counter
+Counting a number up and down with button presses.  
+Uses `QPushButton` and `QLineEdit`.  
+Special here is that `myLineEdit` is an extended `QLineEdit` with a new `slot` (callback function).
+
+## Text2Console
+Print the content of a text field to std::cout on button press.  
+Uses `QPushButton` and `QLineEdit`.  
+Special here is the division of functionality between view MainWindow and control Control.  
+It is not shown here, but when using a *model* it doesn't have to be a `QObject` and can thus be fully independend from the Qt Framework.
+
+
+# Building
+
+Should work out of the box with Qt Creator, VSCode and the CMake and C++ plugins installed.  
\ No newline at end of file