$fixit — arreglar problemas

antes de tocar nada

piensa:

• ¿qué estaba haciendo el usuario cuando se rompió?
• ¿qué cambió recientemente?
• ¿qué estás asumiendo que tal vez no está bien?

no persigas solo el primer error. busca causa raíz.

checklist de diagnóstico

haz este flujo y detente en el primer fallo para corregirlo antes de seguir.

1. ¿dev server corriendo?

curl -s -o /dev/null -w "%{http_code}" http://localhost:3000

si no responde:

npm run dev &

espera a que arranque y continúa. si no se mantiene, revisa npm run build, corrige ese error y vuelve a intentar.

2. integridad de archivos

verifica que existan y sean válidos:

• app/page.tsx con default export
• app/layout.tsx con default export y <Providers>{children}</Providers>
• app/providers.tsx exportando Providers con HeroUIProvider
• app/globals.css con @import "tailwindcss", @plugin '../hero.ts', @custom-variant dark, y bloque @theme
• hero.ts con default export de heroui()

si falta algo, recréalo con esos mínimos.

3. import check

escanea imports en app/ y components/:

• imports válidos de @heroui/react
• sin imports locales rotos
• sin paquetes inexistentes en package.json

corrige lo roto.

4. lint check

npx eslint app/ --fix

si quedan errores, corrígelos manualmente y vuelve a correr.

5. build check

npm run build

si falla, corrige y vuelve a correr hasta que pase.

después de arreglar

explica en lenguaje simple:

"encontré un detalle: [explicación]. ya quedó, revisa tu navegador."

si todo pasa

"todo se ve bien — tu app está corriendo limpio."

si el checklist pasa pero algo sigue raro

no pares:

• relee los últimos mensajes
• vuelve a abrir los archivos implicados
• valida comportamiento real, no solo que compile
• busca errores sutiles (estado, variable, re-render, lógica)

si de verdad no lo encuentras:

"corrí todo y se ve bien en mi lado. ¿qué estás viendo exactamente vs qué esperabas?"

y sigue desde esa descripción.

reglas

• no mostrar logs crudos ni stack traces
• arreglar, no solo reportar
• confirmar que quedó arreglado antes de decirlo
• mantener lenguaje casual
• no te quedes en "compila"; valida que funcione como esperan