diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..6506fc6
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "CBQN"]
+	path = CBQN
+	url = https://github.com/dzaima/CBQN.git
diff --git a/CBQN b/CBQN
new file mode 160000
index 0000000..982a54d
--- /dev/null
+++ b/CBQN
@@ -0,0 +1 @@
+Subproject commit 982a54d98a4d2a37f40d0cc711b0ad5e396613e3
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f0548be
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# A 2048 game made in [BQN](https://github.com/mlochbaum/BQN)
+
+## Controls
+Vim style movement keys
+
+- h: left
+- j: down
+- k: up
+- l: right
+- q: quit
+
+## Running
+
+If you already have BQN and you have it on your path just run `./soko.bqn`
+
+Otherwise:
+
+1. `make` to compile CBQN
+2. `make run` to run the game
+
+## License 
+
+This code is licensed as AGPLv3