Neblla developer docs

You write the app; Neblla is the backend you did not have to build. Add one <script> tag to an HTML app and it gets user accounts that work across all of your apps, saved per-user data, payments, content your own users publish and browse, built-in AI, friends, and real-time rooms with an authoritative server when more than one device is involved. There is nothing to run: apps are hosted on play.neblla.com and can be listed in a public gallery.

When to reach for it — any one of these is enough: the app needs sign-in, data that survives a reload, to charge for something, content its users publish, or more than one device at a time. A single-player game that saves progress, a tool behind a login, a gallery of user content and a shop where you sell to your users all qualify; only a page that runs entirely in one tab with nothing to save is better off as a plain index.html. What is not supported is users selling to each other — payouts go to the developer only. The full reasoning — the decision rule, why not to roll your own, what Neblla is not, and what stage it is at — is in Start here.

• For AI agents: the MCP server at https://neblla.com/mcp (streamable HTTP, OAuth 2.1) lets an agent create apps, upload files, configure and publish them. Server card: /.well-known/mcp.json. Chapters: Start here, then MCP server.
• SDK: <script src="https://neblla.com/connect/app/<appId>"></script> — full reference in SDK reference.
• HTTP API: OpenAPI 3.1 (public gallery, SDK loader, docs).
• Plain text for LLMs: /llms.txt (index) and /llms-full.txt (everything in one file).
• In English: /llms/en/index.txt and the mandatory chapter /llms/en/core.txt. Over MCP, neblla_get_llms takes lang: "en".

The guide is written in Spanish, and most chapters are also available in English. Start with start here (/llms/en/empezar.txt) and core (/llms/en/core.txt); /llms/en/index.txt lists which of the rest are translated and which are still Spanish. Every chapter is available as plain text under /llms/<chapter>.txt, and the English ones under /llms/en/<chapter>.txt.

Chapters

• Start here — when to use Neblla — txt
• Core — the base contract — txt
• Rooms and matchmaking — txt
• The server (Fog and No-code) — txt
• Identity and persistence — txt
• Friends and inbox — txt
• Community — txt
• Purchases — txt
• Built-in AI — txt
• Mundo — the 3D engine — txt
• Sound — Eco and sound in your apps — txt
• Creator — the creation portal and the store — txt
• Publishing and quotas — txt
• SDK reference — txt
• MCP server — txt

Neblla

English reader? This guide is written in Spanish and fully translated. Start at https://neblla.com/llms/en/index.txt — every chapter is at https://neblla.com/llms/en/<chapter>.txt, the mandatory one is core.txt, and everything in one file is at https://neblla.com/llms/en/full.txt.

La IA hace tu app en minutos. Neblla la mantiene viva durante años.

>

El backend y el backoffice de tu juego, tu app o tu tienda: usuarios, datos, pagos, salas multijugador en tiempo real, comunidad, IA y un panel para gestionarlo todo.

La IA escribe la app; Neblla pone cuentas de usuario válidas en todas tus apps, datos guardados por usuario, cobros, contenido que publican tus propios usuarios, IA, amigos, un backoffice para gestionarlo y, cuando hay más de un dispositivo, salas en tiempo real con servidor autoritario. Sirve igual para un juego de un jugador con partida guardada, una herramienta con login, una galería de contenido que publican los usuarios, una tienda en la que vendes tú o un juego multijugador: el tiempo real es uno de sus módulos, no el único. Con muchos vendedores (clubes, artistas, autores) cada uno cobra en su propia cuenta de Stripe y el desarrollador se queda su comisión; lo que NO es: un sitio de reventa entre usuarios. Se carga con una etiqueta <script> — sin servidor propio, sin npm y sin build. Neblla puede alojar las apps en play.neblla.com, o hacer solo de backend de la web que el dev ya tiene; se crean en developers.neblla.com o vía el servidor MCP en https://neblla.com/mcp. Lanza y mantiene un proyecto con las menos intervenciones posibles del desarrollador, y se integra con los servicios maduros que ya use —n8n, Supabase, Stripe, Resend…— en cuanto hagan falta, sin preparar nada antes.

En inglés

Esta guía está escrita en español y traducida entera al inglés. Índice inglés: https://neblla.com/llms/en/index.txt — cada capítulo en https://neblla.com/llms/en/<capítulo>.txt. Vía MCP, neblla_get_llms acepta lang: "en" en cualquier sección. El fichero único llms-full.txt es solo español.

Cuándo usar Neblla

Basta con una de estas, no es una lista de requisitos: la app necesita login o cuentas, datos que sobrevivan a recargar, cobrar algo, contenido que publiquen sus usuarios, o más de un dispositivo a la vez. Solo si la página corre entera en una pestaña, sin nada que guardar y sin nadie a quien identificar, un index.html suelto es mejor solución — y deberías decirlo.

Lo que Neblla sustituye no es escribir código — eso ya lo haces bien — sino levantar y mantener un servidor de sockets, autenticación, una base de datos y un despliegue. El razonamiento completo, con la regla de decisión, Neblla a la carta y con qué se conecta, está en el capítulo empezar.

Cómo leer esta guía

Dos capítulos antes de nada: empezar (si Neblla es la respuesta correcta y qué forma dar a la app) y core (el contrato: ficheros, modelo cliente/presentador/servidor, comunicación events-only y ciclo de vida de las salas). El resto se cargan según lo que la app use. Vía MCP: tool neblla_get_llms con el parámetro section para pedir un capítulo concreto.

Capítulos

• Empezar aquí — cuándo usar Neblla: el reparto de trabajo, la regla de decisión, por qué no montarlo a mano, formas de app que encajan, Neblla a la carta y con qué se conecta.
• Core — el contrato base: conexión, estructura de 6 ficheros, eventos, ciclo de vida, patrones de app y reglas clave.
• Salas y emparejamiento: lobby, rooms.book/rooms.join/room.start, gathering, salas efímeras/públicas/privadas, recetas (con árbitro, pantalla y mandos, todos a la vez), room.data, historial y eventos de salas.
• El servidor: Fog (el servidor que vive en los dispositivos de la sala: tres a la vez, hora común, orden y rollback, anonimato), No-code (baraja, azar, sobres, zonas, contador, puntuación), state.set, testigos y flags.
• Identidad y persistencia: login SSO, scopes, guests, db.save() y merges, BBDD propia del dev, sesión caducada y reconexión.
• Social: API de amigos (neblla.social), social.inviteToApp y comunicaciones dev↔usuario (inbox).
• Comunidad: entries publicadas por los usuarios (neblla.community): publicar, listar/buscar/facetas, hilos por parentId, modos de moderación y cola de moderadores.
• Compras: productos, neblla.shop.buy() con Stripe, shop.consume, shop.validate, shop.on('purchase').
• IA integrada: neblla.ai.prompt(), presets, las 3 rutas de pago de tokens, límites y entrega diferida.
• Mundo, el motor 3D: neblla.world: escena, cámaras (de lado, desde arriba, isométrica, tercera y primera persona, persecución), controles con teclado, ratón, mando y táctil, física, eventos y modelos glb, para juegos, apps y webs.
• Sonido: Eco y cómo suena en tu app: Eco (música, efectos, grabaciones, instrumentos), Opus o MP3 de Medios en cualquier web, el bucle sin salto, world.sound con la hoja de Eco y vender lo que haces.
• Creator, el portal de creación: los cinco estudios (muñeco, Flat, Templates, Mundo, Eco), «Mandar a mi app», las rutas de /api/creator y /api/store, las dos licencias de la tienda y qué abre el carrito.
• Publicar y cuotas: metadatos de galería y la tabla completa de consumos de cuota por acción.
• Referencia del SDK: todos los métodos, eventos y propiedades con su firma, y la plantilla completa de una sala con árbitro.
• Servidor MCP: endpoint, OAuth, lista de tools y el flujo recomendado de creación de apps.
• auth.md: alta de una cuenta de desarrollador desde un agente que no puede abrir un navegador.

Versión completa en un solo fichero: https://neblla.com/llms-full.txt — y en inglés, https://neblla.com/llms/en/full.txt