Créer une maquette Apple Notes
Génère des écrans Apple Notes qui ressemblent à de vraies captures d'écran iPhone — barre d'état correcte, pilule de barre d'outils flottante, titre en gras, texte du corps avec espacement des paragraphes, curseur de texte jaune, soulignement de correction automatique, images intégrées et listes de vérification optionnelles, et un clavier iOS optionnel.
Objectif
Transformer une spécification JSON de note en une capture d'écran Apple Notes (iPhone, mode clair) pixel-parfaite — HTML + PNG à la résolution native 1180×2556 (DPR 2). C'est le moteur de rendu déterministe, sans LLM, que la molécule create-apple-notes-video-ad utilise image par image pour simuler une animation de saisie, et un outil autonome pour les séquences « noté à soi-même » dans les publicités, les publications sociales et les storyboards. L'agent orchestreur possède le texte ; cet atome possède la fidélité (barre d'état, ponctuation intelligente, curseur, soulignement de correction automatique, barre d'outils, chrome du clavier).
Quand l'utiliser
- Besoin d'une fausse capture d'écran Apple Notes pour une publicité, un post sur les réseaux sociaux, une scène vidéo ou une maquette de produit.
- Besoin d'une séquence d'images Apple Notes (titre uniquement → ajout de paragraphes → déplacement du curseur) pour animer une vidéo de saisie — utilisé par
create-apple-notes-video-ad. - Besoin d'une séquence statique « noté à soi-même » dans un storyboard.
Si vous devez restituer une conversation iMessage, utilisez skills/atoms/messaging/create-imessage-mockup à la place.
Entrées
La compétence est déterministe — elle n'intègre pas de LLM. L'agent orchestreur compose un JSON de note correspondant au schéma ci-dessous, puis invoque le moteur de rendu.
Schéma JSON de la note
{
"title": "Bonjour",
"body": [
{ "type": "paragraph", "text": "Ceci est un enregistrement d'écran de moi tapant sur l'application Apple Notes." },
{ "type": "paragraph", "text": "Voyons ce que ça donne." }
],
"cursor": "end",
"autocorrect_underline": ["ceci", "que"],
"status_bar": {
"time": "9:41",
"battery_pct": 87,
"battery_low": false,
"show_focus_glyph": false
},
"show_keyboard": false,
"keyboard_state": {
"suggestions": ["voir", "aller", "faire"],
"shift": "lower",
"letters_row1": "azertyuiop",
"letters_row2": "qsdfghjklm",
"letters_row3": "wxcvbn"
},
"with_iphone_frame": false
}
title— chaîne de caractères. Titre d'affichage en gras, sur une seule ligne.body[]— liste de blocs. Types de blocs pris en charge :paragraph—{ "text": "..." }. La ponctuation intelligente est appliquée automatiquement ('→',"→",...→…,--→–,---→—).image—{ "src": "<chemin|url>", "caption": "optionnel" }. Les chemins relatifs sont résolus par rapport au répertoire du fichier de spécification et intégrés sous forme de data URI.checklist—{ "items": [{ "text": "...", "checked": true|false }] }. Les éléments cochés obtiennent des cercles remplis jaunes avec un barré ; les éléments non cochés obtiennent des cercles gris vides.divider— règle horizontale.
cursor—"title" | "end" | null."title"place le curseur jaune à la fin du titre ;"end"le place à la fin du dernier paragraphe ;nullle cache.autocorrect_underline[]— liste de mots respectant la casse. Chaque occurrence obtient le soulignement jaune de la correction automatique en cours de saisie d'Apple Notes (<span class="spell">).status_bar—time,battery_pct(0–100),battery_low(batterie rouge),show_focus_glyph(icône DND/voiture à côté de l'heure). L'île dynamique n'est pas rendue.show_keyboard—truesuperpose le clavier QWERTY iOS + la barre d'outils de formatage.keyboard_state— uniquement consulté lorsqueshow_keyboardest true.shift="lower" | "upper".with_iphone_frame— ajoute un fin cadre noir (bord) pour les compositions héroïques.
CLI
node render.js --note exemples/milieu.json
node render.js --note exemples/long.json --output ./mes-exports/ --name note-du-jour
node render.js --note ma-note.json --with-keyboard
node render.js --note ma-note.json --viewport 1080x1920 # format publicitaire 9:16
Options
| Option | Effet |
|---|---|
--note <chemin> | (obligatoire) Fichier JSON correspondant au schéma ci-dessus |
--with-keyboard | force l'activation de show_keyboard (remplace la spécification) |
--with-iphone-frame | force l'activation du cadre matériel |
--no-frame | force la désactivation du cadre matériel |
--output <dossier> | dossier parent pour le dossier de sortie daté ; défaut ./apple-notes-mockup-exports/ |
--name <slug> | remplace le slug du dossier de sortie |
--out-html <chemin> / --out-png <chemin> | écrit directement dans des chemins explicites (ignore le dossier daté) |
--viewport LxH | remplace le viewport de rendu (défaut 1180x2556) |
--dpr N | ratio de pixels de l'appareil (défaut 2) |
Sortie
<dossier_sortie>/<AAAA-MM-JJ>-<slug>/
index.html # HTML complet autonome (images intégrées en data URI)
screenshot.png # PNG rendu au viewport choisi × DPR
spec.json # copie de l'entrée pour la reproductibilité
Le <dossier_sortie> par défaut est ./apple-notes-mockup-exports/ dans le répertoire de travail.
Workflow
- Recevoir une invite ou un JSON de note existant.
- Si seule une invite a été donnée : composer un
note.jsoncorrespondant au schéma, le sauvegarder. - Exécuter
node render.js --note <chemin> [--with-keyboard]. - Ouvrir le PNG résultant pour vérifier la disposition. Si quelque chose semble incorrect (mauvais retour à la ligne, mauvaise position du curseur, mauvaise couleur de batterie), modifier le JSON et relancer le rendu.
Configuration (une fois)
cd create-apple-notes-mockup
npm install
npx playwright install chromium
Un lien symbolique vers create-imessage-mockup/node_modules est livré avec le dépôt, donc après un nouveau clone, npm install n'est nécessaire que si vous voulez que cette compétence soit autonome.
Fichiers
| Fichier | Objectif |
|---|---|
render.js | Point d'entrée CLI — analyse les options, résout les chemins d'images, génère le HTML, prend la capture d'écran |
generate.js | Note JSON → page HTML autonome (ponctuation intelligente + soulignement de correction automatique appliqués ici) |
screenshot.js | HTML → PNG via Playwright (chromium headless) à 1180×2556, DPR 2 |
templates/note.css | Tout le style visuel (barre d'état, barre d'outils, corps, liste de vérification, image, clavier) |
templates/icons.js | Icônes SVG en ligne (chevron retour, annuler, partager, plus, coche terminé, signal, wifi, batterie, icônes de barre d'outils de formatage, glyphes du clavier) |
assets/samples/sample-landscape.jpg | Exemple d'image utilisé par examples/with-image.json |
examples/*.json | 6 notes de référence couvrant toutes les variations (titre uniquement, saisie en cours, long paragraphe multiple, avec liste de vérification, avec image, image 1 clavier minuscules) |
tests/run-all.sh | Effectue le rendu de chaque exemple dans tests/output/ pour révision visuelle |
apple-notes-skill-build.html | Tableau de révision côte à côte comparant les images de référence vidéo aux PNG générés |
Contrôles qualité
Avant de déclarer une note prête à être livrée :
- Le titre s'affiche comme un titre d'affichage en gras, pas en poids normal.
- Le texte du corps utilise la ponctuation intelligente d'Apple —
'est courbe,"est courbe,…est un seul caractère. - Le curseur jaune (
#FFCC00) se trouve au ras de la fin du texte cible, large d'environ 5 px. - Les paragraphes du corps sont séparés par une ligne visuelle vide (pas de
<br>manuel). - Les soulignements de correction automatique sont de courtes lignes jaunes au ras sous le mot signalé, avec correspondance sensible à la casse.
- Barre d'état : heure à gauche, signal/wifi/batterie à droite. La batterie est rouge ssi
battery_low: true. Pas d'île dynamique. - Masque de défilement : la barre d'état et la barre d'outils ont des arrière-plans blancs opaques pour que le contenu du corps défilé par le pilote de la molécule ne transparaisse pas. Vérifier en translatant
.notede-300pxdans DevTools et en confirmant que le titre est entièrement masqué par la barre d'outils — pas visible derrière/à travers elle. - Barre d'outils : pilule flottante de chevron retour (à gauche), capsule blanche avec annuler/partager/plus, cercle Terminé jaune (à droite). Tous projettent des ombres douces.
- Clavier (lorsqu'il est activé) : disposition QWERTY correspond à la casse
shift, bande de suggestions montre 3 mots, pilule de barre d'outils de formatage au-dessus des touches, mic + globe en bas. - Les blocs d'images s'affichent avec des coins arrondis (~18 px) et respectent le rembourrage gauche du corps.
- Liste de vérification : cercles remplis jaunes + barré sur les éléments cochés ; cercles vides gris sinon.
Modes de défaillance
| Symptôme | Cause | Correctif |
|---|---|---|
| Le texte du corps coupe un mot trop tôt ou trop tard | La largeur de la police diffère de la référence (Chromium a pris une police de secours non-SF) | Ajuster font-size sur .note-body par pas de 2 px, ou élargir .note en réduisant le rembourrage gauche/droit |
| Le titre semble fin / pas assez en gras | L'hôte n'a pas SF Pro Display ; le système utilise une police de secours plus légère | Définir font-weight: 900 (déjà la valeur par défaut) et vérifier `fc-list |
| "Hello's", "Let's" s'affichent avec un guillemet droit | Le préprocesseur de ponctuation intelligente est désactivé | Vérifier que smartQuotes() est appelé dans generate.js avant escapeHtml |
| L'image ne s'affiche pas (espace blanc) | URL distante bloquée ou chemin relatif non résolu | Utiliser un chemin de fichier local ; render.js intègre les images locales en base64 |
| Le soulignement de correction automatique correspond également à "This" alors que seul "this" était prévu | L'expression régulière n'était pas sensible à la casse | Par défaut, l'expression régulière est sensible à la casse. Passer des chaînes avec la casse exacte dans autocorrect_underline |
| Un paragraphe vide se réduit (pas d'espace pour le curseur) | <p class="note-paragraph"></p> sans contenu a une hauteur nulle | Le CSS définit margin: 0 0 84px 0 donc un paragraphe vide occupe toujours un espace de paragraphe ; assurez-vous de ne pas avoir supprimé la marge inférieure |
| Le cercle Terminé jaune semble orange | Dérive de couleur CSS | Le jaune Apple pur est #FFCC00. Le curseur et Terminé partagent la même valeur ; ne pas remplacer par #FFC107 (ambre Material) |
| La suggestion du clavier "Hello's" s'affiche avec une apostrophe droite | Les guillemets intelligents ne sont pas appliqués aux suggestions | Confirmé appliqué via smartQuotes(s) dans generate.js |
Référence
La spécification visuelle a été extraite de apple-notes-typing.MP4 (un enregistrement d'écran iPhone de 36 secondes montrant la saisie dans Apple Notes en mode clair). Voir apple-notes-skill-build.html dans ce dossier pour la preuve côte à côte — chaque exemple est présenté à côté de l'image de référence qu'il cible.