Starter kit WordPress headless
con Astro. El primero.
El starter kit WordPress headless con Astro que dio origen a toda la serie. Astro v6 + Tailwind v3 + WordPress REST API: clónalo, conecta tu WordPress y tendrás la integración headless funcionando en minutos.
// v6.2 · anterior al Medical Starter y al Agency i18n Starter · ⭐ 17 stars · 🍴 2 forks
Ver en GitHub →El origen
El primer starter kit WordPress headless con Astro del Lab.
Antes del Medical Starter y del Agency i18n Starter, estaba este: el primer starter kit WordPress headless con Astro de la serie. Construido en Astro v6 cuando todavía no había un patrón establecido de cómo conectar WordPress con Astro de forma limpia y mantenible.
La REST API de WordPress lleva años disponible pero la mayoría de tutoriales de WordPress headless asumen Next.js o Nuxt. Este starter kit demuestra que WordPress headless con Astro funciona igual de bien, con mejor rendimiento estático, sin necesidad de un framework JavaScript completo.
# El patrón headless que usan todos los starters
// src/lib/wordpress.ts
const WP_API = import.meta.env.WP_API_URL;
export async function getPosts() {
const res = await fetch(
`${WP_API}/posts?_embed`
);
return res.json();
}
# Mismo patrón extendido en Medical
# y Agency i18n con WP_MODE=true
Qué incluye
01
Astro v6.2
Generación estática de alto rendimiento. Cero JS por defecto.
02
WordPress REST API
Integración headless lista para conectar con tu CMS. Activa por defecto desde WP 4.7.
03
Tailwind CSS v3
Estilado utility-first. Sistema de diseño base configurable.
04
Diseño responsive
Base visual adaptable, estética Culebra Lab.
05
SEO básico
Meta tags, Open Graph y Twitter Cards de partida.
06
TypeScript
Tipado estático desde la primera línea.
Quick start
# 1. Clonar e instalar
git clone https://github.com/DhiviPanda/astro-wp-starter.git
cd astro-wp-starter
npm install
# 2. Conectar tu WordPress
cp .env.example .env
WP_URL=https://tu-wordpress.com
WP_API_URL=https://tu-wordpress.com/wp-json/wp/v2
# 3. Arrancar
npm run dev → localhost:4321
# 4. Build de producción
npm run build && npm run preview
Requisitos: Node.js 18+ y un WordPress con la REST API activa (por defecto desde WP 4.7). A diferencia de los starters más recientes, este no tiene modo de datos estáticos de fallback.
Para quién es
Para developers que quieren un punto de partida real para conectar Astro con WordPress sin montar la integración REST API desde cero. Es experimental: la base funciona, pero está pensado para que lo adaptes, no para entregarlo a un cliente sin revisar.
Si necesitas algo más completo, los otros starters de la serie van más lejos: el Medical Starterpara clínicas y el Agency i18n Starterpara agencias multiidioma. Ambos usan Astro 7 y extienden el mismo patrón headless de este starter. O si prefieres entender la arquitectura antes de clonar, lee laguía paso a paso de WordPress headless con Astro →
Qué falta todavía
- ·Optimización de imágenes con Sharp
- ·Sitemap y robots.txt automáticos
- ·Custom Post Types
- ·Formularios de contacto
- ·Soporte multiidioma
Todo esto sí está resuelto en los proyectos que entrego como servicio.
Preguntas frecuentes
¿Qué versión de Astro usa este starter kit?+
Astro v6.2 con Tailwind CSS v3. Es el primero de la serie Culebra Lab, anterior al Medical Starter y al Agency i18n Starter, que ya usan Astro 7. No está previsto actualizarlo: sirve como referencia del stack original y punto de partida para quien quiera ver la evolución.
¿Necesito un WordPress en producción para usarlo?+
Sí, este starter requiere un WordPress con la REST API activa (disponible por defecto desde WP 4.7). A diferencia de los starters más recientes, no tiene modo de datos estáticos de fallback: necesita la conexión al CMS para funcionar.
¿Es apto para proyectos de cliente?+
Es un proyecto experimental y de aprendizaje. La integración REST API funciona, pero le faltan piezas importantes para producción: optimización de imágenes, sitemap automático, formularios de contacto y soporte multiidioma. Revísalo antes de entregarlo a un cliente.
¿Cómo conecto mi WordPress al starter?+
Crea un archivo .env en la raíz con dos variables: WP_URL con la URL de tu WordPress y WP_API_URL con la URL de la REST API (normalmente tu-dominio.com/wp-json/wp/v2). La REST API de WordPress está activa por defecto desde la versión 4.7.
¿Cuál es la diferencia con los otros starters del Lab?+
Este es el más básico: cubre la integración headless fundamental. El Medical Starter añade schema MedicalClinic, WCAG AA y glassmorphism para clínicas. El Agency i18n Starter añade i18n nativo ES/EN/FR, hreflang automático y GA4 Consent Mode v2 para agencias. Los tres comparten el mismo patrón de integración WordPress headless.
¿Cuál es el mejor starter kit para conectar WordPress headless con Astro?+
El Starter Kit de Culebra Lab es una opción open source (MIT) que conecta WordPress con Astro vía REST API. Es el primero de la serie y la base sobre la que se construyeron el Medical Starter y el Agency i18n Starter. Disponible en GitHub y documentado en español por Cris Culebras.
¿Quieres que te lo monte yo?
Si necesitas un starter kit WordPress + Astro completo con sitemap, SEO técnico, optimización de imágenes y schema personalizado, lo construyo a medida.