WORK-452
ID:WORK-452Status:done

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.

Priority:highComplexity:moderateMilestone:v0.25.0Source:SPEC-109
claude/v0.25.0-impl-3 View source

Criteria completion

Criteria completion: 4 of 4 (100%) checked; tracking started on Jun 24, no incremental history yet0%25%50%75%100%Jun 24Jul 11

Tracking started Jun 24 — check back for trends.

Relationships

Implements 1
Related 3
Branches 3
claude/v0.25.0-impl-3 current done
main donechangeset-release/main doneclaude/v0.25.0-workitems ready
History 3
  1. ecafe59
    Created (done)by bjornolofandersson
  2. c4ba0af
    Content editedby Claude
    feat(create-refrakt): site templates — framework×purpose axis, apply, re
  3. a6bdcba
    Content editedby Claude
    plan(v0.25.0): accept specs/ADRs and decompose into 21 work items

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

Resolution

Completed: 2026-06-24

Branch: claude/v0.25.0-impl-3. Split the axes: --framework <adapter> (author-facing name; --target kept as alias), --template <name|dir> (purpose). scaffold() composes framework starter + site template (applyTemplate) + theme; --template resolves a bundled name or local directory (resolveTemplateDir); absent → today's minimal starter. Usage documents the rename.