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

> Crea un nuevo proyecto de Base44 desde una plantilla. Este comando es agnóstico al framework y puede generar un proyecto completo o añadir configuración de Base44 a un proyecto existente.

<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 create

Crea un nuevo proyecto de Base44 desde una plantilla. Este comando es agnóstico al framework y puede generar un proyecto completo o añadir configuración de Base44 a un proyecto existente.

## Crítico: se requiere modo no interactivo

Proporciona SIEMPRE tanto el nombre del proyecto COMO la bandera `--path`. Sin ambos, el comando abre un TUI interactivo que los agentes no pueden usar correctamente.

INCORRECTO: `npx base44 create`
INCORRECTO: `npx base44 create my-app`
CORRECTO: `npx base44 create my-app -p ./my-app`

## Sintaxis

```bash theme={null}
npx base44 create [name] --path <path> [options]
```

## Argumentos y opciones

| Argumento/Opción      | Descripción                                                                                 | Requerido |
| --------------------- | ------------------------------------------------------------------------------------------- | --------- |
| `name`                | Nombre del proyecto (argumento posicional)                                                  | Sí\*      |
| `-p, --path <path>`   | Ruta donde crear el proyecto                                                                | Sí\*      |
| `-t, --template <id>` | ID de plantilla (ver plantillas abajo)                                                      | No        |
| `--deploy`            | Compila y despliega el sitio (incluye enviar entidades)                                     | No        |
| `--no-skills`         | Omite la instalación de habilidades de agente de IA (las habilidades se añaden por defecto) | No        |

\*Requerido para modo no interactivo. Tanto `name` como `--path` deben proporcionarse juntos.

## Selección de plantilla (CRÍTICO - Elige apropiadamente)

**DEBES seleccionar la plantilla más apropiada según los requisitos del usuario:**

| ID de plantilla      | Cuándo usar                                                                                      | Escenarios de ejemplo                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| `backend-and-client` | Crear una NUEVA app web full-stack desde cero                                                    | "Crear una app de tareas", "Constrúyeme un panel", "Haz una app SaaS"       |
| `backend-only`       | Añadir Base44 a un proyecto EXISTENTE O usar un framework diferente (Next.js, Vue, Svelte, etc.) | "Añade Base44 a mi proyecto", "Quiero usar Next.js", "Ya tengo un frontend" |

**Elección predeterminada:** Cuando el usuario pide "crear una app" o "construir un proyecto" sin especificar un framework particular, usa `backend-and-client` para proporcionar una aplicación completa, lista para producción con Vite + React + Tailwind.

## La bandera `--path`

* **Para plantilla `backend-and-client` (nuevos proyectos):** Usa una ruta de subcarpeta nueva
  ```bash theme={null}
  npx base44 create my-app -p ./my-app -t backend-and-client
  ```
* **Para plantilla `backend-only` (proyectos existentes):** Usa `-p .` en el directorio actual
  ```bash theme={null}
  npx base44 create my-app -p .
  ```

## Flujo: Usar `backend-only` con frameworks externos

**CRÍTICO: La carpeta del proyecto DEBE existir ANTES de ejecutar `base44 create` con `backend-only`**

La plantilla `backend-only` solo añade archivos de configuración de Base44 - NO crea un frontend. Si necesitas un frontend con un framework específico:

```bash theme={null}
# Paso 1: Inicializa el proyecto frontend PRIMERO
npm create vite@latest my-app -- --template react  # o vue, svelte, etc.
# O: npx create-next-app@latest my-app
# O: cualquier otro comando de inicialización del framework

# Paso 2: Navega a la carpeta creada
cd my-app

# Paso 3: Instala Base44 CLI
npm install --save-dev base44

# Paso 4: Añade configuración de Base44
npx base44 create my-app -p .
```

**ADVERTENCIA:** NO:

* Crees una carpeta vacía manualmente, luego intentes ejecutar `npx create vite` dentro (fallará - la carpeta existe)
* Ejecutes `base44 create` con `backend-only` esperando que cree un frontend (no lo hará)

**SÍ:**

* Ejecuta primero el comando de inicialización del framework externo (crea su propia carpeta)
* Luego ejecuta `base44 create` dentro de esa carpeta con `-p .`

## Ejemplos

```bash theme={null}
# RECOMENDADO: Crear proyecto full-stack (para nuevas apps)
npx base44 create my-app -p ./my-app -t backend-and-client

# Crear full-stack y desplegar en un paso
npx base44 create my-app -p ./my-app -t backend-and-client --deploy

# Añadir Base44 a proyecto EXISTENTE (debe estar dentro de la carpeta del proyecto)
npx base44 create my-app -p .

# Añadir Base44 a proyecto existente y desplegar
npx base44 create my-app -p . --deploy

# Crear sin añadir habilidades de agente de IA
npx base44 create my-app -p . --no-skills
```

## Lo que hace

1. Aplica la plantilla seleccionada a la ruta de destino
2. Crea una carpeta `base44/` con archivos de configuración
3. Registra el proyecto con el backend de Base44
4. Crea `base44/.app.jsonc` con el app ID
5. Si se usa `--deploy`:
   * Envía cualquier entidad definida en `base44/entities/`
   * Ejecuta comandos de instalación y compilación (para plantillas con frontend)
   * Despliega el sitio en el alojamiento de Base44

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