diff --git a/README.md b/README.md
new file mode 100644
index 0000000..326debd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# Stupid Superhero Physics calculator
+
+A stupid physics calculator for superheroes, written in D. This is just an
+exercise for using some `std` library bits, and `quantities` for fiddling with
+units.
+
+## Install D and run it
+
+First [install D](https://dlang.org/download.html), and then use dub to pull in
+dependencies, compile and run:
+```
+dub build
+dub run
+```