diff --git a/README.md b/README.md
new file mode 100644
index 0000000..def3fdb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# Space Arcade
+
+8-bit retro arcade suite — 4 games, pure JS, no external game libraries.
+
+> Status: **public** ⚠️ — needs to be set to private