Desarrollo

Requisitos

Node.js ≥ 22.12.0.
pnpm ≥ 11.15.1. El script de instalación puede configurarlo con corepack.

Iniciar la app

./scripts/install.sh
./scripts/start.sh

En Windows:

scripts\install.bat
scripts\start.bat

El frontend se ejecuta en http://localhost:4321 y hace proxy de /api al backend en http://localhost:3001.

Instalación manual:

corepack enable
corepack prepare pnpm@11.21.0 --activate
pnpm install
pnpm dev

Controles de calidad

pnpm check:arch   # reglas de arquitectura
pnpm check        # arquitectura + typecheck + lint
pnpm --filter @workspace/backend test
pnpm --filter @workspace/frontend exec vitest run

pnpm check:arch verifica el límite de tamaño del frontend, los límites hexagonales del backend, la pureza de lib/ y del paquete shared, los hooks genéricos, los archivos muertos y el aislamiento entre funciones. Lee AGENTS.md para las reglas completas.

Estructura

Paquete	Propósito
`packages/backend`	API Express + Drizzle + SQLite. Arquitectura hexagonal.
`packages/frontend`	UI Astro + React.
`packages/shared`	Tipos y utilidades sin framework.
`packages/ui`	Componentes reutilizables de shadcn/ui.
`packages/website`	Este sitio público (Astro + Starlight).

Contribuir

Lee CONTRIBUTING.md y abre un pull request. master está protegida; el CI tiene que pasar antes de fusionar. Usa confirmaciones convencionales y cambios pequeños.