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

# Apariencia

> Tema, tokens y estilos por parte para todos los elementos.

> [!NOTE]
>
> Esta página documenta `@whop/elements@1.10.0` y `@whop/elements-react@1.10.0`.

Un único objeto `appearance` aplica estilo a todos los elementos. Pásalo globalmente en la construcción, por grupo en `create()` (o como props de React), y cámbialo en vivo en cualquier momento con `update({ appearance })`. Los elementos montados cambian de estilo sin volver a montarse.

```ts theme={null}
const payments = whop.payments.create({
  appearance: {
    theme: { appearance: 'dark', accentColor: 'blue' },
    variables: { '--radius': '8px' },
    classes: { /* per-part declarations, see below */ }
  }
});
```

## Tema

Los tokens de diseño de alto nivel. Todos los campos son opcionales y están totalmente tipados. Los valores siguientes se enumeran a partir de los tipos del código fuente:

**appearance** `"light" | "dark"`

El esquema de color que se usa. - `"light"` - Modo claro con texto oscuro sobre fondos claros - `"dark"` - Modo oscuro con texto claro sobre fondos oscuros

**accentColor** `AccentColor`

El color de acento principal que se usa en los elementos interactivos. Uno de `ruby`, `blue`, `red`, `yellow`, `green`, `gray`, `tomato`, `crimson`, `pink`, `plum`, `purple`, `violet`, `iris`, `cyan`, `teal`, `jade`, `grass`, `brown`, `orange`, `indigo`, `sky`, `mint`, `amber`, `lime`, `lemon`, `magenta`, `gold`, `bronze`.

**grayColor** `string`

La paleta de grises que se usa en los elementos neutros. Usa `"auto"` para que coincida automáticamente con el color de acento.

Uno de `"gray"`, `"mauve"`, `"slate"`, `"sage"`, `"olive"`, `"sand"` o `"auto"`.

**dangerColor** `"ruby" | "red" | "tomato"`

El color que se usa en los estados de error y las acciones destructivas.

**warningColor** `"yellow" | "amber"`

El color que se usa en los estados de advertencia.

**successColor** `"green" | "teal" | "jade" | "grass"`

El color que se usa en los estados de éxito.

**infoColor** `"sky" | "blue"`

El color que se usa en los estados informativos.

## Variables

Propiedades personalizadas de CSS (variables) que se pueden usar para personalizar los estilos de los elementos. Las claves deben empezar con el prefijo `--`.

```ts theme={null}
appearance: { variables: { "--radius": "8px" } }
```

## Clases

Declaraciones de estilo para cada nombre de clase `whop-*`. Cada entrada cambia el estilo de una parte documentada de un elemento. Consulta la sección Estilos de la página de cada elemento para ver su lista de clases. El framework comprueba cada declaración y después inyecta el resultado saneado dentro del frame del elemento, porque las hojas de estilo de la página no pueden llegar a él.

Un objeto de declaraciones de estilo que asigna valores a propiedades CSS, como `CSSProperties` de React. Los nombres de las propiedades pueden usar camel case (`fontWeight`) o kebab case (`font-weight`). El framework normaliza cada nombre y lo compara con la lista de propiedades seguras antes de aplicarlo.

```ts theme={null}
appearance: {
  classes: {
    "whop-SomePart": { borderRadius: "8px", fontWeight: "600" },
  },
}
```

Encuentra la lista de partes de cada elemento en la sección **Estilos** de su página.

Un único objeto `appearance` aplica estilo a todos los elementos. Pásalo en `<WhopElements>` y se aplica a todo lo que hay debajo, o por grupo en `<Payments>`. Cámbialo en cualquier momento y los elementos montados cambian de estilo sin volver a montarse.

```tsx theme={null}
<WhopElements
  appearance={{
    theme: { appearance: 'dark', accentColor: 'blue' },
    tokens: { radius: 10, spacing: 4 },
    parts: { 'whop-Input': { borderWidth: 1 } },
  }}
>
```

## Tema

Idéntico al objeto web, campo por campo, así que un tema escrito para tu sitio web tiene los mismos tipos y se comporta igual aquí:

```tsx theme={null}
theme: {
  appearance: 'light' | 'dark',
  accentColor: 'blue',   // any Radix accent scale
  grayColor: 'auto',
  dangerColor: 'ruby' | 'red' | 'tomato',
  warningColor: 'yellow' | 'amber',
  successColor: 'green' | 'teal' | 'jade' | 'grass',
  infoColor: 'sky' | 'blue',
}
```

Si omites `appearance`, se sigue el ajuste claro u oscuro del dispositivo. `grayColor: 'auto'` elige la escala de grises que combina con tu color de acento.

## Tokens

Las `variables` de la web son propiedades personalizadas de CSS, que no tienen equivalente en React Native. `tokens` es el sustituto cerrado y tipado, y sus valores son **números en lugar de cadenas**, porque aquí no hay unidades:

```tsx theme={null}
tokens: {
  radius: 8,           // corner radius
  spacing: 4,          // the base unit gaps and padding multiply
  fontSize: 15,        // input and value text
  labelFontSize: 13,
  borderWidth: 1,
  controlHeight: 44,
  fontFamily: 'Inter', // undefined uses the platform font
}
```

Todas las claves son opcionales y se combinan sobre los valores predeterminados.

## Partes

Las `classes` de la web son declaraciones CSS indexadas por nombre de parte `whop-*`. `parts` mantiene **los mismos nombres de parte**, así que un único vocabulario de estilos cubre ambas superficies, y sustituye el CSS por objetos de estilo de React Native:

```tsx theme={null}
parts: {
  'whop-Input': { borderWidth: 1.5, borderRadius: 12 },
  'whop-MethodTileSelected': { borderColor: '#5B5BD6' },
  'whop-Label': { fontWeight: '600' },
}
```

Anulaciones planas por parte que se aplican después del tema. No hay cascada, ni pseudoclases ni combinadores, así que un estado al que una hoja de estilo llegaría con `:focus` tiene en su lugar su propia parte (`whop-InputFocused`, `whop-InputInvalid`).

Encuentra la lista de partes de cada elemento en la sección **Estilos** de su página.

> [!NOTE]
>
> Aquí `variables` y `classes` tienen el tipo `never` en lugar de ignorarse, así que un objeto de apariencia copiado de la web no compila en las dos claves que no se pueden trasladar, en lugar de no hacer nada sin avisar.

Para leer el tema tú mismo: `useTheme()` devuelve las escalas y los tokens resueltos, que es como haces que tu propia interfaz circundante coincida con los elementos. Consulta [Primeros pasos](https://docs.whop.com/es/elements/latest/getting-started.md).
