Initial commit

frontend/START.md

@@ -0,0 +1,88 @@
+# 🚀 Inicio Rápido
+
+## Pasos para ejecutar el proyecto:
+
+### 1. Instalar dependencias
+```bash
+npm install
+```
+
+### 2. Configuración (Automática)
+
+✅ **El proyecto usa automáticamente las credenciales del archivo `bnt-ia-innovacion-new.json`**
+
+No necesitas configurar nada adicional. El archivo JSON ya contiene todas las credenciales necesarias.
+
+Si quieres usar una API key diferente (opcional):
+```bash
+cp .env.local.example .env.local
+# Edita y descomenta GOOGLE_API_KEY
+```
+
+### 3. Ejecutar el proyecto
+
+```bash
+npm run dev
+```
+
+### 4. Abrir en el navegador
+
+Abre http://localhost:3000
+
+---
+
+## 📝 Notas Importantes
+
+### Sobre la Autenticación
+
+El proyecto usa **Google Generative AI SDK** (`@google/generative-ai`) con las credenciales del archivo `bnt-ia-innovacion-new.json`.
+
+La autenticación es automática mediante `google-auth-library` que lee el Service Account del JSON.
+
+### Verificar que todo funciona
+
+1. Abre http://localhost:3000
+2. Selecciona un modelo (por defecto: gemini-2.0-flash-exp)
+3. Escribe un prompt simple: "un gato naranja"
+4. Haz clic en "Generar Imagen"
+
+Si ves errores:
+- Verifica que la API key sea válida
+- Revisa los logs en la terminal
+- Revisa la consola del navegador (F12)
+
+---
+
+## 🔧 Comandos útiles
+
+```bash
+# Desarrollo
+npm run dev
+
+# Build para producción
+npm run build
+
+# Ejecutar producción
+npm start
+
+# Linting
+npm run lint
+```
+
+---
+
+## 🐛 Problemas Comunes
+
+### Error: "API key not valid"
+- Verifica que copiaste correctamente la API key
+- Asegúrate de que el archivo `.env.local` existe
+- Reinicia el servidor de desarrollo (Ctrl+C y `npm run dev` de nuevo)
+
+### Error: "Module not found"
+- Ejecuta `npm install` de nuevo
+- Borra `node_modules` y `.next`, luego `npm install`
+
+### Las imágenes no se generan
+- Algunos modelos de Gemini aún no soportan generación de imágenes
+- Prueba con diferentes prompts
+- Revisa los logs del servidor para más detalles