coldbox-app-layoutslisted
Install: claude install-skill ColdBox/skills
# App Layouts
## When to Use This Skill
Use this skill when:
- Creating a new ColdBox application from scratch and choosing a project structure
- Deciding between the `flat`, `boxlang`, and `modern` application templates
- Scaffolding via `box coldbox create app skeleton=<name>`
- Understanding directory conventions for an existing app
- Migrating from one layout to another
## Language & Engine Compatibility
| Layout | CFML (Adobe CF / Lucee) | BoxLang |
|--------|------------------------|---------|
| `flat` | Yes | Yes |
| `boxlang` | No | Yes only |
| `modern` | Yes | Yes |
> **Default**: The ColdBox CLI (`coldbox create app`) defaults to the `boxlang` skeleton. Pass `--cfml` or `skeleton=flat` / `skeleton=modern` to use another layout.
## Flat Layout
**Template repo**: <https://github.com/coldbox-templates/flat>
The flat layout places all application code directly in the web root. It is the traditional ColdBox structure and the widest-compatibility choice — works with Adobe ColdFusion, Lucee, and BoxLang.
### Flat: Directory Map
```
/
├── Application.cfc # App bootstrap
├── index.cfm # Front controller
├── box.json # CommandBox package descriptor
├── server.json # Server configuration
├── pom.xml # Maven Java dependencies (optional)
│
├── config/
│ ├── ColdBox.cfc # Framework settings
│ ├── Router.cfc # URL routing
│ └── WireBox.cfc # D