diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d927072
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# Barnulfizator
+
+Makes things more Barnulf.
+
+## Description
+
+This is a set of custom scripts helping me to quickly setup a familiar environment on new machines.
+
+## Usage
+
+### Manually
+
+Scripts uses the [Deno](https://deno.land) runtime to run, it can be installed without sudo using this script:
+
+```sh
+curl -fsSL https://deno.land/x/install/install.sh | sh
+```
+
+The `complete.ts` script installs each parts.
+
+```sh
+deno run -A [URL]
+```
+
+### With the prelude
+
+```sh
+curl -fsSL [URL] | sh
+```
diff --git a/prelude.sh b/prelude.sh
index 1852510..563d6ec 100644
--- a/prelude.sh
+++ b/prelude.sh
@@ -9,4 +9,4 @@ export PATH="$DENO_INSTALL/bin:$PATH"
 
 # indications
 echo "run with :
-deno -A \"[URL]\""
\ No newline at end of file
+deno -A \"[URL]\""