prism site generate

Generate a static site from PRISM capability stacks.

Synopsis

prism site generate --stack=<path> [options]

Description

Generates a multi-page static website from capability stacks, maturity models, and state documents. The generated site includes capability views, metrics dashboards, and PDF export functionality.

Options

Option	Description	Default
`--stack`	Capability stack file or directory (required, repeatable)	-
`--models`	Directory containing maturity model JSON files	-
`--states`	Directory containing state JSON files	-
`--output`	Output directory for generated site	`./dist`
`--capstack`	Capability stack file for layer-based maturity views	-
`--aggregation`	Aggregation method: `min` (conservative) or `avg` (average)	`min`
`--theme`	Theme: `light` or `dark`	`dark`
`--title`	Site title	`PRISM Dashboard`
`--description`	Site description	`Capability maturity dashboard`
`--base-url`	Base URL for the site (for absolute links)	-
`--site-nav-js`	Path to site-nav JavaScript bundle	-
`--hide-generated-by`	Hide the "Generated by PRISM" footer	`false`

Standard Directory Structure

The recommended way to organize PRISM data:

{stack-name}/
├── stack.json     # Capability stack definition (required)
├── model.json     # Maturity model (optional)
├── state.json     # Current state (optional)
└── roadmap.json   # Roadmap items (optional)

Examples

Basic generation

prism site generate --stack=./security/ --output=./dist

Multiple stacks

prism site generate \
  --stack=./security/ \
  --stack=./reliability/ \
  --output=./dist \
  --title="PRISM Dashboard"

Parent directory with multiple stacks

prism site generate \
  --stack=./stacks/ \
  --output=./dist/ \
  --theme=dark

With layer views and aggregation method

prism site generate \
  --stack=./stacks/ \
  --aggregation=min \
  --output=./dist

Using average aggregation

prism site generate \
  --stack=./security/ \
  --aggregation=avg \
  --output=./dist

Legacy mode with separate directories

prism site generate \
  --stack=./security-stack.json \
  --models=./models/ \
  --states=./states/ \
  --output=./dist

Generated Pages

The site includes the following pages per stack:

Page	Description
`capabilities-by-category-{stack}.html`	Capabilities grouped by category
`capabilities-by-layer-{stack}.html`	Capabilities grouped by layer
`metrics-{stack}.html`	Threshold matrix table with PDF export
`metrics-by-category-{stack}.html`	Metrics grouped by category with PDF export
`metrics-by-layer-{stack}.html`	Metrics grouped by layer with PDF export

Aggregation Methods

Method	Description	Use Case
`min`	Minimum SLI level across the group	Conservative view, ensures all metrics meet threshold
`avg`	Average SLI level across the group	Balanced view, shows overall progress

PDF Export

Layer and category metric views include PDF export buttons:

Per-group export - Export a single layer/category to PDF
Export all - Export all layers/categories to a single PDF with summary