앱 생성 및 배포 방법

미니앱은 복잡한 개발 과정 없이, AI에게 말로 요청하여 우리 팀에 필요한 전용 도구(설문지, 신청서 등)를 직접 만들고 공유하는 기능입니다.

이 페이지 목차

시작 전 확인

미니앱을 만들려면 관리자가 아래 두 가지를 먼저 해 두어야 합니다. 둘 다 되어 있어야 프로필 메뉴에 미니앱이 나타납니다.

1. 미니앱 기능 켜기: 관리자 대시보드에서 미니앱 플랫폼을 켭니다. 처음에는 꺼져 있습니다.
2. 게시 권한 주기: 앱을 만들 사람에게 게시 권한을 줍니다. 사람, 그룹, 소속 단위로 주거나 모든 사용자에게 열 수 있습니다.

전체 흐름

앱은 프로필 메뉴(왼쪽 아래 계정 이름) → 미니앱 → 내 앱 탭에서 오른쪽 위 + 새 앱을 눌러 만듭니다.

② 기본 정보 입력

• 슬러그(주소): 앱 주소(/apps/슬러그)가 되며, 만든 뒤에는 바꿀 수 없습니다. 영문 소문자, 숫자, 하이픈만 사용할 수 있으며 3~40자까지 가능합니다.
• 아이콘: 이모지·아이콘 중에서 고르거나 이미지를 올립니다. 고르지 않으면 앱 이름의 첫 글자가 표시됩니다.
• 한 사람이 만들 수 있는 앱은 최대 10개입니다.

③ 개발

• 바이브코딩 킷 = AI가 앱을 제작할 때 필요한 기본 설정과 지침이 담긴 압축(zip) 파일입니다. 앱 관리 화면의 개요 탭에서 내려받습니다.
• 진행 순서:
  1. 킷 압축을 풀고 template 폴더로 들어가 pnpm install : 필요한 프로그램 패키지 설치
  2. 개발 토큰 탭에서 토큰을 발급해 .env 파일에 넣기
  3. pnpm dev : 내 컴퓨터에서 화면 미리보기 실행
  4. pnpm build 다음 pnpm pack:aiapp : 최종 배포용 파일(.aiapp) 만들기
  5. 만든 .aiapp 파일을 앱 관리 화면의 버전 탭에 올리기(최대 20MB)
• 앱 관리 화면 안내에는 pnpm pack으로 적혀 있지만, 킷에서 .aiapp 파일을 만드는 명령은 pnpm pack:aiapp입니다. pnpm pack만 실행하면 .aiapp 파일이 만들어지지 않습니다.
• 개발 토큰은 앱 관리 화면(내 앱 → 앱 관리)의 개발 토큰 탭에서 발급합니다. 토큰은 이 앱에만 바인딩되고, 발급한 사람(소유자)의 권한으로 동작합니다. 로컬 개발 서버(pnpm dev)에서 실제 데이터에 접근할 때만 필요하며, 빌드·패키징(.aiapp 생성) 자체엔 필요하지 않습니다.

④ AI에게 요청

• 원하는 기능과 디자인을 일반 문장(자연어)으로 설명하면, AI가 입력할 데이터 항목(컬렉션·필드)의 설계안을 먼저 보여준 뒤, 코드 검사와 파일 생성까지 알아서 진행합니다.
• AI가 요청 내용을 보고 제출자용 화면과 관리자용 화면을 역할별로 나눠 설계합니다. 직원끼리는 서로의 응답을 볼 수 없습니다.

요청 문장 템플릿

Claude Code에 아래처럼 요청하면 됩니다. 똑같이 쓰지 않아도 되지만, 다섯 가지를 빠뜨리지 않으면 한 번에 원하는 앱이 나올 가능성이 높습니다.

⑤~⑦ 배포·승인

• 버전 탭에 올리면 바로 미리보기 링크가 생깁니다.
• 배포 파일을 올린 직후에는 게시 상태가 '초안'이라 제작자와 관리자만 미리보기로 테스트해 볼 수 있습니다.
• 검수 요청을 하면 관리자 화면의 승인 대기 탭에 노출됩니다(앱 이름·소유자·요청 버전·현재 버전·마지막 업로드 시각 표시).
• 관리자는 줄 오른쪽 ⋯ 메뉴에서 미리보기로 확인한 뒤 승인 또는 반려합니다. 승인하면 확인 창이 한 번 더 뜨고, 승인된 버전은 바로 게시됩니다.
• 앱 상태는 두 줄로 표시됩니다. 게시 상태(초안/게시됨)와 검수 상태(검수 대기/승인됨)입니다.
• 앱 실행 화면에서는 만든 사람에게만 관리 버튼이 보이며, 이 버튼으로 앱 관리 화면(개요·버전·컬렉션·개발 토큰 탭)에 들어갑니다. 공유, 검수 요청 철회, 앱 삭제도 앱 관리 화면에서 합니다.
• 공개 범위(전체 공개 / 지정 대상만)는 승인 시점에 함께 설정합니다. 지정 대상은 소속(하위 소속 포함)·사용자·조건 검색으로 고릅니다. 승인 전 앱 관리 화면의 상태 카드에 보이는 공개 범위는 기본값이며, 실제 공개 범위는 승인할 때 확정됩니다.

⑧ 실사용

아래는 ④의 요청 예시로 실제로 만든 '정보보안 교육 이수 확인' 앱의 화면입니다. 화면 구성은 요청한 내용에 따라 앱마다 다릅니다.

• 직원은 게시된 앱을 열어 이수 여부와 이수일을 고르고 이수증을 첨부해 제출합니다. 이름은 로그인 정보로 자동 입력되어 따로 입력할 필요가 없습니다.
• 제출한 뒤에도 다시 접속해 다시 제출로 내용을 바꿀 수 있습니다. 다른 직원의 제출은 보이지 않습니다.

• 앱을 만든 사람은 현황 탭에서 제출·이수·미이수 건수와 이수율을 보고, 이수 여부로 걸러 누가 아직 안 했는지 확인합니다.

• 동료가 만든 앱은 프로필 메뉴 → 미니앱의 공유받은 앱 탭에서 확인할 수 있습니다. 카드에 앱 이름·소유자·상태(게시 상태와 검수 상태)·버전이 표시되며, 카드를 누르면 바로 실행됩니다. 제목·슬러그·소유자로 검색할 수 있습니다.

자주 묻는 질문

마지막 수정: 2026년 10월 21일