From 5b0ff8e5d2ba9e3591e6fedcd0b9a300fd9e53cd Mon Sep 17 00:00:00 2001
From: alexandriaa <atw611@gmail.com>
Date: Sun, 5 Apr 2026 22:58:48 -0400
Subject: [PATCH] Add README.md

---
 README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a93a5c2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# Magical Deckbuilder
+
+A WPF card game where you combine cards, build decks, and battle opponents.
+
+## Features
+
+- **Card Combining**: Merge blank cards with elements to create unique cards
+- **Deck Building**: Build custom decks from your card collection
+- **Battle System**: Turn-based combat against AI opponents
+- **8 Card Types**: Spell, Creature, Artifact, Enchantment, Weapon, Armor, Event, Blank
+- **8 Elements**: Radioactivity, Flesh, Toxin, Fungus, Thermodynamics, Time, Food, Eldritch
+- **Rarity System**: Common, Uncommon, Rare, and Legendary cards
+
+## Project Structure
+
+```
+MagicalDeckbuilder.Shared/    # Core game library
+  Cards/          - Card classes and types
+  Decks/          - Deck management
+  Game/           - Game logic, CardFactory, OpponentAI
+  Combining/      - Card combining system
+  Logging/        - Error logging
+
+NewGame.UI/                  # WPF application
+  Views/          - MenuView, GameView, BattleSelectView, etc.
+  ViewModels/     - MVVM ViewModels
+  Controls/       - Custom UI controls
+  Converters/     - Value converters
+  Styles/         - XAML styles and themes
+```
+
+## Building
+
+```bash
+dotnet build
+```
+
+## Running
+
+```bash
+dotnet run --project NewGame.UI
+```
+
+## Requirements
+
+- .NET 9.0
+- Windows
\ No newline at end of file