Intent-only codegen¶

2026-05-29

Version: 1.0.0 · Intent 3.3.0+

Rebuild a runnable Asset Admin app from the intent bundle only — no implementation/ vendored tree and no webapp-asset-admin-distributor-v2 on disk.

Bundle¶

Layer	Role
Intent YAML + human spec	Routes, themes, RBAC, GraphQL names, visual signatures
`templates/mosaic/app/css/`	Mosaic Tailwind 4 tokens + utility classes (codegen asset)
`scripts/generate-from-intent.js`	Emits Next.js app from the above

Generate¶

cd oves-sites
npm run validate-crud-intent
npm run generate:v2          # → ../webapp-asset-admin-distributor-v2 (wired UI)
# or
npm run generate-test-site   # → ../webapp-asset-admin-distributor-test
cd ../webapp-asset-admin-distributor-v2
npm install && npm run graphql:codegen && npm run dev

Exact replica vs production?¶


Routes, sidebar, sign-in chrome, dashboard shell	Driven by intent — aligned with parity contract
GraphQL, tables, maps, PayGo workflows	Wired via `templates/f11-runtime` overlay (lists, dashboards, charts, sign-in)
Pixel parity with assets.omnivoltaic.com	Mosaic shell + functional data; refine theme bodies as needed

Intent codegen produces the correct app skeleton and Mosaic styling foundation. Full production parity is completed by wiring catalog operations into generated theme slots (or AI following generate-assets-v2-prompt.md).

AI without v2 repo¶

Give the model:

Full intent bundle (5 YAML + asset-admin-distributor.md)
Output of npm run generate-test-site as starting tree, or instruct it to run the same codegen rules in generate-from-intent.js

Do not expect YAML alone to materialize thousands of lines of UI without codegen or AI filling theme implementations.