diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e67394a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# eInvoicing
+
+Tools for working with eInvoicing according to EU standard EU 16931.
+
+## Reading
+
+### Extract eInvoice from a PDF or XML file:
+
+```kotlin
+val reader = EInvoiceReader()
+
+// read a ZUGFeRD or Factor-X PDF that contains eInvoice XML as attachment
+val invoiceFromPDF = reader.extractFromPdf(File("ZUGFeRD.pdf"))
+
+// read a eInvoice XML file like XRechnung:
+val invoiceFromXml = reader.readFromXml(File("XRechnung.xml"))
+```
+
+### Find all invoices of an IMAP email account
+
+```kotlin
+        val mailReader = MailReader()
+        
+        val mailsWithEInvoices = mailReader.listAllMessagesWithEInvoice(MailAccount(
+            username = "", // your mail account username
+            password = "", // your mail account username
+            serverAddress = "", // IMAP server address
+            port = null // IMAP server port, leave null if default port 993
+        ))
+```
\ No newline at end of file
diff --git a/e-invoicing-domain/src/test/kotlin/net/codinux/invoicing/Demonstration.kt b/e-invoicing-domain/src/test/kotlin/net/codinux/invoicing/Demonstration.kt
new file mode 100644
index 0000000..eaa562b
--- /dev/null
+++ b/e-invoicing-domain/src/test/kotlin/net/codinux/invoicing/Demonstration.kt
@@ -0,0 +1,30 @@
+package net.codinux.invoicing
+
+import net.codinux.invoicing.mail.MailAccount
+import net.codinux.invoicing.mail.MailReader
+import net.codinux.invoicing.reader.EInvoiceReader
+import java.io.File
+
+class Demonstration {
+
+    fun read() {
+        val reader = EInvoiceReader()
+
+        // read a ZUGFeRD or Factor-X PDF that contains eInvoice XML as attachment
+        val invoiceFromPDF = reader.extractFromPdf(File("ZUGFeRD.pdf"))
+
+        // read a eInvoice XML file like XRechnung:
+        val invoiceFromXml = reader.readFromXml(File("XRechnung.xml"))
+    }
+
+    fun fromMail() {
+        val mailReader = MailReader()
+
+        val mailsWithEInvoices = mailReader.listAllMessagesWithEInvoice(MailAccount(
+            username = "", // your mail account username
+            password = "", // your mail account username
+            serverAddress = "", // IMAP server address
+            port = null // IMAP server port, leave null if default port 993
+        ))
+    }
+}
\ No newline at end of file