# pixl8/preside-cms-commandbox-commands architecture

> Architecture diagram of the GitHub repository pixl8/preside-cms-commandbox-commands, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pixl8/preside-cms-commandbox-commands
- Repository: https://github.com/pixl8/preside-cms-commandbox-commands

## Overview

This repository provides CommandBox commands for PresideCMS. The documented user workflow is creating a site with `preside new site`, then starting it with `preside start`; first startup may download Preside and prompt for database information, and a browser opens after startup. The tree also shows commands for creating and compiling extensions, but their behavior and connections are not documented in the available evidence. Edges therefore show only README-documented relationships.

Main entry points: [`commands/preside/start.cfc`](https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/start.cfc) (Start site), [`commands/preside/new/site.cfc`](https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/new/site.cfc) (Create site)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site commands"]
  node_new_site["Create site<br/>[site.cfc]"]
  node_start["Start site<br/>[start.cfc]"]
end

subgraph group_extension["Extension commands"]
  node_new_extension["Create extension<br/>[extension.cfc]"]
  node_compile_extension["Compile extension<br/>[compile.cfc]"]
end

node_user(("CommandBox user"))
node_preside_download["Preside download"]
node_browser["Browser"]

node_user -->|"runs command"| node_new_site
node_user -->|"runs command"| node_start
node_start -->|"downloads when needed"| node_preside_download
node_start -->|"prompts for database info"| node_user
node_start -->|"opens after startup"| node_browser

click node_new_site "https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/new/site.cfc"
click node_start "https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/start.cfc"
click node_new_extension "https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/new/extension.cfc"
click node_compile_extension "https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/extension/compile.cfc"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_new_site,node_start,node_user,node_browser toneBlue
class node_new_extension,node_compile_extension toneAmber
class node_preside_download toneIndigo
```

## Components

### Site commands

- [Create site](https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/new/site.cfc): `commands/preside/new/site.cfc`
- [Start site](https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/start.cfc): `commands/preside/start.cfc`

### Extension commands

- [Create extension](https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/new/extension.cfc): `commands/preside/new/extension.cfc`
- [Compile extension](https://github.com/pixl8/preside-cms-commandbox-commands/blob/stable/commands/preside/extension/compile.cfc): `commands/preside/extension/compile.cfc`

### Other components

- **CommandBox user**
- **Preside download**
- **Browser**

## Connections

- CommandBox user → Create site: runs command (evidence: `README.md`)
- CommandBox user → Start site: runs command (evidence: `README.md`)
- Start site → Preside download: downloads when needed (evidence: `README.md`)
- Start site → CommandBox user: prompts for database info (evidence: `README.md`)
- Start site → Browser: opens after startup (evidence: `README.md`)
