⚡ Zainder Metrix Studio

Local Speed, SEO & AI Optimization Suite

🇪🇸 Versión en español · 🇬🇧 English version

🌍 Bilingual / Bilingüe — This document is written in both Spanish and English. Use the flag menu above to jump to your language. The application itself is also fully bilingual (Spanish & English), and it ships in English by default.

🌍 Bilingüe / Bilingual — Este documento está escrito en español e inglés. Usa el menú de banderas de arriba para ir a tu idioma. La propia aplicación también es totalmente bilingüe (español e inglés) y viene en inglés por defecto.

---

🇪🇸 Español

¿Qué es Zainder Metrix Studio?

Zainder Metrix Studio es una aplicación de escritorio para Windows que mide y audita el rendimiento, el SEO y la visibilidad en IA de cualquier sitio web. Todo el análisis se ejecuta 100% en local, en tu propio equipo:

• Sin cuentas de usuario, sin base de datos y sin APIs externas de Google.
• Sin telemetría ni cuotas de uso.
• Todos los resultados se guardan como archivos JSON y HTML en disco.
• Los resultados dependen del hardware, la CPU y la conexión de red de tu equipo, por lo que es ideal para medir la evolución de tus propios sitios de forma privada y comparable.

La interfaz está completamente traducida a español e inglés, y el idioma por defecto de la aplicación es inglés.

✨ Funcionalidades principales

1. Medición de rendimiento al estilo GTmetrix

• Nota global (Grado A–F) con ponderación 70% Rendimiento / 30% Estructura.
• Core Web Vitals oficiales: LCP, TBT, CLS, FCP, TTFB, Speed Index e INP, con umbrales de "Bueno / Mejorable / Pobre".
• Carga completa, peso total de la página (KB) y número de peticiones.
• Desglose de recursos por tipo (HTML, JS, CSS, imágenes, fuentes, otros).
• Comparación Móvil vs. Escritorio mediante emulación de dispositivo y viewport.

2. Motores de medición

• Lighthouse Local (Fase 1): motor de laboratorio estándar con perfil limpio, Core Web Vitals, auditoría SEO y cascada simplificada.
• sitespeed.io (Fase 2 / modo avanzado): cascada HAR detallada (DNS, conexión, TLS, espera, descarga) y análisis profundo de recursos.
• Render con Chromium real: captura filmstrip y captura final de la página.
• Repeticiones configurables (N pasadas): el motor ejecuta varias veces y guarda la mediana para filtrar fluctuaciones de red.
• Perfiles fijos de throttling de CPU y red.

3. Pestañas del informe

• Resumen: métricas globales y detalles del entorno de medición.
• Core Web Vitals: escala oficial de Google y ponderaciones.
• Waterfall: cascada de peticiones construida localmente (espera/TTFB, descarga, DNS/SSL) con filtros por tipo de recurso.
• SEO: auditoría on-page (indexabilidad, metadatos, enlaces rastreables, viewport móvil).
• Oportunidades: recomendaciones priorizadas por ahorro de tiempo y datos.
• Accesibilidad y Buenas Prácticas: usabilidad con tecnología de asistencia, HTTPS, UTF-8, DOCTYPE, etc.
• 📁 Archivos del sitio: análisis de robots.txt, sitemap, cabeceras de seguridad y archivos del dominio.
• 🕸️ Rastreo de sitio: rastreo de enlaces del sitio.
• ★ Checklist SEO (11 categorías): checklist extenso con ítems automáticos y de revisión manual.

4. Escaneo de sitio completo

• Descubre y clasifica las páginas del sitio por tipo (Inicio, Blog, Producto, Servicio, Contacto, Precios, Categoría, Portfolio…).
• Analiza varias páginas y navega entre ellas agrupadas por tipo, cada una con su propia nota.

5. Historial, gráficos y comparador

• Historial por dominio con gráficos de evolución temporal (puntuación, LCP/Speed Index, peso).
• Comparador de 2 pruebas con diferencias absolutas (Δ) y porcentuales, con veredicto automático (mejora / regresión).

6. Automatización nativa en Windows

• Programación de análisis periódicos mediante el Programador de Tareas de Windows (schtasks).
• Las tareas se ejecutan a nivel de sistema operativo (incluso con la app cerrada) mediante el ejecutable CLI (app.exe --run <id>).
• Genera comandos CMD y PowerShell (.ps1) descargables, con opción de ejecutar ahora.
• Frecuencias: diaria, semanal, cada hora y mensual.

7. Informes y exportación

• Informe HTML autónomo: un único archivo .html con diseño embebido, colores de grado GTmetrix y todos los desgloses.
• PDF / imprimible de alta fidelidad (motor de impresión de Chromium).
• CSV por dominio o global (todos los dominios) para Excel, Power BI o Google Sheets.
• Exportación bilingüe: los informes se generan en el idioma activo de la app.

8. Ajustes y accesibilidad

• Ruta del ejecutable de Google Chrome/Chromium (con fallback automático al navegador del sistema).
• Reglas de medición: número de repeticiones/mediana y perfiles de throttling.
• Selección del motor de medición.
• Carpeta de almacenamiento de datos JSON.
• Diagnóstico del sistema local.
• Tema oscuro/claro, tamaño de letra, modo de alto contraste y modo lectura fácil (TDAH).
• Atajos de teclado (guía con F1), paleta de comandos, consola de actividad en vivo y notificaciones.

🧱 Tecnologías

Capa	Tecnología
Escritorio	Electron
Interfaz	React 19 + TypeScript + Vite + TailwindCSS 4
Backend embebido	Express (servidor local interno)
Medición	Lighthouse, sitespeed.io, Chromium real
Empaquetado	electron-builder (instalador NSIS + versión portable)
Almacenamiento	Archivos JSON y HTML en disco (sin SQLite ni bases de datos)
Gráficos	Chart.js

🔒 Privacidad

• 100% local: nada sale de tu equipo.
• Sin telemetría, sin cuentas y sin servicios de terceros.
• Datos guardados en %APPDATA%\ZainderMetrixStudio\:
• datos/config.json — configuración.
• datos/resultados/ — resultados completos por dominio.
• datos/resumen/ — resúmenes para historial y gráficos.
• datos/programaciones/ — tareas programadas.
• settings.json — preferencias (idioma, tema, accesibilidad).
• logs/ — registros locales.

🚀 Instalación y uso (desarrollo)

Requisitos: Node.js 18+ y Windows.

# 1. Instalar dependencias
npm install

# 2. Modo desarrollo (servidor local)
npm run dev

# 3. Compilar interfaz + backend
npm run build

# 4. Generar instalador de Windows (NSIS + portable)
npm run dist

# 5. Ejecutar el runner CLI (tareas programadas)
npm run cli -- --run <id-programacion>
npm run cli -- --url https://ejemplo.com --dispositivo movil

Scripts disponibles

Script	Descripción
npm run dev	Arranca el servidor de desarrollo (tsx server.ts).
npm run build	Compila la UI y empaqueta backend + Electron.
npm run dist	Genera el instalador de Windows x64 (NSIS + portable).
npm run start	Arranca el servidor Express.
npm run lint	Comprueba tipos (tsc --noEmit).
npm run cli	Runner CLI para análisis programados.

📦 Ejecutable final

La aplicación se distribuye como instalador NSIS y versión portable:

• Zainder_Metrix_Studio_Setup_<version>.exe
• Zainder_Metrix_Studio_Portable_<version>.exe

📄 Licencia y privacidad

Los términos, la licencia (CC BY 4.0) y la política de datos se detallan dentro de la propia aplicación, en el menú «Licencia y privacidad».

---

🇬🇧 English

What is Zainder Metrix Studio?

Zainder Metrix Studio is a Windows desktop application that measures and audits the performance, SEO and AI visibility of any website. Every analysis runs 100% locally, on your own machine:

• No user accounts, no database, and no external Google APIs.
• No telemetry and no usage quotas.
• All results are stored as JSON and HTML files on disk.
• Results depend on your hardware, CPU and network connection, making it ideal to track the evolution of your own sites in a private and comparable way.

The interface is fully translated into Spanish and English, and the application's default language is English.

✨ Main features

1. GTmetrix-style performance measurement

• Overall score (Grade A–F) weighted 70% Performance / 30% Structure.
• Official Core Web Vitals: LCP, TBT, CLS, FCP, TTFB, Speed Index and INP, with "Good / Needs Improvement / Poor" thresholds.
• Fully loaded time, total page weight (KB) and number of requests.
• Resource breakdown by type (HTML, JS, CSS, images, fonts, other).
• Mobile vs. Desktop comparison through device and viewport emulation.

2. Measurement engines

• Local Lighthouse (Phase 1): standard lab engine with a clean profile, Core Web Vitals, SEO audit and simplified waterfall.
• sitespeed.io (Phase 2 / advanced mode): detailed HAR waterfall (DNS, connection, TLS, wait, download) and deep resource analysis.
• Real Chromium render: load filmstrip and final page screenshot.
• Configurable repetitions (N runs): the engine runs multiple times and stores the median to filter out transient network fluctuations.
• Fixed CPU & network throttling profiles.

3. Report tabs

• Summary: global metrics and measurement-environment details.
• Core Web Vitals: official Google scale and score weightings.
• Waterfall: network request cascade built locally (wait/TTFB, download, DNS/SSL) with resource-type filters.
• SEO: on-page audit (indexability, meta tags, crawlable links, mobile viewport).
• Opportunities: recommendations prioritized by time and bandwidth savings.
• Accessibility & Best Practices: assistive-technology usability, HTTPS, UTF-8, DOCTYPE, etc.
• 📁 Site files: analysis of robots.txt, sitemap, security headers and domain files.
• 🕸️ Site crawl: crawls the site's links.
• ★ SEO Checklist (11 categories): an extensive checklist with automatic and manual-review items.

4. Full site scan

• Discovers and classifies the site's pages by type (Home, Blog, Product, Service, Contact, Pricing, Category, Portfolio…).
• Audits multiple pages and lets you navigate them grouped by type, each with its own grade.

5. History, graphs and comparator

• Per-domain history with time-evolution graphs (score, LCP/Speed Index, weight).
• Comparator for 2 runs with absolute (Δ) and percentage differences, plus an automatic verdict (improvement / regression).

6. Native Windows automation

• Schedule periodic benchmarks through the Windows Task Scheduler (schtasks).
• Tasks run at the operating-system level (even with the app closed) via the CLI executable (app.exe --run <id>).
• Generates downloadable CMD and PowerShell (.ps1) commands, plus a Run now option.
• Frequencies: daily, weekly, hourly and monthly.

7. Reports and export

• Standalone HTML report: a single .html file with embedded styling, GTmetrix grade colors and all breakdowns.
• PDF / printable high-fidelity export (Chromium print engine).
• CSV per domain or global (all domains) for Excel, Power BI or Google Sheets.
• Bilingual export: reports are generated in the app's active language.

8. Settings and accessibility

• Google Chrome/Chromium executable path (with automatic fallback to the system browser).
• Measurement rules: repetitions/median count and throttling profiles.
• Measurement engine selection.
• JSON data storage folder.
• Local system diagnostics.
• Dark/light theme, font size, high contrast mode and easy-reading (ADHD) mode.
• Keyboard shortcuts (guide via F1), command palette, live activity console and toasts.

🧱 Tech stack

Layer	Technology
Desktop	Electron
UI	React 19 + TypeScript + Vite + TailwindCSS 4
Embedded backend	Express (internal local server)
Measurement	Lighthouse, sitespeed.io, real Chromium
Packaging	electron-builder (NSIS installer + portable build)
Storage	JSON & HTML files on disk (no SQLite or databases)
Charts	Chart.js

🔒 Privacy

• 100% local: nothing leaves your machine.
• No telemetry, no accounts and no third-party services.
• Data stored under %APPDATA%\ZainderMetrixStudio\:
• datos/config.json — configuration.
• datos/resultados/ — full per-domain results.
• datos/resumen/ — summaries for history and graphs.
• datos/programaciones/ — scheduled tasks.
• settings.json — preferences (language, theme, accessibility).
• logs/ — local logs.

🚀 Setup and usage (development)

Requirements: Node.js 18+ and Windows.

# 1. Install dependencies
npm install

# 2. Development mode (local server)
npm run dev

# 3. Build UI + backend
npm run build

# 4. Generate the Windows installer (NSIS + portable)
npm run dist

# 5. Run the CLI runner (scheduled tasks)
npm run cli -- --run <schedule-id>
npm run cli -- --url https://example.com --dispositivo movil

Available scripts

Script	Description
npm run dev	Starts the development server (tsx server.ts).
npm run build	Builds the UI and bundles backend + Electron.
npm run dist	Builds the Windows x64 installer (NSIS + portable).
npm run start	Starts the Express server.
npm run lint	Type check (tsc --noEmit).
npm run cli	CLI runner for scheduled analyses.

📦 Final executable

The app ships as an NSIS installer and a portable build:

• Zainder_Metrix_Studio_Setup_<version>.exe
• Zainder_Metrix_Studio_Portable_<version>.exe

📄 License and privacy

The terms, the license (CC BY 4.0) and the data policy are detailed inside the application itself, under the "License & privacy" menu.

---

Zainder Metrix Studio — Local Speed, SEO & AI Optimization Suite

🇪🇸 Versión en español · 🇬🇧 English version · ⬆️ (Top)