diff --git a/README.md b/README.md
new file mode 100644
index 0000000..84fea0c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# var-font-setup
+
+## Installation (Linux only)
+
+#### Using [`typship`](https://github.com/sjfhsjfh/typship)
+
+```bash
+typship download -n local https://imsc.uni-graz.at/git/gjankowiak/typst-var-font-setup
+```
+
+## Usage
+
+```typst
+#import "@local/var-font-setup:0.0.1": var-font-setup
+
+#show: var-font-setup.with(font: "Nunito Sans 12pt", normal-weight: 100, bold-weight: 500)
+```
+
+
+Tested typst version: `0.15.2`.