Skip to content

Commit 6ea3d8b

Browse files
wheels-bot[bot]github-actions[bot]claude
authored
docs(web/guides): clarify box CLI vs wheels CLI in v4 active docs (#2542)
* docs(web/guides): clarify box CLI vs wheels CLI in v4 active docs Add Aside to BoxLang section of cfml-engines guide explaining that `wheels start` boots the bundled Lucee Express and CommandBox is required for BoxLang server management. Update vm-deployment tip to remove confusing CI/Docker reference and explicitly distinguish CommandBox server management from the `wheels` dev CLI. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs(web/guides): align BoxLang aside with Adobe CF aside in cfml-engines Address Reviewer A/B consensus findings (round 1): - Expand the BoxLang <Aside> in v4-0-0-snapshot/start-here/cfml-engines.mdx to match the Adobe CF aside's coverage. Now lists all four affected commands (wheels start, stop, reload, test) and includes the ?reload=true&password=... URL workaround, matching the Adobe CF section that the PR body promised to mirror. --------- Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 422fcdb commit 6ea3d8b

3 files changed

Lines changed: 6 additions & 1 deletion

File tree

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ All historical references to "CFWheels" in this changelog have been preserved fo
2626

2727
**Documentation**
2828
- Add Debug Panel guide covering each tab, configuration settings, and when the bar appears
29+
- Clarify BoxLang server management in cfml-engines guide; update vm-deployment tip to distinguish CommandBox server management from the `wheels` dev CLI
2930

3031
**ORM & data layer**
3132
- Chainable query builder with `where()`, `orWhere()`, `whereNull()`, `whereBetween()`, `whereIn()`, `whereNotIn()`, `orderBy()`, `limit()`, and more for injection-safe fluent queries (#1922)

web/sites/guides/src/content/docs/v4-0-0-snapshot/deployment/vm-deployment.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ Lucee 7 is the canonical engine target for Wheels 4. Two install options work eq
6767
Follow the Lucee install docs end-to-end rather than re-typing them here — they're the authoritative source and they change with each release. See [Lucee installation guides](https://docs.lucee.org/guides/installing-lucee/).
6868

6969
<Aside type="tip">
70-
If you already run CommandBox on other hosts, you can install Lucee via `box server start cfengine=lucee@7.0.1+100` on the VM too. It's the same mechanism the Wheels test images use (see `tools/docker/lucee7/server.json`). The systemd unit below still applies — point `ExecStart` at the CommandBox wrapper script instead of `lucee.sh run`.
70+
If your team already uses CommandBox for server management, you can run Lucee on the VM via `box server start cfengine=lucee@7.0.1+100` as an alternative to the official installer. The systemd unit below still applies — point `ExecStart` at the CommandBox wrapper script instead of `lucee.sh run`. Note that `wheels start` is a local development convenience (it bundles a Lucee Express runtime for dev machines) and is not intended for production VM deployment.
7171
</Aside>
7272

7373
After install, confirm Lucee is listening on a local port (`8888` is a common default) and that a `lucee.sh` (or equivalent) start script exists in `/opt/lucee/bin`.

web/sites/guides/src/content/docs/v4-0-0-snapshot/start-here/cfml-engines.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,10 @@ cd myApp
8181
box server start cfengine=boxlang@latest port=8080
8282
```
8383

84+
<Aside type="note">
85+
The `wheels start`, `wheels stop`, `wheels reload`, and `wheels test` commands all assume the Lucee Express bundled with the CLI — they do not interact with BoxLang. BoxLang developers manage their server through CommandBox (`box server start/stop/restart`) and reload via `?reload=true&password=<your-password>` directly. Generators (`wheels generate ...`) are pure file-system operations and work the same regardless of engine.
86+
</Aside>
87+
8488
Wheels' BoxLang compatibility is verified per release in the same CI matrix as Lucee and Adobe CF. Cross-engine gotchas worth knowing about live in [`.ai/wheels/cross-engine-compatibility.md`](https://github.com/wheels-dev/wheels/blob/develop/.ai/wheels/cross-engine-compatibility.md) — most are about minor differences in struct/array semantics under closures.
8589

8690
## Pick an engine

0 commit comments

Comments
 (0)