콘텐츠로 건너뛰기
supastack
문서 둘러보기
데스크톱Tauri

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/desktop/project-structure.md (or send Accept: text/markdown).

프로젝트 구조

Rust 셸, 부트 페이지, 릴리스 스크립트, 웹 앱과의 경계를 찾습니다.

이 가이드에 대해 질문하기
다음에서 열기

설치 및 설정

모든 단계 전에 시작하기 전에와 터미널 기본을 읽으십시오. package.json이 들어 있는 폴더인 루트에서 supastack 폴더를 엽니다. Desktop 체크아웃에는 apps/desktop과 그 릴리스 스크립트가 있고, All Platforms 모노레포는 Web 백엔드와 모바일 앱을 추가합니다. 환경 변수는 로컬 .env 파일 또는 호스팅 대시보드에 저장된 이름 있는 설정입니다. 셸은 SUPASTACK_APP_URL을 파일에서가 아니라 터미널 설정으로 읽습니다.

1. apps/desktop/src-tauri/src/lib.rs를 엽니다 — 모든 네이티브 동작이 이 하나의 파일에 있습니다.

2. apps/desktop/src-tauri/를 둘러봅니다 — 구성, capabilities, 아이콘.

3. 리포지토리 루트에서 corepack pnpm --filter @supastack/desktop dev를 접근 가능한 백엔드로 실행합니다.

체크아웃에는 Tauri 셸만 있습니다: Rust 소스, 그 구성, 부트 페이지, 릴리스 스크립트. 제품 화면은 창이 로드하는 웹 앱에 있습니다 — Desktop 전용 체크아웃에는 자체 앱 화면이 없습니다. 동작을 변경하기 전에 AGENTS.md와 .ai/PROJECT_CONTEXT.md를 읽으십시오. .ai/ 미러 문서는 파일만으로는 보이지 않는 결정을 기록합니다.

apps/desktop/src-tauri/src/    Rust — window, tray, menus, deep links, updater
apps/desktop/src-tauri/        tauri.conf.json, capabilities/, Cargo.toml, icons
apps/desktop/ui/               Boot page (index.html + boot.js) shown while loading
apps/desktop/scripts/          Release preflight + update manifest
docs/                          Runbooks incl. desktop updates
.agents/skills/                Task guides for coding agents

변경이 속할 위치

편집 전에 어느 쪽이 변경을 소유하는지 결정하십시오: 사용자가 제품 UI로 보는 것은 웹 앱에 속하고, OS 수준 동작만 Rust에 속합니다.

  • 창, 트레이, 메뉴, 단축키 또는 단일 인스턴스 동작 → apps/desktop/src-tauri/src/lib.rs.
  • 새 webview 권한 → apps/desktop/src-tauri/capabilities/default.json — 네이티브 기능이 필요할 때만 확장합니다.
  • 번들 식별자, 버전, 업데이터 엔드포인트 또는 플러그인 옵션 → apps/desktop/src-tauri/tauri.conf.json.
  • 자리 표시자 제품 아이콘 → placeholder-icon.png를 교체하고 아이콘 스크립트를 실행합니다.
  • 부팅, 로딩 또는 오프라인 오버레이 동작 → apps/desktop/ui/.
  • 모든 제품 화면, 설정 또는 데이터 → 웹 앱 리포지토리 — 셸은 제품 UI를 포크하지 않습니다.

구현 워크플로

네이티브 변경의 경우 lib.rs를 편집하고 cargo check와 Rust 테스트를 실행한 다음 각 대상 OS에서 창을 실제로 실행합니다 — 트레이, 단축키, 딥링크 동작은 플랫폼마다 다릅니다. .agents/skills/의 add-a-desktop-capability 스킬이 같은 순서를 안내합니다.

검증 및 문제 해결

cargo check는 컴파일 오류를 잡고 cargo test는 순수 로직을 다룹니다. 실제 검증은 Windows, macOS, Linux에서 실행 중인 창입니다 — 트레이, 단축키, 딥링크는 테스트만으로는 증명할 수 없습니다.

corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop typecheck