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

# CLI ile Bir Web Sitesi Oluşturun

> Bir Vite uygulaması iskeletleyin, gerçek Whop verileriyle yerel olarak çalıştırın ve bir whop.site adresine veya kendi alan adınıza dağıtın.

Dört komut sizi boş bir dizinden kendi alan adındaki canlı bir siteye götürür.

> [!NOTE]
>
> [Whop CLI](https://docs.whop.com/tr/developer/cli.md) aracını yükleyin ve oturum açıp bir işletme seçmek için `whop` komutunu bir kez çalıştırın.

**1. Uygulamayı oluşturun**

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

Alan adını talep eder, uygulamayı onun üzerine kaydeder, projeyi `./shine-time` içine iskeletler ve dizini uygulamaya bağlayan bir `whop.app.json` yazar. Bunun yerine sorulmasını istiyorsanız bayrakları atlayın.

`--domain`, bir whop.site adı (`shine-time` → `shine-time.whop.site`) veya `shinetime.com` gibi kendi alan adınızı alır:

* İşletmenizde zaten bulunan bir alan adı olduğu gibi kullanılır.
* Kimsenin kaydetmediği bir alan adı Whop üzerinden satın alınır. CLI bir satın alma bağlantısı döndürür ve orada ödeme yapana kadar hiçbir ücret alınmaz.
* Başka bir yerde sahip olduğunuz bir alan adı bağlanır: CLI'ın listelediği DNS kayıtlarını yayınlayın.

Siz ödeme yapana veya bu kayıtları yayınlayana kadar site o alan adını bekler. `whop domains get shinetime.com` durumunu gösterir.

> [!WARNING]
>
> `--app_type` kalıcıdır. `website`, ziyaretçilerin siteye alan adından göz attığı anlamına gelir. `b2c_app`, içerik üreticilerinin onu kendi whop'larına yüklediği anlamına gelir.

**2. Yerel olarak çalıştırın**

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

`dev` betiğinizi, barındırılan çalışma zamanının ona vereceği ortamla başlatır: `WHOP_APP_ID`, `WHOP_API_KEY` olarak kısa ömürlü bir belirteç ve saklanan her [uygulama gizli anahtarı](https://docs.whop.com/tr/developer/websites/hosting.md#secrets). Sunucu tarafı SDK çağrıları kurulum gerektirmeden çalışır. Kendiniz dışa aktardığınız her şey önceliklidir ve yeniden başlatmak belirteci yeniler.

**3. Dağıtın**

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

Derler, tür denetimi yapar, derlemeyi ve bir kaynak arşivini yükler ve onu yükseltir. İşlem bittiğinde siteniz yayındadır.

```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. Çalışmasını izleyin**

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

7 gün boyunca saklanan sunucu çalışma zamanı günlükleri. Bkz. [Barındırma](https://docs.whop.com/tr/developer/websites/hosting.md#logs).

## İskeletin size sağladıkları

`whop apps init`, TanStack'in kendi create komutuyla bir React projesi iskeletler, ardından Whop bağlantılarını uygular:

| Değişiklik | Neden |
| - | - |
| `@whop/cli/vite` içinden `whop()` eklentisi | `dist/` dizinini `whop apps deploy` komutunun yüklediği arşive paketler |
| Geliştirme bağımlılığı olarak `@whop/cli` | Vite yapılandırması eklentiyi buradan içe aktarır |
| `deploy` ve `typecheck` betikleri | `whop apps deploy` komutunun çalıştırdıkları |
| Rotanızın adını taşıyan derleme yapılandırması | Projeyi uygulamayla uyumlu tutar |
| `whop.app.json` | Dizini uygulamaya bağlar |

## Kendi framework'ünüzü getirin

Eklenti framework'ten bağımsızdır; TanStack Start, Nitro, Hono veya düz SSR'ın hepsi çalışır. Tek gereksinim derleme düzenidir: statik varlıklar `dist/client` içinde, sunucu paketi `dist/server` içinde.

```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`, dağıtımdan önce geçerli dizini mevcut bir uygulamaya bağlar ve `whop.app.json` içindeki herhangi bir bağlantının yerini alır.

## Bir site üzerinde başka bir makineden çalışın

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

Yeni bir makinede bu, production derlemesinin kaynak arşivinden `./<app name>` dizinini oluşturur. Mevcut bir projenin içinde, dağıtılan kaynağı git aracılığıyla yerel kodunuzla üç yönlü birleştirir. Belirli bir derleme için `--build abld_xxxxxxxx`, birleştirmeyi atlamak için `--overwrite` iletin.

## Sonraki adımlar

> [card] [Barındırma nasıl çalışır](https://docs.whop.com/tr/developer/websites/hosting.md)
>
> Gizli anahtarlar, geri almalar, günlükler ve enjekte edilen API anahtarı.

> [card] [Ziyaretçileri izleyin](https://docs.whop.com/tr/developer/websites/tracking.md)
>
> Piksel zaten yüklü; kendi olaylarınızı ekleyin.

> [card] [Blueprint'ler](https://docs.whop.com/tr/developer/websites/blueprints.md)
>
> Boş bir proje yerine çalışan bir işletmeden başlayın.

> [card] [CLI referansı](https://docs.whop.com/tr/developer/cli.md)
>
> Tüm komutlar ve etkileşimsiz kullanım.


## Related topics

- [Whop'ta Bir Web Sitesi Barındırın](https://docs.whop.com/tr/developer/websites/overview.md)
- [Bir Blueprint İşletmesi Dağıtın](https://docs.whop.com/tr/developer/websites/blueprints.md)
- [React Native ile Whop uygulamaları oluşturun](https://docs.whop.com/tr/developer/guides/react-native.md)
