diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..2d41b5d
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,28 @@
+slay with friends
+=================
+
+multiplayer browser version of slay the spire, played with friends.
+
+based on the slay the spire board game rules from contention games.
+video game card art for visuals, board game mechanics for gameplay.
+
+1-4 players cooperate through map rooms, building decks and fighting
+enemies. if any player hits 0 HP, everyone loses.
+
+status: early development. building the core combat engine.
+
+setup
+-----
+
+requires bun (https://bun.sh)
+
+  bun install
+  bun run dev
+
+open http://localhost:3000
+
+development
+-----------
+
+  bun test          run tests
+  bun run check     lint + format + tests