← Todos los trabajos
MigraciónAstro Caso de estudio · 2026

D'SKIN — Tienda headless ordenada por la rutina

Migración completa del sitio de una marca chilena de skincare, de WordPress a Astro con WooCommerce headless. En 2026 la tienda se reordenó entera: ya no se navega por categorías, se navega por los cuatro pasos de la rutina.

Ver sitio en vivo ↗
01 · Resumen
Stack
  • Astro
  • TinaCMS
  • React
  • TypeScript
  • WooCommerce API
  • Supabase
Rol
  • Full-Stack Developer
Plazo
  • noviembre de 2026
  • Migración en diciembre de 2025 · rediseño en noviembre de 2026
Cliente
  • D'SKIN
  • Chile
Alcance
  • Migración de WordPress a Astro + TinaCMS con WooCommerce headless
  • Checkout propio en el sitio, en producción desde febrero de 2026
  • Rediseño de la tienda ordenada por los cuatro pasos de la rutina
  • Edición visual de contenido para el equipo de marketing
  • Soporte bilingüe (ES/EN) e i18n completo
  • Lighthouse móvil 99 de rendimiento, 100 de accesibilidad y 100 de SEO
02 · Detalle

El rediseño de 2026: la tienda como rutina

Un año después de la migración, el problema ya no era técnico. La tienda se ordenaba por las categorías de WooCommerce, que además estaban rotas: «Beauty», «Cream», «Serum», «Skin care» y siete productos en «Uncategorized». Una clienta que entra no sabe qué es un sérum. Lo que necesita saber es que va segundo.

Así que la tienda pasó a ordenarse por los cuatro pasos de la rutina —limpiar, tratar, hidratar, contorno—, con cada producto en su paso, su frecuencia de uso y su tipo de piel.

Lo que cambió el diseño fue mirar los pedidos. Agrupando los 486 pedidos pagados del histórico por persona —196 clientas— apareció esto:

  • El 42,9 % entra por la crema hidratante, que es el paso 3. Solo el 6,1 % entra por el paso 1.
  • El 68,9 % compra un solo producto en su primera compra.
  • De las que repiten, el 63,5 % repone lo mismo en vez de avanzar en la rutina.

Nadie había mirado eso antes, y contradecía el diseño obvio. Por eso el hero no abre por el paso 1 sino por donde la gente entra de verdad, el titular dice «Puedes empezar por uno», y existe un bloque que pregunta qué hay ya en la repisa en vez de presentar la rutina completa como si fuera el único camino.

Tres decisiones del rediseño

Una sola fuente para el orden, y nada escrito a mano. Un archivo define los cuatro pasos y qué producto va en cada uno. Precio, foto y stock se piden a WooCommerce en cada render. Un producto agotado muestra «Agotado · avísame» y no se puede agregar al carrito, que es justamente lo que la tienda anterior sí dejaba hacer.

Ni un solo @media. Todo el rediseño usa consultas de contenedor, medidas en cqw con clamp() y grillas auto-fit. Cada bloque se comporta igual dentro de una columna, dentro de un modal o a página completa, porque mide su contenedor y no la ventana.

El dorado de la marca no se usa como tinta. #d8c7a5 mide 1,44:1 sobre fondo claro: como texto es ilegible y como línea desaparece. Los rótulos van en #6f5733, que da 6,4:1 sobre hueso, y las líneas en un tono intermedio. El color de marca se conserva donde funciona —en fondos y en producto—, no donde el contraste lo prohíbe.

Un error que vale dejar escrito

La entrada por scroll de las secciones estaba puesta en CSS con opacity: 0. Cuando el observador de intersección no llega a correr —y pasó en la maqueta a 768 y a 390— la página se queda en blanco: el estado inicial se aplicó y el final nunca llega. Ahora el estado oculto lo pone JavaScript después de montar, y solo bajo el pliegue. Sin JavaScript, o con prefers-reduced-motion, la página se ve entera desde el primer render.

El Desafío

D’SKIN, una marca chilena de cosmética natural, tenía un sitio WordPress + WooCommerce que ya acusaba el paso del tiempo. El cliente necesitaba una presencia web más rápida y moderna, manteniendo la capacidad de gestionar contenido con facilidad y conservar intacta su funcionalidad de e-commerce.

Los objetivos principales fueron:

  • Mejorar dramáticamente la velocidad de carga y los Core Web Vitals
  • Proporcionar una experiencia de edición visual de contenido para el equipo de marketing
  • Mantener WooCommerce para la gestión de productos y los pedidos
  • Soporte de contenido bilingüe (español/inglés)
  • Estética moderna y premium que refleje la identidad de skincare natural de la marca

La Solución

Diseñé un enfoque híbrido: Astro para el frontend con TinaCMS para edición visual de contenido, manteniendo WordPress + WooCommerce como backend headless para los datos de producto y los pedidos.

┌─────────────────┐   ┌──────────────┐   ┌─────────────────┐
│  Sitio Astro    │──▶│   TinaCMS    │──▶│  Build Estático │
│  (Frontend)     │   │  (Contenido) │   │   (Hosting)     │
└─────────────────┘   └──────────────┘   └─────────────────┘
        │
        ▼
┌─────────────────┐
│   WordPress     │
│   WooCommerce   │
│   (Productos)   │
└─────────────────┘

Características Implementadas

Soporte bilingüe (ES/EN) — Implementación completa de i18n con español como idioma predeterminado, rutas en inglés en /en/* con traducción completa, colecciones de contenido separadas por idioma (26+ posts de blog cada una), elementos de UI, fechas, formato de moneda, navegación y meta tags SEO localizados por idioma.

Gestión visual de contenido con TinaCMS — Edición con preview en tiempo real en vista dividida, con secciones editables e indicadores visuales: slider hero de la página principal (4 productos configurables), sección Best Sellers con integración WooCommerce, página Sobre Nosotros con galería del equipo, catálogo de servicios de tratamientos, y posts de blog con edición rich-text.

Integración E-commerce — Catálogo de productos obtenido de la WooCommerce REST API en tiempo real, carrito drawer del lado del cliente con persistencia en localStorage, estado de stock y precios sincronizados automáticamente, y un mecanismo de respaldo si la API no responde. El checkout empezó siendo un traspaso del carrito a WooCommerce con sesión firmada; desde febrero de 2026 el pago ocurre en el propio sitio, y WooCommerce queda como catálogo y registro de pedidos.

Componentes interactivos — Carrito drawer (sidebar de 380px en desktop, ancho completo en móvil), slider hero con productos configurables, carrusel de Google Reviews, feed de Instagram dinámico, botón flotante de WhatsApp, y smooth scrolling con Lenis.

Optimizaciones de rendimiento — Generación estática con hidratación parcial de Astro, componentes React que solo se hidratan cuando hace falta (client:load, client:visible), e imágenes optimizadas servidas desde una CDN en el borde.

Resultados

Medido en producción con Lighthouse móvil, mediana de tres corridas:

  • Rendimiento 99, accesibilidad 100, SEO 100
  • LCP 1,3 s y CLS 0,001
  • Buenas prácticas 77, y baja solo por las cookies de terceros de los píxeles de publicidad: es una decisión de la marca, no del sitio

El equipo de marketing actualiza artículos, tratamientos, fichas y contenido de página sin asistencia técnica, y el checkout vive en el propio sitio desde febrero de 2026, con WooCommerce como catálogo y registro de pedidos.

Highlights Técnicos

Edición visual con TinaCMS — Wrappers de React personalizados habilitan preview en tiempo real con el hook useTina().

// Ejemplo de wrapper de edición visual
export default function BestSellersWrapper({ query, variables, data, products }) {
  const { data: tinaData } = useTina({ query, variables, data });
  return (
    <section data-tina-field={tinaField(bestSellers, 'title')}>
      {/* Contenido editable con indicadores visuales */}
    </section>
  );
}

Integración con la API de WooCommerce — Datos de productos en tiempo real con fallbacks elegantes (getBestSellers(), getProductsByIds(), formato de precio chileno).

// Obtener productos más vendidos
const products = await getBestSellers(3);

// Obtener productos específicos por ID
const products = await getProductsByIds([7183, 7176, 7868]);

// Formatear precio en formato chileno
formatPrice(21990); // "$21.990"

Del traspaso al checkout propio — La primera versión entregaba el carrito a WooCommerce con un plugin a medida y tokens firmados de cinco minutos, para que la clienta no volviera a escribir nada. Funcionaba, pero el pago seguía ocurriendo en un sitio con otro diseño y otro dominio. Desde febrero de 2026 el checkout es una ruta más del sitio: mismo diseño, mismo dominio, y WooCommerce recibe el pedido por API.

Este proyecto demuestra cómo un sitio WordPress tradicional puede modernizarse con una arquitectura headless, combinando lo mejor del rendimiento de sitios estáticos con la flexibilidad de un CMS visual y la robustez de WooCommerce para el e-commerce.

03 · Capturas
La tienda ordenada como rutina: limpiar, tratar, hidratar y contorno, con cada producto en su paso, su indicación de uso, su valoración y su precio.
La tienda ordenada como rutina: limpiar, tratar, hidratar y contorno, con cada producto en su paso, su indicación de uso, su valoración y su precio.

¿Tienes un proyecto así?