1 files changed, 38 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3e7e6c8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Books
+
+Visualize a book library.
+
+## Book library
+
+Organize folders as you wish, only `metadata.json` files matter:
+
+```json
+{
+  "title": "Title of the Book",
+  "subtitle": "Optional subtitle",
+  "authors": [ "Author 1", "Author 2" ],
+  "authorsSort": "Author sorting",
+  "genres": [ "Foo", "Bar", "Baz" ],
+  "year": "1234",
+  "read": true
+}
+```
+
+Each `metadata.json` file correspond to a book, and there **must** be a cover
+named `cover.ext` in the same directory. Any extension works.
+
+## Show library
+
+View the book library by running:
+
+    ./bin/view browser-cmd path-to-books
+
+## Dev server
+
+Enter nix shell:
+
+    nix develop --command ./watch-command
+
+Then run the dev-server:
+
+    ./bin/dev-server path-to-books