docs: add mintel architecture manifesto

- Remove non-existent ChatWindow.scss import causing Webpack resolution errors
- Disable dynamic ChatWindowProvider injection (now statically declared in host app)
- Revert build script to tsc (no SCSS copy needed)

.agent/workflows/cms-workflow.md

@@ -0,0 +1,82 @@
+---
+description: How to manage and deploy Directus CMS infrastructure changes.
+---
+
+# Directus CMS Infrastructure Workflow
+
+This workflow ensures "Industrial Grade" consistency and stability across local, testing, and production environments for the `at-mintel` Directus CMS.
+
+## 1. Local Development Lifecycle
+
+### Starting the CMS
+To start the local Directus instance with extensions:
+```bash
+cd packages/cms-infra
+npm run up
+```
+
+### Modifying Schema
+1.  **Directus UI**: Make your changes directly in the local Directus Admin UI (Collections, Fields, Relations).
+2.  **Take Snapshot**:
+    ```bash
+    cd packages/cms-infra
+    npm run snapshot:local
+    ```
+    This updates `packages/cms-infra/schema/snapshot.yaml`.
+3.  **Commit**: Commit the updated `snapshot.yaml`.
+
+## 2. Deploying Schema Changes
+
+### To Local Environment (Reconciliation)
+If you pull changes from Git and need to apply them to your local database:
+```bash
+cd packages/cms-infra
+npm run schema:apply:local
+```
+> [!IMPORTANT]
+> This command automatically runs `scripts/cms-reconcile.sh` to prevent "Field already exists" errors by registering database columns in Directus metadata first.
+
+### To Production (Infra)
+To deploy the local snapshot to the production server:
+```bash
+cd packages/cms-infra
+npm run schema:apply:infra
+```
+This script:
+1.  Syncs built extensions via rsync.
+2.  Injects the `snapshot.yaml` into the remote container.
+3.  Runs `directus schema apply`.
+4.  Restarts Directus to clear the schema cache.
+
+## 3. Data Synchronization
+
+### Pulling from Production
+To update your local environment with production data and assets:
+```bash
+cd packages/cms-infra
+npm run sync:pull
+```
+
+### Pushing to Production
+> [!CAUTION]
+> This will overwrite production data. Use with extreme care.
+```bash
+cd packages/cms-infra
+npm run sync:push
+```
+
+## 4. Extension Management
+When modifying extensions in `packages/*-manager`:
+1.  Extensions are automatically built and synced when running `npm run up`.
+2.  To sync manually without restarting the stack:
+    ```bash
+    cd packages/cms-infra
+    npm run build:extensions
+    ```
+
+## 5. Troubleshooting "Field already exists"
+If `schema:apply` fails with "Field already exists", run:
+```bash
+./scripts/cms-reconcile.sh
+```
+This script ensures the database state matches Directus's internal field registry (`directus_fields`).

.changeset/next-config-server-actions.md

@@ -0,0 +1,5 @@
+---
+"@mintel/next-config": patch
+---
+
+fix: add serverActions.allowedOrigins to support branch deployments

.dockerignore

@@ -1,12 +1,26 @@
 node_modules
+**/node_modules
 .next
+**/.next
 .git
-.npmrc
+# .npmrc is allowed as it contains the registry template
 dist
+**/dist
 build
+**/build
 out
+**/out
 coverage
+**/coverage
 .vercel
+**/.vercel
 .turbo
+**/.turbo
 *.log
+**/*.log
 .DS_Store
+**/.DS_Store
+.pnpm-store
+**/.pnpm-store
+.gitea
+**/.gitea

.env

@@ -0,0 +1,61 @@
+# Project
+IMAGE_TAG=v1.8.19
+PROJECT_NAME=at-mintel
+PROJECT_COLOR=#82ed20
+GITEA_TOKEN=ccce002e30fe16a31a6c9d5a414740af2f72a582
+GITEA_HOST=https://git.infra.mintel.me
+OPENROUTER_API_KEY=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
+ZYTE_API_KEY=1f0f74726f044f55aaafc7ead32cd489
+REPLICATE_API_KEY=r8_W3grtpXMRfi0u3AM9VdkKbuWdZMmhwU2Tn0yt
+SERPER_API_KEY=02f69a8db9578c41fb1c8ed9f7a999302da644ff
+DATA_FOR_SEO_API_KEY=bWFyY0BtaW50ZWwubWU6MjQ0YjBjZmIzOGY3NTIzZA==
+DATA_FOR_SEO_LOGIN=marc@mintel.me
+DATA_FOR_SEO_PASSWORD=244b0cfb38f7523d
+
+# Kabelfachmann LLM Configuration
+KABELFACHMANN_LLM_PROVIDER=openrouter
+KABELFACHMANN_OLLAMA_MODEL=qwen3.5
+KABELFACHMANN_OLLAMA_HOST=http://host.docker.internal:11434
+
+# Authentication
+GATEKEEPER_PASSWORD=mintel
+AUTH_COOKIE_NAME=mintel_gatekeeper_session
+
+# Host Config (Local)
+TRAEFIK_HOST=at-mintel.localhost
+DIRECTUS_HOST=cms-legacy.localhost
+
+# Next.js
+NEXT_PUBLIC_BASE_URL=http://at-mintel.localhost
+
+# Directus
+DIRECTUS_URL=http://cms-legacy.localhost
+DIRECTUS_KEY=F9IIfahEjPq6NZhKyRLw516D8GotuFj79EGK7pGfIWg=
+DIRECTUS_SECRET=OZfxMu8lBxzaEnFGRKreNBoJpRiRu58U+HsVg2yWk4o=
+CORS_ENABLED=true
+CORS_ORIGIN=true
+LOG_LEVEL=debug
+DIRECTUS_ADMIN_EMAIL=mmintel@mintel.me
+DIRECTUS_ADMIN_PASSWORD=Tim300493.
+DIRECTUS_DB_NAME=directus
+DIRECTUS_DB_USER=directus
+DIRECTUS_DB_PASSWORD=mintel-db-pass
+
+# Sentry / Glitchtip
+SENTRY_DSN=
+
+# Analytics (Umami)
+NEXT_PUBLIC_UMAMI_WEBSITE_ID=
+NEXT_PUBLIC_UMAMI_SCRIPT_URL=https://analytics.infra.mintel.me/script.js
+UMAMI_USERNAME=mmintel
+UMAMI_PASSWORD=Tim300493.
+
+# MCP Services
+QDRANT_URL=http://qdrant:6333
+SERPBEAR_API_KEY=Tim300493.
+GLITCHTIP_API_KEY=3d37db66fa1fc3a1cdcd1357728b056225aca950f0163b50c5e922344807ede9
+
+# Corrected MCP Base URLs
+UMAMI_BASE_URL=https://analytics.infra.mintel.me
+GLITCHTIP_BASE_URL=https://errors.infra.mintel.me
+SERPBEAR_BASE_URL=https://seo.infra.mintel.me

.env.example

@@ -1,4 +1,5 @@
 # Project
+IMAGE_TAG=v1.9.17
 PROJECT_NAME=sample-website
 PROJECT_COLOR=#82ed20
 

.eslintignore

@@ -0,0 +1,4 @@
+**/index.js
+**/dist/**
+packages/cms-infra/extensions/**
+packages/cms-infra/extensions/**

.gitea/actions/core-smoke-tests/action.yml

@@ -0,0 +1,41 @@
+name: "Mintel Core Smoke Tests"
+description: "Executes standard fast HTTP, API, and Locale validation checks."
+
+inputs:
+  TARGET_URL:
+    description: 'The deployed URL to test against'
+    required: true
+  GATEKEEPER_PASSWORD:
+    description: 'Gatekeeper bypass password'
+    required: true
+  UMAMI_API_ENDPOINT:
+    description: 'Umami Analytics Endpoint'
+    required: false
+    default: 'https://analytics.infra.mintel.me'
+  SENTRY_DSN:
+    description: 'Sentry / Glitchtip DSN'
+    required: false
+
+runs:
+  using: "composite"
+  steps:
+    - name: 🌐 Full Sitemap HTTP Validation
+      shell: bash
+      env:
+        NEXT_PUBLIC_BASE_URL: ${{ inputs.TARGET_URL }}
+        GATEKEEPER_PASSWORD: ${{ inputs.GATEKEEPER_PASSWORD }}
+      run: pnpm run check:http
+
+    - name: 🌐 Locale & Language Switcher Validation
+      shell: bash
+      env:
+        NEXT_PUBLIC_BASE_URL: ${{ inputs.TARGET_URL }}
+        GATEKEEPER_PASSWORD: ${{ inputs.GATEKEEPER_PASSWORD }}
+      run: pnpm run check:locale
+
+    - name: 🌐 External API Smoke Test (Umami & Sentry)
+      shell: bash
+      env:
+        UMAMI_API_ENDPOINT:  ${{ inputs.UMAMI_API_ENDPOINT }}
+        SENTRY_DSN:          ${{ inputs.SENTRY_DSN }}
+      run: pnpm run check:apis

.gitea/workflows/maintenance.yml

@@ -0,0 +1,44 @@
+name: 🏥 Server Maintenance
+
+on:
+  schedule:
+    - cron: '0 3 * * *' # Every day at 3:00 AM
+  workflow_dispatch: # Allow manual trigger
+
+jobs:
+  maintenance:
+    name: 🧹 Prune & Clean
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 🚀 Execute Maintenance via SSH
+        run: |
+          mkdir -p ~/.ssh
+          echo "${{ secrets.SSH_KEY }}" > ~/.ssh/id_ed25519
+          chmod 600 ~/.ssh/id_ed25519
+          ssh-keyscan -H ${{ secrets.SSH_HOST }} >> ~/.ssh/known_hosts 2>/dev/null
+
+          # Run the prune script on the host
+          # We transfer the script and execute it to ensure it matches the repo version
+          scp packages/infra/scripts/mintel-optimizer.sh root@${{ secrets.SSH_HOST }}:/tmp/mintel-optimizer.sh
+          ssh root@${{ secrets.SSH_HOST }} "bash /tmp/mintel-optimizer.sh && rm /tmp/mintel-optimizer.sh"
+
+      - name: 🔔 Notification - Success
+        if: success()
+        run: |
+          curl -s -k -X POST "${{ secrets.GOTIFY_URL }}/message?token=${{ secrets.GOTIFY_TOKEN }}" \
+            -F "title=🏥 Maintenance Complete" \
+            -F "message=Server-Wartung erfolgreich ausgeführt.\nRegistry & Docker Ressourcen bereinigt." \
+            -F "priority=2" || true
+
+      - name: 🔔 Notification - Failure
+        if: failure()
+        run: |
+          curl -s -k -X POST "${{ secrets.GOTIFY_URL }}/message?token=${{ secrets.GOTIFY_TOKEN }}" \
+            -F "title=❌ Maintenance FAILED" \
+            -F "message=Die automatische Server-Wartung ist fehlgeschlagen!\nBitte Logs prüfen." \
+            -F "priority=8" || true

.gitea/workflows/pipeline.yml

@@ -2,51 +2,148 @@ name: Monorepo Pipeline
 
 on:
   push:
+    branches:
+      - '**'
     tags:
-      - 'v*'
+      - '*'
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
-  qa:
-    name: 🧪 Quality Assurance
+  prioritize:
+    name: ⚡ Prioritize Release
     runs-on: docker
     container:
       image: catthehacker/ubuntu:act-latest
+    steps:
+      - name: 🛑 Cancel Redundant Runs
+        env:
+          GITEA_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO: ${{ github.repository }}
+          RUN_ID: ${{ github.run_id }}
+          REF: ${{ github.ref }}
+          REF_NAME: ${{ github.ref_name }}
+          EVENT: ${{ github.event_name }}
+          SHA: ${{ github.sha }}
+        run: |
+          echo "🔎 Debug: Event=$EVENT, Ref=$REF, RefName=$REF_NAME, RunId=$RUN_ID"
+          
+          # Fetch recent runs for the repository
+          RUNS=$(curl -s -H "Authorization: token $GITEA_TOKEN" "https://git.infra.mintel.me/api/v1/repos/$REPO/actions/runs?limit=30")
+          
+          case "$REF" in
+            refs/tags/*)
+              echo "🚀 Release detected ($REF_NAME). Cancelling non-tag runs..."
+              
+              # Identify runs to cancel: in_progress/queued, NOT this run, and NOT a tag run
+              echo "$RUNS" | jq -c '.workflow_runs[] | select(.status == "in_progress" or .status == "queued") | select(.id | tostring != "'$RUN_ID'")' | while read -r run; do
+                ID=$(echo "$run" | jq -r '.id')
+                RUN_REF=$(echo "$run" | jq -r '.ref')
+                TITLE=$(echo "$run" | jq -r '.display_title')
+                
+                case "$RUN_REF" in
+                  refs/tags/*)
+                    echo "⏭️ Skipping parallel release run $ID ($TITLE) on $RUN_REF"
+                    ;;
+                  *)
+                    echo "🛑 Cancelling redundant branch run $ID ($TITLE) on $RUN_REF..."
+                    curl -X POST -s -H "Authorization: token $GITEA_TOKEN" "https://git.infra.mintel.me/api/v1/repos/$REPO/actions/runs/$ID/cancel"
+                    ;;
+                esac
+              done
+              ;;
+            *)
+              echo "ℹ️ Regular push. Checking for parallel release tag for SHA $SHA..."
+              
+              # Check if there's a tag run for the SAME commit
+              TAG_RUN_ID=$(echo "$RUNS" | jq -r '.workflow_runs[] | select(.ref | startswith("refs/tags/")) | select(.head_sha == "'$SHA'") | .id' | head -n 1)
+              
+              if [[ -n "$TAG_RUN_ID" && "$TAG_RUN_ID" != "null" ]]; then
+                echo "🚀 Found parallel tag run $TAG_RUN_ID for commit $SHA. Cancelling this branch run ($RUN_ID)..."
+                curl -X POST -s -H "Authorization: token $GITEA_TOKEN" "https://git.infra.mintel.me/api/v1/repos/$REPO/actions/runs/$RUN_ID/cancel"
+                exit 0
+              fi
+              echo "✅ No parallel tag run found. Proceeding."
+              ;;
+          esac
+
+  lint:
+    name: 🧹 Lint
+    needs: prioritize
+    if: always() && !cancelled() && (needs.prioritize.result == 'success' || needs.prioritize.result == 'skipped')
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    env:
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
           node_version: 20
-
+      - name: Enable pnpm
+        run: corepack enable && corepack prepare pnpm@10.2.0 --activate
       - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-        env:
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts --no-color
       - name: Lint
         run: pnpm lint
+      - name: Check Dependencies (Depcheck)
+        run: pnpm -r exec npx --yes depcheck --skip-missing --ignores="eslint*,@eslint/*,@types/*,typescript,tsup,tsx,vitest,tailwindcss,postcss,autoprefixer,@mintel/*,ts-node,*in-the-middle,pino*,@commitlint/*,@changesets/*,globals"
 
+  test:
+    name: 🧪 Test
+    needs: prioritize
+    if: always() && !cancelled() && (needs.prioritize.result == 'success' || needs.prioritize.result == 'skipped')
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    env:
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node_version: 20
+      - name: Enable pnpm
+        run: corepack enable && corepack prepare pnpm@10.2.0 --activate
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts --no-color
       - name: Test
         run: pnpm test
 
+  build:
+    name: 🏗️ Build
+    needs: prioritize
+    if: always() && !cancelled() && (needs.prioritize.result == 'success' || needs.prioritize.result == 'skipped')
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    env:
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node_version: 20
+      - name: Enable pnpm
+        run: corepack enable && corepack prepare pnpm@10.2.0 --activate
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts --no-color
       - name: Build
         run: pnpm build
 
   release:
     name: 🚀 Release
-    needs: qa
-    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [lint, test, build]
+    if: startsWith(github.ref, 'refs/tags/')
     runs-on: docker
     container:
       image: catthehacker/ubuntu:act-latest
@@ -58,33 +155,43 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
           node_version: 20
-
+      - name: Enable pnpm
+        run: corepack enable && corepack prepare pnpm@10.2.0 --activate
       - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
+        run: pnpm install --frozen-lockfile --prefer-offline --ignore-scripts --no-color
+      - name: 🏷️ Sync Versions (if Tagged)
+        run: pnpm sync-versions
       - name: 🏷️ Release Packages (Tag-Driven)
         run: |
           echo "🏷️ Tag detected [${{ github.ref_name }}], performing sync release..."
-          pnpm sync-versions
           pnpm release:tag
 
   build-images:
-    name: 🐳 Build & Push Images
-    needs: qa
-    if: startsWith(github.ref, 'refs/tags/v')
+    name: 🐳 Build ${{ matrix.name }}
+    needs: [lint, test, build]
+    if: startsWith(github.ref, 'refs/tags/')
     runs-on: docker
     container:
       image: catthehacker/ubuntu:act-latest
+    strategy:
+      fail-fast: false
+      max-parallel: 1
+      matrix:
+        include:
+          - image: nextjs
+            file: packages/infra/docker/Dockerfile.nextjs
+            name: Build-Base
+          - image: runtime
+            file: packages/infra/docker/Dockerfile.runtime
+            name: Production Runtime
+          - image: gatekeeper
+            file: packages/infra/docker/Dockerfile.gatekeeper
+            name: Gatekeeper (Product)
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -92,65 +199,44 @@ jobs:
       - name: 🐳 Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
-      - name: 🔐 Registry Login
-        uses: docker/login-action@v3
-        with:
-          registry: registry.infra.mintel.me
-          username: ${{ secrets.REGISTRY_USER }}
-          password: ${{ secrets.REGISTRY_PASS }}
+      - name: 🔐 Discover Valid Registry Token
+        id: discover_token
+        run: |
+          echo "Testing available secrets against git.infra.mintel.me Docker registry..."
+          TOKENS="${{ secrets.GITEA_PAT }} ${{ secrets.MINTEL_PRIVATE_TOKEN }} ${{ secrets.NPM_TOKEN }}"
+          USERS="${{ github.repository_owner }} ${{ github.actor }} marcmintel mintel mmintel"
 
-      - name: 🏗️ Build & Push Nextjs Build-Base
+          for TOKEN in $TOKENS; do
+            if [ -n "$TOKEN" ]; then
+              for U in $USERS; do
+                if [ -n "$U" ]; then
+                  echo "Attempting docker login for a token with user $U..."
+                  if echo "$TOKEN" | docker login git.infra.mintel.me -u "$U" --password-stdin > /dev/null 2>&1; then
+                    echo "✅ Successfully authenticated with a token."
+                    echo "::add-mask::$TOKEN"
+                    echo "token=$TOKEN" >> $GITHUB_OUTPUT
+                    echo "user=$U" >> $GITHUB_OUTPUT
+                    exit 0
+                  fi
+                fi
+              done
+            fi
+          done
+          echo "❌ All available tokens failed to authenticate!"
+          exit 1
+
+      - name: 🏗️ Build & Push ${{ matrix.name }}
         uses: docker/build-push-action@v5
         with:
           context: .
-          file: packages/infra/docker/Dockerfile.nextjs
-          platforms: linux/arm64
+          file: ${{ matrix.file }}
+          platforms: linux/amd64
           pull: true
+          provenance: false
           push: true
           secrets: |
-            NPM_TOKEN=${{ secrets.NPM_TOKEN }}
+            NPM_TOKEN=${{ steps.discover_token.outputs.token }}
           tags: |
-            registry.infra.mintel.me/mintel/nextjs:${{ github.ref_name }}
-            registry.infra.mintel.me/mintel/nextjs:latest
+            git.infra.mintel.me/mmintel/${{ matrix.image }}:${{ github.ref_name }}
+            git.infra.mintel.me/mmintel/${{ matrix.image }}:latest
 
-      - name: 🏗️ Build & Push Production Runtime
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: packages/infra/docker/Dockerfile.runtime
-          platforms: linux/arm64
-          pull: true
-          push: true
-          secrets: |
-            NPM_TOKEN=${{ secrets.NPM_TOKEN }}
-          tags: |
-            registry.infra.mintel.me/mintel/runtime:${{ github.ref_name }}
-            registry.infra.mintel.me/mintel/runtime:latest
-
-      - name: 🏗️ Build & Push Gatekeeper (Product)
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: packages/infra/docker/Dockerfile.gatekeeper
-          platforms: linux/arm64
-          pull: true
-          push: true
-          secrets: |
-            NPM_TOKEN=${{ secrets.NPM_TOKEN }}
-          tags: |
-            registry.infra.mintel.me/mintel/gatekeeper:${{ github.ref_name }}
-            registry.infra.mintel.me/mintel/gatekeeper:latest
-
-      - name: 🏗️ Build & Push Directus (Base)
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          file: packages/infra/docker/Dockerfile.directus
-          platforms: linux/arm64
-          pull: true
-          push: true
-          secrets: |
-            NPM_TOKEN=${{ secrets.NPM_TOKEN }}
-          tags: |
-            registry.infra.mintel.me/mintel/directus:${{ github.ref_name }}
-            registry.infra.mintel.me/mintel/directus:latest

.gitea/workflows/quality-assurance-template.yml

@@ -0,0 +1,248 @@
+name: Reusable Nightly QA
+
+on:
+  workflow_call:
+    inputs:
+      TARGET_URL:
+        description: 'The URL to test (e.g., https://testing.klz-cables.com)'
+        required: true
+        type: string
+      PROJECT_NAME:
+        description: 'The internal project name for notifications'
+        required: true
+        type: string
+    secrets:
+      GOTIFY_URL:
+        required: true
+      GOTIFY_TOKEN:
+        required: true
+      GATEKEEPER_PASSWORD:
+        required: true
+      NPM_TOKEN:
+        required: false
+      MINTEL_PRIVATE_TOKEN:
+        required: false
+      GITEA_PAT:
+        required: false
+
+jobs:
+  prepare:
+    name: 🏗️ Prepare & Install
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10
+      - name: 🔐 Registry Auth
+        run: |
+          REGISTRY="${{ vars.REGISTRY_HOST || 'npm.infra.mintel.me' }}"
+          echo "@mintel:registry=https://$REGISTRY" > .npmrc
+          echo "//$REGISTRY/:_authToken=${{ secrets.NPM_TOKEN || secrets.GITEA_PAT || secrets.MINTEL_PRIVATE_TOKEN }}" >> .npmrc
+      - name: 🔍 Diagnostics
+        run: |
+          echo "👤 User: $(id)"
+          echo "📂 Directory: $(pwd)"
+          echo "📂 Disk Space:"
+          df -h
+      - name: Install dependencies
+        run: |
+          rm -rf .next .turbo node_modules || true
+          pnpm install --no-frozen-lockfile --reporter=append-only
+      - name: 📦 Archive dependencies
+        uses: actions/upload-artifact@v3
+        with:
+          name: node_modules
+          path: node_modules
+          retention-days: 1
+
+  static:
+    name: 🔍 Static Analysis
+    needs: prepare
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: 📥 Restore dependencies
+        uses: actions/download-artifact@v3
+        with:
+          name: node_modules
+      - name: 🌐 HTML Validation
+        env:
+          NEXT_PUBLIC_BASE_URL: ${{ inputs.TARGET_URL }}
+          GATEKEEPER_PASSWORD: ${{ secrets.GATEKEEPER_PASSWORD }}
+        run: pnpm run check:html
+      - name: 🖼️ Asset Scan
+        env:
+          NEXT_PUBLIC_BASE_URL: ${{ inputs.TARGET_URL }}
+          GATEKEEPER_PASSWORD: ${{ secrets.GATEKEEPER_PASSWORD }}
+        run: pnpm run check:assets
+
+  accessibility:
+    name: ♿ Accessibility
+    needs: prepare
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: 📥 Restore dependencies
+        uses: actions/download-artifact@v3
+        with:
+          name: node_modules
+      - name: 🔍 Install Chromium
+        run: |
+          apt-get update && apt-get install -y gnupg wget ca-certificates
+          CODENAME=$(. /etc/os-release && echo $VERSION_CODENAME)
+          mkdir -p /etc/apt/keyrings
+          wget -qO- "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x82BB6851C64F6880" | gpg --dearmor > /etc/apt/keyrings/xtradeb.gpg
+          echo "deb [signed-by=/etc/apt/keyrings/xtradeb.gpg] http://ppa.launchpad.net/xtradeb/apps/ubuntu $CODENAME main" > /etc/apt/sources.list.d/xtradeb-ppa.list
+          printf "Package: *\nPin: release o=LP-PPA-xtradeb-apps\nPin-Priority: 1001\n" > /etc/apt/preferences.d/xtradeb
+          apt-get update && apt-get install -y --allow-downgrades chromium
+          ln -sf /usr/bin/chromium /usr/bin/google-chrome
+      - name: ♿ WCAG Scan
+        continue-on-error: true
+        env:
+          NEXT_PUBLIC_BASE_URL: ${{ inputs.TARGET_URL }}
+          GATEKEEPER_PASSWORD: ${{ secrets.GATEKEEPER_PASSWORD }}
+        run: pnpm run check:wcag
+
+  analysis:
+    name: 🧪 Maintenance & Links
+    needs: prepare
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: 📥 Restore dependencies
+        uses: actions/download-artifact@v3
+        with:
+          name: node_modules
+      - name: 📦 Depcheck
+        continue-on-error: true
+        run: pnpm dlx depcheck --ignores="*eslint*,*typescript*,*tailwindcss*,*postcss*,*prettier*,*@types/*,*husky*,*lint-staged*,*@next/*,*@lhci/*,*commitlint*,*cspell*,*rimraf*,*@payloadcms/*,*start-server-and-test*,*html-validate*,*critters*,*dotenv*,*turbo*"
+      - name: 🔗 Lychee Link Check
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: --accept 200,204,429 --timeout 15 content/ app/ public/
+          fail: true
+
+  performance:
+    name: 🎭 Lighthouse
+    needs: prepare
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 10
+      - name: 📥 Restore dependencies
+        uses: actions/download-artifact@v3
+        with:
+          name: node_modules
+      - name: 🔍 Install Chromium
+        run: |
+          apt-get update && apt-get install -y gnupg wget ca-certificates
+          CODENAME=$(. /etc/os-release && echo $VERSION_CODENAME)
+          mkdir -p /etc/apt/keyrings
+          wget -qO- "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x82BB6851C64F6880" | gpg --dearmor > /etc/apt/keyrings/xtradeb.gpg
+          echo "deb [signed-by=/etc/apt/keyrings/xtradeb.gpg] http://ppa.launchpad.net/xtradeb/apps/ubuntu $CODENAME main" > /etc/apt/sources.list.d/xtradeb-ppa.list
+          printf "Package: *\nPin: release o=LP-PPA-xtradeb-apps\nPin-Priority: 1001\n" > /etc/apt/preferences.d/xtradeb
+          apt-get update && apt-get install -y --allow-downgrades chromium
+          ln -sf /usr/bin/chromium /usr/bin/google-chrome
+      - name: 🎭 LHCI Desktop
+        env:
+          LHCI_URL: ${{ inputs.TARGET_URL }}
+          GATEKEEPER_PASSWORD: ${{ secrets.GATEKEEPER_PASSWORD }}
+        run: pnpm run pagespeed:test -- --collect.settings.preset=desktop
+      - name: 📱 LHCI Mobile
+        env:
+          LHCI_URL: ${{ inputs.TARGET_URL }}
+          GATEKEEPER_PASSWORD: ${{ secrets.GATEKEEPER_PASSWORD }}
+        run: pnpm run pagespeed:test -- --collect.settings.preset=mobile
+
+  notifications:
+    name: 🔔 Notify
+    needs: [prepare, static, accessibility, analysis, performance]
+    if: always()
+    runs-on: docker
+    container:
+      image: catthehacker/ubuntu:act-latest
+    steps:
+      - name: 🔔 Gotify
+        shell: bash
+        run: |
+          PREPARE="${{ needs.prepare.result }}"
+          STATIC="${{ needs.static.result }}"
+          A11Y="${{ needs.accessibility.result }}"
+          ANALYSIS="${{ needs.analysis.result }}"
+          PERF="${{ needs.performance.result }}"
+          
+          PROJECT="${{ inputs.PROJECT_NAME }}"
+          URL="${{ inputs.TARGET_URL }}"
+
+          if [[ "$PREPARE" != "success" || "$STATIC" != "success" || "$PERF" != "success" ]]; then
+            PRIORITY=8
+            EMOJI="🚨"
+            STATUS_LINE="Nightly QA Failed! Action required."
+          else
+            PRIORITY=2
+            EMOJI="✅"
+            STATUS_LINE="Nightly QA Passed."
+          fi
+
+          TITLE="$EMOJI $PROJECT Nightly QA"
+          MESSAGE="$STATUS_LINE
+          Prepare: $PREPARE | Static: $STATIC | A11y: $A11Y
+          Analysis: $ANALYSIS | Perf: $PERF
+          $URL"
+
+          curl -s -k -X POST "${{ secrets.GOTIFY_URL }}/message?token=${{ secrets.GOTIFY_TOKEN }}" \
+            -F "title=$TITLE" \
+            -F "message=$MESSAGE" \
+            -F "priority=$PRIORITY" || true

.gitignore

@@ -1,6 +1,7 @@
 # dependencies
 node_modules
 .pnpm-debug.log*
+.pnpm-store/
 
 # next.js
 .next/
@@ -36,3 +37,21 @@ Thumbs.db
 
 # Changesets
 .changeset/*.lock
+directus/extensions/
+packages/cms-infra/extensions/
+packages/cms-infra/uploads/
+
+directus/uploads/directus-health-file
+
+# Estimation Engine Data
+data/crawls/
+packages/estimation-engine/out/
+apps/web/out/estimations/
+
+# Memory MCP
+data/qdrant/
+packages/memory-mcp/models/
+
+# Kabelfachmann MCP
+packages/kabelfachmann-mcp/data/
+packages/kabelfachmann-mcp/models/

.husky/pre-push

@@ -0,0 +1,8 @@
+# Validate Directus SDK imports before push
+# This prevents runtime crashes caused by importing non-existent exports
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+if [ -f "$SCRIPT_DIR/scripts/validate-sdk-imports.sh" ]; then
+  "$SCRIPT_DIR/scripts/validate-sdk-imports.sh" || exit 1
+fi
+
+

.npmrc

@@ -1,4 +1,6 @@
-@mintel:registry=https://npm.infra.mintel.me/
-registry=https://npm.infra.mintel.me/
-//npm.infra.mintel.me/:_authToken=${NPM_TOKEN}
+@mintel:registry=https://git.infra.mintel.me/api/packages/mmintel/npm/
+//git.infra.mintel.me/api/packages/mmintel/npm/:_authToken=${NPM_TOKEN}
 always-auth=true
+
+public-hoist-pattern[]=*
+shamefully-hoist=true

ARCHITECTURE.md

@@ -0,0 +1,46 @@
+# Mintel Universal Design System - Architecture Manifesto
+
+Dieses Dokument ist der absolute Nordstern für alle Entwickler und KI-Agenten, die an der Mintel Codebase arbeiten. Es definiert, wie wir UI-Komponenten bauen, isolieren und skalieren, ohne in eine "Lock-in"-Falle zu tappen.
+
+## 1. Das Problem: Die Design System Falle
+Wir bauen eine neutrale Basis (`@mintel/ui`), auf der Web, Print (PDF), Präsentationen und Remotion-Videos basieren. 
+Das größte Risiko: Komponenten werden im Laufe der Zeit so komplex (mit dutzenden `if/else`-Switches für Kunden-Sonderfälle), dass niemand sich mehr traut, sie anzufassen, aus Angst, andere Projekte zu zerstören.
+
+## 2. Die Zwiebel-Architektur (Core vs. Components)
+Um dieses Problem zu lösen, teilen wir unser UI-Paket logisch in zwei Ebenen:
+
+### Tier 1: Primitives (Der Kern)
+- **Was ist das?** Die absoluten Grundbausteine: `<Box>`, `<Text>`, `<Flex>`, `<Grid>`.
+- **Die Regel:** Diese Komponenten haben *keine* Meinung. Sie dienen ausschließlich als saubere, typisierte Wrapper, um Tailwind-Klassen und Props durchzureichen. Sie dürfen sich architektonisch nie ändern.
+- **Warum?** Weil Projekte im Notfall immer auf diese Bausteine zurückfallen können, um eigene, hochgradig individuelle Layouts zu bauen.
+
+### Tier 2: Base Components (Der Mintel Standard)
+- **Was ist das?** Fertige Komponenten wie `<Button>`, `<Card>`, `<HeroSection>`.
+- **Die Regel:** Sie haben den "neutralen" Mintel-Standardlook. Sie bauen zu 100% auf Tier 1 Primitives auf.
+
+## 3. Die 3 Goldenen Regeln gegen den "Lock-in"
+
+Wenn ein spezifisches Projekt (z.B. ein neuer Kunde) eine Komponente braucht, die radikal vom Mintel-Standard abweicht, gelten folgende Eskalationsstufen:
+
+### Eskalation 1: Compound Components
+Komponenten dürfen niemals gigantische Props-Monster (`<Card hideHeader={true} showFooter={false} />`) werden. 
+Wir nutzen **Compound Components**: Das Projekt setzt die Card selbst aus `<Card.Header>`, `<Card.Body>` und `<Card.Footer>` zusammen. Braucht das Projekt den Header nicht, lässt es ihn einfach weg.
+
+### Eskalation 2: Das `asChild` Pattern (Slot)
+Wir sperren Projekte niemals in unsere DOM-Struktur ein. Wenn eine Komponente Logik enthält, nutzen wir das `asChild` (oder Slot) Pattern.
+*Beispiel:* Ein `<Button asChild>` rendert kein `<button>` HTML-Tag, sondern reicht seine Tailwind-Styles und seine Accessibility-Logik transparent an das Kind-Element durch (z.B. einen Next.js `<Link>`).
+
+### Eskalation 3: Der "Eject" (Der Shadcn-Weg)
+Wenn eine `@mintel/ui` Komponente absolut nicht mehr für den Kunden X passt, wird sie **nicht** durch `if (kunde === 'X')`-Logik in der Basis "aufgebohrt".
+Stattdessen **ejecten** (kopieren) wir den Source-Code der Komponente physisch in das Projekt von Kunde X (`apps/kunde-x/components/`). Ab diesem Moment "besitzt" das Projekt diese Komponente und kann sie nach Belieben modifizieren. Die neutrale Basis bleibt sauber!
+
+## 4. Agenten & LLM Workflow
+Jeder KI-Agent, der eine neue Komponente für `@mintel/ui` baut, muss folgende Checkliste abarbeiten:
+
+1. **Ladle-First (TDD):** Keine Komponente wird ohne eine dazugehörige `.stories.tsx` Datei für den Ladle-Katalog akzeptiert. Ladle ist unsere Source of Truth.
+2. **Keine Business-Logik:** Die Komponente darf keinen State (außer internen UI-State wie `isOpen`), keine API-Fetches und keine projektspezifischen Konstanten enthalten.
+3. **Universalität prüfen:** Die Komponente darf keine reinen Browser-APIs (`window.location`) ohne Fallbacks nutzen, damit sie auch serverseitig in der Print-Engine (PDF) und in der Remotion-Engine gerendert werden kann.
+4. **Tailwind pur:** Nutze ausschließlich Tailwind-Klassen. Keine externen CSS-Module oder `style`-Tags, wenn nicht physikalisch zwingend (z.B. bei dynamischer Frame-Interpolation in Videos).
+
+---
+*Wer dieses Manifest bricht, sabotiert die Skalierbarkeit des Monorepos. Halte dich an die Zwiebel-Architektur!*

Dockerfile.template

@@ -0,0 +1,56 @@
+# Stage 1: Builder
+FROM git.infra.mintel.me/mmintel/nextjs:latest AS builder
+WORKDIR /app
+
+# Clean the workspace in case the base image is dirty
+RUN rm -rf ./*
+
+# Arguments for build-time configuration
+ARG NEXT_PUBLIC_BASE_URL
+ARG NEXT_PUBLIC_TARGET
+ARG DIRECTUS_URL
+ARG NPM_TOKEN
+
+# Environment variables for Next.js build
+ENV NEXT_PUBLIC_BASE_URL=$NEXT_PUBLIC_BASE_URL
+ENV NEXT_PUBLIC_TARGET=$NEXT_PUBLIC_TARGET
+ENV DIRECTUS_URL=$DIRECTUS_URL
+ENV SKIP_RUNTIME_ENV_VALIDATION=true
+ENV CI=true
+
+# Enable pnpm
+RUN corepack enable
+
+# Copy lockfile and manifest for dependency installation caching
+COPY pnpm-lock.yaml package.json .npmrc* ./
+
+# Install dependencies with cache mount
+RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
+    --mount=type=secret,id=NPM_TOKEN \
+    export NPM_TOKEN=$(cat /run/secrets/NPM_TOKEN 2>/dev/null || echo $NPM_TOKEN) && \
+    pnpm install --frozen-lockfile
+
+# Copy source code
+COPY . .
+
+# Build application
+RUN pnpm build
+
+# Stage 2: Runner
+FROM git.infra.mintel.me/mmintel/runtime:latest AS runner
+WORKDIR /app
+
+ENV HOSTNAME="0.0.0.0"
+ENV PORT=3000
+ENV NODE_ENV=production
+
+# Copy standalone output and static files
+# Adjust paths if using a monorepo structure (e.g., /app/apps/web/public)
+COPY --from=builder --chown=nextjs:nodejs /app/public ./public
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+COPY --from=builder --chown=nextjs:nodejs /app/.next/cache ./.next/cache
+
+USER nextjs
+
+CMD ["node", "server.js"]

README.md

@@ -80,3 +80,5 @@ Client websites scaffolded via the CLI use a **tag-based deployment** strategy:
 - **Git Tag `v*.*.*`**: Deploys to the `production` environment.
 
 See the [`@mintel/infra`](packages/infra/README.md) package for detailed template documentation.
+
+Trigger rebuilding for x86 architecture.

apps/example-presentation/.gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

apps/example-presentation/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

apps/example-presentation/eslint.config.js

@@ -0,0 +1,22 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      globals: globals.browser,
+    },
+  },
+])

apps/example-presentation/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>example-presentation</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

apps/example-presentation/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "example-presentation",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@mintel/ui": "workspace:*",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "spectacle": "^10.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^4.3.4",
+    "eslint": "^9.17.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react-refresh": "^0.4.16",
+    "globals": "^15.14.0",
+    "typescript": "~5.7.2",
+    "typescript-eslint": "^8.18.2",
+    "vite": "^6.0.5"
+  }
+}

apps/example-presentation/public/icons.svg

@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg">
+  <symbol id="bluesky-icon" viewBox="0 0 16 17">
+    <g clip-path="url(#bluesky-clip)"><path fill="#08060d" d="M7.75 7.735c-.693-1.348-2.58-3.86-4.334-5.097-1.68-1.187-2.32-.981-2.74-.79C.188 2.065.1 2.812.1 3.251s.241 3.602.398 4.13c.52 1.744 2.367 2.333 4.07 2.145-2.495.37-4.71 1.278-1.805 4.512 3.196 3.309 4.38-.71 4.987-2.746.608 2.036 1.307 5.91 4.93 2.746 2.72-2.746.747-4.143-1.747-4.512 1.702.189 3.55-.4 4.07-2.145.156-.528.397-3.691.397-4.13s-.088-1.186-.575-1.406c-.42-.19-1.06-.395-2.741.79-1.755 1.24-3.64 3.752-4.334 5.099"/></g>
+    <defs><clipPath id="bluesky-clip"><path fill="#fff" d="M.1.85h15.3v15.3H.1z"/></clipPath></defs>
+  </symbol>
+  <symbol id="discord-icon" viewBox="0 0 20 19">
+    <path fill="#08060d" d="M16.224 3.768a14.5 14.5 0 0 0-3.67-1.153c-.158.286-.343.67-.47.976a13.5 13.5 0 0 0-4.067 0c-.128-.306-.317-.69-.476-.976A14.4 14.4 0 0 0 3.868 3.77C1.546 7.28.916 10.703 1.231 14.077a14.7 14.7 0 0 0 4.5 2.306q.545-.748.965-1.587a9.5 9.5 0 0 1-1.518-.74q.191-.14.372-.293c2.927 1.369 6.107 1.369 8.999 0q.183.152.372.294-.723.437-1.52.74.418.838.963 1.588a14.6 14.6 0 0 0 4.504-2.308c.37-3.911-.63-7.302-2.644-10.309m-9.13 8.234c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.894 0 1.614.82 1.599 1.82.001 1-.705 1.82-1.6 1.82m5.91 0c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.893 0 1.614.82 1.599 1.82 0 1-.706 1.82-1.6 1.82"/>
+  </symbol>
+  <symbol id="documentation-icon" viewBox="0 0 21 20">
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="m15.5 13.333 1.533 1.322c.645.555.967.833.967 1.178s-.322.623-.967 1.179L15.5 18.333m-3.333-5-1.534 1.322c-.644.555-.966.833-.966 1.178s.322.623.966 1.179l1.534 1.321"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M17.167 10.836v-4.32c0-1.41 0-2.117-.224-2.68-.359-.906-1.118-1.621-2.08-1.96-.599-.21-1.349-.21-2.848-.21-2.623 0-3.935 0-4.983.369-1.684.591-3.013 1.842-3.641 3.428C3 6.449 3 7.684 3 10.154v2.122c0 2.558 0 3.838.706 4.726q.306.383.713.671c.76.536 1.79.64 3.581.66"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M3 10a2.78 2.78 0 0 1 2.778-2.778c.555 0 1.209.097 1.748-.047.48-.129.854-.503.982-.982.145-.54.048-1.194.048-1.749a2.78 2.78 0 0 1 2.777-2.777"/>
+  </symbol>
+  <symbol id="github-icon" viewBox="0 0 19 19">
+    <path fill="#08060d" fill-rule="evenodd" d="M9.356 1.85C5.05 1.85 1.57 5.356 1.57 9.694a7.84 7.84 0 0 0 5.324 7.44c.387.079.528-.168.528-.376 0-.182-.013-.805-.013-1.454-2.165.467-2.616-.935-2.616-.935-.349-.91-.864-1.143-.864-1.143-.71-.48.051-.48.051-.48.787.051 1.2.805 1.2.805.695 1.194 1.817.857 2.268.649.064-.507.27-.857.49-1.052-1.728-.182-3.545-.857-3.545-3.87 0-.857.31-1.558.8-2.104-.078-.195-.349-1 .077-2.078 0 0 .657-.208 2.14.805a7.5 7.5 0 0 1 1.946-.26c.657 0 1.328.092 1.946.26 1.483-1.013 2.14-.805 2.14-.805.426 1.078.155 1.883.078 2.078.502.546.799 1.247.799 2.104 0 3.013-1.818 3.675-3.558 3.87.284.247.528.714.528 1.454 0 1.052-.012 1.896-.012 2.156 0 .208.142.455.528.377a7.84 7.84 0 0 0 5.324-7.441c.013-4.338-3.48-7.844-7.773-7.844" clip-rule="evenodd"/>
+  </symbol>
+  <symbol id="social-icon" viewBox="0 0 20 20">
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M12.5 6.667a4.167 4.167 0 1 0-8.334 0 4.167 4.167 0 0 0 8.334 0"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M2.5 16.667a5.833 5.833 0 0 1 8.75-5.053m3.837.474.513 1.035c.07.144.257.282.414.309l.93.155c.596.1.736.536.307.965l-.723.73a.64.64 0 0 0-.152.531l.207.903c.164.715-.213.991-.84.618l-.872-.52a.63.63 0 0 0-.577 0l-.872.52c-.624.373-1.003.094-.84-.618l.207-.903a.64.64 0 0 0-.152-.532l-.723-.729c-.426-.43-.289-.864.306-.964l.93-.156a.64.64 0 0 0 .412-.31l.513-1.034c.28-.562.735-.562 1.012 0"/>
+  </symbol>
+  <symbol id="x-icon" viewBox="0 0 19 19">
+    <path fill="#08060d" fill-rule="evenodd" d="M1.893 1.98c.052.072 1.245 1.769 2.653 3.77l2.892 4.114c.183.261.333.48.333.486s-.068.089-.152.183l-.522.593-.765.867-3.597 4.087c-.375.426-.734.834-.798.905a1 1 0 0 0-.118.148c0 .01.236.017.664.017h.663l.729-.83c.4-.457.796-.906.879-.999a692 692 0 0 0 1.794-2.038c.034-.037.301-.34.594-.675l.551-.624.345-.392a7 7 0 0 1 .34-.374c.006 0 .93 1.306 2.052 2.903l2.084 2.965.045.063h2.275c1.87 0 2.273-.003 2.266-.021-.008-.02-1.098-1.572-3.894-5.547-2.013-2.862-2.28-3.246-2.273-3.266.008-.019.282-.332 2.085-2.38l2-2.274 1.567-1.782c.022-.028-.016-.03-.65-.03h-.674l-.3.342a871 871 0 0 1-1.782 2.025c-.067.075-.405.458-.75.852a100 100 0 0 1-.803.91c-.148.172-.299.344-.99 1.127-.304.343-.32.358-.345.327-.015-.019-.904-1.282-1.976-2.808L6.365 1.85H1.8zm1.782.91 8.078 11.294c.772 1.08 1.413 1.973 1.425 1.984.016.017.241.02 1.05.017l1.03-.004-2.694-3.766L7.796 5.75 5.722 2.852l-1.039-.004-1.039-.004z" clip-rule="evenodd"/>
+  </symbol>
+</svg>

apps/example-presentation/src/App.css

@@ -0,0 +1,184 @@
+.counter {
+  font-size: 16px;
+  padding: 5px 10px;
+  border-radius: 5px;
+  color: var(--accent);
+  background: var(--accent-bg);
+  border: 2px solid transparent;
+  transition: border-color 0.3s;
+  margin-bottom: 24px;
+
+  &:hover {
+    border-color: var(--accent-border);
+  }
+  &:focus-visible {
+    outline: 2px solid var(--accent);
+    outline-offset: 2px;
+  }
+}
+
+.hero {
+  position: relative;
+
+  .base,
+  .framework,
+  .vite {
+    inset-inline: 0;
+    margin: 0 auto;
+  }
+
+  .base {
+    width: 170px;
+    position: relative;
+    z-index: 0;
+  }
+
+  .framework,
+  .vite {
+    position: absolute;
+  }
+
+  .framework {
+    z-index: 1;
+    top: 34px;
+    height: 28px;
+    transform: perspective(2000px) rotateZ(300deg) rotateX(44deg) rotateY(39deg)
+      scale(1.4);
+  }
+
+  .vite {
+    z-index: 0;
+    top: 107px;
+    height: 26px;
+    width: auto;
+    transform: perspective(2000px) rotateZ(300deg) rotateX(40deg) rotateY(39deg)
+      scale(0.8);
+  }
+}
+
+#center {
+  display: flex;
+  flex-direction: column;
+  gap: 25px;
+  place-content: center;
+  place-items: center;
+  flex-grow: 1;
+
+  @media (max-width: 1024px) {
+    padding: 32px 20px 24px;
+    gap: 18px;
+  }
+}
+
+#next-steps {
+  display: flex;
+  border-top: 1px solid var(--border);
+  text-align: left;
+
+  & > div {
+    flex: 1 1 0;
+    padding: 32px;
+    @media (max-width: 1024px) {
+      padding: 24px 20px;
+    }
+  }
+
+  .icon {
+    margin-bottom: 16px;
+    width: 22px;
+    height: 22px;
+  }
+
+  @media (max-width: 1024px) {
+    flex-direction: column;
+    text-align: center;
+  }
+}
+
+#docs {
+  border-right: 1px solid var(--border);
+
+  @media (max-width: 1024px) {
+    border-right: none;
+    border-bottom: 1px solid var(--border);
+  }
+}
+
+#next-steps ul {
+  list-style: none;
+  padding: 0;
+  display: flex;
+  gap: 8px;
+  margin: 32px 0 0;
+
+  .logo {
+    height: 18px;
+  }
+
+  a {
+    color: var(--text-h);
+    font-size: 16px;
+    border-radius: 6px;
+    background: var(--social-bg);
+    display: flex;
+    padding: 6px 12px;
+    align-items: center;
+    gap: 8px;
+    text-decoration: none;
+    transition: box-shadow 0.3s;
+
+    &:hover {
+      box-shadow: var(--shadow);
+    }
+    .button-icon {
+      height: 18px;
+      width: 18px;
+    }
+  }
+
+  @media (max-width: 1024px) {
+    margin-top: 20px;
+    flex-wrap: wrap;
+    justify-content: center;
+
+    li {
+      flex: 1 1 calc(50% - 8px);
+    }
+
+    a {
+      width: 100%;
+      justify-content: center;
+      box-sizing: border-box;
+    }
+  }
+}
+
+#spacer {
+  height: 88px;
+  border-top: 1px solid var(--border);
+  @media (max-width: 1024px) {
+    height: 48px;
+  }
+}
+
+.ticks {
+  position: relative;
+  width: 100%;
+
+  &::before,
+  &::after {
+    content: '';
+    position: absolute;
+    top: -4.5px;
+    border: 5px solid transparent;
+  }
+
+  &::before {
+    left: 0;
+    border-left-color: var(--border);
+  }
+  &::after {
+    right: 0;
+    border-right-color: var(--border);
+  }
+}

apps/example-presentation/src/App.tsx

@@ -0,0 +1,26 @@
+import React from 'react';
+import { Deck, Slide, Heading, Text as SpectacleText } from 'spectacle';
+import { Box, Text, EnvironmentProvider } from '@mintel/ui';
+
+function App() {
+  return (
+    <EnvironmentProvider env="presentation">
+      <Deck>
+        <Slide>
+          <Box className="flex flex-col items-center justify-center h-full">
+            <Heading>Mintel Universal Design System</Heading>
+            <SpectacleText>One Codebase. Web, Print, and Presentations.</SpectacleText>
+            
+            <Box className="mt-8 p-4 bg-mintel-primary rounded-xl shadow-xl">
+              <Text className="text-white text-xl">
+                This Box and Text comes directly from @mintel/ui!
+              </Text>
+            </Box>
+          </Box>
+        </Slide>
+      </Deck>
+    </EnvironmentProvider>
+  );
+}
+
+export default App;

apps/example-presentation/src/assets/react.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

apps/example-presentation/src/index.css

@@ -0,0 +1,111 @@
+:root {
+  --text: #6b6375;
+  --text-h: #08060d;
+  --bg: #fff;
+  --border: #e5e4e7;
+  --code-bg: #f4f3ec;
+  --accent: #aa3bff;
+  --accent-bg: rgba(170, 59, 255, 0.1);
+  --accent-border: rgba(170, 59, 255, 0.5);
+  --social-bg: rgba(244, 243, 236, 0.5);
+  --shadow:
+    rgba(0, 0, 0, 0.1) 0 10px 15px -3px, rgba(0, 0, 0, 0.05) 0 4px 6px -2px;
+
+  --sans: system-ui, 'Segoe UI', Roboto, sans-serif;
+  --heading: system-ui, 'Segoe UI', Roboto, sans-serif;
+  --mono: ui-monospace, Consolas, monospace;
+
+  font: 18px/145% var(--sans);
+  letter-spacing: 0.18px;
+  color-scheme: light dark;
+  color: var(--text);
+  background: var(--bg);
+  font-synthesis: none;
+  text-rendering: optimizeLegibility;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+
+  @media (max-width: 1024px) {
+    font-size: 16px;
+  }
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --text: #9ca3af;
+    --text-h: #f3f4f6;
+    --bg: #16171d;
+    --border: #2e303a;
+    --code-bg: #1f2028;
+    --accent: #c084fc;
+    --accent-bg: rgba(192, 132, 252, 0.15);
+    --accent-border: rgba(192, 132, 252, 0.5);
+    --social-bg: rgba(47, 48, 58, 0.5);
+    --shadow:
+      rgba(0, 0, 0, 0.4) 0 10px 15px -3px, rgba(0, 0, 0, 0.25) 0 4px 6px -2px;
+  }
+
+  #social .button-icon {
+    filter: invert(1) brightness(2);
+  }
+}
+
+#root {
+  width: 1126px;
+  max-width: 100%;
+  margin: 0 auto;
+  text-align: center;
+  border-inline: 1px solid var(--border);
+  min-height: 100svh;
+  display: flex;
+  flex-direction: column;
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+}
+
+h1,
+h2 {
+  font-family: var(--heading);
+  font-weight: 500;
+  color: var(--text-h);
+}
+
+h1 {
+  font-size: 56px;
+  letter-spacing: -1.68px;
+  margin: 32px 0;
+  @media (max-width: 1024px) {
+    font-size: 36px;
+    margin: 20px 0;
+  }
+}
+h2 {
+  font-size: 24px;
+  line-height: 118%;
+  letter-spacing: -0.24px;
+  margin: 0 0 8px;
+  @media (max-width: 1024px) {
+    font-size: 20px;
+  }
+}
+p {
+  margin: 0;
+}
+
+code,
+.counter {
+  font-family: var(--mono);
+  display: inline-flex;
+  border-radius: 4px;
+  color: var(--text-h);
+}
+
+code {
+  font-size: 15px;
+  line-height: 135%;
+  padding: 4px 8px;
+  background: var(--code-bg);
+}

apps/example-presentation/src/main.tsx

@@ -0,0 +1,10 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import './index.css'
+import App from './App.tsx'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)

apps/example-presentation/tsconfig.app.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+    "target": "es2023",
+    "lib": ["ES2023", "DOM"],
+    "module": "esnext",
+    "types": ["vite/client"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src"]
+}

apps/example-presentation/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

apps/example-presentation/tsconfig.node.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+    "target": "es2023",
+    "lib": ["ES2023"],
+    "module": "esnext",
+    "types": ["node"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+
+    /* Linting */
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["vite.config.ts"]
+}

apps/example-presentation/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [react()],
+})

apps/example-print/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "example-print",
+  "version": "1.0.0",
+  "private": true,
+  "main": "index.js",
+  "scripts": {
+    "build:pdf": "ts-node src/generator.tsx"
+  },
+  "dependencies": {
+    "@mintel/ui": "workspace:*",
+    "@react-pdf/renderer": "^3.4.0",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "ts-node": "^10.9.2",
+    "typescript": "^5.0.0",
+    "@types/react": "^18.2.0"
+  }
+}

apps/example-print/src/generator.tsx

@@ -0,0 +1,30 @@
+import React from 'react';
+import ReactPDF, { Document, Page } from '@react-pdf/renderer';
+import { Box, Text, EnvironmentProvider } from '@mintel/ui';
+
+const InvoiceDocument = () => (
+  <EnvironmentProvider env="print">
+    <Document>
+      <Page size="A4" style={{ padding: 40, backgroundColor: '#ffffff' }}>
+        <Box pdfStyle={{ marginBottom: 20, borderBottom: '2px solid #1E40AF', paddingBottom: 10 }}>
+          <Text pdfStyle={{ fontSize: 28, color: '#1E40AF', fontWeight: 'bold' }}>
+            Mintel Universal Design
+          </Text>
+        </Box>
+        <Box pdfStyle={{ padding: 20, backgroundColor: '#f3f4f6', borderRadius: 8 }}>
+          <Text pdfStyle={{ fontSize: 14, color: '#374151' }}>
+            This PDF is generated using the exact same React components as the Web application.
+          </Text>
+        </Box>
+      </Page>
+    </Document>
+  </EnvironmentProvider>
+);
+
+const generatePDF = async () => {
+  console.log('Generating Universal PDF...');
+  await ReactPDF.render(<InvoiceDocument />, `${__dirname}/output.pdf`);
+  console.log('Successfully saved to output.pdf');
+};
+
+generatePDF();

apps/example-video/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@mintel/example-video",
+  "version": "1.0.0",
+  "description": "Remotion video project using Mintel UI",
+  "scripts": {
+    "start": "remotion studio",
+    "build": "remotion render"
+  },
+  "dependencies": {
+    "@mintel/ui": "workspace:*",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "remotion": "^4.0.0"
+  },
+  "devDependencies": {
+    "@remotion/cli": "^4.0.0",
+    "@remotion/tailwind": "^4.0.0",
+    "typescript": "^5.0.0",
+    "@types/react": "^18.0.0",
+    "tailwindcss": "^3.0.0"
+  }
+}

apps/example-video/postcss.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

apps/example-video/remotion.config.ts

@@ -0,0 +1,4 @@
+import { Config } from "@remotion/cli/config";
+
+Config.setVideoImageFormat("jpeg");
+Config.setOverwriteOutput(true);

apps/example-video/src/Composition.tsx

@@ -0,0 +1,40 @@
+import React from "react";
+import { useCurrentFrame, useVideoConfig, interpolate } from "remotion";
+import { Box, Text } from "@mintel/ui";
+import "../../ui/index.css"; // Ensure Tailwind CSS from UI package is loaded
+
+export const MintelPromo: React.FC = () => {
+  const frame = useCurrentFrame();
+  const { fps } = useVideoConfig();
+
+  // Fade in over the first 1 second (30 frames)
+  const opacity = interpolate(frame, [0, fps], [0, 1], {
+    extrapolateRight: "clamp",
+  });
+
+  // Slide up over the first 1 second
+  const translateY = interpolate(frame, [0, fps], [50, 0], {
+    extrapolateRight: "clamp",
+  });
+
+  return (
+    <div style={{ flex: 1, backgroundColor: "#f3f4f6" }}>
+      <Box
+        className="w-full h-full flex items-center justify-center bg-gray-100"
+        style={{ opacity }}
+      >
+        <Box
+          className="bg-white p-12 rounded-3xl shadow-2xl flex flex-col items-center"
+          style={{ transform: `translateY(${translateY}px)` }}
+        >
+          <Text variant="h1" className="text-blue-600 mb-4 text-8xl font-bold">
+            Mintel Video
+          </Text>
+          <Text variant="body" className="text-gray-600 text-3xl">
+            Powered by Remotion & @mintel/ui
+          </Text>
+        </Box>
+      </Box>
+    </div>
+  );
+};

apps/example-video/src/Root.tsx

@@ -0,0 +1,18 @@
+import React from "react";
+import { Composition } from "remotion";
+import { MintelPromo } from "./Composition";
+
+export const RemotionRoot: React.FC = () => {
+  return (
+    <>
+      <Composition
+        id="MintelPromo"
+        component={MintelPromo}
+        durationInFrames={150}
+        fps={30}
+        width={1920}
+        height={1080}
+      />
+    </>
+  );
+};

apps/example-video/src/index.ts

@@ -0,0 +1,4 @@
+import { registerRoot } from "remotion";
+import { RemotionRoot } from "./Root";
+
+registerRoot(RemotionRoot);

apps/example-video/tailwind.config.js

@@ -0,0 +1,11 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  content: [
+    "./src/**/*.{ts,tsx}",
+    "../../packages/ui/src/**/*.{ts,tsx}"
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

apps/example-video/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "useDefineForClassFields": true,
+    "lib": ["DOM", "DOM.Iterable", "ESNext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx"
+  },
+  "include": ["src"]
+}

apps/example-web/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

apps/example-web/AGENTS.md

@@ -0,0 +1,5 @@
+<!-- BEGIN:nextjs-agent-rules -->
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
+<!-- END:nextjs-agent-rules -->

apps/example-web/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

apps/example-web/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

apps/example-web/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

apps/example-web/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;

apps/example-web/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "example-web",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "next": "16.2.7",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.7",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

apps/example-web/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+ignoredBuiltDependencies:
+  - sharp
+  - unrs-resolver

apps/example-web/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

apps/example-web/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

apps/example-web/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

apps/example-web/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

apps/example-web/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

apps/example-web/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

apps/example-web/src/app/globals.css

@@ -0,0 +1,26 @@
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}

apps/example-web/src/app/layout.tsx

@@ -0,0 +1,33 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "Create Next App",
+  description: "Generated by create next app",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html
+      lang="en"
+      className={`${geistSans.variable} ${geistMono.variable} h-full antialiased`}
+    >
+      <body className="min-h-full flex flex-col">{children}</body>
+    </html>
+  );
+}

apps/example-web/src/app/page.tsx

@@ -0,0 +1,65 @@
+import Image from "next/image";
+
+export default function Home() {
+  return (
+    <div className="flex flex-col flex-1 items-center justify-center bg-zinc-50 font-sans dark:bg-black">
+      <main className="flex flex-1 w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
+        <Image
+          className="dark:invert"
+          src="/next.svg"
+          alt="Next.js logo"
+          width={100}
+          height={20}
+          priority
+        />
+        <div className="flex flex-col items-center gap-6 text-center sm:items-start sm:text-left">
+          <h1 className="max-w-xs text-3xl font-semibold leading-10 tracking-tight text-black dark:text-zinc-50">
+            To get started, edit the page.tsx file.
+          </h1>
+          <p className="max-w-md text-lg leading-8 text-zinc-600 dark:text-zinc-400">
+            Looking for a starting point or more instructions? Head over to{" "}
+            <a
+              href="https://vercel.com/templates?framework=next.js&utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+              className="font-medium text-zinc-950 dark:text-zinc-50"
+            >
+              Templates
+            </a>{" "}
+            or the{" "}
+            <a
+              href="https://nextjs.org/learn?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+              className="font-medium text-zinc-950 dark:text-zinc-50"
+            >
+              Learning
+            </a>{" "}
+            center.
+          </p>
+        </div>
+        <div className="flex flex-col gap-4 text-base font-medium sm:flex-row">
+          <a
+            className="flex h-12 w-full items-center justify-center gap-2 rounded-full bg-foreground px-5 text-background transition-colors hover:bg-[#383838] dark:hover:bg-[#ccc] md:w-[158px]"
+            href="https://vercel.com/new?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            <Image
+              className="dark:invert"
+              src="/vercel.svg"
+              alt="Vercel logomark"
+              width={16}
+              height={16}
+            />
+            Deploy Now
+          </a>
+          <a
+            className="flex h-12 w-full items-center justify-center rounded-full border border-solid border-black/[.08] px-5 transition-colors hover:border-transparent hover:bg-black/[.04] dark:border-white/[.145] dark:hover:bg-[#1a1a1a] md:w-[158px]"
+            href="https://nextjs.org/docs?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            Documentation
+          </a>
+        </div>
+      </main>
+    </div>
+  );
+}

apps/example-web/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

apps/sample-website/docker-compose.yml

@@ -1,71 +0,0 @@
-services:
-  app:
-    build:
-      context: .
-      dockerfile: Dockerfile
-      args:
-        NEXT_PUBLIC_BASE_URL: ${NEXT_PUBLIC_BASE_URL:-http://localhost:3000}
-        NEXT_PUBLIC_UMAMI_WEBSITE_ID: ${NEXT_PUBLIC_UMAMI_WEBSITE_ID}
-        NEXT_PUBLIC_UMAMI_SCRIPT_URL: ${NEXT_PUBLIC_UMAMI_SCRIPT_URL}
-        NEXT_PUBLIC_TARGET: ${TARGET:-development}
-      DIRECTUS_URL: ${DIRECTUS_URL:-http://directus:8055}
-    restart: always
-    networks:
-      - infra
-    env_file:
-      - .env
-    ports:
-      - "3000:3000"
-    labels:
-      - "traefik.enable=true"
-      - "traefik.http.routers.sample-website.rule=Host(`${TRAEFIK_HOST:-sample-website.localhost}`)"
-      - "traefik.http.services.sample-website.loadbalancer.server.port=3000"
-
-  directus:
-    image: registry.infra.mintel.me/mintel/directus:latest
-    restart: always
-    networks:
-      - infra
-    env_file:
-      - .env
-    environment:
-      KEY: ${DIRECTUS_KEY:-mintel-key}
-      SECRET: ${DIRECTUS_SECRET:-mintel-secret}
-      ADMIN_EMAIL: ${DIRECTUS_ADMIN_EMAIL:-admin@mintel.me}
-      ADMIN_PASSWORD: ${DIRECTUS_ADMIN_PASSWORD:-mintel-admin}
-      DB_CLIENT: 'pg'
-      DB_HOST: 'directus-db'
-      DB_PORT: '5432'
-      DB_DATABASE: ${DIRECTUS_DB_NAME:-directus}
-      DB_USER: ${DIRECTUS_DB_USER:-directus}
-      DB_PASSWORD: ${DIRECTUS_DB_PASSWORD:-mintel-db-pass}
-      WEBSOCKETS_ENABLED: 'true'
-      PUBLIC_URL: ${DIRECTUS_URL:-http://localhost:8055}
-    ports:
-      - "8055:8055"
-    volumes:
-      - ./directus/uploads:/directus/uploads
-      - ./directus/extensions:/directus/extensions
-    labels:
-      - "traefik.enable=true"
-      - "traefik.http.routers.sample-website-directus.rule=Host(`${DIRECTUS_HOST:-cms.sample-website.localhost}`)"
-      - "traefik.http.services.sample-website-directus.loadbalancer.server.port=8055"
-
-  directus-db:
-    image: postgres:15-alpine
-    restart: always
-    networks:
-      - infra
-    environment:
-      POSTGRES_DB: ${DIRECTUS_DB_NAME:-directus}
-      POSTGRES_USER: ${DIRECTUS_DB_USER:-directus}
-      POSTGRES_PASSWORD: ${DIRECTUS_DB_PASSWORD:-mintel-db-pass}
-    volumes:
-      - directus-db-data:/var/lib/postgresql/data
-
-networks:
-  infra:
-    external: true
-
-volumes:
-  directus-db-data:

apps/sample-website/eslint.config.mjs

@@ -1,3 +0,0 @@
-import { nextConfig } from "@mintel/eslint-config/next";
-
-export default nextConfig;

apps/sample-website/next.config.ts

@@ -1,6 +1,8 @@
 import mintelNextConfig from "@mintel/next-config";
 
 /** @type {import('next').NextConfig} */
-const nextConfig = {};
+const nextConfig = {
+  transpilePackages: ["@mintel/ui"],
+};
 
 export default mintelNextConfig(nextConfig);

apps/sample-website/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sample-website",
-  "version": "0.1.1",
+  "version": "1.9.17",
   "private": true,
   "type": "module",
   "scripts": {
@@ -8,22 +8,18 @@
     "dev:local": "mintel dev --local",
     "build": "next build",
     "start": "next start",
-    "lint": "next lint",
+    "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
     "test": "vitest run --passWithNoTests",
-    "cms:bootstrap": "mintel directus bootstrap",
-    "cms:push:testing": "mintel directus sync push testing",
-    "cms:pull:testing": "mintel directus sync pull testing",
-    "cms:push:staging": "mintel directus sync push staging",
-    "cms:pull:staging": "mintel directus sync pull staging",
-    "cms:push:prod": "mintel directus sync push production",
     "cms:pull:prod": "mintel directus sync pull production",
     "pagespeed:test": "mintel pagespeed"
   },
   "dependencies": {
+    "@mintel/next-observability": "workspace:*",
     "@mintel/next-utils": "workspace:*",
-    "next": "15.1.6",
-    "next-intl": "^4.8.2",
+    "@mintel/observability": "workspace:*",
+    "@sentry/nextjs": "10.38.0",
+    "next": "16.1.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

apps/sample-website/sentry.client.config.ts

@@ -0,0 +1,9 @@
+import { initSentry } from "@mintel/next-observability";
+
+initSentry({
+  // Use a placeholder DSN on the client if you want to bypass ad-blockers via tunnel
+  // Or just use the real DSN if you don't care about ad-blockers for errors.
+  // The Mintel standard is to use the relay.
+  dsn: "https://public@errors.infra.mintel.me/1", // Placeholder for relay
+  tunnel: "/errors/api/relay",
+});

apps/sample-website/sentry.edge.config.ts

@@ -0,0 +1,8 @@
+import { initSentry } from "@mintel/next-observability";
+import { validateMintelEnv } from "@mintel/next-utils";
+
+const env = validateMintelEnv();
+
+initSentry({
+  dsn: env.SENTRY_DSN,
+});

apps/sample-website/sentry.server.config.ts

@@ -0,0 +1,8 @@
+import { initSentry } from "@mintel/next-observability";
+import { validateMintelEnv } from "@mintel/next-utils";
+
+const env = validateMintelEnv();
+
+initSentry({
+  dsn: env.SENTRY_DSN,
+});

apps/sample-website/src/app/errors/api/relay/route.ts

@@ -0,0 +1,6 @@
+import { createSentryRelayHandler } from "@mintel/next-observability";
+import { validateMintelEnv } from "@mintel/next-utils";
+
+export const POST = createSentryRelayHandler({
+  dsn: validateMintelEnv().SENTRY_DSN,
+});

apps/sample-website/src/app/layout.tsx

@@ -1,5 +1,11 @@
 import type { Metadata } from "next";
+import { Suspense } from "react";
 import "./globals.css";
+import {
+  AnalyticsContextProvider,
+  AnalyticsAutoTracker,
+} from "@mintel/next-observability/client";
+import { getAnalyticsConfig } from "@/lib/observability";
 
 export const metadata: Metadata = {
   title: "Sample Website",
@@ -11,9 +17,18 @@ export default function RootLayout({
 }: Readonly<{
   children: React.ReactNode;
 }>) {
+  const analyticsConfig = getAnalyticsConfig();
+
   return (
     <html lang="en">
-      <body>{children}</body>
+      <body>
+        <AnalyticsContextProvider config={analyticsConfig}>
+          <Suspense fallback={null}>
+            <AnalyticsAutoTracker />
+          </Suspense>
+          {children}
+        </AnalyticsContextProvider>
+      </body>
     </html>
   );
 }

apps/sample-website/src/app/stats/api/send/route.ts

@@ -0,0 +1,7 @@
+import { createUmamiProxyHandler } from "@mintel/next-observability";
+import { validateMintelEnv } from "@mintel/next-utils";
+
+export const POST = createUmamiProxyHandler({
+  websiteId: validateMintelEnv().UMAMI_WEBSITE_ID,
+  apiEndpoint: validateMintelEnv().UMAMI_API_ENDPOINT,
+});

apps/sample-website/src/instrumentation.ts

@@ -0,0 +1,13 @@
+import * as Sentry from "@sentry/nextjs";
+
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    await import("../sentry.server.config");
+  }
+
+  if (process.env.NEXT_RUNTIME === "edge") {
+    await import("../sentry.edge.config");
+  }
+}
+
+export const onRequestError = Sentry.captureRequestError;

apps/sample-website/src/lib/observability.ts

@@ -0,0 +1,54 @@
+import {
+  UmamiAnalyticsService,
+  GotifyNotificationService,
+  NoopNotificationService,
+} from "@mintel/observability";
+import { validateMintelEnv } from "@mintel/next-utils";
+
+let analyticsService: any = null;
+let notificationService: any = null;
+
+export function getAnalyticsConfig() {
+  const isClient = typeof window !== "undefined";
+
+  if (isClient) {
+    return {
+      enabled: true,
+      apiEndpoint: "/stats",
+    };
+  }
+
+  const env = validateMintelEnv();
+  return {
+    enabled: Boolean(env.UMAMI_WEBSITE_ID),
+    websiteId: env.UMAMI_WEBSITE_ID,
+    apiEndpoint: env.UMAMI_API_ENDPOINT,
+  };
+}
+
+export function getAnalyticsService() {
+  if (analyticsService) return analyticsService;
+
+  const config = getAnalyticsConfig();
+  analyticsService = new UmamiAnalyticsService(config);
+
+  return analyticsService;
+}
+
+export function getNotificationService() {
+  if (notificationService) return notificationService;
+
+  if (typeof window === "undefined") {
+    const env = validateMintelEnv();
+    notificationService = new GotifyNotificationService({
+      enabled: Boolean(env.GOTIFY_URL && env.GOTIFY_TOKEN),
+      url: env.GOTIFY_URL || "",
+      token: env.GOTIFY_TOKEN || "",
+    });
+  } else {
+    // Notifications are typically server-side only to protect tokens
+    notificationService = new NoopNotificationService();
+  }
+
+  return notificationService;
+}

blender-mv.sh

@@ -0,0 +1,177 @@
+#!/usr/bin/env bash
+# blender-mv: A smart file/directory mover that automatically updates Blender paths
+
+set -e
+
+print_usage() {
+    echo "Usage: blender-mv [OPTIONS] SOURCE DEST"
+    echo ""
+    echo "Options:"
+    echo "  --search-project <dir>    Scan this specific project directory for .blend files"
+    echo "                            to update (useful if you move an external asset folder,"
+    echo "                            and old .blend files referencing it are elsewhere)."
+    echo ""
+    echo "Example: blender-mv ./old_folder ./new_folder"
+}
+
+SEARCH_PROJECT=""
+
+# Parse arguments
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        --search-project) SEARCH_PROJECT="$2"; shift 2 ;;
+        -h|--help) print_usage; exit 0 ;;
+        *)
+            if [[ -z "$SOURCE" ]]; then
+                SOURCE="$1"
+            elif [[ -z "$DEST" ]]; then
+                DEST="$1"
+            else
+                echo "Unknown parameter passed: $1"
+                print_usage
+                exit 1
+            fi
+            shift
+            ;;
+    esac
+done
+
+if [[ -z "$SOURCE" || -z "$DEST" ]]; then
+    echo "Error: Both SOURCE and DEST must be provided."
+    print_usage
+    exit 1
+fi
+
+if [[ ! -e "$SOURCE" ]]; then
+    echo "Error: Source path '$SOURCE' does not exist."
+    exit 1
+fi
+
+# Function to get absolute normalized path (handles missing destination gracefully)
+get_abs_path() {
+    python3 -c 'import os,sys; print(os.path.normpath(os.path.abspath(sys.argv[1])))' "$1" 2>/dev/null
+}
+
+# Resolve source before moving
+ABS_SOURCE=$(get_abs_path "$SOURCE")
+
+# Determine resulting target path
+if [[ -d "$DEST" ]]; then
+    # If DEST is an existing dir, standard mv puts SOURCE inside it
+    BASENAME_SOURCE=$(basename "$SOURCE")
+    ABS_DEST=$(get_abs_path "$DEST/$BASENAME_SOURCE")
+else
+    # Placed exactly at DEST (rename or target dir doesn't exist yet)
+    ABS_DEST=$(get_abs_path "$DEST")
+fi
+
+echo "Moving: $SOURCE -> $DEST"
+mv "$SOURCE" "$DEST"
+
+echo "Replacing paths in Blender's recent-files lists..."
+# Find all recent-files.txt across Blender versions and replace the string
+find "$HOME/Library/Application Support/Blender" -type f -name "recent-files.txt" 2>/dev/null | while read -r RECENT_FILE; do
+    # Using sed with alternative delimiter to avoid path interference
+    sed -i '' "s|${ABS_SOURCE}|${ABS_DEST}|g" "$RECENT_FILE"
+done
+
+# Prepare the embedded Python payload to update blend paths
+TMP_PY=$(mktemp /tmp/blender_update_paths.XXXXXX.py)
+cat << 'EOF' > "$TMP_PY"
+import bpy
+import sys
+
+def replace_in_prop(prop, old_path, new_path):
+    if prop and isinstance(prop, str) and old_path in prop:
+        return prop.replace(old_path, new_path)
+    return prop
+
+def run():
+    # Args are passed after `--`
+    if '--' not in sys.argv:
+        return
+    idx = sys.argv.index('--')
+    if len(sys.argv) <= idx + 2:
+        return
+        
+    old_path = sys.argv[idx + 1]
+    new_path = sys.argv[idx + 2]
+    
+    changed = False
+    
+    # 1. Libraries (Linked objects/collections)
+    for lib in bpy.data.libraries:
+        new_fp = replace_in_prop(lib.filepath, old_path, new_path)
+        if new_fp != lib.filepath:
+            lib.filepath = new_fp
+            changed = True
+            
+    # 2. Images (Textures, Env Maps)
+    for img in bpy.data.images:
+        new_fp = replace_in_prop(img.filepath, old_path, new_path)
+        if new_fp != img.filepath:
+            img.filepath = new_fp
+            changed = True
+            
+    # 3. Cache files (Alembic/VDB)
+    for cache in bpy.data.cache_files:
+        new_fp = replace_in_prop(cache.filepath, old_path, new_path)
+        if new_fp != cache.filepath:
+            cache.filepath = new_fp
+            changed = True
+            
+    # 4. Fonts
+    for font in bpy.data.fonts:
+        new_fp = replace_in_prop(font.filepath, old_path, new_path)
+        if new_fp != font.filepath:
+            font.filepath = new_fp
+            changed = True
+            
+    # 5. Video strips
+    for scene in bpy.data.scenes:
+        if scene.sequence_editor:
+            for strip in scene.sequence_editor.sequences_all:
+                if strip.type in ('MOVIE', 'IMAGE'):
+                    new_fp = replace_in_prop(strip.filepath, old_path, new_path)
+                    if new_fp != strip.filepath:
+                        strip.filepath = new_fp
+                        changed = True
+
+    if changed:
+        print(f"[*] Updated paths in {bpy.data.filepath}")
+        bpy.ops.wm.save_mainfile()
+        
+try:
+    run()
+except Exception as e:
+    print(f"[!] Error updating blend file paths: {e}")
+EOF
+
+# Determine what to search for blend files
+if [[ -n "$SEARCH_PROJECT" ]]; then
+    SEARCH_ROOT=$(get_abs_path "$SEARCH_PROJECT")
+    echo "Scanning project root '$SEARCH_ROOT' for .blend files..."
+elif [[ -d "$ABS_DEST" ]]; then
+    SEARCH_ROOT="$ABS_DEST"
+    echo "Scanning moved directory for .blend files..."
+elif [[ "$ABS_DEST" == *.blend ]]; then
+    SEARCH_ROOT="$ABS_DEST"
+    echo "Updating moved .blend file..."
+else
+    echo "No project root defined and moved object is not a directory or .blend file."
+    echo "Finished."
+    rm -f "$TMP_PY"
+    exit 0
+fi
+
+# Execute headless blender on all found blend files
+if [[ -d "$SEARCH_ROOT" ]]; then
+    find "$SEARCH_ROOT" -type f -name "*.blend" -print0 | while IFS= read -r -d '' BLEND_FILE; do
+        blender -b "$BLEND_FILE" -P "$TMP_PY" -- "$ABS_SOURCE" "$ABS_DEST" >/dev/null 2>&1 || echo "Warning: Failed to process $BLEND_FILE"
+    done
+elif [[ -f "$SEARCH_ROOT" && "$SEARCH_ROOT" == *.blend ]]; then
+    blender -b "$SEARCH_ROOT" -P "$TMP_PY" -- "$ABS_SOURCE" "$ABS_DEST" >/dev/null 2>&1 || echo "Warning: Failed to process $SEARCH_ROOT"
+fi
+
+rm -f "$TMP_PY"
+echo "Success: Move complete and paths updated."

data/briefings/etib.txt

@@ -0,0 +1,246 @@
+Hallo Marc,
+ 
+eine harte Deadline gibt es nicht – Was denkst du ist realistisch? Ich habe als Ziel so
+April / Mai im Kopf -> dann aber schon zu 95 % fertig. Viele Grüße
+ 
+Mit freundlichen Grüßen
+ 
+Danny Joseph
+Geschäftsführer
+ 
+E-TIB GmbH
+Gewerbestraße 22
+D-03172 Guben
+ 
+Mobil    +49 15207230518
+E-Mail   d.joseph@e-tib.com
+Web      www.e-tib.com
+
+--------------------------------------------------------------------------------------------------
+
+Hey,
+ 
+ich würde wie bei https://www.schleicher-gruppe.de/ ein Video auf der Startseite
+haben wollen. Da ginge sicherlich was vom bisherigen Messevideo. Liebe Grüße.
+ 
+Mit freundlichen Grüßen
+ 
+Danny Joseph
+Geschäftsführer
+ 
+E-TIB GmbH
+Gewerbestraße 22
+D-03172 Guben
+ 
+Mobil    +49 15207230518
+E-Mail   d.joseph@e-tib.com
+Web      www.e-tib.com
+ 
+
+--------------------------------------------------------------------------------------------------
+Geschäftsführung: Danny Joseph
+Handelsregister: Amtsgericht Cottbus
+HRB: 12403 CB
+USt. ID-Nr.: DE304799919
+--------------------------------------------------------------------------------------------------
+ 
+Von: Frieder Helmich <f.helmich@etib-ing.com>
+Gesendet: Donnerstag, 29. Januar 2026 08:49
+An: Marc Mintel <marc@cablecreations.de>; Danny Joseph <d.joseph@e-tib.com>
+Betreff: AW: Homepage E-TIB
+ 
+Hi Marc,
+ 
+brauchst du nur Fotos oder bindest du auch videos ein? Wir haben sehr viel Videomaterial. Wir haben auch einen kleinen Film den wir auf der Messe laufen lassen haben.
+ 
+Mit freundlichen Grüßen
+ 
+i.A. Frieder Helmich
+ 
+E-TIB Ingenieurgesellschaft mbH
+Kampstraße 3
+D-27412 Bülstedt
+ 
+Tel         +49 4283 6979923
+Mobil     +49 173 6560514
+Fax        +49 4283 6084091
+ 
+E-Mail   f.helmich@etib-ing.com
+Web     www.etib-ing.com
+ 
+ETIB_Ing_logo_mk
+Datenschutzhinweise: www.etib-ing.com/datenschutz
+-----------------------------------------------------------------------------------------------
+Geschäftsführung: Julian Helmich
+Handelsregister: Amtsgericht Tostedt
+HRB: 207158
+-----------------------------------------------------------------------------------------------
+ 
+Von: Marc Mintel <marc@cablecreations.de>
+Gesendet: Mittwoch, 28. Januar 2026 18:10
+An: Danny Joseph <d.joseph@e-tib.com>
+Cc: Frieder Helmich <f.helmich@etib-ing.com>
+Betreff: Re: Homepage E-TIB
+ 
+Hallo Danny,
+ 
+Vielen Dank für die schnelle Rückmeldung.
+Wie gesprochen werde ich mir die Unterlagen und Webseiten im Detail anschauen und mich dann noch einmal bei dir melden.
+ 
+Gibt es eigentlich eine Deadline oder einen zeitlichen Rahmen, wo ihr mit der neuen Webseite rechnen möchtet?
+Je nach dem könnte man auch Features priorisieren, so dass der Kern der Seite schnellstmöglich modernisiert online geht und der Rest im Nachgang.
+ 
+Das Foto-Material würde ich auch gerne sichten, dann kann man schon sehen, wie viel sich damit arbeiten lässt.
+ 
+Viele Grüße
+ 
+ 
+From: Danny Joseph <d.joseph@e-tib.com>
+Organization: E-TIB GmbH
+Date: Wednesday, 28. January 2026 at 16:16
+To: Marc Mintel <marc@cablecreations.de>
+Cc: 'Frieder Helmich' <f.helmich@etib-ing.com>
+Subject: Homepage E-TIB
+ 
+Hallo Marc,
+ 
+wie telefonisch besprochen erste wirre Gedanken:
+ 
+Wir möchten eine minimalistische, hochwertige Homepage die sowohl am PV, als auch
+Auf Smartphone / Tablet etc. vernünftig ausschaut.
+ 
+Bisher war unser Aufhänger:
+DIE EXPERTEN FÜR KABELTIEFBAU …
+ 
+Alles nur Ideen: …
+ 
+# Schaltflächen ähnlich: https://www.schleicher-gruppe.de/
+ 
+E-TIB GmbH
+E-TIB Verwaltung GmbH
+E-TIB Ingenieurgesellschaft mbH
+E-TIB Bohrtechnik GmbH
+ 
+# Schaltflächen ähnlich: https://www.schleicher-gruppe.de/
+(ehemals Kompetenzen www.e-tib.com)
+ 
+Kabelbau
+Kabelpflugarbeiten
+Horizontalspülbohrungen
+Elektromontagen bis 110 kV
+Glasfaser-Kabelmontagen
+Wartung & Störungsdienst
+Genehmigungs- und Ausführungsplanung
+Komplexe Querung (Bahn, Autobahn, Gewässer)
+Elektro- und Netzanschlussplanung
+Vermessung & Dokumentation
+ 
+Input für Über uns: Grid … Timeline?
+Gründung E-TIB GmbH: 16.12.2015
+Kabelbau
+Kabelpflugarbeiten
+Horizontalspülbohrungen
+Elektromontagen bis 110 kV
+Glasfaser-Kabelmontagen
+Wartung & Störungsdienst
+Elektro- und Netzanschlussplanung
+Vermessung & Dokumentation
+ 
+Gründung E-TIB Verwaltung GmbH: 14.11.2019
+Der Erwerb, die Vermietung, Verpachtung und Verwaltung
+von Immobilien, Grundstücken, Maschinen und Geräten.
+ 
+Gründung E-TIB Ingenieurgesellschaft mbH: 04.02.2019
+Genehmigungs- und Ausführungsplanung
+Komplexe Querung (Bahn, Autobahn, Gewässer)
+Elektro- und Netzanschlussplanung
+ 
+Gründung E-TIB Bohrtechnik GmbH: 21.10.2025
+Horizontalspülbohrungen in allen Bodenklassen
+ 
+Gruppen‑Kacheln (Beispieltexte) ...
+ 
+E‑TIB GmbH – Ausführung elektrischer Infrastrukturprojekte
+E‑TIB Bohrtechnik GmbH – Präzise Horizontalbohrungen in allen Bodenklassen
+E‑TIB Verwaltung GmbH – Zentrale Dienste, Einkauf, Finanzen
+E‑TIB Ingenieurgesellschaft mbH – Planung, Projektierung, Dokumentation
+ 
+Kontaktseite siehe: www.e-tib.com
+ 
+Karriere: ...
+ 
+Messen: wo wir dieses Jahr einen Stand haben: Intersolar München, Windenergietage Linstow, Kabelwerkstatt Wiesbaden
+ 
+Referenzen: … müsste ich dir zur Verfügung stellen
+ 
+Pflichtseiten
+Impressum (vollständig, Verantwortliche, Registernummer, USt‑ID).
+Datenschutz (Verarbeitungen, Rechtsgrundlagen, AVV, Cookie‑Gruppen, Löschfristen, Rechte).
+Cookie‑Einstellungen (Consent Manager: ...)
+ 
+www.e-tib.com
+www.etib-ing.com
+ 
+Hier mein instagram account:
+me.and.eloise
+Verstehst du mich vielleicht ein kleines Stück mehr…
+ 
+Unser Frieder Helmich kann erstes Foto-/Videomaterial zur Verfügung stellen:
+f.helmich@etib-ing.com
+ 
+Lass mir mal eine Idee vom Stundenaufwand / Kosten pro Stunde für Erstellung zukommen,
+damit wir eine Vertragsgrundlage haben. Danach lass uns loslegen.
+ 
+Besten Dank dir.
+ 
+Mit freundlichen Grüßen
+ 
+Danny Joseph
+Geschäftsführer
+ 
+E-TIB GmbH
+Gewerbestraße 22
+D-03172 Guben
+ 
+Mobil    +49 15207230518
+E-Mail   d.joseph@e-tib.com
+Web      www.e-tib.com
+ 
+
+--------------------------------------------------------------------------------------------------
+Geschäftsführung: Danny Joseph
+Handelsregister: Amtsgericht Cottbus
+HRB: 12403 CB
+USt. ID-Nr.: DE304799919
+--------------------------------------------------------------------------------------------------
+ 
+Von: Marc Mintel <marc@cablecreations.de>
+Gesendet: Donnerstag, 13. November 2025 16:30
+An: d.joseph@e-tib.com
+Betreff: Homepage
+ 
+Hi Danny,
+ 
+mein Vater meinte, ich könnte mich mal bei dir melden, weil ihr jemanden für eure Website sucht.
+ 
+Kurz zu mir: Ich habe über 10 Jahre in der Webentwicklung gearbeitet. Inzwischen liegt mein Schwerpunkt zwar im 3D-Bereich (u. a. cablecreations.de), aber ich betreue weiterhin Websites für Firmen, die das Ganze unkompliziert abgegeben haben möchten. Unter anderem betreue ich auch die Seite von KLZ (klz-cables.com). Der Ablauf ist bei mir recht einfach: Wenn ihr etwas braucht, reicht in der Regel eine kurze Mail – Anpassungen, Inhalte oder technische Themen erledige ich dann im Hintergrund. Dadurch spart ihr euch Schulungen, Zugänge oder lange Meetings, wie man sie oft mit Agenturen hat.
+ 
+Wichtig ist: Eine Website braucht auch nach dem Aufbau regelmäßige Pflege, damit Technik und Sicherheit sauber laufen – das übernehme ich dann ebenfalls, damit ihr im Alltag keinen Aufwand damit habt.
+ 
+Um einschätzen zu können, ob und wie ich euch unterstützen kann, wäre es gut zu wissen, was ihr mit der Website vorhabt und was an der aktuellen Seite nicht mehr passt. Wenn du magst, können wir dazu auch kurz telefonieren.
+ 
+Viele Grüße 
+Marc
+ 
+Marc Mintel
+Founder & 3D Artist
+marc@cablecreations.de
+ 
+Cable Creations
+www.cablecreations.de
+info@cablecreations.de
+VAT: DE367588065
+ 
+Georg-Meistermann-Straße 7
+54586 Schüller
+Germany

docker-compose.gatekeeper.yml

@@ -0,0 +1,39 @@
+services:
+  gatekeeper-proxy:
+    image: alpine:latest
+    command: sleep infinity
+    restart: unless-stopped
+    networks:
+      - infra
+    labels:
+      - "caddy=http://gatekeeper.localhost"
+      - "caddy.route=/*"
+      - "caddy.route.0_redir=/ /gatekeeper/login 302"
+      - "caddy.route.1_reverse_proxy=gatekeeper-app:3000"
+
+  gatekeeper-app:
+    image: node:20-alpine
+    working_dir: /app
+    volumes:
+      - .:/app
+      - gatekeeper_root_node_modules:/app/node_modules
+      - gatekeeper_pkg_node_modules:/app/packages/gatekeeper/node_modules
+      - gatekeeper_next_cache:/app/packages/gatekeeper/.next
+      - gatekeeper_pnpm_store:/pnpm
+    environment:
+      - NODE_ENV=development
+      - NPM_TOKEN=${NPM_TOKEN:-}
+    networks:
+      - infra
+    command: >
+      sh -c "corepack enable && pnpm config set store-dir /pnpm && pnpm install --no-frozen-lockfile && pnpm --filter @mintel/gatekeeper run dev --hostname 0.0.0.0 --port 3000"
+
+networks:
+  infra:
+    external: true
+
+volumes:
+  gatekeeper_root_node_modules:
+  gatekeeper_pkg_node_modules:
+  gatekeeper_next_cache:
+  gatekeeper_pnpm_store:

docker-compose.mcps.yml

@@ -0,0 +1,90 @@
+services:
+  qdrant:
+    image: qdrant/qdrant:latest
+    container_name: qdrant-mcp
+    ports:
+      - "6335:6333"
+      - "6336:6334"
+    volumes:
+      - ./data/qdrant:/qdrant/storage
+    restart: unless-stopped
+    networks:
+      - mcp-network
+
+  gitea-mcp:
+    build:
+      context: ./packages/gitea-mcp
+    container_name: gitea-mcp
+    env_file:
+      - .env
+    ports:
+      - "3011:3001"
+    restart: unless-stopped
+    networks:
+      - mcp-network
+
+  memory-mcp:
+    build:
+      context: ./packages/memory-mcp
+    container_name: memory-mcp
+    env_file:
+      - .env
+    ports:
+      - "3002:3002"
+    depends_on:
+      - qdrant
+    restart: unless-stopped
+    networks:
+      - mcp-network
+
+  umami-mcp:
+    build:
+      context: ./packages/umami-mcp
+    container_name: umami-mcp
+    env_file:
+      - .env
+    ports:
+      - "3003:3003"
+    restart: unless-stopped
+    networks:
+      - mcp-network
+
+  serpbear-mcp:
+    build:
+      context: ./packages/serpbear-mcp
+    container_name: serpbear-mcp
+    env_file:
+      - .env
+    ports:
+      - "3004:3004"
+    restart: unless-stopped
+    networks:
+      - mcp-network
+
+  glitchtip-mcp:
+    build:
+      context: ./packages/glitchtip-mcp
+    container_name: glitchtip-mcp
+    env_file:
+      - .env
+    ports:
+      - "3005:3005"
+    restart: unless-stopped
+    networks:
+      - mcp-network
+
+  klz-payload-mcp:
+    build:
+      context: ./packages/klz-payload-mcp
+    container_name: klz-payload-mcp
+    env_file:
+      - .env
+    ports:
+      - "3006:3006"
+    restart: unless-stopped
+    networks:
+      - mcp-network
+
+networks:
+  mcp-network:
+    driver: bridge

docker-compose.yml

@@ -0,0 +1,64 @@
+services:
+  app:
+    build:
+      context: ./apps/sample-website
+      dockerfile: Dockerfile
+      args:
+        NEXT_PUBLIC_BASE_URL: ${NEXT_PUBLIC_BASE_URL:-http://localhost:3000}
+        NEXT_PUBLIC_UMAMI_WEBSITE_ID: ${NEXT_PUBLIC_UMAMI_WEBSITE_ID}
+        NEXT_PUBLIC_UMAMI_SCRIPT_URL: ${NEXT_PUBLIC_UMAMI_SCRIPT_URL}
+        NEXT_PUBLIC_TARGET: ${TARGET:-development}
+    restart: always
+    networks:
+      - infra
+    env_file:
+      - .env
+    ports:
+      - "3000:3000"
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.sample-website.rule=Host(`${TRAEFIK_HOST:-sample-website.localhost}`)"
+      - "traefik.http.services.sample-website.loadbalancer.server.port=3000"
+      - "caddy=http://${TRAEFIK_HOST:-acquisition.localhost}"
+      - "caddy.reverse_proxy={{upstreams 3000}}"
+
+  at-mintel-ui:
+    image: node:22-alpine
+    working_dir: /app
+    volumes:
+      - .:/app
+      - ui_pnpm_store:/pnpm
+    environment:
+      - CI=true
+    networks:
+      - infra
+    restart: unless-stopped
+    command: >
+      sh -c "corepack enable && pnpm config set store-dir /pnpm && pnpm install --no-frozen-lockfile --ignore-scripts || true; echo 'Starting ladle...'; pnpm --filter @mintel/ui exec ladle serve --host 0.0.0.0 --port 61000"
+    labels:
+      - "caddy=http://ui.localhost"
+      - "caddy.reverse_proxy={{upstreams 61000}}"
+
+  at-mintel-video:
+    image: node:22-alpine
+    working_dir: /app
+    volumes:
+      - .:/app
+      - ui_pnpm_store:/pnpm
+    environment:
+      - CI=true
+    networks:
+      - infra
+    restart: unless-stopped
+    command: >
+      sh -c "corepack enable && pnpm config set store-dir /pnpm && pnpm install --no-frozen-lockfile --ignore-scripts || true; pnpm --filter @mintel/example-video exec remotion studio --host 0.0.0.0 --port 3001"
+    labels:
+      - "caddy=http://video.localhost"
+      - "caddy.reverse_proxy={{upstreams 3001}}"
+
+networks:
+  infra:
+    external: true
+
+volumes:
+  ui_pnpm_store:

eslint-errors-2.txt

@@ -0,0 +1,69 @@
+
+/Users/marcmintel/Projects/at-mintel/packages/gitea-mcp/src/index.ts
+  11:0  error  Parsing error: Identifier expected
+
+/Users/marcmintel/Projects/at-mintel/packages/glitchtip-mcp/src/index.ts
+  124:19  warning  'res' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/klz-payload-mcp/src/index.ts
+  39:18  warning  'e' is defined but never used. Allowed unused caught errors must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/memory-mcp/src/qdrant.test.ts
+  7:52  warning  'text' is defined but never used. Allowed unused args must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/page-audit/src/report.ts
+  7:47  warning  'PageAuditData' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+  7:62  warning  'AuditIssue' is defined but never used. Allowed unused vars must match /^_/u     @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/FieldGenerators/AiFieldButton.tsx
+  11:13  warning  'value' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/FieldGenerators/GenerateSlugButton.tsx
+  20:21  warning  'replaceState' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+  21:13  warning  'value' is assigned a value but never used. Allowed unused vars must match /^_/u         @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/FieldGenerators/GenerateThumbnailButton.tsx
+  21:13  warning  'value' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/OptimizeButton.tsx
+  5:10  warning  'Button' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/tools/mcpAdapter.ts
+  44:15  warning  'toolSchema' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/tools/memoryDb.ts
+  89:31  warning  'query' is defined but never used. Allowed unused args must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/tools/payloadLocal.ts
+  3:40  warning  'User' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/types.ts
+  1:15  warning  'Plugin' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/ConceptPDF.tsx
+  4:18  warning  'PDFPage' is defined but never used. Allowed unused vars must match /^_/u    @typescript-eslint/no-unused-vars
+  5:10  warning  'pdfStyles' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/EstimationPDF.tsx
+   4:18  warning  'PDFPage' is defined but never used. Allowed unused vars must match /^_/u              @typescript-eslint/no-unused-vars
+   5:10  warning  'pdfStyles' is defined but never used. Allowed unused vars must match /^_/u            @typescript-eslint/no-unused-vars
+  54:11  warning  'getPageNum' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/InfoPDF.tsx
+   5:13  warning  'PDFPage' is defined but never used. Allowed unused vars must match /^_/u    @typescript-eslint/no-unused-vars
+  12:5   warning  'pdfStyles' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/pdf/SharedUI.tsx
+  528:5  warning  'bankData' is defined but never used. Allowed unused args must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/pdf/SimpleLayout.tsx
+  4:52  warning  'PDFText' is defined but never used. Allowed unused vars must match /^_/u    @typescript-eslint/no-unused-vars
+  5:26  warning  'pdfStyles' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/seo-engine/src/report.ts
+  5:3  warning  'TopicCluster' is defined but never used. Allowed unused vars must match /^_/u       @typescript-eslint/no-unused-vars
+  6:3  warning  'ContentGap' is defined but never used. Allowed unused vars must match /^_/u         @typescript-eslint/no-unused-vars
+  7:3  warning  'CompetitorRanking' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+✖ 28 problems (1 error, 27 warnings)
+

eslint-errors.txt

@@ -0,0 +1,97 @@
+
+/Users/marcmintel/Projects/at-mintel/packages/gitea-mcp/src/index.ts
+   12:5   warning  'Resource' is defined but never used. Allowed unused vars must match /^_/u    @typescript-eslint/no-unused-vars
+   14:10  warning  'z' is defined but never used. Allowed unused vars must match /^_/u           @typescript-eslint/no-unused-vars
+  427:30  warning  'e' is defined but never used. Allowed unused caught errors must match /^_/u  @typescript-eslint/no-unused-vars
+  745:50  error    Unnecessary escape character: \/                                              no-useless-escape
+  745:60  error    Unnecessary escape character: \/                                              no-useless-escape
+  799:54  error    Unnecessary escape character: \/                                              no-useless-escape
+  799:64  error    Unnecessary escape character: \/                                              no-useless-escape
+
+/Users/marcmintel/Projects/at-mintel/packages/glitchtip-mcp/src/index.ts
+  124:19  warning  'res' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/klz-payload-mcp/src/index.ts
+  39:18  warning  'e' is defined but never used. Allowed unused caught errors must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/memory-mcp/src/qdrant.test.ts
+  7:52  warning  'text' is defined but never used. Allowed unused args must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/page-audit/src/report.ts
+  7:47  warning  'PageAuditData' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+  7:62  warning  'AuditIssue' is defined but never used. Allowed unused vars must match /^_/u     @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/chatPlugin.ts
+   1:15  warning  'Config' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+  10:17  error    'config' is never reassigned. Use 'const' instead                         prefer-const
+  48:37  warning  'req' is defined but never used. Allowed unused args must match /^_/u     @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/ChatWindow/index.tsx
+  43:5   error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+  44:63  warning  'setMessages' is assigned a value but never used. Allowed unused vars must match /^_/u                               @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/FieldGenerators/AiFieldButton.tsx
+  11:13  warning  'value' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/FieldGenerators/GenerateSlugButton.tsx
+  20:21  warning  'replaceState' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+  21:13  warning  'value' is assigned a value but never used. Allowed unused vars must match /^_/u         @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/FieldGenerators/GenerateThumbnailButton.tsx
+  21:13  warning  'value' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/components/OptimizeButton.tsx
+  5:10  warning  'Button' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/endpoints/chatEndpoint.ts
+   96:13  error  Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+  100:13  error  Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/tools/mcpAdapter.ts
+  44:15  warning  'toolSchema' is assigned a value but never used. Allowed unused vars must match /^_/u                                @typescript-eslint/no-unused-vars
+  53:13  error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/tools/memoryDb.ts
+  50:13  error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+  88:13  error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+  89:31  warning  'query' is defined but never used. Allowed unused args must match /^_/u                                              @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/tools/payloadLocal.ts
+   3:40  warning  'User' is defined but never used. Allowed unused vars must match /^_/u                                               @typescript-eslint/no-unused-vars
+  25:13  error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+  45:13  error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+  61:13  error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+  78:13  error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+  95:13  error    Use "@ts-expect-error" instead of "@ts-ignore", as "@ts-ignore" will do nothing if the following line is error-free  @typescript-eslint/ban-ts-comment
+
+/Users/marcmintel/Projects/at-mintel/packages/payload-ai/src/types.ts
+  1:15  warning  'Plugin' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/ConceptPDF.tsx
+  4:18  warning  'PDFPage' is defined but never used. Allowed unused vars must match /^_/u    @typescript-eslint/no-unused-vars
+  5:10  warning  'pdfStyles' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/EstimationPDF.tsx
+   4:18  warning  'PDFPage' is defined but never used. Allowed unused vars must match /^_/u              @typescript-eslint/no-unused-vars
+   5:10  warning  'pdfStyles' is defined but never used. Allowed unused vars must match /^_/u            @typescript-eslint/no-unused-vars
+  54:11  warning  'getPageNum' is assigned a value but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/InfoPDF.tsx
+   5:13  warning  'PDFPage' is defined but never used. Allowed unused vars must match /^_/u    @typescript-eslint/no-unused-vars
+  12:5   warning  'pdfStyles' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/pdf/SharedUI.tsx
+  528:5  warning  'bankData' is defined but never used. Allowed unused args must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/pdf-library/src/components/pdf/SimpleLayout.tsx
+  4:52  warning  'PDFText' is defined but never used. Allowed unused vars must match /^_/u    @typescript-eslint/no-unused-vars
+  5:26  warning  'pdfStyles' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+/Users/marcmintel/Projects/at-mintel/packages/seo-engine/src/report.ts
+  5:3  warning  'TopicCluster' is defined but never used. Allowed unused vars must match /^_/u       @typescript-eslint/no-unused-vars
+  6:3  warning  'ContentGap' is defined but never used. Allowed unused vars must match /^_/u         @typescript-eslint/no-unused-vars
+  7:3  warning  'CompetitorRanking' is defined but never used. Allowed unused vars must match /^_/u  @typescript-eslint/no-unused-vars
+
+✖ 49 problems (16 errors, 33 warnings)
+  1 error and 0 warnings potentially fixable with the `--fix` option.
+

eslint.config.js

@@ -1,3 +1,26 @@
+import baseConfig from "@mintel/eslint-config";
 import { nextConfig } from "@mintel/eslint-config/next";
 
-export default nextConfig;
+export default [
+  {
+    ignores: [
+      "packages/cms-infra/extensions/**",
+      "**/index.js",
+      "**/*.db",
+      "**/build/**",
+      "**/data/**",
+      "**/reference/**",
+      "**/dist/**",
+      "**/.next/**",
+    ],
+  },
+  ...baseConfig,
+  ...nextConfig.map((config) => ({
+    ...config,
+    files: [
+      "apps/sample-website/**/*.{ts,tsx}",
+      "packages/gatekeeper/**/*.{ts,tsx}",
+      "../klz-2026/**/*.{ts,tsx}",
+    ],
+  })),
+];

fix-private.mjs

@@ -0,0 +1,12 @@
+import fs from 'fs';
+import glob from 'glob';
+
+const files = glob.sync('/Users/marcmintel/Projects/at-mintel/packages/*/package.json');
+files.forEach(f => {
+    const content = fs.readFileSync(f, 'utf8');
+    if (content.includes('"private": true,')) {
+        console.log(`Fixing ${f}`);
+        const newContent = content.replace(/\s*"private": true,?\n/g, '\n');
+        fs.writeFileSync(f, newContent);
+    }
+});

models/tiny_face_detector_model-shard1

@@ -0,0 +1 @@
+404: Not Found

models/tiny_face_detector_model-weights_manifest.json

@@ -0,0 +1,30 @@
+[
+  {
+      "weights":
+      [
+          {"name":"conv0/filters","shape":[3,3,3,16],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.009007044399485869,"min":-1.2069439495311063}},
+          {"name":"conv0/bias","shape":[16],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.005263455241334205,"min":-0.9211046672334858}},
+          {"name":"conv1/depthwise_filter","shape":[3,3,16,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.004001977630690033,"min":-0.5042491814669441}},
+          {"name":"conv1/pointwise_filter","shape":[1,1,16,32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.013836609615999109,"min":-1.411334180831909}},
+          {"name":"conv1/bias","shape":[32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0015159862590771096,"min":-0.30926119685173037}},
+          {"name":"conv2/depthwise_filter","shape":[3,3,32,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.002666276225856706,"min":-0.317286870876948}},
+          {"name":"conv2/pointwise_filter","shape":[1,1,32,64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.015265831292844286,"min":-1.6792414422128714}},
+          {"name":"conv2/bias","shape":[64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0020280554598453,"min":-0.37113414915168985}},
+          {"name":"conv3/depthwise_filter","shape":[3,3,64,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.006100742489683862,"min":-0.8907084034938438}},
+          {"name":"conv3/pointwise_filter","shape":[1,1,64,128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.016276211832083907,"min":-2.0508026908425725}},
+          {"name":"conv3/bias","shape":[128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.003394414279975143,"min":-0.7637432129944072}},
+          {"name":"conv4/depthwise_filter","shape":[3,3,128,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.006716050119961009,"min":-0.8059260143953211}},
+          {"name":"conv4/pointwise_filter","shape":[1,1,128,256],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.021875603993733724,"min":-2.8875797271728514}},
+          {"name":"conv4/bias","shape":[256],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0041141652009066415,"min":-0.8187188749804216}},
+          {"name":"conv5/depthwise_filter","shape":[3,3,256,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.008423839597141042,"min":-0.9013508368940915}},
+          {"name":"conv5/pointwise_filter","shape":[1,1,256,512],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.030007277283014035,"min":-3.8709387695088107}},
+          {"name":"conv5/bias","shape":[512],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.008402082966823203,"min":-1.4871686851277068}},
+          {"name":"conv8/filters","shape":[1,1,512,25],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.028336129469030042,"min":-4.675461362389957}},
+          {"name":"conv8/bias","shape":[25],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.002268134028303857,"min":-0.41053225912299807}}
+      ],
+      "paths":
+      [
+          "tiny_face_detector_model.bin"
+      ]
+  }
+]

optimize-images.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+# Ghost Image Optimizer
+# Target directory for Ghost content
+TARGET_DIR="/home/deploy/sites/marisas.world/content/images"
+
+echo "Starting image optimization for $TARGET_DIR..."
+
+# Find all original images, excluding the 'size/' directory where Ghost stores thumbnails
+# Resize images larger than 2500px down to 2500px width
+# Compress JPEG/PNG to 80% quality
+find "$TARGET_DIR" -type d -name "size" -prune -o \( -iname "*.jpg" -o -iname "*.jpeg" -o -iname "*.png" \) -type f -exec mogrify -resize '2500x>' -quality 80 {} +
+
+echo "Optimization complete."

package.json

@@ -5,11 +5,19 @@
   "scripts": {
     "build": "pnpm -r build",
     "dev": "pnpm -r dev",
-    "lint": "pnpm -r lint",
+    "dev:gatekeeper": "bash -c 'trap \"COMPOSE_PROJECT_NAME=gatekeeper docker-compose -f docker-compose.gatekeeper.yml down\" EXIT INT TERM; docker network create infra 2>/dev/null || true && COMPOSE_PROJECT_NAME=gatekeeper docker-compose -f docker-compose.gatekeeper.yml down && COMPOSE_PROJECT_NAME=gatekeeper docker-compose -f docker-compose.gatekeeper.yml up --build --remove-orphans'",
+    "dev:mcps:up": "docker-compose -f docker-compose.mcps.yml up -d --build --remove-orphans",
+    "dev:mcps:down": "docker-compose -f docker-compose.mcps.yml down",
+    "dev:mcps:watch": "pnpm -r --filter=\"./packages/*-mcp\" exec tsc -w",
+    "dev:mcps": "npm run dev:mcps:up && npm run dev:mcps:watch",
+    "start:mcps": "npm run dev:mcps:up",
+    "start:mcps:force": "docker-compose -f docker-compose.mcps.yml up -d --build --force-recreate --remove-orphans",
+    "lint": "pnpm -r --filter='./packages/**' --filter='./apps/**' lint",
     "test": "pnpm -r test",
     "changeset": "changeset",
     "version-packages": "changeset version",
-    "sync-versions": "tsx scripts/sync-versions.ts",
+    "sync-versions": "tsx scripts/sync-versions.ts --",
+    "release:version": "bash scripts/release.sh",
     "release": "pnpm build && changeset publish",
     "release:tag": "pnpm build && pnpm -r publish --no-git-checks --access public",
     "prepare": "husky"
@@ -20,23 +28,51 @@
     "@commitlint/config-conventional": "^20.4.0",
     "@mintel/eslint-config": "workspace:*",
     "@mintel/husky-config": "workspace:*",
+    "@next/eslint-plugin-next": "16.1.6",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
+    "@types/node": "^20.17.16",
     "@types/react": "^19.2.10",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.2",
     "eslint": "^9.39.2",
-    "eslint-plugin-next": "^0.0.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.0.1",
     "happy-dom": "^20.4.0",
     "husky": "^9.1.7",
     "jsdom": "^27.4.0",
     "lint-staged": "^16.2.7",
+    "pm2": "^6.0.14",
     "prettier": "^3.8.1",
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "typescript-eslint": "^8.54.0",
     "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "globals": "^17.3.0",
+    "import-in-the-middle": "^3.0.0",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "require-in-the-middle": "^8.0.1"
+  },
+  "version": "1.9.17",
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@parcel/watcher",
+      "@sentry/cli",
+      "@swc/core",
+      "@tensorflow/tfjs-node",
+      "canvas",
+      "core-js",
+      "esbuild",
+      "sharp",
+      "unrs-resolver",
+      "vue-demi"
+    ],
+    "overrides": {
+      "next": "16.1.6",
+      "@sentry/nextjs": "10.38.0"
+    }
   }
-}
+}

packages/cli/README.md

@@ -4,10 +4,30 @@ The Mintel CLI is the primary automation tool for managing the monorepo and ensu
 
 ## 🚀 Installation
 
-The CLI is intended to be used within the monorepo:
+### Using npx (Recommended)
+
+Run the CLI without installing it globally. This always uses the latest version from the registry:
 
 ```bash
-pnpm install
+npx @mintel/cli init apps/my-new-website.com
+```
+
+### Global Installation
+
+Install the CLI globally from the Mintel registry:
+
+```bash
+npm install -g @mintel/cli
+```
+
+### Development (Local Link)
+
+If you are contributing to the CLI, you can link it locally:
+
+```bash
+cd packages/cli
+pnpm build
+npm link
 ```
 
 ## 🛠 Commands
@@ -17,10 +37,11 @@ pnpm install
 Scaffolds a new, production-ready client website in the specified path.
 
 ```bash
-pnpm --filter @mintel/cli start init apps/my-new-website.com
+mintel init apps/my-new-website.com
 ```
 
 #### What it does:
+
 1.  **Project Structure**: Creates a modern Next.js directory layout.
 2.  **Shared Configs**: Generates `package.json`, `tsconfig.json`, and `eslint.config.mjs` that extend the `@mintel` shared packages.
 3.  **Localization**: Sets up a localized routing structure (`src/app/[locale]`) with `next-intl` pre-configured.

packages/cli/package.json

@@ -1,31 +1,34 @@
 {
   "name": "@mintel/cli",
-  "version": "1.0.1",
+  "version": "1.9.17",
   "publishConfig": {
     "access": "public",
-    "registry": "https://npm.infra.mintel.me"
+    "registry": "https://git.infra.mintel.me/api/packages/mmintel/npm"
   },
   "type": "module",
   "bin": {
     "mintel": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --target es2020",
+    "build": "tsup",
     "start": "node dist/index.js",
     "dev": "tsup src/index.ts --format esm --watch --target es2020",
     "test": "vitest run"
   },
   "dependencies": {
-    "commander": "^11.0.0",
-    "fs-extra": "^11.1.0",
     "chalk": "^5.3.0",
-    "prompts": "^2.4.2"
+    "commander": "^11.0.0",
+    "fs-extra": "^11.1.0"
   },
   "devDependencies": {
-    "tsup": "^8.0.0",
-    "typescript": "^5.0.0",
+    "@mintel/tsconfig": "workspace:*",
     "@types/fs-extra": "^11.0.0",
     "@types/prompts": "^2.4.4",
-    "@mintel/tsconfig": "workspace:*"
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://git.infra.mintel.me/mmintel/at-mintel.git"
   }
 }

packages/cli/src/index.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { Command } from "commander";
 import fs from "fs-extra";
 import path from "path";
@@ -24,52 +25,24 @@ program
       console.log(chalk.cyan("Running Next.js locally..."));
       execSync("next dev", { stdio: "inherit" });
     } else {
-      console.log(chalk.cyan("Starting Docker stack (App, Directus, DB)..."));
-      // Ensure network exists
       try {
-        execSync("docker network create infra", { stdio: "ignore" });
-      } catch (e) {}
+        console.log(chalk.cyan("Starting Docker stack (App, Directus, DB)..."));
+        // Ensure network exists
+      } catch (_e) {
+        // Network already exists or docker is not running
+      }
+    }
 
-      console.log(
-        chalk.yellow(`
+    console.log(
+      chalk.yellow(`
 📱 App:      http://localhost:3000
-🗄️  CMS:      http://localhost:8055/admin
 🚦 Traefik:  http://localhost:8080
 `),
-      );
-      execSync(
-        "docker-compose down --remove-orphans && docker-compose up app directus directus-db",
-        { stdio: "inherit" },
-      );
-    }
-  });
-
-const directus = program
-  .command("directus")
-  .description("Directus management commands");
-
-directus
-  .command("bootstrap")
-  .description("Setup Directus branding and settings")
-  .action(async () => {
-    const { execSync } = await import("child_process");
-    console.log(chalk.blue("🎨 Bootstrapping Directus..."));
-    execSync("npx tsx --env-file=.env scripts/setup-directus.ts", {
-      stdio: "inherit",
-    });
-  });
-
-directus
-  .command("sync <action> <env>")
-  .description("Sync Directus data (push/pull) for a specific environment")
-  .action(async (action, env) => {
-    const { execSync } = await import("child_process");
-    console.log(
-      chalk.blue(`📥 Executing Directus sync: ${action} -> ${env}...`),
     );
-    execSync(`./scripts/sync-directus.sh ${action} ${env}`, {
-      stdio: "inherit",
-    });
+    execSync(
+      "docker compose down --remove-orphans && docker compose up -d app",
+      { stdio: "inherit" },
+    );
   });
 
 program
@@ -87,7 +60,7 @@ program
   .action(async (projectPath) => {
     const fullPath = path.isAbsolute(projectPath)
       ? projectPath
-      : path.resolve(process.cwd(), "../../", projectPath);
+      : path.resolve(process.cwd(), projectPath);
     const projectName = path.basename(fullPath);
 
     console.log(chalk.blue(`Initializing new project: ${projectName}...`));
@@ -110,21 +83,14 @@ program
           lint: "next lint",
           typecheck: "tsc --noEmit",
           test: "vitest run --passWithNoTests",
-          "directus:bootstrap": "mintel directus bootstrap",
-          "directus:push:testing": "mintel directus sync push testing",
-          "directus:pull:testing": "mintel directus sync pull testing",
-          "directus:push:staging": "mintel directus sync push staging",
-          "directus:pull:staging": "mintel directus sync pull staging",
-          "directus:push:prod": "mintel directus sync push production",
-          "directus:pull:prod": "mintel directus sync pull production",
           "pagespeed:test": "mintel pagespeed",
         },
         dependencies: {
-          next: "15.1.6",
+          next: "16.1.6",
           react: "^19.0.0",
           "react-dom": "^19.0.0",
           "@mintel/next-utils": "workspace:*",
-          "@directus/sdk": "^21.0.0",
+          "@mintel/next-observability": "workspace:*",
         },
         devDependencies: {
           "@types/node": "^20.0.0",
@@ -262,11 +228,15 @@ export default createMintelI18nRequestConfig(
       // Create instrumentation.ts
       await fs.writeFile(
         path.join(fullPath, "src/instrumentation.ts"),
-        `import * as Sentry from '@sentry/nextjs';
+        `import { Sentry } from '@mintel/next-observability';
 
 export async function register() {
   if (process.env.NEXT_RUNTIME === 'nodejs') {
-    // Server-side initialization
+    await import('./sentry.server.config');
+  }
+
+  if (process.env.NEXT_RUNTIME === 'edge') {
+    await import('./sentry.edge.config');
   }
 }
 
@@ -357,15 +327,6 @@ export default function Home() {
         }
       }
 
-      // Create Directus structure
-      await fs.ensureDir(path.join(fullPath, "directus/uploads"));
-      await fs.ensureDir(path.join(fullPath, "directus/extensions"));
-      await fs.writeFile(path.join(fullPath, "directus/uploads/.gitkeep"), "");
-      await fs.writeFile(
-        path.join(fullPath, "directus/extensions/.gitkeep"),
-        "",
-      );
-
       // Create .env.example
       const envExample = `# Project
 PROJECT_NAME=${projectName}
@@ -377,27 +338,20 @@ AUTH_COOKIE_NAME=mintel_gatekeeper_session
 
 # Host Config (Local)
 TRAEFIK_HOST=\`${projectName}.localhost\`
-DIRECTUS_HOST=\`cms.${projectName}.localhost\`
 
 # Next.js
 NEXT_PUBLIC_BASE_URL=http://${projectName}.localhost
 
-# Directus
-DIRECTUS_URL=http://cms.${projectName}.localhost
-DIRECTUS_KEY=$(openssl rand -hex 32 2>/dev/null || echo "mintel-key")
-DIRECTUS_SECRET=$(openssl rand -hex 32 2>/dev/null || echo "mintel-secret")
-DIRECTUS_ADMIN_EMAIL=admin@mintel.me
-DIRECTUS_ADMIN_PASSWORD=mintel-admin-pass
-DIRECTUS_DB_NAME=directus
-DIRECTUS_DB_USER=directus
-DIRECTUS_DB_PASSWORD=mintel-db-pass
-
 # Sentry / Glitchtip
 SENTRY_DSN=
 
 # Analytics (Umami)
-NEXT_PUBLIC_UMAMI_WEBSITE_ID=
-NEXT_PUBLIC_UMAMI_SCRIPT_URL=https://analytics.infra.mintel.me/script.js
+UMAMI_WEBSITE_ID=
+UMAMI_API_ENDPOINT=https://analytics.infra.mintel.me
+
+# Notifications (Gotify)
+GOTIFY_URL=
+GOTIFY_TOKEN=
 `;
       await fs.writeFile(path.join(fullPath, ".env.example"), envExample);
 

packages/cli/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+    entry: ['src/index.ts'],
+    format: ['esm'],
+    target: 'es2020',
+    clean: true,
+    banner: {
+        js: '#!/usr/bin/env node',
+    },
+});

packages/cloner-library/build.mjs

@@ -0,0 +1,43 @@
+import { build } from 'esbuild';
+import { resolve, dirname } from 'path';
+import { mkdirSync } from 'fs';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const entryPoints = [
+    resolve(__dirname, 'src/index.ts')
+];
+
+try {
+    mkdirSync(resolve(__dirname, 'dist'), { recursive: true });
+} catch {
+    // ignore
+}
+
+console.log(`Building entry point...`);
+
+build({
+    entryPoints: entryPoints,
+    bundle: true,
+    platform: 'node',
+    target: 'node18',
+    outdir: resolve(__dirname, 'dist'),
+    format: 'esm',
+    loader: {
+        '.ts': 'ts',
+        '.js': 'js',
+    },
+    external: ["playwright", "crawlee", "axios", "cheerio", "fs", "path", "os", "http", "https", "url", "stream", "util", "child_process"],
+}).then(() => {
+    console.log("Build succeeded!");
+}).catch((e) => {
+    if (e.errors) {
+        console.error("Build failed with errors:");
+        e.errors.forEach(err => console.error(`  ${err.text} at ${err.location?.file}:${err.location?.line}`));
+    } else {
+        console.error("Build failed:", e);
+    }
+    process.exit(1);
+});

packages/cloner-library/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@mintel/cloner",
+  "version": "1.9.17",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "dev": "node build.mjs --watch"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.6.3"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "crawlee": "^3.7.0",
+    "playwright": "^1.40.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://git.infra.mintel.me/mmintel/at-mintel.git"
+  }
+}

packages/cloner-library/src/AssetManager.ts

@@ -0,0 +1,98 @@
+import axios from "axios";
+import fs from "node:fs";
+import path from "node:path";
+
+export interface AssetMap {
+  [originalUrl: string]: string;
+}
+
+export class AssetManager {
+  private userAgent: string;
+
+  constructor(
+    userAgent: string = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
+  ) {
+    this.userAgent = userAgent;
+  }
+
+  public sanitizePath(rawPath: string): string {
+    return rawPath
+      .split("/")
+      .map((p) => p.replace(/[^a-z0-9._-]/gi, "_"))
+      .join("/");
+  }
+
+  public async downloadFile(
+    url: string,
+    assetsDir: string,
+  ): Promise<string | null> {
+    if (url.startsWith("//")) url = `https:${url}`;
+    if (!url.startsWith("http")) return null;
+
+    try {
+      const u = new URL(url);
+      const relPath = this.sanitizePath(u.hostname + u.pathname);
+      const dest = path.join(assetsDir, relPath);
+
+      if (fs.existsSync(dest)) return `./assets/${relPath}`;
+
+      const res = await axios.get(url, {
+        responseType: "arraybuffer",
+        headers: { "User-Agent": this.userAgent },
+        timeout: 15000,
+        validateStatus: () => true,
+      });
+
+      if (res.status !== 200) return null;
+
+      if (!fs.existsSync(path.dirname(dest)))
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.writeFileSync(dest, Buffer.from(res.data));
+      return `./assets/${relPath}`;
+    } catch {
+      return null;
+    }
+  }
+
+  public async processCssRecursively(
+    cssContent: string,
+    cssUrl: string,
+    assetsDir: string,
+    urlMap: AssetMap,
+    depth = 0,
+  ): Promise<string> {
+    if (depth > 5) return cssContent;
+
+    const urlRegex = /(?:url\(["']?|@import\s+["'])([^"')]*)["']?\)?/gi;
+    let match;
+    let newContent = cssContent;
+
+    while ((match = urlRegex.exec(cssContent)) !== null) {
+      const originalUrl = match[1];
+      if (originalUrl.startsWith("data:") || originalUrl.startsWith("blob:"))
+        continue;
+
+      try {
+        const absUrl = new URL(originalUrl, cssUrl).href;
+        const local = await this.downloadFile(absUrl, assetsDir);
+
+        if (local) {
+          const u = new URL(cssUrl);
+          const cssPath = u.hostname + u.pathname;
+          const assetPath = new URL(absUrl).hostname + new URL(absUrl).pathname;
+
+          const rel = path.relative(
+            path.dirname(this.sanitizePath(cssPath)),
+            this.sanitizePath(assetPath),
+          );
+
+          newContent = newContent.split(originalUrl).join(rel);
+          urlMap[absUrl] = local;
+        }
+      } catch {
+        // Ignore
+      }
+    }
+    return newContent;
+  }
+}

packages/cloner-library/src/PageCloner.ts

@@ -0,0 +1,256 @@
+import { chromium } from "playwright";
+import fs from "node:fs";
+import path from "node:path";
+import axios from "axios";
+import { AssetManager, AssetMap } from "./AssetManager.js";
+
+export interface PageClonerOptions {
+  outputDir: string;
+  userAgent?: string;
+}
+
+export class PageCloner {
+  private options: PageClonerOptions;
+  private assetManager: AssetManager;
+  private userAgent: string;
+
+  constructor(options: PageClonerOptions) {
+    this.options = options;
+    this.userAgent =
+      options.userAgent ||
+      "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36";
+    this.assetManager = new AssetManager(this.userAgent);
+  }
+
+  public async clone(targetUrl: string): Promise<string> {
+    const urlObj = new URL(targetUrl);
+    const domainSlug = urlObj.hostname.replace("www.", "");
+    const domainDir = path.resolve(this.options.outputDir, domainSlug);
+    const assetsDir = path.join(domainDir, "assets");
+
+    if (!fs.existsSync(assetsDir)) fs.mkdirSync(assetsDir, { recursive: true });
+
+    let pageSlug = urlObj.pathname.split("/").filter(Boolean).join("-");
+    if (!pageSlug) pageSlug = "index";
+    const htmlFilename = `${pageSlug}.html`;
+
+    console.log(`🚀 INDUSTRIAL CLONE: ${targetUrl}`);
+
+    const browser = await chromium.launch({ headless: true });
+    const context = await browser.newContext({
+      userAgent: this.userAgent,
+      viewport: { width: 1920, height: 1080 },
+    });
+    const page = await context.newPage();
+
+    const urlMap: AssetMap = {};
+    const foundAssets = new Set<string>();
+
+    page.on("response", (response) => {
+      if (response.status() === 200) {
+        const url = response.url();
+        if (
+          url.match(
+            /\.(css|js|png|jpg|jpeg|gif|svg|woff2?|ttf|otf|mp4|webm|webp|ico)/i,
+          )
+        ) {
+          foundAssets.add(url);
+        }
+      }
+    });
+
+    try {
+      await page.goto(targetUrl, { waitUntil: "networkidle", timeout: 90000 });
+
+      // Scroll Wave
+      await page.evaluate(async () => {
+        await new Promise((resolve) => {
+          let totalHeight = 0;
+          const distance = 400;
+          const timer = setInterval(() => {
+            const scrollHeight = document.body.scrollHeight;
+            window.scrollBy(0, distance);
+            totalHeight += distance;
+            if (totalHeight >= scrollHeight) {
+              clearInterval(timer);
+              window.scrollTo(0, 0);
+              resolve(true);
+            }
+          }, 100);
+        });
+      });
+
+      const fullHeight = await page.evaluate(() => document.body.scrollHeight);
+      await page.setViewportSize({ width: 1920, height: fullHeight + 1000 });
+      await page.waitForTimeout(3000);
+
+      // Sanitization
+      await page.evaluate(() => {
+        const assetPattern =
+          /\.(jpg|jpeg|png|gif|svg|webp|mp4|webm|woff2?|ttf|otf)/i;
+        document.querySelectorAll("*").forEach((el) => {
+          if (
+            ["META", "LINK", "HEAD", "SCRIPT", "STYLE", "SVG", "PATH"].includes(
+              el.tagName,
+            )
+          )
+            return;
+          const htmlEl = el as HTMLElement;
+          const style = window.getComputedStyle(htmlEl);
+          if (style.opacity === "0" || style.visibility === "hidden") {
+            htmlEl.style.setProperty("opacity", "1", "important");
+            htmlEl.style.setProperty("visibility", "visible", "important");
+          }
+          for (const attr of Array.from(el.attributes)) {
+            const name = attr.name.toLowerCase();
+            const val = attr.value;
+            if (
+              assetPattern.test(val) ||
+              name.includes("src") ||
+              name.includes("image")
+            ) {
+              if (el.tagName === "IMG") {
+                const img = el as HTMLImageElement;
+                if (name.includes("srcset")) img.srcset = val;
+                else if (!img.src || img.src.includes("data:")) img.src = val;
+              }
+              if (el.tagName === "SOURCE")
+                (el as HTMLSourceElement).srcset = val;
+              if (el.tagName === "VIDEO" || el.tagName === "AUDIO")
+                (el as HTMLMediaElement).src = val;
+              if (
+                val.match(/^(https?:\/\/|\/\/|\/)/) &&
+                !name.includes("href")
+              ) {
+                const bg = htmlEl.style.backgroundImage;
+                if (!bg || bg === "none")
+                  htmlEl.style.backgroundImage = `url('${val}')`;
+              }
+            }
+          }
+        });
+        if (document.body) {
+          document.body.style.setProperty("opacity", "1", "important");
+          document.body.style.setProperty("visibility", "visible", "important");
+        }
+      });
+
+      await page.waitForLoadState("networkidle");
+      await page.waitForTimeout(1000);
+
+      const content = await page.content();
+      const regexPatterns = [
+        /(?:src|href|url|data-[a-z-]+|srcset)=["']([^"'<>\s]+?\.(?:css|js|png|jpg|jpeg|gif|svg|woff2?|ttf|otf|mp4|webm|webp|ico)(?:\?[^"']*)?)["']/gi,
+        /url\(["']?([^"')]*)["']?\)/gi,
+      ];
+
+      for (const pattern of regexPatterns) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+          try {
+            foundAssets.add(new URL(match[1], targetUrl).href);
+          } catch {
+            // Ignore invalid URLs
+          }
+        }
+      }
+
+      for (const url of foundAssets) {
+        const local = await this.assetManager.downloadFile(url, assetsDir);
+        if (local) {
+          urlMap[url] = local;
+          const clean = url.split("?")[0];
+          urlMap[clean] = local;
+          if (clean.endsWith(".css")) {
+            try {
+              const { data } = await axios.get(url, {
+                headers: { "User-Agent": this.userAgent },
+              });
+              const processedCss =
+                await this.assetManager.processCssRecursively(
+                  data,
+                  url,
+                  assetsDir,
+                  urlMap,
+                );
+              const relPath = this.assetManager.sanitizePath(
+                new URL(url).hostname + new URL(url).pathname,
+              );
+              fs.writeFileSync(path.join(assetsDir, relPath), processedCss);
+            } catch {
+              // Ignore stylesheet download/process failures
+            }
+          }
+        }
+      }
+
+      let finalContent = content;
+      const sortedUrls = Object.keys(urlMap).sort(
+        (a, b) => b.length - a.length,
+      );
+      if (sortedUrls.length > 0) {
+        const escaped = sortedUrls.map((u) =>
+          u.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"),
+        );
+        const masterRegex = new RegExp(`(${escaped.join("|")})`, "g");
+        finalContent = finalContent.replace(
+          masterRegex,
+          (match) => urlMap[match] || match,
+        );
+      }
+
+      const commonDirs = [
+        "/wp-content/",
+        "/wp-includes/",
+        "/assets/",
+        "/static/",
+        "/images/",
+      ];
+      for (const dir of commonDirs) {
+        const localDir = `./assets/${urlObj.hostname}${dir}`;
+        finalContent = finalContent
+          .split(`"${dir}`)
+          .join(`"${localDir}`)
+          .split(`'${dir}`)
+          .join(`'${localDir}`)
+          .split(`(${dir}`)
+          .join(`(${localDir}`);
+      }
+
+      const domainPattern = new RegExp(
+        `https?://(www\\.)?${urlObj.hostname.replace(/\./g, "\\.")}[^"']*`,
+        "gi",
+      );
+      finalContent = finalContent.replace(domainPattern, () => "./");
+
+      finalContent = finalContent.replace(
+        /<script\b[^>]*>([\s\S]*?)<\/script>/gi,
+        (match, scriptContent) => {
+          const lower = scriptContent.toLowerCase();
+          return lower.includes("google-analytics") ||
+            lower.includes("gtag") ||
+            lower.includes("fbq") ||
+            lower.includes("lazy") ||
+            lower.includes("tracker")
+            ? ""
+            : match;
+        },
+      );
+
+      const headEnd = finalContent.indexOf("</head>");
+      if (headEnd > -1) {
+        const stabilityCss = `\n<style>* { transition: none !important; animation: none !important; scroll-behavior: auto !important; } [data-aos], .reveal, .lazypath, .lazy-load, [data-src] { opacity: 1 !important; visibility: visible !important; transform: none !important; clip-path: none !important; } img, video, iframe { max-width: 100%; display: block; } a { pointer-events: none; cursor: default; } </style>`;
+        finalContent =
+          finalContent.slice(0, headEnd) +
+          stabilityCss +
+          finalContent.slice(headEnd);
+      }
+
+      const finalPath = path.join(domainDir, htmlFilename);
+      fs.writeFileSync(finalPath, finalContent);
+      return finalPath;
+    } finally {
+      await browser.close();
+    }
+  }
+}

packages/cloner-library/src/WebsiteCloner.ts

@@ -0,0 +1,150 @@
+import { PlaywrightCrawler, RequestQueue } from "crawlee";
+import * as path from "node:path";
+import * as fs from "node:fs";
+import { execSync } from "node:child_process";
+
+export interface WebsiteClonerOptions {
+  baseOutputDir: string;
+  maxRequestsPerCrawl?: number;
+  maxConcurrency?: number;
+}
+
+export class WebsiteCloner {
+  private options: WebsiteClonerOptions;
+
+  constructor(options: WebsiteClonerOptions) {
+    this.options = {
+      maxRequestsPerCrawl: 100,
+      maxConcurrency: 3,
+      ...options,
+    };
+  }
+
+  public async clone(
+    targetUrl: string,
+    outputDirName?: string,
+  ): Promise<string> {
+    const urlObj = new URL(targetUrl);
+    const domain = urlObj.hostname;
+    const finalOutputDirName = outputDirName || domain.replace(/\./g, "-");
+    const baseOutputDir = path.resolve(
+      this.options.baseOutputDir,
+      finalOutputDirName,
+    );
+
+    if (fs.existsSync(baseOutputDir)) {
+      fs.rmSync(baseOutputDir, { recursive: true, force: true });
+    }
+    fs.mkdirSync(baseOutputDir, { recursive: true });
+
+    console.log(`🚀 Starting perfect recursive clone of ${targetUrl}...`);
+    console.log(`📂 Output: ${baseOutputDir}`);
+
+    const requestQueue = await RequestQueue.open();
+    await requestQueue.addRequest({ url: targetUrl });
+
+    const crawler = new PlaywrightCrawler({
+      requestQueue,
+      maxRequestsPerCrawl: this.options.maxRequestsPerCrawl,
+      maxConcurrency: this.options.maxConcurrency,
+
+      async requestHandler({ request, enqueueLinks, log }) {
+        const url = request.url;
+        log.info(`Capturing ${url}...`);
+
+        const u = new URL(url);
+        let relPath = u.pathname;
+        if (relPath === "/" || relPath === "") relPath = "/index.html";
+        if (!relPath.endsWith(".html") && !path.extname(relPath))
+          relPath += "/index.html";
+        if (relPath.startsWith("/")) relPath = relPath.substring(1);
+
+        const fullPath = path.join(baseOutputDir, relPath);
+        fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+
+        try {
+          // Note: This assumes single-file-cli is available in the environment
+          execSync(
+            `npx single-file-cli "${url}" "${fullPath}" --browser-headless=true --browser-wait-until=networkidle0`,
+            {
+              stdio: "inherit",
+            },
+          );
+        } catch (_e) {
+          log.error(`Failed to capture ${url} with SingleFile`);
+        }
+
+        await enqueueLinks({
+          strategy: "same-domain",
+          transformRequestFunction: (req) => {
+            if (
+              /\.(download|pdf|zip|gz|exe|png|jpg|jpeg|gif|svg|css|js)$/i.test(
+                req.url,
+              )
+            )
+              return false;
+            return req;
+          },
+        });
+      },
+    });
+
+    await crawler.run();
+
+    console.log("🔗 Rewriting internal links for offline navigation...");
+    const allFiles = this.getFiles(baseOutputDir).filter((f) =>
+      f.endsWith(".html"),
+    );
+
+    for (const file of allFiles) {
+      let content = fs.readFileSync(file, "utf8");
+      const fileRelToRoot = path.relative(baseOutputDir, file);
+
+      content = content.replace(/href="([^"]+)"/g, (match, href) => {
+        if (
+          href.startsWith(targetUrl) ||
+          href.startsWith("/") ||
+          (!href.includes("://") && !href.startsWith("data:"))
+        ) {
+          try {
+            const linkUrl = new URL(href, targetUrl);
+            if (linkUrl.hostname === domain) {
+              let linkPath = linkUrl.pathname;
+              if (linkPath === "/" || linkPath === "") linkPath = "/index.html";
+              if (!linkPath.endsWith(".html") && !path.extname(linkPath))
+                linkPath += "/index.html";
+              if (linkPath.startsWith("/")) linkPath = linkPath.substring(1);
+
+              const relativeLink = path.relative(
+                path.dirname(fileRelToRoot),
+                linkPath,
+              );
+              return `href="${relativeLink}"`;
+            }
+          } catch (_e) {
+            // Ignore link rewriting failures
+          }
+        }
+        return match;
+      });
+
+      fs.writeFileSync(file, content);
+    }
+
+    console.log(`\n✅ Done! Perfect clone complete in: ${baseOutputDir}`);
+    return baseOutputDir;
+  }
+
+  private getFiles(dir: string, fileList: string[] = []) {
+    const files = fs.readdirSync(dir);
+    for (const file of files) {
+      const name = path.join(dir, file);
+      if (fs.statSync(name).isDirectory()) {
+        this.getFiles(name, fileList);
+      } else {
+        fileList.push(name);
+      }
+    }
+    return fileList;
+  }
+}