Skip to main content

앱 만들기

두 가지 방법:
  • AI에 요청 - 스레드에서 원하는 것을 설명하면 AI가 빌드합니다
  • 새 앱 버튼 - Drive 사이드바에서 **+**를 클릭하고 새 앱을 선택합니다
AI는 요청 내용을 바탕으로 시작 템플릿을 선택합니다:

하나의 앱, 하나의 브랜치

각 앱은 main의 단일 git 체크아웃입니다. 별도의 초안, 브랜치 전환, 병합 단계가 없습니다. 모든 편집은 main에 커밋으로 저장되며, 배포는 단순히 “현재 main 배포”입니다.

빌드 사이클

  1. AI가 main에 직접 코드를 작성합니다
  2. AI가 개발 서버를 시작합니다. 라이브 미리보기가 표시됩니다
  3. 채팅으로 반복 작업합니다: “차트를 사이드바로 이동”, “다크 테마 추가”
  4. 각 편집 후 개발 서버가 핫 리로드됩니다
  5. 준비되면 배포합니다

배포

배포는 현재 main 커밋을 배포합니다. 별도의 프로덕션 브랜치가 없으며, main에서 가장 최근에 배포된 커밋이 라이브 상태입니다. 카탈로그에 배포하여 다른 사용자가 설치할 수 있도록 하면, 앱은 시작 시 사용자 ID 토큰, 백엔드용 설치 키, 설치/제거 웹훅을 받습니다. 배포를 참조하세요.

캐싱, 업데이트, 오프라인

데스크톱과 모바일은 앱 URL을 일반 브라우저 보기에서만 엽니다. 브라우저 캐시를 지우거나, 네트워크 전용 로드를 강제하거나, 공개 앱과 비공개 앱에 다른 캐시 정책을 적용하지 않습니다. 웹 앱이 캐싱을 관리합니다:
  • 문서 및 자산용 HTTP Cache-Control 헤더
  • 선택적 서비스 워커 / PWA 설정 (템플릿에는 자동 업데이트가 포함된 vite-plugin-pwa 포함)
  • 새 빌드가 즉시 활성화되는지, 한 번 리로드되는지, 다음 열기를 기다리는지 여부
  • 최신 활성화된 빌드의 오프라인 폴백
Kazzle이 열린 앱 탭의 새로운 배포 버전을 감지하면, 등록된 서비스 워커에 업데이트를 확인하도록 요청합니다 (registration.update()). 서비스 워커가 없는 앱은 해당 확인을 무시하고 자신의 HTTP 캐시 헤더를 계속 사용합니다. 따라서 배포된 앱은 캐시에서 즉시 열 수 있고, 하드 새로고침 없이 새 빌드를 적용할 수 있으며, 최신 빌드를 오프라인에서 사용할 수 있습니다.

배포

배포 후 라이브 URL을 얻으려면 배포합니다:
  • 원격 앱 - Kazzle 클라우드에 배포되고 공개 URL을 받습니다
  • 로컬 앱 - 컴퓨터에 설치됩니다. UI는 직접 로드되고, 프로세스 부분은 개발 서버를 실행합니다.

실시간 앱

즉시 로컬 읽기 및 오프라인 지원이 필요한 앱의 경우 AI는:
  1. 데이터베이스를 만듭니다
  2. 실시간 동기화를 켭니다
  3. 두 부분 앱을 빌드합니다: UI (React + 동기화 클라이언트) 및 프로세스 (토큰 엔드포인트 + 동기화 업로드)
  4. vault를 통해 자격 증명을 연결합니다
작동 방식은 실시간 동기화를 참조하세요.

랜딩 페이지

랜딩 페이지는 UI 전용 앱입니다. 백엔드 없음, 데이터베이스 없음. 페이지를 설명하면 AI가 빌드하고, 배포하고, 라이브 URL을 제공합니다. 사용자 정의 도메인을 사용하려면 도메인 또는 서브도메인을 배포된 앱 URL로 지정합니다.