@equinor/fusion-framework-cli 12.2.0 → 12.3.1

package/dist/esm/lib/index.js

@@ -1,6 +1,6 @@
 export { resolvePackage } from './utils/resolve-package.js';
 export { resolveEntryPoint } from './utils/resolve-source-entry-point.js';
-export { loadDevServerConfig } from './load-dev-server-config.js';
+export { loadDevServerConfig, defineDevServerConfig, } from './load-dev-server-config.js';
 // Legacy imports - these will be removed in the next major version
 // @todo - remove these imports, introduced in v11
 export { defineAppConfig, defineAppManifest } from './legacy.js';

package/dist/esm/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAwB,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,mEAAmE;AACnE,kDAAkD;AAClD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAwB,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GAGtB,MAAM,6BAA6B,CAAC;AAErC,mEAAmE;AACnE,kDAAkD;AAClD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/lib/utils/resolve-annotations.js

@@ -1,5 +1,6 @@
 import { resolveGithubAnnotations } from './resolve-github-annotations.js';
 import { resolveDevopsAnnotations } from './resolve-devops-annotations.js';
+import { version } from '../../version.js';
 /**
  * Resolves CI/CD environment-specific annotation variables.
  *
@@ -11,11 +12,18 @@ import { resolveDevopsAnnotations } from './resolve-devops-annotations.js';
  * If no known environment is detected, returns an empty object.
  */
 export const resolveAnnotations = () => {
+    // Required annotations for manifest
+    const requiredAnnotations = {
+        cliVersion: version,
+        source: 'local',
+        reason: 'manual',
+    };
     // Check if running in GitHub Actions environment
     // If so, delegate to the GitHub-specific annotation resolver
     if (process.env.GITHUB_ACTIONS) {
         const annotation = resolveGithubAnnotations();
         const baseAnnotations = {
+            ...requiredAnnotations,
             source: 'github',
             reason: annotation.eventName,
             workflow: annotation.workflow,
@@ -53,6 +61,7 @@ export const resolveAnnotations = () => {
     if (process.env.SYSTEM_TEAMPROJECT) {
         const annotations = resolveDevopsAnnotations();
         return {
+            ...requiredAnnotations,
             source: 'azure_devops',
             reason: annotations.reason,
             repository: annotations.repository,
@@ -65,7 +74,7 @@ export const resolveAnnotations = () => {
         };
     }
     // Fallback: No known CI/CD environment detected
-    // Return an empty object to indicate no annotations are available
-    return undefined;
+    // Return required annotations indicating local build
+    return requiredAnnotations;
 };
 //# sourceMappingURL=resolve-annotations.js.map

package/dist/esm/lib/utils/resolve-annotations.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-annotations.js","sourceRoot":"","sources":["../../../../src/lib/utils/resolve-annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAqC3E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAmC,EAAE;IACrE,iDAAiD;IACjD,6DAA6D;IAC7D,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,eAAe,GAAG;YACtB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,UAAU,CAAC,SAAS;YAC5B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE,EAAE;YACpC,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI;YACvC,mBAAmB,EAAE,UAAU,CAAC,UAAU,EAAE,QAAQ;YACpD,kBAAkB,EAAE,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI;YACxD,gBAAgB,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK;YACrD,2BAA2B,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU;YACrE,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,YAAY,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK;YACtC,iBAAiB,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU;SACpB,CAAC;QAE/B,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;YAC5B,OAAO;gBACL,GAAG,eAAe;gBAClB,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG;gBACzC,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG;gBAC3C,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC,QAAQ;aACb,CAAC;QACjC,CAAC;QAED,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO;gBACL,GAAG,eAAe;gBAClB,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,QAAQ;gBAChC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,QAAQ;aACR,CAAC;QACjC,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,+CAA+C;IAC/C,mEAAmE;IACnE,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAC;QAC/C,OAAO;YACL,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,UAAU,EAAE,WAAW,CAAC,UAAU;YAClC,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,QAAQ,EAAE,WAAW,CAAC,YAAY;SACN,CAAC;IACjC,CAAC;IACD,gDAAgD;IAChD,kEAAkE;IAClE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}
+{"version":3,"file":"resolve-annotations.js","sourceRoot":"","sources":["../../../../src/lib/utils/resolve-annotations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAuC3C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAuB,EAAE;IACzD,oCAAoC;IACpC,MAAM,mBAAmB,GAAG;QAC1B,UAAU,EAAE,OAAO;QACnB,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,QAAQ;KACjB,CAAC;IAEF,iDAAiD;IACjD,6DAA6D;IAC7D,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,eAAe,GAAG;YACtB,GAAG,mBAAmB;YACtB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,UAAU,CAAC,SAAS;YAC5B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,QAAQ,EAAE,UAAU,CAAC,WAAW,EAAE,EAAE;YACpC,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI;YACvC,mBAAmB,EAAE,UAAU,CAAC,UAAU,EAAE,QAAQ;YACpD,kBAAkB,EAAE,UAAU,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI;YACxD,gBAAgB,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK;YACrD,2BAA2B,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU;YACrE,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,YAAY,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK;YACtC,iBAAiB,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU;SACpB,CAAC;QAE/B,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;YAC5B,OAAO;gBACL,GAAG,eAAe;gBAClB,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG;gBACzC,QAAQ,EAAE,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG;gBAC3C,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC,QAAQ;aACb,CAAC;QACjC,CAAC;QAED,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO;gBACL,GAAG,eAAe;gBAClB,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,QAAQ;gBAChC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,QAAQ;aACR,CAAC;QACjC,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,+CAA+C;IAC/C,mEAAmE;IACnE,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAC;QAC/C,OAAO;YACL,GAAG,mBAAmB;YACtB,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,UAAU,EAAE,WAAW,CAAC,UAAU;YAClC,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,QAAQ,EAAE,WAAW,CAAC,YAAY;SACN,CAAC;IACjC,CAAC;IAED,gDAAgD;IAChD,qDAAqD;IACrD,OAAO,mBAAmB,CAAC;AAC7B,CAAC,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '12.2.0';
+export const version = '12.3.1';
 //# sourceMappingURL=version.js.map

package/dist/types/bin/app-check.d.ts

@@ -1,5 +1,5 @@
 import { type FusionEnv, type FusionFrameworkSettings } from './framework.node.js';
-import type { ConsoleLogger } from './utils/index.js';
+import { type ConsoleLogger } from './utils/index.js';
 /**
  * Options for checking application registration in the app store.
  * @public

package/dist/types/bin/app-dev.d.ts

@@ -30,6 +30,10 @@ export interface StartAppDevServerOptions {
      * Port for the development server (optional, defaults to 3000).
      */
     port?: number;
+    /**
+     * Host for the development server (optional, defaults to 'localhost').
+     */
+    host?: string;
 }
 /**
  * Starts the application development server for local development.

package/dist/types/bin/app-upload.d.ts

@@ -1,6 +1,6 @@
 import AdmZip from 'adm-zip';
 import type { FusionFramework } from './framework.node.js';
-import type { ConsoleLogger } from './utils/index.js';
+import { type ConsoleLogger } from './utils/index.js';
 /**
  * Options for uploading an application bundle to the app service.
  *

package/dist/types/bin/utils/create-dev-server.d.ts

@@ -2,6 +2,7 @@ import type { AppManifest } from '@equinor/fusion-framework-module-app';
 import type { ApiAppConfig } from '@equinor/fusion-framework-module-app/schemas.js';
 import { type RuntimeEnv } from '@equinor/fusion-framework-cli/lib';
 import { type UserConfig, type DevServerOptions, type FusionTemplateEnv } from '@equinor/fusion-framework-dev-server';
+import type { ConsoleLogger } from './ConsoleLogger.js';
 /**
  * PortalManifest describes the minimal structure required for a portal manifest.
  * Used for dev server portal routing and config.
@@ -45,5 +46,8 @@ export type CreateDevServerOptions = {
  * @returns The complete dev server options object.
  */
 export declare const createDevServerConfig: (options: CreateDevServerOptions) => DevServerOptions;
-export declare const createDevServer: (env: RuntimeEnv, options: CreateDevServerOptions, overrides?: UserConfig) => Promise<import("vite").ViteDevServer>;
+export declare const createDevServer: (env: RuntimeEnv, options: CreateDevServerOptions, args?: {
+    overrides?: UserConfig;
+    log?: ConsoleLogger | null;
+}) => Promise<import("vite").ViteDevServer>;
 export {};

package/dist/types/bin/utils/defaultHeaders.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Default headers for Fusion Framework CLI requests.
+ * @type {Object}
+ * @property {string} 'X-Fusion-CLI-Name' - The name of the Fusion Framework CLI.
+ * @property {string} 'X-Fusion-CLI-Version' - The version of the Fusion Framework CLI.
+ * @property {string} 'User-Agent' - The user agent for the Fusion Framework CLI and its current version.
+ */
+export declare const defaultHeaders: {
+    'X-Fusion-CLI-Name': string;
+    'X-Fusion-CLI-Version': string;
+    'User-Agent': string;
+};
+export default defaultHeaders;

package/dist/types/bin/utils/index.d.ts

@@ -2,3 +2,4 @@ export { formatPath, formatByteSize, chalk } from './format.js';
 export { Spinner } from './spinner.js';
 export { ConsoleLogger } from './ConsoleLogger.js';
 export { createDevServerConfig, createDevServer, type CreateDevServerOptions, } from './create-dev-server.js';
+export { defaultHeaders } from './defaultHeaders.js';

package/dist/types/cli/commands/app/dev.d.ts

@@ -7,6 +7,7 @@
  * - Launches the development server for your application.
  * - Supports custom manifest/config files, runtime environment, and port selection.
  * - Debug mode available for verbose logging.
+ * - Automatic loading of dev-server.config.ts for API mocking and customization.
  *
  * Usage:
  *   $ ffc app dev [options]
@@ -17,13 +18,20 @@
  *   --config <path>      Path to the app config file (app.config[.env]?.[ts,js,json])
  *   --env <environment>  Runtime environment for the dev server (default: local)
  *   --port <port>        Port for the development server (default: 3000)
+ *   --host <host>        Host for the development server (default: localhost)
+ *
+ * Configuration:
+ *   dev-server.config.ts  Optional configuration file for API mocking, service discovery,
+ *                         and development environment customization
  *
  * Example:
  *   $ ffc app dev
  *   $ ffc app dev --port 4000
  *   $ ffc app dev --manifest ./app.manifest.local.ts --config ./app.config.ts
+ *   $ ffc app dev --host 0.0.0.0
  *
  * @see startAppDevServer for implementation details
+ * @see dev-server-config.md for configuration options
  */
 export declare const command: import("commander").Command;
 export default command;

package/dist/types/cli/commands/portal/dev.d.ts

@@ -7,6 +7,7 @@
  * - Launches the development server for your portal.
  * - Supports custom runtime environment and port selection.
  * - Debug mode available for verbose logging.
+ * - Automatic loading of dev-server.config.ts for API mocking and customization.
  *
  * Usage:
  *   $ ffc portal dev [options]
@@ -16,12 +17,17 @@
  *   --env <environment>  Runtime environment for the dev server (default: local)
  *   --port <port>        Port for the development server (default: 3000)
  *
+ * Configuration:
+ *   dev-server.config.ts  Optional configuration file for API mocking, service discovery,
+ *                         and development environment customization
+ *
  * Example:
  *   $ ffc portal dev
  *   $ ffc portal dev --port 4000
  *   $ ffc portal dev --debug
  *
  * @see startPortalDevServer for implementation details
+ * @see dev-server-config.md for configuration options
  */
 export declare const command: import("commander").Command;
 export default command;

package/dist/types/lib/index.d.ts

@@ -1,5 +1,5 @@
 export type { RuntimeEnv } from './types.js';
 export { resolvePackage, type ResolvedPackage } from './utils/resolve-package.js';
 export { resolveEntryPoint } from './utils/resolve-source-entry-point.js';
-export { loadDevServerConfig } from './load-dev-server-config.js';
+export { loadDevServerConfig, defineDevServerConfig, type DevServerConfigExport, type DevServerConfigFn, } from './load-dev-server-config.js';
 export { defineAppConfig, defineAppManifest } from './legacy.js';

package/dist/types/lib/utils/resolve-annotations.d.ts

@@ -1,6 +1,7 @@
 /**
  * Represents metadata annotations related to a release process.
  *
+ * @property cliVersion - The version of the CLI that triggered the release.
  * @property source - The origin or system that triggered the release.
  * @property reason - The reason or context for the release.
  * @property [repository] - The repository associated with the release, if applicable.
@@ -14,6 +15,7 @@
  * @property [tag] - The tag name associated with the release.
  */
 export type ReleaseAnnotations = {
+    cliVersion: string;
     source: string;
     reason: string;
     actor?: string;
@@ -42,4 +44,4 @@ export type ReleaseAnnotations = {
  * @returns {Record<string, string>} An object containing annotation variables for the detected environment.
  * If no known environment is detected, returns an empty object.
  */
-export declare const resolveAnnotations: () => ReleaseAnnotations | undefined;
+export declare const resolveAnnotations: () => ReleaseAnnotations;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "12.2.0";
+export declare const version = "12.3.1";

package/docs/application.md

@@ -107,7 +107,7 @@ pnpm fusion-framework-cli publish --env <environment>
 pnpm fusion-framework-cli app config --publish --env <environment>
 ```
 
-> **Tip:** For CI/CD and automation, set the `FUSION_TOKEN` environment variable. See [Authentication](./docs/auth.md) for details.
+> **Tip:** For CI/CD and automation, set the `FUSION_TOKEN` environment variable. See [Authentication](auth.md) for details.
 
 ---
 
@@ -131,7 +131,7 @@ pnpm fusion-framework-cli app config --publish --env <environment>
 - **Missing manifest/config:** Ensure `app.manifest.ts` and `app.config.ts` exist in your project root.
 - **Environment variables:** Use `.env` files or your CI/CD system to inject secrets and config values.
 - **Command help:** Run any command with `--help` for detailed usage and options.
-- **Still stuck?** See [Troubleshooting](#troubleshooting--faq) or [Authentication](./docs/auth.md).
+- **Still stuck?** See [Troubleshooting](#troubleshooting--faq) or [Authentication](auth.md).
 
 ---
 
@@ -295,6 +295,7 @@ export default defineAppConfig((env, args) => {
 
 The Fusion Framework CLI provides a suite of commands to support the full application lifecycle, from development to deployment. Below is an overview of all available commands with quick links to their detailed usage:
 
+- [Create](#create) — Create new Fusion applications from templates.
 - [Dev](#dev) — Start the development server with hot reloading.
 - [Publish](#publish) — Build, upload, and tag your app for deployment.
 - [Config](#config) — Generate or upload your app configuration.
@@ -304,10 +305,61 @@ The Fusion Framework CLI provides a suite of commands to support the full applic
 - [Tag](#tag) — Tag a published app version for release management.
 - [Manifest](#manifest) — Generate your app manifest file.
 - [Check](#check) — Verify your app's registration status.
+- [Disco](#disco) — Service discovery operations.
 - [Aliases](#aliases) — Deprecated commands and their replacements.
 
 Refer to each section below for detailed options, usage, and examples.
 
+### Create
+
+Create new Fusion applications from predefined templates. This command provides an interactive way to scaffold new projects with proper structure and configuration.
+
+```sh
+# Create a new app with interactive template selection
+pnpm fusion-framework-cli create app my-app
+
+# Create with a specific template
+pnpm fusion-framework-cli create app my-app --template react-app
+
+# Create in a specific directory
+pnpm fusion-framework-cli create app my-app --directory ./projects
+```
+
+**Options:**
+- `-t, --template <type>` - Template type to use (will prompt if not specified)
+- `-d, --directory <path>` - Directory to create the app in (default: current directory)
+
+For detailed information about creating applications, see [Creating Apps](creating-apps.md).
+
+### Disco
+
+Service discovery operations for resolving and inspecting Fusion services.
+
+#### Resolve
+
+Resolve and display information about a service registered in Fusion service discovery.
+
+```sh
+# Resolve a service in the current environment
+pnpm fusion-framework-cli disco resolve my-service
+
+# Resolve in a specific environment
+pnpm fusion-framework-cli disco resolve my-service --env prod
+
+# Silent mode for scripting
+pnpm fusion-framework-cli disco resolve my-service --silent
+```
+
+**Options:**
+- `--env <environment>` - Environment to use (prod, test, etc.)
+- `--silent` - Silent mode, outputs only JSON for scripting
+- Authentication options: `--token`, `--tenantId`, `--clientId`
+
+**Useful for:**
+- Finding service endpoints for API calls
+- Debugging service connectivity issues
+- Getting service metadata and configuration
+
 ### Dev
 
 Start your application in development mode with hot reloading and environment-specific configuration.
@@ -609,7 +661,7 @@ pnpm fusion-framework-cli app check --env prod --debug
 > - This change aligns with industry standards and prepares for future CLI enhancements.
 > - Deprecated commands will be removed in future versions—update your scripts and workflows now to avoid breaking changes.
 > 
-> For a full migration guide, see [Migration v10 to v11](./migration-v10-to-v11.md).
+> For a full migration guide, see [Migration v10 to v11](migration-v10-to-v11.md).
 
 The CLI will warn you and redirect to the new command when you use a deprecated alias, applying any necessary options automatically. See the table below for mappings:
 

package/docs/dev-server-config.md

@@ -259,7 +259,6 @@ export default defineDevServerConfig(() => ({
       // Override portal configuration
       portal: {
         id: 'my-custom-portal',
-        tag: 'development'
       },
 
       // Modify service discovery
@@ -294,6 +293,32 @@ export default defineDevServerConfig(() => ({
 - `3`: Error (shows only errors and critical messages)
 - `4`: Critical (shows only critical messages - least verbose)
 
+### Portal Proxy Configuration
+
+**When you need it**: You want to control how portal assets are loaded during development - either from the Fusion portal service or from locally installed portal packages.
+
+**How it works**:
+- **`proxy: true`**: Routes portal assets through the dev-server's `/portal-proxy` endpoint, which fetches content from the Fusion portal service
+- **`proxy: false`** (default): Loads portal assets directly from `node_modules` (typically `@equinor/fusion-dev-server` or another portal package installed locally)
+
+```typescript
+export default defineDevServerConfig(() => ({
+  spa: {
+    templateEnv: {
+      portal: {
+        id: 'fusion',
+        tag: 'latest',
+        proxy: true // Load portal from Fusion portal service via /portal-proxy
+      }
+    }
+  }
+}));
+```
+
+**Benefits**:
+- **`proxy: true`**: Access production portal templates or custom portal deployments via the Fusion portal service
+- **`proxy: false`**: Use locally installed portal packages for offline development or custom portal development
+
 ### CLI Logging
 
 **When you need it**: You want to control the verbosity of dev-server output in your terminal/console.

package/docs/dev-server.md

@@ -12,6 +12,8 @@ The Fusion Framework dev-server is your complete local development solution for
 
 🛠️ **Flexible Configuration** - Easy setup for both applications and portals with environment-specific overrides
 
+📝 **Configurable Development** - Optional `dev-server.config.ts` file for API mocking, service discovery customization, and environment variable overrides
+
 ## Quick Start
 
 ```bash
@@ -28,6 +30,8 @@ The dev-server automatically detects your project type, loads configuration file
 
 For detailed information about configuring the dev-server, see [Dev Server Configuration](dev-server-config.md).
 
+The dev-server automatically loads configuration from a `dev-server.config.ts` file in your project root, allowing you to customize API mocking, service discovery, and development environment settings without modifying your application code.
+
 ## Key Features
 
 - **Service Discovery Integration** - Automatically connects to Fusion service discovery and enables local API mocking

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-cli",
-  "version": "12.2.0",
+  "version": "12.3.1",
   "keywords": [
     "Fusion",
     "Fusion Framework",
@@ -106,10 +106,10 @@
     "vite": "^7.1.9",
     "vite-tsconfig-paths": "^5.1.4",
     "zod": "^4.1.8",
-    "@equinor/fusion-framework-dev-server": "1.1.4",
+    "@equinor/fusion-framework-dev-portal": "1.2.2",
+    "@equinor/fusion-framework-dev-server": "1.1.5",
     "@equinor/fusion-framework-module-msal-node": "1.0.7",
-    "@equinor/fusion-imports": "1.1.4",
-    "@equinor/fusion-framework-dev-portal": "1.2.0"
+    "@equinor/fusion-imports": "1.1.4"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.3",