@abgov/nx-adsp 12.16.1 → 12.18.0

package/generators.json

@@ -44,6 +44,11 @@
       "schema": "./src/generators/angular-app/schema.json",
       "description": "Generator that creates a Angular based frontend application."
     },
+    "vue-app": {
+      "factory": "./src/generators/vue-app/vue-app",
+      "schema": "./src/generators/vue-app/schema.json",
+      "description": "Generator that creates a Vue 3 frontend application using GoA web components."
+    },
     "mean": {
       "factory": "./src/generators/mean/mean",
       "schema": "./src/generators/mean/schema.json",
@@ -61,6 +66,18 @@
       "schema": "./src/generators/pean/schema.json",
       "description": "Generator that creates a PEAN fullstack solution.",
       "hidden": true
+    },
+    "pevn": {
+      "factory": "./src/generators/pevn/pevn",
+      "schema": "./src/generators/pevn/schema.json",
+      "description": "Generator that creates a PEVN fullstack solution.",
+      "hidden": true
+    },
+    "mevn": {
+      "factory": "./src/generators/mevn/mevn",
+      "schema": "./src/generators/mevn/schema.json",
+      "description": "Generator that creates a MEVN fullstack solution.",
+      "hidden": true
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abgov/nx-adsp",
-  "version": "12.16.1",
+  "version": "12.18.0",
   "license": "Apache-2.0",
   "main": "src/index.js",
   "description": "Government of Alberta - Nx plugin for ADSP apps.",
@@ -17,6 +17,7 @@
     "@nx/eslint": "^22.0.0",
     "@nx/express": "^22.0.0",
     "@nx/react": "^22.0.0",
+    "@nx/vue": "^22.0.0",
     "tslib": "^2.0.0"
   },
   "peerDependenciesMeta": {
@@ -25,6 +26,9 @@
     },
     "@nx/angular": {
       "optional": true
+    },
+    "@nx/vue": {
+      "optional": true
     }
   },
   "dependencies": {

package/src/generators/mevn/mevn.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+import { Schema } from './schema';
+export default function (host: Tree, options: Schema): Promise<() => void>;

package/src/generators/mevn/mevn.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const nx_oc_1 = require("@abgov/nx-oc");
+const express_service_1 = require("../express-service/express-service");
+const vue_app_1 = require("../vue-app/vue-app");
+const agent_1 = require("../../utils/agent");
+const keycloak_admin_1 = require("../../utils/keycloak-admin");
+const plugin_version_1 = require("../../utils/plugin-version");
+function normalizeOptions(host, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const adsp = yield (0, nx_oc_1.getAdspConfiguration)(host, options);
+        return Object.assign(Object.assign({}, options), { accessToken: (_a = adsp.accessToken) !== null && _a !== void 0 ? _a : options.accessToken, adsp });
+    });
+}
+function default_1(host, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+        const normalizedOptions = yield normalizeOptions(host, options);
+        const projectName = (0, devkit_1.names)(options.name).fileName;
+        const serviceName = `${projectName}-service`;
+        const appName = `${projectName}-app`;
+        const appsDir = (0, devkit_1.getWorkspaceLayout)(host).appsDir;
+        const serviceRoot = `${appsDir}/${serviceName}`;
+        const appRoot = `${appsDir}/${appName}`;
+        yield (0, express_service_1.default)(host, Object.assign(Object.assign({}, normalizedOptions), { name: serviceName, skipAgent: true, database: 'mongo' }));
+        yield (0, vue_app_1.default)(host, Object.assign(Object.assign({}, normalizedOptions), { name: appName, proxy: {
+                location: '/api/',
+                proxyPass: `http://${serviceName}:3333/${serviceName}/`,
+            }, skipAgent: true }));
+        if (normalizedOptions.adsp) {
+            const accessToken = (_a = normalizedOptions.adsp.accessToken) !== null && _a !== void 0 ? _a : normalizedOptions.accessToken;
+            const serviceClientId = `urn:ads:${normalizedOptions.adsp.tenant}:${serviceName}`;
+            const appClientId = `urn:ads:${normalizedOptions.adsp.tenant}:${appName}`;
+            yield (0, keycloak_admin_1.ensureAudienceMapper)(normalizedOptions.adsp.accessServiceUrl, normalizedOptions.adsp.tenantRealm, appClientId, serviceClientId, accessToken);
+            yield (0, keycloak_admin_1.ensureClientRoleScope)(normalizedOptions.adsp.accessServiceUrl, normalizedOptions.adsp.tenantRealm, appClientId, serviceClientId, 'example-role', accessToken);
+        }
+        if (normalizedOptions.adsp && !normalizedOptions.skipAgent) {
+            const accessToken = (_b = normalizedOptions.adsp.accessToken) !== null && _b !== void 0 ? _b : (yield (0, nx_oc_1.realmLogin)(normalizedOptions.adsp.accessServiceUrl, normalizedOptions.adsp.tenantRealm).catch((err) => {
+                var _a;
+                process.stdout.write(`\n[nx-adsp] Agent sign-in failed (${(_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : err}) — skipping agent interaction.\n`);
+                return undefined;
+            }));
+            yield (0, agent_1.confirmAfterAgentInterrupt)(yield (0, agent_1.consultAgent)(normalizedOptions.adsp.directoryServiceUrl, accessToken, {
+                projectName,
+                projectType: 'mevn',
+                tenant: normalizedOptions.adsp.tenant,
+                pluginVersion: plugin_version_1.PLUGIN_VERSION,
+                existingFiles: {
+                    'service/src/main.ts': (_d = (_c = host.read(`${serviceRoot}/src/main.ts`)) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : '',
+                    'service/src/environment.ts': (_f = (_e = host.read(`${serviceRoot}/src/environment.ts`)) === null || _e === void 0 ? void 0 : _e.toString()) !== null && _f !== void 0 ? _f : '',
+                    'service/src/database.ts': (_h = (_g = host.read(`${serviceRoot}/src/database.ts`)) === null || _g === void 0 ? void 0 : _g.toString()) !== null && _h !== void 0 ? _h : '',
+                    'service/src/events.ts': (_k = (_j = host.read(`${serviceRoot}/src/events.ts`)) === null || _j === void 0 ? void 0 : _j.toString()) !== null && _k !== void 0 ? _k : '',
+                    'app/src/App.vue': (_m = (_l = host.read(`${appRoot}/src/App.vue`)) === null || _l === void 0 ? void 0 : _l.toString()) !== null && _m !== void 0 ? _m : '',
+                    'app/src/main.ts': (_p = (_o = host.read(`${appRoot}/src/main.ts`)) === null || _o === void 0 ? void 0 : _o.toString()) !== null && _p !== void 0 ? _p : '',
+                    'app/src/router/index.ts': (_r = (_q = host.read(`${appRoot}/src/router/index.ts`)) === null || _q === void 0 ? void 0 : _q.toString()) !== null && _r !== void 0 ? _r : '',
+                    'app/src/environments/environment.ts': (_t = (_s = host.read(`${appRoot}/src/environments/environment.ts`)) === null || _s === void 0 ? void 0 : _s.toString()) !== null && _t !== void 0 ? _t : '',
+                },
+            }, host, serviceRoot, { additionalRoots: { 'app': appRoot } }));
+        }
+        yield (0, devkit_1.formatFiles)(host);
+        return () => {
+            (0, devkit_1.installPackagesTask)(host);
+        };
+    });
+}
+//# sourceMappingURL=mevn.js.map

package/src/generators/mevn/mevn.js.map

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

package/src/generators/mevn/mevn.spec.ts

@@ -0,0 +1,47 @@
+import { readProjectConfiguration } from '@nx/devkit';
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+
+import * as utils from '@abgov/nx-oc';
+import { environments } from '@abgov/nx-oc';
+import { Schema } from './schema';
+import generator from './mevn';
+
+jest.mock('@nx/devkit', () => ({ ...jest.requireActual('@nx/devkit'), formatFiles: jest.fn().mockResolvedValue(undefined) }));
+jest.mock('@abgov/nx-oc');
+jest.mock('../../utils/agent', () => ({
+  consultAgent: jest.fn().mockResolvedValue(null),
+  confirmAfterAgentInterrupt: jest.fn().mockResolvedValue(undefined),
+}));
+const utilsMock = utils as jest.Mocked<typeof utils>;
+utilsMock.getAdspConfiguration.mockResolvedValue({
+  tenant: 'test',
+  tenantRealm: 'test',
+  accessServiceUrl: environments.test.accessServiceUrl,
+  directoryServiceUrl: environments.test.directoryServiceUrl,
+});
+utilsMock.realmLogin.mockResolvedValue('test-token');
+
+describe('MEVN Generator', () => {
+  const options: Schema = {
+    name: 'test',
+    env: 'dev',
+  };
+
+  it('can run', async () => {
+    const host = createTreeWithEmptyWorkspace({ layout: 'apps-libs' });
+    await generator(host, options);
+
+    const appConfig = readProjectConfiguration(host, 'test-app');
+    expect(appConfig.root).toBe('apps/test-app');
+
+    const serviceConfig = readProjectConfiguration(host, 'test-service');
+    expect(serviceConfig.root).toBe('apps/test-service');
+
+    expect(host.exists('apps/test-app/nginx.conf')).toBeTruthy();
+    const nginxConf = host.read('apps/test-app/nginx.conf').toString();
+    expect(nginxConf).toContain('http://test-service:3333/');
+
+    expect(host.exists('apps/test-app/src/App.vue')).toBeTruthy();
+    expect(host.exists('apps/test-service/prisma/schema.prisma')).toBeFalsy();
+  }, 30000);
+});

package/src/generators/mevn/schema.d.ts

@@ -0,0 +1,14 @@
+import { AdspConfiguration, EnvironmentName } from '@abgov/nx-oc';
+
+export interface Schema {
+  name: string;
+  env: EnvironmentName;
+  accessToken?: string;
+  tenant?: string;
+  tenantRealm?: string;
+  skipAgent?: boolean;
+}
+
+export interface NormalizedSchema extends Schema {
+  adsp: AdspConfiguration;
+}

package/src/generators/mevn/schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "id": "NxAdspMevn",
+  "title": "MEVN Stack ADSP Solution",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Name of the MEVN stack solution.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use?"
+    },
+    "env": {
+      "type": "string",
+      "description": "Environment to target.",
+      "$default": {
+        "$source": "argv",
+        "index": 1
+      },
+      "alias": "e",
+      "x-prompt": {
+        "message": "Which ADSP environment do you want to target?",
+        "type": "list",
+        "items": [
+          "dev",
+          "test",
+          "prod"
+        ]
+      }
+    },
+    "tenant": {
+      "type": "string",
+      "description": "ADSP tenant name. Enables a single browser login for the full stack — service and frontend agent interactions both use the same tenant-realm token.",
+      "alias": "t"
+    },
+    "tenantRealm": {
+      "type": "string",
+      "description": "Keycloak realm UUID. Optional when --tenant is provided — overrides the realm looked up from the tenant service.",
+      "alias": "tr"
+    },
+    "accessToken": {
+      "type": "string",
+      "description": "Access token for retrieving configuration from ADSP APIs.",
+      "alias": "at"
+    },
+    "skipAgent": {
+      "type": "boolean",
+      "description": "Skip the consultAgent interaction and generate base scaffolding only.",
+      "default": false
+    }
+  },
+  "required": [
+    "name",
+    "env"
+  ],
+  "additionalProperties": false
+}

package/src/generators/pevn/pevn.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+import { Schema } from './schema';
+export default function (host: Tree, options: Schema): Promise<() => void>;

package/src/generators/pevn/pevn.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const nx_oc_1 = require("@abgov/nx-oc");
+const express_service_1 = require("../express-service/express-service");
+const vue_app_1 = require("../vue-app/vue-app");
+const agent_1 = require("../../utils/agent");
+const keycloak_admin_1 = require("../../utils/keycloak-admin");
+const plugin_version_1 = require("../../utils/plugin-version");
+function normalizeOptions(host, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const adsp = yield (0, nx_oc_1.getAdspConfiguration)(host, options);
+        return Object.assign(Object.assign({}, options), { accessToken: (_a = adsp.accessToken) !== null && _a !== void 0 ? _a : options.accessToken, adsp });
+    });
+}
+function default_1(host, options) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+        const normalizedOptions = yield normalizeOptions(host, options);
+        const projectName = (0, devkit_1.names)(options.name).fileName;
+        const serviceName = `${projectName}-service`;
+        const appName = `${projectName}-app`;
+        const appsDir = (0, devkit_1.getWorkspaceLayout)(host).appsDir;
+        const serviceRoot = `${appsDir}/${serviceName}`;
+        const appRoot = `${appsDir}/${appName}`;
+        yield (0, express_service_1.default)(host, Object.assign(Object.assign({}, normalizedOptions), { name: serviceName, skipAgent: true, database: 'postgres' }));
+        yield (0, vue_app_1.default)(host, Object.assign(Object.assign({}, normalizedOptions), { name: appName, proxy: {
+                location: '/api/',
+                proxyPass: `http://${serviceName}:3333/${serviceName}/`,
+            }, skipAgent: true }));
+        if (normalizedOptions.adsp) {
+            const accessToken = (_a = normalizedOptions.adsp.accessToken) !== null && _a !== void 0 ? _a : normalizedOptions.accessToken;
+            const serviceClientId = `urn:ads:${normalizedOptions.adsp.tenant}:${serviceName}`;
+            const appClientId = `urn:ads:${normalizedOptions.adsp.tenant}:${appName}`;
+            yield (0, keycloak_admin_1.ensureAudienceMapper)(normalizedOptions.adsp.accessServiceUrl, normalizedOptions.adsp.tenantRealm, appClientId, serviceClientId, accessToken);
+            yield (0, keycloak_admin_1.ensureClientRoleScope)(normalizedOptions.adsp.accessServiceUrl, normalizedOptions.adsp.tenantRealm, appClientId, serviceClientId, 'example-role', accessToken);
+        }
+        if (normalizedOptions.adsp && !normalizedOptions.skipAgent) {
+            const accessToken = (_b = normalizedOptions.adsp.accessToken) !== null && _b !== void 0 ? _b : (yield (0, nx_oc_1.realmLogin)(normalizedOptions.adsp.accessServiceUrl, normalizedOptions.adsp.tenantRealm).catch((err) => {
+                var _a;
+                process.stdout.write(`\n[nx-adsp] Agent sign-in failed (${(_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : err}) — skipping agent interaction.\n`);
+                return undefined;
+            }));
+            yield (0, agent_1.confirmAfterAgentInterrupt)(yield (0, agent_1.consultAgent)(normalizedOptions.adsp.directoryServiceUrl, accessToken, {
+                projectName,
+                projectType: 'pevn',
+                tenant: normalizedOptions.adsp.tenant,
+                pluginVersion: plugin_version_1.PLUGIN_VERSION,
+                existingFiles: {
+                    'service/src/main.ts': (_d = (_c = host.read(`${serviceRoot}/src/main.ts`)) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : '',
+                    'service/src/environment.ts': (_f = (_e = host.read(`${serviceRoot}/src/environment.ts`)) === null || _e === void 0 ? void 0 : _e.toString()) !== null && _f !== void 0 ? _f : '',
+                    'service/src/database.ts': (_h = (_g = host.read(`${serviceRoot}/src/database.ts`)) === null || _g === void 0 ? void 0 : _g.toString()) !== null && _h !== void 0 ? _h : '',
+                    'service/src/events.ts': (_k = (_j = host.read(`${serviceRoot}/src/events.ts`)) === null || _j === void 0 ? void 0 : _j.toString()) !== null && _k !== void 0 ? _k : '',
+                    'app/src/App.vue': (_m = (_l = host.read(`${appRoot}/src/App.vue`)) === null || _l === void 0 ? void 0 : _l.toString()) !== null && _m !== void 0 ? _m : '',
+                    'app/src/main.ts': (_p = (_o = host.read(`${appRoot}/src/main.ts`)) === null || _o === void 0 ? void 0 : _o.toString()) !== null && _p !== void 0 ? _p : '',
+                    'app/src/router/index.ts': (_r = (_q = host.read(`${appRoot}/src/router/index.ts`)) === null || _q === void 0 ? void 0 : _q.toString()) !== null && _r !== void 0 ? _r : '',
+                    'app/src/environments/environment.ts': (_t = (_s = host.read(`${appRoot}/src/environments/environment.ts`)) === null || _s === void 0 ? void 0 : _s.toString()) !== null && _t !== void 0 ? _t : '',
+                },
+            }, host, serviceRoot, { additionalRoots: { 'app': appRoot } }));
+        }
+        yield (0, devkit_1.formatFiles)(host);
+        return () => {
+            (0, devkit_1.installPackagesTask)(host);
+        };
+    });
+}
+//# sourceMappingURL=pevn.js.map

package/src/generators/pevn/pevn.js.map

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

package/src/generators/pevn/pevn.spec.ts

@@ -0,0 +1,47 @@
+import { readProjectConfiguration } from '@nx/devkit';
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+
+import * as utils from '@abgov/nx-oc';
+import { environments } from '@abgov/nx-oc';
+import { Schema } from './schema';
+import generator from './pevn';
+
+jest.mock('@nx/devkit', () => ({ ...jest.requireActual('@nx/devkit'), formatFiles: jest.fn().mockResolvedValue(undefined) }));
+jest.mock('@abgov/nx-oc');
+jest.mock('../../utils/agent', () => ({
+  consultAgent: jest.fn().mockResolvedValue(null),
+  confirmAfterAgentInterrupt: jest.fn().mockResolvedValue(undefined),
+}));
+const utilsMock = utils as jest.Mocked<typeof utils>;
+utilsMock.getAdspConfiguration.mockResolvedValue({
+  tenant: 'test',
+  tenantRealm: 'test',
+  accessServiceUrl: environments.test.accessServiceUrl,
+  directoryServiceUrl: environments.test.directoryServiceUrl,
+});
+utilsMock.realmLogin.mockResolvedValue('test-token');
+
+describe('PEVN Generator', () => {
+  const options: Schema = {
+    name: 'test',
+    env: 'dev',
+  };
+
+  it('can run', async () => {
+    const host = createTreeWithEmptyWorkspace({ layout: 'apps-libs' });
+    await generator(host, options);
+
+    const appConfig = readProjectConfiguration(host, 'test-app');
+    expect(appConfig.root).toBe('apps/test-app');
+
+    const serviceConfig = readProjectConfiguration(host, 'test-service');
+    expect(serviceConfig.root).toBe('apps/test-service');
+
+    expect(host.exists('apps/test-app/nginx.conf')).toBeTruthy();
+    const nginxConf = host.read('apps/test-app/nginx.conf').toString();
+    expect(nginxConf).toContain('http://test-service:3333/');
+
+    expect(host.exists('apps/test-app/src/App.vue')).toBeTruthy();
+    expect(host.exists('apps/test-service/prisma/schema.prisma')).toBeTruthy();
+  }, 30000);
+});

package/src/generators/pevn/schema.d.ts

@@ -0,0 +1,14 @@
+import { AdspConfiguration, EnvironmentName } from '@abgov/nx-oc';
+
+export interface Schema {
+  name: string;
+  env: EnvironmentName;
+  accessToken?: string;
+  tenant?: string;
+  tenantRealm?: string;
+  skipAgent?: boolean;
+}
+
+export interface NormalizedSchema extends Schema {
+  adsp: AdspConfiguration;
+}

package/src/generators/pevn/schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "id": "NxAdspPevn",
+  "title": "PEVN Stack ADSP Solution",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Name of the PEVN stack solution.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use?"
+    },
+    "env": {
+      "type": "string",
+      "description": "Environment to target.",
+      "$default": {
+        "$source": "argv",
+        "index": 1
+      },
+      "alias": "e",
+      "x-prompt": {
+        "message": "Which ADSP environment do you want to target?",
+        "type": "list",
+        "items": [
+          "dev",
+          "test",
+          "prod"
+        ]
+      }
+    },
+    "tenant": {
+      "type": "string",
+      "description": "ADSP tenant name. Enables a single browser login for the full stack — service and frontend agent interactions both use the same tenant-realm token.",
+      "alias": "t"
+    },
+    "tenantRealm": {
+      "type": "string",
+      "description": "Keycloak realm UUID. Optional when --tenant is provided — overrides the realm looked up from the tenant service.",
+      "alias": "tr"
+    },
+    "accessToken": {
+      "type": "string",
+      "description": "Access token for retrieving configuration from ADSP APIs.",
+      "alias": "at"
+    },
+    "skipAgent": {
+      "type": "boolean",
+      "description": "Skip the consultAgent interaction and generate base scaffolding only.",
+      "default": false
+    }
+  },
+  "required": [
+    "name",
+    "env"
+  ],
+  "additionalProperties": false
+}

package/src/generators/vue-app/files/AGENTS.md__tmpl__

@@ -0,0 +1,97 @@
+# AGENTS.md — <%= projectName %>
+
+Vue 3 frontend for the Alberta Digital Service Platform (ADSP).
+Generated by `nx g @abgov/nx-adsp:vue-app`.
+
+## Stack
+
+- **UI**: Vue 3 (Composition API) + GoA design system (`@abgov/web-components` — `goa-*` custom elements)
+- **Auth**: `@dsb-norge/vue-keycloak-js` (wraps `keycloak-js`)
+- **State**: Pinia
+- **Router**: Vue Router v4
+
+## Key files
+
+| File | Purpose |
+|------|---------|
+| `src/main.ts` | Entry — registers Pinia, Router, and Keycloak plugin |
+| `src/App.vue` | Shell — nav header with sign-in/out, hero banner, `<RouterView>` |
+| `src/router/index.ts` | Routes — `/protected` guarded with `requiresAuth` meta |
+| `src/views/HomeView.vue` | Public page — calls public and private APIs |
+| `src/views/ProtectedView.vue` | Authenticated page — shows user info from token |
+| `src/environments/environment.ts` | Access URL, realm, client ID — pre-set from ADSP tenant |
+| `vite.config.ts` | Vite config — `isCustomElement` marks `goa-*` as web components |
+
+## Auth pattern
+
+```typescript
+import { useKeycloak } from '@dsb-norge/vue-keycloak-js';
+
+// useKeycloak() returns a DeepReadonly<VueKeycloakInstance>
+const { authenticated, fullName, ready, token, tokenParsed, keycloak } = useKeycloak();
+
+authenticated       // Ref<boolean> — true after sign-in
+fullName            // Ref<string | undefined> — display name from token
+ready               // Ref<boolean> — true once Keycloak init has settled
+token               // Ref<string | undefined> — current access token
+
+// Call Keycloak actions via the underlying keycloak-js instance:
+keycloak?.login()
+keycloak?.logout({ redirectUri: window.location.origin })
+
+// Refresh token before an authenticated API call:
+await keycloak?.updateToken(30);
+const bearer = keycloak?.token;
+```
+
+Route guard (in `router/index.ts`):
+
+```typescript
+router.beforeEach((to) => {
+  if (to.meta.requiresAuth) {
+    const { authenticated, ready, keycloak } = useKeycloak();
+    if (!ready) return true;    // let Keycloak init settle first
+    if (!authenticated) {
+      keycloak?.login({ redirectUri: window.location.origin + to.fullPath });
+      return false;
+    }
+  }
+  return true;
+});
+```
+
+## GoA design system
+
+Use `goa-*` web components directly in Vue templates. The vite.config.ts
+`isCustomElement` option prevents Vue from warning about unknown elements.
+
+**Event names**: GoA web component interactive elements (buttons, inputs, etc.)
+emit a `_click` custom event (not `click`) to avoid conflicts with native browser
+events. Use `@_click` in Vue templates:
+
+```html
+<goa-button type="primary" @_click="handleSave">Save</goa-button>
+<goa-input @_change="handleChange" />
+```
+
+See [GoA web components docs](https://ui-components.alberta.ca) for the full
+component and event reference.
+
+## Backend API calls (proxy setup)
+
+Use relative `/api/` paths — they route through Vite's dev proxy and nginx in production:
+
+```typescript
+// ✓ correct
+const res = await fetch('/api/v1/my-resource');
+
+// ✗ wrong — bypasses proxy, won't work in production
+const res = await fetch('http://localhost:3333/my-service/v1/my-resource');
+```
+
+## What NOT to change
+
+- `src/main.ts` — Keycloak plugin is registered once here; do not call `new Keycloak()` elsewhere
+- `environments/environment.ts` — access URL and realm are pre-configured for the ADSP tenant
+- `silent-check-sso.html` — required for keycloak-js silent SSO; must be served from the app root
+- `vite.config.ts` — the `isCustomElement` predicate must stay to suppress Vue warnings for `goa-*` elements

package/src/generators/vue-app/files/nginx.conf__tmpl__

@@ -0,0 +1,45 @@
+events {
+  worker_connections 1024;
+}
+
+http {
+  sendfile on;
+  include mime.types;
+  default_type application/octet-stream;
+
+  gzip on;
+  gzip_types text/plain text/css application/javascript application/json image/svg+xml font/woff2;
+  gzip_min_length 1000;
+
+  server {
+    listen 8080;
+    root /opt/app-root/src;
+    index index.html;
+
+    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
+      expires 30d;
+      add_header Cache-Control "public, no-transform";
+    }
+
+    location = /silent-check-sso.html {
+      add_header Cache-Control "no-store";
+    }
+
+    location / {
+      try_files $uri /index.html;
+    }
+<% nginxProxies.forEach(function(nginxProxy){ %>
+    location <%= nginxProxy.location %> {
+      proxy_pass <%= nginxProxy.proxyPass %>;
+      proxy_set_header Host $host;
+      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+      proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto;
+    }
+<% }); %>
+  }
+}