메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

프로젝트는 Replit에서 빌드하는 모든 것의 컨테이너입니다. 프로젝트에는 디자인, 앱, 슬라이드, 데이터, 그리고 생성하는 모든 결과물이 담겨 있습니다. 아티팩트는 프로젝트 내의 게시 가능한 결과물입니다: 웹 앱, 모바일 앱, 슬라이드 덱, 비디오. 두 가지 이상을 빌드할 때는 두 가지 선택지가 있습니다:
  • 하나의 프로젝트에 여러 아티팩트를 추가하거나,
  • 별도의 프로젝트를 만드는 것입니다.
올바른 선택은 앱이 데이터, 로직, 배포 주기를 공유하는지 여부에 따라 달라집니다. 이 가이드에서는 아티팩트를 단일 프로젝트에 유지할 때와 별도로 만들 때를 다룹니다.

프로젝트에서 아티팩트가 공유하는 것

아티팩트가 같은 프로젝트에 있으면 자동으로 다음을 공유합니다:
  • 데이터베이스: 하나의 아티팩트가 데이터를 작성하면 나머지가 즉시 읽을 수 있습니다
  • 백엔드 및 API: 공유 서버 로직, 코드 중복 없음
  • 파일 스토리지: 아티팩트 전반에서 접근 가능한 이미지, 문서, 업로드 파일
  • 배포: 게시하면 모든 것이 동기화되어 함께 배포됩니다
즉, 아티팩트 간에 연결을 설정하거나 코드를 중복할 필요가 없습니다. 하지만 하나의 아티팩트만 게시하고 나머지는 게시하지 않을 수는 없습니다.

빠른 가이드

기존 프로젝트에 아티팩트를 추가할지 별도의 프로젝트를 만들지 결정할 때 고려해야 할 주요 시나리오입니다.
하나의 프로젝트에 여러 아티팩트 사용별도 프로젝트 사용
앱이 동일한 데이터와 백엔드를 공유할 때앱이 기본 로직이나 데이터를 공유하지 않을 때
모든 것을 함께 배포하고 싶을 때독립적인 배포 주기가 필요할 때
상호 보완적인 앱일 때 (예: 고객 앱과 관리자 대시보드)관련 없는 제품이거나 다른 클라이언트를 위한 것일 때
하나의 아티팩트 변경사항이 다른 아티팩트에 자동으로 반영되길 원할 때캠페인 랜딩 페이지나 이벤트 사이트처럼 단기 프로젝트일 때

예시

같은 프로젝트: 하나의 제품을 위한 웹 앱 + 모바일 앱

레스토랑이 고객이 메뉴를 탐색할 수 있는 웹 앱과 직원이 주문을 관리할 수 있는 모바일 앱을 빌드합니다. 두 앱 모두 메뉴 항목, 주문, 고객 정보의 동일한 데이터베이스에 연결됩니다. 하나의 프로젝트인 이유: 앱이 동일한 데이터와 백엔드를 공유합니다. 고객이 웹 앱을 통해 주문하면 직원이 모바일 앱에서 즉시 확인할 수 있습니다.

같은 프로젝트: 앱 + 관리자 대시보드 + 투자자 피치 덱

스타트업이 주요 제품, 콘텐츠 관리를 위한 내부 관리 패널, 펀드레이징을 위한 슬라이드 덱 — 모두 하나의 프로젝트에 빌드합니다. 스타트업이 주요 제품, 콘텐츠 관리를 위한 내부 관리 패널, 펀드레이징을 위한 슬라이드 덱 — 모두 하나의 프로젝트에 빌드합니다. 하나의 프로젝트인 이유: 관리자 대시보드는 앱이 표시하는 것과 동일한 데이터를 관리하고, 피치 덱은 공유 백엔드의 실시간 지표를 참조할 수 있습니다.

별도 프로젝트: 관련 없는 두 클라이언트 앱

프리랜서가 한 클라이언트를 위한 이커머스 스토어와 다른 클라이언트를 위한 예약 시스템을 빌드합니다. 별도 프로젝트인 이유: 앱에 공유 데이터나 로직이 없습니다. 각 클라이언트는 독립적인 배포가 필요하며 한쪽의 변경사항이 다른 쪽에 영향을 미치지 않아야 합니다.

별도 프로젝트: 주요 제품과 함께 운영되는 캠페인 랜딩 페이지

연중 운영되는 프로덕션 앱과 마케팅 캠페인을 위한 단기 랜딩 페이지가 있습니다. 별도 프로젝트인 이유: 캠페인 페이지는 자체 라이프사이클이 있습니다 — 몇 주 동안 운영했다가 종료합니다. 별도로 유지하면 주요 제품이 복잡해지지 않고 독립적으로 게시하거나 제거할 수 있습니다.

자주 묻는 질문

현재는 불가능합니다. 아티팩트를 분리해야 한다면 새 프로젝트를 만들고 Agent에게 거기서 다시 빌드하도록 요청하세요.
프로젝트는 최대 7개의 아티팩트를 담을 수 있습니다. 추가 아티팩트는 더 많은 메모리를 소비해 미리 보기가 느려질 수 있기 때문에 이 제한이 존재합니다. 더 많은 아티팩트가 필요하면 다른 프로젝트를 시작하세요.
현재는 불가능합니다. 게시하면 모든 것이 함께 배포됩니다. 독립적인 배포가 필요하면 별도의 프로젝트를 사용하세요.