diff --git a/README.md b/README.md
new file mode 100644
index 0000000..093d368
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+Green Directory PHP [![Build Status](https://travis-ci.org/netzbegruenung/green-directory-php.svg?branch=master)](https://travis-ci.org/netzbegruenung/green-directory-php)
+============
+
+PHP reader for [green-directory](https://github.com/netzbegruenung/green-directory) data.
+
+## Example
+
+```php
+<?php
+
+use Netzbegruenung\GreenDirectory\Reader;
+use Netzbegruenung\GreenDirectory\Repository;
+
+$repository = new Repository(new Reader(__DIR__ . '/green-directory/data'));
+$chapter = $repository->findBySherpaId('11002609');
+
+echo $chapter->getCity();
+```
\ No newline at end of file