# 새로온 개발자 센터 (developers.saeroon.com)

> 새로온 호스팅은 HTML·CSS·JS 정적 사이트를 CLI 한 줄로 배포하고, HTML 의 `data-saeroon-*` 속성만으로 문의 폼·회원·게시판·장바구니를 붙이는 정적 호스팅 서비스입니다. 아래 모든 문서는 URL 끝에 `.md` 를 붙이면 마크다운 원문으로 받을 수 있습니다.

한 줄 정의: 새로온 호스팅은 AI가 만든 화면 아래에 결제·예약·회원이 이미 돌아가는 상태로 붙는 웹사이트·앱 백엔드 호스팅입니다. 화면을 올리는 건 명령 한 줄이고, 그 뒤에 붙는 기능은 미리 만들어 실제 서비스에서 검증해 뒀습니다.

## 시작하기
- [Quickstart](https://developers.saeroon.com/docs/quickstart.md): 가입부터 첫 배포·발행까지 — 정적 사이트를 라이브 URL로 올리는 전체 흐름.

## 기능 붙이기
- [Forms](https://developers.saeroon.com/docs/forms.md): data-saeroon-form 한 줄로 문의 폼을 붙이고 제출을 대시보드에서 받기.
- [Members](https://developers.saeroon.com/docs/members.md): 회원가입·로그인·프로필·등급 조건부 노출을 data-saeroon 속성으로.
- [Boards](https://developers.saeroon.com/docs/boards.md): 게시판 목록·상세·글쓰기·댓글을 붙이기 — data-board-id(GUID) 필수.
- [Shop](https://developers.saeroon.com/docs/shop.md): 장바구니 담기·카트 배지를 data-saeroon 속성으로, 결제는 shop SDK로.
- [Catalogs](https://developers.saeroon.com/docs/catalogs.md): 사이트가 소유하는 이름 붙은 목록 — 도감·배지·장비처럼 다른 기록이 가리킬 대상.
- [Groups](https://developers.saeroon.com/docs/groups.md): 회원이 모임을 만들고 가입하는 구조 — 운영 규칙과 직위 어휘를 사이트가 정한다.
- [Holdings](https://developers.saeroon.com/docs/holdings.md): 회원이 카탈로그에서 가진 것을 기록하고, 그룹이 서로에게 표식을 남기는 회원 평면.

## 앱 붙이기
- [앱 백엔드 붙이기](https://developers.saeroon.com/docs/app-backend.md): iOS·Android 네이티브 앱을 새로온 백엔드에 연결하는 흐름 — 키 발급, 게시판 시드(CLI·MCP), 소셜 로그인, 피드 읽기·쓰기, 신고·차단, 계정 삭제.

## 레퍼런스
- [속성 계약 (data-saeroon-*)](https://developers.saeroon.com/docs/attributes.md): 정적 사이트에 회원·게시판·댓글·쇼핑·폼을 붙이는 data-* 속성 전수표 — 코드에서 자동 생성
- [CLI 레퍼런스 (@saeroon/cli)](https://developers.saeroon.com/docs/cli.md): 공개 CLI 전 커맨드 표 — 코드 등록부에서 자동 생성
- [API](https://developers.saeroon.com/docs/api.md): API 키 체계 — 비밀 키(sk_live_)와 공개 키(pk_live_), 인증 헤더.
- [MCP](https://developers.saeroon.com/docs/mcp.md): IDE 에이전트를 새로온에 연결하기 — 원격 HTTP + OAuth.

## 마켓플레이스
- [Marketplace](https://developers.saeroon.com/docs/marketplace.md): 만든 사이트를 템플릿으로 등록·심사·게시하기.

## Instructions for LLM Agents
- 기본 제작 방식은 **정적 트랙**입니다. HTML·CSS·JS 를 직접 만들고 `npx @saeroon/cli deploy <folder>` 로 배포하세요.
- 기능(폼·회원·게시판·장바구니)은 HTML 요소에 `data-saeroon-*` 속성을 선언해 붙입니다. 속성 전수표는 위 레퍼런스의 Attributes 문서를 fetch 해 확인하세요.
- 게시판 관련 속성(`data-saeroon-post-list` · `data-saeroon-post-create`)에는 게시판 GUID 를 담는 `data-board-id` 가 반드시 필요합니다.
- 블록/스키마 카탈로그 기반 API 는 구(legacy) 스키마 사이트 전용입니다. 신규 정적 사이트 제작에는 사용하지 마세요.
- 제작 규약 한 장 요약이 필요하면 https://developers.saeroon.com/prompt.md 를 fetch 하세요.