Plantillas de app y remixes

Disponibilidad

El flujo de manifiesto de plantilla y registro de app está implementado. Puede listar manifiestos curados por el operador, crear un registro de app nuevo desde uno, sembrar valores de entorno no secretos cuando el almacén de entorno está configurado y crear un registro remix limpio desde una app elegible.

La instanciación no despliega la app. Las bases de datos, buckets y servicios de autenticación declarados no se aprovisionan automáticamente. Algunos servicios declarados son ellos mismos solo stub, así que una declaración en manifiesto no es evidencia de que exista una dependencia.

Explorar manifiestos

GET /api/apps/templates?category=web&q=next
GET /api/apps/templates/{template_id}

La galería es lectura pública. Un manifiesto describe URL Git fuente, rama, valores runtime por defecto, esquema de variables de entorno y servicios declarados. Revisa repositorio, revisión actual, licencia, estado de mantenimiento y comandos runtime antes de instanciar. Un manifiesto es metadatos del operador, no un respaldo de seguridad.

Dos manifiestos seed integrados evitan que la API esté vacía. Sus repositorios externos pueden cambiar o desaparecer, y aún no hay prueba de humo automatizada para cada seed.

Instanciar

POST /api/apps/templates/{template_id}/instantiate
Content-Type: application/json
 
{
  "name": "My app",
  "env": {
    "NEXT_PUBLIC_APP_NAME": "My app"
  }
}

La llamada crea un registro de app privado y devuelve su app_id, información de fuente, tipo runtime y servicios declarados. Solo se aceptan claves declaradas por el manifiesto. Los campos secretos no se siembran con esta llamada.

Tras instanciar:

1. inspecciona la fuente y ajustes runtime de la app nueva;
2. suministra secretos mediante Variables de entorno de app;
3. proporciona dependencias externas reales tú mismo salvo que un servicio reporte explícitamente listo;
4. llama al endpoint de despliegue; y
5. sigue el despliegue por compilación, health check y activación.

Remix

POST /api/apps/{source_app_id}/remix
Content-Type: application/json
 
{
  "name": "My private remix"
}

Los propietarios pueden hacer remix de su propia app. Otro usuario puede remix solo una app pública y marcada como remixable. La app nueva es privada.

El remix lleva URL fuente, rama, tipo de despliegue, puerto y linaje. No copia valores de entorno, secretos, referencias de base de datos o bucket, bindings de autenticación, checkpoints, estado IDE ni datos. Tampoco bifurca ni fija el repositorio Git remoto. Si el propietario fuente cambia o elimina ese repositorio después, un nuevo despliegue puede diferir o fallar.

Para un remix durable, bifurca la fuente en un repositorio que controles, revisa y fija una revisión, actualiza la fuente de la app nueva y luego despliega.

Lista de publicación para una plantilla

Antes de presentar una plantilla como utilizable:

• confirma repositorio y licencia;
• fija o registra una revisión probada;
• valida install, build, run, puerto y comportamiento de salud;
• prueba campos de entorno requeridos sin exponer secretos;
• verifica que todo servicio declarado esté realmente disponible; e
• instancia, despliega, prueba de humo y elimina en un entorno limpio.