Changes

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a149211
--- /dev/null
+++ b/README.md
@@ -0,0 +1,66 @@
+# Scoundrel Web
+
+A web-based implementation of Scoundrel, a solo dungeon crawler card game played with a standard poker deck. This project is a single-page application (SPA) built with modern, lightweight web technologies.
+
+## Game Rules
+
+The goal is to traverse the entire dungeon (the deck) without your HP dropping to zero.
+
+*   **Setup**: The deck (minus Red Face cards and Red Aces) represents the dungeon. You start with 20 HP.
+*   **The Room**: You are presented with 4 cards. You must resolve (play) at least 3 of them to advance.
+*   **Card Types**:
+    *   **Monsters (Clubs ♣ and Spades ♠)**: Deal damage equal to their rank (2-10, J=11, Q=12, K=13, A=14).
+    *   **Weapons (Diamonds ♦)**: Equip to fight monsters. Attack Power = Rank.
+        *   *Durability*: You can only kill monsters *weaker* than the last monster you killed with the current weapon.
+    *   **Potions (Hearts ♥)**: Heal HP equal to their rank. Max HP is 20. Only one potion per room.
+*   **Fleeing**: You can run away from a room once per turn (shuffling the cards back into the deck), but you cannot flee twice in a row.
+
+## How to Play
+
+### Online
+(Link to hosted version goes here)
+
+### Local Development
+This is a static site with no build steps required.
+
+1.  **Clone the repository:**
+    ```bash
+    git clone https://git.xeno.darksair.org/scoundrel-web.git
+    cd scoundrel-web
+    ```
+2.  **Serve the files:**
+    You can use any static file server. For example:
+    *   **Python:** `python3 -m http.server`
+    *   **Node:** `npx serve`
+3.  **Open in Browser:** Navigate to `http://localhost:8000` (or whatever port your server uses).
+
+## Tech Stack
+
+*   **Core**: HTML5, CSS3, ES6+ JavaScript.
+*   **Libraries**:
+    *   [Preact](https://preactjs.com/): Fast, 3kB alternative to React.
+    *   [HTM](https://github.com/developit/htm): Hyperscript Tagged Markup (JSX-like syntax in plain JS).
+*   **Architecture**: No build tools (Webpack/Vite/Babel) required. Uses ES Modules directly in the browser.
+
+## Themes and Customization
+
+The game supports custom card themes!
+*   **Classic (Text)**: Default Unicode rendering.
+*   **Simple SVG**: A clean vector-based card set (included).
+
+**Adding a New Theme:**
+1.  Add your images to `assets/themes/YourThemeName/`.
+2.  Ensure filenames are lower-case (e.g., `10h.png`, `kc.jpg`).
+3.  Register the theme in `game.js`:
+    ```javascript
+    'YourThemeName': { label: 'My Theme', ext: 'png', path: 'assets/themes/YourThemeName' }
+    ```
+
+## Features
+
+*   **Local Persistence**: Your game state (including theme) is saved automatically. Resume anytime!
+*   **Undo System**: You can undo your last move.
+*   **Mobile Friendly**: Responsive design for dungeon crawling on the go.
+
+## License
+[WTFPL](http://www.wtfpl.net/)