Skip to content

Release v0.9.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 17:24
· 79 commits to main since this release

🎯 Koubou (工房) - The artisan workshop for App Store screenshots

Transform YAML into handcrafted App Store screenshots.
Koubou is your professional workshop where every screenshot
is carefully crafted with artisan quality.

工房 (koubou) means "artisan's workshop" in Japanese -
where masters create their finest work.

What's Changed

Added

  • Localized asset support with hybrid approach (convention-based and explicit mapping)
  • resolve_localized_asset() function for automatic language-specific asset resolution
  • Convention-based asset resolution using {lang}/ directory pattern
  • Explicit per-language asset mapping with dict format {"en": "path/en.png", "es": "path/es.png"}
  • Fallback chain: explicit mapping → lang directory → base_lang directory → direct path
  • Comprehensive unit and integration tests for localized assets
  • Dependency analyzer support for dict-based asset tracking

Changed

  • ContentItem.asset field now accepts both string and dict formats for maximum flexibility
  • Enhanced asset resolution to work seamlessly with multi-language projects

Installation

PyPI (Recommended)

pip install koubou

Homebrew (macOS/Linux)

brew install bitomule/tap/koubou

Manual Download

Download the wheel or source distribution from the assets below.

Quick Start

kou create-config my-screenshots.yaml    # Create sample config
kou generate my-screenshots.yaml         # Generate screenshots
kou list-frames                          # List available device frames

Features

  • 🎨 100+ Device Frames: iPhone, iPad, Mac, Watch, and more
  • 🌈 Professional Backgrounds: Linear, radial, conic gradients
  • ✨ Rich Typography: Advanced text overlays with stroke, alignment
  • 📱 YAML Configuration: Elegant, declarative screenshot definitions
  • 🚀 Batch Processing: Generate multiple screenshots efficiently

Full Changelog: https://github.com/bitomule/koubou/commits/v0.9.0