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

# React Native ile Whop uygulamaları oluşturun

> iOS ve Android'deki Whop mobil uygulamasının içinde ve web'de çalışan bir React Native uygulaması oluşturun.

Tek bir React Native kod tabanı kullanarak Whop için yerel iOS, Android ve web deneyimleri oluşturun. Uygulamalarınız doğrudan Whop mobil uygulamasının içinde çalışır ve yerel platform özelliklerine erişebilir.

## Nasıl çalışır

Whop, React Native uygulamalarını birden fazla platformda çalışan deneyimler olarak yerleştirir:

* **Mobil (iOS/Android)**: Uygulamalar, tam platform entegrasyonuyla Whop mobil uygulamasının içinde yerel olarak çalışır
* **Web**: Uygulamalar, platforma özgü özellikler için otomatik yedeklerle tarayıcıda çalışır
* **Evrensel kod**: Bir kez yazın, platforma özgü optimizasyonlarla her yerde dağıtın

Uygulamanız kimliği doğrulanmış kullanıcı bağlamını alır ve Whop SDK'sı aracılığıyla API çağrıları yapabilir. Derleme sistemi, mobil için Metro ve web için esbuild kullanarak platforma özgü paketlemeyi otomatik olarak yönetir.

***

## Başlarken

### Sistem gereksinimleri

Başlamadan önce sisteminizin aşağıdaki gereksinimleri karşıladığından emin olun:

* [Node.js 22](https://nodejs.org/) veya üzeri
* [pnpm 9.15](https://pnpm.io/) veya üzeri

Kontrol etmek için `node -v` ve `pnpm -v` komutlarını çalıştırın.

### Uygulamanızı oluşturun

CLI'ı kullanarak yeni bir Whop React Native uygulaması oluşturun:

```bash theme={null}
pnpm create @whop/react-native@latest
```

Bu, aşağıdaki yapıya sahip yeni bir proje kurar:

```
my-app/
├── src/
│   └── views/
│       ├── experience-view.tsx    # Experience view
│       ├── dashboard-view.tsx     # Account dashboard view
│       └── discover-view.tsx      # Discovery/marketplace view (optional)
├── .env.local                     # Environment variables
├── package.json
└── babel.config.js
```

### Ortam değişkenlerini yapılandırın

Kök dizinde bir `.env.local` dosyası oluşturun:

```env theme={null}
WHOP_API_KEY=your_api_key
NEXT_PUBLIC_WHOP_APP_ID=your_app_id
NEXT_PUBLIC_WHOP_AGENT_USER_ID=your_agent_user_id
NEXT_PUBLIC_WHOP_COMPANY_ID=your_account_id
```

Bu kimlik bilgilerini [Whop Geliştirici Panosundan](https://whop.com/dashboard/developer) alın:

1. Whop Geliştirici Panosuna gidin
2. Yeni bir uygulama oluşturun veya mevcut bir uygulamayı seçin
3. Ortam değişkenlerini uygulama ayarlarından kopyalayın

***

## Görünümler

![Proje yapısı](https://mintcdn.com/whop/qLWy5VwqPyIy4SPF/images/react-native-project-structure.png?fit=max\&auto=format\&n=qLWy5VwqPyIy4SPF\&q=85\&s=2252ed3982bb73023b2ccc70204071a0)

Whop uygulamaları, nerede görüntülendiklerine bağlı olarak farklı "görünümler" kullanır. Her görünüm, kimliği doğrulanmış bağlamı props olarak alır.

### Deneyim görünümü

Deneyim uygulamaları için ana görünüm. Kullanıcılar uygulama içeriğinizle burada etkileşime girer.

```tsx theme={null}
// src/views/experience-view.tsx
import React from "react";
import { View, Text, ScrollView } from "react-native";
import type { ExperienceViewProps } from "@whop/react-native";

export function ExperienceView(props: ExperienceViewProps) {
	const { experienceId, companyId, currentUserId, path, params } = props;

	return (
		<ScrollView>
			<Text>Experience: {experienceId}</Text>
			<Text>User: {currentUserId}</Text>
		</ScrollView>
	);
}
```

**Props:**

* `experienceId` - Deneyim kimliği
* `companyId` - Bu deneyimin sahibi olan hesap
* `currentUserId` - Kimliği doğrulanmış kullanıcı (oturum açılmamışsa `null`)
* `path` - Dizi olarak gezinme yolu (ör. `["courses", "123"]`)
* `params` - Nesne olarak sorgu parametreleri

### Pano görünümü

Satıcıların işletmelerini yönettiği hesap panosu entegrasyonları için.

```tsx theme={null}
// src/views/dashboard-view.tsx
import React from "react";
import { View, Text } from "react-native";
import type { DashboardViewProps } from "@whop/react-native";

export function DashboardView(props: DashboardViewProps) {
	const { companyId, currentUserId, path, params } = props;

	return (
		<View>
			<Text>Dashboard for account: {companyId}</Text>
		</View>
	);
}
```

**Props:**

* `companyId` - Hesap kimliği
* `currentUserId` - Kimliği doğrulanmış kullanıcı
* `path` - Dizi olarak gezinme yolu
* `params` - Sorgu parametreleri

### Keşfet görünümü (isteğe bağlı)

Kullanıcıların içeriğe göz attığı pazar yeri/keşif deneyimleri için.

```tsx theme={null}
// src/views/discover-view.tsx
import React from "react";
import type { DiscoverViewProps } from "@whop/react-native";

export function DiscoverView(props: DiscoverViewProps) {
	const { currentUserId, path, params } = props;

	// Your discovery UI
}
```

***

## Veri getirme

### Whop SDK'sını kullanma

> [!WARNING]
>
> Bu örnek, kullanımdan kaldırılmış bir SDK arayüzü kullanır. Yerini alacak
> React Native SDK'sı yayınlandığında güncellenecektir.

Whop SDK'sı, istemci tarafında veri getirme için kutudan çıktığı gibi kullanılabilir:

```tsx theme={null}
import { whopSdk } from "@whop/react-native";
import { useQuery } from "@tanstack/react-query";

export function UserProfile() {
	const { data: user } = useQuery({
		queryKey: ["user"],
		queryFn: () => whopSdk.users.getCurrentUser(),
	});

	return <Text>{user?.name}</Text>;
}
```

> [!NOTE]
>
> [TanStack Query](https://tanstack.com/query/latest), önbelleğe almayı, yükleme durumlarını
> ve yeniden getirmeyi otomatik olarak yönettiği için veri getirme açısından iyi bir seçimdir.

> [!WARNING]
>
> Bazı SDK işlemleri "yalnızca sunucu" işlemleridir ve API'nizden çağrılmalıdır. Hangi
> yöntemlerin sunucu tarafında yürütme gerektirdiğini öğrenmek için
> [Hızlı başlangıç](https://docs.whop.com/tr/developer/quickstart.md) sayfasına bakın.

### Kimliği doğrulanmış API istekleri yapma

Sunucu tarafı işlemler için API rotaları oluşturun ve bunları React Native uygulamanızdan çağırın:

**1. API temel URL'nizi ayarlayın**

API kaynağınızı [geliştirici panosunda](https://whop.com/dashboard/developer) **Base URL** altında yapılandırın.

![Temel URL](https://mintcdn.com/whop/UNSo2mxrx93nOcNt/images/app-settings-base-url.png?fit=max\&auto=format\&n=UNSo2mxrx93nOcNt\&q=85\&s=67da3bca3f3a091176ced262b083b3ae)

**2. Bir API uç noktası oluşturun**

```tsx theme={null}
// app/api/user/route.ts
import { whopSdk } from "@/lib/whop";

export async function GET(request: Request) {
  const { userId } = await whopSdk.verifyUserToken(request.headers);
  const user = await whopSdk.users.getUser({ userId });

  return Response.json(user, { status: 200 });
}
```

SDK yapılandırması için [Hızlı başlangıç](https://docs.whop.com/tr/developer/quickstart.md) sayfasına bakın.

**3. React Native'den çağırın**

Kimliği doğrulanmış istekler yapmak için `apiOrigin` kullanın:

```tsx theme={null}
import { useQuery } from "@tanstack/react-query";
import { __internal_execSync } from "@whop/react-native";

const { apiOrigin } = __internal_execSync("getAppApiOrigin", {});

export function User() {
  const { data: user, isPending } = useQuery({
    queryKey: ["user"],
    queryFn: () => fetch(`${apiOrigin}/api/user`).then((res) => res.json()),
  });

  if (isPending) return <Text>Loading...</Text>;

  return <Text>{user?.name}</Text>;
}
```

> [!NOTE]
>
> Kimliği doğrulanmış istekler için `apiOrigin` kullanmak önemlidir. Bu, isteklerin
> uygun kimlik doğrulama başlıklarıyla Whop'un proxy'sinden geçmesini sağlar.

### Örnek: Bir deneyime erişimi kontrol etme

```tsx theme={null}
// Component
import { useQuery } from "@tanstack/react-query";
import { __internal_execSync } from "@whop/react-native";

const { apiOrigin } = __internal_execSync("getAppApiOrigin", {});

export function ProtectedContent({ experienceId }: { experienceId: string }) {
	const { data: access, isPending } = useQuery({
		queryKey: ["access", experienceId],
		queryFn: () =>
			fetch(`${apiOrigin}/api/access?experienceId=${experienceId}`).then(
				(res) => res.json(),
			),
	});

	if (isPending) return <Text>Loading...</Text>;
	if (!access?.hasAccess) return <Text>Access Denied</Text>;

	return <Text>Welcome! You have access.</Text>;
}
```

> [!WARNING]
>
> Bu sunucu tarafı örnek, kullanımdan kaldırılmış bir SDK arayüzü kullanır. `@whop/sdk`
> ile güncel sunucu tarafı token doğrulaması için
> [Kimlik doğrulama](https://docs.whop.com/tr/developer/guides/authentication.md) sayfasına bakın.

```tsx theme={null}
// app/api/access/route.ts
import { whopSdk } from "@/lib/whop";
import { NextRequest } from "next/server";

export async function GET(request: NextRequest) {
	const experienceId = request.nextUrl.searchParams.get("experienceId");
	if (!experienceId) {
		return new Response("Experience ID required", { status: 400 });
	}

	const { userId } = await whopSdk.verifyUserToken(request.headers);

	const access = await whopSdk.access.checkIfUserHasAccessToExperience({
		experienceId,
		userId,
	});

	return Response.json(access, { status: 200 });
}
```

***

## Stil

### Renk temaları

React Native, cihazın renk şemasını algılamak için bir `useColorScheme` hook'u sağlar. Bu, Whop uygulamalarında otomatik olarak çalışır:

```tsx theme={null}
import { useColorScheme } from "react-native";

export function ThemedView() {
	const colorScheme = useColorScheme();
	const backgroundColor = colorScheme === "dark" ? "#000" : "#fff";

	return <View style={{ backgroundColor }} />;
}
```

### Radix UI renklerini kullanma

Otomatik karanlık mod içeren kapsamlı bir renk sistemi için `useColors` hook desenini Radix UI renkleriyle kullanın:

```bash theme={null}
pnpm add @radix-ui/colors
```

```tsx theme={null}
// hooks/use-colors.ts
import { useColorScheme } from "react-native";
import {
	gray,
	grayA,
	grayDark,
	grayDarkA,
	blue,
	blueA,
	blueDark,
	blueDarkA,
	red,
	redA,
	redDark,
	redDarkA,
	green,
	greenA,
	greenDark,
	greenDarkA,
	amber,
	amberA,
	amberDark,
	amberDarkA,
} from "@radix-ui/colors";

export function useColors() {
	const colorScheme = useColorScheme();
	const isDark = colorScheme === "dark";

	return {
		transparent: "transparent" as const,
		...(isDark ? grayDark : gray),
		...(isDark ? grayDarkA : grayA),
		...(isDark ? blueDark : blue),
		...(isDark ? blueDarkA : blueA),
		...(isDark ? redDark : red),
		...(isDark ? redDarkA : redA),
		...(isDark ? greenDark : green),
		...(isDark ? greenDarkA : greenA),
		...(isDark ? amberDark : amber),
		...(isDark ? amberDarkA : amberA),
	};
}
```

**Kullanım:**

```tsx theme={null}
export function StyledComponent() {
	const colors = useColors();

	return (
		<View style={{ backgroundColor: colors.gray1 }}>
			<Text style={{ color: colors.gray12 }}>Themed text</Text>
		</View>
	);
}
```

***

## Gezinme

Ekranlar arasında gezinmek ve modal pencereler göstermek için dahili gezinme API'lerini kullanın:

### Yeni bir ekrana gidin

```tsx theme={null}
import { __internal_execSync } from "@whop/react-native";

function navigateToPage() {
	__internal_execSync("routerPush", {
		path: ["courses", "123"],
		params: { section: "intro" },
	});
}
```

Whop, `path` ve `params` değerlerini görünüm bileşeninize props olarak iletir.

### Geri dönün

```tsx theme={null}
import { __internal_execSync } from "@whop/react-native";

function goBack() {
	__internal_execSync("routerPop", {});
}
```

### Bir sayfa veya modal gösterin

```tsx theme={null}
import { __internal_execSync } from "@whop/react-native";

function showModal() {
	__internal_execSync("routerPresentSheet", {
		path: ["modal", "settings"],
		params: {},
	});
}

function hideModal() {
	__internal_execSync("routerDismissSheet", {});
}
```

### Mevcut rotayı alın

```tsx theme={null}
import { __internal_execSync } from "@whop/react-native";

const currentRoute = __internal_execSync("routerGetCurrent", {});
console.log(currentRoute.path); // ["courses", "123"]
console.log(currentRoute.params); // { section: "intro" }
```

***

## Platforma özgü özellikler

### Gezinme çubuğu

Gezinme çubuğunun başlığını ve açıklamasını yapılandırın:

```tsx theme={null}
import { __internal_execSync } from "@whop/react-native";

__internal_execSync("setNavigationBarData", {
	title: "Course Details",
	description: "Learn React Native",
});
```

### Ekran yönü

Ekran yönünü kontrol edin:

```tsx theme={null}
import { __internal_execSync } from "@whop/react-native";

// Lock to portrait
__internal_execSync("setScreenOrientationMode", {
	targetScreenOrientationMode: "portrait",
});

// Lock to landscape
__internal_execSync("setScreenOrientationMode", {
	targetScreenOrientationMode: "landscape",
});

// Allow rotation
__internal_execSync("setScreenOrientationMode", {
	targetScreenOrientationMode: "rotate",
});
```

### Dokunsal geri bildirim

Mobil cihazlarda dokunsal geri bildirim sağlayın:

```tsx theme={null}
import { Haptics } from "@whop/react-native";

async function triggerHaptic() {
	await Haptics.trigger("impactMedium", {
		enableVibrateFallback: true,
		ignoreAndroidSystemSettings: false,
	});
}
```

**Kullanılabilir dokunsal türler:**

* `"selection"` - Hafif seçim geri bildirimi
* `"impactLight"` | `"impactMedium"` | `"impactHeavy"` - Darbe geri bildirimi
* `"notificationSuccess"` | `"notificationWarning"` | `"notificationError"` - Bildirim geri bildirimi

### Yerel önbellekleme

Verileri cihazda yerel olarak saklayın:

```tsx theme={null}
import { __internal_execSync } from "@whop/react-native";

// Save data
__internal_execSync("cacheSet", {
	key: "user_preferences",
	data: JSON.stringify({ theme: "dark" }),
});

// Retrieve data
const result = __internal_execSync("cacheGet", {
	key: "user_preferences",
});
const preferences = JSON.parse(result.data || "{}");
```

### Ana uygulama ayrıntıları

Whop uygulaması hakkında bilgi alın:

```tsx theme={null}
import { __internal_execSync } from "@whop/react-native";

const hostDetails = __internal_execSync("getHostAppDetails", {});
console.log(hostDetails.platform); // "ios" | "android" | "web"
console.log(hostDetails.version); // "1.2.3"
console.log(hostDetails.build); // "123"
console.log(hostDetails.buildType); // "appstore" | "testflight" | "debug"
```

***

## Uygulama içi satın alımlar

Ödemeleri doğrudan uygulamanızın içinde kabul edin:

```tsx theme={null}
import { __internal_execAsync } from "@whop/react-native";

async function handlePurchase(planId: string) {
	try {
		const result = await __internal_execAsync("inAppPurchase", {
			planId: planId,
			id: "optional-checkout-config-id",
		});

		console.log("Payment successful!");
		console.log("Session ID:", result.sessionId);
		console.log("Receipt ID:", result.receiptId);

		// Unlock content for user
	} catch (error) {
		console.error("Payment failed:", error);
	}
}
```

Ödeme kabul etmeye ilişkin eksiksiz bir kılavuz için [Ödeme kabul etme dokümantasyonuna](https://docs.whop.com/tr/developer/guides/accept-payments.md) bakın.

***

## Üçüncü taraf kitaplıkları kullanma

Çoğu React Native kitaplığı kutudan çıktığı gibi çalışır. Yaygın kitaplıklar için önerilen sürümler şunlardır:

```json theme={null}
{
	"dependencies": {
		"@react-native-async-storage/async-storage": "2.1.0",
		"@react-native-community/netinfo": "12.0.3",
		"@shopify/flash-list": "1.7.2",
		"burnt": "0.13.2",
		"react-native-mmkv": "3.1.0",
		"react-native-safe-area-context": "5.5.2",
		"react-native-screens": "4.6.0",
		"react-native-svg": "15.12.0",
		"react-native-gesture-handler": "2.27.2",
		"react-native-reanimated": "3.18.0",
		"react-native-haptic-feedback": "2.3.3",
		"lottie-react-native": "7.3.2"
	}
}
```

> [!WARNING]
>
> Yeni kitaplıklar eklerken React Native ile uyumlu olduklarından emin olun.
> Bazı npm paketleri yalnızca web içindir ve mobil platformlarda çalışmaz.

***

## Dağıtım

### Derleme ve dağıtım

`ship` komutu uygulamanızı tüm platformlar için derler ve bir geliştirme derlemesi olarak yükler:

```bash theme={null}
pnpm ship
```

Belirli platformlar için derleyin:

```bash theme={null}
pnpm ship --ios           # iOS only
pnpm ship --android       # Android only
pnpm ship --web          # Web only
pnpm ship --ios --android # iOS and Android
```

> [!NOTE]
>
> `ship` komutu bir **geliştirme derlemesi** olarak dağıtır; bu, mevcut üretim
> uygulamalarında çalıştırmak için güvenlidir. Canlı kullanıcılarınızı etkilemez.

### Geliştirme ve üretim derlemeleri

**Geliştirme derlemeleri:**

* `pnpm ship` ile dağıtılır
* Yalnızca **Dev mode** etkinleştirildiğinde görünür (telefonu sallayın)
* Üretim kullanıcılarını etkilemeden test etmek güvenlidir
* İstediğiniz zaman dağıtabilirsiniz

**Üretim derlemeleri:**

* Pano üzerinden geliştirme derlemelerinden yükseltilir
* Tüm kullanıcılara görünür
* Onay/inceleme gerektirir
* Yükseltmeden önce test edin

### Uygulamanızı önizleyin

Bir geliştirme derlemesini dağıttıktan sonra cihazınızda önizleyin:

```bash theme={null}
pnpm preview
```

Bu, uygulamanızı yükleyen bir QR kodu oluşturur.

> [!WARNING]
>
> Geliştirme derlemelerini önizlemek için Whop uygulamasında **Dev mode**'u etkinleştirmek
> üzere **telefonunuzu sallamanız** gerekir. Bu, üretim dışı derlemeleri görmenizi sağlar.

### Derleme komutları

Derlemeleri yönetmek için ek komutlar:

```bash theme={null}
pnpm build         # Build without uploading
pnpm upload        # Upload previously built files
pnpm clean         # Clean build directory
```

### Üretime yükseltme

1. Bir geliştirme derlemesi dağıtın: `pnpm ship`
2. **Dev mode** içinde test edin (etkinleştirmek için sallayın)
3. [Uygulama panonuza](https://whop.com/dashboard/developer) gidin
4. Builds sekmesine gidin
5. Geliştirme derlemenizi seçin
6. **Promote to Production** seçeneğini seçin

![Üretime yükseltme](https://mintcdn.com/whop/qLWy5VwqPyIy4SPF/images/promote-build.png?fit=max\&auto=format\&n=qLWy5VwqPyIy4SPF\&q=85\&s=9e428a92b24390c4b8db785a55b59b57)

Whop uygulamanızı inceler ve onaydan sonra tüm kullanıcılara dağıtır.

### Geri alma

Derlemeler ekranından ayrıca önceki bir üretim derlemesine anında geri dönebilir ve onu Whop genelindeki tüm kullanıcılar için canlıya alabilirsiniz.

![Geri alma](https://mintcdn.com/whop/qLWy5VwqPyIy4SPF/images/rollback-build.png?fit=max\&auto=format\&n=qLWy5VwqPyIy4SPF\&q=85\&s=c406c17b97bad3f4241749c45741b33e)

***

## Komut satırı arayüzü referansı

`@whop/react-native` CLI'ı, uygulamanızı derlemek ve dağıtmak için komutlar sağlar:

### Komutlar

```bash theme={null}
pnpm ship [--ios] [--android] [--web]    # Build + upload development build
pnpm build [--ios] [--android] [--web]   # Build only (no upload)
pnpm upload [--ios] [--android] [--web]  # Upload existing build/
pnpm clean                                # Clean build directory
pnpm preview                              # Generate install QR code
```

### Derleme süreci

`pnpm ship` komutunu çalıştırdığınızda CLI:

1. **Giriş noktaları oluşturur** - Görünümlerinizi kaydeden platforma özgü giriş dosyaları oluşturur
2. **Kodu paketler**:
   * **Mobil (iOS/Android)**: Metro paketleyici + Hermes bayt kodu derleyicisini kullanır
   * **Web**: React Native Web takma adlarıyla esbuild kullanır
3. **Varlıkları paketler** - Görselleri ve diğer varlıkları toplar ve optimize eder
4. **Whop'a yükler** - Uygulama panonuzda bir geliştirme derlemesi oluşturur
5. **Yükleme bağlantısı oluşturur** - Test için QR kodu sağlar

### Derleme çıktısı

```
build/
├── entrypoints/        # Generated entry files
│   ├── ios/
│   ├── android/
│   └── web/
├── output/            # Compiled bundles
│   ├── ios/
│   │   └── main_js_bundle.hbc
│   ├── android/
│   │   └── main_js_bundle.hbc
│   └── web/
│       ├── main.js
│       └── index.html
└── app_build_*.zip   # Packaged builds
```

***

## Sorun giderme

### Geliştirme derlemesi görünmüyor

**Sorun**: Bir geliştirme derlemesi dağıttınız ancak uygulamada göremiyorsunuz.

**Çözüm**: **Dev mode**'u etkinleştirmek için telefonunuzu sallayın. Geliştirme derlemeleri yalnızca **Dev mode** etkin olduğunda görünür.

### Derleme hataları

**Sorun**: Derleme Metro veya esbuild hatalarıyla başarısız oluyor.

**Çözümler**:

* Derleme önbelleğini temizlemek için `pnpm clean` çalıştırın
* Tüm bağımlılıkları yüklediğinizi kontrol edin: `pnpm install`
* Node.js sürümünü doğrulayın: `node -v` (22+ olmalı)
* Görünümlerinizde söz dizimi hatalarını kontrol edin

### Uygulama programlama arayüzü istekleri çalışmıyor

**Sorun**: API istekleri 401 veya kimlik doğrulama hataları döndürüyor.

**Çözümler**:

* `__internal_execSync("getAppApiOrigin", {})` içinden gelen `apiOrigin` değerini kullandığınızı doğrulayın
* `.env.local` dosyasının `WHOP_API_KEY` değerini ayarladığını kontrol edin
* API uç noktanızın `whopSdk.verifyUserToken(request.headers)` çağırdığını doğrulayın
* Panonun temel URL'yi doğru ayarladığını doğrulayın

### Görünümler bulunamadı

**Sorun**: Derleme başarılı oluyor ancak görünümler oluşturulmuyor.

**Çözümler**:

* Görünüm dosyalarının `src/views/` içinde bulunduğunu kontrol edin
* Dışa aktarımların eşleştiğini doğrulayın: `export function ExperienceView(props: ExperienceViewProps)`
* Görünüm dosyalarının `.tsx` veya `.jsx` ile bittiğinden emin olun

### Kitaplıklar çalışmıyor

**Sorun**: Üçüncü taraf kitaplık mobilde çökmelere neden oluyor.

**Çözümler**:

* Kitaplığın React Native'i desteklediğini (yalnızca web'i değil) doğrulayın
* [Kitaplıkları kullanma](#using-third-party-libraries) bölümündeki önerilen sürümleri kullanın
* Kitaplığın yerel modüller gerektirip gerektirmediğini kontrol edin (gerektiriyorsa ve önerilenler arasında değilse desteklenmez)

### Platforma özgü sorunlar

**Sorun**: Uygulama bir platformda çalışıyor ancak diğerinde çalışmıyor.

**Çözümler**:

* Platformu algılamak ve yedekler sağlamak için `Platform.OS` kullanın
* Üretime yükseltmeden önce tüm platformlarda test edin
* Platforma özgü API'leri yanlış kullanıp kullanmadığınızı kontrol edin

***

## Sonraki adımlar

* API rotalarınız için [kimlik doğrulamayı ayarlayın](https://docs.whop.com/tr/developer/guides/authentication.md)
* Uygulama içi satın alımlarla [ödeme kabul edin](https://docs.whop.com/tr/developer/guides/accept-payments.md)
* Olayları işlemek için [webhook'ları kullanın](https://docs.whop.com/tr/developer/guides/webhooks.md)


## Related topics

- [Payment Elements ile ödeme sayfası oluşturun](https://docs.whop.com/tr/developer/guides/payment-elements.md)
- [Elements ile başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md)
- [CLI ile Bir Web Sitesi Oluşturun](https://docs.whop.com/tr/developer/websites/quickstart.md)
