Registro público de decisiones

Usamos Next.js 16.2.4 con Turbopack + App Router.

Necesitábamos SSG 4-idiomas con TTFB sub-milisegundo, content-driven (no CMS), y desplegable en Docker Swarm. El API async `params: Promise<{...}>` de Next 16 es el tradeoff correcto: fuerza el manejo async correcto y desbloquea streaming SSR más adelante. Next 15 tiene la misma forma pero todavía en desarrollo. Volver a 14 habría significado perder 2 años de mejoras de perf.

Astro es genial para sitios de contenido pero nuestras páginas dinámicas de pricing y casos de estudio habrían necesitado islas cliente de todas formas. SvelteKit es más rápido pero el equipo tiene 5 años de memoria muscular de React. Remix es solo React 18. Vite + RRR es 3x más código para mantener. Pages Router está muerto.

Todos los 42+ sitios cliente corren en un solo VPS con Docker Swarm, Traefik v3.5, y proxy orange-cloud de CF al frente.

Tenemos 1 ingeniero (yo) corriendo 42 sitios cliente. K8s significaría un cluster, upgrades del control plane, RBAC, ingress controllers, cert-manager, backups de etcd — eso son 3-5 días/mes de yak-shaving. Swarm tiene el mismo modelo declarativo con un binario, un `docker stack deploy`, cero gestión de cluster. La desventaja es que no auto-escala, pero no lo necesitamos — toda la flota peakea en ~30% CPU.

K3s todavía necesita mantenimiento de cluster. Nomad tiene una comunidad más chica. docker-compose no puede hacer deploys zero-downtime. Vercel/Netlify significarían 42 facturas separadas y 42 pipelines de build separados. CF Pages requiere el sistema de build de CF Workers, menos flexible.

Los 28 servicios con precios de referencia, low/high del mercado, y prueba interna — en un Google Sheet público + en el sitio de la empresa.

Cuando empecé AI Whisperers, la objeción #1 de los compradores era '¿cuánto cuesta?'. La queja #1 después de contratarnos era 'no tenía idea de que iba a costar eso'. Ambas vienen de la misma raíz: precios ocultos. Publicar las tarifas de antemano filtra a clientes que no pueden pagarnos (bien — no es el fit correcto) y genera confianza en los que sí pueden (bien — ROI a largo plazo). El riesgo es que los competidores nos bajen el precio. El contra-riesgo es parecer cualquier otra agencia opaca de Paraguay.

Solo cotización significa una llamada de 30 min para cada prospect, incluso los que no pueden pagarnos. Solo tiers es lo peor — es difícil de comparar y nos deja ocultar las tarifas reales. Solo por hora es técnicamente transparente pero psicológicamente peor: una cotización de $5K parece 50 horas × $100, lo cual es intimidante.

Todo el copy del sitio está en `content/{en,es,nl,pt}/site.json` + JSON files por sección. Sin CMS. Git es la fuente de verdad.

Para un sitio 4-idiomas, 44 páginas, con 28 items de servicio, el overhead de un CMS no se paga solo. Git nos da: (1) contenido versionado, (2) PR review en cambios de copy, (3) Claude/Cursor puede editar JSON en segundos, (4) sin vendor lock-in, (5) sin pipeline de deploy separado. La desventaja es que usuarios no técnicos no pueden editar — pero somos 2 personas, ambos técnicos, y el cliente no necesita editar copy (lo aprueba antes del deploy).

Sanity/Contentful cuestan $200+/mes y agregan una API separada para debuggear. Strapi es solo más config YAML para mantener. Decap CMS es bueno pero agrega un runtime. Markdown funcionaría pero JSON es más estructurado para nuestro caso de uso (tablas de precios, testimonios, etc).

Construimos una app fresca de Next.js 16 + Turbopack, desplegamos en nuestro propio VPS, matamos el deploy de Vercel. Mismo DNS, backend diferente.

El build viejo de Vercel era el tagline 'Machines for the math. Humans for the magic.' — circa 2025. Para 2026 ya habíamos pasado del pitch de AI-training al pitch de AI-engineering. El tagline viejo nos estaba haciendo daño en las llamadas de ventas. Iterar sobre el build de Vercel habría significado: editar componentes React, pegarle a la API de Vercel para redeploy, lidear con edge functions de Vercel-only, etc. Empezar fresco en nuestro propio VPS nos dio: control total, sin facturación por función, security headers, Traefik middlewares, rebuild content-driven. Tomó 4 días end-to-end.

Iterar en Vercel mantenía la arquitectura equivocada. Astro habría significado reescribir cada componente interactivo. Hugo habría significado no SSG con contenido per-locale. Next fresco en VPS ganó en todos los ejes.