diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4a0df35
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# te, a text editor
+
+![preview](preview.jpg)
+
+In order to build on windows you need to call build.bat from
+the x64 Native Command Tools prompt that ships with Visual Studio.
+
+For Linux you will need clang, SDL3 and libbacktrace libraries to be installed and
+available on your system. Just call build.sh when these are available.
\ No newline at end of file
diff --git a/preview.jpg b/preview.jpg
new file mode 100644
index 0000000..1b69b9b
Binary files /dev/null and b/preview.jpg differ