Redacción de artículos del blog

Configuración y ajustes

Antes de cualquier paso, lea Antes de comenzar y Conceptos básicos del terminal. Estas instrucciones suponen que abrió el monorepo supastack completo en VS Code; su paquete raíz.json marca la raíz del repositorio. En los comandos pnpm, un paquete de espacio de trabajo es una aplicación o una carpeta de código compartido; En el producto, un espacio de trabajo es el contenedor de datos y el límite de seguridad de un equipo. corepack pnpm --filter ... selecciona un paquete del monorepo mientras los comandos se ejecutan desde su raíz. Si abrió solo una carpeta sincronizada para dispositivos móviles o de escritorio, no contiene el backend web, la configuración de Docker ni los scripts raíz: ejecute el backend desde este monorepo o un servidor alojado accesible y use los propios scripts de la carpeta de la plataforma. Una variable de entorno es una configuración con nombre almacenada en un archivo .env local o en su panel de hosting; reinicie la aplicación correspondiente después de cambiarla y mantenga los secretos del servidor fuera de los valores NEXT_PUBLIC_ y EXPO_PUBLIC_.

1. En VS Code, abra apps/web/src/resources/content.ts y copie un artículo cercano completo como punto de partida; La copia del artículo se encuentra en el repositorio, no en un panel de publicación.

2. Asigne al artículo un nuevo slug, título, categoría, fecha, secciones y un slug de guía existente.

3. Desde la raíz del repositorio, ejecute corepack pnpm --filter @supastack/web dev y abra http://localhost:3000/blog/<your-slug>.. Se espera: el artículo y el enlace de la guía relacionada se cargan localmente antes de compartir el URL.

El contenido del blog se guarda en src/resources/content.ts y blog-posts.ts. Es contenido gestionado por el repositorio; no hay servicio de publicación CMS. Cada Post necesita slug, título, descripción, categoría, fecha, guía relacionada y secciones únicos.

{
  slug: 'your-article',
  title: 'A specific reader question',
  category: 'Guides',
  date: '2026-09-07',
  guide: 'web/local-setup',
  sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}

Comandos para copiar

Siga los comentarios para ver en qué carpeta se ejecuta un comando. Si dos terminales están etiquetados, abra dos ventanas de terminal y mantenga el primer comando ejecutándose mientras usa el segundo.

corepack pnpm --filter @supastack/web dev

# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.ts

Flujo de implementación

Sigue un objeto Post existente completo para los campos de tipo restantes. Mantén estable el slug después de publicar para que los URL compartidos sigan funcionando. Los encabezados necesitan ID de sección únicos para el índice y los enlaces de anclaje.

Las categorías se derivan del catálogo de artículos. El índice filtra según la URL y las rutas de artículos generan metadatos a partir del contenido. El valor de guía debe coincidir con un slug de documentación existente; el contenido relacionado debería llevar a un siguiente paso útil.

Verificación y solución de problemas

Si el artículo devuelve 404, verifique que su slug sea único y que se haya agregado a la lista de artículos en apps/web/src/resources/content.ts.. Si la tabla de contenido no salta a ninguna parte, asigne a cada sección una identificación única. Ejecute corepack pnpm test -- apps/web/src/resources/content.test.ts desde la raíz para ver los errores de validación de contenido.

Ejecuta las pruebas de contenido, abre la ruta del artículo, sigue su guía relacionada y comprueba el índice filtrado. Contrasta las fechas y afirmaciones con las fuentes. No publiques enlaces de marcador de posición ni afirmes que una integración se verificó solo porque aparece en un artículo.