Skip to content

Commit 121b64d

Browse files
bpamiriPeter Amiriclaude
authored
docs(web/guides): name the dead cfwheels-base-template slug and redirect to wheels-base-template (#3253)
The Installing with CommandBox page existed to give 2.x/3.x CommandBox teams a clear Wheels 4 answer, but it never mentioned the slug a migrating 2.x user actually has in muscle memory: `box install cfwheels-base-template`. That pre-rebrand slug still resolves on ForgeBox (76,754 installs, top 'cfwheels' search hit) but errors on its missing `cfwheels` core dependency and leaves an unrunnable skeleton. Worse, the 2.x/3.x migration table claimed `box install wheels-base-template` + `wheels-core` was 'Unchanged' — inaccurate for a genuine 2.x user, whose slug DID change (cfwheels-base-template -> wheels-base-template). The row now reads 'Slug changed' and a caution Aside maps the dead cfwheels- prefixed slugs to the supported 4.x slugs (cfwheels-base-template -> wheels-base-template, cfwheels -> wheels-core). Refs #3198 (post-merge review finding) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Signed-off-by: Peter Amiri <petera@pai.com> Co-authored-by: Peter Amiri <petera@pai.com> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent 5056ea4 commit 121b64d

1 file changed

Lines changed: 14 additions & 1 deletion

File tree

web/sites/guides/src/content/docs/v4-0-0/start-here/installing-with-commandbox.mdx

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,20 @@ The 3.x getting-started spine was built on CommandBox. Here's how each old step
124124
| `wheels generate app myApp` / `wheels g app` | `wheels new myApp` |
125125
| `box server start` | Still works — or `wheels start` (Lucee, bundled with the CLI) |
126126
| ForgeBox plugins (`box install ...`, `forgebox install`) | The [`wheels packages`](/v4-0-0/digging-deeper/packages/) registry (CLI-only; not ForgeBox) |
127-
| `box install wheels-base-template` + `wheels-core` | Unchanged — still the supported way to fetch the framework with CommandBox |
127+
| `box install cfwheels-base-template` | **Slug changed**`box install wheels-base-template` (the `cfwheels-`-prefixed slug is dead; see below) |
128+
129+
<Aside type="caution" title="The `cfwheels-base-template` slug is gone — use `wheels-base-template`">
130+
If your 2.x muscle memory is `box install cfwheels-base-template`, that command no longer works. The pre-rebrand `cfwheels-`-prefixed ForgeBox slugs (`cfwheels-base-template`, `cfwheels`) are **deprecated and unmaintained**`cfwheels-base-template` still resolves on ForgeBox but errors on its missing `cfwheels` core dependency and leaves an unrunnable skeleton. The framework rebranded to **Wheels** at 3.0, and the supported 4.x slugs dropped the prefix:
131+
132+
- `cfwheels-base-template`[`wheels-base-template`](#supported-install-the-framework)
133+
- `cfwheels``wheels-core`
134+
135+
Install the modern slug instead:
136+
137+
```bash title="illustrative — the supported 4.x slug"
138+
box install wheels-base-template
139+
```
140+
</Aside>
128141

129142
The practical recommendation: keep CommandBox if you rely on it for Adobe CF or BoxLang server management, and add the `wheels` CLI alongside it for everything in the [feature-set list above](#not-supported-via-commandbox-the-wheels-cli-feature-set).
130143

0 commit comments

Comments
 (0)