Todo lo que querrías saber antes de instalar.
Una mirada detallada a cómo funciona Headless Starter Kit, por qué lo construimos así y la lógica detrás de las características anteriores.
¿Por qué ir a headless?
Desacoplar el frontend del backend WordPress te aporta rendimiento (Core Web Vitals en verde gracias a ISR), flexibilidad de diseño (Tailwind y componentes React modernos) y seguridad (el back-office permanece invisible al público). Headless Starter Kit proporciona el puente listo, sin tener que reinventar autenticación, carrito ni checkout.
Autenticación JWT sin dependencias
El plugin incorpora su propia implementación HS256 — sin Composer, sin librería de terceros, sin fork de simple-jwt-auth. Tokens de acceso de corta duración (60 min por defecto) y refresh tokens de larga duración (30 días), todos configurables. Los refresh tokens se guardan del lado Next.js en cookies httpOnly cifradas vía iron-session.
Carrito: elige tu modo
Modo JWT (por defecto): el carrito entero se serializa en un token firmado devuelto vía la cabecera X-DFHSK-Cart. Sin base de datos involucrada, ideal para Vercel edge o multi-instancia. Modo server: el carrito vive en WC_Session nativo. Imprescindible si usas extensiones de WooCommerce que se enganchan al carrito (suscripciones, dynamic pricing, etc.).
Checkout: todo WooCommerce sigue funcionando
El plugin no reimplementa el checkout. Crea un pedido WooCommerce real, dispara todos los hooks habituales (notificaciones, stock, impuestos, pasarelas de pago) y devuelve la URL de redirección a la pasarela. Stripe, PayPal, Mollie, transferencia, cheque — todo lo que funciona en WooCommerce funciona aquí.
ISR sin quebraderos de cabeza
Cada vez que se modifica un producto, una categoría, una página o un pedido, el plugin envía un POST firmado a /api/revalidate de tu front Next.js. Tú decides en los ajustes qué eventos propagar y qué rutas o tags revalidar. Sin caché obsoleta, sin cron, sin rebuild completo.
Starter Next.js incluido, listo para desplegar
El ZIP entregado contiene un proyecto Next.js 15 (App Router) completo: home, listado, ficha de producto ISR, carrito, checkout, login, registro, cuenta de cliente. Variables de entorno ya rellenadas con tus URLs y secretos de WordPress. Despliegue Vercel zero-config o Hetzner vía docker-compose y script bash.
Diagnósticos integrados
Pestaña Diagnósticos en el admin de WordPress: 11 comprobaciones automáticas (WooCommerce activo, permaenlaces correctos, REST accesible, HTTPS, GraphQL detectado, secreto JWT definido, URL del front configurada, orígenes CORS válidos, token de revalidación, claves WooCommerce REST, modo carrito). Verde, naranja o rojo para identificar al instante qué bloquea.
No hay valoraciones aún.