diff --git a/README.md b/README.md
index 31a8413..0b1504f 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,4 @@
-njump
-=====
+# njump
 
 njump is a HTTP Nostr static gateway that allows you to browse profiles, notes and relays; it is an easy way to preview a resource and then open it with your preferred client. The typical use of njump is to share a resource outside the Nostr world, where the Nostr: schema is not (yet) working.
 
@@ -9,11 +8,19 @@ njump currently lives under [njump.me](https://njump.me), you can reach it appen
 
 For more information about njump's philosophy and its use, read the presentation [on the homepage](https://njump.me).
 
-Docker
-=====
+## Development
+
+### Running locally
+
+The easiest way to start is to run the development server with `just` (if you have [it](https://just.systems/) installed) or with `TAILWIND_DEBUG=true go run .`. You can also check the contents of `justfile` to see other useful scripts.
+
+For live-reload you can use [`air`](https://github.com/cosmtrek/air) and start it with `air -c .air.toml` -- this will run it without the local cache, which can be annoying if you're not specifically debugging the part of the code that loads content, so you may want to run it with `air -c .air.toml --build.cmd 'go build -o ./tmp/main .'`. These run modes will recompile the Tailwind bundle on every restart and they assume you have [the `tailwind` CLI](https://tailwindcss.com/docs/installation) installed globally.
+
+### Docker
 
 To build and run in a Docker container:
+
 ```bash
 docker build -t njump .
 docker run -e DOMAIN=njump.mydomain.com -p 2999:2999 njump
-```
\ No newline at end of file
+```