diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..6250602
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,10 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+[*.typ]
+charset = utf-8
+indent_style = space
+indent_size = 2
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5f50401
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# typst cv
+
+it's what it says on the tin
+
+## what
+
+it's a cv (template and content) used by ≥1 people
+
+## why
+
+typst is cool and i need a cv
+
+## ok how
+
+copy the template folder and get writing
+
+maybe customize the look if you want
+
+then build with typst (≥0.6): 
+
+```
+# `--root .` is needed because by default typst doesn't allow
+#   any files that are above the main file in the fs tree
+typst c --root . path/to/your/cv.typ
+```
+
+and find your cv.pdf next to your cv.typ
\ No newline at end of file