Skip to main content
Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la documentación para desarrolladores.

​
base44 scaffold

Genera la estructura de un proyecto local para una app de Base44 existente. Úsalo cuando ya tienes una app de Base44 (conoces su app ID) y quieres configurar los archivos del proyecto local para trabajar con ella. Se ejecuta totalmente sin interacción, por lo que es seguro para agentes y CI.
EscenarioComando
Empezar de cero, quieres una NUEVA app de Base44 + proyecto desde una plantillanpx base44 create
Ya tienes una app de Base44 (por ID) y quieres archivos locales para ellanpx base44 scaffold
Tienes un base44/config.jsonc local pero no .app.jsoncnpx base44 link

​
Sintaxis

npx base44 scaffold [name] [options]
Genera la estructura en el directorio actual.

​
Argumentos y opciones

Argumento/OpciónDescripciónRequerido
nameNombre del proyecto (posicional). Por defecto es el nombre del directorio actual.No
--app-id <id>ID de app de Base44 existente. Recurre a la variable de entorno BASE44_APP_ID.Sí*
--no-skillsOmite la instalación de habilidades de agente de IA (las habilidades se instalan por defecto)No
*El app ID es requerido: proporciónalo mediante --app-id o la variable de entorno BASE44_APP_ID. Si ninguno está establecido, el comando falla.

​
Ejemplos

# Generar la estructura del directorio actual para una app existente
npx base44 scaffold --app-id app_123

# Generar la estructura del directorio actual con un nombre de proyecto explícito
npx base44 scaffold my-app --app-id app_123

# Proporcionar el app ID mediante variable de entorno en lugar de la bandera
BASE44_APP_ID=app_123 npx base44 scaffold

# Generar la estructura sin instalar habilidades de agente de IA
npx base44 scaffold --app-id app_123 --no-skills

​
Lo que hace

  1. Resuelve el app ID desde --app-id o la variable de entorno BASE44_APP_ID
  2. Aplica la plantilla backend-only al directorio actual
  3. Registra los archivos del proyecto contra la app existente y escribe base44/.app.jsonc con el app ID
  4. Instala habilidades de agente de IA (a menos que se pase --no-skills)

​
Traspaso de aprovisionamiento (proyectos Stripe / projects.dev)

scaffold es el comando a ejecutar después de que una app de Base44 se aprovisione a través de un flujo Stripe Projects / projects.dev. Usa scaffold, no create — la app ya existe, por lo que create crearía un duplicado. Cuando Base44 se aprovisiona de esa manera, las credenciales se inyectan en el entorno bajo un prefijo BASE44_PROJECTS_ (por ejemplo, BASE44_PROJECTS_BASE44_APP_ID, BASE44_PROJECTS_BASE44_ACCESS_TOKEN, BASE44_PROJECTS_BASE44_REFRESH_TOKEN). La CLI las normaliza automáticamente a los nombres simples que usa (BASE44_APP_ID, BASE44_ACCESS_TOKEN, …). Como resultado:
  • App ID se resuelve desde BASE44_APP_ID automáticamente — no se necesita la bandera --app-id.
  • Autenticación se inicia desde BASE44_ACCESS_TOKEN / BASE44_REFRESH_TOKEN — no se necesita npx base44 login interactivo.
Por lo que todo el paso posterior al aprovisionamiento es simplemente: 
npx base44 scaffold
Ejecútalo desde el directorio donde quieres los archivos del proyecto. Después de generar la estructura, envía los recursos con npx base44 deploy.

​
Notas

  • Plantilla: Siempre usa la plantilla backend-only (solo configuración de Base44 — no se genera frontend).
  • No interactivo: Nunca pregunta. No envía entidades ni despliega el sitio. Usa npx base44 deploy después para enviar recursos.
  • Solo app existente: A diferencia de create, esto no crea una nueva app de Base44 — vincula los archivos locales al app ID que proporcionas.
  • Autenticación: Requiere que estés autenticado (ejecuta npx base44 login primero).
  • El archivo .app.jsonc debería estar ignorado por git (contiene tu app ID).
Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.