2026-03-11 17:35:12 +01:00
27 changed files with 1097 additions and 546 deletions
--- a/frontend/Dockerfile
+++ b/frontend/Dockerfile
@@ -1,14 +1,13 @@
-# Stage 1: Build
-FROM node:20 as build
+FROM node:22-alpine

 WORKDIR /app
 COPY package*.json ./
-RUN npm install
+RUN npm ci --legacy-peer-deps
 COPY . .
-RUN npm run build --configuration=production
+RUN npm run build -- --configuration=production

-# Stage 2: Serve
-FROM nginx:alpine
-COPY --from=build /app/dist/frontend/browser /usr/share/nginx/html
-COPY nginx.conf /etc/nginx/conf.d/default.conf
+ENV NODE_ENV=production
+ENV PORT=80
 EXPOSE 80
+
+CMD ["node", "dist/frontend/server/server.mjs"]
--- a/frontend/Dockerfile.dev
+++ b/frontend/Dockerfile.dev
@@ -1,15 +1,15 @@
-# Stage 1: Build
-FROM node:20 as build
+FROM node:22-alpine

 WORKDIR /app
 COPY package*.json ./
-RUN npm install
+RUN npm ci --legacy-peer-deps
 COPY . .
+
 # Use development configuration to pick up environment.ts (localhost)
 RUN npm run build -- --configuration=development

-# Stage 2: Serve
-FROM nginx:alpine
-COPY --from=build /app/dist/frontend/browser /usr/share/nginx/html
-COPY nginx.conf /etc/nginx/conf.d/default.conf
+ENV NODE_ENV=development
+ENV PORT=80
 EXPOSE 80
+
+CMD ["node", "dist/frontend/server/server.mjs"]
--- a/frontend/angular.json
+++ b/frontend/angular.json
@@ -36,7 +36,12 @@
              "@angular/material/prebuilt-themes/azure-blue.css",
              "src/styles.scss"
            ],
-            "scripts": []
+            "scripts": [],
+            "server": "src/main.server.ts",
+            "prerender": false,
+            "ssr": {
+              "entry": "src/server.ts"
+            }
          },
          "configurations": {
            "production": {
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -6,35 +6,41 @@
    "start": "ng serve",
    "build": "ng build",
    "watch": "ng build --watch --configuration development",
-    "test": "ng test"
+    "test": "ng test",
+    "serve:ssr:frontend": "node dist/frontend/server/server.mjs"
  },
  "private": true,
  "engines": {
    "node": "^22.0.0"
  },
  "dependencies": {
-    "@angular/cdk": "^19.2.19",
-    "@angular/common": "^19.2.18",
-    "@angular/compiler": "^19.2.18",
-    "@angular/core": "^19.2.18",
-    "@angular/forms": "^19.2.18",
-    "@angular/material": "^19.2.19",
-    "@angular/platform-browser": "^19.2.18",
-    "@angular/platform-browser-dynamic": "^19.2.18",
-    "@angular/router": "^19.2.18",
+    "@angular/cdk": "19.2.19",
+    "@angular/common": "19.2.19",
+    "@angular/compiler": "19.2.19",
+    "@angular/core": "19.2.19",
+    "@angular/forms": "19.2.19",
+    "@angular/material": "19.2.19",
+    "@angular/platform-browser": "19.2.19",
+    "@angular/platform-browser-dynamic": "19.2.19",
+    "@angular/platform-server": "19.2.19",
+    "@angular/router": "19.2.19",
+    "@angular/ssr": "19.2.19",
    "@ngx-translate/core": "^17.0.0",
    "@ngx-translate/http-loader": "^17.0.0",
    "@types/three": "^0.182.0",
+    "express": "^4.18.2",
    "rxjs": "~7.8.0",
    "three": "^0.182.0",
    "tslib": "^2.3.0",
    "zone.js": "~0.15.0"
  },
  "devDependencies": {
-    "@angular-devkit/build-angular": "^19.2.19",
-    "@angular/cli": "^19.2.19",
-    "@angular/compiler-cli": "^19.2.18",
+    "@angular-devkit/build-angular": "19.2.19",
+    "@angular/cli": "19.2.19",
+    "@angular/compiler-cli": "19.2.19",
+    "@types/express": "^4.17.17",
    "@types/jasmine": "~5.1.0",
+    "@types/node": "^18.18.0",
    "jasmine-core": "~5.6.0",
    "karma": "~6.4.0",
    "karma-chrome-launcher": "~3.2.0",
--- a/frontend/src/app/app.config.server.ts
+++ b/frontend/src/app/app.config.server.ts
@@ -0,0 +1,9 @@
+import { mergeApplicationConfig, ApplicationConfig } from '@angular/core';
+import { provideServerRendering } from '@angular/platform-server';
+import { appConfig } from './app.config';
+
+const serverConfig: ApplicationConfig = {
+  providers: [provideServerRendering()],
+};
+
+export const config = mergeApplicationConfig(appConfig, serverConfig);
--- a/frontend/src/app/app.config.ts
+++ b/frontend/src/app/app.config.ts
@@ -1,22 +1,48 @@
 import {
  ApplicationConfig,
+  provideAppInitializer,
  provideZoneChangeDetection,
  importProvidersFrom,
+  inject,
+  REQUEST,
 } from '@angular/core';
 import {
  provideRouter,
  withComponentInputBinding,
  withInMemoryScrolling,
  withViewTransitions,
+  Router,
 } from '@angular/router';
 import { routes } from './app.routes';
 import { provideHttpClient, withInterceptors } from '@angular/common/http';
-import { TranslateModule, TranslateLoader } from '@ngx-translate/core';
 import {
-  provideTranslateHttpLoader,
-  TranslateHttpLoader,
-} from '@ngx-translate/http-loader';
+  TranslateLoader,
+  TranslateModule,
+  TranslateService,
+} from '@ngx-translate/core';
 import { adminAuthInterceptor } from './core/interceptors/admin-auth.interceptor';
+import {
+  provideClientHydration,
+  withEventReplay,
+} from '@angular/platform-browser';
+import { serverOriginInterceptor } from './core/interceptors/server-origin.interceptor';
+import { catchError, firstValueFrom, of } from 'rxjs';
+import { StaticTranslateLoader } from './core/i18n/static-translate.loader';
+
+type SupportedLang = 'it' | 'en' | 'de' | 'fr';
+const SUPPORTED_LANGS: readonly SupportedLang[] = ['it', 'en', 'de', 'fr'];
+
+function resolveLangFromUrl(url: string): SupportedLang {
+  const firstSegment = (url || '/')
+    .split('?')[0]
+    .split('#')[0]
+    .split('/')
+    .filter(Boolean)[0]
+    ?.toLowerCase();
+  return SUPPORTED_LANGS.includes(firstSegment as SupportedLang)
+    ? (firstSegment as SupportedLang)
+    : 'it';
+}

 export const appConfig: ApplicationConfig = {
  providers: [
@@ -29,19 +55,44 @@ export const appConfig: ApplicationConfig = {
        scrollPositionRestoration: 'top',
      }),
    ),
-    provideHttpClient(withInterceptors([adminAuthInterceptor])),
-    provideTranslateHttpLoader({
-      prefix: './assets/i18n/',
-      suffix: '.json',
-    }),
+    provideHttpClient(
+      withInterceptors([serverOriginInterceptor, adminAuthInterceptor]),
+    ),
    importProvidersFrom(
      TranslateModule.forRoot({
        defaultLanguage: 'it',
        loader: {
          provide: TranslateLoader,
-          useClass: TranslateHttpLoader,
+          useClass: StaticTranslateLoader,
        },
      }),
    ),
+    provideAppInitializer(() => {
+      const translate = inject(TranslateService);
+      const router = inject(Router);
+      const request = inject(REQUEST, { optional: true }) as {
+        url?: string;
+      } | null;
+
+      translate.addLangs([...SUPPORTED_LANGS]);
+      translate.setDefaultLang('it');
+      const requestedUrl =
+        (typeof request?.url === 'string' && request.url) || router.url || '/';
+      const lang = resolveLangFromUrl(requestedUrl);
+
+      return firstValueFrom(
+        translate.use(lang).pipe(
+          catchError((error) => {
+            console.error('[i18n] Failed to preload language for SSR', {
+              lang,
+              requestedUrl,
+              error,
+            });
+            return of({});
+          }),
+        ),
+      ).then(() => undefined);
+    }),
+    provideClientHydration(withEventReplay()),
  ],
 };
--- a/frontend/src/app/core/i18n/static-translate.loader.ts
+++ b/frontend/src/app/core/i18n/static-translate.loader.ts
@@ -0,0 +1,22 @@
+import { Injectable } from '@angular/core';
+import { TranslateLoader, TranslationObject } from '@ngx-translate/core';
+import { Observable, of } from 'rxjs';
+import de from '../../../assets/i18n/de.json';
+import en from '../../../assets/i18n/en.json';
+import fr from '../../../assets/i18n/fr.json';
+import it from '../../../assets/i18n/it.json';
+
+const TRANSLATIONS: Record<string, TranslationObject> = {
+  it: it as TranslationObject,
+  en: en as TranslationObject,
+  de: de as TranslationObject,
+  fr: fr as TranslationObject,
+};
+
+@Injectable()
+export class StaticTranslateLoader implements TranslateLoader {
+  getTranslation(lang: string): Observable<TranslationObject> {
+    const normalized = String(lang || 'it').toLowerCase();
+    return of(TRANSLATIONS[normalized] ?? TRANSLATIONS['it']);
+  }
+}
--- a/frontend/src/app/core/interceptors/server-origin.interceptor.ts
+++ b/frontend/src/app/core/interceptors/server-origin.interceptor.ts
@@ -0,0 +1,63 @@
+import { HttpInterceptorFn } from '@angular/common/http';
+import { inject, REQUEST } from '@angular/core';
+
+type RequestLike = {
+  protocol?: string;
+  get?: (name: string) => string | undefined;
+  headers?: Record<string, string | string[] | undefined>;
+};
+
+function isAbsoluteUrl(url: string): boolean {
+  return /^[a-z][a-z\d+\-.]*:/i.test(url) || url.startsWith('//');
+}
+
+function firstHeaderValue(value: string | string[] | undefined): string | null {
+  if (Array.isArray(value)) {
+    return value[0] ?? null;
+  }
+  return typeof value === 'string' ? value : null;
+}
+
+function resolveOrigin(request: RequestLike | null): string | null {
+  if (!request) {
+    return null;
+  }
+
+  const host =
+    request.get?.('host') ??
+    firstHeaderValue(request.headers?.['host']) ??
+    firstHeaderValue(request.headers?.['x-forwarded-host']);
+  if (!host) {
+    return null;
+  }
+
+  const forwardedProtoRaw = firstHeaderValue(
+    request.headers?.['x-forwarded-proto'],
+  );
+  const forwardedProto = forwardedProtoRaw
+    ?.split(',')
+    .map((part) => part.trim().toLowerCase())
+    .find(Boolean);
+  const protocol = forwardedProto || request.protocol || 'http';
+  return `${protocol}://${host}`;
+}
+
+function normalizeRelativePath(url: string): string {
+  const withoutDot = url.replace(/^\.\//, '');
+  return withoutDot.startsWith('/') ? withoutDot : `/${withoutDot}`;
+}
+
+export const serverOriginInterceptor: HttpInterceptorFn = (req, next) => {
+  if (isAbsoluteUrl(req.url)) {
+    return next(req);
+  }
+
+  const request = inject(REQUEST, { optional: true }) as RequestLike | null;
+  const origin = resolveOrigin(request);
+  if (!origin) {
+    return next(req);
+  }
+
+  const absoluteUrl = `${origin}${normalizeRelativePath(req.url)}`;
+  return next(req.clone({ url: absoluteUrl }));
+};
--- a/frontend/src/app/features/admin/pages/admin-cad-invoices.component.ts
+++ b/frontend/src/app/features/admin/pages/admin-cad-invoices.component.ts
@@ -1,5 +1,5 @@
-import { CommonModule } from '@angular/common';
-import { Component, OnInit, inject } from '@angular/core';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
+import { Component, OnInit, PLATFORM_ID, inject } from '@angular/core';
 import { FormsModule } from '@angular/forms';
 import {
  AdminCadInvoice,
@@ -16,6 +16,7 @@ import { CopyOnClickDirective } from '../../../shared/directives/copy-on-click.d
  styleUrl: './admin-cad-invoices.component.scss',
 })
 export class AdminCadInvoicesComponent implements OnInit {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
  private readonly adminOperationsService = inject(AdminOperationsService);
  private readonly adminOrdersService = inject(AdminOrdersService);

@@ -112,11 +113,17 @@ export class AdminCadInvoicesComponent implements OnInit {
  }

  openCheckout(path: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
    const url = this.toCheckoutUrl(path);
    window.open(url, '_blank');
  }

  copyCheckout(path: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
    const url = this.toCheckoutUrl(path);
    navigator.clipboard?.writeText(url);
    this.successMessage = 'Link checkout CAD copiato negli appunti.';
@@ -126,6 +133,9 @@ export class AdminCadInvoicesComponent implements OnInit {
    if (!orderId) return;
    this.adminOrdersService.downloadOrderInvoice(orderId).subscribe({
      next: (blob) => {
+        if (!this.isBrowser) {
+          return;
+        }
        const url = window.URL.createObjectURL(blob);
        const a = document.createElement('a');
        a.href = url;
@@ -142,10 +152,16 @@ export class AdminCadInvoicesComponent implements OnInit {
  private toCheckoutUrl(path: string): string {
    const safePath = path.startsWith('/') ? path : `/${path}`;
    const lang = this.resolveLang();
+    if (!this.isBrowser) {
+      return `/${lang}${safePath}`;
+    }
    return `${window.location.origin}/${lang}${safePath}`;
  }

  private resolveLang(): string {
+    if (!this.isBrowser) {
+      return 'it';
+    }
    const firstSegment = window.location.pathname
      .split('/')
      .filter(Boolean)
--- a/frontend/src/app/features/admin/pages/admin-contact-requests.component.ts
+++ b/frontend/src/app/features/admin/pages/admin-contact-requests.component.ts
@@ -1,5 +1,5 @@
-import { CommonModule } from '@angular/common';
-import { Component, inject, OnInit } from '@angular/core';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
+import { Component, PLATFORM_ID, inject, OnInit } from '@angular/core';
 import { FormsModule } from '@angular/forms';
 import {
  AdminContactRequest,
@@ -17,6 +17,7 @@ import { CopyOnClickDirective } from '../../../shared/directives/copy-on-click.d
  styleUrl: './admin-contact-requests.component.scss',
 })
 export class AdminContactRequestsComponent implements OnInit {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
  private readonly adminOperationsService = inject(AdminOperationsService);

  readonly statusOptions = ['NEW', 'PENDING', 'IN_PROGRESS', 'DONE', 'CLOSED'];
@@ -171,6 +172,9 @@ export class AdminContactRequestsComponent implements OnInit {
  }

  private downloadBlob(blob: Blob, filename: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
--- a/frontend/src/app/features/admin/pages/admin-dashboard.component.ts
+++ b/frontend/src/app/features/admin/pages/admin-dashboard.component.ts
@@ -1,5 +1,5 @@
-import { CommonModule } from '@angular/common';
-import { Component, inject, OnInit } from '@angular/core';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
+import { Component, PLATFORM_ID, inject, OnInit } from '@angular/core';
 import { FormsModule } from '@angular/forms';
 import {
  AdminOrder,
@@ -16,6 +16,7 @@ import { CopyOnClickDirective } from '../../../shared/directives/copy-on-click.d
  styleUrl: './admin-dashboard.component.scss',
 })
 export class AdminDashboardComponent implements OnInit {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
  private readonly adminOrdersService = inject(AdminOrdersService);

  orders: AdminOrder[] = [];
@@ -498,6 +499,9 @@ export class AdminDashboardComponent implements OnInit {
  }

  private downloadBlob(blob: Blob, filename: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
--- a/frontend/src/app/features/admin/pages/admin-home-media.component.ts
+++ b/frontend/src/app/features/admin/pages/admin-home-media.component.ts
@@ -1,5 +1,11 @@
-import { CommonModule } from '@angular/common';
-import { Component, inject, OnDestroy, OnInit } from '@angular/core';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
+import {
+  Component,
+  PLATFORM_ID,
+  inject,
+  OnDestroy,
+  OnInit,
+} from '@angular/core';
 import { FormsModule } from '@angular/forms';
 import { of, switchMap } from 'rxjs';
 import {
@@ -85,6 +91,7 @@ const MEDIA_LANGUAGE_LABELS: Readonly<Record<AdminMediaLanguage, string>> = {
  styleUrl: './admin-home-media.component.scss',
 })
 export class AdminHomeMediaComponent implements OnInit, OnDestroy {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
  private readonly adminMediaService = inject(AdminMediaService);
  readonly mediaLanguages = SUPPORTED_MEDIA_LANGUAGES;
  readonly mediaLanguageLabels = MEDIA_LANGUAGE_LABELS;
@@ -243,7 +250,8 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {

    this.revokePreviewUrl(formState.previewUrl);
    formState.file = file;
-    formState.previewUrl = file ? URL.createObjectURL(file) : null;
+    formState.previewUrl =
+      file && this.isBrowser ? URL.createObjectURL(file) : null;

    if (file && this.areAllTitlesBlank(formState.translations)) {
      const nextTitle = this.deriveDefaultTitle(file.name);
@@ -583,6 +591,9 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {
  }

  private revokePreviewUrl(previewUrl: string | null): void {
+    if (!this.isBrowser) {
+      return;
+    }
    if (!previewUrl?.startsWith('blob:')) {
      return;
    }
--- a/frontend/src/app/features/admin/pages/admin-sessions.component.ts
+++ b/frontend/src/app/features/admin/pages/admin-sessions.component.ts
@@ -1,5 +1,5 @@
-import { CommonModule } from '@angular/common';
-import { Component, inject, OnInit } from '@angular/core';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
+import { Component, PLATFORM_ID, inject, OnInit } from '@angular/core';
 import {
  AdminOperationsService,
  AdminQuoteSession,
@@ -15,6 +15,7 @@ import { CopyOnClickDirective } from '../../../shared/directives/copy-on-click.d
  styleUrl: './admin-sessions.component.scss',
 })
 export class AdminSessionsComponent implements OnInit {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
  private readonly adminOperationsService = inject(AdminOperationsService);

  sessions: AdminQuoteSession[] = [];
@@ -51,7 +52,9 @@ export class AdminSessionsComponent implements OnInit {
      return;
    }

-    const confirmed = window.confirm(
+    const confirmed =
+      this.isBrowser &&
+      window.confirm(
        `Vuoi eliminare la sessione ${session.id}? Questa azione non si puo annullare.`,
      );
    if (!confirmed) {
--- a/frontend/src/app/features/admin/pages/admin-shop.component.html
+++ b/frontend/src/app/features/admin/pages/admin-shop.component.html
@@ -878,6 +878,7 @@
                    class="ui-form-control"
                    [(ngModel)]="material.materialCode"
                    [name]="'material-code-' + index"
+                    (ngModelChange)="onMaterialCodeChange(index, $event)"
                  >
                    <option [ngValue]="''" disabled>Seleziona materiale</option>
                    <option
@@ -915,6 +916,30 @@
                  />
                </label>

+                <label class="ui-form-field" *ngIf="material.isDefault">
+                  <span class="ui-form-caption">Colore default</span>
+                  <select
+                    class="ui-form-control"
+                    [(ngModel)]="material.defaultColorKey"
+                    [name]="'material-default-color-' + index"
+                    [disabled]="materialColorCount(material.materialCode) === 0"
+                  >
+                    <option [ngValue]="''" disabled>
+                      Seleziona colore default
+                    </option>
+                    <option
+                      *ngFor="
+                        let option of materialColorOptions(
+                          material.materialCode
+                        )
+                      "
+                      [ngValue]="option.key"
+                    >
+                      {{ option.label }}
+                    </option>
+                  </select>
+                </label>
+
                <div class="toggle-row toggle-row--compact">
                  <label class="ui-checkbox">
                    <input
--- a/frontend/src/app/features/admin/pages/admin-shop.component.ts
+++ b/frontend/src/app/features/admin/pages/admin-shop.component.ts
@@ -1,10 +1,11 @@
-import { CommonModule } from '@angular/common';
+import { CommonModule, DOCUMENT, isPlatformBrowser } from '@angular/common';
 import {
  Component,
  ElementRef,
  HostListener,
  OnDestroy,
  OnInit,
+  PLATFORM_ID,
  ViewChild,
  inject,
 } from '@angular/core';
@@ -53,6 +54,7 @@ interface CategoryFormState {

 interface ProductMaterialFormState {
  materialCode: string;
+  defaultColorKey: string;
  priceChf: string;
  isDefault: boolean;
  isActive: boolean;
@@ -138,6 +140,9 @@ const RICH_TEXT_ALLOWED_TAGS = new Set([
  styleUrl: './admin-shop.component.scss',
 })
 export class AdminShopComponent implements OnInit, OnDestroy {
+  private readonly platformId = inject(PLATFORM_ID);
+  private readonly isBrowser = isPlatformBrowser(this.platformId);
+  private readonly documentRef = inject(DOCUMENT);
  private readonly adminShopService = inject(AdminShopService);
  private readonly adminOperationsService = inject(AdminOperationsService);
  private descriptionEditorElement: HTMLDivElement | null = null;
@@ -200,12 +205,14 @@ export class AdminShopComponent implements OnInit, OnDestroy {

  ngOnDestroy(): void {
    this.revokeImagePreviewUrl(this.imageUploadState.previewUrl);
-    document.body.style.removeProperty('cursor');
+    if (this.isBrowser) {
+      this.documentRef.body?.style.removeProperty('cursor');
+    }
  }

  @HostListener('window:pointermove', ['$event'])
  onWindowPointerMove(event: PointerEvent): void {
-    if (!this.isResizingPanels) {
+    if (!this.isBrowser || !this.isResizingPanels) {
      return;
    }
    this.updateListPanelWidthFromPointer(event.clientX);
@@ -214,11 +221,13 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  @HostListener('window:pointerup')
  @HostListener('window:pointercancel')
  onWindowPointerUp(): void {
-    if (!this.isResizingPanels) {
+    if (!this.isBrowser || !this.isResizingPanels) {
      return;
    }
    this.isResizingPanels = false;
-    document.body.style.cursor = '';
+    if (this.documentRef.body) {
+      this.documentRef.body.style.cursor = '';
+    }
    this.persistListPanelWidth();
  }

@@ -368,7 +377,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
    }

    if (
-      !window.confirm(
+      !this.confirmBrowser(
        "Eliminare questo prodotto? L'azione non puo essere annullata.",
      )
    ) {
@@ -412,12 +421,14 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  }

  startPanelResize(event: PointerEvent): void {
-    if (window.innerWidth <= 1060) {
+    if (!this.isBrowser || window.innerWidth <= 1060) {
      return;
    }
    event.preventDefault();
    this.isResizingPanels = true;
-    document.body.style.cursor = 'col-resize';
+    if (this.documentRef.body) {
+      this.documentRef.body.style.cursor = 'col-resize';
+    }
    this.updateListPanelWidthFromPointer(event.clientX);
  }

@@ -507,7 +518,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
    }

    if (
-      !window.confirm(
+      !this.confirmBrowser(
        'Eliminare questa categoria? Fallira se contiene sottocategorie o prodotti.',
      )
    ) {
@@ -642,7 +653,14 @@ export class AdminShopComponent implements OnInit, OnDestroy {
      (_, currentIndex) => currentIndex !== index,
    );
    if (!nextMaterials.some((material) => material.isDefault)) {
-      nextMaterials[0].isDefault = true;
+      nextMaterials[0] = {
+        ...nextMaterials[0],
+        isDefault: true,
+        defaultColorKey: this.resolveMaterialDefaultColorKey(
+          nextMaterials[0].materialCode,
+          nextMaterials[0].defaultColorKey,
+        ),
+      };
    }
    this.productForm.materials = nextMaterials;
  }
@@ -652,10 +670,34 @@ export class AdminShopComponent implements OnInit, OnDestroy {
      (material, currentIndex) => ({
        ...material,
        isDefault: currentIndex === index,
+        defaultColorKey: this.resolveMaterialDefaultColorKey(
+          material.materialCode,
+          material.defaultColorKey,
+        ),
      }),
    );
  }

+  onMaterialCodeChange(index: number, nextMaterialCode: string): void {
+    const normalizedMaterialCode = nextMaterialCode.trim().toUpperCase();
+    this.productForm.materials = this.productForm.materials.map(
+      (material, currentIndex) => {
+        if (currentIndex !== index) {
+          return material;
+        }
+
+        return {
+          ...material,
+          materialCode: normalizedMaterialCode,
+          defaultColorKey: this.resolveMaterialDefaultColorKey(
+            normalizedMaterialCode,
+            material.defaultColorKey,
+          ),
+        };
+      },
+    );
+  }
+
  availableMaterialChoices(currentMaterialCode: string): string[] {
    const normalizedCurrentMaterialCode = currentMaterialCode
      .trim()
@@ -693,6 +735,22 @@ export class AdminShopComponent implements OnInit, OnDestroy {
      .slice(0, 6);
  }

+  materialColorOptions(
+    materialCode: string,
+  ): Array<{ key: string; label: string }> {
+    const normalizedMaterialCode = materialCode.trim().toUpperCase();
+    return this.stockVariantsForMaterial(normalizedMaterialCode).map(
+      (variant) => ({
+        key: this.variantKey(
+          normalizedMaterialCode,
+          variant.colorName,
+          variant.colorHex,
+        ),
+        label: this.stockVariantLabel(variant),
+      }),
+    );
+  }
+
  onModelFileSelected(event: Event): void {
    const input = event.target as HTMLInputElement | null;
    const file = input?.files?.[0] ?? null;
@@ -760,7 +818,9 @@ export class AdminShopComponent implements OnInit, OnDestroy {
    }

    if (
-      !window.confirm('Rimuovere il modello 3D associato a questo prodotto?')
+      !this.confirmBrowser(
+        'Rimuovere il modello 3D associato a questo prodotto?',
+      )
    ) {
      return;
    }
@@ -832,7 +892,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
    this.imageUploadState = {
      ...this.imageUploadState,
      file,
-      previewUrl: URL.createObjectURL(file),
+      previewUrl: this.isBrowser ? URL.createObjectURL(file) : null,
      translations: nextTranslations,
    };
  }
@@ -1008,7 +1068,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
      return;
    }

-    if (!window.confirm('Rimuovere questa immagine dal prodotto?')) {
+    if (!this.confirmBrowser('Rimuovere questa immagine dal prodotto?')) {
      return;
    }

@@ -1120,6 +1180,9 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  }

  private restoreListPanelWidth(): void {
+    if (!this.isBrowser) {
+      return;
+    }
    const storedValue = window.localStorage.getItem(
      SHOP_LIST_PANEL_WIDTH_STORAGE_KEY,
    );
@@ -1134,6 +1197,9 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  }

  private persistListPanelWidth(): void {
+    if (!this.isBrowser) {
+      return;
+    }
    window.localStorage.setItem(
      SHOP_LIST_PANEL_WIDTH_STORAGE_KEY,
      String(this.listPanelWidthPercent),
@@ -1282,6 +1348,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  ): ProductMaterialFormState {
    return {
      materialCode,
+      defaultColorKey: this.resolveMaterialDefaultColorKey(materialCode),
      priceChf: '0.00',
      isDefault,
      isActive: true,
@@ -1361,8 +1428,21 @@ export class AdminShopComponent implements OnInit, OnDestroy {
          (left, right) => (left.sortOrder ?? 0) - (right.sortOrder ?? 0),
        );
        const firstVariant = sortedVariants[0];
+        const defaultVariantForMaterial =
+          materialVariants.find((variant) => variant.isDefault) ?? null;
+        const persistedDefaultColorKey = defaultVariantForMaterial
+          ? this.variantKey(
+              materialCode,
+              defaultVariantForMaterial.colorName,
+              defaultVariantForMaterial.colorHex,
+            )
+          : null;
        return {
          materialCode,
+          defaultColorKey: this.resolveMaterialDefaultColorKey(
+            materialCode,
+            persistedDefaultColorKey,
+          ),
          priceChf: Number(firstVariant?.priceChf ?? 0).toFixed(2),
          isDefault: materialVariants.some((variant) => variant.isDefault),
          isActive: materialVariants.some((variant) => variant.isActive),
@@ -1494,9 +1574,6 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  }

  private buildVariantsFromMaterials(): AdminUpsertShopProductVariantPayload[] {
-    const persistedDefaultVariant = this.selectedProduct?.variants.find(
-      (variant) => variant.isDefault,
-    );
    const existingVariantsByKey = new Map(
      (this.selectedProduct?.variants ?? []).map((variant) => [
        this.variantKey(
@@ -1507,14 +1584,6 @@ export class AdminShopComponent implements OnInit, OnDestroy {
        variant,
      ]),
    );
-    const persistedDefaultKey = persistedDefaultVariant
-      ? this.variantKey(
-          persistedDefaultVariant.internalMaterialCode,
-          persistedDefaultVariant.colorName,
-          persistedDefaultVariant.colorHex,
-        )
-      : null;
-
    const variants: AdminUpsertShopProductVariantPayload[] = [];
    let defaultAssigned = false;

@@ -1525,20 +1594,10 @@ export class AdminShopComponent implements OnInit, OnDestroy {
    for (const material of sortedMaterials) {
      const materialCode = material.materialCode.trim().toUpperCase();
      const stockVariants = this.stockVariantsForMaterial(materialCode);
-      let defaultVariantKeyForMaterial: string | null = null;
-
-      if (material.isDefault && persistedDefaultKey) {
-        defaultVariantKeyForMaterial =
-          stockVariants
-            .map((variant) =>
-              this.variantKey(
+      const selectedDefaultColorKey = this.resolveMaterialDefaultColorKey(
        materialCode,
-                variant.colorName,
-                variant.colorHex,
-              ),
-            )
-            .find((variantKey) => variantKey === persistedDefaultKey) ?? null;
-      }
+        material.defaultColorKey,
+      );

      stockVariants.forEach((stockVariant, colorIndex) => {
        const variantKey = this.variantKey(
@@ -1550,9 +1609,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
        const isDefault =
          material.isDefault &&
          !defaultAssigned &&
-          (defaultVariantKeyForMaterial
-            ? variantKey === defaultVariantKeyForMaterial
-            : colorIndex === 0);
+          variantKey === selectedDefaultColorKey;

        variants.push({
          id: existingVariant?.id,
@@ -1623,6 +1680,51 @@ export class AdminShopComponent implements OnInit, OnDestroy {
      });
  }

+  private resolveMaterialDefaultColorKey(
+    materialCode: string,
+    preferredKey?: string | null,
+  ): string {
+    const normalizedMaterialCode = materialCode.trim().toUpperCase();
+    const stockVariants = this.stockVariantsForMaterial(normalizedMaterialCode);
+    if (stockVariants.length === 0) {
+      return '';
+    }
+
+    const normalizedPreferredKey = (preferredKey ?? '').trim();
+    if (
+      normalizedPreferredKey &&
+      stockVariants.some(
+        (variant) =>
+          this.variantKey(
+            normalizedMaterialCode,
+            variant.colorName,
+            variant.colorHex,
+          ) === normalizedPreferredKey,
+      )
+    ) {
+      return normalizedPreferredKey;
+    }
+
+    const firstVariant = stockVariants[0];
+    return this.variantKey(
+      normalizedMaterialCode,
+      firstVariant.colorName,
+      firstVariant.colorHex,
+    );
+  }
+
+  private stockVariantLabel(variant: AdminFilamentVariant): string {
+    const colorName = variant.colorName.trim();
+    const variantDisplayName = variant.variantDisplayName.trim();
+    if (
+      variantDisplayName &&
+      variantDisplayName.toLowerCase() !== colorName.toLowerCase()
+    ) {
+      return `${colorName} (${variantDisplayName})`;
+    }
+    return colorName;
+  }
+
  private nextAvailableMaterialCode(): string | null {
    const selectedCodes = new Set(
      this.productForm.materials
@@ -1741,6 +1843,9 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  }

  private revokeImagePreviewUrl(previewUrl: string | null): void {
+    if (!this.isBrowser) {
+      return;
+    }
    if (previewUrl?.startsWith('blob:')) {
      URL.revokeObjectURL(previewUrl);
    }
@@ -1863,12 +1968,15 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  }

  private applyDescriptionExecCommand(command: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
    const editor = this.descriptionEditorElement;
    if (!editor) {
      return;
    }
    editor.focus();
-    document.execCommand(command, false);
+    this.documentRef.execCommand(command, false);
    this.syncDescriptionFromEditor(editor, false);
  }

@@ -1912,6 +2020,10 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  }

  private sanitizeRichTextHtml(value: string): string {
+    if (!this.isBrowser) {
+      return this.stripPotentiallyUnsafeHtml(value);
+    }
+
    const parser = new DOMParser();
    const sourceDocument = parser.parseFromString(
      `<body>${value}</body>`,
@@ -2017,12 +2129,18 @@ export class AdminShopComponent implements OnInit, OnDestroy {
  }

  private extractTextFromHtml(value: string): string {
+    if (!this.isBrowser) {
+      return value.replace(/<[^>]+>/g, ' ');
+    }
    const parser = new DOMParser();
    const parsed = parser.parseFromString(`<body>${value}</body>`, 'text/html');
    return parsed.body.textContent ?? '';
  }

  private serializeNodeChildren(node: Node): string {
+    if (!this.isBrowser) {
+      return node.textContent ?? '';
+    }
    const serializer = new XMLSerializer();
    let html = '';
    for (const child of Array.from(node.childNodes)) {
@@ -2035,6 +2153,10 @@ export class AdminShopComponent implements OnInit, OnDestroy {
    element: HTMLElement,
    html: string,
  ): void {
+    if (!this.isBrowser) {
+      return;
+    }
+
    if (!html) {
      element.replaceChildren();
      return;
@@ -2043,11 +2165,21 @@ export class AdminShopComponent implements OnInit, OnDestroy {
    const parser = new DOMParser();
    const parsed = parser.parseFromString(`<body>${html}</body>`, 'text/html');
    const nodes = Array.from(parsed.body.childNodes).map((child) =>
-      document.importNode(child, true),
+      this.documentRef.importNode(child, true),
    );
    element.replaceChildren(...nodes);
  }

+  private confirmBrowser(message: string): boolean {
+    return this.isBrowser ? window.confirm(message) : false;
+  }
+
+  private stripPotentiallyUnsafeHtml(value: string): string {
+    return value
+      .replace(/<script[\s\S]*?>[\s\S]*?<\/script>/gi, '')
+      .replace(/<style[\s\S]*?>[\s\S]*?<\/style>/gi, '');
+  }
+
  private escapeHtml(value: string): string {
    return value
      .replace(/&/g, '&amp;')
--- a/frontend/src/app/features/calculator/calculator-page.component.ts
+++ b/frontend/src/app/features/calculator/calculator-page.component.ts
@@ -4,9 +4,12 @@ import {
  signal,
  ViewChild,
  ElementRef,
+  Inject,
  OnInit,
+  Optional,
+  PLATFORM_ID,
 } from '@angular/core';
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
 import { TranslateModule } from '@ngx-translate/core';
 import { forkJoin, of } from 'rxjs';
 import { catchError, map } from 'rxjs/operators';
@@ -53,6 +56,7 @@ type TrackedPrintSettings = {
  styleUrl: './calculator-page.component.scss',
 })
 export class CalculatorPageComponent implements OnInit {
+  private readonly isBrowser: boolean;
  mode = signal<'easy' | 'advanced'>('easy');
  step = signal<'upload' | 'quote' | 'details' | 'success'>('upload');

@@ -85,7 +89,10 @@ export class CalculatorPageComponent implements OnInit {
    private router: Router,
    private route: ActivatedRoute,
    private languageService: LanguageService,
-  ) {}
+    @Optional() @Inject(PLATFORM_ID) platformId?: Object,
+  ) {
+    this.isBrowser = isPlatformBrowser(platformId ?? 'browser');
+  }

  ngOnInit() {
    this.route.data.subscribe((data) => {
@@ -260,7 +267,7 @@ export class CalculatorPageComponent implements OnInit {

    // Auto-scroll on mobile to make analysis visible
    setTimeout(() => {
-      if (this.resultCol && window.innerWidth < 768) {
+      if (this.isBrowser && this.resultCol && window.innerWidth < 768) {
        this.resultCol.nativeElement.scrollIntoView({
          behavior: 'smooth',
          block: 'start',
--- a/frontend/src/app/features/contact/components/contact-form/contact-form.component.ts
+++ b/frontend/src/app/features/contact/components/contact-form/contact-form.component.ts
@@ -1,5 +1,12 @@
-import { Component, signal, effect, inject, OnDestroy } from '@angular/core';
-import { CommonModule } from '@angular/common';
+import {
+  Component,
+  signal,
+  effect,
+  inject,
+  OnDestroy,
+  PLATFORM_ID,
+} from '@angular/core';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
 import {
  ReactiveFormsModule,
  FormBuilder,
@@ -16,6 +23,7 @@ import {
 import { QuoteEstimatorService } from '../../../calculator/services/quote-estimator.service';
 import { QuoteRequestService } from '../../../../core/services/quote-request.service';
 import { LanguageService } from '../../../../core/services/language.service';
+import { SuccessStateComponent } from '../../../../shared/components/success-state/success-state.component';

 interface FilePreview {
  file: File;
@@ -23,8 +31,6 @@ interface FilePreview {
  type: 'image' | 'video' | 'pdf' | '3d' | 'document' | 'other';
 }

-import { SuccessStateComponent } from '../../../../shared/components/success-state/success-state.component';
-
@Component({
  selector: 'app-contact-form',
  standalone: true,
@@ -41,6 +47,7 @@ import { SuccessStateComponent } from '../../../../shared/components/success-sta
  styleUrl: './contact-form.component.scss',
 })
 export class ContactFormComponent implements OnDestroy {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
  form: FormGroup;
  sent = signal(false);
  files = signal<FilePreview[]>([]);
@@ -127,7 +134,8 @@ export class ContactFormComponent implements OnDestroy {
        return {
          file: f,
          type,
-          url: this.shouldCreatePreview(type)
+          url:
+            this.isBrowser && this.shouldCreatePreview(type)
              ? URL.createObjectURL(f)
              : undefined,
        };
@@ -185,7 +193,8 @@ export class ContactFormComponent implements OnDestroy {
      const preview: FilePreview = {
        file,
        type,
-        url: this.shouldCreatePreview(type)
+        url:
+          this.isBrowser && this.shouldCreatePreview(type)
            ? URL.createObjectURL(file)
            : undefined,
      };
@@ -354,6 +363,9 @@ export class ContactFormComponent implements OnDestroy {
  }

  private revokePreviewUrl(file: FilePreview): void {
+    if (!this.isBrowser) {
+      return;
+    }
    if (file.url?.startsWith('blob:')) {
      URL.revokeObjectURL(file.url);
    }
--- a/frontend/src/app/features/order/order.component.ts
+++ b/frontend/src/app/features/order/order.component.ts
@@ -1,5 +1,5 @@
-import { Component, OnInit, inject, signal } from '@angular/core';
-import { CommonModule } from '@angular/common';
+import { Component, OnInit, PLATFORM_ID, inject, signal } from '@angular/core';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
 import { ActivatedRoute, Router } from '@angular/router';
 import { AppButtonComponent } from '../../shared/components/app-button/app-button.component';
 import { AppCardComponent } from '../../shared/components/app-card/app-card.component';
@@ -75,6 +75,7 @@ export class OrderComponent implements OnInit {
  private router = inject(Router);
  private quoteService = inject(QuoteEstimatorService);
  private translate = inject(TranslateService);
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));

  orderId: string | null = null;
  selectedPaymentMethod: 'twint' | 'bill' | null = 'twint';
@@ -115,6 +116,9 @@ export class OrderComponent implements OnInit {
  }

  downloadQrInvoice() {
+    if (!this.isBrowser) {
+      return;
+    }
    const orderId = this.orderId;
    if (!orderId) return;
    this.quoteService.getOrderConfirmation(orderId).subscribe({
@@ -153,7 +157,7 @@ export class OrderComponent implements OnInit {

  openTwintPayment(): void {
    const openUrl = this.twintOpenUrl();
-    if (typeof window !== 'undefined' && openUrl) {
+    if (this.isBrowser && openUrl) {
      window.open(openUrl, '_blank');
    }
  }
--- a/frontend/src/app/features/shop/product-detail.component.ts
+++ b/frontend/src/app/features/shop/product-detail.component.ts
@@ -1,8 +1,9 @@
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
 import {
  Component,
  DestroyRef,
  Injector,
+  PLATFORM_ID,
  computed,
  inject,
  input,
@@ -62,6 +63,7 @@ export class ProductDetailComponent {
  private readonly seoService = inject(SeoService);
  private readonly languageService = inject(LanguageService);
  private readonly shopRouteService = inject(ShopRouteService);
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
  readonly shopService = inject(ShopService);

  readonly categorySlug = input<string | undefined>();
@@ -444,7 +446,7 @@ export class ProductDetailComponent {

  goBackToShop(): void {
    const returnUrl =
-      typeof history.state?.shopReturnUrl === 'string'
+      this.isBrowser && typeof history.state?.shopReturnUrl === 'string'
        ? history.state.shopReturnUrl
        : null;

@@ -671,6 +673,15 @@ export class ProductDetailComponent {
    if (!this.containsHtmlMarkup(normalized)) {
      return normalized;
    }
+
+    if (!this.isBrowser) {
+      const text = normalized
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+      return text || null;
+    }
+
    const parser = new DOMParser();
    const parsed = parser.parseFromString(
      `<body>${normalized}</body>`,
@@ -694,6 +705,10 @@ export class ProductDetailComponent {
  }

  private syncPublicUrl(product: ShopProductDetail): void {
+    if (!this.isBrowser) {
+      return;
+    }
+
    const currentProductSlug = this.productSlug()?.trim().toLowerCase() ?? '';
    const targetProductSlug = this.shopRouteService.productPathSegment(product);
    if (currentProductSlug === targetProductSlug) {
--- a/frontend/src/app/shared/components/stl-viewer/stl-viewer.component.ts
+++ b/frontend/src/app/shared/components/stl-viewer/stl-viewer.component.ts
@@ -5,10 +5,12 @@ import {
  OnChanges,
  OnDestroy,
  OnInit,
+  PLATFORM_ID,
  ViewChild,
  SimpleChanges,
+  inject,
 } from '@angular/core';
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
 import { TranslateModule } from '@ngx-translate/core';
 import * as THREE from 'three';
 // @ts-ignore
@@ -24,6 +26,9 @@ import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
  styleUrl: './stl-viewer.component.scss',
 })
 export class StlViewerComponent implements OnInit, OnDestroy, OnChanges {
+  private readonly platformId = inject(PLATFORM_ID);
+  private readonly isBrowser = isPlatformBrowser(this.platformId);
+
  @Input() file: File | null = null;
  @Input() color: string = '#facf0a'; // Default Brand Color
  @Input() height = 300;
@@ -39,14 +44,22 @@ export class StlViewerComponent implements OnInit, OnDestroy, OnChanges {
  private animationId: number | null = null;
  private currentMesh: THREE.Mesh | null = null;
  private autoRotate = true;
+  private resizeObserver: ResizeObserver | null = null;

  loading = false;

  ngOnInit() {
+    if (!this.isBrowser) {
+      return;
+    }
    this.initThree();
  }

  ngOnChanges(changes: SimpleChanges) {
+    if (!this.isBrowser) {
+      return;
+    }
+
    if (changes['file'] && this.file) {
      this.loadFile(this.file);
    }
@@ -57,6 +70,9 @@ export class StlViewerComponent implements OnInit, OnDestroy, OnChanges {
  }

  ngOnDestroy() {
+    this.resizeObserver?.disconnect();
+    this.resizeObserver = null;
+
    if (this.animationId) cancelAnimationFrame(this.animationId);
    this.clearCurrentMesh();
    if (this.controls) this.controls.dispose();
@@ -121,7 +137,7 @@ export class StlViewerComponent implements OnInit, OnDestroy, OnChanges {
    this.animate();

    // Handle resize
-    const resizeObserver = new ResizeObserver(() => {
+    this.resizeObserver = new ResizeObserver(() => {
      if (!this.rendererContainer) return;
      const w = this.rendererContainer.nativeElement.clientWidth;
      const h = this.rendererContainer.nativeElement.clientHeight;
@@ -129,7 +145,7 @@ export class StlViewerComponent implements OnInit, OnDestroy, OnChanges {
      this.camera.updateProjectionMatrix();
      this.renderer.setSize(w, h);
    });
-    resizeObserver.observe(this.rendererContainer.nativeElement);
+    this.resizeObserver.observe(this.rendererContainer.nativeElement);
  }

  dimensions = { x: 0, y: 0, z: 0 };
--- a/frontend/src/app/shared/directives/copy-on-click.directive.ts
+++ b/frontend/src/app/shared/directives/copy-on-click.directive.ts
@@ -1,10 +1,20 @@
-import { Directive, HostBinding, HostListener, Input } from '@angular/core';
+import { isPlatformBrowser } from '@angular/common';
+import {
+  Directive,
+  HostBinding,
+  HostListener,
+  Input,
+  PLATFORM_ID,
+  inject,
+} from '@angular/core';

@Directive({
  selector: '[appCopyOnClick]',
  standalone: true,
 })
 export class CopyOnClickDirective {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
+
  @Input('appCopyOnClick') value: string | null | undefined;

  @HostBinding('style.cursor') readonly cursor = 'pointer';
@@ -21,6 +31,10 @@ export class CopyOnClickDirective {
  }

  private async copy(text: string): Promise<void> {
+    if (!this.isBrowser) {
+      return;
+    }
+
    if (navigator.clipboard?.writeText) {
      try {
        await navigator.clipboard.writeText(text);
--- a/frontend/src/index.html
+++ b/frontend/src/index.html
@@ -19,6 +19,7 @@
      href="https://fonts.googleapis.com/icon?family=Material+Icons"
      rel="stylesheet"
    />
+    <meta name="msvalidate.01" content="5AF60C1471E1800B39DF4DBC3C709035" />
  </head>
  <body>
    <app-root></app-root>
--- a/frontend/src/main.server.ts
+++ b/frontend/src/main.server.ts
@@ -0,0 +1,11 @@
+import {
+  BootstrapContext,
+  bootstrapApplication,
+} from '@angular/platform-browser';
+import { AppComponent } from './app/app.component';
+import { config } from './app/app.config.server';
+
+const bootstrap = (context: BootstrapContext) =>
+  bootstrapApplication(AppComponent, config, context);
+
+export default bootstrap;
--- a/frontend/src/server.ts
+++ b/frontend/src/server.ts
@@ -0,0 +1,67 @@
+import { APP_BASE_HREF } from '@angular/common';
+import { CommonEngine, isMainModule } from '@angular/ssr/node';
+import express from 'express';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import bootstrap from './main.server';
+
+const serverDistFolder = dirname(fileURLToPath(import.meta.url));
+const browserDistFolder = resolve(serverDistFolder, '../browser');
+const indexHtml = join(serverDistFolder, 'index.server.html');
+
+const app = express();
+const commonEngine = new CommonEngine();
+
+/**
+ * Example Express Rest API endpoints can be defined here.
+ * Uncomment and define endpoints as necessary.
+ *
+ * Example:
+ * ```ts
+ * app.get('/api/**', (req, res) => {
+ *   // Handle API request
+ * });
+ * ```
+ */
+
+/**
+ * Serve static files from /browser
+ */
+app.get(
+  '**',
+  express.static(browserDistFolder, {
+    maxAge: '1y',
+    index: false,
+  }),
+);
+
+/**
+ * Handle all other requests by rendering the Angular application.
+ */
+app.get('**', (req, res, next) => {
+  const { protocol, originalUrl, baseUrl, headers } = req;
+
+  commonEngine
+    .render({
+      bootstrap,
+      documentFilePath: indexHtml,
+      url: `${protocol}://${headers.host}${originalUrl}`,
+      publicPath: browserDistFolder,
+      providers: [{ provide: APP_BASE_HREF, useValue: baseUrl }],
+    })
+    .then((html) => res.send(html))
+    .catch((err) => next(err));
+});
+
+/**
+ * Start the server if this module is the main entry point.
+ * The server listens on the port defined by the `PORT` environment variable, or defaults to 4000.
+ */
+if (isMainModule(import.meta.url)) {
+  const port = process.env['PORT'] || 4000;
+  app.listen(port, () => {
+    console.log(`Node Express server listening on http://localhost:${port}`);
+  });
+}
+
+export default app;
--- a/frontend/tsconfig.app.json
+++ b/frontend/tsconfig.app.json
@@ -4,10 +4,14 @@
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "outDir": "./out-tsc/app",
-    "types": []
+    "types": [
+      "node"
+    ]
  },
  "files": [
-    "src/main.ts"
+    "src/main.ts",
+    "src/main.server.ts",
+    "src/server.ts"
  ],
  "include": [
    "src/**/*.d.ts"
--- a/frontend/tsconfig.json
+++ b/frontend/tsconfig.json
@@ -14,6 +14,7 @@
    "esModuleInterop": true,
    "experimentalDecorators": true,
    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
    "importHelpers": true,
    "target": "ES2022",
    "module": "ES2022"