Initial commit

skills/textual-builder/assets/card-game-template/README.md

@@ -0,0 +1,77 @@
+# Card Game Template
+
+A starter template for building turn-based card games with Textual.
+
+## Features
+
+- **Card Widget**: Customizable playing cards with suit, rank, face-up/down state
+- **Hand Container**: Display and manage player hands
+- **Play Area**: Central area for cards in play
+- **Turn System**: Basic turn management
+- **Interactivity**: Card selection and playing with keyboard shortcuts
+
+## Running the Template
+
+```bash
+python app.py
+```
+
+## Key Bindings
+
+- `d` - Draw a card
+- `space` - Select/deselect card
+- `p` - Play selected card
+- `n` - Next turn
+- `q` - Quit
+
+## Customization
+
+### Card Values
+
+Modify the `Card` class to add game-specific properties:
+
+```python
+class Card(Widget):
+    def __init__(self, rank: str, suit: str, power: int = 0, special_ability: str = ""):
+        self.power = power
+        self.special_ability = special_ability
+        # ...
+```
+
+### Game Rules
+
+Implement game logic in the `CardGameApp` methods:
+- `on_card_played()` - Validate and process card plays
+- `action_draw_card()` - Implement deck management
+- `action_next_turn()` - Add turn-based game logic
+
+### Card Appearance
+
+Edit `Card.compose()` or the CSS in `app.tcss` to change card styling.
+
+### Deck Management
+
+Add a `Deck` class to manage card shuffling and drawing:
+
+```python
+class Deck:
+    def __init__(self):
+        self.cards = []
+        self.shuffle()
+
+    def shuffle(self):
+        import random
+        random.shuffle(self.cards)
+
+    def draw(self) -> Card | None:
+        return self.cards.pop() if self.cards else None
+```
+
+## Structure
+
+```
+card-game-template/
+├── app.py          # Main application
+├── app.tcss        # Styles
+└── README.md       # This file
+```