Skip to content

Release v0.6.0: The AI-Native & API Edition

Choose a tag to compare

@gonzoblasco gonzoblasco released this 30 Jun 20:08
· 33 commits to main since this release

Esta es la actualización más grande de create-stack-next hasta la fecha. Concluimos oficialmente la Fase 2 (Flexibilidad Interna y DX) e introdujimos un soporte nativo revolucionario para el desarrollo asistido por Inteligencia Artificial y la creación ágil de Backends puros.

🌟 Novedades Principales

🤖 Proyectos AI-Native desde el Minuto Cero

Todos los proyectos generados por el CLI ahora nacen con un flujo de trabajo listo para agentes de IA (como OpenClaw o Cursor).

  • Prompt de Kickoff: El archivo AGENTS.md incluye un texto pre-configurado para que le ordenes a la IA que asuma el rol de Arquitecto y empiece a programar.
  • Documentación Dinámica: Inyectamos los esqueletos ROADMAP.md, AGENT_TASKS.md y HANDOFF.md para evitar la "amnesia contextual" típica de los LLMs.
  • Decisiones Registradas (ADRs): Se fuerza contractualmente a las IAs a dejar constancia de cambios arquitectónicos en docs/decisions.md.

⚡ Nuevo Template: API Backend (--template api)

¿Querés construir un Backend sin el peso del Frontend? Introducimos el flag --template api, que genera un proyecto optimizado de Next.js App Router puro (Route Handlers).

  • Drizzle ORM + SQLite: Tipado impecable y ultra veloz para entornos Serverless (@libsql/client).
  • Validación con Zod: Esquemas listos para proteger tus payloads.
  • Arquitectura Robusta: Middleware de autenticación (Bearer/API Key), utilidades para Respuestas y Errores HTTP unificadas (ApiError, successResponse).
  • Testing en Memoria: Configurado con node-mocks-http y Vitest para probar endpoints directamente en milisegundos sin levantar puertos.

🎨 Experiencia de Desarrollador (DX) Renovada

  • @clack/prompts: La terminal ahora luce espectacular con spinners en tiempo real, colores semánticos, manejo limpio de cancelaciones (Ctrl+C) y un bloque estilizado de "Próximos pasos".
  • Soporte de Workspaces (Monorepos): El CLI ahora detecta mágicamente si lo estás ejecutando dentro de un Turborepo o pnpm workspace y desactiva de manera inteligente el git init para no anidar repositorios de forma accidental.

🛠️ Mejoras Internas y Correcciones

  • CI/CD Pipeline: Agregamos un flujo de trabajo de GitHub Actions nativo para validar Linting, Tipos y Playwright tests automáticamente en el repositorio central.
  • Tests Re-arquitecturados: Los tests de Vitest ahora discriminan el directorio src/ del directorio de plantillas template/, evitando colisiones fantasma.
  • Fix: Resolución del infame error ERESOLVE de npm install fijando la dependencia de React de forma armónica para Next.js 15.

Nota para los contribuidores: Asegúrense de usar npm run test:run para verificar las adiciones, ya que ahora el proyecto cuenta con 55 tests automáticos en verde. ¡A disfrutar creando!