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

# Apparence

> Thème, tokens et style par partie pour chaque élément.

> [!NOTE]
>
> Cette page documente `@whop/elements@1.10.0` et `@whop/elements-react@1.10.0`.

Un seul objet `appearance` stylise chaque élément. Transmettez-le globalement à la construction, par groupe lors de `create()` (ou en tant que props React), et modifiez-le en direct à tout moment avec `update({ appearance })`. Les éléments montés changent de style sur place.

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

## Thème

Les tokens de design de haut niveau. Chaque champ est facultatif et entièrement typé. Les valeurs ci-dessous sont énumérées à partir des types sources :

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

Le schéma de couleurs à utiliser. - `"light"` - Mode clair avec du texte sombre sur fond clair - `"dark"` - Mode sombre avec du texte clair sur fond sombre

**accentColor** `AccentColor`

La couleur d'accent principale utilisée pour les éléments interactifs. L'une des valeurs `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 palette de gris à utiliser pour les éléments neutres. Utilisez `"auto"` pour l'accorder automatiquement à la couleur d'accent.

L'une des valeurs `"gray"`, `"mauve"`, `"slate"`, `"sage"`, `"olive"`, `"sand"` ou `"auto"`.

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

La couleur utilisée pour les états d'erreur et les actions destructrices.

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

La couleur utilisée pour les états d'avertissement.

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

La couleur utilisée pour les états de réussite.

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

La couleur utilisée pour les états informatifs.

## Variables

Propriétés personnalisées CSS (variables) permettant de personnaliser le style des éléments. Les clés doivent commencer par le préfixe `--`.

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

## Classes

Déclarations de style pour chaque nom de classe `whop-*`. Chaque entrée modifie le style d'une partie documentée d'un élément. Consultez la section Style de chaque page d'élément pour sa liste de classes. Le framework vérifie chaque déclaration, puis injecte le résultat assaini dans le frame de l'élément, car les feuilles de style de la page ne peuvent pas l'atteindre.

Un objet de déclaration de style qui associe des propriétés CSS à des valeurs, comme le `CSSProperties` de React. Les noms de propriétés peuvent utiliser le camel case (`fontWeight`) ou le kebab case (`font-weight`). Le framework normalise chaque nom et le vérifie par rapport à la liste des propriétés sûres avant de l'appliquer.

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

Retrouvez la liste des parties de chaque élément dans la section **Style** de sa page.

Un seul objet `appearance` stylise chaque élément. Transmettez-le à `<WhopElements>` pour qu'il s'applique à tout ce qui se trouve en dessous, ou par groupe sur `<Payments>`. Modifiez-le à tout moment et les éléments montés changent de style sur place.

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

## Thème

Identique à l'objet web, champ pour champ : un thème écrit pour votre site web est typé et se comporte de la même façon ici :

```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 `appearance` est omis, le réglage clair ou sombre de l'appareil est suivi. `grayColor: 'auto'` choisit l'échelle de gris assortie à votre accent.

## Tokens

Les `variables` du web sont des propriétés personnalisées CSS, qui n'ont pas d'équivalent dans React Native. `tokens` est leur remplaçant fermé et typé, et ses valeurs sont des **nombres plutôt que des chaînes**, car il n'y a pas d'unités ici :

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

Chaque clé est facultative et se fusionne avec les valeurs par défaut.

## Parties

Les `classes` du web sont des déclarations CSS indexées par nom de partie `whop-*`. `parts` conserve **les mêmes noms de parties**, de sorte qu'un seul vocabulaire de style couvre les deux surfaces, et remplace le CSS par des objets de style React Native :

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

Des surcharges à plat par partie, appliquées après le thème. Il n'y a ni cascade, ni pseudo-classes, ni combinateurs : un état qu'une feuille de style atteindrait avec `:focus` dispose donc de sa propre partie (`whop-InputFocused`, `whop-InputInvalid`).

Retrouvez la liste des parties de chaque élément dans la section **Style** de sa page.

> [!NOTE]
>
> `variables` et `classes` sont typés `never` ici plutôt qu'ignorés : un objet appearance copié depuis le web échoue donc à la compilation sur les deux clés non transposables, au lieu de ne rien faire silencieusement.

Lire le thème vous-même : `useTheme()` renvoie les échelles et tokens résolus, ce qui vous permet d'accorder votre propre interface environnante aux éléments. Consultez [Premiers pas](https://docs.whop.com/fr/elements/latest/getting-started.md).


## Related topics

- [Frosted UI](https://docs.whop.com/fr/developer/guides/frosted_ui.md)
- [Thème et style du chat intégré](https://docs.whop.com/fr/developer/guides/chat/theming-and-styles.md)
- [Référence des types d'Element Sessions](https://docs.whop.com/fr/sdk/elements/types.md)
