diff --git a/.drone.yml b/.drone.yml
index 0ef2e68..d7a96ab 100644
--- a/.drone.yml
+++ b/.drone.yml
@@ -10,7 +10,7 @@ steps:
         - pull_request
     image: denoland/deno:alpine
     commands:
-      - deno run -A https://deno.land/x/lume@v1.6.4/install.ts
+      - deno run -A https://deno.land/x/lume@v1.12.0/install.ts
       - deno task build
 
   - name: publish
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6dcb4b6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# pub.solar homepage
+
+This is the repository containing the code for https://pub.solar.
+
+It is built using [lume](https://lume.land/) with JSX. To get started, make sure you're loading all dependencies via `direnv`:
+
+```
+$ direnv allow
+```
+
+This will use nix shell to create an environment that has deno and lume available.
+
+To get a live development server, run
+
+```
+$ deno task serve
+```
+
+Unfortunately, hot module reloading is currently broken for JSX modules, so you'll need to restart this process regularly during development.
+
+## Updating Open Sans
+
+To update the font files and CSS, run `google-font-downloader $FONT_CSS_URL`. As "documentation" `shell.nix` shows the internals, and `_includes/styles/typography.css` has a comment at the top that shows which command was used to generate it.
diff --git a/shell.nix b/shell.nix
index 677a753..c8ec7dc 100644
--- a/shell.nix
+++ b/shell.nix
@@ -15,4 +15,8 @@ mkShell {
     deno
     google-font-downloader
   ];
+
+  shellHook = ''
+    deno run -A https://deno.land/x/lume@v1.12.0/install.ts
+  '';
 }