ID:SPEC-109Status:accepted
Site template packages, manifest, and scaffolding
Name:v0.25.0Status:active
v0.25.0 — Distribution & onboarding
With the theme platform matured across v0.22.0 (type tokens), v0.23.0 (surface axes + skeleton/skin) and v0.24.0 (live backdrops + motion), the next move is to make that platform distributable and cut the largest activation cost in the toolchain: the blank page. Three recent specs interlock to take an author from zero to a designed, purpose-built site — starting templates, robust install from anywhere, and presets shippable independent of a theme.
Progress 5/5 work items
Relationships
Related 6
ID:SPEC-115Status:accepted
Project asset resolution — the asset: scheme
ID:SPEC-110Status:accepted
Theme and template install robustness
ID:SPEC-111Status:accepted
Decoupled preset packs with scope and compatibility metadata
ID:SPEC-116Status:accepted
Authoring scaffolds for distributable extensions
ID:ADR-023Status:accepted
Versioning and compatibility for distributed extensions
Date:2026-06-18
Work Items
Done 5
WORK-447 claude/milestone-v0-28-0-llvtfa
create-refrakt --type plugin|template|preset-pack dispatch create-refrakt --type accepts only site|theme|plan (packages/create-refrakt/src/bin.ts). SPEC-118 §1 extends it with the three distributable kinds and dispatches each to its own scaffolder. This is the thin CLI seam; the scaffolder bodies land in their own work items (plugin, theme, template, preset-pack).
4/4 criteria
WORK-448 claude/milestone-v0-28-0-llvtfa
Bake ADR-023 peerDeps, compat range, devDeps and build wiring into scaffolds ADR-023 compliance and the day-one-build guarantee (SPEC-118 §3–§4) must be embodied by every scaffold so an author starts correct rather than remembering the policy. This is the shared scaffolding helper the per-kind scaffolders consume.
6/6 criteria
WORK-449 claude/milestone-v0-28-0-llvtfa
create-refrakt plugin scaffold SPEC-118 §2 — --type plugin emits a package implementing Plugin (packages/types/src/package.ts) with one example rune that builds and renders under the identity transform out of the box.
4/4 criteria
WORK-450 claude/milestone-v0-28-0-llvtfa
Framework-agnostic theme scaffold default with --target opt-in Per ADR-024, the --type theme scaffold currently emits a Svelte-coupled theme (svelte/ folder, SvelteTheme export, target: 'svelte') that doesn't match the framework-agnostic reference theme (Lumina, which ships zero .svelte). Default it to framework-agnostic; make the framework component layer opt-in via --target.
4/4 criteria
WORK-464 claude/milestone-v0-28-0-llvtfa
Authoring docs for distributables (template, theme, plugin, preset-pack) The docs ACs across SPEC-109, SPEC-111, and SPEC-118 — authoring guides for each distributable, each create-refrakt --type kind with a worked example.
4/4 criteria