# Apps hechas con Lovable, Bolt, v0 o Replit

> Agrega Sypnia a una app hecha con un constructor de apps con IA, con el prompt para darle al constructor, el código que debería producir y cómo revisar que lo hizo bien.

Aplica a: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/guides/lovable-bolt-v0-replit/

Esta guía es para quien construyó su app describiéndola. No necesitas leer código para seguirla. Funciona con Sypnia Cloud y con un motor con alojamiento propio; los ejemplos usan Sypnia Cloud, y cambia una línea para tu propio motor.

**Al final tendrás:** Sypnia vigilando la app que hizo tu constructor, de modo que cuando un botón deje de funcionar después de «un cambio pequeño», te lo digan en una frase, con un prompt que puedes pegar de vuelta en el constructor.

**Necesitas:** un proyecto en Sypnia y su llave de ingesta, que empieza por `spk_`. El [inicio rápido de Sypnia Cloud](https://docs.sypnia.com/es/start/quickstart-cloud) crea ambos en su primer paso.

> **En palabras simples**
>
> Le vas a pedir a tu constructor que agregue a tu app una pieza pequeña de código, el SDK. Desde entonces la app le cuenta a Sypnia lo que les pasa a las personas que la usan. La llave que pegas no es una contraseña: solo puede enviar, nunca leer, así que puede ir dentro de la app.

## El prompt

Pega esto en el chat de tu constructor, con tu propia llave en lugar de la del ejemplo. Está escrito para que el constructor no pueda equivocarse en lo importante. Va en inglés porque así lo entienden mejor estas herramientas.

```text
Add Sypnia monitoring to this app.

1. Install the npm package @sypnia/browser. (If this is a Next.js app, install
   @sypnia/next instead and follow https://docs.sypnia.com/sdks/nextjs.md.)
2. In the file where the app starts, before it renders, add:

   import { init } from '@sypnia/browser';

   init({
     project: 'spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e',
     environment: location.hostname === 'MY-REAL-DOMAIN.com' ? 'production' : 'development',
   });

   Replace MY-REAL-DOMAIN.com with the domain where my customers use the app.
3. Call init exactly once. Do not wrap it in a component or an effect.
4. Where the app knows who signed in, call
   identify({ person: { id: user.id } }) from '@sypnia/browser',
   and identify(null) on sign-out. Send the id only, no name or e-mail.
5. Do not add any other Sypnia call. Do not try to record what people type.
   The key above is public and belongs in the code; never add a key that starts with sps_.
6. Show me the files you changed.

Reference: https://docs.sypnia.com/llms.txt
```

Con un motor con alojamiento propio, agrega una línea a la llamada `init` del prompt: `endpoint: 'https://sypnia.example.com',` con la dirección de tu motor.

Por qué importa la línea `environment`: los constructores muestran tu app en una vista previa mientras trabajas. Sin esa línea, cada prueba que hagas en la vista previa contaría como un cliente real y te enviaría alertas.

## En tu constructor

Lo que sigue es lo que sabemos que es estable de cada herramienta: qué clase de app hace y dónde va el código. Los menús y los nombres de estas herramientas cambian seguido. Donde un paso depende de funciones propias de la herramienta, lo dice: revisa la documentación actual de la herramienta en vez de confiar en un nombre de menú escrito aquí.

**Lovable**

Lovable hace apps React construidas con Vite.

- **Dale el prompt de arriba.** La llamada `init` va en `src/main.tsx`, antes de la línea que pinta la app.
- **Si pregunta dónde guardar la llave:** en el código está bien. La llave de ingesta es pública.
- **Si tu app usa Supabase** (Lovable se conecta con él), lee también [Apps con Supabase](https://docs.sypnia.com/es/guides/supabase): una opción más registra las llamadas a tu base de datos.
- **Revisa el resultado** en la app publicada, no solo en la vista previa. Si puedes abrir y editar el código tú mismo, o sincronizarlo con GitHub, depende de tu plan: revisa la documentación actual de Lovable.

**Bolt**

Bolt hace varias clases de app; la mayoría son apps Vite con React, y también puede hacer apps Next.js.

- **Dale el prompt de arriba.** En una app Vite la llamada va en `src/main.tsx` o `src/main.ts`. En una app Next.js el constructor debe seguir la página de Next.js enlazada en el prompt.
- **También puedes hacerlo a mano:** Bolt muestra los archivos del proyecto y una terminal. Corre ahí `npm install @sypnia/browser` y pega tú la llamada `init`.
- **Revisa el resultado** en la app desplegada. Cómo despliega Bolt y dónde guarda las variables de entorno es función propia de Bolt: revisa su documentación actual.

**v0**

v0 hace apps Next.js y las despliega en Vercel.

- **Dale el prompt de arriba.** Como la app es Next.js, el paquete correcto es `@sypnia/next`, con tres archivos pequeños. El constructor debe seguir la página enlazada en el prompt; el resultado debe coincidir con [Next.js](https://docs.sypnia.com/es/sdks/nextjs).
- **Pon la llave en las variables de entorno del proyecto en Vercel** como `SYPNIA_PROJECT_KEY`, como explica [Next.js en Vercel](https://docs.sypnia.com/es/guides/nextjs-on-vercel). Dónde muestra v0 esos ajustes es función propia de v0: revisa su documentación actual.
- **No necesitas la línea `environment`:** `@sypnia/next` la lee de Vercel, así que las vistas previas reportan como `preview` y tu sitio real como `production`.

**Replit**

Replit corre cualquier clase de app, así que primero averigua cuál es la tuya: pregúntale al Replit Agent «is this a Vite app, a Next.js app, or something else, and does it have a Node server?».

- **Dale al Agent el prompt de arriba.** Para una app con servidor Node (Express es común), pide además: «Add @sypnia/node to the server following <https://docs.sypnia.com/sdks/node.md>, reading the key from the secret SYPNIA_PROJECT_KEY.»

- **Para una app de HTML simple sin paso de compilación,** sáltate el paquete y pega una línea antes de `</head>` en cada página:

  ```html
  <script async src="https://ingest.sypnia.com/v1/sdk.js" data-project="spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e"></script>
  ```

- **Secretos:** la llave de ingesta puede vivir en el código. Replit tiene un lugar para secretos; úsalo para las variables del servidor. Dónde está y cómo lo leen los despliegues es función propia de Replit: revisa su documentación actual.

## Revisa que el constructor lo hizo bien

No tienes que leer el código. Revisa tres cosas:

### 1. La app sigue funcionando

Abre la app publicada y úsala como lo haría un cliente.

**Deberías ver:**Todo se comporta como antes. Sypnia no muestra nada en tus páginas.

### 2. Sypnia lo recibe

En Sypnia, abre **Sesiones**. Elige el entorno `production` si usaste tu dominio real, `development` si usaste la vista previa.

**Deberías ver:**En menos de 10 minutos, tu propia visita, con las páginas que abriste y en qué hiciste clic.

### 3. Pídele al constructor que confirme

Pega: «List every place where Sypnia is called in this app, and confirm that init is called once and that no key starting with sps\_ is in the code.»

**Deberías ver:**Un `init`, máximo un `identify` y un `identify(null)`, y ninguna llave `sps_`.

Si no aparece ninguna sesión, las causas más comunes con constructores son un `init` puesto dentro de un componente (corre tarde o dos veces) y una dirección de vista previa que no coincide con la línea `environment`. [Solución de problemas](https://docs.sypnia.com/es/sdks/troubleshooting) tiene la lista completa.

## Cuando Sypnia reporta un problema

Esta es la parte que estas herramientas hacen fácil. Cada problema viene con un prompt escrito para un agente de código: qué pasa, dónde, por qué, qué cambiar y cómo revisarlo. Cópialo del problema y pégalo en el chat de tu constructor. Mira [El prompt](https://docs.sypnia.com/es/agent/the-prompt).

Dos límites, dichos con honestidad:

- **Nombres de archivo en los problemas.** Sypnia muestra el archivo y la línea de tu propio código solo si tu compilación sube sus source maps. Si puedes agregar un paso de compilación depende del constructor; con una app Next.js en Vercel son dos variables de entorno ([Next.js en Vercel](https://docs.sypnia.com/es/guides/nextjs-on-vercel)). Sin source maps el problema igual dice qué pasó, a quién y desde cuándo.
- **Los pull requests** **\[Nube]** necesitan tu código en GitHub y la GitHub App de Sypnia. Si tu constructor sincroniza con GitHub, funciona; si no, usa el prompt.
