diff --git a/.gitea/workflows/build-and-deploy.yml b/.gitea/workflows/build-and-deploy.yml
index 5d3f66d..86db3a7 100644
--- a/.gitea/workflows/build-and-deploy.yml
+++ b/.gitea/workflows/build-and-deploy.yml
@@ -5,13 +5,21 @@ on:
     branches: [ main, master ]
 
 jobs:
-#───────────────── build & push ─────────────────
-  build:
+#───────────────── build, push & deploy (unified) ─────────────────
+  build-and-deploy:
     runs-on: docker
     env:
       REG: ${{ vars.REGISTRY_URL }}
       APP_NAME: ${{ vars.APP_NAME }}
       REPO_OWNER: ${{ github.repository_owner }}
+      # Variables de entorno para docker-compose
+      APP_DOMAIN: ${{ vars.APP_DOMAIN }}
+      NUXT_PUBLIC_APP_URL: ${{ vars.NUXT_PUBLIC_APP_URL }}
+      DOCKER_DOMAIN: ${{ vars.DOCKER_DOMAIN }}
+      # Variables para MCP Gitea Server
+      GIT_URL: ${{ vars.GIT_URL }}
+      GIT_DOMAIN: ${{ vars.GIT_DOMAIN }}
+      GIT_TOKEN: ${{ secrets.GIT_TOKEN }}
     steps:
       - uses: actions/checkout@v3
       - uses: docker/setup-buildx-action@v2
@@ -42,27 +50,6 @@ jobs:
           docker push $REG/$REPO_OWNER/mcp-gitea-server:${{ github.sha }}
           docker push $REG/$REPO_OWNER/mcp-gitea-server:latest
 
-#───────────────── deploy ─────────────────
-  deploy:
-    needs: build
-    runs-on: docker
-    env:
-      REG: ${{ vars.REGISTRY_URL }}
-      REPO_OWNER: ${{ github.repository_owner }}
-      APP_NAME: ${{ vars.APP_NAME }}
-      # Variables de entorno para docker-compose
-      APP_DOMAIN: ${{ vars.APP_DOMAIN }}
-      NUXT_PUBLIC_APP_URL: ${{ vars.NUXT_PUBLIC_APP_URL }}
-      DOCKER_DOMAIN: ${{ vars.DOCKER_DOMAIN }}
-      # Variables para MCP Gitea Server
-      GIT_URL: ${{ vars.GIT_URL }}
-      GIT_DOMAIN: ${{ vars.GIT_DOMAIN }}
-      GIT_TOKEN: ${{ secrets.GIT_TOKEN }}
-    steps:
-      - uses: actions/checkout@v3
-      - name: Login to registry
-        run: docker login ${{ vars.REGISTRY_URL }} -u ${{ secrets.REGISTRY_USERNAME }} -p ${{ secrets.REGISTRY_PASSWORD }}
-
       - name: Info about environment
         run: |
           echo "ℹ️  Deploying ${{ vars.APP_NAME }}"
diff --git a/nuxt4/nuxt.config.ts b/nuxt4/nuxt.config.ts
index 19b8b0c..af8aa62 100644
--- a/nuxt4/nuxt.config.ts
+++ b/nuxt4/nuxt.config.ts
@@ -24,6 +24,7 @@ export default defineNuxtConfig({
     registerType: 'autoUpdate',
     includeAssets: ['favicon.ico', 'apple-touch-icon.png', 'icon.svg', 'offline.html'],
     manifest: {
+      id: '/?app=docs',
       name: 'Nucleo Docs',
       short_name: 'Docs',
       description: 'Documentación del sistema Nucleo',
@@ -34,8 +35,17 @@ export default defineNuxtConfig({
       orientation: 'portrait',
       scope: '/',
       start_url: '/',
+      // Control de ventanas - mantener una sola ventana
+      launch_handler: {
+        client_mode: 'navigate-existing'
+      },
       // Capturar enlaces dentro de la app
       capture_links: 'existing-client-navigate',
+      // URL handling - nuevo estándar para manejar links a esta PWA
+      handle_links: 'preferred',
+      url_handlers: [
+        { origin: 'https://docs.nucleoriofrio.com' }
+      ],
       icons: [
         {
           src: '/icon-192x192.png',