From 7bc43815543ebd8df9ace3096350286c9be0d675 Mon Sep 17 00:00:00 2001
From: Dominic DiTaranto <me@domdit.com>
Date: Thu, 28 Aug 2025 17:25:44 -0400
Subject: [PATCH] readme

---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.md b/README.md
index fe3dded..adb5ee4 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,19 @@
 # PYSOKOBAN
+
+Welcome to PYSOKOBAN!
+The object of the game is to move all of the boulders to specific storage 
+positions in the shortest amount of moves possible. 
+
+        KEY                 MOVEMENT
++===========================================+
+|_symbol_|_meaning_||  y  k  u  |  7  8  9  |
+|   @    |   you   ||   \ | /   |   \ | /   |
+|   #    |   wall  ||  h- . -l  |  4- . -6  |
+|   0    | boulder ||   / | \   |   / | \   |
+|   .    | storage ||  b  j  n  |  1  2  3  |
++===========================================+
+
+If you like my stuff visit my website: https://domdit.com
+
+### TODO:
+- Create more maps. If you would like to contribute maps, please do!