If generation fails, start by checking the CLI output and warnings. irgen always surfaces unsupported behavior as explicit warnings.
DSL entry did not call app(...) / frontend(...)
Make sure your DSL file imports the correct helper and calls it at top level. The CLI skips files that do not emit a declaration.
Cannot import .ts files
irgen requires Node >= 18 and uses the tsx loader. If you still see import errors, verify you are running the published CLI (npx irgen).
Policy validation failed
Policy schemas are strict. Double-check keys and value types in your policy blocks or JSON passed to --policies.
Dynamic routes skipped (static outputs)
Static Site and React SSG skip dynamic routes unless routes are explicit. Provide a static route list when required.
Missing assets (search, mermaid, highlight)
Warnings indicate optional assets are missing. Run npm install in the irgen project or disable the feature via policy.