diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2f83c29
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Stellar Neighbours
+
+An interactive 3D spherical map of surrounding stars, made with THREE.js.
+
+## Development Setup
+
+```sh
+yarn # install dependencies
+yarn dev # run dev server
+```
+
+## Build
+```sh
+yarn build
+```