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

# 앱 뷰

> Whop에서 앱이 표시되는 위치를 구성하세요: 멤버를 위한 경험 뷰, 크리에이터를 위한 대시보드 뷰, 또는 둘 다.

앱 뷰는 Whop이 앱을 어디에 어떻게 표시할지 결정합니다. 앱의 기능과 대상 사용자에 따라 하나 이상의 뷰를 구성할 수 있습니다.

각 뷰는 서로 다른 목적을 가지며 플랫폼의 서로 다른 맥락에서 표시됩니다.

## 경험 뷰

경험 뷰는 멤버가 앱의 핵심 기능과 상호작용하는 곳입니다. 이 뷰를 가진 앱은 채팅, 포럼, 강좌 같은 기본 기능과 함께 Whop 사이드바에 바로 표시됩니다.

크리에이터가 앱을 설치하면 앱으로 구동되는 경험을 하나 이상 만들 수 있습니다. 각 경험은 사이드바의 항목 하나에 대응하며 고유한 사용자 지정 콘텐츠를 렌더링할 수 있습니다.

경험 뷰의 각 인스턴스에는 `exp_xxxxxxxx` 형태의 고유한 경험 ID가 있습니다.

![경험 뷰](https://mintcdn.com/whop/10U_4RMUCDhk64co/images/app-experience-view.jpeg?fit=max\&auto=format\&n=10U_4RMUCDhk64co\&q=85\&s=695a5e126942d5b709b641edd3f3a513)

### 경험 뷰를 사용해야 하는 경우

경험 뷰는 멤버가 상호작용하는 소비자 중심 앱에 적합합니다:

* 커뮤니티 안에서 바로 진행되는 라이브 퀴즈와 투표
* 인터랙티브 콘텐츠를 갖춘 맞춤형 강좌 제공 시스템
* 동영상, 파일 또는 다운로드가 포함된 접근 제한 콘텐츠 라이브러리
* 커뮤니티 게임과 인터랙티브 경험
* 멤버를 위한 실시간 협업 도구

### 경험 뷰 구성하기

**1. 앱의 호스팅 설정으로 이동하기**

1. [개발자 대시보드](https://whop.com/dashboard/developer)로 이동합니다
2. 새 앱을 만들거나 기존 앱을 선택합니다
3. **Hosting** 섹션으로 스크롤합니다

![앱 설정](https://mintcdn.com/whop/10U_4RMUCDhk64co/images/app-settings-hosting.png?fit=max\&auto=format\&n=10U_4RMUCDhk64co\&q=85\&s=428a4fa02ead35e8f4e3de4c368d744b)

**2. 경로 입력하기**

경험 뷰의 경로를 입력하세요. 권장 기본 경로는 `/experiences/[experienceId]`입니다.

![경험 뷰 경로](https://mintcdn.com/whop/10U_4RMUCDhk64co/images/experience-view-path.png?fit=max\&auto=format\&n=10U_4RMUCDhk64co\&q=85\&s=09b247eb50e14ee3f0dc4bf5e903d099)

* `[experienceId]`는 접근한 경험 ID를 제공하는 데 사용됩니다: `/experiences/[experienceId] -> /experiences/exp_***`
* `[restPath]`는 앱의 특정 섹션으로 딥 링크하는 데 사용됩니다: `/experiences/[experienceId]/[restPath] -> /experiences/exp_***/posts/1`

### 경험 뷰 미리 보기

**1. 앱 설치하기**

설치 버튼을 선택하거나, 설치 링크를 복사해 브라우저에서 방문하세요. whop에 앱을 설치하라는 안내가 표시됩니다.

![앱 설치 버튼](https://mintcdn.com/whop/10U_4RMUCDhk64co/images/app-settings-install-app-button.png?fit=max\&auto=format\&n=10U_4RMUCDhk64co\&q=85\&s=9a5bbb5ab8d08cfb419aaa64b0754765)

이미 앱을 설치했다면 whop에서 접근할 수 있습니다.

![Whop 사이드바 앱 섹션](https://mintcdn.com/whop/YCN8CE8TO9oEZrci/images/whop-experiences.png?fit=max\&auto=format\&n=YCN8CE8TO9oEZrci\&q=85\&s=3b441cbe9f4a93a4c58d9ab83a6f59f0)

**2. 환경 설정하기**

1. **톱니바퀴** 버튼을 선택하여 개발자 도구를 엽니다
2. 환경을 **localhost**로 설정합니다

<video controls src="https://mintcdn.com/whop/wmug03bhIwuWRAcH/how-to-videos/experience-app-preview-set-localhost.mp4?fit=max&auto=format&n=wmug03bhIwuWRAcH&q=85&s=707023002211309d87f552fab95a7b5d" />

### 경험 접근 권한 검증하기

> [!WARNING]
>
> `verifyUserToken`은 현재 `@whop/sdk`에서 사용할 수 없습니다. 이 페이지의 검증 코드 조각은 참고용으로 남겨 두었으며 작성된 그대로는 실행되지 않습니다.

`checkAccess` 메서드를 사용해 사용자가 경험에 접근할 수 있는지 확인하세요. 앱이 로드될 때 Whop은 경험 ID를 경로 매개변수로 전달합니다.

```typescript theme={null}
import { headers } from "next/headers";
import { whopsdk } from "@/lib/whop-sdk";

export default async function ExperiencePage({
    params,
}: {
    params: Promise<{ experienceId: string }>;
}) {
    const { experienceId } = await params;
    const { userId } = await whopsdk.verifyUserToken(await headers());

    const access = await whopsdk.users.checkAccess({
        id: userId,
        resource_id: experienceId,
    });

    if (!access.has_access) {
        return <div>Access denied</div>;
    }

    // access.access_level can be:
    // "customer" - User has a valid membership
    // "admin" - User is a team member

    return <div>Welcome to the experience!</div>;
}
```

자세한 내용은 [인증 - 고객 앱](https://docs.whop.com/ko/developer/guides/authentication.md#customer-app-experience-view)을 참고하세요.

### 예제

* [Next.js](https://github.com/whopio/whop-nextjs-app-template/blob/main/app/experiences/%5BexperienceId%5D/page.tsx)
* [React Native](https://github.com/whopio/whop-sdk-ts/blob/main/packages/create-react-native/template/src/views/experience-view.tsx)

## 대시보드 뷰

대시보드 뷰는 크리에이터의 비즈니스 대시보드에 바로 표시됩니다. 비즈니스의 성장과 운영 관리를 돕는 앱에 이 뷰를 사용하세요.

대시보드 뷰를 가진 앱은 대시보드 사이드바의 앱 섹션에 표시되므로, 크리에이터가 비즈니스 운영을 관리할 때 쉽게 찾을 수 있습니다.

![대시보드 뷰](https://mintcdn.com/whop/10U_4RMUCDhk64co/images/app-dashboard-view.jpeg?fit=max\&auto=format\&n=10U_4RMUCDhk64co\&q=85\&s=b8c203cd338932683757b8843226da6b)

### 대시보드 뷰를 사용해야 하는 경우

대시보드 뷰는 크리에이터의 비즈니스 운영을 돕는 B2B 앱에 적합합니다:

* 매출, 멤버 증가, 참여 지표를 보여 주는 분석 대시보드
* 충성 멤버에게 맞춤 제안을 보내는 고객 업셀 도구
* 고객을 정리하고 세분화하는 멤버 관리 인터페이스
* 자동화된 마케팅 캠페인과 이메일 빌더
* 앱별 설정을 관리하는 맞춤형 관리자 패널

### 대시보드 뷰 구성하기

**1. 앱의 호스팅 설정으로 이동하기**

1. [개발자 대시보드](https://whop.com/dashboard/developer)로 이동합니다
2. 새 앱을 만들거나 기존 앱을 선택합니다
3. **Hosting** 섹션으로 스크롤합니다

![앱 설정](https://mintcdn.com/whop/10U_4RMUCDhk64co/images/app-settings-hosting.png?fit=max\&auto=format\&n=10U_4RMUCDhk64co\&q=85\&s=428a4fa02ead35e8f4e3de4c368d744b)

**2. 경로 입력하기**

대시보드 뷰의 경로를 입력하세요. 권장 기본 경로는 `/dashboard/[companyId]`입니다.

![대시보드 뷰 경로](https://mintcdn.com/whop/10U_4RMUCDhk64co/images/dashboard-view-path.png?fit=max\&auto=format\&n=10U_4RMUCDhk64co\&q=85\&s=24abea4609726b03e150679e9081138e)

* `[companyId]`는 접근한 계정 ID를 제공하는 데 사용됩니다: `/dashboard/[companyId] -> /dashboard/biz_***`
* `[restPath]`는 앱의 특정 섹션으로 딥 링크하는 데 사용됩니다: `/dashboard/[companyId]/[restPath] -> /dashboard/biz_***/posts/1`

### 대시보드 뷰 미리 보기

**1. 앱 설치하기**

필드 옆의 미리 보기 버튼을 선택하여 앱의 대시보드 뷰를 엽니다. 아직 앱을 설치하지 않았다면 설치하라는 안내가 표시됩니다.

![앱 미리 보기 버튼](https://mintcdn.com/whop/YCN8CE8TO9oEZrci/images/preview-dashboard-app-button.png?fit=max\&auto=format\&n=YCN8CE8TO9oEZrci\&q=85\&s=16043cb9c3553600f4d81942bde76904)

이미 앱을 설치했다면 대시보드의 **apps** 섹션에서 접근할 수 있습니다.

![대시보드 사이드바 앱 섹션](https://mintcdn.com/whop/10U_4RMUCDhk64co/images/dashboard-apps-sidebar-section.png?fit=max\&auto=format\&n=10U_4RMUCDhk64co\&q=85\&s=b0ab34c95536596c42f59b51b7dff586)

**2. 환경 설정하기**

1. **톱니바퀴** 버튼을 선택하여 개발자 도구를 엽니다
2. 환경을 **localhost**로 설정합니다

<video controls src="https://mintcdn.com/whop/wmug03bhIwuWRAcH/how-to-videos/dashboard-app-preview-set-localhost.mp4?fit=max&auto=format&n=wmug03bhIwuWRAcH&q=85&s=6f0eb2a0a7c60799a3bae0054697c208" />

### 계정 접근 권한 검증하기

대시보드 앱에는 계정 관리자만 접근할 수 있어야 합니다. 계정 ID와 함께 `checkAccess` 메서드를 사용해 접근 권한을 확인하세요.

```typescript theme={null}
import { headers } from "next/headers";
import { whopsdk } from "@/lib/whop-sdk";

export default async function DashboardPage({
    params,
}: {
    params: Promise<{ companyId: string }>;
}) {
    const { companyId } = await params;
    const { userId } = await whopsdk.verifyUserToken(await headers());

    const access = await whopsdk.users.checkAccess({
        id: userId,
        resource_id: companyId,
    });

    if (access.access_level !== "admin") {
        return <div>Admin access required</div>;
    }

    return <div>Welcome to the dashboard!</div>;
}
```

자세한 내용은 [인증 - 대시보드 앱](https://docs.whop.com/ko/developer/guides/authentication.md#dashboard-app-dashboard-view)을 참고하세요.

### 예제

* [Next.js](https://github.com/whopio/whop-nextjs-app-template/blob/main/app/dashboard/%5BcompanyId%5D/page.tsx)
* [React Native](https://github.com/whopio/whop-sdk-ts/blob/main/packages/create-react-native/template/src/views/dashboard-view.tsx)

## 적합한 뷰 선택하기

앱의 기능에 따라 여러 뷰를 구성할 수 있습니다:

* **소비자 앱**: 경험 뷰를 사용해 멤버에게 인터랙티브 기능을 제공합니다
* **비즈니스 앱**: 대시보드 뷰를 사용해 크리에이터의 운영 관리를 돕습니다
* **하이브리드 앱**: 두 뷰를 모두 사용해 멤버와 크리에이터 모두에게 서비스를 제공합니다

시작하려면 앱 대시보드의 Hosting 섹션에서 뷰를 구성하세요.


## Related topics

- [Whop 앱 빌드하기](https://docs.whop.com/ko/developer/apps/overview.md)
- [앱 권한 요청하기](https://docs.whop.com/ko/developer/guides/permissions.md)
- [앱 스토어 등록 요구 사항](https://docs.whop.com/ko/developer/apps/listing-requirements.md)
