diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2ffff17
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# sharp-json
+A lightweight JSON implementation for Mono/.NET
+
+## Usage
+
+Use the base type *sharp.json.JSON* to represent JSON variables.
+
+    import sharp.json;
+    ...
+    JSON n = 123.45;
+    JSON s = "Hello World!"
+
+    Console.WriteLine("A number: {0}",n.ToString());
+    Console.WriteLine("A String: {0}",s.ToString());
+
+To parse JSON from text you may use
+
+    JSONParser parser = new JSONParser();
+    JSON json = parser.Parse("[ 0, 1, 2, 3 ]");
+
+    Console.WriteLine("json: {0}",json);
+