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

# Créer un site web avec la CLI

> Générez une app Vite, exécutez-la en local avec de vraies données Whop, et déployez-la sur une adresse whop.site ou sur votre propre domaine.

Quatre commandes vous mènent d'un répertoire vide à un site en ligne sur son domaine.

> [!NOTE]
>
> Installez la [CLI Whop](https://docs.whop.com/fr/developer/cli.md) et exécutez `whop` une première fois pour vous connecter et sélectionner une entreprise.

**1. Créez l'app**

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

Réserve le domaine, y enregistre l'app, génère le projet dans `./shine-time` et écrit un fichier `whop.app.json` qui lie le répertoire à l'app. Omettez les options pour que les valeurs vous soient demandées.

`--domain` accepte un nom whop.site (`shine-time` → `shine-time.whop.site`) ou votre propre domaine, comme `shinetime.com` :

* Un domaine déjà associé à votre entreprise est utilisé tel quel.
* Un domaine que personne n'a enregistré est acheté via Whop. La CLI renvoie un lien d'achat, et rien n'est débité tant que vous n'y avez pas payé.
* Un domaine que vous possédez ailleurs est connecté : publiez les enregistrements DNS listés par la CLI.

Tant que vous n'avez pas payé ou publié ces enregistrements, le site attend ce domaine. `whop domains get shinetime.com` affiche son statut.

> [!WARNING]
>
> `--app_type` est définitif. `website` signifie que les visiteurs le consultent sur son domaine. `b2c_app` signifie que les créateurs l'installent dans leur whop.

**2. Exécutez-la en local**

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

Lance votre script `dev` avec l'environnement que lui fournirait le runtime hébergé : `WHOP_APP_ID`, un jeton de courte durée dans `WHOP_API_KEY`, et chaque [secret d'app](https://docs.whop.com/fr/developer/websites/hosting.md#secrets) stocké. Les appels SDK côté serveur fonctionnent sans configuration. Tout ce que vous exportez vous-même est prioritaire, et un redémarrage actualise le jeton.

**3. Déployez**

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

Compile, vérifie les types, téléverse le build et une archive source, puis le promeut. Votre site est en ligne une fois l'opération terminée.

```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. Suivez son exécution**

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

Logs du runtime serveur, conservés pendant 7 jours. Consultez [Hébergement](https://docs.whop.com/fr/developer/websites/hosting.md#logs).

## Ce que fournit la structure générée

`whop apps init` génère un projet React avec la commande de création propre à TanStack, puis applique les connexions Whop :

| Modification | Raison |
| - | - |
| Plugin `whop()` de `@whop/cli/vite` | Intègre `dist/` dans l'archive téléversée par `whop apps deploy` |
| `@whop/cli` comme dépendance de développement | La configuration Vite en importe le plugin |
| Scripts `deploy` et `typecheck` | Ce qu'exécute `whop apps deploy` |
| Configuration de build nommée d'après votre route | Maintient le projet aligné sur l'app |
| `whop.app.json` | Lie le répertoire à l'app |

## Utiliser votre propre framework

Le plugin est indépendant du framework — TanStack Start, Nitro, Hono ou du SSR classique fonctionnent tous. La seule exigence concerne la structure du build : les ressources statiques dans `dist/client`, le bundle serveur dans `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` lie le répertoire courant à une app existante avant le déploiement, en remplaçant tout lien présent dans `whop.app.json`.

## Travailler sur un site depuis une autre machine

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

Sur une nouvelle machine, cette commande crée `./<app name>` à partir de l'archive source du build de production. Dans un projet existant, elle fusionne à trois voies le code source déployé avec votre code local via git. Transmettez `--build abld_xxxxxxxx` pour un build spécifique, ou `--overwrite` pour ignorer la fusion.

## Étapes suivantes

> [card] [Fonctionnement de l'hébergement](https://docs.whop.com/fr/developer/websites/hosting.md)
>
> Secrets, retours arrière, logs et clé API injectée.

> [card] [Suivre les visiteurs](https://docs.whop.com/fr/developer/websites/tracking.md)
>
> Le pixel est déjà installé — ajoutez vos propres événements.

> [card] [Blueprints](https://docs.whop.com/fr/developer/websites/blueprints.md)
>
> Partez d'une entreprise fonctionnelle plutôt que d'un projet vide.

> [card] [Référence de la CLI](https://docs.whop.com/fr/developer/cli.md)
>
> Toutes les commandes, ainsi que l'utilisation non interactive.


## Related topics

- [Héberger un site web sur Whop](https://docs.whop.com/fr/developer/websites/overview.md)
- [Déployer une entreprise à partir d'un blueprint](https://docs.whop.com/fr/developer/websites/blueprints.md)
- [Sites web](https://docs.whop.com/fr/elements/latest/websites/overview.md)
