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

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:

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:

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