> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 데스크톱 앱 5분 시작

Rust와 운영 체제의 빌드 도구를 준비하고, 연결 가능한 웹 백엔드를 시작하고, Tauri 창을 실행하고, 트레이, 바로가기 및 로컬 작업 동작을 확인하세요.

## 1. 일반 및 기본 도구 설치

완료 시작하기 전에 데스크톱 저장소 또는 모든 플랫폼 모노레포를 복제하고 편집기에서 엽니다. 데스크톱은 동일한 웹 앱을 둘러싼 기본 창입니다. 계정이나 채팅의 두 번째 구현은 포함되지 않습니다. 종속성 및 기본 도구가 설치된 후 5분 간의 실행이 시작됩니다. 최초 설치 및 Rust 컴파일에는 시간이 더 오래 걸리는 경우가 많습니다.

Windows에서는 아래 Tauri 필수 구성 요소 링크를 사용하여 Microsoft C++ 빌드 도구를 설치합니다. 설치 프로그램에서 C++를 사용한 데스크톱 개발을 선택하고 Windows SDK를 선택한 상태로 유지하고 설치를 완료합니다. Microsoft Edge WebView2 런타임이 설치되어 있는지 확인하세요. Rustup-init.exe를 사용하여 Rustup.rs에서 Rust를 설치하세요. 기본 MSVC 툴체인을 유지합니다. 설치 후 터미널을 다시 엽니다.

macOS에서는 터미널에서 xcode-select --install을 실행하고 명령줄 도구 대화 상자가 설치되지 않은 경우 완료합니다. Rustup.rs에서 macOS 명령을 사용하여 Rust를 설치합니다. Linux에서는 정확한 배포판의 WebKitGTK, 컴파일러, 트레이 및 시스템 라이브러리 패키지에 대한 Tauri 전제 조건 페이지를 따른 다음 Rust를 설치하세요. Linux 패키지 이름은 다양합니다. 다른 배포판의 명령을 실행하지 마십시오.

저장소 루트에서 터미널을 열고 아래 버전 확인을 실행하세요. rustc 및 cargo 모두 버전을 인쇄해야 합니다. cargo는 Rust의 빌드 도구입니다. 둘 중 하나라도 누락된 경우 설치를 완료하고 계속하기 전에 터미널을 다시 엽니다.

[도구 설치 및 코드 받기](https://supastack.dev/ko/docs/web/before-you-start.md)

[명령어 실행 및 파일 편집 방법 알아보기](https://supastack.dev/ko/docs/web/terminal-basics.md)

[Tauri의 운영 체제 전제 조건 체크리스트](https://tauri.app/start/prerequisites/)

[공식 Rust 설치 프로그램](https://rustup.rs/)

```
rustc --version
cargo --version
corepack pnpm install
```


## 2. 웹 백엔드 시작 또는 선택

체크아웃에 apps/web가 포함된 경우 웹 튜토리얼에 따라 apps/web/.env.local를 생성하고 아래 명령을 사용하여 별도의 터미널에서 웹 서버를 실행한 후 실행 상태로 둡니다. 먼저 브라우저에서 http://localhost:3000를 확인하세요. 데이터베이스 없이 /dashboard 데모를 사용할 수 있습니다. /auth의 실제 로그인에는 마이그레이션된 Postgres가 필요합니다.

데스크톱 전용 체크아웃에는 apps/web.가 포함되어 있지 않습니다. 제품에 대해 별도로 제공되는 별도로 실행되는 웹 백엔드를 사용하고 브라우저에서 해당 URL를 열어 작동하는지 확인하세요. 데스크톱 셸에서는 백엔드를 생성할 수 없습니다. 해당 폴더가 없으면 아래 웹 명령을 시도하지 마십시오. 3단계에서는 제공된 백엔드 주소를 선택하는 방법을 보여줍니다.

[로컬 웹 백엔드 실행](https://supastack.dev/ko/docs/web/ship-in-5-minutes.md)

[Postgres로 실계좌 준비](https://supastack.dev/ko/docs/web/database.md)

```
# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev
```


## 3. 바탕화면 창을 실행하세요

백엔드가 계속 실행되는 동안 저장소 루트에서 두 번째 터미널을 엽니다. http://localhost:3000,의 기본 로컬 백엔드에 대해 아래 첫 번째 명령을 실행합니다. Cargo는 라이브러리를 다운로드하고 쉘을 컴파일할 수 있습니다. SupaStack 창이 열릴 때까지 기다립니다. 첫 번째 빌드 중 컴파일러 메시지가 예상됩니다.

제공된 백엔드의 경우 아래의 적절한 운영 체제 블록에 있는 https://app.example.com를 실제 URL로 바꿉니다. 플랫폼의 블록만 실행하세요. SUPASTACK_APP_URL는 터미널 환경 설정으로, 기본 프로세스가 시작될 때 읽습니다. 루트 .env에만 넣으면 셸이 구성되지 않습니다. 백엔드 URL에 내장된 사용자 이름이나 비밀번호가 없도록 유지하세요.

모든 플랫폼 모노 저장소에서 corepack pnpm dev:desktop은 시작하기 전에에 설명된 대로 pnpm가 PATH에 있으면 웹과 Tauri를 함께 시작할 수 있습니다. 아래 필터링된 명령은 백엔드가 별도로 실행되는 데스크톱 전용 체크아웃에서도 작동합니다.

```
# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev

# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev

# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev
```


## 4. 창, 트레이, 바로가기 확인

성공은 창에 브라우저의 백엔드와 동일한 홈페이지가 표시된다는 의미입니다. 데스크톱 창에는 브라우저 주소 표시줄이 없습니다. 자격 증명이 필요 없는 데모를 열려면 트레이의 Quit 작업을 사용하여 셸을 종료한 다음 웹 서버가 계속 실행되는 동안 데스크톱 터미널에서 아래 운영 체제 블록을 실행하세요. 그러면 /dashboard가 직접 로드됩니다. 거기에서 웹 튜토리얼의 로컬 작업 단계를 따르십시오. 실제 계정 로그인은 브라우저에서와 마찬가지로 백엔드의 데이터베이스를 사용합니다.

닫기 버튼을 사용하여 창을 닫습니다. 앱은 종료되지 않고 트레이에 숨겨져야 합니다. Supastack 트레이 아이콘을 클릭하거나 Windows/Linux에서는 Ctrl + Shift + Space, macOS에서는 Command + Shift + Space를 누르면 다시 표시됩니다. 종료하려면 트레이의 종료 동작을 사용하십시오. 개발을 완전히 종료하려면 데스크톱 터미널에서도 Ctrl + C를 누른 후 백엔드 터미널을 중지합니다.

창이 비어 있거나 연결 문제가 표시되면 먼저 브라우저에서 구성된 URL를 엽니다. 백엔드를 시작하거나 URL를 수정한 다음 Tauri를 다시 시작하세요. Rust에서 linker.exe를 찾을 수 없다고 보고하면 Windows C++ 워크로드를 설치하고 터미널을 다시 엽니다. Linux에서 시스템 라이브러리가 누락되었다고 보고하는 경우 배포판별 필수 구성 요소를 따르세요. 단축키가 이미 사용된 경우 트레이를 사용하고 기본 동작에 따라 단축키를 변경하세요.

그러면 로컬 개발 창이 시작됩니다. 서명된 설치 프로그램을 생성하거나 앱을 게시하지 않습니다. 설치 프로그램 빌드, 플랫폼 서명 및 다른 컴퓨터에서의 테스트를 위해 데스크탑 배포를 따릅니다. Windows 컴파일에서는 macOS 또는 Linux 동작을 확인하지 않습니다.

[기본 창 및 바로가기 동작 구성](https://supastack.dev/ko/docs/desktop/run.md)

[데스크톱 설치 프로그램 빌드 및 확인](https://supastack.dev/ko/docs/desktop/release.md)

```
# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev

# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop dev
```


## 로컬 앱 URL 사용

재정의가 없으면 Tauri는 http://localhost:3000을 불러옵니다. 로컬 Next.js 앱이 다른 접근 가능한 HTTP(S) origin을 사용할 때만 SUPASTACK_APP_URL을 설정하세요. 자격 증명이 있거나 웹 URL이 아니면 거부됩니다.

개발 bundle identifier와 release 설정은 제품용으로 준비되지 않았습니다. release 사전 점검과 플랫폼 서명은 별도 release 안내를 따르세요.


## 다음

[shell 실행 및 구성](https://supastack.dev/ko/docs/desktop/run.md)