diff --git a/README.md b/README.md
index 96da82df..e181f196 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,36 @@
-# flatlaf
\ No newline at end of file
+FlatLaf - Flat Look and Feel
+============================
+
+**FlatLaf** is a modern open-source cross-platform Look and Feel for Java
+desktop applications.
+
+It is mostly "flat" (no shadows or gradients), clean, simple and elegant. It
+comes with **Light** and **Dark** themes and is made for **HiDPI** displays.
+
+The look is heavily inspired by **Darcula** and **IntelliJ** themes from
+IntelliJ IDEA 2019.2+ and uses mostly the same colors and icons.
+
+![Flat Light Demo](images/FlatLightDemo.png)
+
+![Flat Dark Demo](images/FlatDarkDemo.png)
+
+
+Demo
+----
+
+Download
+[flatlaf-demo-0.1.jar](https://download.formdev.com/flatlaf/flatlaf-demo-0.1.jar)
+and run it with `java -jar flatlaf-demo-0.1.jar` (or double-click it). Requires
+Java 8 or newer.
+
+
+Download
+--------
+
+Coming soon
+
+
+License
+-------
+
+FlatLaf is open source licensed under the [Apache 2.0 License](LICENSE)
diff --git a/images/FlatDarkDemo.png b/images/FlatDarkDemo.png
new file mode 100644
index 00000000..28199c11
Binary files /dev/null and b/images/FlatDarkDemo.png differ
diff --git a/images/FlatLightDemo.png b/images/FlatLightDemo.png
new file mode 100644
index 00000000..f0360f04
Binary files /dev/null and b/images/FlatLightDemo.png differ