¿Qué hace generar-maqueta-apple-notes?
Genera pantallas de Apple Notes que parecen capturas de pantalla de iPhone reales: barra de estado correcta, píldora flotante de la barra de herramientas, título en negrita, texto del cuerpo con espacio entre párrafos, cursor de texto amarillo, subrayado de autocorrección, imágenes incrustadas opcionales y listas de verificación, y un teclado iOS opcional.
Propósito
Convierte una especificación JSON de nota en una captura de pantalla de Apple Notes (iPhone, modo claro) con precisión de píxeles — HTML + PNG en la resolución nativa 1180×2556 (DPR 2). Es el renderizador determinista (sin LLM) que la molécula create-apple-notes-video-ad utiliza fotograma a fotograma para simular una animación de escritura, y una herramienta independiente para crear imágenes de notas rápidas ('noted to self') en anuncios, publicaciones en redes sociales y storyboards. El agente orquestador es dueño del texto; este átomo es dueño de la fidelidad visual (barra de estado, puntuación inteligente, cursor, subrayado de autocorrección, barra de herramientas, teclado).
Cuándo usarlo
- Necesitas una captura de pantalla falsa de Apple Notes para un anuncio, publicación en redes sociales, escena de video o maqueta de producto.
- Necesitas una secuencia de fotogramas de Apple Notes (solo título → agregar párrafos → mover cursor) para impulsar un video de animación de escritura — utilizado por
create-apple-notes-video-ad. - Necesitas una imagen estática de una nota rápida ('noted to self') en un storyboard.
Si estás renderizando un hilo de iMessage, usa skills/atoms/messaging/create-imessage-mockup.
Entradas
La habilidad es determinista — no incorpora un LLM. El agente orquestador compone un JSON de nota que coincide con el esquema siguiente y luego invoca el renderizador.
Esquema JSON de la nota
{
"title": "Hola",
"body": [
{ "type": "paragraph", "text": "Esta es una grabación de pantalla de mí escribiendo en la aplicación de notas de Apple." },
{ "type": "paragraph", "text": "Veamos cómo se siente esto." }
],
"cursor": "end",
"autocorrect_underline": ["esta", "cómo"],
"status_bar": {
"time": "9:41",
"battery_pct": 87,
"battery_low": false,
"show_focus_glyph": false
},
"show_keyboard": false,
"keyboard_state": {
"suggestions": ["ver", "ir", "hacer"],
"shift": "lower",
"letters_row1": "qwertyuiop",
"letters_row2": "asdfghjkl",
"letters_row3": "zxcvbnm"
},
"with_iphone_frame": false
}
title— cadena. Título de visualización en negrita, una sola línea.body[]— lista de bloques. Tipos de bloque compatibles:paragraph—{ "text": "..." }. La puntuación inteligente se aplica automáticamente ('→',"→",...→…,--→–,---→—).image—{ "src": "<ruta|url>", "caption": "opcional" }. Las rutas relativas se resuelven con respecto al directorio del archivo de especificación y se incrustan como data URIs.checklist—{ "items": [{ "text": "...", "checked": true|false }] }. Los elementos marcados obtienen círculos rellenos amarillos con tachado; los no marcados obtienen círculos con contorno gris.divider— regla horizontal.
cursor—"title" | "end" | null."title"coloca el cursor amarillo al final del título;"end"lo coloca al final del último párrafo;nulllo oculta.autocorrect_underline[]— lista de palabras con mayúsculas exactas. Cada ocurrencia obtiene el subrayado amarillo de escritura intermedia de Apple Notes (<span class="spell">).status_bar—time,battery_pct(0–100),battery_low(color de batería rojo),show_focus_glyph(icono de DND/coche al lado de la hora). La Isla Dinámica no se renderiza.show_keyboard—truesuperpone el teclado QWERTY de iOS + la barra de herramientas de formato.keyboard_state— solo se consulta cuandoshow_keyboardes true.shift="lower" | "upper".with_iphone_frame— agrega un bisel oscuro delgado (para composiciones destacadas).
CLI
node render.js --note examples/medio.json
node render.js --note examples/largo.json --output ./mis-exportes/ --name nota-de-hoy
node render.js --note mi-nota.json --with-keyboard
node render.js --note mi-nota.json --viewport 1080x1920 # tamaño de entrega de anuncio 9:16
Banderas
| Bandera | Efecto |
|---|---|
--note <ruta> | (requerido) Archivo JSON que coincide con el esquema anterior |
--with-keyboard | fuerza la habilitación de show_keyboard (anula la especificación) |
--with-iphone-frame | fuerza el bisel de hardware |
--no-frame | fuerza la desactivación del bisel de hardware |
--output <dir> | directorio padre para la carpeta de salida con fecha; por defecto ./apple-notes-mockup-exports/ |
--name <slug> | anula el slug de la carpeta de salida |
--out-html <ruta> / --out-png <ruta> | escribe directamente en rutas explícitas (omite la carpeta con fecha) |
--viewport WxH | anula el viewport de renderizado (por defecto 1180x2556) |
--dpr N | relación de píxeles del dispositivo (por defecto 2) |
Salida
<salida>/<YYYY-MM-DD>-<slug>/
index.html # HTML completo independiente (imágenes incrustadas como data URIs)
screenshot.png # PNG renderizado en el viewport elegido × DPR
spec.json # copia de la entrada para reproducibilidad
La <salida> predeterminada es ./apple-notes-mockup-exports/ en el directorio de trabajo actual.
Flujo de trabajo
- Recibe un prompt o un JSON de nota existente.
- Si solo se dio un prompt: compone un
note.jsonque coincida con el esquema, guárdalo. - Ejecuta
node render.js --note <ruta> [--with-keyboard]. - Abre el PNG resultante para verificar el diseño. Si algo se ve mal (salto de línea incorrecto, posición del cursor incorrecta, color de batería incorrecto), edita el JSON y vuelve a renderizar.
Configuración (única vez)
cd create-apple-notes-mockup
npm install
npx playwright install chromium
Se incluye un enlace simbólico a create-imessage-mockup/node_modules en el repositorio, por lo que en un clon nuevo npm install solo es necesario si deseas que esta habilidad sea autónoma.
Archivos
| Archivo | Propósito |
|---|---|
render.js | Punto de entrada CLI — analiza banderas, resuelve rutas de imágenes, genera HTML, toma captura de pantalla |
generate.js | JSON de nota → página HTML independiente (la puntuación inteligente y el subrayado de autocorrección se aplican aquí) |
screenshot.js | HTML → PNG a través de Playwright (chromium headless) a 1180×2556, DPR 2 |
templates/note.css | Todos los estilos visuales (barra de estado, barra de herramientas, cuerpo, lista de verificación, imagen, teclado) |
templates/icons.js | Iconos SVG incrustados (chevron de retroceso, deshacer, compartir, más, check de hecho, señal, wifi, batería, iconos de barra de herramientas de formato, glifos de teclado) |
assets/samples/sample-landscape.jpg | Imagen de muestra utilizada por examples/with-image.json |
examples/*.json | 6 notas de referencia que cubren todas las variaciones (solo título, escritura intermedia, párrafo largo múltiple, con lista de verificación, con imagen, fotograma-1 teclado en minúsculas) |
tests/run-all.sh | Renderiza cada ejemplo en tests/output/ para revisión visual |
apple-notes-skill-build.html | Tablero de revisión lado a lado que compara fotogramas de video de referencia con PNG generados |
Controles de calidad
Antes de declarar una nota como lista para usar:
- El título se renderiza como título de visualización en negrita, no con peso regular.
- El texto del cuerpo usa la puntuación inteligente de Apple:
'es curvada,"es curvada,…es un solo carácter. - El cursor amarillo (
#FFCC00) se coloca al final del texto de destino, de ~5px de ancho. - Los párrafos del cuerpo están separados por una línea visual vacía (sin
<br>manual). - Los subrayados de autocorrección son líneas amarillas cortas debajo del token marcado, con coincidencia sensible a mayúsculas.
- Barra de estado: hora a la izquierda, señal/wifi/batería a la derecha. La batería es roja solo si
battery_low: true. Sin Isla Dinámica. - Máscara de desplazamiento: la barra de estado y la barra de herramientas tienen fondos blancos opacos para que el contenido del cuerpo desplazado por el controlador de la molécula no se vea a través. Verifica traduciendo
.noteen-300pxen DevTools y confirmando que el título está completamente enmascarado por la barra de herramientas, no visible detrás/de ella. - Barra de herramientas: píldora flotante de chevron de retroceso (izquierda), cápsula blanca con deshacer/compartir/más, círculo amarillo de Hecho (derecha). Todos proyectan sombras suaves.
- Teclado (cuando está habilitado): diseño QWERTY que coincide con las mayúsculas de
shift, tira de sugerencias muestra 3 palabras, píldora de barra de herramientas de formato sobre las teclas, micrófono + globo en la parte inferior. - Los bloques de imagen se renderizan con esquinas redondeadas (~18px) y respetan el padding izquierdo del cuerpo.
- Lista de verificación: círculos rellenos amarillos + tachado en elementos marcados; círculos de contorno gris en caso contrario.
Modos de fallo
| Síntoma | Causa | Solución |
|---|---|---|
| El texto del cuerpo se divide una palabra demasiado pronto o demasiado tarde | El ancho de la fuente difiere de la referencia (Chromium eligió una fuente alternativa que no es SF) | Ajusta font-size en .note-body en pasos de 2px, o ensancha .note reduciendo el padding izquierdo/derecho |
| El título se ve delgado / no lo suficientemente negrita | El host no tiene SF Pro Display; el sistema recurre a una cara más clara | Establece font-weight: 900 (ya es el predeterminado) y verifica `fc-list |
| Los "Hello's", "Let's" se renderizan con comillas rectas | El preprocesador de puntuación inteligente está deshabilitado | Verifica que se llame a smartQuotes() en generate.js antes de escapeHtml |
| La imagen no se renderiza (espacio en blanco) | URL remota bloqueada o ruta relativa no se resolvió | Usa una ruta de archivo local; render.js incrusta imágenes locales como base64 |
| El subrayado de autocorrección también coincide con "Esta" cuando solo se pretendía "esta" | La expresión regular no distinguía mayúsculas de minúsculas | La expresión regular distingue mayúsculas de minúsculas de forma predeterminada. Pasa cadenas con mayúsculas exactas en autocorrect_underline |
| El párrafo vacío colapsa (sin espacio para el cursor) | <p class="note-paragraph"></p> sin contenido tiene altura cero | El CSS establece margin: 0 0 84px 0 por lo que un párrafo vacío aún ocupa un espacio de párrafo; asegúrate de no haber eliminado el margen inferior |
| El círculo amarillo de Hecho se ve naranja | Desviación del color CSS | El amarillo puro de Apple es #FFCC00. El cursor y Hecho comparten el valor; no lo cambies a #FFC107 (ámbar de Material) |
| La sugerencia del teclado "Hello's" se renderiza con apóstrofe recto | Las comillas inteligentes no se aplican a las sugerencias | Confirmado que se aplica mediante smartQuotes(s) en generate.js |
Referencia
La especificación visual se extrajo de apple-notes-typing.MP4 (una grabación de pantalla de iPhone de 36 segundos escribiendo en Apple Notes en modo claro). Consulta apple-notes-skill-build.html en esta carpeta para ver la prueba lado a lado: cada ejemplo se muestra junto con el fotograma de referencia al que se dirige.