A repository for designing, prototyping, and iterating on card games and board games.
games/
├── active/ # Games currently in development
├── completed/ # Finished games ready for testing/production
└── archived/ # Games that are shelved or deprecated
templates/ # Reusable game design templates and frameworks
docs/ # Game design principles, rules, and documentation
git checkout -b game/[game-name]Each game should have its own folder in games/active/ with:
README.md- Game overview and current statusrules.md- Complete game rulescomponents.md- Required components (cards, boards, pieces)playtests/- Playtest logs and feedbackiterations/- Version history and design changes
- Active: Under development, frequent changes
- Completed: Rules finalized, ready for extensive testing
- Archived: Shelved or replaced by better versions
- Create branch:
git checkout -b game/[your-game-name] - Copy template:
cp -r templates/basic-game games/active/[your-game-name] - Edit the game files to match your concept
- Commit iterations as you develop
- Start Simple: Begin with core mechanics, add complexity gradually
- Playtest Early: Test with minimal viable version
- Document Everything: Rules, changes, and feedback
- Iterate Quickly: Small changes, frequent testing