> ## 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에서 게시 가능한 결과물입니다 — 웹 앱, 모바일 앱, 슬라이드 덱, 애니메이션, 데이터 시각화, 3D 게임, 그리고 배포하고 공유할 수 있는 디자인.

export const ArtifactGrid = () => {
  if (typeof document !== "undefined" && !document.getElementById("artifact-grid-styles")) {
    const style = document.createElement("style");
    style.id = "artifact-grid-styles";
    style.textContent = `
      .artifact-grid-wrap {
        --ag-bg: var(--replit-docs-bg, #F6F6F4);
        --ag-icon-bg: var(--replit-docs-bg-elevated, #F1F1EE);
        --ag-icon-border: var(--replit-docs-border, #DEDAD5);
        --ag-text: var(--replit-docs-text-muted, #5C5C5C);
        --ag-icon-color: var(--replit-docs-text-muted, #5C5C5C);
      }
      .dark .artifact-grid-wrap,
      html.dark .artifact-grid-wrap,
      [data-theme="dark"] .artifact-grid-wrap {
        --ag-bg: var(--replit-docs-bg, #1E1E1F);
        --ag-icon-bg: var(--replit-docs-bg-elevated, #222223);
        --ag-icon-border: var(--replit-docs-border, #39393D);
        --ag-text: var(--replit-docs-text-muted, #B8B8BE);
        --ag-icon-color: var(--replit-docs-text-muted, #B8B8BE);
      }
      @keyframes ag-fade-in {
        from { transform: translateY(8px); opacity: 0; }
        to { transform: translateY(0); opacity: 1; }
      }
      @media (hover: hover) {
        .artifact-grid-wrap .ag-icon-btn:hover {
          background: var(--ag-icon-border) !important;
        }
      }
    `;
    document.head.appendChild(style);
  }
  const types = [{
    name: "Web",
    icon: <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
          <path fillRule="evenodd" d="M12 1.25c5.937 0 10.75 4.813 10.75 10.75S17.937 22.75 12 22.75 1.25 17.937 1.25 12 6.063 1.25 12 1.25Zm-9.217 11.5a9.25 9.25 0 0 0 7.468 8.333 15.25 15.25 0 0 1-2.982-8.333H2.783Zm13.948 0a15.249 15.249 0 0 1-2.983 8.333 9.25 9.25 0 0 0 7.469-8.333H16.73Zm-7.958 0A13.748 13.748 0 0 0 12 20.876a13.748 13.748 0 0 0 3.227-8.126H8.773Zm1.478-9.834a9.251 9.251 0 0 0-7.468 8.334H7.27a15.251 15.251 0 0 1 2.982-8.334ZM12 3.123a13.747 13.747 0 0 0-3.227 8.127h6.454A13.748 13.748 0 0 0 12 3.123Zm1.748-.207a15.25 15.25 0 0 1 2.983 8.334h4.486a9.251 9.251 0 0 0-7.469-8.334Z" clipRule="evenodd" />
        </svg>
  }, {
    name: "Mobile",
    icon: <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
          <path fillRule="evenodd" d="M7 2.75c-.69 0-1.25.56-1.25 1.25v16c0 .69.56 1.25 1.25 1.25h10c.69 0 1.25-.56 1.25-1.25V4c0-.69-.56-1.25-1.25-1.25H7ZM4.25 4A2.75 2.75 0 0 1 7 1.25h10A2.75 2.75 0 0 1 19.75 4v16A2.75 2.75 0 0 1 17 22.75H7A2.75 2.75 0 0 1 4.25 20V4Zm7 14a.75.75 0 0 1 .75-.75h.01a.75.75 0 0 1 0 1.5H12a.75.75 0 0 1-.75-.75Z" clipRule="evenodd" />
        </svg>
  }, {
    name: "Slides",
    icon: <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
          <path fillRule="evenodd" d="M20 2.25A2.75 2.75 0 0 1 22.75 5v14A2.75 2.75 0 0 1 20 21.75h-8A2.75 2.75 0 0 1 9.25 19V5A2.75 2.75 0 0 1 12 2.25h8Zm-8 1.5c-.69 0-1.25.56-1.25 1.25v14c0 .69.56 1.25 1.25 1.25h8c.69 0 1.25-.56 1.25-1.25V5c0-.69-.56-1.25-1.25-1.25h-8Z" clipRule="evenodd" />
          <path d="M6 4.25a.75.75 0 0 1 .75.75v14a.75.75 0 0 1-1.5 0V5A.75.75 0 0 1 6 4.25ZM2 6.25a.75.75 0 0 1 .75.75v10a.75.75 0 0 1-1.5 0V7A.75.75 0 0 1 2 6.25Z" />
        </svg>
  }, {
    name: "Design",
    icon: <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
          <path d="M6.5 11.25a1.25 1.25 0 1 1 0 2.5 1.25 1.25 0 0 1 0-2.5ZM17.5 9.25a1.25 1.25 0 1 1 0 2.5 1.25 1.25 0 0 1 0-2.5ZM8.5 6.25a1.25 1.25 0 1 1 0 2.5 1.25 1.25 0 0 1 0-2.5ZM13.5 5.25a1.25 1.25 0 1 1 0 2.5 1.25 1.25 0 0 1 0-2.5Z" />
          <path fillRule="evenodd" d="M12 1.25c2.827 0 5.553 1.01 7.573 2.828C21.596 5.9 22.75 8.388 22.75 11A5.749 5.749 0 0 1 17 16.75h-2.25a1 1 0 0 0-.8 1.6l.3.4.1.143a2.5 2.5 0 0 1-2.1 3.857H12a10.75 10.75 0 1 1 0-21.5Zm0 1.5a9.25 9.25 0 1 0 0 18.5h.25a1 1 0 0 0 .8-1.6l-.3-.4a2.5 2.5 0 0 1 2-4H17l.21-.005A4.25 4.25 0 0 0 21.25 11c0-2.161-.953-4.252-2.68-5.807C16.84 3.636 14.476 2.75 12 2.75Z" clipRule="evenodd" />
        </svg>
  }, {
    name: "Animation",
    icon: <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
          <path fillRule="evenodd" d="M10.024 7.25c.31.004.613.091.878.251l4.996 2.996a1.752 1.752 0 0 1 .625 2.367 1.75 1.75 0 0 1-.625.639v-.001l-4.995 2.995.001.001a1.75 1.75 0 0 1-2.654-1.505v-5.99a1.75 1.75 0 0 1 1.774-1.753Zm-.02 1.5a.252.252 0 0 0-.22.124.253.253 0 0 0-.034.127v5.998a.252.252 0 0 0 .127.219.253.253 0 0 0 .252-.004l.002-.001 4.997-2.997.002-.001a.252.252 0 0 0 .122-.215.25.25 0 0 0-.122-.215h-.002L10.13 8.786h-.002a.25.25 0 0 0-.125-.037Z" clipRule="evenodd" />
          <path fillRule="evenodd" d="M12 1.25c5.937 0 10.75 4.813 10.75 10.75S17.937 22.75 12 22.75 1.25 17.937 1.25 12 6.063 1.25 12 1.25Zm0 1.5a9.25 9.25 0 1 0 0 18.5 9.25 9.25 0 0 0 0-18.5Z" clipRule="evenodd" />
        </svg>
  }, {
    name: "Data Viz",
    icon: <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
          <path d="M5 14.25a.75.75 0 0 1 .75.75v6a.75.75 0 0 1-1.5 0v-6a.75.75 0 0 1 .75-.75ZM12 8.25a.75.75 0 0 1 .75.75v12a.75.75 0 0 1-1.5 0V9a.75.75 0 0 1 .75-.75ZM19 2.25a.75.75 0 0 1 .75.75v18a.75.75 0 0 1-1.5 0V3a.75.75 0 0 1 .75-.75Z" />
        </svg>
  }, {
    name: "3D Game",
    icon: <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
          <path fillRule="evenodd" d="M11.25 9.675A3.751 3.751 0 0 1 12 2.25a3.75 3.75 0 0 1 .75 7.425v4.575H19A2.75 2.75 0 0 1 21.75 17v2A2.75 2.75 0 0 1 19 21.75H5A2.75 2.75 0 0 1 2.25 19v-2A2.75 2.75 0 0 1 5 14.25h.25V13a.75.75 0 0 1 1.5 0v1.25h4.5V9.675ZM9.75 6a2.25 2.25 0 1 0 4.5 0 2.25 2.25 0 0 0-4.5 0ZM4.116 16.116A1.25 1.25 0 0 1 5 15.75h14A1.25 1.25 0 0 1 20.25 17v2A1.25 1.25 0 0 1 19 20.25H5a1.25 1.25 0 0 1-1.244-1.126L3.75 19v-2c0-.331.132-.65.366-.884Z" clipRule="evenodd" />
        </svg>
  }];
  const rows = [types.slice(0, 4), types.slice(4, 7)];
  const iconBtnStyle = {
    display: "flex",
    alignItems: "center",
    justifyContent: "center",
    width: "48px",
    height: "48px",
    border: "1px solid var(--ag-icon-border)",
    borderRadius: "12px",
    background: "var(--ag-icon-bg)",
    cursor: "default",
    color: "var(--ag-icon-color)",
    padding: 0,
    transition: "background 120ms ease-out",
    flexShrink: 0
  };
  return <div className="artifact-grid-wrap" style={{
    fontFamily: "'IBM Plex Sans', sans-serif",
    display: "flex",
    flexDirection: "column",
    alignItems: "center",
    gap: "12px",
    padding: "32px",
    background: "var(--ag-bg)",
    borderRadius: "16px",
    width: "100%",
    maxWidth: "460px",
    margin: "32px auto",
    opacity: 0,
    animation: "ag-fade-in 300ms ease-out forwards"
  }}>
      {rows.map((row, ri) => <div key={ri} style={{
    display: "flex",
    gap: "12px",
    justifyContent: "center"
  }}>
          {row.map(type => <div key={type.name} style={{
    display: "flex",
    flexDirection: "column",
    alignItems: "center",
    gap: "6px"
  }}>
              <div className="ag-icon-btn" style={iconBtnStyle}>
                {type.icon}
              </div>
              <span style={{
    fontSize: "11px",
    color: "var(--ag-text)",
    textAlign: "center",
    lineHeight: "1.2"
  }}>
                {type.name}
              </span>
            </div>)}
        </div>)}
    </div>;
};

## 아티팩트란?

아티팩트는 Replit에서 게시할 수 있는 것들입니다: 웹 앱, 모바일 앱, 슬라이드 덱, 애니메이션, 데이터 앱, 3D 게임, 디자인. 각각은 게시할 때 자체 공유 가능한 URL을 갖는 완전하고 독립적인 결과물입니다.

프로젝트의 다른 모든 것 — 파일, 이미지, CSV, 코드 — 은 아티팩트를 지원하지만 그 자체로는 게시할 수 없습니다.

<ArtifactGrid />

## 만들 수 있는 것

| 유형                                                           | 설명                                   |
| ------------------------------------------------------------ | ------------------------------------ |
| **[웹 앱](/references/artifact-types/web-apps)**               | 사용자, 데이터베이스 등을 처리하는 아름답고 강력한 웹사이트.   |
| **[모바일 앱](/references/artifact-types/building-mobile-apps)** | iPhone 및 Android용 네이티브 앱.            |
| **[슬라이드 덱](/references/artifact-types/slide-decks)**         | 발표하거나 내보낼 수 있는 프레젠테이션 덱.             |
| **[애니메이션](/references/artifact-types/animated-videos)**      | 모션 그래픽 및 애니메이션 비디오. MP4로 내보내기 가능.    |
| **[데이터 시각화](/references/artifact-types/data-apps)**          | 데이터 탐색 및 차트 생성을 위한 인터랙티브 대시보드 및 시각화. |
| **3D 게임**                                                    | 3D 게임, 시뮬레이션, 인터랙티브 경험.              |
| **[디자인](/learn/design/canvas)**                              | 디자인 캔버스에서 탐색한 시각적 방향 및 프로토타입.        |

플랜 가용성은 각 유형의 전용 페이지를 참조하세요.

## 시작하기

Replit 홈페이지에서 만드는 두 가지 방법이 있습니다:

* **설명하기**: 원하는 것을 입력하세요 — "레시피 앱 만들어줘" 또는 "스타트업 피치 덱 만들어줘." Agent가 어떤 유형이 적합한지 파악하고 빌드합니다.
* **유형 선택하기**: 아이디어를 설명하기 전에 원하는 아티팩트 — 웹 앱, 모바일 앱, 데이터 시각화, 애니메이션, 3D 게임, 또는 다른 지원 유형 — 를 선택하세요.

채팅에서 Agent에게 요청하거나 미리 보기 패널의 **+** 버튼을 클릭해 언제든지 기존 프로젝트에 더 추가할 수도 있습니다.

## 아티팩트 간 전환하기

프로젝트에 여러 아티팩트가 있으면 **미리 보기 패널** 또는 **Library 사이드바**에서 전환하세요. Agent에게 물어볼 수도 있습니다 — "모바일 앱 보여줘" 또는 "슬라이드로 전환해줘."

### Library 사이드바

Library 사이드바는 프로젝트의 모든 것을 탐색할 수 있는 중앙 공간을 제공합니다. 아티팩트, Agent가 생성하거나 다운로드한 이미지, 다른 프로젝트 자산을 보여줍니다. 왼쪽 패널에서 Library 사이드바를 열어 프로젝트 전반에 걸쳐 모든 자산을 찾고 재사용하세요.

<Frame>
  <video autoPlay muted loop playsInline src="https://cdn.replit.com/sanity/stock_image_library_compressed.mp4" />
</Frame>

## 하나의 프로젝트에 여러 아티팩트

하나의 프로젝트에 최대 **7개의 아티팩트**를 담을 수 있으며, 프로젝트당 **모바일 앱 1개** 최대 제한이 있습니다. 예를 들어, 고객을 위한 웹 앱, 팀을 위한 모바일 앱, 투자자를 위한 슬라이드 덱을 모두 같은 프로젝트에 빌드할 수 있습니다.

<ArtifactGrid />

### 프로젝트에 아티팩트 추가하기

기존 프로젝트에 아티팩트를 추가하는 세 가지 방법이 있습니다:

* **채팅**: Agent에게 요청하세요 — "이 프로젝트에 모바일 앱 추가해줘" 또는 "투자자 피치 슬라이드 덱 만들어줘"
* **Plus 버튼**: 미리 보기 패널의 **+** 버튼을 클릭하고 빌드하려는 것을 선택하세요
* **Library 사이드바**: 기존 아티팩트, 이미지, 다른 자산을 탐색하고 거기서 새 아티팩트를 추가하세요

### 공유 데이터 및 백엔드

아티팩트가 같은 프로젝트에 있으면 자동으로 동일한 데이터와 백엔드 로직을 공유합니다. 고객이 웹 앱을 통해 주문하면, 모바일 앱과 데이터 대시보드도 그 주문을 바로 확인할 수 있습니다. 연결을 설정하거나 코드를 복제할 필요 없이 바로 작동합니다.

<Note>
  게시하면 전체 프로젝트가 한 번에 배포됩니다. 모든 아티팩트가 함께 활성화되므로 항상 동기화 상태를 유지합니다.
</Note>

### 조합 예시

* **웹 앱 + 모바일 앱**: 고객용 웹 앱과 직원용 모바일 앱이 있는 레스토랑 — 둘 다 동일한 API와 데이터베이스에 연결
* **앱 + 관리자 대시보드**: 콘텐츠, 사용자, 설정 관리를 위한 내부 관리 패널이 함께 있는 주요 제품
* **앱 + 슬라이드 덱**: 슬라이드가 항상 최신 버전을 반영하도록 같은 프로젝트에 있는 제품과 피치 덱
* **데이터 대시보드 + 비디오**: 하이라이트를 설명하는 애니메이션 비디오와 함께하는 라이브 데이터 시각화

## 게시하기

앱, 슬라이드, 비디오 모두 게시하고 공유할 수 있습니다. 배포할 때 각각은 자체 공유 가능한 URL을 갖습니다.

아티팩트가 아닌 파일과 자산(CSV, 이미지, 마크다운 파일 등)은 그 자체로 게시할 수 없습니다. 공유하려면 앱에 추가하거나 새 아티팩트를 만드세요.

## 자주 묻는 질문

<Accordion title="프로젝트에 아티팩트를 하나 이상 가질 수 있나요?">
  예. 하나의 프로젝트에 최대 **7개의 아티팩트**를 담을 수 있으며, **프로젝트당 모바일 앱 1개** 제한이 있습니다. 프로젝트의 모든 아티팩트는 자동으로 동일한 백엔드와 데이터를 공유합니다.

  모바일 앱 제한에 도달하고 두 번째 모바일 앱을 빌드하려면 새 프로젝트에 만드세요. 7개 아티팩트 총 제한에 도달하면, 다른 것을 추가하기 전에 기존 아티팩트를 제거하거나 프로젝트에 걸쳐 작업을 분산하세요.
</Accordion>

<Accordion title="시작하기 전에 유형을 선택해야 하나요?">
  아니요. 원하는 것을 설명하기만 하면 Agent가 올바른 유형을 선택합니다. 원한다면 드롭다운에서 유형을 수동으로 선택할 수도 있습니다.
</Accordion>

<Accordion title="프로젝트에서 아티팩트 하나만 게시할 수 있나요?">
  현재는 불가능합니다. 게시하면 전체 프로젝트가 함께 배포되므로 모든 아티팩트가 동기화 상태를 유지합니다. 독립적인 배포가 필요하면 별도의 프로젝트를 사용하세요.
</Accordion>

<Accordion title="아티팩트끼리 데이터를 공유하나요?">
  예. 프로젝트의 모든 아티팩트는 동일한 데이터베이스와 백엔드 서비스를 공유합니다. 웹 앱이 데이터를 작성하면, 모바일 앱과 데이터 대시보드가 즉시 읽을 수 있습니다.
</Accordion>

<Accordion title="아티팩트와 파일의 차이점은 무엇인가요?">
  아티팩트는 게시할 수 있는 것들 — 앱, 슬라이드, 비디오 — 입니다. 파일(CSV, 이미지, 코드 등)은 프로젝트 내의 자산으로 아티팩트를 지원하지만 그 자체로는 게시할 수 없습니다.
</Accordion>

<Accordion title="내 모바일 앱에 웹 앱의 기능이 빠져 있습니다. 어떻게 된 건가요?">
  Agent가 아티팩트 유형 간에 기능을 변환할 때 일부 기능이 완벽하게 이전되지 않을 수 있습니다 — 특히 플랫폼 간에 다르게 작동하는 상호작용이나 레이아웃. 채팅에서 후속 질문으로 빠진 부분을 채울 수 있습니다.
</Accordion>

빌드할 수 있는 전체 목록은 [프로젝트 개요](/references/projects-and-artifacts/projects)를 참조하세요.
