diff --git a/README.md b/README.md
index 8e7dccc..34dadbf 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,14 @@
 # huellas
+This service is backed by an Axum server and uses a raw Typescript front-end using
+Leaflet.js.
 
+## Migrations
+We use the `sqlx` CLI to manage migrations. To create a new one run
+```shell
+cargo sqlx migrate add
+```
+## Cross-architecture building
+Images are built for arm64 on a juicier machine using
+```shell
+docker buildx build --platform=linux/arm64 . -t oolong.ludwig.dog/pitbuster/huellas:X.Y.Z
+```