Skip to content

Bean Scene Boilerplate Variants

This page is the fast lookup surface for backend Vona and frontend Zova bean scenes that expose more than one CLI scaffold template.

Use it when you need to answer questions such as:

  • does this bean scene support --boilerplate=...
  • which variant names are currently defined
  • where is the source module metadata for that scene

Shared rule

Vona and Zova follow the same practical lookup rule for bean-scene boilerplate variants:

  • boilerplate provides the default template
  • --boilerplate=web maps to boilerplateWeb
  • more generally, --boilerplate=name maps to boilerplateName

That means the available variants are scene-defined metadata, not a universal list shared by every scene.

A practical contributor rule is:

  1. use the default template unless you know the scene exposes a named variant
  2. check this page first for current built-in examples
  3. if needed, verify the owning module package.json metadata before assuming a variant exists

Backend Vona

Current built-in scenes with variants

SceneDefault metadata keyNamed variant keysExample commandSource module
filterboilerplateboilerplateGlobalnpm run vona :create:bean filter log -- --module=training-student --boilerplate=globalvona-module-a-aspect
pipeboilerplateboilerplateGlobalnpm run vona :create:bean pipe log -- --module=training-student --boilerplate=globalvona-module-a-aspect
interceptorboilerplateboilerplateGlobalnpm run vona :create:bean interceptor log -- --module=training-student --boilerplate=globalvona-module-a-aspect
guardboilerplateboilerplateGlobalnpm run vona :create:bean guard auth -- --module=training-student --boilerplate=globalvona-module-a-aspect
middlewareboilerplateboilerplateGlobalnpm run vona :create:bean middleware trace -- --module=training-student --boilerplate=globalvona-module-a-aspect
ssrMenuboilerplateboilerplateWebnpm run vona :create:bean ssrMenu menuTest -- --module=training-student --boilerplate=webvona-module-a-ssr
ssrMenuGroupboilerplateboilerplateWebnpm run vona :create:bean ssrMenuGroup groupTest -- --module=training-student --boilerplate=webvona-module-a-ssr

These backend entries come from the current vonaModule.onions metadata in a-aspect and a-ssr.

Frontend Zova

Current built-in scenes with variants

SceneDefault metadata keyNamed variant keysExample command patternSource module
commandboilerplateboilerplateCommandBulk, boilerplateCommandRownpm run zova :create:bean command test -- --module=training-student --boilerplate=commandRowzova-module-a-command
tableCellboilerplateboilerplateTableActionRownpm run zova :create:bean tableCell test -- --module=training-student --boilerplate=tableActionRowzova-module-a-table

These frontend entries come from the current zovaModule.onions metadata in a-command and a-table.

For the built-in command scene’s runtime model and helper-base patterns, see Command Scene Authoring.

Guidance for AI-assisted development

Do not assume every bean scene supports named variants.

For reliable AI-assisted workflow selection:

  1. choose npm run vona for backend bean scenes and npm run zova for frontend bean scenes
  2. check whether the current scene is listed on this page
  3. if it is not listed, verify the owning module metadata before recommending --boilerplate=...
  4. treat this page as a current built-in lookup surface, not as a promise that all future scenes will follow the same naming set

Use this page together with:

Released under the MIT License.