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.
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 crea ambos en su primer paso.
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.
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.txtCon 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
initva ensrc/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: 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.tsxosrc/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/browsery pega tú la llamadainit. - 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. - Pon la llave en las variables de entorno del proyecto en Vercel como
SYPNIA_PROJECT_KEY, como explica Next.js en 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/nextla lee de Vercel, así que las vistas previas reportan comopreviewy tu sitio real comoproduction.
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:
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 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.
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). 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.