diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c9c40de
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# Space Invaders
+
+## About
+This is a simple clone I wrote in a weekend using `odin-lang` and the available `raylib` bindings.
+
+# Software used
+* `Aseprite` for pixel art
+* `neovim` and the `ols` LSP
+* `make`
+
+# Building & running
+This should be buildable through the makefile on any platform (Windows, OSX & Linux) as long as you have the Odin compiler on hand.
+If the makefile is causing you trouble the project can be directly ran with (which creates a binary file as well):
+
+```bash
+odin run .
+```
+or compiled to a binary with a custom output directory & speed optimizations (although they are not needed at all):
+```bash
+odin build . -out:space_invaders.exe -o:speed
+```
+
+# Gallery
+![Space Invaders Start Game Screen](/repo/start_game_screenshot.png)
+
+![In Game Screen](/repo/in_game_screenshot.png)
\ No newline at end of file
diff --git a/repo/in_game_screenshot.png b/repo/in_game_screenshot.png
new file mode 100644
index 0000000..5444f6d
Binary files /dev/null and b/repo/in_game_screenshot.png differ
diff --git a/repo/start_game_screenshot.png b/repo/start_game_screenshot.png
new file mode 100644
index 0000000..9cfa28a
Binary files /dev/null and b/repo/start_game_screenshot.png differ