> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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...

<Warning>
  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](/developers).
</Warning>

# 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.

## Crítico: cuándo usar scaffold vs create vs link

| Escenario                                                                       | Comando               |
| ------------------------------------------------------------------------------- | --------------------- |
| Empezar de cero, quieres una NUEVA app de Base44 + proyecto desde una plantilla | `npx base44 create`   |
| Ya tienes una app de Base44 (por ID) y quieres archivos locales para ella       | `npx base44 scaffold` |
| Tienes un `base44/config.jsonc` local pero no `.app.jsonc`                      | `npx base44 link`     |

## Sintaxis

```bash theme={null}
npx base44 scaffold [name] [options]
```

Genera la estructura en el **directorio actual**.

## Argumentos y opciones

| Argumento/Opción | Descripción                                                                                   | Requerido |
| ---------------- | --------------------------------------------------------------------------------------------- | --------- |
| `name`           | Nombre 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-skills`    | Omite 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

```bash theme={null}
# 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:

```bash theme={null}
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).

<Note>Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/).</Note>