O que criar-maquete-apple-notes faz?
Gere telas do Apple Notes que parecem capturas de tela reais de iPhone — barra de status correta, pílula de ferramenta flutuante, título em negrito, texto do corpo com espaçamento entre parágrafos, cursor de texto amarelo, sublinhado de autocorreção, imagens e listas de verificação opcionais, e um teclado iOS opcional.
Propósito
Transforme uma especificação JSON de nota em uma captura de tela do Apple Notes (iPhone, modo claro) com precisão de pixels — HTML + PNG na resolução nativa de 1180×2556 (DPR 2). É o renderizador determinístico, sem LLM, que a molécula create-apple-notes-video-ad aciona quadro a quadro para simular uma animação de digitação, e também uma ferramenta independente para criar cenas únicas de "lembrete pessoal" em anúncios, posts em redes sociais e storyboards. O agente orquestrador é responsável pelo texto; esta skill é responsável pela fidelidade visual (barra de status, pontuação inteligente, cursor, sublinhado de autocorreção, barra de ferramentas, teclado).
Quando usar
- Precisar de uma captura de tela falsa do Apple Notes para um anúncio, post em rede social, cena de vídeo ou maquete de produto.
- Precisar de uma sequência de quadros do Apple Notes (apenas título → adicionando parágrafos → movendo cursor) para gerar uma animação de digitação em vídeo — usado por
create-apple-notes-video-ad. - Precisar de uma cena estática de "lembrete pessoal" em um storyboard.
Se você estiver renderizando uma conversa do iMessage, use skills/atoms/messaging/create-imessage-mockup.
Entradas
A skill é determinística — ela não incorpora um LLM. O agente orquestrador compõe um JSON de nota de acordo com o esquema abaixo e então invoca o renderizador.
Esquema JSON da nota
{
"title": "Olá",
"body": [
{ "type": "paragraph", "text": "Esta é uma gravação de tela de mim digitando no aplicativo Apple Notes." },
{ "type": "paragraph", "text": "Vamos ver como isso se sente." }
],
"cursor": "end",
"autocorrect_underline": ["esta", "como"],
"status_bar": {
"time": "9:41",
"battery_pct": 87,
"battery_low": false,
"show_focus_glyph": false
},
"show_keyboard": false,
"keyboard_state": {
"suggestions": ["ver", "ir", "fazer"],
"shift": "lower",
"letters_row1": "qwertyuiop",
"letters_row2": "asdfghjkl",
"letters_row3": "zxcvbnm"
},
"with_iphone_frame": false
}
title— string. Cabeçalho de exibição em negrito, linha única.body[]— lista de blocos. Tipos de bloco suportados:paragraph—{ "text": "..." }. Pontuação inteligente é aplicada automaticamente ('→',"→",...→…,--→–,---→—).image—{ "src": "<caminho|url>", "caption": "opcional" }. Caminhos relativos são resolvidos em relação ao diretório do arquivo de especificação e incorporados como URIs de dados.checklist—{ "items": [{ "text": "...", "checked": true|false }] }. Itens marcados recebem círculos amarelos preenchidos com tachado; itens desmarcados recebem círculos com contorno cinza.divider— linha horizontal.
cursor—"title" | "end" | null."title"coloca o cursor amarelo no final do título;"end"coloca no final do último parágrafo;nullo oculta.autocorrect_underline[]— lista de palavras com maiúsculas/minúsculas exatas. Cada ocorrência recebe o sublinhado amarelo de digitação do Apple Notes (<span class="spell">).status_bar—time,battery_pct(0–100),battery_low(bateria vermelha),show_focus_glyph(ícone de N Perturbe/carro ao lado da hora). Ilha Dinâmica não é renderizada.show_keyboard—truesobrepõe o teclado QWERTY do iOS + barra de formatação.keyboard_state— só é consultado quandoshow_keyboardé true.shift="lower" | "upper".with_iphone_frame— adiciona uma borda fina e escura (para composições de banner).
CLI
node render.js --note examples/medio.json
node render.js --note examples/longo.json --output ./meus-exports/ --name nota-de-hoje
node render.js --note minha-nota.json --with-keyboard
node render.js --note minha-nota.json --viewport 1080x1920 # tamanho de entrega de anúncio 9:16
Flags
| Flag | Efeito |
|---|---|
--note <caminho> | (obrigatório) Arquivo JSON correspondente ao esquema acima |
--with-keyboard | força a ativação de show_keyboard (sobrescreve a especificação) |
--with-iphone-frame | força a ativação da moldura de hardware |
--no-frame | força a desativação da moldura de hardware |
--output <dir> | diretório pai para a pasta de saída com data; padrão ./apple-notes-mockup-exports/ |
--name <slug> | sobrescreve o slug da pasta de saída |
--out-html <caminho> / --out-png <caminho> | escreve diretamente em caminhos explícitos (ignora a pasta com data) |
--viewport LxA | sobrescreve o viewport de renderização (padrão 1180x2556) |
--dpr N | proporção de pixels do dispositivo (padrão 2) |
Saída
<saída>/<AAAA-MM-DD>-<slug>/
index.html # HTML completo independente (imagens incorporadas como URIs de dados)
screenshot.png # PNG renderizado no viewport escolhido × DPR
spec.json # cópia da entrada para reprodutibilidade
O <saída> padrão é ./apple-notes-mockup-exports/ no diretório de trabalho atual.
Fluxo de trabalho
- Receber um prompt ou um JSON de nota existente.
- Se apenas um prompt foi fornecido: compor um
note.jsonde acordo com o esquema, salvá-lo. - Executar
node render.js --note <caminho> [--with-keyboard]. - Abrir o PNG resultante para verificar o layout. Se algo parecer errado (quebra de linha incorreta, posição do cursor errada, cor da bateria errada), editar o JSON e renderizar novamente.
Configuração (única)
cd criar-maquete-apple-notes
npm install
npx playwright install chromium
Um link simbólico para create-imessage-mockup/node_modules acompanha o repositório, portanto, em um clone novo, npm install só é necessário se você quiser que esta skill seja autossuficiente.
Arquivos
| Arquivo | Propósito |
|---|---|
render.js | Ponto de entrada CLI — analisa flags, resolve caminhos de imagem, gera HTML, captura tela |
generate.js | Nota JSON → página HTML independente (pontuação inteligente e sublinhado de autocorreção aplicados aqui) |
screenshot.js | HTML → PNG via Playwright (chromium headless) em 1180×2556, DPR 2 |
templates/note.css | Todo o estilo visual (barra de status, barra de ferramentas, corpo, lista de verificação, imagem, teclado) |
templates/icons.js | Ícones SVG embutidos (chevron voltar, desfazer, compartilhar, mais, concluído, sinal, wifi, bateria, ícones de barra de formatação, glifos de teclado) |
assets/samples/sample-landscape.jpg | Imagem de amostra usada por examples/with-image.json |
examples/*.json | 6 notas de referência cobrindo todas as variações (apenas título, digitação intermediária, vários parágrafos longos, com lista de verificação, com imagem, quadro-1 teclado minúsculo) |
tests/run-all.sh | Renderiza cada exemplo em tests/output/ para revisão visual |
apple-notes-skill-build.html | Quadro de revisão lado a lado comparando quadros de vídeo de referência com PNGs gerados |
Verificações de qualidade
Antes de declarar uma nota pronta para uso:
- O título é renderizado como cabeçalho de exibição em negrito, não peso normal.
- O texto do corpo usa pontuação inteligente da Apple —
'é curvo,"é curvo,…é um único caractere. - O cursor amarelo (
#FFCC00) está alinhado ao final do texto alvo, com aproximadamente 5px de largura. - Os parágrafos do corpo são separados por uma linha visual vazia (sem
<br>manual). - Os sublinhados de autocorreção são linhas amarelas curtas alinhadas sob o token sinalizado, com correspondência de maiúsculas/minúsculas.
- Barra de status: hora à esquerda, sinal/wifi/bateria à direita. A bateria é vermelha somente se
battery_low: true. Sem Ilha Dinâmica. - Máscara de rolagem: a barra de status e a barra de ferramentas têm fundos brancos opacos para que o conteúdo do corpo rolado pelo driver da molécula não apareça. Verifique traduzindo
.noteem-300pxno DevTools e confirmando que o título está totalmente mascarado pela barra de ferramentas — não visível atrás/através dela. - Barra de ferramentas: pílula de chevron voltar flutuante (esquerda), cápsula branca com desfazer/compartilhar/mais, círculo amarelo Concluído (direita). Todos com sombras suaves.
- Teclado (quando ativado): layout QWERTY corresponde à capitalização
shift, faixa de sugestão mostra 3 palavras, pílula de barra de formatação acima das teclas, microfone + globo na parte inferior. - Blocos de imagem são renderizados com cantos arredondados (~18px) e respeitam o preenchimento esquerdo do corpo.
- Lista de verificação: círculos amarelos preenchidos + tachado em itens marcados; círculos com contorno cinza caso contrário.
Modos de falha
| Sintoma | Causa | Correção |
|---|---|---|
| O texto do corpo quebra uma palavra muito cedo ou muito tarde | A largura da fonte difere da referência (Chromium usou uma fonte substituta não-SF) | Ajuste o font-size em .note-body em etapas de 2px, ou aumente .note reduzindo o preenchimento esquerdo/direito |
| O título parece fino / não suficientemente em negrito | O host não possui SF Pro Display; o sistema usa uma face mais clara | Defina font-weight: 900 (já é o padrão) e verifique `fc-list |
| "Olá's", "Vamos's" são renderizados com aspas retas | O pré-processador de pontuação inteligente está desabilitado | Verifique se smartQuotes() é chamado em generate.js antes de escapeHtml |
| A imagem não renderiza (espaço em branco) | URL remota bloqueada ou caminho relativo não resolvido | Use um caminho de arquivo local; render.js incorpora imagens locais como base64 |
| O sublinhado de autocorreção também corresponde a "Esta" quando apenas "esta" era pretendido | Regex era insensível a maiúsculas/minúsculas | A regex é sensível a maiúsculas/minúsculas por padrão. Passe strings com maiúsculas/minúsculas exatas em autocorrect_underline |
| Parágrafo vazio colapsa (sem espaço para cursor) | <p class="note-paragraph"></p> sem conteúdo tem altura zero | O CSS define margin: 0 0 84px 0, então um parágrafo vazio ainda ocupa um espaçamento de parágrafo; certifique-se de não remover a margem inferior |
| Círculo amarelo Concluído parece laranja | Desvio de cor CSS | O amarelo puro da Apple é #FFCC00. O cursor e Concluído compartilham o valor; não altere para #FFC107 (âmbar Material) |
| Sugestão de teclado "Olá's" renderiza com apóstrofo reto | Aspas inteligentes não aplicadas às sugestões | Confirmado que é aplicado via smartQuotes(s) em generate.js |
Referência
A especificação visual foi extraída de apple-notes-typing.MP4 (uma gravação de tela de 36 segundos de um iPhone digitando no Apple Notes em modo claro). Veja apple-notes-skill-build.html nesta pasta para a prova lado a lado — cada exemplo é mostrado ao lado do quadro de referência que ele visa.