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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Crea un sitio web con la CLI

> Genera una app de Vite, ejecútala en local con datos reales de Whop e impleméntala en una dirección whop.site o en tu propio dominio.

Cuatro comandos te llevan de un directorio vacío a un sitio activo en su dominio.

> [!NOTE]
>
> Instala la [CLI de Whop](https://docs.whop.com/es/developer/cli.md) y ejecuta `whop` una vez para iniciar sesión y seleccionar un negocio.

**1. Crea la app**

```bash theme={null}
whop apps init --app_type website --name "Shine Time" --domain shine-time
```

Reclama el dominio, registra la app en él, genera la estructura del proyecto en `./shine-time` y escribe un `whop.app.json` que vincula el directorio a la app. Omite las opciones para que se te pidan de forma interactiva.

`--domain` acepta un nombre de whop.site (`shine-time` → `shine-time.whop.site`) o tu propio dominio, como `shinetime.com`:

* Un dominio que ya está en tu negocio se usa tal cual.
* Un dominio que nadie ha registrado se compra a través de Whop. La CLI devuelve un enlace de compra y no se cobra nada hasta que pagues ahí.
* Un dominio que tienes en otro proveedor se conecta: publica los registros DNS que indica la CLI.

Hasta que pagues o publiques esos registros, el sitio queda a la espera de ese dominio. `whop domains get shinetime.com` muestra su estado.

> [!WARNING]
>
> `--app_type` es permanente. `website` significa que los visitantes lo navegan en su dominio. `b2c_app` significa que los creadores lo instalan en su whop.

**2. Ejecútalo en local**

```bash theme={null}
cd shine-time
whop apps dev
```

Inicia tu script `dev` con el entorno que le daría el runtime alojado: `WHOP_APP_ID`, un token de corta duración como `WHOP_API_KEY` y todos los [secretos de la app](https://docs.whop.com/es/developer/websites/hosting.md#secrets) almacenados. Las llamadas al SDK del lado del servidor funcionan sin configuración. Todo lo que exportes tú mismo tiene prioridad, y al reiniciar se renueva el token.

**3. Implementa**

```bash theme={null}
whop apps deploy
```

Compila, comprueba los tipos, sube la compilación y un archivo del código fuente, y la promueve. Tu sitio está activo cuando termina.

```bash theme={null}
whop apps deploy --preview                  # upload without going live
whop apps builds promote abld_xxxxxxxx      # ship it later, or roll back to it
```

**4. Supervisa su ejecución**

```bash theme={null}
whop apps logs app_xxxxxxxx --level error
```

Registros del runtime del servidor, conservados durante 7 días. Consulta [Alojamiento](https://docs.whop.com/es/developer/websites/hosting.md#logs).

## Qué te da la estructura generada

`whop apps init` genera un proyecto de React con el propio comando de creación de TanStack y después aplica la integración con Whop:

| Cambio | Motivo |
| - | - |
| Plugin `whop()` de `@whop/cli/vite` | Empaqueta `dist/` en el archivo que sube `whop apps deploy` |
| `@whop/cli` como dependencia de desarrollo | La configuración de Vite importa el plugin desde ahí |
| Scripts `deploy` y `typecheck` | Lo que ejecuta `whop apps deploy` |
| Configuración de compilación con el nombre de tu ruta | Mantiene el proyecto alineado con la app |
| `whop.app.json` | Vincula el directorio a la app |

## Usa tu propio framework

El plugin no depende de ningún framework: TanStack Start, Nitro, Hono o SSR simple funcionan. El único requisito es la estructura de la compilación: los recursos estáticos en `dist/client` y el bundle del servidor en `dist/server`.

```typescript vite.config.ts theme={null}
import { defineConfig } from "vite";
import { whop } from "@whop/cli/vite";

export default defineConfig({
  plugins: [whop()],
});
```

```bash theme={null}
whop apps deploy --app app_xxxxxxxx
```

`--app` vincula el directorio actual a una app existente antes de implementar, sustituyendo cualquier vínculo de `whop.app.json`.

## Trabaja en un sitio desde otra máquina

```bash theme={null}
whop apps pull --app app_xxxxxxxx
```

En una máquina nueva, esto crea `./<app name>` a partir del archivo del código fuente de la compilación de producción. Dentro de un proyecto existente, fusiona a tres bandas el código fuente implementado con tu código local mediante git. Pasa `--build abld_xxxxxxxx` para una compilación concreta, o `--overwrite` para omitir la fusión.

## Próximos pasos

> [card] [Cómo funciona el alojamiento](https://docs.whop.com/es/developer/websites/hosting.md)
>
> Secretos, reversiones, registros y la clave de API inyectada.

> [card] [Haz seguimiento de los visitantes](https://docs.whop.com/es/developer/websites/tracking.md)
>
> El píxel ya está instalado: añade tus propios eventos.

> [card] [Blueprints](https://docs.whop.com/es/developer/websites/blueprints.md)
>
> Empieza a partir de un negocio que funciona en lugar de un proyecto vacío.

> [card] [Referencia de la CLI](https://docs.whop.com/es/developer/cli.md)
>
> Todos los comandos, además del uso no interactivo.


## Related topics

- [Aloja un sitio web en Whop](https://docs.whop.com/es/developer/websites/overview.md)
- [Implementa un negocio a partir de un blueprint](https://docs.whop.com/es/developer/websites/blueprints.md)
- [Crea un checkout con Payment Elements](https://docs.whop.com/es/developer/guides/payment-elements.md)
