Primeros pasos con VillApps

Primeros pasos

De la instalación a tu primera pantalla útil, platicando. Sin programar y sin instalar nada más.

Atajo

Déjaselo a tu IA — tú solo haces tres cosas

Necesitas la suscripción de la IA que ya uses, con su herramienta de agente instalada (Claude Code, OpenAI Codex, Gemini CLI, GitHub Copilot CLI o VS Code; el paso 3 trae la lista completa). Copia esta instrucción y pégala ahí: tu IA hace todo y tú solo instalas lo que te indique, creas tu Cuenta VillApps —la contraseña la eliges tú; a tu correo solo llega un código de 6 dígitos (si no llega, revisa el correo no deseado)— y apruebas lo que únicamente tú puedes aprobar.

Lee https://villapps.com/primeros-pasos/ia.md y déjame VillApps funcionando: instálalo, conéctate, explícame cómo puedo aprovechar VillApps en mi negocio y ayúdame a construir mi primera pantalla. Haz tú todo lo que puedas; pídeme solo lo que únicamente yo pueda hacer.
ia.md · villapps.com

¿Quieres ver el detalle de lo que hará — o prefieres hacerlo tú mismo? Al abrir VillApps te recibe un solo hilo de cuatro pasos numerados, con palomita en lo que ya quedó y retomable si cierras la app a medias: son estos, después de instalar.

1

Instala VillApps

Descárgalo desde la página de descarga (Mac o Windows); ahí vienen los pasos de instalación. La base de datos ya viene incluida. Adelanto del paso 3: la IA es tuya — su cuenta y su plan los contratas con su proveedor, no con VillApps — y necesitas su herramienta de agente instalada. ¿Cuánto cuesta una IA?

2

Paso ① del hilo: crea tu cuenta VillApps

Abre VillApps: el paso ① del hilo es tu Cuenta VillApps. Pones tu correo, eliges tu contraseña ahí mismo y a tu correo llega solo un código de 6 dígitos para activarla (vence en 15 minutos; si no llega, revisa el correo no deseado). Señal de que quedó: el ① aparece palomeado con tu correo y tu prueba gratis, y el hilo pasa solo al ②.

Crear tu cuenta no pide tarjeta: pruebas todo gratis 30 días (después, MX$100 + IVA al mes en México o $6 USD fuera).

3

Paso ② del hilo: conecta tu IA

Necesitas tu propia suscripción de IA, con su herramienta de agente instalada en tu computadora. VillApps no te vende la IA ni te la instala: usas la que ya pagas.

El paso ② del hilo (y la portada de cada proyecto, para quien ya tiene apps) trae la conexión: eliges tu IA, pulsas Conectar y la app la registra sola — sin Terminal y sin copiar tokens. Después pulsas Comprobar: cuando tu IA de verdad habla con la app, el ② queda palomeado con la fecha de ese momento y el hilo pasa al ③. Si algo falta, te dice qué.

Si tu IA no está en la computadora, o prefieres hacerlo a mano, la misma tarjeta te da su configuración ya rellena con tus datos y la fuente oficial de donde salió. Al terminar, cierra y vuelve a abrir tu IA para que cargue las herramientas.

Tu IADónde queda su configuraciónEstado
Claude Code~/.claude.jsonBotón en la app · probada
OpenAI Codex~/.codex/config.tomlBotón en la app · probada
Gemini CLI~/.gemini/settings.jsonBotón en la app · probada · pide /trust en tu carpeta
GitHub Copilot CLI~/.copilot/mcp-config.jsonBotón en la app · probada · te pide permiso en cada uso
Visual Studio Codemcp.json de tu perfilBotón en la app · probada · se desconecta desde VS Code
Cursor~/.cursor/mcp.jsonConfiguración documentada, no probada por nosotros
Grok Build~/.grok/config.tomlConfiguración documentada, no probada por nosotros

Dos avisos honestos: Gemini CLI y VS Code guardan ese archivo con permisos que otros usuarios de la misma computadora pueden leer — es decisión de ellos, no nuestra. Y la configuración de Cursor y Grok Build sale de su documentación oficial, pero no la hemos probado aquí: si te falla, escríbenos y lo revisamos.

4

Paso ③ del hilo: ¿para qué la usarías?

El paso ③ del hilo es una sola pregunta, contestada en tus palabras («llevar las órdenes de reparación de mi taller y cobrarlas»). Con eso la app pasa al ④ y te entrega ya escrita la instrucción para pegarle a tu IA —con tu propósito dentro—, junto al nombre del primer proyecto por si prefieres crearlo tú. Pégasela a tu IA y pídele lo que necesitas:

«Crea un proyecto VillApps para mi negocio y hazme un control de cobranza.»
«Tengo un Excel de ventas: hazme un reporte mensual por cliente.» (tu IA te dirá dónde dejar el archivo)

Tu IA crea el proyecto, construye, y las pantallas aparecen solas dentro de ese proyecto en VillApps. Si prefieres crear tú el proyecto con «Crear el proyecto yo mismo», dile a tu IA que trabaje en ese — una sola de las dos vías, para no acabar con proyectos duplicados. Revisa que las pantallas hagan lo que pediste y pídele ajustes hasta que quede. Después podrás pedirle personas y permisos, compartir la app con tu equipo o pasarla a producción — todo platicando.

5

Paso ④ del hilo: tu IA construye

Con la instrucción pegada, el hilo se queda en el ④ mientras tu IA trabaja y palomea solo tres hechos, sin que toques nada: tu IA habló con esta app, creó tu primer proyecto e instaló la primera pantalla. Deja VillApps abierta mientras tanto: tu IA habla con la app, y cerrada no la encuentra. Si tu IA no se conecta, el mismo paso te manda de vuelta al ②.

Cuando el proyecto existe, la portada dice «Listo: tu IA creó ⟨tu proyecto⟩», con el botón para abrirlo y tres peticiones para seguir (agregar una pantalla, cargar datos, compartir con tu equipo). Abrirlo termina el arranque: desde ahí, VillApps es la de siempre.

¿Tu red necesita un buzón?

Entre contactos de tu red los mensajes, archivos y solicitudes entre IAs viajan cerrados, directo de una computadora a otra. Si el destinatario no está, el mensaje espera «enviando» hasta que los dos coincidan en línea. Una computadora dedicada y siempre encendida como buzón de la red lo resuelve: guarda el sobre cerrado y lo entrega sola cuando el otro entra; nadie tiene que coincidir y el buzón nunca lee lo que custodia.

Para ponerlo: en esa computadora, con tu cuenta VillApps y sin abrir ningún proyecto, entra a «Cuenta VillApps» y en la tarjeta «Buzón de la red» pulsa «Activar en esta máquina». Arrancará con el sistema aunque nadie inicie sesión. Tu IA también puede hacerlo desde esa máquina con la herramienta `buzon_red`. Un buzón por cuenta; tus contactos ven en Mensajes que su red ya tiene buzón.

¿Te invitaron a una app?

Si alguien de tu equipo ya usa VillApps y te compartió una app, no necesitas IA propia, solo tu propia cuenta VillApps: instala VillApps (paso 1), crea tu cuenta o entra con ella, y en su pantalla de inicio abre «¿Te invitaron a una app?»: «Conectar a una app de mi red» con la dirección y la clave que te dieron, o «Conectar a una app por internet» con el código de contacto del dueño. Entras con tu cuenta y ves lo que tu grupo permite. En el teléfono, la app móvil crea tu cuenta ahí mismo.

¿Te atoraste en algún paso? Escríbenos a cuentas@villapps.com.