create-apple-notes-mockup
실제 iPhone 스크린샷처럼 보이는 Apple Notes 화면을 생성합니다 — 올바른 상태 표시줄, 떠 있는 툴바 필, 굵은 제목, 단락 간격이 있는 본문, 노란색 텍스트 커서, 자동 수정 밑줄, 선택적 임베디드 이미지 및 체크리스트, 그리고 선택적 iOS 키보드를 포함합니다.
목적
JSON 노트 명세를 픽셀 정확한 Apple Notes (iPhone, 라이트 모드) 스크린샷으로 변환합니다 — HTML + PNG, 네이티브 1180×2556 해상도 (DPR 2). 이는 create-apple-notes-video-ad 분자가 프레임 단위로 타이핑 애니메이션을 구현하는 데 사용하는 결정론적, LLM 없는 렌더러이며, 광고, 소셜 게시물, 스토리보드에서 일회성 "메모" 비트를 위한 독립형 도구이기도 합니다. 오케스트레이션 에이전트는 콘텐츠를 담당하며, 이 아톰은 시각적 충실도 (상태 표시줄, 스마트 구두점, 커서, 자동 수정 밑줄, 툴바, 키보드 크롬)를 책임집니다.
사용 시기
- 광고, 소셜 게시물, 비디오 장면 또는 제품 모크업을 위해 가짜 Apple Notes 스크린샷이 필요한 경우.
- 타이핑 애니메이션 비디오를 구동하기 위해 Apple Notes 프레임 시퀀스 (제목만 → 단락 추가 → 커서 이동)가 필요한 경우 —
create-apple-notes-video-ad에서 사용됨. - 스토리보드에서 정적 "메모" 비트가 필요한 경우.
iMessage 대화를 렌더링해야 한다면 skills/atoms/messaging/create-imessage-mockup을 대신 사용하세요.
입력
이 스킬은 결정론적입니다 — LLM을 내장하지 않습니다. 오케스트레이션 에이전트가 아래 스키마에 맞는 노트 JSON을 구성한 후 렌더러를 호출합니다.
노트 JSON 스키마
{
"title": "안녕하세요",
"body": [
{ "type": "paragraph", "text": "이것은 제가 Apple Notes 앱에 입력하는 화면 녹화입니다." },
{ "type": "paragraph", "text": "이것이 어떤 느낌인지 봅시다." }
],
"cursor": "end",
"autocorrect_underline": ["이것", "어떤"],
"status_bar": {
"time": "9:41",
"battery_pct": 87,
"battery_low": false,
"show_focus_glyph": false
},
"show_keyboard": false,
"keyboard_state": {
"suggestions": ["see", "go", "do"],
"shift": "lower",
"letters_row1": "qwertyuiop",
"letters_row2": "asdfghjkl",
"letters_row3": "zxcvbnm"
},
"with_iphone_frame": false
}
title— 문자열. 굵은 표시 헤드라인, 한 줄.body[]— 블록 목록. 지원되는 블록 유형:paragraph—{ "text": "..." }. 스마트 구두점이 자동 적용됩니다 ('→',"→",...→…,--→–,---→—).image—{ "src": "<경로|URL>", "caption": "선택사항" }. 상대 경로는 명세 파일의 디렉토리를 기준으로 확인되며 데이터 URI로 인라인 처리됩니다.checklist—{ "items": [{ "text": "...", "checked": true|false }] }. 체크된 항목은 노란색 채워진 원과 취소선이 표시되고, 체크되지 않은 항목은 회색 윤곽선 원이 표시됩니다.divider— 수평선.
cursor—"title" | "end" | null."title"은 제목 끝에 노란색 캐럿을 배치하고,"end"는 마지막 단락 끝에 배치하며,null은 숨깁니다.autocorrect_underline[]— 정확한 대소문자 단어 목록. 각 항목은 Apple Notes 입력 중 노란색 밑줄 (<span class="spell">)을 얻습니다.status_bar—time,battery_pct(0–100),battery_low(배터리 빨간색),show_focus_glyph(시간 옆 DND/자동차 아이콘). Dynamic Island는 렌더링되지 않습니다.show_keyboard—true이면 iOS QWERTY + 포맷팅 툴바를 오버레이합니다.keyboard_state—show_keyboard가true일 때만 사용됩니다.shift="lower" | "upper".with_iphone_frame— 얇은 어두운 베젤 인셋을 추가합니다 (히어로 구성용).
CLI
node render.js --note examples/mid.json
node render.js --note examples/long.json --output ./my-exports/ --name todays-note
node render.js --note my-note.json --with-keyboard
node render.js --note my-note.json --viewport 1080x1920 # 9:16 광고 제공 크기
플래그
| 플래그 | 효과 |
|---|---|
--note <경로> | (필수) 위 스키마와 일치하는 JSON 파일 |
--with-keyboard | show_keyboard를 강제 활성화 (명세를 재정의함) |
--with-iphone-frame | 하드웨어 베젤을 강제 활성화 |
--no-frame | 하드웨어 베젤을 강제 비활성화 |
--output <디렉토리> | 날짜가 포함된 출력 폴더의 상위 디렉토리; 기본값 ./apple-notes-mockup-exports/ |
--name <슬러그> | 출력 폴더 슬러그 재정의 |
--out-html <경로> / --out-png <경로> | 명시적 경로에 직접 쓰기 (날짜 폴더 건너뜀) |
--viewport WxH | 렌더 뷰포트 재정의 (기본값 1180x2556) |
--dpr N | 장치 픽셀 비율 (기본값 2) |
출력
<출력>/<YYYY-MM-DD>-<슬러그>/
index.html # 완전한 독립형 HTML (이미지는 데이터 URI로 인라인 처리됨)
screenshot.png # 선택한 뷰포트 × DPR로 렌더링된 PNG
spec.json # 재현성을 위한 입력 복사본
기본 <출력>은 cwd의 ./apple-notes-mockup-exports/입니다.
워크플로우
- 프롬프트 또는 기존 노트 JSON을 받습니다.
- 프롬프트만 주어진 경우: 스키마와 일치하는
note.json을 작성하고 저장합니다. node render.js --note <경로> [--with-keyboard]를 실행합니다.- 결과 PNG를 열어 레이아웃을 확인합니다. 무언가 잘못 보이면 (잘못된 줄바꿈, 잘못된 커서 위치, 잘못된 배터리 색상), JSON을 편집하고 다시 렌더링합니다.
설정 (일회성)
cd create-apple-notes-mockup
npm install
npx playwright install chromium
create-imessage-mockup/node_modules에 대한 심볼릭 링크가 리포지토리와 함께 제공되므로, 새 클론에서 npm install은 이 스킬을 독립적으로 실행하려는 경우에만 필요합니다.
파일
| 파일 | 목적 |
|---|---|
render.js | CLI 진입점 — 플래그 파싱, 이미지 경로 해석, HTML 생성, 스크린샷 촬영 |
generate.js | 노트 JSON → 독립형 HTML 페이지 (여기서 스마트 구두점 + 자동 수정 밑줄 적용) |
screenshot.js | HTML → PNG via Playwright (chromium headless) at 1180×2556, DPR 2 |
templates/note.css | 모든 시각적 스타일링 (상태 표시줄, 툴바, 본문, 체크리스트, 이미지, 키보드) |
templates/icons.js | 인라인 SVG 아이콘 (뒤로가기 쉐브론, 실행 취소, 공유, 더 보기, 완료 체크, 신호, 와이파이, 배터리, 포맷 툴바 아이콘, 키보드 글리프) |
assets/samples/sample-landscape.jpg | examples/with-image.json에서 사용되는 샘플 이미지 |
examples/*.json | 모든 변형을 다루는 6개의 참조 노트 (제목만, 입력 중, 긴 다중 단락, 체크리스트 포함, 이미지 포함, 프레임-1 소문자 키보드) |
tests/run-all.sh | 모든 예제를 tests/output/에 렌더링하여 시각적 검토 |
apple-notes-skill-build.html | 참조 비디오 프레임과 생성된 PNG를 비교하는 나란히 보기 리뷰 보드 |
품질 검사
노트를 출시 가능하다고 선언하기 전에:
- 제목은 일반 굵기가 아닌 굵은 표시 헤드라인으로 렌더링됩니다.
- 본문 텍스트는 Apple의 스마트 구두점을 사용합니다 —
'는 둥근 따옴표,"는 둥근 따옴표,…는 단일 문자입니다. - 노란색 커서 (
#FFCC00)가 대상 텍스트 끝에 약 5px 너비로 깔끔하게 위치합니다. - 본문 단락은 하나의 빈 시각적 줄로 구분됩니다 (수동
<br>없음). - 자동 수정 밑줄은 플래그된 토큰 아래에 짧은 노란색 줄로, 대소문자를 구분하여 일치합니다.
- 상태 표시줄: 시간은 왼쪽, 신호/와이파이/배터리는 오른쪽.
battery_low: true인 경우에만 배터리가 빨간색입니다. Dynamic Island 없음. - 스크롤 마스크: 상태 표시줄과 툴바는 불투명한 흰색 배경을 가지므로, 분자의 드라이버가 스크롤하는 본문 콘텐츠가 비쳐 보이지 않습니다. DevTools에서
.note를-300px만큼 변환하고 제목이 툴바에 완전히 가려져 뒤/사이로 보이지 않는지 확인하여 검증합니다. - 툴바: 왼쪽에 떠 있는 뒤로가기 쉐브론 필, 흰색 캡슐 (실행취소/공유/더보기), 오른쪽에 노란색 완료 원. 모두 부드러운 그림자를 드리웁니다.
- 키보드 (활성화된 경우): QWERTY 레이아웃이
shift대소문자와 일치, 제안 스트립에 3개의 단어 표시, 키 위에 포맷팅 툴바 필, 하단에 마이크 + 지구본. - 이미지 블록은 둥근 모서리 (~18px)로 렌더링되고 본문 왼쪽 패딩을 존중합니다.
- 체크리스트: 체크된 항목은 노란색 채워진 원 + 취소선, 그 외는 회색 윤곽선 원.
실패 모드
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 본문 텍스트가 한 단어 너무 빨리 또는 너무 늦게 줄바꿈됨 | 글꼴 너비가 참조와 다름 (Chromium이 SF가 아닌 폴백을 선택함) | .note-body의 font-size를 2px 단위로 조정하거나, 왼쪽/오른쪽 패딩을 줄여 .note 너비를 늘림 |
| 제목이 얇게 / 충분히 굵지 않게 보임 | 호스트에 SF Pro Display가 없어서 시스템이 더 가벼운 폴백을 사용함 | font-weight: 900으로 설정 (이미 기본값)하고 `fc-list |
| "Hello's", "Let's"가 직선 따옴표로 렌더링됨 | 스마트 구두점 전처리기가 비활성화됨 | generate.js에서 escapeHtml 전에 smartQuotes()가 호출되는지 확인 |
| 이미지가 렌더링되지 않음 (빈 공간) | 원격 URL이 차단되었거나 상대 경로가 확인되지 않음 | 로컬 파일 경로 사용; render.js가 로컬 이미지를 base64로 인라인 처리함 |
| "this"만 의도했는데 "This"도 자동 수정 밑줄이 일치함 | 정규식이 대소문자를 구분하지 않음 | 정규식은 기본적으로 대소문자를 구분합니다. autocorrect_underline에 정확한 대소문자 문자열을 전달하세요 |
| 빈 단락이 축소됨 (커서 공간 없음) | 내용이 없는 <p class="note-paragraph"></p>는 높이가 0입니다 | CSS는 margin: 0 0 84px 0을 설정하므로 빈 단락도 하나의 단락 간격을 차지합니다. 후행 여백을 제거하지 않았는지 확인하세요 |
| 노란색 완료 원이 주황색으로 보임 | CSS 색상 표류 | 순수 Apple 노란색은 #FFCC00입니다. 커서와 완료가 이 값을 공유합니다. #FFC107 (Material amber)로 변경하지 마세요 |
| 키보드 제안 "Hello's"가 직선 아포스트로피로 렌더링됨 | 스마트 따옴표가 제안에 적용되지 않음 | generate.js에서 smartQuotes(s)를 통해 적용됨을 확인함 |
참조
시각적 명세는 apple-notes-typing.MP4 (Apple Notes에 라이트 모드로 입력하는 36초 iPhone 화면 녹화)에서 추출되었습니다. 이 폴더의 apple-notes-skill-build.html에서 나란히 보기 증명을 확인하세요 — 각 예제가 대상 참조 프레임과 함께 표시됩니다.