Announcing PO9 Specification v1

Thu, 30 Jul 2026 00:00:00 GMT

Today we’re marking Specification v1 stable. .po9-skin is now a fixed, dependable target you can build against.

What v1 locks in

A required manifest as the single entry point.
Theme tokens — a flat, named set of styling values.
Asset rules that keep skins small and safe.
A single-file package format.

The promise

A skin valid under v1 stays valid under every later minor revision. Additive features (like the animation tokens on the roadmap) never break what you’ve already shipped. That stability is the whole point of a standard.

Start building with the Quick Start.

How to Build a PO9 Skin

Tue, 28 Jul 2026 00:00:00 GMT

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.

2. Change the tokens

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

3. Validate, package, use

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.