@avora-labs/cli 1.1.20

package/dist/utils/logger.d.ts

@@ -0,0 +1,21 @@
+export declare const logger: {
+    info(msg: string): void;
+    success(msg: string): void;
+    warning(msg: string): void;
+    error(msg: string, err?: unknown): void;
+    /** File created */
+    create(path: string, bytes?: number): void;
+    /** File updated */
+    update(path: string, detail?: string): void;
+    /** File deleted */
+    delete(path: string): void;
+    /** Dry-run prefix */
+    dry(path: string, action: "create" | "update" | "delete"): void;
+    /** Print a blank separator line */
+    nl(): void;
+    /** Section header */
+    header(title: string): void;
+    /** Rollback notification */
+    rollback(msg: string): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,MAAM;cACP,MAAM,GAAG,IAAI;iBAIV,MAAM,GAAG,IAAI;iBAIb,MAAM,GAAG,IAAI;eAIf,MAAM,QAAQ,OAAO,GAAG,IAAI;IAOvC,mBAAmB;iBACN,MAAM,UAAU,MAAM,GAAG,IAAI;IAK1C,mBAAmB;iBACN,MAAM,WAAW,MAAM,GAAG,IAAI;IAK3C,mBAAmB;iBACN,MAAM,GAAG,IAAI;IAI1B,qBAAqB;cACX,MAAM,UAAU,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAK/D,mCAAmC;UAC7B,IAAI;IAIV,qBAAqB;kBACP,MAAM,GAAG,IAAI;IAM3B,4BAA4B;kBACd,MAAM,GAAG,IAAI;CAG5B,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,63 @@
+import chalk from 'chalk';
+const PREFIX = {
+    info: chalk.cyan('ℹ'),
+    success: chalk.green('✔'),
+    warning: chalk.yellow('⚠'),
+    error: chalk.red('✖'),
+    create: chalk.green('CREATE'),
+    update: chalk.yellow('UPDATE'),
+    delete: chalk.red('DELETE'),
+    skip: chalk.gray('SKIP'),
+    dry: chalk.magenta('DRY'),
+};
+export const logger = {
+    info(msg) {
+        console.log(`  ${PREFIX.info}  ${chalk.white(msg)}`);
+    },
+    success(msg) {
+        console.log(`  ${PREFIX.success}  ${chalk.greenBright(msg)}`);
+    },
+    warning(msg) {
+        console.warn(`  ${PREFIX.warning}  ${chalk.yellow(msg)}`);
+    },
+    error(msg, err) {
+        console.error(`  ${PREFIX.error}  ${chalk.red(msg)}`);
+        if (err instanceof Error && err.message) {
+            console.error(chalk.dim(`     ${err.message}`));
+        }
+    },
+    /** File created */
+    create(path, bytes) {
+        const size = bytes !== undefined ? chalk.dim(` (${bytes} bytes)`) : '';
+        console.log(`  ${PREFIX.create} ${chalk.green(path)}${size}`);
+    },
+    /** File updated */
+    update(path, detail) {
+        const d = detail ? chalk.dim(` (${detail})`) : '';
+        console.log(`  ${PREFIX.update} ${chalk.yellow(path)}${d}`);
+    },
+    /** File deleted */
+    delete(path) {
+        console.log(`  ${PREFIX.delete} ${chalk.red(path)}`);
+    },
+    /** Dry-run prefix */
+    dry(path, action) {
+        const color = action === 'create' ? chalk.green : action === 'delete' ? chalk.red : chalk.yellow;
+        console.log(`  ${PREFIX.dry} [${action.toUpperCase()}] ${color(path)}`);
+    },
+    /** Print a blank separator line */
+    nl() {
+        console.log('');
+    },
+    /** Section header */
+    header(title) {
+        console.log('');
+        console.log(chalk.bold.blueBright(`  ◆ ${title}`));
+        console.log(chalk.dim('  ' + '─'.repeat(50)));
+    },
+    /** Rollback notification */
+    rollback(msg) {
+        console.warn(chalk.dim(`  ↩  [ROLLBACK] ${msg}`));
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,8 @@
+import { input, select, checkbox, confirm, password } from '@inquirer/prompts';
+import type { LayoutType, SectionType, AuthType } from '../types/cli.types.js';
+export { input, select, checkbox, confirm, password };
+export declare function promptLayout(defaultValue?: LayoutType): Promise<LayoutType>;
+export declare function promptSections(): Promise<SectionType[]>;
+export declare function promptAuthType(): Promise<AuthType>;
+export declare function promptNavGroup(existingGroups?: string[]): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAItD,wBAAsB,YAAY,CAAC,YAAY,GAAE,UAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAc7F;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAc7D;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAYxD;AAED,wBAAsB,cAAc,CAAC,cAAc,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBnF"}

package/dist/utils/prompt.js

@@ -0,0 +1,63 @@
+import { input, select, checkbox, confirm, password } from '@inquirer/prompts';
+export { input, select, checkbox, confirm, password };
+// ─── AMF-specific prompt helpers ─────────────────────────────────────────────
+export async function promptLayout(defaultValue = 'vertical') {
+    return select({
+        message: 'Default layout:',
+        default: defaultValue,
+        choices: [
+            { name: 'Vertical   — sidebar left, content right (most common)', value: 'vertical' },
+            { name: 'Horizontal — top navigation bar', value: 'horizontal' },
+            { name: 'Centered   — centered card (forms, landing)', value: 'centered' },
+            { name: 'Two-Column — split 50/50', value: 'two-column' },
+            { name: 'Dashboard  — responsive grid', value: 'dashboard-grid' },
+            { name: 'Compact    — compact sidebar', value: 'compact' },
+            { name: 'Empty      — no shell (full custom)', value: 'empty' },
+        ],
+    });
+}
+export async function promptSections() {
+    return checkbox({
+        message: 'Include sections:',
+        choices: [
+            { name: 'page-header   — title bar with action buttons', value: 'page-header', checked: true },
+            { name: 'table         — data table with pagination', value: 'table' },
+            { name: 'form          — reactive form', value: 'form' },
+            { name: 'stepper-form  — multi-step wizard form', value: 'stepper-form' },
+            { name: 'stats-grid    — KPI stat cards', value: 'stats-grid' },
+            { name: 'card          — content card', value: 'card' },
+            { name: 'accordion     — collapsible panels', value: 'accordion' },
+            { name: 'tabs          — tabbed content', value: 'tabs' },
+        ],
+    });
+}
+export async function promptAuthType() {
+    return select({
+        message: 'Auth type:',
+        default: 'jwt',
+        choices: [
+            { name: 'JWT      — JSON Web Token (most common)', value: 'jwt' },
+            { name: 'Session  — server-side session cookie', value: 'session' },
+            { name: 'OAuth2   — social / third-party login', value: 'oauth2' },
+            { name: 'API Key  — static API key header', value: 'apiKey' },
+            { name: 'Custom   — implement your own', value: 'custom' },
+        ],
+    });
+}
+export async function promptNavGroup(existingGroups = []) {
+    const customChoice = '__new__';
+    const choices = [
+        ...existingGroups.map(g => ({ name: g, value: g })),
+        { name: '+ Create new group', value: customChoice },
+    ];
+    if (choices.length > 1) {
+        const chosen = await select({
+            message: 'Add to nav group:',
+            choices,
+        });
+        if (chosen !== customChoice)
+            return chosen;
+    }
+    return input({ message: 'New group label:', default: 'Main' });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"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"}

package/dist/utils/template-engine.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Render an EJS template file.
+ * @param templatePath  - relative path inside templates/, e.g. 'page/page.meta.ts.ejs'
+ * @param data          - variables injected into the template
+ */
+export declare function renderTemplate(templatePath: string, data: Record<string, unknown>): Promise<string>;
+/** Render a raw EJS string (for inline templates in schematics). */
+export declare function renderInline(template: string, data: Record<string, unknown>): string;
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/utils/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEpF"}

package/dist/utils/template-engine.js

@@ -0,0 +1,23 @@
+import ejs from 'ejs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import fsExtra from 'fs-extra';
+const { readFile } = fsExtra;
+// Resolve templates/ relative to this file's location in dist/utils/
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = join(__dirname, '../../templates');
+/**
+ * Render an EJS template file.
+ * @param templatePath  - relative path inside templates/, e.g. 'page/page.meta.ts.ejs'
+ * @param data          - variables injected into the template
+ */
+export async function renderTemplate(templatePath, data) {
+    const fullPath = join(TEMPLATES_DIR, templatePath);
+    const raw = await readFile(fullPath, 'utf-8');
+    return ejs.render(raw, data, { async: false, filename: fullPath });
+}
+/** Render a raw EJS string (for inline templates in schematics). */
+export function renderInline(template, data) {
+    return ejs.render(template, data);
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/utils/template-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAO,MAAM,UAAU,CAAC;AAC/B,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;AAE7B,qEAAqE;AACrE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAAoB,EACpB,IAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,IAA6B;IAC1E,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/utils/transaction.d.ts

@@ -0,0 +1,37 @@
+/**
+ * FileTransaction — atomic file operations with full rollback.
+ *
+ * Usage:
+ *   const tx = new FileTransaction();
+ *   await tx.snapshot(filePath);       // save state BEFORE modifying
+ *   ... write files ...
+ *   if (error) await tx.rollback();    // restore everything
+ *   else tx.commit();                  // no-op, just marks done
+ */
+export declare class FileTransaction {
+    private snapshots;
+    private committed;
+    /**
+     * Snapshot the current state of a file before modifying it.
+     * If the file doesn't exist yet, records null so rollback will delete it.
+     */
+    snapshot(filePath: string): Promise<void>;
+    /**
+     * Restore all snapshotted files to their pre-transaction state.
+     * - Files that were CREATED will be deleted.
+     * - Files that were MODIFIED will be restored.
+     */
+    rollback(): Promise<void>;
+    /** Mark the transaction as done (no-op, prevents accidental rollback). */
+    commit(): void;
+    /** Number of files tracked in this transaction. */
+    get size(): number;
+}
+/**
+ * Runs a schematic function inside a transaction.
+ * If fn throws, all file changes are automatically rolled back.
+ */
+export declare function withTransaction<T>(fn: (tx: FileTransaction) => Promise<T>): Promise<T>;
+export declare function txWriteFile(tx: FileTransaction, filePath: string, content: string): Promise<void>;
+export declare function txReadFile(filePath: string): Promise<string>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/utils/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB/B,0EAA0E;IAC1E,MAAM,IAAI,IAAI;IAId,mDAAmD;IACnD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,CAAC,CAAC,CAUZ;AAID,wBAAsB,WAAW,CAC/B,EAAE,EAAE,eAAe,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAElE"}

package/dist/utils/transaction.js

@@ -0,0 +1,94 @@
+import fsExtra from 'fs-extra';
+const { readFile, writeFile, pathExists, ensureDir, remove } = fsExtra;
+import { dirname, resolve } from 'node:path';
+import { logger } from './logger.js';
+/**
+ * FileTransaction — atomic file operations with full rollback.
+ *
+ * Usage:
+ *   const tx = new FileTransaction();
+ *   await tx.snapshot(filePath);       // save state BEFORE modifying
+ *   ... write files ...
+ *   if (error) await tx.rollback();    // restore everything
+ *   else tx.commit();                  // no-op, just marks done
+ */
+export class FileTransaction {
+    snapshots = new Map();
+    committed = false;
+    /**
+     * Snapshot the current state of a file before modifying it.
+     * If the file doesn't exist yet, records null so rollback will delete it.
+     */
+    async snapshot(filePath) {
+        const absPath = resolve(filePath);
+        if (this.snapshots.has(absPath))
+            return; // already snapshotted
+        const exists = await pathExists(absPath);
+        this.snapshots.set(absPath, {
+            type: exists ? 'modify' : 'create',
+            path: absPath,
+            originalContent: exists ? await readFile(absPath, 'utf-8') : null,
+        });
+    }
+    /**
+     * Restore all snapshotted files to their pre-transaction state.
+     * - Files that were CREATED will be deleted.
+     * - Files that were MODIFIED will be restored.
+     */
+    async rollback() {
+        if (this.committed)
+            return;
+        for (const [, snap] of this.snapshots) {
+            try {
+                if (snap.originalContent === null) {
+                    // File was created by us — remove it
+                    await remove(snap.path);
+                    logger.rollback(`Deleted ${snap.path}`);
+                }
+                else {
+                    // File was modified — restore original content
+                    await ensureDir(dirname(snap.path));
+                    await writeFile(snap.path, snap.originalContent, 'utf-8');
+                    logger.rollback(`Restored ${snap.path}`);
+                }
+            }
+            catch (err) {
+                logger.error(`Rollback failed for ${snap.path}`, err);
+            }
+        }
+    }
+    /** Mark the transaction as done (no-op, prevents accidental rollback). */
+    commit() {
+        this.committed = true;
+    }
+    /** Number of files tracked in this transaction. */
+    get size() {
+        return this.snapshots.size;
+    }
+}
+/**
+ * Runs a schematic function inside a transaction.
+ * If fn throws, all file changes are automatically rolled back.
+ */
+export async function withTransaction(fn) {
+    const tx = new FileTransaction();
+    try {
+        const result = await fn(tx);
+        tx.commit();
+        return result;
+    }
+    catch (err) {
+        await tx.rollback();
+        throw err;
+    }
+}
+// ─── Write helpers that auto-snapshot before overwriting ─────────────────────
+export async function txWriteFile(tx, filePath, content) {
+    await tx.snapshot(filePath);
+    await ensureDir(dirname(resolve(filePath)));
+    await writeFile(resolve(filePath), content, 'utf-8');
+}
+export async function txReadFile(filePath) {
+    return readFile(resolve(filePath), 'utf-8');
+}
+//# sourceMappingURL=transaction.js.map

package/dist/utils/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/utils/transaction.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@avora-labs/cli",
+  "version": "1.1.20",
+  "description": "Official CLI for the AvoraMetaForge ecosystem",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AvoraLabs/avora-cli.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "avora": "./bin/avora.mjs"
+  },
+  "main": "./dist/cli.js",
+  "exports": {
+    ".": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates"
+  ],
+  "scripts": {
+    "build":         "tsc",
+    "build:watch":   "tsc --watch",
+    "dev":           "tsx src/cli.ts",
+    "clean":         "node -e \"require('fs').rmSync('./dist', { recursive: true, force: true })\"",
+    "link:cli":      "npm run build && npm link",
+    "test:info":     "node bin/avora.mjs info",
+    "test:dry-run":  "node bin/avora.mjs generate page test-page --layout vertical --section page-header --section table --guard --nav-group Main --dry-run"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^6.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "diff": "^7.0.0",
+    "ejs": "^3.1.10",
+    "execa": "^9.3.0",
+    "fs-extra": "^11.2.0",
+    "ts-morph": "^23.0.0"
+  },
+  "devDependencies": {
+    "@types/diff": "^6.0.0",
+    "@types/ejs": "^3.1.5",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "~5.8.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "avoralabs",
+    "avora",
+    "meta-forge",
+    "angular",
+    "cli",
+    "scaffold",
+    "meta-driven"
+  ],
+  "author": "AvoraLabs",
+  "license": "UNLICENSED"
+}

package/templates/app/app.component.ts.ejs

@@ -0,0 +1,9 @@
+import { Component } from '@angular/core';
+import { LayoutComponent } from '@avora-labs/meta-forge';
+
+@Component({
+  selector: 'app-root',
+  imports: [LayoutComponent],
+  template: '<app-layout></app-layout>',
+})
+export class AppComponent {}

package/templates/app/app.config.ts.ejs

@@ -0,0 +1,27 @@
+import { ApplicationConfig, provideZoneChangeDetection } from '@angular/core';
+import {
+  provideRouter,
+  withComponentInputBinding,
+  withViewTransitions,<% if (enableAuth) { %>
+  withDisabledInitialNavigation,<% } %>
+} from '@angular/router';
+import { provideHttpClient<% if (enableAuth) { %>, withInterceptors<% } %> } from '@angular/common/http';
+import { routes } from './app.routes';
+import { <% if (enableAuth) { %>authInterceptor, <% } %>provideAvoraMetaForge } from '@avora-labs/meta-forge';
+import { APP_META } from './app.meta';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideZoneChangeDetection({ eventCoalescing: true }),
+    provideRouter(
+      routes,
+      withComponentInputBinding(),
+      withViewTransitions(),<% if (enableAuth) { %>
+      withDisabledInitialNavigation(),<% } %>
+    ),
+    provideHttpClient(<% if (enableAuth) { %>
+      withInterceptors([authInterceptor])<% } %>
+    ),
+    provideAvoraMetaForge(APP_META),
+  ],
+};

package/templates/app/app.meta.ts.ejs

@@ -0,0 +1,58 @@
+import type { AppMeta } from '@avora-labs/meta-forge';
+import { dashboardPage } from './pages/dashboard.page';
+
+export const APP_META: AppMeta = {
+  app: {
+    name: '<%= appName %>',
+    defaultLayout: '<%= layout %>',
+    copyright: '© <%= new Date().getFullYear() %> <%= appName %>. All rights reserved.',
+<% if (enableAuth) { %>
+    defaultGuard: { requireAuth: true, redirectTo: '/login' },
+<% } %>
+  },
+
+<% if (enableAuth) { %>
+  auth: {
+    type: '<%= authType %>',
+    loginEndpoint: 'mock-login',
+    tokenStorage: 'localStorage',
+    tokenKey: '<%= appName.toLowerCase().replace(/\s+/g,'-') %>_auth_token',
+<% if (builtInAuthUI) { %>
+    builtInUI: {
+      enabled: true,
+      brandName: '<%= appName %>',
+      brandTagline: 'Secure Access Gateway'
+    },
+<% } %>
+  },
+
+<% } %>
+  navigation: [
+    {
+      label: 'Main',
+      items: [
+        { label: 'Dashboard', route: '/dashboard', icon: 'home' }
+      ]
+    }
+  ],
+
+  pages: [
+    dashboardPage
+  ],
+
+  apis: [
+<% if (enableAuth) { %>
+    {
+      id: 'mock-login',
+      method: 'POST',
+      path: '/auth/login',
+      mock: true,
+      mockDelay: 800,
+      mockData: {
+        token: 'mock-jwt-token-dev',
+        user: { id: 1, name: 'Admin User', role: 'admin' }
+      }
+    },
+<% } %>
+  ]
+};

package/templates/app/app.routes.ts.ejs

@@ -0,0 +1,9 @@
+import { Routes } from '@angular/router';
+import { getAmfAuthRoutes } from '@avora-labs/meta-forge';
+import { APP_META } from './app.meta';
+
+// getAmfAuthRoutes auto-adds a redirect from '' to meta.pages[0].path
+// and adds auth pages (login, forgot-password etc.) when auth.builtInUI.enabled = true
+export const routes: Routes = [
+  ...getAmfAuthRoutes(APP_META),
+];

package/templates/app/dashboard.page.ts.ejs

@@ -0,0 +1,61 @@
+import { PageMeta } from '@avora/meta-forge';
+
+export const dashboardPage: PageMeta = {
+  id: 'dashboard',
+  path: 'dashboard',
+  title: 'Dashboard',
+  layout: '<%= layout %>',
+<% if (enableAuth) { %>
+  guard: { requireAuth: true, redirectTo: '/login' },
+<% } %>
+  sections: [
+    {
+      type: 'page-header',
+      config: {
+        title: 'Dashboard',
+        subtitle: 'Welcome to <%= appName %>',
+        actions: []
+      }
+    },
+    {
+      type: 'stats-grid',
+      config: {
+        stats: [
+          {
+            label: 'Total Users',
+            value: '1,248',
+            trend: '+12%',
+            trendPositive: true,
+            icon: 'users',
+            color: '#6366f1'
+          },
+          {
+            label: 'Active Sessions',
+            value: '342',
+            trend: '+5%',
+            trendPositive: true,
+            icon: 'activity',
+            color: '#22c55e'
+          },
+          {
+            label: 'Revenue',
+            value: '$48,200',
+            trend: '+8%',
+            trendPositive: true,
+            icon: 'dollar-sign',
+            color: '#f59e0b'
+          },
+          {
+            label: 'Pending Tasks',
+            value: '17',
+            trend: '-3',
+            trendPositive: false,
+            icon: 'clock',
+            color: '#ef4444'
+          }
+        ],
+        columns: 4
+      }
+    }
+  ]
+};