Documentación

Guía de desarrollo

Primeros pasos

git clone <repo-url>
cd stack-2026
pnpm install
pnpm db:up
pnpm db:generate
pnpm db:migrate
pnpm dev

Estructura del monorepo

apps/
  web/          # Astro 6 + React 19 (frontend, puerto 4321)
  api/          # Fastify 5 (backend, puerto 8080)
packages/
  db/           # Prisma 6 (ORM + migraciones)
  shared/       # Tipos y utilidades compartidas
  ui/           # Componentes UI reutilizables
infra/          # Docker Compose (PostgreSQL 17)
docs/           # Documentación y auditorías

Comandos principales

Comando Descripción
pnpm dev Arranca frontend y API simultáneamente
pnpm check Ejecuta lint, typecheck y build
pnpm db:up Inicia PostgreSQL en Docker
pnpm db:migrate Ejecuta migraciones Prisma
pnpm format Formatea código con Prettier

Próximos pasos

  • Explorar la documentación en docs/
  • Revisar las auditorías en docs/audits/
  • Ejecutar pnpm check antes de cada commit
  • Mantener Docker corriendo para desarrollo con base de datos