# miri.dev 배포 가이드

## 개요

[miri.dev](https://www.miri.dev)는 정적 웹사이트를 드래그 앤 드롭 또는 API POST 요청으로 즉시 배포할 수 있는 무료 호스팅 플랫폼이다.

- 운영: BaryonLabs Inc.
- CDN: Cloudflare 글로벌 CDN
- HTTPS: 자동 SSL 인증서 발급
- 커스텀 도메인: DNS CNAME 연결 지원

---

## 방법 1: 웹 브라우저 (드래그 앤 드롭)

1. https://www.miri.dev 접속
2. 카카오 또는 네이버로 로그인
3. 업로드 영역에 파일(HTML, CSS, JS, 이미지 등)을 드래그 앤 드롭
4. 업로드 완료 시 `https://[랜덤ID].miri.dev` URL 즉시 생성
5. 마이페이지에서 프로젝트로 등록하면 영구 서브도메인 부여 (`https://[프로젝트명]-[ID].miri.dev`)

---

## 방법 2: API (curl / CLI)

### 엔드포인트

```
POST https://www.miri.dev/api/deploy
Content-Type: multipart/form-data
```

### 파라미터

| 필드 | 설명 |
|------|------|
| `files` | 업로드할 파일 (여러 개 가능, 각각 `-F "files=@경로"`) |

### 사용 예시

**단일 파일 배포:**

```bash
curl -X POST https://www.miri.dev/api/deploy \
  -F "files=@index.html"
```

**여러 파일 배포:**

```bash
curl -X POST https://www.miri.dev/api/deploy \
  -F "files=@index.html" \
  -F "files=@style.css" \
  -F "files=@script.js"
```

### 응답 예시

```json
{
  "success": true,
  "site": {
    "id": "a798f89d-ca59-469c-8a66-fcb4301b1caf",
    "url": "https://a798f89d.miri.dev",
    "expiresAt": "2026-03-29T17:11:35.393Z",
    "title": "페이지 타이틀"
  },
  "message": "3 files successfully deployed"
}
```

### 응답 필드

| 필드 | 설명 |
|------|------|
| `success` | 배포 성공 여부 |
| `site.id` | 사이트 고유 ID |
| `site.url` | 배포된 사이트 URL |
| `site.expiresAt` | 만료 일시 (임시 배포) |
| `site.title` | HTML `<title>` 태그에서 추출된 제목 |

---

## 참고 사항

- API로 배포 시 로그인 없이 즉시 배포 가능하나 임시 배포로 만료 기한이 있다.
- 영구 배포를 원하면 웹사이트에서 로그인 후 프로젝트로 등록해야 한다.
- `index.html`이 반드시 포함되어야 사이트가 정상 작동한다.
- 폴더 구조(하위 디렉토리)가 필요한 경우 웹 UI를 통해 업로드한다.