diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4e4da4e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# jillo
+
+the goop :)
+
+![](https://oat.zone/jilloref-2.png)
+
+## Setup
+
+```sh
+pnpm install knex -g
+# rerun after each update
+pnpm install
+knex migrate:latest
+```
+
+<small>(`npm` instead of `pnpm` will also suffice)</small>
+
+Copy `config.example.json` to `config.json` and change as necessary
+
+## Dev
+
+```sh
+pnpm deploy-commands -- --dev
+pnpm dev
+```
+
+## Run
+
+```sh
+pnpm start
+```
\ No newline at end of file