How to Build a PO9 Skin

Jul 28, 2026

Building a skin is one straight line: Create → Validate → Package → Import → Use. Here’s the short version.

1. Start from a template

po9 new my-skin --template minimal

The minimal template is the smallest valid skin — a clean base with a manifest, metadata, and tokens.

Open theme/tokens.json and edit colors, fonts, radius, and spacing. The required core is just three: color.bg, color.text, color.accent.

po9 validate .    # security · compatibility · structure · version
po9 package .     # → my-skin.po9-skin

Import the file in the PO9 app and apply. That’s it.

Want the full rules? Read the Specification. Want the 5-minute hands-on? The Quick Start has it.