Skip to main content
프로젝트의 홈에서는 프로젝트에서 사용하는 앱과 외부 링크를 한곳에서 관리합니다. 직접 만든 웹 앱을 등록하고 배포할 수 있으며, Figma·Notion·고객지원 채널처럼 팀에서 자주 사용하는 외부 페이지도 함께 추가할 수 있습니다.

등록된 앱 확인하기

홈에는 프로젝트에 등록된 앱이 카드 또는 목록 형태로 표시됩니다. 상단 검색창에서는 다음 정보를 기준으로 앱을 찾을 수 있습니다.
  • 앱 이름
  • Alias
  • 설명
  • URL
오른쪽 상단의 보기 버튼을 이용하면 앱 표시 방식을 변경할 수 있습니다. 각 앱에서는 이름, Alias, 설명, URL, 최근 수정자와 수정 시간을 확인할 수 있습니다. 파일이 배포된 앱에는 현재 활성화된 버전 번호가 표시됩니다.

앱 추가하기

오른쪽 상단의 앱 추가를 선택합니다. 앱을 추가할 때 다음 정보를 입력할 수 있습니다.
  • 제목: 홈과 메뉴에 표시할 앱 이름
  • Alias: 앱을 식별하고 CLI 배포에 사용하는 값
  • 아이콘: 메뉴에 표시할 아이콘
  • 카테고리: 앱의 용도나 분류
  • 설명: 앱의 목적이나 사용 방법
  • URL: 앱을 선택했을 때 이동할 주소
Alias를 비워두면 제목을 기준으로 자동 생성됩니다. 외부 서비스나 문서 페이지를 연결하려면 URL을 입력한 뒤 앱을 추가합니다. 직접 만든 웹 앱을 배포하려면 먼저 앱을 추가한 다음, 생성된 앱의 수정 화면에서 배포를 진행합니다.

앱 수정하기

앱 카드에서 수정을 선택하면 앱의 상세 설정을 관리할 수 있습니다. 수정 화면에서는 다음 작업을 할 수 있습니다.
  • 앱 이름과 Alias 변경
  • 아이콘, 카테고리, 설명 변경
  • 연결 URL 변경
  • 커스텀 도메인 설정
  • HTML 또는 ZIP 파일 배포
  • CLI 배포 안내 확인
  • 버전 히스토리 확인
  • 앱 삭제
Alias는 CLI에서 배포할 앱을 지정할 때 사용됩니다. 이미 배포에 사용 중인 Alias를 변경했다면 이후 배포 명령어에도 변경된 값을 사용해야 합니다.

앱 배포하기

앱 수정 화면에서는 파일 업로드 또는 SAPP CLI를 이용해 앱을 배포할 수 있습니다. 파일로 배포하려면 파일 선택을 누르거나 파일을 업로드 영역에 끌어다 놓습니다. 단일 HTML 파일 또는 index.html이 포함된 ZIP 파일을 사용할 수 있습니다. 반복적으로 앱을 수정하거나 개발 환경에서 바로 배포하려면 CLI로 쉽게 업로드하기를 선택합니다. 배포키 발급, CLI 설치, 프로젝트 연결, 현재 앱의 Alias를 이용한 배포 명령어를 확인할 수 있습니다. AI 코딩 도구에 배포 방법을 전달하려면 Help for Agent (markdown)을 이용할 수 있습니다. 자세한 과정은 파일로 앱 배포하기와 CLI로 앱 배포하기 가이드를 참고하세요.

버전 확인하기

앱을 배포할 때마다 새로운 버전이 생성됩니다. 수정 화면에서 버전 히스토리를 선택하면 다음 정보를 확인할 수 있습니다.
  • 버전 번호
  • 배포 메시지
  • 배포된 파일
  • 배포자
  • 배포 일시
  • 현재 활성 버전
현재 사용 중인 버전에는 활성이 표시됩니다. 이전 상태로 되돌려야 한다면 원하는 버전의 이 버전으로를 선택합니다. 배포할 때 변경 내용을 메시지로 남겨두면 이후 필요한 버전을 찾기 쉽습니다.

왼쪽 메뉴 구성하기

홈의 메뉴 관리에서는 왼쪽 메뉴에 표시할 앱과 그룹을 구성합니다. 다음 작업을 할 수 있습니다.
  • 등록된 앱을 메뉴에 추가
  • 여러 앱을 묶을 그룹 추가
  • 앱과 그룹 이름 변경
  • 드래그하여 표시 순서 변경
  • 앱을 그룹 안으로 이동
  • 메뉴에서 항목 제거
메뉴에서 앱을 제거해도 등록된 앱 자체가 삭제되지는 않습니다. 앱을 완전히 삭제하려면 해당 앱의 수정 화면에서 삭제를 선택해야 합니다. 메뉴 구성을 저장하면 왼쪽 메뉴에 반영됩니다.

기본 이용 순서

홈에서 앱을 관리하는 기본 흐름은 다음과 같습니다.
  1. 앱 추가에서 앱의 기본 정보를 등록합니다.
  2. 생성된 앱의 수정을 선택합니다.
  3. 필요한 경우 파일 또는 CLI로 앱을 배포합니다.
  4. 메뉴 관리에서 팀원이 사용할 메뉴를 구성합니다.
  5. 이후 배포 이력은 버전 히스토리에서 관리합니다.
외부 링크는 URL만 등록해도 사용할 수 있지만, 직접 만든 웹 앱은 앱을 추가한 뒤 수정 화면에서 별도로 배포해야 합니다.