diff --git a/README.md b/README.md
new file mode 100644
index 0000000..87831e9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Chaospott Status
+
+Because we RiiR, we have ported our space status API to Rust.
+
+Thanks a lot to [axum the web app framework](https://github.com/tokio-rs/axum)
+and the [spaceapi crate](https://crates.io/crates/spaceapi), the initial work
+was a matter of a rainy evening. 🌧️🧑‍💻
+
+The original code was written in PHP 🐘 by bandie.
+
+## Development
+
+Check out the [tutorial](https://www.youtube.com/watch?v=Vhh_GeBPOhs).
+
+To start the app, just `cargo run --release` as usual.
+
+Find scripts for testing in [`scripts/`](scripts/).
+
+## Need help?
+
+Ask chfkch, starblue, m0veax, CyReVolt or your favourite Rustacean. 🦀