Crea una app con Codex, del código al instalador y su landing
Elige una de las siete apps y constrúyela de principio a fin con el mismo método: por etapas, comprobando cada una, hasta un instalador .exe para Windows y su propia landing publicada. Además, cinco prácticas para ir más allá: añadir IA a una app con Codex o con la API gratuita de Gemini, crear vuestra propia app de IA local con Gemma 4, conectar herramientas con MCP y modelar en 3D con Blender usando Computer Use. Dos sesiones de tres horas, presencial en el Cibernàrium de Barcelona y online.
Elige la app que vas a construir
Todas siguen las mismas doce etapas y terminan igual: app de escritorio, instalador de Windows y landing publicada. En clase la demostración se hace con Focus Studio; cada persona puede seguirla o elegir otra.
Cada etapa sigue el mismo ciclo
- Pedir el plan
- Aprobar o corregir
- Construir
- Comprobar con la lista
- Guardar con un commit
Doce etapas para cada app
Cada etapa tiene su objetivo, el prompt para copiar, cómo comprobar que ha salido bien y qué hacer si algo falla. No paséis a la siguiente hasta que la comprobación sea correcta.
Focus Studio
App de escritorio de tipo Pomodoro para trabajar por bloques de tiempo, con proyectos, tareas, estadísticas e idiomas.
Sesión 1 · De la idea a una app que funciona
00Preparar la carpeta y los materiales
Objetivo tener la carpeta del proyecto abierta en Codex con todos los ficheros de trabajo.
Si todavía no tenéis Codex instalado y configurado, empezad por el bloque 0 · Instalar y configurar Codex. Después:
- Descargad los materialesfocus-studio-materials.zip (13 KB, 8 ficheros).
- Descomprimid la carpetaDentro de vuestra carpeta de usuario, por ejemplo
Documentos\focus-studio-materials. Fuera de OneDrive y de la raíz deC:\. - Abridla en CodexAdd new project (Ctrl+O) y elegid la carpeta. Dejad los permisos en Ask for approval.
- Comprobad que Codex la entiendeCon el prompt de abajo.
Lista los ficheros de esta carpeta y explícame en [tu idioma], en una línea cada uno, para qué sirve. No cambies nada.
Qué hay en la carpeta (y cómo crear cada fichero si no podéis descargar el zip)
AGENTS.mdInstrucciones que Codex lee siempre en esta carpeta.Crear este fichero con un prompt
Crea en esta carpeta un AGENTS.md para el proyecto Focus Studio: app de escritorio de tipo Pomodoro para trabajar por bloques de tiempo, con proyectos, tareas, estadísticas e idiomas. Se hace con HTML, CSS y JavaScript sin frameworks y se empaqueta para Windows con Electron. Indica: responde siempre en el idioma del usuario; explica el plan antes de cambiar ficheros y espera confirmación; haz una etapa cada vez; trabaja solo dentro de esta carpeta y no borres nada sin preguntar; avisa antes de órdenes que necesiten internet; todos los textos visibles salen de textos.json (ca, es, en); los datos se guardan en el dispositivo; accesible con teclado; al terminar cada etapa, pasa las comprobaciones de proves_focus_studio.md.
brief_focus_studio_es.md / brief_focus_studio_ca.mdEl encargo: qué hace la app y cómo se comprueba.Crear este fichero con un prompt
Crea brief_focus_studio_es.md con el encargo de Focus Studio: App de escritorio de tipo Pomodoro para trabajar por bloques de tiempo, con proyectos, tareas, estadísticas e idiomas. Incluye objetivo, qué tiene que hacer por etapas (el temporizador; proyectos y tareas; estadísticas; idiomas ca/es/en desde textos.json; exportar e importar JSON e importar CSV; ventana Electron con icono e instalador; landing publicada en GitHub Pages), aspecto, fuera de alcance y cómo sabremos que está bien.
textos.jsonTodos los textos de la interfaz en ca, es y en.Crear este fichero con un prompt
Crea textos.json con tres bloques, "ca", "es" y "en", con las mismas claves en los tres para todos los textos que necesitará la interfaz de Focus Studio según el brief: botones, campos, filtros, estadísticas, configuración, mensajes de confirmación y de error. Traduce cada texto con naturalidad.
proves_focus_studio.mdComprobaciones de cada etapa, con casillas.Crear este fichero con un prompt
Crea proves_focus_studio.md con una lista de comprobaciones con casillas para cada etapa de Focus Studio según el brief, más idiomas, datos (exportar, importar JSON y CSV, CSV mal formado), escritorio, instalador de Windows, landing y publicación. Cada comprobación tiene que poder verificarse mirando la app.
icona.pngIcono de 512 × 512 para el instalador.Crear este fichero con un prompt
Crea icona.png de 512 × 512 píxeles para Focus Studio: un cuadrado redondeado de color oscuro con un símbolo sencillo y claro que represente la app. Usa Python con Pillow; si no está instalado, pídeme permiso para instalarlo.
focus-studio-materials.01Leer el encargo y planificar
Objetivo que Codex explique qué va a construir y en qué orden antes de escribir código.
Lee AGENTS.md y brief_focus_studio_es.md. Explícame en [tu idioma] qué vamos a construir y propón un plan en estas etapas: 2 el temporizador, 3 proyectos y tareas, 4 estadísticas, 5 idiomas, 6 punto de recuperación, 7 datos, 8 app de escritorio, 9 instalador de Windows, 10 landing de la app, 11 publicación. Para cada etapa, dime qué ficheros crearás o cambiarás. Hazme las preguntas que necesites. No cambies nada todavía.
Responded a sus preguntas en el mismo chat. Si el plan no os convence, pedid el cambio antes de aprobarlo.
02El temporizador
Objetivo una primera versión que ya funciona: el reloj de concentración con sus pausas.
Etapa 2. Crea index.html, styles.css y app.js con el temporizador del brief: concentración de 25 minutos, pausa corta de 5 y pausa larga de 15 cada cuatro bloques; botones Empezar, Pausa y Reiniciar; aviso sonoro y visual al terminar; reloj grande; modo claro y oscuro. Carga los textos desde textos.json, de momento en castellano. Para probarlo, sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado en http://localhost:8000 y pasa las comprobaciones de la etapa 2 de proves_focus_studio.md.
Para comprobar el aviso sin esperar 25 minutos, pedid a Codex un modo de prueba temporal:
Añade un modo de prueba que se active con ?prueba en la dirección y haga que cada bloque dure 10 segundos. Explícame cómo activarlo.
http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.03Proyectos y tareas
Objetivo organizar el trabajo y elegir en qué tarea se concentra cada bloque.
Etapa 3. Añade proyectos y tareas: crear, editar, marcar como hechas y borrar con confirmación. Cada tarea pertenece a un proyecto y tiene una estimación de bloques. Antes de empezar un bloque se puede elegir la tarea. Guarda todo en localStorage para que siga ahí al cerrar. Enséñame el resultado en el navegador integrado y pasa las comprobaciones de la etapa 3.
04Estadísticas
Objetivo ver adónde se va el tiempo con cifras y un gráfico.
Etapa 4. Registra cada bloque terminado con fecha, hora, proyecto y tarea. Añade una vista de estadísticas con bloques de hoy, de esta semana y por proyecto, la racha de días seguidos y un gráfico de barras de los últimos siete días dibujado con SVG, sin librerías. Para probarlo, crea un botón temporal que genere sesiones de ejemplo de la última semana y otro que las borre. Pasa las comprobaciones de la etapa 4.
05Idiomas
Objetivo la misma app en catalán, castellano e inglés.
Etapa 5. Añade un selector de idioma con català, castellano e English que cambie todos los textos visibles con los de textos.json y recuerde la elección. Busca en el código cualquier texto escrito a mano y pásalo a textos.json en los tres idiomas. Formatea fechas y números según el idioma. Pasa las comprobaciones de la etapa 5.
06Punto de recuperación y repaso
Objetivo guardar el trabajo de la sesión 1 para poder volver a este punto pase lo que pase.
Git guarda fotos del proyecto (commits). Si algo se estropea en la sesión 2, se vuelve a esta foto. Si no tenéis Git instalado, está en el apartado 11 del bloque 0.
Etapa 6. Repasa todas las comprobaciones de las etapas 2 a 5 de proves_focus_studio.md y dime cuáles pasan. Después inicia Git en esta carpeta, crea un .gitignore que excluya node_modules y dist, y haz un commit con el mensaje «Sesión 1: temporizador, tareas, estadísticas e idiomas». Explícame cómo volver a este punto si algo se estropea.
git log muestra el commit de la sesión 1 y el panel de revisión de Codex ya no marca cambios pendientes.git config --global user.name y user.email.Sesión 2 · Datos, instalador de Windows, landing y publicación
07Datos: exportar e importar
Objetivo que los datos se puedan guardar fuera de la app y recuperar, y cargar datos desde una hoja de cálculo.
Al empezar la sesión 2, abrid la misma carpeta en Codex y comprobad que todo sigue en su sitio:
Resúmeme en [tu idioma] en qué punto está el proyecto según git log y proves_focus_studio.md, y arranca la app en http://localhost:8000 para comprobar que funciona. No cambies nada.
Etapa 7. Añade en Configuración: Exportar datos (un fichero JSON con todos los datos y la configuración), Importar datos desde ese JSON e Importar desde CSV con el formato de tasques_exemple.csv. Si el fichero está mal formado, muestra un mensaje claro y no borres nada. Prueba la importación con tasques_exemple.csv y con un CSV estropeado que crees tú para la prueba. Pasa las comprobaciones de la etapa 7 y haz un commit.
08Convertirla en app de escritorio
Objetivo que Focus Studio se abra en su propia ventana, con su icono, como un programa.
Usamos Electron, la misma tecnología de apps como VS Code o Slack: envuelve la página en una ventana de escritorio. Necesita Node.js (apartado 11 del bloque 0) y descargar paquetes, así que Codex os pedirá permiso para usar internet.
Etapa 8. Convierte Focus Studio en app de escritorio con Electron: crea package.json (nombre focus-studio, versión 1.0.0), instala electron como dependencia de desarrollo y crea main.js con una ventana de 1000 × 700 que cargue index.html, use icona.png y no muestre la barra de menús. Asegúrate de que los textos de textos.json y los demás ficheros de datos se cargan dentro de Electron sin servidor. Añade el script start y ejecuta npm start. Pasa las comprobaciones de escritorio y haz un commit.
node --version
npm --version
npm start
npm no se reconoce, Node.js no está instalado o la app no se ha reiniciado después de instalarlo. Si sale «running scripts is disabled», es la política de PowerShell del apartado 06 del bloque 0. Si la ventana sale vacía, pedid a Codex que abra las herramientas de desarrollo de Electron y lea el error.09El instalador para Windows
Objetivo un fichero Focus-Studio-Setup-1.0.0.exe que cualquiera puede instalar en Windows.
Etapa 9. Prepara el instalador de Windows con electron-builder: instálalo como dependencia de desarrollo y añade en package.json la configuración build con appId com.cibernarium.focusstudio, productName Focus Studio, icono icona.png y destino nsis para Windows, que cree acceso directo en el escritorio y en el menú Inicio y que el fichero se llame Focus-Studio-Setup-${version}.exe. Añade el script dist (electron-builder --win) y ejecútalo. Dime dónde ha quedado el .exe y cuánto ocupa.npm run dist
Instalar y probar
- Abrid la carpeta distDoble clic en
Focus-Studio-Setup-1.0.0.exe. - Aviso de SmartScreenWindows mostrará «Windows protegió su PC» porque la app no está firmada con un certificado de empresa. Es lo esperado en una app propia: pulsad Más información y después Ejecutar de todas formas.
- Instalad y abridLa instalación es para vuestro usuario y no pide permisos de administrador. Abrid Focus Studio desde el menú Inicio.
- DesinstalarConfiguración de Windows › Aplicaciones › Aplicaciones instaladas › Focus Studio.
electron-builder --mac y obtendréis el instalador para macOS.dist está Focus-Studio-Setup-1.0.0.exe. Instalada, la app abre desde el menú Inicio y conserva los datos al cerrarla y abrirla.10La landing de Focus Studio
Objetivo una página web que presente la app con su copy, una captura y el botón de descarga, con el estilo de una web de referencia.
Elegid una web cuyo diseño os guste (la de una app, un estudio o una marca) y copiad su dirección. Codex la mira en el navegador integrado, extrae el sistema visual (tipografías, colores, espacios, botones) y lo aplica a vuestra landing con textos propios. También podéis pegar una captura de la referencia en el chat.
Etapa 10, primera parte. Abre en el navegador integrado [dirección de la web de referencia] y analiza su diseño: tipografías (busca equivalentes en Google Fonts), paleta de colores, escala de tamaños, espaciado, estilo de botones y de tarjetas. Escríbelo en docs/estil.md como un sistema propio para Focus Studio. No copies textos, logos ni imágenes de la referencia. Enséñame el resumen antes de seguir.
Etapa 10, segunda parte. Escribe el copy de la landing en [tu idioma] a partir de brief_focus_studio_es.md: titular, subtítulo, tres ventajas, cómo funciona en tres pasos, preguntas frecuentes y llamada a descargar. Tono claro y directo, sin exageraciones. Después crea docs/index.html con ese copy y el sistema de docs/estil.md: cabecera, captura de la app (hazla tú con el navegador integrado en http://localhost:8000 y guárdala como docs/captura.png), ventajas, pasos, botón Descargar para Windows que apunte a https://github.com/[tu usuario]/focus-studio/releases/latest/download/Focus-Studio-Setup-1.0.0.exe, preguntas y pie. Responsive, accesible y en un solo fichero de estilos. Ábrela en el navegador integrado a 1440 y a 390 px y pasa las comprobaciones de la etapa 10.
Para iterar, usad los comentarios del navegador integrado sobre la propia página («este titular más corto», «más aire entre secciones») o pedid cambios concretos en el chat.
11Publicar: GitHub, instalador y landing en línea
Objetivo el código en GitHub, el instalador en una release y la landing publicada con su dirección pública.
Necesitáis la cuenta de GitHub y gh auth login del apartado 12 del bloque 0. GitHub Pages publica gratis la carpeta docs de un repositorio público.
Etapa 11. Repasa todas las comprobaciones de proves_focus_studio.md y dime cuáles pasan. Crea un README.md en [tu idioma] que explique qué es Focus Studio, cómo se instala y cómo se arranca en modo desarrollo. Haz un commit, crea con gh un repositorio público llamado focus-studio en mi cuenta y súbelo. Crea una release v1.0.0 con dist/Focus-Studio-Setup-1.0.0.exe adjunto. Activa GitHub Pages desde la rama main y la carpeta /docs, espera a que esté publicada y dame la dirección. Pídeme permiso antes de cada paso que suba algo.
gh repo view --web
gh release view v1.0.0
gh api repos/{owner}/focus-studio/pages
https://vuestro-usuario.github.io/focus-studio/ y su botón descarga el instalador de la release.gh release view. Si gh dice que no estáis autenticados, repetid gh auth login.Biblioteca Studio
Tu biblioteca personal: libros leídos, en curso y pendientes, valoraciones, préstamos y objetivo de lectura anual.
Sesión 1 · De la idea a una app que funciona
00Preparar la carpeta y los materiales
Objetivo tener la carpeta del proyecto abierta en Codex con todos los ficheros de trabajo.
Si todavía no tenéis Codex instalado y configurado, empezad por el bloque 0 · Instalar y configurar Codex. Después:
- Descargad los materialesbiblioteca-studio-materials.zip (10 KB, 8 ficheros).
- Descomprimid la carpetaDentro de vuestra carpeta de usuario, por ejemplo
Documentos\biblioteca-studio-materials. Fuera de OneDrive y de la raíz deC:\. - Abridla en CodexAdd new project (Ctrl+O) y elegid la carpeta. Dejad los permisos en Ask for approval.
- Comprobad que Codex la entiendeCon el prompt de abajo.
Lista los ficheros de esta carpeta y explícame en [tu idioma], en una línea cada uno, para qué sirve. No cambies nada.
Qué hay en la carpeta (y cómo crear cada fichero si no podéis descargar el zip)
AGENTS.mdInstrucciones que Codex lee siempre en esta carpeta.Crear este fichero con un prompt
Crea en esta carpeta un AGENTS.md para el proyecto Biblioteca Studio: tu biblioteca personal: libros leídos, en curso y pendientes, valoraciones, préstamos y objetivo de lectura anual. Se hace con HTML, CSS y JavaScript sin frameworks y se empaqueta para Windows con Electron. Indica: responde siempre en el idioma del usuario; explica el plan antes de cambiar ficheros y espera confirmación; haz una etapa cada vez; trabaja solo dentro de esta carpeta y no borres nada sin preguntar; avisa antes de órdenes que necesiten internet; todos los textos visibles salen de textos.json (ca, es, en); los datos se guardan en el dispositivo; accesible con teclado; al terminar cada etapa, pasa las comprobaciones de proves.md.
brief_es.md / brief_ca.mdEl encargo: qué hace la app y cómo se comprueba.Crear este fichero con un prompt
Crea brief_es.md con el encargo de Biblioteca Studio: Tu biblioteca personal: libros leídos, en curso y pendientes, valoraciones, préstamos y objetivo de lectura anual. Incluye objetivo, qué tiene que hacer por etapas (el catálogo de libros; préstamos; estadísticas de lectura; idiomas ca/es/en desde textos.json; exportar e importar JSON e importar CSV; ventana Electron con icono e instalador; landing publicada en GitHub Pages), aspecto, fuera de alcance y cómo sabremos que está bien.
textos.jsonTodos los textos de la interfaz en ca, es y en.Crear este fichero con un prompt
Crea textos.json con tres bloques, "ca", "es" y "en", con las mismas claves en los tres para todos los textos que necesitará la interfaz de Biblioteca Studio según el brief: botones, campos, filtros, estadísticas, configuración, mensajes de confirmación y de error. Traduce cada texto con naturalidad.
llibres_exemple.csvDoce libros de ejemplo con estado, valoración y préstamos.Crear este fichero con un prompt
Crea llibres_exemple.csv con las columnas titol,autor,genere,pagines,estat,valoracio,data_fi,prestat_a,data_prestec y doce libros clásicos de la literatura catalana y castellana: seis con estat llegit (con data_fi de 2026 y valoracio de 1 a 5), dos llegint y cuatro pendent; dos de los leídos prestados a una persona inventada con su fecha de préstamo.
proves.mdComprobaciones de cada etapa, con casillas.Crear este fichero con un prompt
Crea proves.md con una lista de comprobaciones con casillas para cada etapa de Biblioteca Studio según el brief, más idiomas, datos (exportar, importar JSON y CSV, CSV mal formado), escritorio, instalador de Windows, landing y publicación. Cada comprobación tiene que poder verificarse mirando la app.
icona.pngIcono de 512 × 512 para el instalador.Crear este fichero con un prompt
Crea icona.png de 512 × 512 píxeles para Biblioteca Studio: un cuadrado redondeado de color oscuro con un símbolo sencillo y claro que represente la app. Usa Python con Pillow; si no está instalado, pídeme permiso para instalarlo.
biblioteca-studio-materials.01Leer el encargo y planificar
Objetivo que Codex explique qué va a construir y en qué orden antes de escribir código.
Lee AGENTS.md y brief_es.md. Explícame en [tu idioma] qué vamos a construir y propón un plan en estas etapas: 2 el catálogo de libros, 3 préstamos, 4 estadísticas de lectura, 5 idiomas, 6 punto de recuperación, 7 datos, 8 app de escritorio, 9 instalador de Windows, 10 landing de la app, 11 publicación. Para cada etapa, dime qué ficheros crearás o cambiarás. Hazme las preguntas que necesites. No cambies nada todavía.
Responded a sus preguntas en el mismo chat. Si el plan no os convence, pedid el cambio antes de aprobarlo.
02El catálogo de libros
Objetivo una primera versión que ya funciona: añadir, buscar y filtrar libros.
Etapa 2. Crea index.html, styles.css y app.js con el catálogo de Biblioteca Studio: añadir, editar y borrar libros (título, autor, género, páginas, estado leído/leyendo/pendiente y valoración de 1 a 5 estrellas); lista con buscador por título o autor y filtro por estado. Guarda todo en localStorage. Carga los textos desde textos.json, de momento en castellano. Para probarlo, sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado en http://localhost:8000 y pasa las comprobaciones de la etapa 2 de proves.md.
http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.03Préstamos
Objetivo saber qué libros están prestados, a quién y desde cuándo.
Etapa 3. Añade los préstamos: prestar un libro (a quién y fecha), marcarlo como devuelto y ver la lista de préstamos activos. Los que lleven más de 30 días se marcan como atrasados con un aviso visible. Un libro prestado muestra a quién en su ficha. Enséñame el resultado en el navegador integrado y pasa las comprobaciones de la etapa 3.
04Estadísticas de lectura
Objetivo ver cuánto y qué leéis, y si vais bien con el objetivo del año.
Etapa 4. Al marcar un libro como leído, guarda la fecha de fin. Añade una vista de estadísticas: libros leídos este año frente a un objetivo anual configurable (24 por defecto) con barra de progreso, páginas leídas, libros por género y un gráfico de barras de libros leídos por mes dibujado con SVG, sin librerías. Para probarlo, crea un botón temporal que genere lecturas de ejemplo y otro que las borre. Pasa las comprobaciones de la etapa 4.
05Idiomas
Objetivo la misma app en catalán, castellano e inglés.
Etapa 5. Añade un selector de idioma con català, castellano e English que cambie todos los textos visibles con los de textos.json y recuerde la elección. Busca en el código cualquier texto escrito a mano y pásalo a textos.json en los tres idiomas. Formatea fechas y números según el idioma. Pasa las comprobaciones de la etapa 5.
06Punto de recuperación y repaso
Objetivo guardar el trabajo de la sesión 1 para poder volver a este punto pase lo que pase.
Git guarda fotos del proyecto (commits). Si algo se estropea en la sesión 2, se vuelve a esta foto. Si no tenéis Git instalado, está en el apartado 11 del bloque 0.
Etapa 6. Repasa todas las comprobaciones de las etapas 2 a 5 de proves.md y dime cuáles pasan. Después inicia Git en esta carpeta, crea un .gitignore que excluya node_modules y dist, y haz un commit con el mensaje «Sesión 1: catálogo, préstamos, estadísticas e idiomas». Explícame cómo volver a este punto si algo se estropea.
git log muestra el commit de la sesión 1 y el panel de revisión de Codex ya no marca cambios pendientes.git config --global user.name y user.email.Sesión 2 · Datos, instalador de Windows, landing y publicación
07Datos: exportar e importar
Objetivo que los datos se puedan guardar fuera de la app y recuperar, y cargar datos desde una hoja de cálculo.
Al empezar la sesión 2, abrid la misma carpeta en Codex y comprobad que todo sigue en su sitio:
Resúmeme en [tu idioma] en qué punto está el proyecto según git log y proves.md, y arranca la app en http://localhost:8000 para comprobar que funciona. No cambies nada.
Etapa 7. Añade en Configuración: Exportar datos (un fichero JSON con todos los datos y la configuración), Importar datos desde ese JSON e Importar desde CSV con el formato de llibres_exemple.csv. Si el fichero está mal formado, muestra un mensaje claro y no borres nada. Prueba la importación con llibres_exemple.csv y con un CSV estropeado que crees tú para la prueba. Pasa las comprobaciones de la etapa 7 y haz un commit.
08Convertirla en app de escritorio
Objetivo que Biblioteca Studio se abra en su propia ventana, con su icono, como un programa.
Usamos Electron, la misma tecnología de apps como VS Code o Slack: envuelve la página en una ventana de escritorio. Necesita Node.js (apartado 11 del bloque 0) y descargar paquetes, así que Codex os pedirá permiso para usar internet.
Etapa 8. Convierte Biblioteca Studio en app de escritorio con Electron: crea package.json (nombre biblioteca-studio, versión 1.0.0), instala electron como dependencia de desarrollo y crea main.js con una ventana de 1000 × 700 que cargue index.html, use icona.png y no muestre la barra de menús. Asegúrate de que los textos de textos.json y los demás ficheros de datos se cargan dentro de Electron sin servidor. Añade el script start y ejecuta npm start. Pasa las comprobaciones de escritorio y haz un commit.
node --version
npm --version
npm start
npm no se reconoce, Node.js no está instalado o la app no se ha reiniciado después de instalarlo. Si sale «running scripts is disabled», es la política de PowerShell del apartado 06 del bloque 0. Si la ventana sale vacía, pedid a Codex que abra las herramientas de desarrollo de Electron y lea el error.09El instalador para Windows
Objetivo un fichero Biblioteca-Studio-Setup-1.0.0.exe que cualquiera puede instalar en Windows.
Etapa 9. Prepara el instalador de Windows con electron-builder: instálalo como dependencia de desarrollo y añade en package.json la configuración build con appId com.cibernarium.bibliotecastudio, productName Biblioteca Studio, icono icona.png y destino nsis para Windows, que cree acceso directo en el escritorio y en el menú Inicio y que el fichero se llame Biblioteca-Studio-Setup-${version}.exe. Añade el script dist (electron-builder --win) y ejecútalo. Dime dónde ha quedado el .exe y cuánto ocupa.npm run dist
Instalar y probar
- Abrid la carpeta distDoble clic en
Biblioteca-Studio-Setup-1.0.0.exe. - Aviso de SmartScreenWindows mostrará «Windows protegió su PC» porque la app no está firmada con un certificado de empresa. Es lo esperado en una app propia: pulsad Más información y después Ejecutar de todas formas.
- Instalad y abridLa instalación es para vuestro usuario y no pide permisos de administrador. Abrid Biblioteca Studio desde el menú Inicio.
- DesinstalarConfiguración de Windows › Aplicaciones › Aplicaciones instaladas › Biblioteca Studio.
electron-builder --mac y obtendréis el instalador para macOS.dist está Biblioteca-Studio-Setup-1.0.0.exe. Instalada, la app abre desde el menú Inicio y conserva los datos al cerrarla y abrirla.10La landing de Biblioteca Studio
Objetivo una página web que presente la app con su copy, una captura y el botón de descarga, con el estilo de una web de referencia.
Elegid una web cuyo diseño os guste (la de una app, un estudio o una marca) y copiad su dirección. Codex la mira en el navegador integrado, extrae el sistema visual (tipografías, colores, espacios, botones) y lo aplica a vuestra landing con textos propios. También podéis pegar una captura de la referencia en el chat.
Etapa 10, primera parte. Abre en el navegador integrado [dirección de la web de referencia] y analiza su diseño: tipografías (busca equivalentes en Google Fonts), paleta de colores, escala de tamaños, espaciado, estilo de botones y de tarjetas. Escríbelo en docs/estil.md como un sistema propio para Biblioteca Studio. No copies textos, logos ni imágenes de la referencia. Enséñame el resumen antes de seguir.
Etapa 10, segunda parte. Escribe el copy de la landing en [tu idioma] a partir de brief_es.md: titular, subtítulo, tres ventajas, cómo funciona en tres pasos, preguntas frecuentes y llamada a descargar. Tono claro y directo, sin exageraciones. Después crea docs/index.html con ese copy y el sistema de docs/estil.md: cabecera, captura de la app (hazla tú con el navegador integrado en http://localhost:8000 y guárdala como docs/captura.png), ventajas, pasos, botón Descargar para Windows que apunte a https://github.com/[tu usuario]/biblioteca-studio/releases/latest/download/Biblioteca-Studio-Setup-1.0.0.exe, preguntas y pie. Responsive, accesible y en un solo fichero de estilos. Ábrela en el navegador integrado a 1440 y a 390 px y pasa las comprobaciones de la etapa 10.
Para iterar, usad los comentarios del navegador integrado sobre la propia página («este titular más corto», «más aire entre secciones») o pedid cambios concretos en el chat.
11Publicar: GitHub, instalador y landing en línea
Objetivo el código en GitHub, el instalador en una release y la landing publicada con su dirección pública.
Necesitáis la cuenta de GitHub y gh auth login del apartado 12 del bloque 0. GitHub Pages publica gratis la carpeta docs de un repositorio público.
Etapa 11. Repasa todas las comprobaciones de proves.md y dime cuáles pasan. Crea un README.md en [tu idioma] que explique qué es Biblioteca Studio, cómo se instala y cómo se arranca en modo desarrollo. Haz un commit, crea con gh un repositorio público llamado biblioteca-studio en mi cuenta y súbelo. Crea una release v1.0.0 con dist/Biblioteca-Studio-Setup-1.0.0.exe adjunto. Activa GitHub Pages desde la rama main y la carpeta /docs, espera a que esté publicada y dame la dirección. Pídeme permiso antes de cada paso que suba algo.
gh repo view --web
gh release view v1.0.0
gh api repos/{owner}/biblioteca-studio/pages
https://vuestro-usuario.github.io/biblioteca-studio/ y su botón descarga el instalador de la release.gh release view. Si gh dice que no estáis autenticados, repetid gh auth login.Astronomia Studio
Diario de observación del cielo: qué visteis, dónde, con qué y en qué condiciones, con la fase de la Luna de cada noche calculada en la propia app.
Sesión 1 · De la idea a una app que funciona
00Preparar la carpeta y los materiales
Objetivo tener la carpeta del proyecto abierta en Codex con todos los ficheros de trabajo.
Si todavía no tenéis Codex instalado y configurado, empezad por el bloque 0 · Instalar y configurar Codex. Después:
- Descargad los materialesastronomia-studio-materials.zip (11 KB, 8 ficheros).
- Descomprimid la carpetaDentro de vuestra carpeta de usuario, por ejemplo
Documentos\astronomia-studio-materials. Fuera de OneDrive y de la raíz deC:\. - Abridla en CodexAdd new project (Ctrl+O) y elegid la carpeta. Dejad los permisos en Ask for approval.
- Comprobad que Codex la entiendeCon el prompt de abajo.
Lista los ficheros de esta carpeta y explícame en [tu idioma], en una línea cada uno, para qué sirve. No cambies nada.
Qué hay en la carpeta (y cómo crear cada fichero si no podéis descargar el zip)
AGENTS.mdInstrucciones que Codex lee siempre en esta carpeta.Crear este fichero con un prompt
Crea en esta carpeta un AGENTS.md para el proyecto Astronomia Studio: diario de observación del cielo: qué visteis, dónde, con qué y en qué condiciones, con la fase de la Luna de cada noche calculada en la propia app. Se hace con HTML, CSS y JavaScript sin frameworks y se empaqueta para Windows con Electron. Indica: responde siempre en el idioma del usuario; explica el plan antes de cambiar ficheros y espera confirmación; haz una etapa cada vez; trabaja solo dentro de esta carpeta y no borres nada sin preguntar; avisa antes de órdenes que necesiten internet; todos los textos visibles salen de textos.json (ca, es, en); los datos se guardan en el dispositivo; accesible con teclado; al terminar cada etapa, pasa las comprobaciones de proves.md.
brief_es.md / brief_ca.mdEl encargo: qué hace la app y cómo se comprueba.Crear este fichero con un prompt
Crea brief_es.md con el encargo de Astronomia Studio: Diario de observación del cielo: qué visteis, dónde, con qué y en qué condiciones, con la fase de la Luna de cada noche calculada en la propia app. Incluye objetivo, qué tiene que hacer por etapas (el diario de observaciones; la fase de la luna; estadísticas del cielo; idiomas ca/es/en desde textos.json; exportar e importar JSON e importar CSV; ventana Electron con icono e instalador; landing publicada en GitHub Pages), aspecto, fuera de alcance y cómo sabremos que está bien.
textos.jsonTodos los textos de la interfaz en ca, es y en.Crear este fichero con un prompt
Crea textos.json con tres bloques, "ca", "es" y "en", con las mismas claves en los tres para todos los textos que necesitará la interfaz de Astronomia Studio según el brief: botones, campos, filtros, estadísticas, configuración, mensajes de confirmación y de error. Traduce cada texto con naturalidad.
observacions_exemple.csvDiez observaciones de ejemplo desde Barcelona y alrededores.Crear este fichero con un prompt
Crea observacions_exemple.csv con las columnas data,hora,lloc,objecte,tipus,instrument,cel,notes y diez observaciones inventadas de 2026 desde Barcelona y alrededores (Collserola, Montseny, el Garraf), con tipus entre lluna, planeta, estrella, constel·lació, cúmul, nebulosa y galàxia, instrumento (ull nu, prismàtics o telescopi) y calidad del cielo cel de 1 a 5.
proves.mdComprobaciones de cada etapa, con casillas.Crear este fichero con un prompt
Crea proves.md con una lista de comprobaciones con casillas para cada etapa de Astronomia Studio según el brief, más idiomas, datos (exportar, importar JSON y CSV, CSV mal formado), escritorio, instalador de Windows, landing y publicación. Cada comprobación tiene que poder verificarse mirando la app.
icona.pngIcono de 512 × 512 para el instalador.Crear este fichero con un prompt
Crea icona.png de 512 × 512 píxeles para Astronomia Studio: un cuadrado redondeado de color oscuro con un símbolo sencillo y claro que represente la app. Usa Python con Pillow; si no está instalado, pídeme permiso para instalarlo.
astronomia-studio-materials.01Leer el encargo y planificar
Objetivo que Codex explique qué va a construir y en qué orden antes de escribir código.
Lee AGENTS.md y brief_es.md. Explícame en [tu idioma] qué vamos a construir y propón un plan en estas etapas: 2 el diario de observaciones, 3 la fase de la luna, 4 estadísticas del cielo, 5 idiomas, 6 punto de recuperación, 7 datos, 8 app de escritorio, 9 instalador de Windows, 10 landing de la app, 11 publicación. Para cada etapa, dime qué ficheros crearás o cambiarás. Hazme las preguntas que necesites. No cambies nada todavía.
Responded a sus preguntas en el mismo chat. Si el plan no os convence, pedid el cambio antes de aprobarlo.
02El diario de observaciones
Objetivo una primera versión que ya funciona: anotar lo que habéis observado.
Etapa 2. Crea index.html, styles.css y app.js con el diario de Astronomia Studio: añadir, editar y borrar observaciones (fecha, hora, lugar, objeto, tipo —luna, planeta, estrella, constelación, cúmulo, nebulosa, galaxia u otro—, instrumento, calidad del cielo de 1 a 5 y notas); lista ordenada de la más reciente a la más antigua con filtro por tipo. Interfaz oscura que no deslumbre de noche. Guarda todo en localStorage. Carga los textos desde textos.json, de momento en castellano. Sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado y pasa las comprobaciones de la etapa 2 de proves.md.
http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.03La fase de la Luna
Objetivo calcular en la app, sin internet, la fase lunar de cualquier día.
Etapa 3. Calcula la fase de la Luna de cualquier fecha sin conexión: usa como referencia la luna nueva del 6 de enero de 2000 a las 18:14 UTC y un mes sinódico de 29,530588853 días. Muestra el nombre de la fase (nueva, creciente, cuarto creciente, gibosa creciente, llena, gibosa menguante, cuarto menguante, menguante), el porcentaje iluminado y un dibujo de la Luna en SVG. Añade un calendario del mes con la fase de cada día y muestra la fase en cada observación. Pasa las comprobaciones de la etapa 3.
04Estadísticas del cielo
Objetivo ver qué y cuándo observáis más, y con qué cielo.
Etapa 4. Añade una vista de estadísticas: observaciones por mes (gráfico de barras en SVG, sin librerías), por tipo de objeto, los cinco objetos más observados, calidad media del cielo por lugar y cuántas observaciones se hicieron con Luna llena o casi llena. Para probarlo, crea un botón temporal que genere observaciones de ejemplo y otro que las borre. Pasa las comprobaciones de la etapa 4.
05Idiomas
Objetivo la misma app en catalán, castellano e inglés.
Etapa 5. Añade un selector de idioma con català, castellano e English que cambie todos los textos visibles con los de textos.json y recuerde la elección. Busca en el código cualquier texto escrito a mano y pásalo a textos.json en los tres idiomas. Formatea fechas y números según el idioma. Pasa las comprobaciones de la etapa 5.
06Punto de recuperación y repaso
Objetivo guardar el trabajo de la sesión 1 para poder volver a este punto pase lo que pase.
Git guarda fotos del proyecto (commits). Si algo se estropea en la sesión 2, se vuelve a esta foto. Si no tenéis Git instalado, está en el apartado 11 del bloque 0.
Etapa 6. Repasa todas las comprobaciones de las etapas 2 a 5 de proves.md y dime cuáles pasan. Después inicia Git en esta carpeta, crea un .gitignore que excluya node_modules y dist, y haz un commit con el mensaje «Sesión 1: diario, fases de la Luna, estadísticas e idiomas». Explícame cómo volver a este punto si algo se estropea.
git log muestra el commit de la sesión 1 y el panel de revisión de Codex ya no marca cambios pendientes.git config --global user.name y user.email.Sesión 2 · Datos, instalador de Windows, landing y publicación
07Datos: exportar e importar
Objetivo que los datos se puedan guardar fuera de la app y recuperar, y cargar datos desde una hoja de cálculo.
Al empezar la sesión 2, abrid la misma carpeta en Codex y comprobad que todo sigue en su sitio:
Resúmeme en [tu idioma] en qué punto está el proyecto según git log y proves.md, y arranca la app en http://localhost:8000 para comprobar que funciona. No cambies nada.
Etapa 7. Añade en Configuración: Exportar datos (un fichero JSON con todos los datos y la configuración), Importar datos desde ese JSON e Importar desde CSV con el formato de observacions_exemple.csv. Si el fichero está mal formado, muestra un mensaje claro y no borres nada. Prueba la importación con observacions_exemple.csv y con un CSV estropeado que crees tú para la prueba. Pasa las comprobaciones de la etapa 7 y haz un commit.
08Convertirla en app de escritorio
Objetivo que Astronomia Studio se abra en su propia ventana, con su icono, como un programa.
Usamos Electron, la misma tecnología de apps como VS Code o Slack: envuelve la página en una ventana de escritorio. Necesita Node.js (apartado 11 del bloque 0) y descargar paquetes, así que Codex os pedirá permiso para usar internet.
Etapa 8. Convierte Astronomia Studio en app de escritorio con Electron: crea package.json (nombre astronomia-studio, versión 1.0.0), instala electron como dependencia de desarrollo y crea main.js con una ventana de 1000 × 700 que cargue index.html, use icona.png y no muestre la barra de menús. Asegúrate de que los textos de textos.json y los demás ficheros de datos se cargan dentro de Electron sin servidor. Añade el script start y ejecuta npm start. Pasa las comprobaciones de escritorio y haz un commit.
node --version
npm --version
npm start
npm no se reconoce, Node.js no está instalado o la app no se ha reiniciado después de instalarlo. Si sale «running scripts is disabled», es la política de PowerShell del apartado 06 del bloque 0. Si la ventana sale vacía, pedid a Codex que abra las herramientas de desarrollo de Electron y lea el error.09El instalador para Windows
Objetivo un fichero Astronomia-Studio-Setup-1.0.0.exe que cualquiera puede instalar en Windows.
Etapa 9. Prepara el instalador de Windows con electron-builder: instálalo como dependencia de desarrollo y añade en package.json la configuración build con appId com.cibernarium.astronomiastudio, productName Astronomia Studio, icono icona.png y destino nsis para Windows, que cree acceso directo en el escritorio y en el menú Inicio y que el fichero se llame Astronomia-Studio-Setup-${version}.exe. Añade el script dist (electron-builder --win) y ejecútalo. Dime dónde ha quedado el .exe y cuánto ocupa.npm run dist
Instalar y probar
- Abrid la carpeta distDoble clic en
Astronomia-Studio-Setup-1.0.0.exe. - Aviso de SmartScreenWindows mostrará «Windows protegió su PC» porque la app no está firmada con un certificado de empresa. Es lo esperado en una app propia: pulsad Más información y después Ejecutar de todas formas.
- Instalad y abridLa instalación es para vuestro usuario y no pide permisos de administrador. Abrid Astronomia Studio desde el menú Inicio.
- DesinstalarConfiguración de Windows › Aplicaciones › Aplicaciones instaladas › Astronomia Studio.
electron-builder --mac y obtendréis el instalador para macOS.dist está Astronomia-Studio-Setup-1.0.0.exe. Instalada, la app abre desde el menú Inicio y conserva los datos al cerrarla y abrirla.10La landing de Astronomia Studio
Objetivo una página web que presente la app con su copy, una captura y el botón de descarga, con el estilo de una web de referencia.
Elegid una web cuyo diseño os guste (la de una app, un estudio o una marca) y copiad su dirección. Codex la mira en el navegador integrado, extrae el sistema visual (tipografías, colores, espacios, botones) y lo aplica a vuestra landing con textos propios. También podéis pegar una captura de la referencia en el chat.
Etapa 10, primera parte. Abre en el navegador integrado [dirección de la web de referencia] y analiza su diseño: tipografías (busca equivalentes en Google Fonts), paleta de colores, escala de tamaños, espaciado, estilo de botones y de tarjetas. Escríbelo en docs/estil.md como un sistema propio para Astronomia Studio. No copies textos, logos ni imágenes de la referencia. Enséñame el resumen antes de seguir.
Etapa 10, segunda parte. Escribe el copy de la landing en [tu idioma] a partir de brief_es.md: titular, subtítulo, tres ventajas, cómo funciona en tres pasos, preguntas frecuentes y llamada a descargar. Tono claro y directo, sin exageraciones. Después crea docs/index.html con ese copy y el sistema de docs/estil.md: cabecera, captura de la app (hazla tú con el navegador integrado en http://localhost:8000 y guárdala como docs/captura.png), ventajas, pasos, botón Descargar para Windows que apunte a https://github.com/[tu usuario]/astronomia-studio/releases/latest/download/Astronomia-Studio-Setup-1.0.0.exe, preguntas y pie. Responsive, accesible y en un solo fichero de estilos. Ábrela en el navegador integrado a 1440 y a 390 px y pasa las comprobaciones de la etapa 10.
Para iterar, usad los comentarios del navegador integrado sobre la propia página («este titular más corto», «más aire entre secciones») o pedid cambios concretos en el chat.
11Publicar: GitHub, instalador y landing en línea
Objetivo el código en GitHub, el instalador en una release y la landing publicada con su dirección pública.
Necesitáis la cuenta de GitHub y gh auth login del apartado 12 del bloque 0. GitHub Pages publica gratis la carpeta docs de un repositorio público.
Etapa 11. Repasa todas las comprobaciones de proves.md y dime cuáles pasan. Crea un README.md en [tu idioma] que explique qué es Astronomia Studio, cómo se instala y cómo se arranca en modo desarrollo. Haz un commit, crea con gh un repositorio público llamado astronomia-studio en mi cuenta y súbelo. Crea una release v1.0.0 con dist/Astronomia-Studio-Setup-1.0.0.exe adjunto. Activa GitHub Pages desde la rama main y la carpeta /docs, espera a que esté publicada y dame la dirección. Pídeme permiso antes de cada paso que suba algo.
gh repo view --web
gh release view v1.0.0
gh api repos/{owner}/astronomia-studio/pages
https://vuestro-usuario.github.io/astronomia-studio/ y su botón descarga el instalador de la release.gh release view. Si gh dice que no estáis autenticados, repetid gh auth login.QR Studio
Generador de códigos QR para los carteles de una cafetería: enlace, diseño del cartel, campañas con seguimiento y exportación en PNG y SVG.
Sesión 1 · De la idea a una app que funciona
00Preparar la carpeta y los materiales
Objetivo tener la carpeta del proyecto abierta en Codex con todos los ficheros de trabajo.
Si todavía no tenéis Codex instalado y configurado, empezad por el bloque 0 · Instalar y configurar Codex. Después:
- Descargad los materialesqr-studio-materials.zip (9 KB, 8 ficheros).
- Descomprimid la carpetaDentro de vuestra carpeta de usuario, por ejemplo
Documentos\qr-studio-materials. Fuera de OneDrive y de la raíz deC:\. - Abridla en CodexAdd new project (Ctrl+O) y elegid la carpeta. Dejad los permisos en Ask for approval.
- Comprobad que Codex la entiendeCon el prompt de abajo.
Lista los ficheros de esta carpeta y explícame en [tu idioma], en una línea cada uno, para qué sirve. No cambies nada.
Qué hay en la carpeta (y cómo crear cada fichero si no podéis descargar el zip)
AGENTS.mdInstrucciones que Codex lee siempre en esta carpeta.Crear este fichero con un prompt
Crea en esta carpeta un AGENTS.md para el proyecto QR Studio: generador de códigos QR para los carteles de una cafetería: enlace, diseño del cartel, campañas con seguimiento y exportación en PNG y SVG. Se hace con HTML, CSS y JavaScript sin frameworks y se empaqueta para Windows con Electron. Indica: responde siempre en el idioma del usuario; explica el plan antes de cambiar ficheros y espera confirmación; haz una etapa cada vez; trabaja solo dentro de esta carpeta y no borres nada sin preguntar; avisa antes de órdenes que necesiten internet; todos los textos visibles salen de textos.json (ca, es, en); los datos se guardan en el dispositivo; accesible con teclado; al terminar cada etapa, pasa las comprobaciones de proves.md.
brief_es.md / brief_ca.mdEl encargo: qué hace la app y cómo se comprueba.Crear este fichero con un prompt
Crea brief_es.md con el encargo de QR Studio: Generador de códigos QR para los carteles de una cafetería: enlace, diseño del cartel, campañas con seguimiento y exportación en PNG y SVG. Incluye objetivo, qué tiene que hacer por etapas (generar el código qr; diseñar el cartel; campañas y variantes; idiomas ca/es/en desde textos.json; exportar e importar JSON e importar CSV; ventana Electron con icono e instalador; landing publicada en GitHub Pages), aspecto, fuera de alcance y cómo sabremos que está bien.
textos.jsonTodos los textos de la interfaz en ca, es y en.Crear este fichero con un prompt
Crea textos.json con tres bloques, "ca", "es" y "en", con las mismas claves en los tres para todos los textos que necesitará la interfaz de QR Studio según el brief: botones, campos, filtros, estadísticas, configuración, mensajes de confirmación y de error. Traduce cada texto con naturalidad.
campanyes_exemple.csvSeis campañas de ejemplo de la cafetería Cafès Roca.Crear este fichero con un prompt
Crea campanyes_exemple.csv con las columnas nom,url,titol_cartell,text,color,data_inici,data_fi y seis campañas inventadas de la cafetería Cafès Roca (carta digital, menú de temporada, encuesta de satisfacción, tarjeta de fidelidad, Instagram y taller de catas), con direcciones en el dominio cafesroca.example; dos terminadas en septiembre de 2026 y cuatro activas hasta el 31 de diciembre de 2030.
proves.mdComprobaciones de cada etapa, con casillas.Crear este fichero con un prompt
Crea proves.md con una lista de comprobaciones con casillas para cada etapa de QR Studio según el brief, más idiomas, datos (exportar, importar JSON y CSV, CSV mal formado), escritorio, instalador de Windows, landing y publicación. Cada comprobación tiene que poder verificarse mirando la app.
icona.pngIcono de 512 × 512 para el instalador.Crear este fichero con un prompt
Crea icona.png de 512 × 512 píxeles para QR Studio: un cuadrado redondeado de color oscuro con un símbolo sencillo y claro que represente la app. Usa Python con Pillow; si no está instalado, pídeme permiso para instalarlo.
qr-studio-materials.01Leer el encargo y planificar
Objetivo que Codex explique qué va a construir y en qué orden antes de escribir código.
Lee AGENTS.md y brief_es.md. Explícame en [tu idioma] qué vamos a construir y propón un plan en estas etapas: 2 generar el código qr, 3 diseñar el cartel, 4 campañas y variantes, 5 idiomas, 6 punto de recuperación, 7 datos, 8 app de escritorio, 9 instalador de Windows, 10 landing de la app, 11 publicación. Para cada etapa, dime qué ficheros crearás o cambiarás. Hazme las preguntas que necesites. No cambies nada todavía.
Responded a sus preguntas en el mismo chat. Si el plan no os convence, pedid el cambio antes de aprobarlo.
02Generar el código QR
Objetivo una primera versión que ya funciona: escribir un enlace y obtener su QR.
Etapa 2. Crea index.html, styles.css y app.js con el generador de QR Studio: un campo para la dirección o el texto, aviso si la dirección no es válida, vista previa del QR, tamaño y nivel de corrección de errores (L, M, Q, H), y botones para descargar en PNG y en SVG. Para generar el código usa la librería qrcode-generator instalada con npm (es la única librería permitida en este proyecto); pídeme permiso para instalarla. Carga los textos desde textos.json, de momento en castellano. Sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado y pasa las comprobaciones de la etapa 2 de proves.md.
http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.03Diseñar el cartel
Objetivo convertir el QR en un cartel listo para imprimir.
Etapa 3. Añade el editor de cartel: formato A4 o A5 vertical, título, texto corto, color de fondo y de texto, el QR en el centro y un logotipo opcional que el usuario elige de su ordenador. Vista previa a escala y exportación del cartel en PNG a 300 ppp. Avisa si el contraste entre el QR y el fondo es insuficiente para escanearlo. Pasa las comprobaciones de la etapa 3.
04Campañas y variantes
Objetivo guardar cada cartel como campaña y saber de dónde vienen las visitas.
Etapa 4. Añade las campañas: guardar el cartel con nombre, dirección, diseño y fechas de inicio y fin; duplicar una campaña como variante; añadir automáticamente a la dirección los parámetros utm_source=cartell y utm_campaign con el nombre de la campaña sin espacios; y una lista con estado activa o terminada según la fecha de hoy. Pasa las comprobaciones de la etapa 4.
05Idiomas
Objetivo la misma app en catalán, castellano e inglés.
Etapa 5. Añade un selector de idioma con català, castellano e English que cambie todos los textos visibles con los de textos.json y recuerde la elección. Busca en el código cualquier texto escrito a mano y pásalo a textos.json en los tres idiomas. Formatea fechas y números según el idioma. Pasa las comprobaciones de la etapa 5.
06Punto de recuperación y repaso
Objetivo guardar el trabajo de la sesión 1 para poder volver a este punto pase lo que pase.
Git guarda fotos del proyecto (commits). Si algo se estropea en la sesión 2, se vuelve a esta foto. Si no tenéis Git instalado, está en el apartado 11 del bloque 0.
Etapa 6. Repasa todas las comprobaciones de las etapas 2 a 5 de proves.md y dime cuáles pasan. Después inicia Git en esta carpeta, crea un .gitignore que excluya node_modules y dist, y haz un commit con el mensaje «Sesión 1: generador, cartel, campañas e idiomas». Explícame cómo volver a este punto si algo se estropea.
git log muestra el commit de la sesión 1 y el panel de revisión de Codex ya no marca cambios pendientes.git config --global user.name y user.email.Sesión 2 · Datos, instalador de Windows, landing y publicación
07Datos: exportar e importar
Objetivo que los datos se puedan guardar fuera de la app y recuperar, y cargar datos desde una hoja de cálculo.
Al empezar la sesión 2, abrid la misma carpeta en Codex y comprobad que todo sigue en su sitio:
Resúmeme en [tu idioma] en qué punto está el proyecto según git log y proves.md, y arranca la app en http://localhost:8000 para comprobar que funciona. No cambies nada.
Etapa 7. Añade en Configuración: Exportar datos (un fichero JSON con todos los datos y la configuración), Importar datos desde ese JSON e Importar desde CSV con el formato de campanyes_exemple.csv. Si el fichero está mal formado, muestra un mensaje claro y no borres nada. Prueba la importación con campanyes_exemple.csv y con un CSV estropeado que crees tú para la prueba. Pasa las comprobaciones de la etapa 7 y haz un commit.
08Convertirla en app de escritorio
Objetivo que QR Studio se abra en su propia ventana, con su icono, como un programa.
Usamos Electron, la misma tecnología de apps como VS Code o Slack: envuelve la página en una ventana de escritorio. Necesita Node.js (apartado 11 del bloque 0) y descargar paquetes, así que Codex os pedirá permiso para usar internet.
Etapa 8. Convierte QR Studio en app de escritorio con Electron: crea package.json (nombre qr-studio, versión 1.0.0), instala electron como dependencia de desarrollo y crea main.js con una ventana de 1000 × 700 que cargue index.html, use icona.png y no muestre la barra de menús. Asegúrate de que los textos de textos.json y los demás ficheros de datos se cargan dentro de Electron sin servidor. Añade el script start y ejecuta npm start. Pasa las comprobaciones de escritorio y haz un commit.
node --version
npm --version
npm start
npm no se reconoce, Node.js no está instalado o la app no se ha reiniciado después de instalarlo. Si sale «running scripts is disabled», es la política de PowerShell del apartado 06 del bloque 0. Si la ventana sale vacía, pedid a Codex que abra las herramientas de desarrollo de Electron y lea el error.09El instalador para Windows
Objetivo un fichero QR-Studio-Setup-1.0.0.exe que cualquiera puede instalar en Windows.
Etapa 9. Prepara el instalador de Windows con electron-builder: instálalo como dependencia de desarrollo y añade en package.json la configuración build con appId com.cibernarium.qrstudio, productName QR Studio, icono icona.png y destino nsis para Windows, que cree acceso directo en el escritorio y en el menú Inicio y que el fichero se llame QR-Studio-Setup-${version}.exe. Añade el script dist (electron-builder --win) y ejecútalo. Dime dónde ha quedado el .exe y cuánto ocupa.npm run dist
Instalar y probar
- Abrid la carpeta distDoble clic en
QR-Studio-Setup-1.0.0.exe. - Aviso de SmartScreenWindows mostrará «Windows protegió su PC» porque la app no está firmada con un certificado de empresa. Es lo esperado en una app propia: pulsad Más información y después Ejecutar de todas formas.
- Instalad y abridLa instalación es para vuestro usuario y no pide permisos de administrador. Abrid QR Studio desde el menú Inicio.
- DesinstalarConfiguración de Windows › Aplicaciones › Aplicaciones instaladas › QR Studio.
electron-builder --mac y obtendréis el instalador para macOS.dist está QR-Studio-Setup-1.0.0.exe. Instalada, la app abre desde el menú Inicio y conserva los datos al cerrarla y abrirla.10La landing de QR Studio
Objetivo una página web que presente la app con su copy, una captura y el botón de descarga, con el estilo de una web de referencia.
Elegid una web cuyo diseño os guste (la de una app, un estudio o una marca) y copiad su dirección. Codex la mira en el navegador integrado, extrae el sistema visual (tipografías, colores, espacios, botones) y lo aplica a vuestra landing con textos propios. También podéis pegar una captura de la referencia en el chat.
Etapa 10, primera parte. Abre en el navegador integrado [dirección de la web de referencia] y analiza su diseño: tipografías (busca equivalentes en Google Fonts), paleta de colores, escala de tamaños, espaciado, estilo de botones y de tarjetas. Escríbelo en docs/estil.md como un sistema propio para QR Studio. No copies textos, logos ni imágenes de la referencia. Enséñame el resumen antes de seguir.
Etapa 10, segunda parte. Escribe el copy de la landing en [tu idioma] a partir de brief_es.md: titular, subtítulo, tres ventajas, cómo funciona en tres pasos, preguntas frecuentes y llamada a descargar. Tono claro y directo, sin exageraciones. Después crea docs/index.html con ese copy y el sistema de docs/estil.md: cabecera, captura de la app (hazla tú con el navegador integrado en http://localhost:8000 y guárdala como docs/captura.png), ventajas, pasos, botón Descargar para Windows que apunte a https://github.com/[tu usuario]/qr-studio/releases/latest/download/QR-Studio-Setup-1.0.0.exe, preguntas y pie. Responsive, accesible y en un solo fichero de estilos. Ábrela en el navegador integrado a 1440 y a 390 px y pasa las comprobaciones de la etapa 10.
Para iterar, usad los comentarios del navegador integrado sobre la propia página («este titular más corto», «más aire entre secciones») o pedid cambios concretos en el chat.
11Publicar: GitHub, instalador y landing en línea
Objetivo el código en GitHub, el instalador en una release y la landing publicada con su dirección pública.
Necesitáis la cuenta de GitHub y gh auth login del apartado 12 del bloque 0. GitHub Pages publica gratis la carpeta docs de un repositorio público.
Etapa 11. Repasa todas las comprobaciones de proves.md y dime cuáles pasan. Crea un README.md en [tu idioma] que explique qué es QR Studio, cómo se instala y cómo se arranca en modo desarrollo. Haz un commit, crea con gh un repositorio público llamado qr-studio en mi cuenta y súbelo. Crea una release v1.0.0 con dist/QR-Studio-Setup-1.0.0.exe adjunto. Activa GitHub Pages desde la rama main y la carpeta /docs, espera a que esté publicada y dame la dirección. Pídeme permiso antes de cada paso que suba algo.
gh repo view --web
gh release view v1.0.0
gh api repos/{owner}/qr-studio/pages
https://vuestro-usuario.github.io/qr-studio/ y su botón descarga el instalador de la release.gh release view. Si gh dice que no estáis autenticados, repetid gh auth login.Hort Studio
Calendario de siembra y riego de un huerto urbano: bancales, cultivos, avisos de riego del día y registro de cosechas.
Sesión 1 · De la idea a una app que funciona
00Preparar la carpeta y los materiales
Objetivo tener la carpeta del proyecto abierta en Codex con todos los ficheros de trabajo.
Si todavía no tenéis Codex instalado y configurado, empezad por el bloque 0 · Instalar y configurar Codex. Después:
- Descargad los materialeshort-studio-materials.zip (12 KB, 9 ficheros).
- Descomprimid la carpetaDentro de vuestra carpeta de usuario, por ejemplo
Documentos\hort-studio-materials. Fuera de OneDrive y de la raíz deC:\. - Abridla en CodexAdd new project (Ctrl+O) y elegid la carpeta. Dejad los permisos en Ask for approval.
- Comprobad que Codex la entiendeCon el prompt de abajo.
Lista los ficheros de esta carpeta y explícame en [tu idioma], en una línea cada uno, para qué sirve. No cambies nada.
Qué hay en la carpeta (y cómo crear cada fichero si no podéis descargar el zip)
AGENTS.mdInstrucciones que Codex lee siempre en esta carpeta.Crear este fichero con un prompt
Crea en esta carpeta un AGENTS.md para el proyecto Hort Studio: calendario de siembra y riego de un huerto urbano: bancales, cultivos, avisos de riego del día y registro de cosechas. Se hace con HTML, CSS y JavaScript sin frameworks y se empaqueta para Windows con Electron. Indica: responde siempre en el idioma del usuario; explica el plan antes de cambiar ficheros y espera confirmación; haz una etapa cada vez; trabaja solo dentro de esta carpeta y no borres nada sin preguntar; avisa antes de órdenes que necesiten internet; todos los textos visibles salen de textos.json (ca, es, en); los datos se guardan en el dispositivo; accesible con teclado; al terminar cada etapa, pasa las comprobaciones de proves.md.
brief_es.md / brief_ca.mdEl encargo: qué hace la app y cómo se comprueba.Crear este fichero con un prompt
Crea brief_es.md con el encargo de Hort Studio: Calendario de siembra y riego de un huerto urbano: bancales, cultivos, avisos de riego del día y registro de cosechas. Incluye objetivo, qué tiene que hacer por etapas (bancales y cultivos; calendario y riego; cosechas y estadísticas; idiomas ca/es/en desde textos.json; exportar e importar JSON e importar CSV; ventana Electron con icono e instalador; landing publicada en GitHub Pages), aspecto, fuera de alcance y cómo sabremos que está bien.
textos.jsonTodos los textos de la interfaz en ca, es y en.Crear este fichero con un prompt
Crea textos.json con tres bloques, "ca", "es" y "en", con las mismas claves en los tres para todos los textos que necesitará la interfaz de Hort Studio según el brief: botones, campos, filtros, estadísticas, configuración, mensajes de confirmación y de error. Traduce cada texto con naturalidad.
cultius.json + plantacions_exemple.csvFichas de doce cultivos: siembra, riego y cosecha. Plantaciones de ejemplo en tres bancales.Crear este fichero con un prompt
Crea cultius.json con doce cultivos habituales en un huerto urbano de Barcelona (tomate, lechuga, calabacín, pimiento, berenjena, judía, guisante, rábano, zanahoria, espinaca, cebolla y albahaca) con los campos nom_ca, nom_es, nom_en, mesos_sembra (números de mes), dies_germinacio, dies_collita, reg_cada_dies y marc_cm. Después crea plantacions_exemple.csv con las columnas bancal,cultiu,data_sembra,unitats y nueve plantaciones de 2026 repartidas en tres bancales (Bancal 1, Bancal 2 y Jardinera).
proves.mdComprobaciones de cada etapa, con casillas.Crear este fichero con un prompt
Crea proves.md con una lista de comprobaciones con casillas para cada etapa de Hort Studio según el brief, más idiomas, datos (exportar, importar JSON y CSV, CSV mal formado), escritorio, instalador de Windows, landing y publicación. Cada comprobación tiene que poder verificarse mirando la app.
icona.pngIcono de 512 × 512 para el instalador.Crear este fichero con un prompt
Crea icona.png de 512 × 512 píxeles para Hort Studio: un cuadrado redondeado de color oscuro con un símbolo sencillo y claro que represente la app. Usa Python con Pillow; si no está instalado, pídeme permiso para instalarlo.
hort-studio-materials.01Leer el encargo y planificar
Objetivo que Codex explique qué va a construir y en qué orden antes de escribir código.
Lee AGENTS.md y brief_es.md. Explícame en [tu idioma] qué vamos a construir y propón un plan en estas etapas: 2 bancales y cultivos, 3 calendario y riego, 4 cosechas y estadísticas, 5 idiomas, 6 punto de recuperación, 7 datos, 8 app de escritorio, 9 instalador de Windows, 10 landing de la app, 11 publicación. Para cada etapa, dime qué ficheros crearás o cambiarás. Hazme las preguntas que necesites. No cambies nada todavía.
Responded a sus preguntas en el mismo chat. Si el plan no os convence, pedid el cambio antes de aprobarlo.
02Bancales y cultivos
Objetivo una primera versión que ya funciona: dibujar el huerto y plantar.
Etapa 2. Crea index.html, styles.css y app.js con los bancales de Hort Studio: crear, editar y borrar bancales (nombre y superficie en m²) y plantar en ellos cultivos de cultius.json con fecha de siembra y unidades. Cada plantación muestra la fecha de cosecha prevista a partir de dies_collita. Guarda todo en localStorage. Carga los textos desde textos.json, de momento en castellano. Sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado y pasa las comprobaciones de la etapa 2 de proves.md.
http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.03Calendario y riego
Objetivo saber cada día qué toca regar y qué se puede sembrar este mes.
Etapa 3. Añade la pantalla «Hoy»: lista de plantaciones que tocan regar según reg_cada_dies y el último riego, con un botón para marcarlas como regadas. Añade un calendario anual con los cultivos que se pueden sembrar cada mes según mesos_sembra, destacando el mes actual. Pasa las comprobaciones de la etapa 3.
04Cosechas y estadísticas
Objetivo registrar lo que da el huerto y verlo por cultivo, bancal y mes.
Etapa 4. Añade el registro de cosechas (plantación, fecha y kilos) y una vista de estadísticas: kilos por cultivo, por bancal y por mes (gráfico de barras en SVG, sin librerías), riegos del último mes y rendimiento en kg por m² de cada bancal. Para probarlo, crea un botón temporal que genere cosechas de ejemplo y otro que las borre. Pasa las comprobaciones de la etapa 4.
05Idiomas
Objetivo la misma app en catalán, castellano e inglés.
Etapa 5. Añade un selector de idioma con català, castellano e English que cambie todos los textos visibles con los de textos.json y recuerde la elección. Busca en el código cualquier texto escrito a mano y pásalo a textos.json en los tres idiomas. Formatea fechas y números según el idioma. Pasa las comprobaciones de la etapa 5.
06Punto de recuperación y repaso
Objetivo guardar el trabajo de la sesión 1 para poder volver a este punto pase lo que pase.
Git guarda fotos del proyecto (commits). Si algo se estropea en la sesión 2, se vuelve a esta foto. Si no tenéis Git instalado, está en el apartado 11 del bloque 0.
Etapa 6. Repasa todas las comprobaciones de las etapas 2 a 5 de proves.md y dime cuáles pasan. Después inicia Git en esta carpeta, crea un .gitignore que excluya node_modules y dist, y haz un commit con el mensaje «Sesión 1: bancales, riego, cosechas e idiomas». Explícame cómo volver a este punto si algo se estropea.
git log muestra el commit de la sesión 1 y el panel de revisión de Codex ya no marca cambios pendientes.git config --global user.name y user.email.Sesión 2 · Datos, instalador de Windows, landing y publicación
07Datos: exportar e importar
Objetivo que los datos se puedan guardar fuera de la app y recuperar, y cargar datos desde una hoja de cálculo.
Al empezar la sesión 2, abrid la misma carpeta en Codex y comprobad que todo sigue en su sitio:
Resúmeme en [tu idioma] en qué punto está el proyecto según git log y proves.md, y arranca la app en http://localhost:8000 para comprobar que funciona. No cambies nada.
Etapa 7. Añade en Configuración: Exportar datos (un fichero JSON con todos los datos y la configuración), Importar datos desde ese JSON e Importar desde CSV con el formato de plantacions_exemple.csv. Si el fichero está mal formado, muestra un mensaje claro y no borres nada. Prueba la importación con plantacions_exemple.csv y con un CSV estropeado que crees tú para la prueba. Pasa las comprobaciones de la etapa 7 y haz un commit.
08Convertirla en app de escritorio
Objetivo que Hort Studio se abra en su propia ventana, con su icono, como un programa.
Usamos Electron, la misma tecnología de apps como VS Code o Slack: envuelve la página en una ventana de escritorio. Necesita Node.js (apartado 11 del bloque 0) y descargar paquetes, así que Codex os pedirá permiso para usar internet.
Etapa 8. Convierte Hort Studio en app de escritorio con Electron: crea package.json (nombre hort-studio, versión 1.0.0), instala electron como dependencia de desarrollo y crea main.js con una ventana de 1000 × 700 que cargue index.html, use icona.png y no muestre la barra de menús. Asegúrate de que los textos de textos.json y los demás ficheros de datos se cargan dentro de Electron sin servidor. Añade el script start y ejecuta npm start. Pasa las comprobaciones de escritorio y haz un commit.
node --version
npm --version
npm start
npm no se reconoce, Node.js no está instalado o la app no se ha reiniciado después de instalarlo. Si sale «running scripts is disabled», es la política de PowerShell del apartado 06 del bloque 0. Si la ventana sale vacía, pedid a Codex que abra las herramientas de desarrollo de Electron y lea el error.09El instalador para Windows
Objetivo un fichero Hort-Studio-Setup-1.0.0.exe que cualquiera puede instalar en Windows.
Etapa 9. Prepara el instalador de Windows con electron-builder: instálalo como dependencia de desarrollo y añade en package.json la configuración build con appId com.cibernarium.hortstudio, productName Hort Studio, icono icona.png y destino nsis para Windows, que cree acceso directo en el escritorio y en el menú Inicio y que el fichero se llame Hort-Studio-Setup-${version}.exe. Añade el script dist (electron-builder --win) y ejecútalo. Dime dónde ha quedado el .exe y cuánto ocupa.npm run dist
Instalar y probar
- Abrid la carpeta distDoble clic en
Hort-Studio-Setup-1.0.0.exe. - Aviso de SmartScreenWindows mostrará «Windows protegió su PC» porque la app no está firmada con un certificado de empresa. Es lo esperado en una app propia: pulsad Más información y después Ejecutar de todas formas.
- Instalad y abridLa instalación es para vuestro usuario y no pide permisos de administrador. Abrid Hort Studio desde el menú Inicio.
- DesinstalarConfiguración de Windows › Aplicaciones › Aplicaciones instaladas › Hort Studio.
electron-builder --mac y obtendréis el instalador para macOS.dist está Hort-Studio-Setup-1.0.0.exe. Instalada, la app abre desde el menú Inicio y conserva los datos al cerrarla y abrirla.10La landing de Hort Studio
Objetivo una página web que presente la app con su copy, una captura y el botón de descarga, con el estilo de una web de referencia.
Elegid una web cuyo diseño os guste (la de una app, un estudio o una marca) y copiad su dirección. Codex la mira en el navegador integrado, extrae el sistema visual (tipografías, colores, espacios, botones) y lo aplica a vuestra landing con textos propios. También podéis pegar una captura de la referencia en el chat.
Etapa 10, primera parte. Abre en el navegador integrado [dirección de la web de referencia] y analiza su diseño: tipografías (busca equivalentes en Google Fonts), paleta de colores, escala de tamaños, espaciado, estilo de botones y de tarjetas. Escríbelo en docs/estil.md como un sistema propio para Hort Studio. No copies textos, logos ni imágenes de la referencia. Enséñame el resumen antes de seguir.
Etapa 10, segunda parte. Escribe el copy de la landing en [tu idioma] a partir de brief_es.md: titular, subtítulo, tres ventajas, cómo funciona en tres pasos, preguntas frecuentes y llamada a descargar. Tono claro y directo, sin exageraciones. Después crea docs/index.html con ese copy y el sistema de docs/estil.md: cabecera, captura de la app (hazla tú con el navegador integrado en http://localhost:8000 y guárdala como docs/captura.png), ventajas, pasos, botón Descargar para Windows que apunte a https://github.com/[tu usuario]/hort-studio/releases/latest/download/Hort-Studio-Setup-1.0.0.exe, preguntas y pie. Responsive, accesible y en un solo fichero de estilos. Ábrela en el navegador integrado a 1440 y a 390 px y pasa las comprobaciones de la etapa 10.
Para iterar, usad los comentarios del navegador integrado sobre la propia página («este titular más corto», «más aire entre secciones») o pedid cambios concretos en el chat.
11Publicar: GitHub, instalador y landing en línea
Objetivo el código en GitHub, el instalador en una release y la landing publicada con su dirección pública.
Necesitáis la cuenta de GitHub y gh auth login del apartado 12 del bloque 0. GitHub Pages publica gratis la carpeta docs de un repositorio público.
Etapa 11. Repasa todas las comprobaciones de proves.md y dime cuáles pasan. Crea un README.md en [tu idioma] que explique qué es Hort Studio, cómo se instala y cómo se arranca en modo desarrollo. Haz un commit, crea con gh un repositorio público llamado hort-studio en mi cuenta y súbelo. Crea una release v1.0.0 con dist/Hort-Studio-Setup-1.0.0.exe adjunto. Activa GitHub Pages desde la rama main y la carpeta /docs, espera a que esté publicada y dame la dirección. Pídeme permiso antes de cada paso que suba algo.
gh repo view --web
gh release view v1.0.0
gh api repos/{owner}/hort-studio/pages
https://vuestro-usuario.github.io/hort-studio/ y su botón descarga el instalador de la release.gh release view. Si gh dice que no estáis autenticados, repetid gh auth login.Col·leccions Studio
Inventario de una colección (el ejemplo es de discos de vinilo) con fotos, estado, precio de compra y valor estimado.
Sesión 1 · De la idea a una app que funciona
00Preparar la carpeta y los materiales
Objetivo tener la carpeta del proyecto abierta en Codex con todos los ficheros de trabajo.
Si todavía no tenéis Codex instalado y configurado, empezad por el bloque 0 · Instalar y configurar Codex. Después:
- Descargad los materialescol-leccions-studio-materials.zip (13 KB, 8 ficheros).
- Descomprimid la carpetaDentro de vuestra carpeta de usuario, por ejemplo
Documentos\col-leccions-studio-materials. Fuera de OneDrive y de la raíz deC:\. - Abridla en CodexAdd new project (Ctrl+O) y elegid la carpeta. Dejad los permisos en Ask for approval.
- Comprobad que Codex la entiendeCon el prompt de abajo.
Lista los ficheros de esta carpeta y explícame en [tu idioma], en una línea cada uno, para qué sirve. No cambies nada.
Qué hay en la carpeta (y cómo crear cada fichero si no podéis descargar el zip)
AGENTS.mdInstrucciones que Codex lee siempre en esta carpeta.Crear este fichero con un prompt
Crea en esta carpeta un AGENTS.md para el proyecto Col·leccions Studio: inventario de una colección (el ejemplo es de discos de vinilo) con fotos, estado, precio de compra y valor estimado. Se hace con HTML, CSS y JavaScript sin frameworks y se empaqueta para Windows con Electron. Indica: responde siempre en el idioma del usuario; explica el plan antes de cambiar ficheros y espera confirmación; haz una etapa cada vez; trabaja solo dentro de esta carpeta y no borres nada sin preguntar; avisa antes de órdenes que necesiten internet; todos los textos visibles salen de textos.json (ca, es, en); los datos se guardan en el dispositivo; accesible con teclado; al terminar cada etapa, pasa las comprobaciones de proves.md.
brief_es.md / brief_ca.mdEl encargo: qué hace la app y cómo se comprueba.Crear este fichero con un prompt
Crea brief_es.md con el encargo de Col·leccions Studio: Inventario de una colección (el ejemplo es de discos de vinilo) con fotos, estado, precio de compra y valor estimado. Incluye objetivo, qué tiene que hacer por etapas (fichas de la colección; galería, búsqueda y filtros; el valor de la colección; idiomas ca/es/en desde textos.json; exportar e importar JSON e importar CSV; ventana Electron con icono e instalador; landing publicada en GitHub Pages), aspecto, fuera de alcance y cómo sabremos que está bien.
textos.jsonTodos los textos de la interfaz en ca, es y en.Crear este fichero con un prompt
Crea textos.json con tres bloques, "ca", "es" y "en", con las mismas claves en los tres para todos los textos que necesitará la interfaz de Col·leccions Studio según el brief: botones, campos, filtros, estadísticas, configuración, mensajes de confirmación y de error. Traduce cada texto con naturalidad.
col_leccio_exemple.csvDoce discos de ejemplo con estado y valor.Crear este fichero con un prompt
Crea col_leccio_exemple.csv con las columnas titol,artista,any,genere,estat,preu_compra,valor_estimat,data_adquisicio y doce discos de vinilo de grupos inventados, con estat entre com nou, molt bo, bo y regular, precios en euros con coma decimal y fechas de adquisición entre 2020 y 2026.
proves.mdComprobaciones de cada etapa, con casillas.Crear este fichero con un prompt
Crea proves.md con una lista de comprobaciones con casillas para cada etapa de Col·leccions Studio según el brief, más idiomas, datos (exportar, importar JSON y CSV, CSV mal formado), escritorio, instalador de Windows, landing y publicación. Cada comprobación tiene que poder verificarse mirando la app.
icona.pngIcono de 512 × 512 para el instalador.Crear este fichero con un prompt
Crea icona.png de 512 × 512 píxeles para Col·leccions Studio: un cuadrado redondeado de color oscuro con un símbolo sencillo y claro que represente la app. Usa Python con Pillow; si no está instalado, pídeme permiso para instalarlo.
col-leccions-studio-materials.01Leer el encargo y planificar
Objetivo que Codex explique qué va a construir y en qué orden antes de escribir código.
Lee AGENTS.md y brief_es.md. Explícame en [tu idioma] qué vamos a construir y propón un plan en estas etapas: 2 fichas de la colección, 3 galería, búsqueda y filtros, 4 el valor de la colección, 5 idiomas, 6 punto de recuperación, 7 datos, 8 app de escritorio, 9 instalador de Windows, 10 landing de la app, 11 publicación. Para cada etapa, dime qué ficheros crearás o cambiarás. Hazme las preguntas que necesites. No cambies nada todavía.
Responded a sus preguntas en el mismo chat. Si el plan no os convence, pedid el cambio antes de aprobarlo.
02Fichas de la colección
Objetivo una primera versión que ya funciona: dar de alta las piezas con su foto.
Etapa 2. Crea index.html, styles.css y app.js con las fichas de Col·leccions Studio: añadir, editar y borrar piezas (título, artista, año, género, estado —como nuevo, muy bueno, bueno o regular—, precio de compra, valor estimado, fecha de adquisición y una foto que el usuario elige de su ordenador). Reduce la foto a 600 px de lado antes de guardarla para no llenar el almacenamiento. Guarda todo en localStorage. Carga los textos desde textos.json, de momento en castellano. Sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado y pasa las comprobaciones de la etapa 2 de proves.md.
http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.03Galería, búsqueda y filtros
Objetivo encontrar cualquier pieza en segundos.
Etapa 3. Añade una vista de galería con las fotos en cuadrícula y una vista de lista, un buscador por título o artista, filtros por género y estado, y ordenación por año, valor o fecha de adquisición. Al pulsar una pieza se abre su ficha completa. Pasa las comprobaciones de la etapa 3.
04El valor de la colección
Objetivo saber cuánto vale la colección y cómo ha crecido.
Etapa 4. Añade una vista de estadísticas: número de piezas, valor estimado total, total pagado y diferencia, valor por género, piezas por estado y un gráfico de barras en SVG (sin librerías) de piezas adquiridas por año. Formatea los importes en euros con el formato del idioma elegido. Para probarlo, crea un botón temporal que genere piezas de ejemplo y otro que las borre. Pasa las comprobaciones de la etapa 4.
05Idiomas
Objetivo la misma app en catalán, castellano e inglés.
Etapa 5. Añade un selector de idioma con català, castellano e English que cambie todos los textos visibles con los de textos.json y recuerde la elección. Busca en el código cualquier texto escrito a mano y pásalo a textos.json en los tres idiomas. Formatea fechas y números según el idioma. Pasa las comprobaciones de la etapa 5.
06Punto de recuperación y repaso
Objetivo guardar el trabajo de la sesión 1 para poder volver a este punto pase lo que pase.
Git guarda fotos del proyecto (commits). Si algo se estropea en la sesión 2, se vuelve a esta foto. Si no tenéis Git instalado, está en el apartado 11 del bloque 0.
Etapa 6. Repasa todas las comprobaciones de las etapas 2 a 5 de proves.md y dime cuáles pasan. Después inicia Git en esta carpeta, crea un .gitignore que excluya node_modules y dist, y haz un commit con el mensaje «Sesión 1: fichas, galería, estadísticas e idiomas». Explícame cómo volver a este punto si algo se estropea.
git log muestra el commit de la sesión 1 y el panel de revisión de Codex ya no marca cambios pendientes.git config --global user.name y user.email.Sesión 2 · Datos, instalador de Windows, landing y publicación
07Datos: exportar e importar
Objetivo que los datos se puedan guardar fuera de la app y recuperar, y cargar datos desde una hoja de cálculo.
Al empezar la sesión 2, abrid la misma carpeta en Codex y comprobad que todo sigue en su sitio:
Resúmeme en [tu idioma] en qué punto está el proyecto según git log y proves.md, y arranca la app en http://localhost:8000 para comprobar que funciona. No cambies nada.
Etapa 7. Añade en Configuración: Exportar datos (un fichero JSON con todos los datos y la configuración), Importar datos desde ese JSON e Importar desde CSV con el formato de col_leccio_exemple.csv. Si el fichero está mal formado, muestra un mensaje claro y no borres nada. Prueba la importación con col_leccio_exemple.csv y con un CSV estropeado que crees tú para la prueba. Pasa las comprobaciones de la etapa 7 y haz un commit.
08Convertirla en app de escritorio
Objetivo que Col·leccions Studio se abra en su propia ventana, con su icono, como un programa.
Usamos Electron, la misma tecnología de apps como VS Code o Slack: envuelve la página en una ventana de escritorio. Necesita Node.js (apartado 11 del bloque 0) y descargar paquetes, así que Codex os pedirá permiso para usar internet.
Etapa 8. Convierte Col·leccions Studio en app de escritorio con Electron: crea package.json (nombre col-leccions-studio, versión 1.0.0), instala electron como dependencia de desarrollo y crea main.js con una ventana de 1000 × 700 que cargue index.html, use icona.png y no muestre la barra de menús. Asegúrate de que los textos de textos.json y los demás ficheros de datos se cargan dentro de Electron sin servidor. Añade el script start y ejecuta npm start. Pasa las comprobaciones de escritorio y haz un commit.
node --version
npm --version
npm start
npm no se reconoce, Node.js no está instalado o la app no se ha reiniciado después de instalarlo. Si sale «running scripts is disabled», es la política de PowerShell del apartado 06 del bloque 0. Si la ventana sale vacía, pedid a Codex que abra las herramientas de desarrollo de Electron y lea el error.09El instalador para Windows
Objetivo un fichero Colleccions-Studio-Setup-1.0.0.exe que cualquiera puede instalar en Windows.
Etapa 9. Prepara el instalador de Windows con electron-builder: instálalo como dependencia de desarrollo y añade en package.json la configuración build con appId com.cibernarium.colleccionsstudio, productName Col·leccions Studio, icono icona.png y destino nsis para Windows, que cree acceso directo en el escritorio y en el menú Inicio y que el fichero se llame Colleccions-Studio-Setup-${version}.exe. Añade el script dist (electron-builder --win) y ejecútalo. Dime dónde ha quedado el .exe y cuánto ocupa.npm run dist
Instalar y probar
- Abrid la carpeta distDoble clic en
Colleccions-Studio-Setup-1.0.0.exe. - Aviso de SmartScreenWindows mostrará «Windows protegió su PC» porque la app no está firmada con un certificado de empresa. Es lo esperado en una app propia: pulsad Más información y después Ejecutar de todas formas.
- Instalad y abridLa instalación es para vuestro usuario y no pide permisos de administrador. Abrid Col·leccions Studio desde el menú Inicio.
- DesinstalarConfiguración de Windows › Aplicaciones › Aplicaciones instaladas › Col·leccions Studio.
electron-builder --mac y obtendréis el instalador para macOS.dist está Colleccions-Studio-Setup-1.0.0.exe. Instalada, la app abre desde el menú Inicio y conserva los datos al cerrarla y abrirla.10La landing de Col·leccions Studio
Objetivo una página web que presente la app con su copy, una captura y el botón de descarga, con el estilo de una web de referencia.
Elegid una web cuyo diseño os guste (la de una app, un estudio o una marca) y copiad su dirección. Codex la mira en el navegador integrado, extrae el sistema visual (tipografías, colores, espacios, botones) y lo aplica a vuestra landing con textos propios. También podéis pegar una captura de la referencia en el chat.
Etapa 10, primera parte. Abre en el navegador integrado [dirección de la web de referencia] y analiza su diseño: tipografías (busca equivalentes en Google Fonts), paleta de colores, escala de tamaños, espaciado, estilo de botones y de tarjetas. Escríbelo en docs/estil.md como un sistema propio para Col·leccions Studio. No copies textos, logos ni imágenes de la referencia. Enséñame el resumen antes de seguir.
Etapa 10, segunda parte. Escribe el copy de la landing en [tu idioma] a partir de brief_es.md: titular, subtítulo, tres ventajas, cómo funciona en tres pasos, preguntas frecuentes y llamada a descargar. Tono claro y directo, sin exageraciones. Después crea docs/index.html con ese copy y el sistema de docs/estil.md: cabecera, captura de la app (hazla tú con el navegador integrado en http://localhost:8000 y guárdala como docs/captura.png), ventajas, pasos, botón Descargar para Windows que apunte a https://github.com/[tu usuario]/col-leccions-studio/releases/latest/download/Colleccions-Studio-Setup-1.0.0.exe, preguntas y pie. Responsive, accesible y en un solo fichero de estilos. Ábrela en el navegador integrado a 1440 y a 390 px y pasa las comprobaciones de la etapa 10.
Para iterar, usad los comentarios del navegador integrado sobre la propia página («este titular más corto», «más aire entre secciones») o pedid cambios concretos en el chat.
11Publicar: GitHub, instalador y landing en línea
Objetivo el código en GitHub, el instalador en una release y la landing publicada con su dirección pública.
Necesitáis la cuenta de GitHub y gh auth login del apartado 12 del bloque 0. GitHub Pages publica gratis la carpeta docs de un repositorio público.
Etapa 11. Repasa todas las comprobaciones de proves.md y dime cuáles pasan. Crea un README.md en [tu idioma] que explique qué es Col·leccions Studio, cómo se instala y cómo se arranca en modo desarrollo. Haz un commit, crea con gh un repositorio público llamado col-leccions-studio en mi cuenta y súbelo. Crea una release v1.0.0 con dist/Colleccions-Studio-Setup-1.0.0.exe adjunto. Activa GitHub Pages desde la rama main y la carpeta /docs, espera a que esté publicada y dame la dirección. Pídeme permiso antes de cada paso que suba algo.
gh repo view --web
gh release view v1.0.0
gh api repos/{owner}/col-leccions-studio/pages
https://vuestro-usuario.github.io/col-leccions-studio/ y su botón descarga el instalador de la release.gh release view. Si gh dice que no estáis autenticados, repetid gh auth login.Rutes Studio
Registro de rutas a pie con distancia, desnivel, dificultad y notas, con importación de tracks GPX y perfil de elevación.
Sesión 1 · De la idea a una app que funciona
00Preparar la carpeta y los materiales
Objetivo tener la carpeta del proyecto abierta en Codex con todos los ficheros de trabajo.
Si todavía no tenéis Codex instalado y configurado, empezad por el bloque 0 · Instalar y configurar Codex. Después:
- Descargad los materialesrutes-studio-materials.zip (12 KB, 9 ficheros).
- Descomprimid la carpetaDentro de vuestra carpeta de usuario, por ejemplo
Documentos\rutes-studio-materials. Fuera de OneDrive y de la raíz deC:\. - Abridla en CodexAdd new project (Ctrl+O) y elegid la carpeta. Dejad los permisos en Ask for approval.
- Comprobad que Codex la entiendeCon el prompt de abajo.
Lista los ficheros de esta carpeta y explícame en [tu idioma], en una línea cada uno, para qué sirve. No cambies nada.
Qué hay en la carpeta (y cómo crear cada fichero si no podéis descargar el zip)
AGENTS.mdInstrucciones que Codex lee siempre en esta carpeta.Crear este fichero con un prompt
Crea en esta carpeta un AGENTS.md para el proyecto Rutes Studio: registro de rutas a pie con distancia, desnivel, dificultad y notas, con importación de tracks GPX y perfil de elevación. Se hace con HTML, CSS y JavaScript sin frameworks y se empaqueta para Windows con Electron. Indica: responde siempre en el idioma del usuario; explica el plan antes de cambiar ficheros y espera confirmación; haz una etapa cada vez; trabaja solo dentro de esta carpeta y no borres nada sin preguntar; avisa antes de órdenes que necesiten internet; todos los textos visibles salen de textos.json (ca, es, en); los datos se guardan en el dispositivo; accesible con teclado; al terminar cada etapa, pasa las comprobaciones de proves.md.
brief_es.md / brief_ca.mdEl encargo: qué hace la app y cómo se comprueba.Crear este fichero con un prompt
Crea brief_es.md con el encargo de Rutes Studio: Registro de rutas a pie con distancia, desnivel, dificultad y notas, con importación de tracks GPX y perfil de elevación. Incluye objetivo, qué tiene que hacer por etapas (fichas de ruta; importar un track gpx; estadísticas de montaña; idiomas ca/es/en desde textos.json; exportar e importar JSON e importar CSV; ventana Electron con icono e instalador; landing publicada en GitHub Pages), aspecto, fuera de alcance y cómo sabremos que está bien.
textos.jsonTodos los textos de la interfaz en ca, es y en.Crear este fichero con un prompt
Crea textos.json con tres bloques, "ca", "es" y "en", con las mismas claves en los tres para todos los textos que necesitará la interfaz de Rutes Studio según el brief: botones, campos, filtros, estadísticas, configuración, mensajes de confirmación y de error. Traduce cada texto con naturalidad.
rutes_exemple.csv + ruta_exemple.gpxOcho rutas de ejemplo por Catalunya. Un track GPX de ejemplo para la importación.Crear este fichero con un prompt
Crea rutes_exemple.csv con las columnas nom,zona,distancia_km,desnivell_m,dificultat,durada_h,data,notes y ocho rutas inventadas de 2026 por Collserola, el Montseny, el Garraf, Montserrat y el Cadí, con dificultat entre fàcil, mitjana y difícil y distancias con coma decimal. Después crea ruta_exemple.gpx con un track inventado de unos 60 puntos con latitud, longitud y elevación, en circuito por Collserola.
proves.mdComprobaciones de cada etapa, con casillas.Crear este fichero con un prompt
Crea proves.md con una lista de comprobaciones con casillas para cada etapa de Rutes Studio según el brief, más idiomas, datos (exportar, importar JSON y CSV, CSV mal formado), escritorio, instalador de Windows, landing y publicación. Cada comprobación tiene que poder verificarse mirando la app.
icona.pngIcono de 512 × 512 para el instalador.Crear este fichero con un prompt
Crea icona.png de 512 × 512 píxeles para Rutes Studio: un cuadrado redondeado de color oscuro con un símbolo sencillo y claro que represente la app. Usa Python con Pillow; si no está instalado, pídeme permiso para instalarlo.
rutes-studio-materials.01Leer el encargo y planificar
Objetivo que Codex explique qué va a construir y en qué orden antes de escribir código.
Lee AGENTS.md y brief_es.md. Explícame en [tu idioma] qué vamos a construir y propón un plan en estas etapas: 2 fichas de ruta, 3 importar un track gpx, 4 estadísticas de montaña, 5 idiomas, 6 punto de recuperación, 7 datos, 8 app de escritorio, 9 instalador de Windows, 10 landing de la app, 11 publicación. Para cada etapa, dime qué ficheros crearás o cambiarás. Hazme las preguntas que necesites. No cambies nada todavía.
Responded a sus preguntas en el mismo chat. Si el plan no os convence, pedid el cambio antes de aprobarlo.
02Fichas de ruta
Objetivo una primera versión que ya funciona: anotar las rutas hechas.
Etapa 2. Crea index.html, styles.css y app.js con las fichas de Rutes Studio: añadir, editar y borrar rutas (nombre, zona, distancia en km, desnivel positivo en m, dificultad fácil/media/difícil, duración en horas, fecha y notas); lista ordenada por fecha con filtro por dificultad y zona. Guarda todo en localStorage. Carga los textos desde textos.json, de momento en castellano. Sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado y pasa las comprobaciones de la etapa 2 de proves.md.
http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.03Importar un track GPX
Objetivo cargar el fichero del GPS o del móvil y obtener distancia, desnivel y perfil.
Etapa 3. Añade la importación de ficheros GPX: lee los puntos del track, calcula la distancia total con la fórmula de Haversine y el desnivel positivo acumulado, y dibuja el perfil de elevación en SVG (distancia en el eje horizontal y altitud en el vertical, sin librerías). Al importar, rellena la ficha de una ruta nueva con esos datos para que el usuario la complete. Pruébalo con ruta_exemple.gpx y pasa las comprobaciones de la etapa 3.
04Estadísticas de montaña
Objetivo ver cuánto habéis caminado y subido, por mes y por zona.
Etapa 4. Añade una vista de estadísticas: kilómetros y desnivel acumulados del año, rutas por dificultad, kilómetros por zona y un gráfico de barras en SVG (sin librerías) de kilómetros por mes. Para probarlo, crea un botón temporal que genere rutas de ejemplo y otro que las borre. Pasa las comprobaciones de la etapa 4.
05Idiomas
Objetivo la misma app en catalán, castellano e inglés.
Etapa 5. Añade un selector de idioma con català, castellano e English que cambie todos los textos visibles con los de textos.json y recuerde la elección. Busca en el código cualquier texto escrito a mano y pásalo a textos.json en los tres idiomas. Formatea fechas y números según el idioma. Pasa las comprobaciones de la etapa 5.
06Punto de recuperación y repaso
Objetivo guardar el trabajo de la sesión 1 para poder volver a este punto pase lo que pase.
Git guarda fotos del proyecto (commits). Si algo se estropea en la sesión 2, se vuelve a esta foto. Si no tenéis Git instalado, está en el apartado 11 del bloque 0.
Etapa 6. Repasa todas las comprobaciones de las etapas 2 a 5 de proves.md y dime cuáles pasan. Después inicia Git en esta carpeta, crea un .gitignore que excluya node_modules y dist, y haz un commit con el mensaje «Sesión 1: rutas, GPX, estadísticas e idiomas». Explícame cómo volver a este punto si algo se estropea.
git log muestra el commit de la sesión 1 y el panel de revisión de Codex ya no marca cambios pendientes.git config --global user.name y user.email.Sesión 2 · Datos, instalador de Windows, landing y publicación
07Datos: exportar e importar
Objetivo que los datos se puedan guardar fuera de la app y recuperar, y cargar datos desde una hoja de cálculo.
Al empezar la sesión 2, abrid la misma carpeta en Codex y comprobad que todo sigue en su sitio:
Resúmeme en [tu idioma] en qué punto está el proyecto según git log y proves.md, y arranca la app en http://localhost:8000 para comprobar que funciona. No cambies nada.
Etapa 7. Añade en Configuración: Exportar datos (un fichero JSON con todos los datos y la configuración), Importar datos desde ese JSON e Importar desde CSV con el formato de rutes_exemple.csv. Si el fichero está mal formado, muestra un mensaje claro y no borres nada. Prueba la importación con rutes_exemple.csv y con un CSV estropeado que crees tú para la prueba. Pasa las comprobaciones de la etapa 7 y haz un commit.
08Convertirla en app de escritorio
Objetivo que Rutes Studio se abra en su propia ventana, con su icono, como un programa.
Usamos Electron, la misma tecnología de apps como VS Code o Slack: envuelve la página en una ventana de escritorio. Necesita Node.js (apartado 11 del bloque 0) y descargar paquetes, así que Codex os pedirá permiso para usar internet.
Etapa 8. Convierte Rutes Studio en app de escritorio con Electron: crea package.json (nombre rutes-studio, versión 1.0.0), instala electron como dependencia de desarrollo y crea main.js con una ventana de 1000 × 700 que cargue index.html, use icona.png y no muestre la barra de menús. Asegúrate de que los textos de textos.json y los demás ficheros de datos se cargan dentro de Electron sin servidor. Añade el script start y ejecuta npm start. Pasa las comprobaciones de escritorio y haz un commit.
node --version
npm --version
npm start
npm no se reconoce, Node.js no está instalado o la app no se ha reiniciado después de instalarlo. Si sale «running scripts is disabled», es la política de PowerShell del apartado 06 del bloque 0. Si la ventana sale vacía, pedid a Codex que abra las herramientas de desarrollo de Electron y lea el error.09El instalador para Windows
Objetivo un fichero Rutes-Studio-Setup-1.0.0.exe que cualquiera puede instalar en Windows.
Etapa 9. Prepara el instalador de Windows con electron-builder: instálalo como dependencia de desarrollo y añade en package.json la configuración build con appId com.cibernarium.rutesstudio, productName Rutes Studio, icono icona.png y destino nsis para Windows, que cree acceso directo en el escritorio y en el menú Inicio y que el fichero se llame Rutes-Studio-Setup-${version}.exe. Añade el script dist (electron-builder --win) y ejecútalo. Dime dónde ha quedado el .exe y cuánto ocupa.npm run dist
Instalar y probar
- Abrid la carpeta distDoble clic en
Rutes-Studio-Setup-1.0.0.exe. - Aviso de SmartScreenWindows mostrará «Windows protegió su PC» porque la app no está firmada con un certificado de empresa. Es lo esperado en una app propia: pulsad Más información y después Ejecutar de todas formas.
- Instalad y abridLa instalación es para vuestro usuario y no pide permisos de administrador. Abrid Rutes Studio desde el menú Inicio.
- DesinstalarConfiguración de Windows › Aplicaciones › Aplicaciones instaladas › Rutes Studio.
electron-builder --mac y obtendréis el instalador para macOS.dist está Rutes-Studio-Setup-1.0.0.exe. Instalada, la app abre desde el menú Inicio y conserva los datos al cerrarla y abrirla.10La landing de Rutes Studio
Objetivo una página web que presente la app con su copy, una captura y el botón de descarga, con el estilo de una web de referencia.
Elegid una web cuyo diseño os guste (la de una app, un estudio o una marca) y copiad su dirección. Codex la mira en el navegador integrado, extrae el sistema visual (tipografías, colores, espacios, botones) y lo aplica a vuestra landing con textos propios. También podéis pegar una captura de la referencia en el chat.
Etapa 10, primera parte. Abre en el navegador integrado [dirección de la web de referencia] y analiza su diseño: tipografías (busca equivalentes en Google Fonts), paleta de colores, escala de tamaños, espaciado, estilo de botones y de tarjetas. Escríbelo en docs/estil.md como un sistema propio para Rutes Studio. No copies textos, logos ni imágenes de la referencia. Enséñame el resumen antes de seguir.
Etapa 10, segunda parte. Escribe el copy de la landing en [tu idioma] a partir de brief_es.md: titular, subtítulo, tres ventajas, cómo funciona en tres pasos, preguntas frecuentes y llamada a descargar. Tono claro y directo, sin exageraciones. Después crea docs/index.html con ese copy y el sistema de docs/estil.md: cabecera, captura de la app (hazla tú con el navegador integrado en http://localhost:8000 y guárdala como docs/captura.png), ventajas, pasos, botón Descargar para Windows que apunte a https://github.com/[tu usuario]/rutes-studio/releases/latest/download/Rutes-Studio-Setup-1.0.0.exe, preguntas y pie. Responsive, accesible y en un solo fichero de estilos. Ábrela en el navegador integrado a 1440 y a 390 px y pasa las comprobaciones de la etapa 10.
Para iterar, usad los comentarios del navegador integrado sobre la propia página («este titular más corto», «más aire entre secciones») o pedid cambios concretos en el chat.
11Publicar: GitHub, instalador y landing en línea
Objetivo el código en GitHub, el instalador en una release y la landing publicada con su dirección pública.
Necesitáis la cuenta de GitHub y gh auth login del apartado 12 del bloque 0. GitHub Pages publica gratis la carpeta docs de un repositorio público.
Etapa 11. Repasa todas las comprobaciones de proves.md y dime cuáles pasan. Crea un README.md en [tu idioma] que explique qué es Rutes Studio, cómo se instala y cómo se arranca en modo desarrollo. Haz un commit, crea con gh un repositorio público llamado rutes-studio en mi cuenta y súbelo. Crea una release v1.0.0 con dist/Rutes-Studio-Setup-1.0.0.exe adjunto. Activa GitHub Pages desde la rama main y la carpeta /docs, espera a que esté publicada y dame la dirección. Pídeme permiso antes de cada paso que suba algo.
gh repo view --web
gh release view v1.0.0
gh api repos/{owner}/rutes-studio/pages
https://vuestro-usuario.github.io/rutes-studio/ y su botón descarga el instalador de la release.gh release view. Si gh dice que no estáis autenticados, repetid gh auth login.IA en tus apps, IA local, MCP y Blender
Cinco prácticas con el mismo formato. La primera añade reconocimiento de imágenes a Biblioteca Studio con Codex como IA, sin API. La segunda construye Biblioteca Studio desde cero como web publicada en internet y le añade la API gratuita de Gemini para reconocer portadas, contraportadas y textos. La tercera construye Arnès, una app de escritorio que descarga Gemma 4 de Hugging Face y funciona sin conexión. Las dos últimas conectan Codex con otras herramientas mediante MCP y le hacen manejar Blender para crear un modelo 3D para Cafès Roca.
00Cómo encaja la IA sin API de pago
Objetivo entender el reparto de trabajo antes de tocar la app: quién reconoce, quién pone los datos y quién guarda.
Vamos a conseguir que Biblioteca Studio añada un libro a partir de una foto de su portada: título, subtítulo, autor, año, páginas, ISBN, sinopsis y portada. Para no pagar una API de IA, la parte inteligente la hace Codex dentro de vuestro plan de ChatGPT, y los datos salen de Open Library, la base de datos pública y gratuita de libros del Internet Archive.
- RequisitoBiblioteca Studio hecha hasta la etapa 7 (exportar e importar datos). Si habéis construido otra app, la etapa 7 de esta práctica adapta el mismo método.
- Materialesbiblioteca-ia-materials.zip: formato de importación, dos libros de ejemplo, carpetas de trabajo y la skill
catalogar-llibres. - FotosTres o cuatro libros vuestros, fotografiados de frente con el móvil, con buena luz y el título legible.
→ Open Library · APIs · Image inputs (OpenAI)
01La app busca en Open Library (sin IA)
Objetivo que el formulario de libro se rellene solo a partir del título, el autor o el ISBN.
Primero, la parte que no necesita IA: la propia app consulta Open Library. Es gratis, no pide clave y responde desde el navegador y desde Electron.
Etapa IA-1. Añade a cada libro los campos subtítulo, año, ISBN, sinopsis, portada (ruta local o URL) y fuente de los datos, con sus textos en textos.json (ca, es, en). En el formulario de nuevo libro añade el botón «Buscar en Open Library»: con lo que haya escrito en título, autor o ISBN, llama una sola vez a https://openlibrary.org/search.json con fields=key,title,subtitle,author_name,first_publish_year,cover_i,isbn,number_of_pages_median y limit=5, y muestra los resultados con miniatura (https://covers.openlibrary.org/b/id/{cover_i}-M.jpg), título, autor y año. Al elegir uno, rellena el formulario; para la sinopsis, pide https://openlibrary.org{key}.json y usa description si existe. Guarda la URL grande de la portada (-L.jpg). Nunca busques mientras se escribe, solo al pulsar el botón, y muestra un mensaje claro si no hay conexión o no hay resultados. Pruébalo con «Mecanoscrit del segon origen» y haz un commit.→ Open Library · Search API · Open Library · Covers API
02Carpetas de trabajo e importación
Objetivo preparar el buzón de fotos y que la app importe los libros que le deje Codex, sin duplicados.
- Descomprimid los materialesCopiad el contenido de biblioteca-ia-materials.zip dentro de la carpeta de Biblioteca Studio (la que tiene
index.html). Quedanfotos/,fotos/fetes/,portades/,importar/,format_importacio.mdy.agents/skills/catalogar-llibres/. - Importación en la appCon el prompt de abajo.
Etapa IA-2. Lee format_importacio.md. Añade en Configuración el botón «Importar libros detectados», que abra un fichero JSON con ese formato y muestre una vista previa: portada, título, autor, confianza, avisos y una casilla por libro (los de confianza baja, desmarcados). Al confirmar, añade solo los marcados y salta los que ya existan (mismo ISBN, o mismo título y autor sin distinguir mayúsculas ni acentos). Para la portada, usa la ruta local si el fichero existe y, si no, portada_url. Pruébalo con importar/llibres_detectats_exemple.json, importándolo dos veces, y haz un commit.
Si no podéis descargar el zip, cread los ficheros con estos prompts
format_importacio.mdEl formato del fichero que escribe Codex.Crear este fichero con un prompt
Crea format_importacio.md con el formato de importar/llibres_detectats.json: un objeto con generat (fecha ISO) y llibres, una lista de libros con titol, subtitol, autor, any, pagines, isbn, genere, sinopsi, portada (ruta local), portada_url, estat (pendent por defecto), confianca (alta, mitjana o baixa), avis, font (dades, sinopsi y la URL de Open Library) y foto. Añade un ejemplo, una tabla de campos y las reglas de duplicados (mismo ISBN, o mismo título y autor).
importar/llibres_detectats_exemple.jsonDos libros reales para probar la importación.Crear este fichero con un prompt
Crea importar/llibres_detectats_exemple.json con el formato de format_importacio.md y dos libros buscados ahora en Open Library: «Mecanoscrit del segon origen» de Manuel de Pedrolo y «Solitud» de Víctor Català, con sus datos, portada_url y una sinopsis de dos frases. Si algún dato de Open Library no coincide con la primera edición, explícalo en avis y pon confianca mitjana. Pídeme permiso antes de usar internet.
fotos/ · fotos/fetes/ · portades/ · importar/Las carpetas de trabajo.Crear este fichero con un prompt
Crea las carpetas fotos, fotos/fetes, portades e importar en este proyecto, cada una con un fichero .gitkeep, y añade fotos/ y portades/ al .gitignore para no subir fotos personales a GitHub.
03Codex reconoce las portadas
Objetivo pasar de unas fotos del móvil a un fichero de libros completo, con Codex como la IA que mira las imágenes.
- Haced las fotosDe frente, con luz, sin reflejos y con el título entero. Si se ve el ISBN en la contraportada, una segunda foto ayuda.
- Pasadlas al ordenadorCon la app Enlace Móvil de Windows, la cámara de OneDrive, por correo o con el cable. Guardadlas en
fotos/. - Pedídselo a CodexCodex mira cada imagen, consulta Open Library y escribe el fichero. Pedirá permiso para usar internet: es para Open Library, aprobadlo.
Etapa IA-3. Mira una a una las imágenes de fotos/ e identifica en cada portada el título, el subtítulo si lo hay, el autor y, si se ve, el ISBN. Para cada libro, haz una sola búsqueda en https://openlibrary.org/search.json (por ISBN si lo tienes; si no, por title y author) con fields=key,title,subtitle,author_name,first_publish_year,cover_i,isbn,number_of_pages_median, con la cabecera User-Agent «BibliotecaStudio-curs» y un segundo de espera entre peticiones. Usa description de https://openlibrary.org{key}.json como sinopsis; si no existe, redacta tú una de dos o tres frases sin desvelar el final y pon Codex como fuente. Descarga la portada a portades/{cover_i}.jpg. Escribe importar/llibres_detectats.json con el formato de format_importacio.md, mueve las fotos procesadas a fotos/fetes/ y acaba con una tabla: foto, título, autor, confianza, fuente de la sinopsis y avisos. No inventes ISBN, años ni páginas. Pídeme permiso antes de usar internet.→ Image inputs (OpenAI) · Sandbox y red (OpenAI)
[sandbox_workspace_write] network_access = true lo deja activado. Si confunde ediciones, pedidle que use el ISBN de la contraportada.04Revisar e importar
Objetivo que una persona decida qué entra en la biblioteca: la IA propone y vosotros aprobáis.
- Abrid la importaciónConfiguración › Importar libros detectados ›
importar/llibres_detectats.json. - Revisad los avisosLos datos públicos también fallan: años de una reedición, autores de un prólogo, subtítulos de otra edición. Corregid antes de importar o desmarcad el libro.
- ImportadSolo los marcados. Después abrid una ficha y comprobad portada, sinopsis y fuente.
Revisa importar/llibres_detectats.json y dime en [tu idioma] qué datos te parecen dudosos (años de reedición, autores que en realidad son traductores o prologuistas, subtítulos que no corresponden) y por qué. No cambies nada hasta que te lo diga.
05Una skill: $catalogar-llibres
Objetivo repetir todo el proceso con una sola palabra, sin volver a pegar el prompt.
Una skill es un fichero SKILL.md con instrucciones que Codex carga cuando las necesita. Las del proyecto viven en .agents/skills/. El zip ya trae catalogar-llibres; si no lo tenéis, Codex la crea con $skill-creator.
$skill-creator Crea en .agents/skills/catalogar-llibres una skill llamada catalogar-llibres a partir de lo que hemos hecho en la etapa IA-3: leer las fotos de fotos/, reconocer título y autor, buscar en Open Library con una petición por libro y User-Agent, sinopsis de Open Library o redactada por ti con la fuente indicada, portada en portades/, salida en importar/llibres_detectats.json según format_importacio.md sin duplicados, fotos a fotos/fetes/ y tabla final. Que se active solo cuando pida catalogar libros a partir de fotos.
/skills
$catalogar-llibres
/skills lista catalogar-llibres. Con fotos nuevas en fotos/, escribir $catalogar-llibres repite todo el proceso y amplía el fichero sin duplicar..agents/skills/catalogar-llibres/SKILL.md dentro del proyecto abierto y empezad un chat nuevo: las skills se cargan al empezar.06Opcional: que se haga solo cada día
Objetivo dejar fotos en la carpeta y encontrar al día siguiente el fichero listo para importar.
Las tareas programadas de la app de ChatGPT ejecutan un prompt en un horario, también dentro de un proyecto local, y pueden usar skills. El ordenador tiene que estar encendido y la app abierta; la disponibilidad depende del plan.
Crea una tarea programada en este proyecto que cada día a las 9:00 ejecute $catalogar-llibres solo si hay fotos nuevas en fotos/, y que si no hay ninguna termine sin hacer nada. Dime dónde la veré.
network_access = true en config.toml solo para este proyecto o ejecutadla a una hora en la que estéis delante.07El mismo método en las otras apps
Objetivo aplicar el patrón foto → Codex → datos públicos → importación a la app que hayáis construido.
| App | Foto | Datos públicos | Qué rellena |
|---|---|---|---|
| Focus Studio | Captura de un correo o de una lista de tareas | Ninguna: Codex lee el texto | Proyecto, tareas y estimación de bloques |
| Astronomia Studio | Foto del cielo o de una carta celeste | API de resúmenes de Wikipedia | Objeto, tipo y una nota con su descripción |
| QR Studio | Foto de un cartel o de un folleto | Ninguna: Codex lee el texto y la dirección | Campaña con título, texto, URL y fechas |
| Hort Studio | Foto de una planta o de un sobre de semillas | cultius.json del propio proyecto | Cultivo, bancal y fecha de siembra |
| Col·leccions Studio | Foto de la portada de un disco | MusicBrainz y Cover Art Archive | Título, artista, año, género y portada |
| Rutes Studio | Foto de un poste o de un panel de sendero | Nominatim de OpenStreetMap | Nombre, zona y coordenadas del inicio |
Quiero aplicar a esta app el método de la práctica de IA de Biblioteca Studio: fotos en fotos/, Codex reconoce lo que hay en cada imagen, completa los datos con [base de datos pública o fichero del proyecto] y escribe importar/detectats.json para que la app lo importe con vista previa y sin duplicados. Propón en [tu idioma] el formato del fichero, los cambios en la app y la skill, en etapas como las de Biblioteca. Comprueba antes en la documentación oficial de esa base de datos sus límites de uso. No cambies nada todavía.
00Qué vamos a construir
Objetivo ver el recorrido completo: primero la app con Codex, después la IA de Google dentro de la propia app.
En dos partes. En la parte A, Codex construye Biblioteca Studio paso a paso como aplicación web y la publicamos en internet con Vercel, gratis con la cuenta de GitHub. En la parte B, la app gana IA: con una foto reconoce el título, el autor y el ISBN de la portada, copia la sinopsis de la contraportada o transcribe cualquier texto, gracias a la API de Gemini de Google, que tiene nivel gratuito.
| Necesitáis | Detalle |
|---|---|
| Codex configurado | Bloque 0 de la landing avanzada, con Git, Node.js y GitHub CLI. |
| Cuenta de GitHub | La misma de los apartados 12 del bloque 0. |
| Cuenta de Google personal | Para la clave gratuita de Gemini (mayores de 18 años). |
| Móvil | Para probar la app publicada con la cámara. |
→ Ayuda de OpenAI · ChatGPT Sites · Vercel · Hobby · Gemini API · Pricing
Parte A · Biblioteca Studio paso a paso
01Carpeta, materiales y plan
Objetivo tener el proyecto abierto en Codex y un plan aprobado para la versión web.
- Descargad los materialesbiblioteca-studio-materials.zip: AGENTS.md, brief, textos en tres idiomas, doce libros de ejemplo, comprobaciones e icono. Cada fichero tiene su prompt en la etapa 0 de Biblioteca Studio.
- Descomprimid y abridEn
Documentos\biblioteca-studio-materials, fuera de OneDrive. En Codex: Add new project y permisos en Ask for approval. - Pedid el planCon el prompt de abajo. Respondedle las preguntas en el mismo chat.
Lee AGENTS.md y brief_es.md. Esta vez Biblioteca Studio será una aplicación web publicada en Vercel, sin Electron ni instalador: actualiza AGENTS.md y el brief en este sentido. Después propón en [tu idioma] un plan con estos pasos: A-2 catálogo, A-3 préstamos, A-4 estadísticas, A-5 idiomas y datos, A-6 búsqueda en Open Library, A-7 publicar en GitHub y Vercel; y después B-8 clave de Gemini, B-9 función de reconocimiento, B-10 fotos en la app, B-11 publicar con la IA y B-12 vigilar el uso. Para cada paso, dime qué ficheros crearás o cambiarás. No escribas código todavía.
02Catálogo de libros
Objetivo una primera versión que ya funciona: añadir, buscar y filtrar libros.
Paso A-2. Crea index.html, styles.css y app.js con el catálogo de Biblioteca Studio: añadir, editar y borrar libros (título, autor, género, páginas, estado leído/leyendo/pendiente y valoración de 1 a 5 estrellas); lista con buscador por título o autor y filtro por estado. Guarda todo en localStorage. Carga los textos desde textos.json, de momento en castellano. Para probarlo, sirve la carpeta con python -m http.server 8000, ábrela en el navegador integrado en http://localhost:8000 y pasa las comprobaciones de la etapa 2 de proves.md. Haz un commit al terminar.
http://localhost:8000. Si python no existe, pedid a Codex que use npx serve.03Préstamos
Objetivo saber qué libros están prestados, a quién y desde cuándo.
Paso A-3. Añade los préstamos: prestar un libro (a quién y fecha), marcarlo como devuelto y ver la lista de préstamos activos. Los que lleven más de 30 días se marcan como atrasados con un aviso visible. Un libro prestado muestra a quién en su ficha. Enséñame el resultado en el navegador integrado y pasa las comprobaciones de la etapa 3. Haz un commit al terminar.
04Estadísticas de lectura
Objetivo ver cuánto y qué leéis, y si vais bien con el objetivo del año.
Paso A-4. Al marcar un libro como leído, guarda la fecha de fin. Añade una vista de estadísticas: libros leídos este año frente a un objetivo anual configurable (24 por defecto) con barra de progreso, páginas leídas, libros por género y un gráfico de barras de libros leídos por mes dibujado con SVG, sin librerías. Para probarlo, crea un botón temporal que genere lecturas de ejemplo y otro que las borre. Pasa las comprobaciones de la etapa 4. Haz un commit al terminar.
05Idiomas y copia de los datos
Objetivo la app en catalán, castellano e inglés, y poder pasar la biblioteca de un navegador a otro.
Paso A-5. Añade un selector de idioma (català, castellano, English) que cambie todos los textos con los de textos.json y recuerde la elección; pasa a textos.json cualquier texto escrito a mano en el código. En Configuración añade Exportar datos (JSON con libros, préstamos y ajustes), Importar datos desde ese JSON e Importar desde CSV con el formato de llibres_exemple.csv; si el fichero está mal formado, muestra un aviso y no borres nada. Prueba con llibres_exemple.csv, pasa las comprobaciones de idiomas y datos de proves.md y haz un commit.
06Buscar libros en Open Library
Objetivo que el formulario se rellene desde una base de datos pública con el título, el autor o el ISBN.
Paso A-6. Añade a cada libro los campos subtítulo, año, ISBN, sinopsis, portada (URL) y fuente de los datos, con sus textos en textos.json. En el formulario de nuevo libro añade el botón «Buscar en Open Library»: con lo escrito en título, autor o ISBN, llama una vez a https://openlibrary.org/search.json con fields=key,title,subtitle,author_name,first_publish_year,cover_i,isbn,number_of_pages_median y limit=5, y muestra los resultados con miniatura (https://covers.openlibrary.org/b/id/{cover_i}-M.jpg), título, autor y año. Al elegir uno, rellena el formulario; para la sinopsis, pide https://openlibrary.org{key}.json y usa description si existe. Busca solo al pulsar el botón y muestra un aviso si no hay conexión o resultados. Prueba con «Mecanoscrit del segon origen» y haz un commit.→ Open Library · Search API · Open Library · Covers API
07Publicar en GitHub y en Vercel
Objetivo la app en una dirección pública, todavía sin IA, que se actualiza sola con cada cambio.
Paso A-7. Repasa las comprobaciones de proves.md de los pasos anteriores y dime cuáles pasan. Crea un README.md en [tu idioma], un .gitignore que excluya node_modules, .env, .env.local y .vercel, y un vercel.json mínimo para servir la web estática desde la raíz sin paso de build (consulta https://vercel.com/docs/project-configuration). Haz un commit, crea con gh un repositorio público llamado biblioteca-studio y súbelo. Pídeme permiso antes de cada paso que suba algo.
- Cread la cuenta de Vercelvercel.com/signup › plan Hobby › Continue with GitHub. Hobby es gratuito y para uso personal sin fines comerciales.
- Importad el repositorioAdd New › Project ›
biblioteca-studio› Import. Framework: Other. Deploy. - Abrid la direcciónVercel da una dirección
…vercel.app. Abridla también en el móvil. Desde ahora, cada push amainpublica una versión nueva.
→ Vercel · Project configuration · Vercel · Hobby
…vercel.app, también en el móvil; cada navegador tiene su propia biblioteca (localStorage), y Exportar e Importar la pasan de uno a otro.gh auth login.Parte B · La IA de Google Gemini en la app
08Conseguir la clave gratuita de Gemini
Objetivo una clave del nivel gratuito, restringida a la API de Gemini, guardada fuera del repositorio y probada.
- Abrid Google AI StudioEntrad en aistudio.google.com/apikey con una cuenta de Google personal y aceptad las condiciones.
- Cread la claveCreate API key. Si el botón sale gris, la cuenta no tiene permisos sobre el proyecto: usad una cuenta personal. Copiad la clave.
- RestringidlaSi aparece como Unrestricted: Add restrictions › Restrict to Gemini API only. La API rechaza las claves sin restringir.
- Mirad vuestros límitesEn AI Studio › Rate limit: peticiones por minuto y por día de cada modelo. Usaremos
gemini-3.8-flash, ygemini-3.5-flash-litesi se agota. - Guardadla para trabajar en localCread en la raíz del proyecto un fichero
.env.localcomo el de abajo. Está en.gitignoredesde el paso A-7, así que no se sube a GitHub.
GEMINI_API_KEY=pega-aquí-tu-clave
GEMINI_MODEL=gemini-3.8-flash
CODIGO_ACCESO=elige-un-código-largo
Paso B-8. Comprueba que .env.local está en .gitignore y que nunca se ha subido. Después, sin mostrar la clave, haz una petición de prueba a la API de Gemini con el modelo de GEMINI_MODEL siguiendo https://ai.google.dev/gemini-api/docs/text-generation, que responda «hola» en [tu idioma], y dime qué ha contestado. Pídeme permiso antes de usar internet.
→ Gemini API · API key · Gemini API · Rate limits · Gemini API · Pricing
git status no muestra .env.local.gemini-3.5-flash-lite. Si .env.local aparece en git status, parad y pedid a Codex que lo saque del seguimiento antes de cualquier commit.09La función que reconoce
Objetivo un punto del servidor de la app que recibe una foto y devuelve en JSON lo que Gemini ha reconocido.
La función entiende tres encargos, cada uno con su formato de respuesta:
| Modo | Para qué | Devuelve |
|---|---|---|
| portada | Identificar el libro | título, subtítulo, autor, ISBN, idioma, confianza |
| contraportada | Sinopsis e ISBN impresos | sinopsis, ISBN, editorial, confianza |
| texto | Copiar una cita o una página | texto e idioma |
{
"portada": {
"type": "object",
"properties": {
"titol": {
"type": "string"
},
"subtitol": {
"type": "string"
},
"autor": {
"type": "string"
},
"isbn": {
"type": "string"
},
"idioma": {
"type": "string"
},
"confianca": {
"type": "string",
"enum": [
"alta",
"mitjana",
"baixa"
]
}
},
"required": [
"titol",
"autor",
"confianca"
]
},
"contraportada": {
"type": "object",
"properties": {
"isbn": {
"type": "string"
},
"sinopsi": {
"type": "string"
},
"editorial": {
"type": "string"
},
"confianca": {
"type": "string",
"enum": [
"alta",
"mitjana",
"baixa"
]
}
},
"required": [
"sinopsi",
"confianca"
]
},
"text": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"idioma": {
"type": "string"
}
},
"required": [
"text"
]
}
}npm install -g vercel
vercel login
vercel link
Paso B-9. Lee https://vercel.com/docs/functions, https://ai.google.dev/gemini-api/docs/image-understanding y https://ai.google.dev/gemini-api/docs/structured-output. Crea api/reconocer.js como función de Vercel con el formato fetch(request) de su documentación. Solo acepta POST con JSON {modo, imagen (base64 JPEG), idioma}; rechaza la petición si la cabecera x-codigo-acceso no coincide con CODIGO_ACCESO, si el modo no es portada, contraportada o texto, o si la imagen pasa de 2 MB. Llama a la API de Gemini con GEMINI_API_KEY y GEMINI_MODEL de las variables de entorno, la imagen y un encargo distinto para cada modo, pidiendo la respuesta en JSON con los esquemas que te paso; en portada, si no está seguro, confianza baja; en contraportada, la sinopsis tal como está impresa. Usa un tiempo máximo de 30 segundos y devuelve los errores como JSON {error: sin_codigo | codigo_incorrecto | limite | clave | gemini | imagen}. No guardes ni registres la imagen ni la clave. Añade a package.json el script «web» que ejecute vercel dev, pruébala en local con una foto de un libro en los tres modos y haz un commit.→ Vercel · Functions · Gemini API · Image understanding · Gemini API · Structured output
npm run web, las tres pruebas devuelven JSON con los campos de su esquema, y una petición sin código devuelve un error de código.clave, la función no lee .env.local: reiniciad npm run web. Si Gemini contesta texto en lugar de JSON, pedid a Codex que revise el formato con la guía de salida estructurada. La primera vez, vercel link pregunta por el proyecto: elegid el de biblioteca-studio.10Reconocer con una foto desde la app
Objetivo que la app haga la foto, la mande a la función y rellene el libro con título, autor, sinopsis o texto.
Paso B-10. En la lista de libros añade el botón «Añadir desde foto» con tres opciones: Portada, Contraportada y Texto. Usa un input de imagen con capture="environment" para que en el móvil abra la cámara trasera y en el ordenador permita elegir un fichero. Reduce la imagen en el navegador a 1024 px de lado mayor en JPEG, corrigiendo la orientación, y envíala a /api/reconocer con el código de acceso guardado en Configuración (campo nuevo «Código de acceso», guardado en local). Con Portada, busca en Open Library como en el paso A-6 y abre el formulario relleno con la fuente «Gemini + Open Library» para que yo lo revise. Con Contraportada, rellena sinopsis e ISBN con la fuente «Contraportada» y, si hay ISBN, completa el resto desde Open Library. Con Texto, añade lo leído a las notas del libro abierto. Traduce cada error de la función a un mensaje claro en ca, es y en, muestra un indicador mientras espera y comprueba que se ve bien a 390 px. Pruébalo con npm run web y haz un commit.
11Publicar con la IA y probar en el móvil
Objetivo la app pública con la clave guardada como secreto en Vercel.
- Añadid las variables en VercelProyecto › Settings › Environment Variables:
GEMINI_API_KEY(tipo Secret),GEMINI_MODELyCODIGO_ACCESO, para Production. - Subid los cambiosCommit y push a GitHub: Vercel despliega la versión nueva con las variables.
- Probad en el móvilAbrid la dirección
…vercel.app, escribid el código de acceso en Configuración y fotografiad un libro.
Paso B-11. Abre en el navegador integrado la dirección de Vercel que te paso y comprueba que la app carga, que /api/reconocer responde con un error de código si no se envía el código y que en el código fuente de la página no aparece ninguna clave. Después añade al README en [tu idioma] el apartado «IA con Gemini»: cómo conseguir la clave gratuita, las tres variables que hay que poner en Vercel, el aviso de privacidad del nivel gratuito y qué hacer ante el límite. Haz un commit y súbelo. Dirección: [pega aquí la dirección de Vercel]
→ Vercel · Environment variables
clave y en local funcionaba, las variables se añadieron después del último despliegue: Deployments › los tres puntos del último › Redeploy.12Vigilar el uso y cambiar la clave
Objetivo saber cuánto se usa la IA y qué hacer si el código o la clave se filtran.
| Situación | Qué hacer |
|---|---|
| Consultar el consumo de Gemini | AI Studio muestra las peticiones por modelo y día. Si se acerca al límite, cambiad GEMINI_MODEL a un modelo Flash-Lite y volved a desplegar. |
| Consultar la función | Vercel › Observability › Vercel Functions: invocaciones y errores. |
| El código de acceso se ha filtrado | Cambiad CODIGO_ACCESO en Vercel y volved a desplegar. |
| La clave se ha filtrado | Borradla en AI Studio, cread otra, cambiadla en Vercel y en .env.local, y volved a desplegar. Borrarla de un fichero no la quita del historial de Git. |
Paso B-12. Busca en todo el proyecto y en el historial de Git cualquier rastro de una clave de API (por ejemplo cadenas que empiecen por AIza) sin mostrarla completa. Añade en Configuración un contador local de reconocimientos hechos hoy y un aviso cuando la función devuelva limite. Haz un commit y súbelo.
→ Vercel · Rotating secrets · Gemini API · API key
Roadmap ARness
La versión completa de esta práctica como roadmap paso a paso para macOS y Windows: ARness, un Codex casero para modelos locales con chat, conexión, proyectos, herramientas y permisos.
00Qué es un arnés de IA local
Objetivo saber qué vamos a montar, qué modelo usar y si vuestro equipo lo aguanta.
Un arnés es el programa que rodea al modelo: lo descarga, lo carga en memoria, le pasa vuestras instrucciones y muestra la respuesta. LM Studio u Ollama son arneses. Vamos a construir el nuestro, Arnès, con Electron y node-llama-cpp (llama.cpp para Node.js), y haremos que descargue Gemma 4, el modelo abierto de Google, desde Hugging Face.
| Modelo | Descarga | RAM | Para qué |
|---|---|---|---|
| Gemma 4 E2B · Q4_0 | 2,8 GB | 8 GB o más | Portátiles normales; el de la demo |
| Gemma 4 E4B · Q4_0 | 4,6 GB | 16 GB | Mejores respuestas si el equipo lo permite |
| Gemma 4 26B y 31B | 16 GB o más | 32 GB y gráfica | Fuera de esta práctica |
→ Gemma 4 E2B GGUF (Hugging Face) · Gemma 4 E4B GGUF (Hugging Face) · node-llama-cpp · Electron
01Crear el proyecto con la plantilla oficial
Objetivo partir de la plantilla de node-llama-cpp para Electron, que ya resuelve el empaquetado de las piezas nativas.
- Abrid el terminal integradoEn Codex, en la carpeta
Documentos. La plantilla hace preguntas, así que la creáis vosotros. - Cread el proyectoCuando pregunte el nombre,
arnes. Si pregunta por un modelo para descargar, saltadlo: lo descargará la app. - Añadid los materialesCopiad dentro de
arnesel contenido de arnes-materials.zip y abrid la carpeta en Codex con Add new project.
cd $HOME\Documents
npm create node-llama-cpp@latest -- --template electron-typescript-react
Etapa L-1. Lee AGENTS.md, brief_es.md, el README y package.json de la plantilla. Explícame en [tu idioma], en cinco puntos, cómo está organizada (proceso principal, interfaz, cómo se comunican, dónde se carga el modelo y cómo se empaqueta). Después instala las dependencias, cambia el nombre visible de la app a «Arnès» y arráncala en modo desarrollo. Pasa las comprobaciones de la etapa 1 de proves.md y haz el primer commit.
Si no podéis descargar el zip, cread los ficheros con estos prompts
models.jsonCatálogo de modelos que la app ofrece.Crear este fichero con un prompt
{
"models": [
{
"id": "gemma-4-e2b",
"nom": "Gemma 4 E2B (Q4_0)",
"uri": "hf:ggml-org/gemma-4-E2B-it-GGUF/gemma-4-E2B-it-Q4_0.gguf",
"mida_gb": 2.8,
"ram_min_gb": 8,
"llicencia": "Apache 2.0",
"font": "https://huggingface.co/ggml-org/gemma-4-E2B-it-GGUF",
"nota": "El més lleuger. Funciona en portàtils de 8 GB de RAM."
},
{
"id": "gemma-4-e4b",
"nom": "Gemma 4 E4B (Q4_0)",
"uri": "hf:ggml-org/gemma-4-E4B-it-GGUF/gemma-4-E4B-it-Q4_0.gguf",
"mida_gb": 4.6,
"ram_min_gb": 16,
"llicencia": "Apache 2.0",
"font": "https://huggingface.co/ggml-org/gemma-4-E4B-it-GGUF",
"nota": "Respon millor; recomanat amb 16 GB de RAM o targeta gràfica."
}
]
}AGENTS.mdNormas para Codex en este proyecto.Crear este fichero con un prompt
Crea AGENTS.md para Arnès, una app Electron basada en la plantilla de node-llama-cpp que descarga modelos abiertos de Hugging Face y los ejecuta en local. Normas: responde en el idioma del usuario; plan antes de cambiar ficheros; una etapa cada vez; avisa antes de descargas grandes con su tamaño; node-llama-cpp solo en el proceso principal y comunicación por IPC; modelos en userData/models, nunca en el proyecto ni en el instalador; catálogo solo desde models.json; nada de lo que escribe el usuario sale del ordenador; textos en ca, es y en; comprobar con proves.md.
brief_es.md / brief_ca.md · proves.mdEncargo y comprobaciones por etapa.Crear este fichero con un prompt
Crea brief_es.md para Arnès con objetivo (app de escritorio que descarga Gemma 4 de Hugging Face y funciona sin conexión), funciones (catálogo y descarga con progreso, chat con streaming y botón de parar, estado con aceleración y tokens por segundo, adjuntar .txt o .md, historial local, instalador sin modelo), aspecto, fuera de alcance y cómo comprobarlo. Después crea proves.md con casillas para las etapas 1 a 5 de la práctica.
opinions_exemple.txtDiez opiniones inventadas de Cafès Roca.Crear este fichero con un prompt
1. El cafè amb llet de Gràcia és el millor del barri, però a les 9 h la cua surt per la porta.
2. Vam esperar vint minuts per a dos croissants al Poblenou. El cambrer es va disculpar, això sí.
3. Sants té la terrassa més agradable i el preu de l'esmorzar és molt raonable.
4. El pa de vidre amb tomàquet estava sec. Abans era molt millor.
5. M'encanta que tinguin llet de civada sense cost addicional.
6. El wifi del Poblenou no funciona mai i hi vaig a treballar.
7. Personal molt amable a Gràcia; recorden el que demano cada dia.
8. La música massa alta a la tarda a Sants, no es pot parlar.
9. Les galetes de xocolata són boníssimes, però s'acaben abans de les 12.
10. Van cobrar-me dos cops el mateix cafè al Poblenou; ho van tornar de seguida.
npm create falla, comprobad Node.js 20 o superior con node --version (apartado 11 del bloque 0). Si la instalación de dependencias tarda, es normal: descarga las piezas nativas de llama.cpp para Windows.02La app descarga Gemma 4 de Hugging Face
Objetivo un catálogo de modelos con botón Descargar, progreso y cancelación, sin salir de Arnès.
Etapa L-2. Crea la pantalla «Modelos» a partir de models.json: para cada modelo, nombre, tamaño, RAM mínima, licencia, enlace a su página de Hugging Face y estado (sin descargar, descargando, listo). Muestra también la RAM total del equipo y avisa si es menor que la mínima. El botón Descargar usa createModelDownloader de node-llama-cpp en el proceso principal con la URI hf: del catálogo y la carpeta models dentro de app.getPath('userData'); envía el progreso a la ventana (porcentaje, MB y velocidad) y permite cancelar. Antes de empezar, comprueba el espacio libre en disco. Un modelo ya descargado no se vuelve a bajar. Lee antes https://node-llama-cpp.withcat.ai/guide/downloading-models. Lanza la descarga de Gemma 4 E2B para probarlo y haz un commit.→ node-llama-cpp · Downloading models
03Chatear con el modelo en vuestro equipo
Objetivo un chat que responde palabra a palabra, se puede parar y enseña cómo trabaja el equipo.
Etapa L-3. En el proceso principal, carga el modelo elegido con getLlama y una LlamaChatSession, y crea una pantalla de chat: respuesta en streaming enviada por IPC, botón Parar, instrucciones de sistema editables (por defecto: «Eres un asistente que responde en el idioma del usuario, con frases claras») y temperatura entre 0 y 1. Añade una barra de estado con el modelo cargado, la aceleración que ha detectado node-llama-cpp (CPU, Vulkan o CUDA) y los tokens por segundo de la última respuesta. Que se pueda cambiar de modelo sin cerrar la app, liberando la memoria del anterior. Pasa las comprobaciones de la etapa 3 y haz un commit.
04Sin conexión y con vuestros documentos
Objetivo comprobar que nada sale del equipo y trabajar con datos que no querríais enviar a un servicio en la nube.
Etapa L-4. Añade un botón para adjuntar un fichero .txt o .md a la conversación: su texto se añade como contexto del siguiente mensaje y se muestra cuánto ocupa en tokens respecto al contexto disponible. Guarda las conversaciones en userData en JSON, con una lista lateral para abrirlas y un botón para borrarlas. Pasa las comprobaciones de la etapa 4 y haz un commit.
- Apagad el Wi-FiO desconectad el cable. Arnès tiene que seguir respondiendo.
- Adjuntad las opiniones
opinions_exemple.txtdel zip: diez opiniones inventadas de clientes de Cafès Roca. - Pedid la clasificaciónCon el prompt de abajo, en Arnès.
Clasifica cada opinión del fichero como positiva, negativa o mixta, indica el local (Gràcia, Poblenou o Sants) y el tema (servicio, producto, espera, ambiente, precio u otro). Devuélvelo en una tabla y acaba con los tres problemas más repetidos.
05El instalador de Arnès
Objetivo un .exe que cualquiera instala y que descarga el modelo la primera vez.
Etapa L-5. Revisa la configuración de empaquetado de la plantilla: nombre Arnès, icono, appId com.cibernarium.arnes y nombre de fichero Arnes-Setup-${version}.exe. Comprueba que las piezas nativas de node-llama-cpp quedan fuera del archivo asar y que ningún fichero .gguf entra en el instalador. Genera el instalador para Windows con el script de la plantilla, dime dónde está y cuánto ocupa. Después crea un README en [tu idioma] con requisitos de RAM, modelos disponibles y licencia de Gemma 4 (Apache 2.0), y haz un commit.06Plan B: Ollama o LM Studio como motor
Objetivo tener una alternativa si node-llama-cpp no funciona en algún equipo, manteniendo la misma interfaz.
| Motor | Cómo se descarga Gemma 4 | Dirección local |
|---|---|---|
| Ollama | ollama pull gemma4:e2b o desde Hugging Face con ollama pull hf.co/ggml-org/gemma-4-E2B-it-GGUF:Q4_0 | http://localhost:11434/api |
| LM Studio | Buscador de modelos de la app o lms get | lms server start --port 1234 y http://localhost:1234, con endpoints compatibles con OpenAI |
Etapa L-6. Añade en Configuración un selector de motor: «Integrado (node-llama-cpp)», «Ollama» y «LM Studio». Con Ollama, la app lista los modelos instalados, puede descargar gemma4:e2b con su API de descarga mostrando el progreso y conversa por http://localhost:11434. Con LM Studio, conversa por su servidor local (lms server start --port 1234) con los endpoints compatibles con OpenAI. Si el motor no responde, explica cómo arrancarlo. Lee antes la documentación oficial de la API de Ollama y del servidor de LM Studio. Haz un commit.
→ Ollama · gemma4 · Ollama · API · LM Studio · servidor local
lms server start --port 1234; en Ollama, comprobad que el icono está en la bandeja del sistema.00Qué es un MCP y cómo funciona
Objetivo entender qué añade un servidor MCP a Codex antes de instalar ninguno.
MCP (Model Context Protocol) es un estándar para que Codex use herramientas e información de otros sistemas: consultar documentación actualizada, manejar un navegador, leer incidencias de GitHub o diseños de Figma. Un servidor MCP es un pequeño programa que publica esas herramientas.
STDIO · en vuestro ordenador
Codex arranca el servidor con una orden (por ejemplo npx). Necesita Node.js. Ejemplos: Context7, Playwright.
Streamable HTTP · en internet
Codex se conecta a una dirección https:// del servicio, a veces con inicio de sesión. Ejemplo: Figma remoto.
La app, la CLI y la extensión de VS Code comparten la misma configuración de MCP. Cada servidor activo añade contexto a cada mensaje y gasta límite de uso: activad solo los que necesitéis.
→ Model Context Protocol (OpenAI) · Pricing · MCP y límites
01Ver qué servidores tenéis
Objetivo saber dónde se gestionan los MCP en la app.
- Desde el chatEscribid
/mcpen la caja de escribir: Codex lista los servidores conectados y sus herramientas. - Desde AjustesSettings (Ctrl+,) › MCP servers. Aquí se añaden, se editan, se autentican y se desactivan.
- En el ficheroTodo queda en
config.toml(%USERPROFILE%\.codex\), en una tabla[mcp_servers.nombre]por servidor.
/mcp responde (aunque la lista esté vacía).02El primer MCP: Context7
Objetivo que Codex consulte documentación técnica actualizada en lugar de recordar versiones antiguas.
- Añadir el servidorSettings › MCP servers › Add server. Nombre:
context7. Tipo: STDIO. Orden:npx. Argumentos:-y @upstash/context7-mcp. - Guardar y reiniciarSave y después Restart.
- ComprobarEscribid
/mcpy buscadcontext7con sus herramientas.
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp list
Usa context7 para consultar la documentación actual de Electron sobre BrowserWindow y electron-builder con destino nsis. Explícame en [tu idioma], en cinco puntos, qué opciones necesitamos para nuestra app y dime de qué versión es la documentación que has leído.
npx -y @upstash/context7-mcp en el terminal integrado y leed el error. Si tarda en arrancar, subid startup_timeout_sec a 30.03Un MCP que actúa: Playwright
Objetivo que Codex abra un navegador, recorra vuestra landing y la compruebe como lo haría una persona.
- Añadir el servidorAdd server › nombre
playwright› STDIO › ordennpx› argumentos@playwright/mcp@latest› Save › Restart. - Arrancar vuestra landingCon el servidor local de la etapa 2 (
python -m http.server 8000) en la carpeta de vuestra app.
Usa playwright para abrir http://localhost:8000/docs/ en un navegador. Recorre la página a 1440 y a 390 px de ancho, haz una captura de cada tamaño, prueba que todos los enlaces y el botón de descarga apuntan a una dirección válida y que se puede navegar con el tabulador. Dame una lista de problemas ordenada por importancia y no cambies nada hasta que te lo diga.
04Controlar qué puede hacer cada MCP
Objetivo decidir qué herramientas se usan, cuándo pide permiso y apagar lo que no se usa.
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
default_tools_approval_mode = "prompt" # auto | prompt | writes | approve
startup_timeout_sec = 30
tool_timeout_sec = 90
enabled = true # false para apagarlo sin borrarlo
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
default_tools_approval_mode = "auto" # solo lee documentación
| Opción | Para qué sirve |
|---|---|
default_tools_approval_mode | prompt pregunta siempre; writes pregunta solo en herramientas que cambian cosas; auto no pregunta. |
enabled_tools / disabled_tools | Lista de herramientas permitidas y bloqueadas de ese servidor. |
enabled | Apaga el servidor sin borrar su configuración. |
startup_timeout_sec / tool_timeout_sec | Segundos de espera al arrancar (10 por defecto) y por cada herramienta (60). |
bearer_token_env_var | Para servidores HTTP con clave: el nombre de la variable de entorno que la guarda. La clave nunca va en el fichero. |
Revisa mi config.toml y explícame en [tu idioma] qué servidores MCP tengo, qué herramientas publica cada uno y cuándo me pedirán permiso. Propón qué apagar para gastar menos límite cuando no lo use. No cambies nada sin preguntarme.
→ Model Context Protocol · opciones · Configuration Reference
enabled = false en un servidor y reiniciando, /mcp ya no lo lista.00Qué es Computer Use y qué necesitamos
Objetivo preparar Blender y Computer Use para que Codex pueda manejar Blender con el ratón y el teclado.
Computer Use deja que Codex vea la pantalla y maneje aplicaciones de escritorio: mueve el puntero, pulsa menús y escribe. Sirve para programas sin conexión directa con Codex, como Blender.
- Instalad BlenderGratuito, desde blender.org/download. Abridlo una vez y cerrad la pantalla de bienvenida.
- Instalad el plugin Computer UseEn Codex: Plugins › Computer Use › Install plugin (o Enable). Activad los interruptores del servidor y de la skill y pulsad Try now.
- Permisos en MacAjustes del Sistema › Privacidad y seguridad: Grabación de pantalla y Accesibilidad para Codex Computer Use.
- Permitir BlenderLa primera vez que Codex use Blender pedirá permiso. Para no repetirlo, añadid Blender a Settings › Computer use › Always-allowed apps, o en
config.toml:[computer_use.windows]conalways_allowed_app_ids = ["blender.exe"]. - En WindowsComputer Use trabaja en primer plano: mientras actúa, Blender tiene que estar visible y no hay que tocar el ratón ni el teclado.
01Preparar la escena
Objetivo una carpeta de práctica y una escena de Blender guardada dentro.
- CarpetaCread
Documentos\blender-cafes-rocay abridla en Codex con Add new project. - EscenaEn Blender: Archivo › Guardar como ›
taza.blenddentro de esa carpeta. Así cada cambio queda en un fichero del proyecto. - VentanasBlender a pantalla completa y Codex al lado o en otra pantalla, para ver lo que hace.
Vamos a crear en Blender una taza de café para la cafetería Cafès Roca usando Computer Use. Antes de tocar nada, explícame en [tu idioma] el plan en pasos: qué objetos crearás, qué modificadores usarás y qué colores pondrás. Los colores de la marca son #3B2A1F (marrón café), #F4EBDD (crema) y #C8553D (terracota). No uses Blender todavía.
02Modelar la taza con Computer Use
Objetivo que Codex construya la taza manejando la interfaz de Blender.
Usa @Computer con Blender para seguir el plan: borra el cubo; crea el cuerpo de la taza con un cilindro, ábrelo por arriba y dale grosor con el modificador Solidify; crea el asa con un toro deformado y únela al lateral; añade un plato con un cilindro aplanado y el café con un disco marrón dentro de la taza; suaviza con Subdivision Surface y sombreado suave. Pon materiales con los colores de la marca: taza crema, franja terracota y café marrón. Ve explicándome cada paso, guarda con Ctrl+S al final y no cierres Blender.
La primera vez que Codex use Blender os pedirá permiso: elegid permitir para esta tarea. Si no queréis que vuelva a preguntar, Always allow.
03Revisar e iterar
Objetivo mejorar el modelo con cambios concretos, como haríais con un diseñador.
Haz una captura de la vista de Blender, compárala con el plan y dime en [tu idioma] tres cosas que mejorarías del modelo (proporciones, unión del asa, grosor de las paredes). Espera a que te diga cuáles aplicar.
Aplica las mejoras 1 y 3. Después coloca la cámara en un plano de tres cuartos ligeramente desde arriba y una luz de área cálida a la izquierda. Guarda con Ctrl+S.
04Render y exportación
Objetivo una imagen final y un modelo 3D listos para usar en una web.
Usa @Computer con Blender: pon la resolución de salida a 1920 × 1080, renderiza la imagen con F12 y guárdala como render_taza.png en la carpeta del proyecto (Imagen › Guardar como). Después exporta el modelo con Archivo › Exportar › glTF 2.0 como taza.glb en la misma carpeta. Dime cuándo esté hecho.
05La misma taza con un script de Python
Objetivo comparar Computer Use con la vía más fiable y repetible: un script que Blender ejecuta solo.
Blender se puede programar en Python. Codex escribe el script, lo ejecuta con Blender en segundo plano y obtiene el mismo resultado sin mover el ratón. La documentación de OpenAI recomienda una integración estructurada como esta siempre que exista.
Escribe taza.py, un script de Python para Blender (bpy) que cree desde cero la misma taza: cuerpo con Solidify, asa, plato, café, Subdivision Surface, materiales con #3B2A1F, #F4EBDD y #C8553D, cámara, luz, render a 1920 × 1080 en render_script.png y exportación a taza_script.glb. Localiza blender.exe en mi ordenador y ejecútalo con blender --background --python taza.py. Pídeme permiso antes de ejecutarlo.
| Computer Use | Script de Python | |
|---|---|---|
| Cómo trabaja | Mira la pantalla y pulsa como una persona. | Escribe instrucciones que Blender ejecuta. |
| Repetible | Cada vez sale algo distinto. | El mismo resultado siempre. |
| Velocidad | Lenta: necesita capturas. | Segundos. |
| Mientras trabaja | No podéis usar el ordenador (Windows). | Podéis seguir trabajando. |
| Cuándo usarlo | Programas sin otra vía, comprobaciones visuales. | Siempre que el programa se pueda programar. |
C:\Program Files\Blender Foundation\). Si el script da error, pedidle que lea la salida de Blender y lo corrija.El mismo método para tu propia app
Repetid el proceso con una idea vuestra. Empezad siempre por un brief, un AGENTS.md y una lista de comprobaciones, y construid por etapas.
Quiero crear una app de escritorio para [tu idea]. Hazme las preguntas necesarias y, con mis respuestas, crea un brief.md con objetivo, usuarios, funciones, aspecto, fuera de alcance y cómo comprobarlo; un AGENTS.md con normas de trabajo como las de este curso; y un proves.md con las comprobaciones por etapa. Después propón el plan en doce etapas, de la carpeta a la publicación. No escribas código todavía.
Antes de apuntarte
¿Necesito saber programar?
No. Necesitáis manejar carpetas y un navegador. Codex escribe el código; vosotros decidís, aprobáis y comprobáis.
¿Qué app elijo?
La que os resulte útil. Si dudáis, Focus Studio: es la que se demuestra en pantalla. Todas tienen la misma dificultad.
¿Qué cuenta necesito?
Funciona con el plan gratuito de ChatGPT (GPT-6 Luna). Con Plus tendréis GPT-6.1 Sol y más margen de uso. Computer Use depende de la región y de la cuenta.
¿Y si tengo Mac?
Todo funciona igual. En la etapa 9 obtendréis un instalador para macOS; el de Windows se genera en un PC con Windows.
¿Necesito permisos de administrador?
No para instalar vuestra app. Para instalar Codex, Git, Node.js o Blender en un ordenador de empresa puede que sí: revisadlo antes con informática.
¿Qué pasa si me quedo atrás?
Cada etapa empieza desde la anterior y el commit de la etapa 6 permite retomar la sesión 2 desde un punto seguro.
Libros para trabajar con IA
Guías prácticas escritas a partir de mis cursos, con los mismos casos y prácticas paso a paso. Los publicados están en Amazon, en Kindle y en tapa blanda. Los que aún no han salido enlazan al temario del curso.
Serie Claude · Nivel 1Trabaja con Claude
Disponible en AmazonVer en Amazon →
Serie Claude · Nivel 2Construye con Claude
Próximamente en AmazonVer el curso →
Serie Claude · Nivel 3Agentes con Claude
Próximamente
Serie Claude · VideojuegosVideojuegos con Claude
Próximamente en AmazonVer el curso →
Serie Codex · Nivel 1Trabaja con ChatGPT y Codex
Próximamente en AmazonVer el curso →
Serie Codex · Nivel 2Codex avanzado
Disponible en AmazonVer en Amazon →
Dirección