diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8a32eae
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# DietComplete
+
+An error correcting diet parser based on the diet-ng spec. See [SPEC.md](SPEC.md) for the added grammar by this repository.
+
+## Example
+
+```d
+import std.algorithm;
+import std.conv;
+import std.stdio;
+
+import dietc.complete;
+
+void main()
+{
+	// Create completion engine from filename
+	// You can also pass a parsed document with a callback for other files in the future (from extend tags)
+	auto complete = new DietComplete("views/filename.dt");
+
+	size_t offset = 12;
+	// Use completeAt to get completion results for a specific byte offset in the code
+	auto completion = complete.completeAt(offset);
+	if (completion is Completion.completeD)
+	{
+		size_t dOffset;
+		string dCode;
+		complete.extractD(offset, /*out*/ dCode, /*out*/ dOffset);
+		// special instruction that D code should be completed here
+		writeln("Complete D code ", dCode, " at ", dOffset);
+	}
+	else
+		completion.map!(a => text(a.type, ": ", a.text)).each!writeln;
+}
+```
\ No newline at end of file
diff --git a/dub.json b/dub.json
index cb0ab20..59b0775 100644
--- a/dub.json
+++ b/dub.json
@@ -1,3 +1,6 @@
 {
-	"name": "diet-complete"
+	"name": "diet-complete",
+	"description": "Error correcting diet parser with integrated auto-completion and neat AST tools",
+	"license": "MIT",
+	"copyright": "Copyright © 2018 webfreak"
 }
\ No newline at end of file