Skip to content

Commit f684659

Browse files
committed
commit: update wheels cli templates for wheels g command
1 parent 7f53287 commit f684659

File tree

2 files changed

+43
-27
lines changed
  • cli/src/commands/wheels/generate
  • docs/src/command-line-tools/commands/generate

2 files changed

+43
-27
lines changed

cli/src/commands/wheels/generate/app.cfc

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -43,11 +43,11 @@ component aliases="wheels g app" extends="../base" {
4343

4444
// Map these shortcut names to the actual ForgeBox slugs
4545
variables.templateMap = {
46-
'Base' : 'wheels-base-template@BE',
47-
'Base@BE' : 'wheels-base-template@BE',
48-
'HelloWorld' : 'cfwheels-template-helloworld',
49-
'HelloDynamic': 'cfwheels-template-hellodynamic',
50-
'HelloPages' : 'cfwheels-template-hellopages'
46+
'WheelsBaseTemplate' : 'wheels-base-template@^3.0.0',
47+
'BleedingEdge' : 'wheels-base-template@BE',
48+
'WheelsTemplateHTMX' : 'cfwheels-template-htmx-alpine-simple',
49+
'WheelsStarterApp' : 'wheels-starter-app',
50+
'WheelsTodoMVCHTMX' : 'cfwheels-todomvc-htmx'
5151
};
5252

5353
return this;
@@ -68,7 +68,7 @@ component aliases="wheels g app" extends="../base" {
6868
**/
6969
function run(
7070
name = 'MyApp',
71-
template = 'wheels-base-template@BE',
71+
template = 'wheels-base-template@^3.0.0',
7272
directory,
7373
reloadPassword = '',
7474
datasourceName,

docs/src/command-line-tools/commands/generate/app.md

Lines changed: 37 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -16,15 +16,15 @@ wheels g app [name] [template] [directory] [options]
1616
This command supports multiple parameter formats:
1717

1818
- **Positional parameters**: `wheels generate app blog` (most common)
19-
- **Named parameters**: `name=value` (e.g., `name=blog`, `template=HelloWorld`)
19+
- **Named parameters**: `name=value` (e.g., `name=blog`, `template=WheelsBaseTemplate`)
2020
- **Flag parameters**: `--flag` equals `flag=true` (e.g., `--useBootstrap` equals `useBootstrap=true`)
2121

2222
**Parameter Mixing Rules:**
2323

2424
**ALLOWED:**
2525
- All positional: `wheels generate app blog`
2626
- All positional + flags: `wheels generate app blog --useBootstrap --init`
27-
- All named: `name=blog template=HelloWorld --useBootstrap`
27+
- All named: `name=blog template=WheelsBaseTemplate --useBootstrap`
2828

2929
**NOT ALLOWED:**
3030
- Positional + named: `wheels generate app blog name=myapp` (causes error)
@@ -40,7 +40,7 @@ The `wheels generate app` command creates a new Wheels application with a comple
4040
| Argument | Description | Default |
4141
|----------|-------------|---------|
4242
| `name` | Application name | `MyApp` |
43-
| `template` | Template to use | `wheels-base-template@BE` |
43+
| `template` | Template to use | `wheels-base-template@^3.0.0` |
4444
| `directory` | Target directory | `./{name}` |
4545

4646
## Options
@@ -57,38 +57,54 @@ The `wheels generate app` command creates a new Wheels application with a comple
5757

5858
## Available Templates
5959

60-
### wheels-base-template@BE (Default)
60+
### wheels-base-template@^3.0.0 (stable)
6161
```bash
6262
wheels generate app myapp
6363
```
64+
- Backend Edition default template
65+
- Complete MVC structure with proven, production-ready defaults
66+
- Sample code with minimal, predictable configuration
67+
- H2 database setup by default
68+
69+
### BleedingEdge
70+
```bash
71+
wheels generate app myapp BleedingEdge
72+
```
6473
- Backend Edition template
6574
- Complete MVC structure
6675
- Sample code and configuration
6776
- H2 database setup by default
6877

69-
### HelloWorld
78+
### WheelsStarterApp
7079
```bash
71-
wheels generate app myapp HelloWorld
80+
wheels generate app myapp WheelsStarterApp
7281
```
73-
- Simple "Hello World" example
74-
- One controller and view
75-
- Great for learning
76-
77-
### HelloDynamic
82+
- Starter user management and authentication application built with Wheels 3.0
83+
- Demonstrates best practices for security, conventions, and MVC architecture
84+
- Full authentication & authorization flow (registration, verification, RBAC, admin panel)
85+
- Built-in security features: CSRF protection, audit logging, bcrypt passwords, role checks
86+
- Modern, responsive UI using Bootstrap with Wheels helpers
87+
- Multi-database support with easy setup via CommandBox (MySQL, PostgreSQL, MSSQL, Oracle, H2)
88+
89+
### WheelsTemplateHTMX
7890
```bash
79-
wheels generate app myapp HelloDynamic
91+
wheels generate app myapp WheelsTemplateHTMX
8092
```
81-
- Dynamic content example
82-
- Database interaction
83-
- Form handling
84-
85-
### HelloPages
93+
- Blank starter application for Wheels
94+
- Full MVC structure pre-configured
95+
- htmx integrated for server-side AJAX interactions
96+
- Alpine.js included for lightweight client-side interactivity
97+
- simple.css bundled for clean, minimal styling
98+
- Ready-to-extend layout with sample configuration
99+
100+
### WheelsTodoMVCHTMX
86101
```bash
87-
wheels generate app myapp HelloPages
102+
wheels generate app myapp WheelsTodoMVCHTMX
88103
```
89-
- Static pages example
90-
- Layout system
91-
- Navigation structure
104+
- Reference TodoMVC implementation built with CFWheels
105+
- Uses HTMX for server-driven interactivity
106+
- Demonstrates real-world MVC and CRUD patterns
107+
- Quick setup using CommandBox, CFWheels CLI, and H2
92108

93109
## Examples
94110

0 commit comments

Comments
 (0)