diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0542553
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+js-sudoku-solver
+================
+
+A Sudoku solving engine using deductive logic and showing every step.
+
+
+Currently the board to solve has to be defined in the index.html file near the bottom.
+
+The second parameter defines whether diagonals need to be checked, too (true) or
+the traditional rules apply (false).