diff --git a/README.md b/README.md
new file mode 100644
index 0000000..27131f5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# Forge Kasm Workspace
+
+A Docker image to run [Forge – Magic: The Gathering](https://github.com/Card-Forge/forge) in a browser-based Kasm workspace.  
+This container auto-downloads the latest Forge snapshot and supports persistent storage for your decks.
+
+## Features
+
+- Runs Forge GUI in the browser via noVNC (Kasm-compatible)
+- Auto-downloads daily Forge snapshot if not present
+- Persists your decks and preferences in `/config`
+- Designed for personal or offline Kasm use
+
+## Usage
+
+```bash
+docker run -it -p 3000:3000 -v $PWD/config:/config yourname/forge-kasm