create-refrakt framework x purpose axis (--framework and --template)

SPEC-109 §1,§5 — split the overloaded single axis: --framework selects the adapter, --template selects the purpose (the site template). Both default to preserve today's behaviour, and scaffolding composes framework starter + site template + theme.

claude/v0.25.0-workitems View source

Criteria completion

Tracking started Jun 23 — check back for trends.

Relationships

ID:SPEC-109Status:accepted

Site template packages, manifest, and scaffolding

ID:WORK-445Status:done

Shared install resolver: tarball name, registry passthrough, source-type detection

Priority:highComplexity:moderateMilestone:v0.25.0

ID:WORK-447Status:done

create-refrakt --type plugin|template|preset-pack dispatch

Priority:highComplexity:simpleMilestone:v0.25.0

ID:WORK-455Status:done

Reference template fixture and scaffold-build CI

Priority:mediumComplexity:moderateMilestone:v0.25.0

claude/v0.25.0-workitems current ready

main done changeset-release/main done claude/v0.25.0-impl-3 done

Jun 23, 07:22 PMa6bdcba
Created (ready)by bjornolofandersson

Acceptance Criteria

--framework <name> selects the adapter (svelte/astro/next/nuxt/eleventy/html), reconciling the existing --type/--target plumbing; the rename is documented
--template <name> selects the purpose; absent → today's minimal starter (existing behaviour preserved)
Scaffolding composes the three inputs (framework starter, site template site config, theme), injecting the framework-specific target/wiring
A --template value may be a bundled name, a local directory, or a package identifier (resolution shared with WORK-445)

Approach

Update bin.ts flag parsing and the compose step in scaffold.ts. The template's site config is framework-agnostic; the scaffolder injects the adapter wiring.

Dependencies

WORK-447 — --type dispatch / flag plumbing

References

SPEC-109 §1, §5; packages/create-refrakt/src/bin.ts