semitexa/skins-base

Framework default skin + Semitexa skin CLI (generate, refine, explain-prompt). Projects generate their own skins into src/skins/; framework ships only the single 'default' reference skin used as fallback.

dev-master 2026-04-24 11:07 UTC

Requires

• php: ^8.4
• semitexa/core: *
• semitexa/llm: *
• semitexa/platform-ui: *
• semitexa/theme: *
• symfony/console: ^7.0

MIT

README

Framework default skin + Semitexa skin CLI.

What ships here

One skin. src/Application/Static/skins/default/ — a neutral-gray reference skin (balanced algorithm, seed #808080, light mode, default knobs) used as the fallback when no project skin matches. Deliberately minimal — "Times New Roman for skins". All 41 design tokens emitted; all three primitives renderable.

Three commands (src/Console/):

Command	Role
skins:generate	Generate a new skin (seed mode or --prompt="…" LLM mode). Writes to project src/skins/<name>/.
skins:refine	Iterate an existing skin's knobs (LLM deltas or --set=name:value). Reads via SkinDiscovery — refining a framework-shipped skin writes the override to project src/skins/<slug>/.
skins:explain-prompt	Preview LLM resolution without writing any files.

Full semantics: platform-ui/docs/skin-generation.md, skin-algorithms.md, skin-refinement.md.

Package boundary

Package	Owns
semitexa/platform-ui	Skin domain: algorithms (SkinAlgorithm), token contract (41 tokens), LLM library (PromptResolverFactory, OutputValidator, RefinementResolver), grammar, primitives.
semitexa/skins-base	CLI commands that orchestrate the domain, and the single framework-default skin.
semitexa/theme	SkinDiscovery — finds skins in both framework (here) and project (src/skins/), resolves slugs to URLs.

The commands depend on platform-ui (for algorithms + token emitter + LLM resolvers) and theme (for SkinDiscovery / ProjectRoot). platform-ui does not depend on skins-base — it's a pure library.

Asset serving

Both framework default and project skins serve at the unified URL prefix:

/assets/skins/<slug>/tokens.css

The alias is registered at worker boot by Semitexa\Theme\Runtime\BootProjectSkinsAssetAliasListener — project first (higher priority), framework second (fallback). When a project skin and a framework skin share a slug, the project wins.

Extending

Projects never modify this package. To add a new skin, run skins:generate in the consumer project — output lands in that project's src/skins/ and is auto-discovered.

To change the framework default (rare — most projects just override via a project-local default skin), regenerate directly against this package:

bin/semitexa skins:generate balanced "#808080" --name=tmp-default --write
# then manually move tokens.css + skin.json from src/skins/tmp-default/ into
# vendor/semitexa/skins-base/src/Application/Static/skins/default/

The deliberate friction here reflects that the framework default is shared infrastructure, not an everyday edit.