create-apple-notes-mockup
Erstelle Apple Notes-Bildschirme, die wie echte iPhone-Screenshots aussehen – korrekte Statusleiste, schwebende Toolbox-Pille, fetter Titel, Fließtext mit Absatzabständen, gelber Textcursor, Autokorrektur-Unterstreichung, optionale eingebettete Bilder und Checklisten sowie eine optionale iOS-Tastatur.
Zweck
Wandle eine JSON-Notiz-Spezifikation in einen pixelgenauen Apple Notes-Screenshot (iPhone, heller Modus) um – HTML + PNG in nativer Auflösung von 1180×2556 (DPR 2). Es ist der deterministische, LLM-freie Renderer, den das Molekül create-apple-notes-video-ad Bild für Bild verwendet, um eine Tipp-Animation zu simulieren, und ein eigenständiges Werkzeug für einmalige „Notiz an mich selbst“-Szenen in Anzeigen, Social Posts und Storyboards. Der orchestrierende Agent erstellt den Text; dieses Atom sorgt für die Detailtreue (Statusleiste, intelligente Satzzeichen, Cursor, Autokorrektur-Unterstreichung, Toolbox, Tastatur-Chrome).
Verwendungszweck
- Du benötigst einen gefälschten Apple Notes-Screenshot für eine Anzeige, einen Social-Media-Post, eine Videoszene oder ein Produkt-Mockup.
- Du benötigst eine Abfolge von Apple Notes-Bildern (nur Titel → Absätze hinzufügen → Cursor bewegen), um eine Tipp-Animation für ein Video zu steuern – verwendet von
create-apple-notes-video-ad. - Du benötigst einen statischen „Notiz an mich selbst“-Moment in einem Storyboard.
Wenn du einen iMessage-Thread rendern möchtest, verwende stattdessen skills/atoms/messaging/create-imessage-mockup.
Eingaben
Das Skill ist deterministisch – es enthält kein LLM. Der orchestrierende Agent erstellt eine JSON-Notiz, die dem untenstehenden Schema entspricht, und ruft dann den Renderer auf.
JSON-Notiz-Schema
{
"title": "Hallo",
"body": [
{ "type": "paragraph", "text": "Dies ist eine Bildschirmaufnahme von mir, wie ich in der Apple Notes App tippe." },
{ "type": "paragraph", "text": "Mal sehen, wie sich das anfühlt." }
],
"cursor": "end",
"autocorrect_underline": ["dies", "wie"],
"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": "qwertzuiop",
"letters_row2": "asdfghjkl",
"letters_row3": "yxcvbnm"
},
"with_iphone_frame": false
}
title— Zeichenkette. Fette Display-Überschrift, einzelne Zeile.body[]— Blockliste. Unterstützte Blocktypen:paragraph—{ "text": "..." }. Intelligente Satzzeichen werden automatisch angewendet ('→',"→",...→…,--→–,---→—).image—{ "src": "<pfad|url>", "caption": "optional" }. Relative Pfade werden relativ zum Verzeichnis der Spezifikationsdatei aufgelöst und als Data-URIs eingefügt.checklist—{ "items": [{ "text": "...", "checked": true|false }] }. Überprüfte Elemente erhalten gelbe gefüllte Kreise mit Durchstreichung; nicht überprüfte erhalten grau umrandete Kreise.divider— Horizontale Linie.
cursor—"title" | "end" | null."title"platziert den gelben Cursor am Ende des Titels;"end"platziert ihn am Ende des letzten Absatzes;nullblendet ihn aus.autocorrect_underline[]— Liste von Wörtern mit exakter Groß-/Kleinschreibung. Jedes Vorkommen erhält die gelbe Unterstreichung der Apple Notes während des Tippens (<span class="spell">).status_bar—time,battery_pct(0–100),battery_low(Batterie rot färben),show_focus_glyph(Bitte-nicht-stören/Auto-Symbol neben der Uhrzeit). Die Dynamic Island wird nicht dargestellt.show_keyboard—trueüberlagert die iOS QWERTZ-Tastatur + Formatierungs-Toolbox.keyboard_state— wird nur ausgewertet, wennshow_keyboardtrue ist.shift="lower" | "upper".with_iphone_frame— fügt einen dünnen, dunklen Rahmen hinzu (für Hero-Kompositionen).
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 Anzeigen-Format
Flags
| Flag | Effekt |
|---|---|
--note <pfad> | (erforderlich) JSON-Datei, die dem obigen Schema entspricht |
--with-keyboard | aktiviert show_keyboard erzwungen (überschreibt Spezifikation) |
--with-iphone-frame | aktiviert Hardware-Rahmen erzwungen |
--no-frame | deaktiviert Hardware-Rahmen erzwungen |
--output <verz> | übergeordnetes Verzeichnis für den datierten Ausgabeordner; Standard ./apple-notes-mockup-exports/ |
--name <slug> | überschreibt den Slug des Ausgabeordners |
--out-html <pfad> / --out-png <pfad> | schreibt direkt in explizite Pfade (überspringt datierten Ordner) |
--viewport BxH | überschreibt das Render-Viewport (Standard 1180x2556) |
--dpr N | Device-Pixel-Ratio (Standard 2) |
Ausgabe
<ausgabe>/<YYYY-MM-DD>-<slug>/
index.html # vollständiges standalone HTML (Bilder als Data-URIs eingefügt)
screenshot.png # gerendertes PNG im gewählten Viewport × DPR
spec.json # Kopie der Eingabe für Reproduzierbarkeit
Standard <ausgabe> ist ./apple-notes-mockup-exports/ im aktuellen Arbeitsverzeichnis.
Arbeitsablauf
- Erhalte eine Eingabeaufforderung oder eine vorhandene JSON-Notiz.
- Wenn nur eine Aufforderung gegeben wurde: Erstelle eine
note.jsongemäß dem Schema und speichere sie. - Führe
node render.js --note <pfad> [--with-keyboard]aus. - Öffne das resultierende PNG, um das Layout zu überprüfen. Wenn etwas falsch aussieht (falscher Zeilenumbruch, falsche Cursorposition, falsche Batteriefarbe), bearbeite die JSON und rendere erneut.
Einrichtung (einmalig)
cd create-apple-notes-mockup
npm install
npx playwright install chromium
Ein Symlink zu create-imessage-mockup/node_modules ist im Repository enthalten, daher ist npm install bei einem frischen Clone nur erforderlich, wenn dieses Skill eigenständig sein soll.
Dateien
| Datei | Zweck |
|---|---|
render.js | CLI-Einstieg – parst Flags, löst Bildpfade auf, generiert HTML, erstellt Screenshot |
generate.js | Notiz-JSON → standalone HTML-Seite (intelligente Satzzeichen + Autokorrektur-Unterstreichung werden hier angewendet) |
screenshot.js | HTML → PNG über Playwright (Chromium headless) bei 1180×2556, DPR 2 |
templates/note.css | Gesamtes visuelles Styling (Statusleiste, Toolbox, Fließtext, Checkliste, Bild, Tastatur) |
templates/icons.js | Inline-SVG-Icons (Zurück-Pfeil, Rückgängig, Teilen, Mehr, Erledigt-Haken, Signal, WLAN, Batterie, Formatierungs-Toolbox-Icons, Tastatur-Glyphen) |
assets/samples/sample-landscape.jpg | Beispielbild, das von examples/with-image.json verwendet wird |
examples/*.json | 6 Referenznotizen, die alle Variationen abdecken (nur Titel, während des Tippens, langer mehrteiliger Text, mit Checkliste, mit Bild, Frame-1 Kleinbuchstaben-Tastatur) |
tests/run-all.sh | Rendert jedes Beispiel in tests/output/ zur visuellen Überprüfung |
apple-notes-skill-build.html | Side-by-Side-Übersicht, die Referenz-Videoframes mit generierten PNGs vergleicht |
Qualitätsprüfungen
Bevor du eine Notiz als versandfertig erklärst:
- Titel wird als fette Display-Überschrift dargestellt, nicht in normaler Schriftstärke.
- Fließtext verwendet Apples intelligente Satzzeichen –
'ist geschwungen,"ist geschwungen,…ist ein einzelnes Zeichen. - Gelber Cursor (
#FFCC00) sitzt bündig am Ende des Zieltextes, ~5px breit. - Fließtext-Absätze sind durch eine leere visuelle Zeile getrennt (kein manuelles
<br>). - Autokorrektur-Unterstreichungen sind kurze gelbe Linien, die bündig unter dem markierten Token verlaufen, mit case-sensitiver Übereinstimmung.
- Statusleiste: Uhrzeit links, Signal/WLAN/Batterie rechts. Batterie ist rot genau dann, wenn
battery_low: true. Keine Dynamic Island. - Scroll-Maske: Statusleiste und Toolbox haben undurchsichtige weiße Hintergründe, sodass der vom Molekül-Treiber gescrollte Fließtext nicht durchscheint. Überprüfe durch Verschieben von
.noteum-300pxin DevTools und bestätige, dass der Titel vollständig von der Toolbox maskiert wird – nicht dahinter/durch sie sichtbar. - Toolbox: schwebende Zurück-Pfeil-Pille (links), weiße Kapsel mit Rückgängig/Teilen/Mehr, gelber Erledigt-Kreis (rechts). Alle werfen weiche Schlagschatten.
- Tastatur (wenn aktiviert): QWERTZ-Layout entspricht der
shift-Groß-/Kleinschreibung, Vorschlagsleiste zeigt 3 Wörter, Formatierungs-Toolbox-Pille über den Tasten, Mikrofon + Globus unten. - Bildblöcke werden mit abgerundeten Ecken (~18px) dargestellt und respektieren den linken Innenabstand des Fließtextes.
- Checkliste: gefüllte gelbe Kreise + Durchstreichung bei überprüften Elementen; graue Umrisskreise andernfalls.
Fehlermodi
| Symptom | Ursache | Lösung |
|---|---|---|
| Fließtext umbricht ein Wort zu früh oder zu spät | Schriftbreite weicht von der Referenz ab (Chromium hat einen Nicht-SF-Fallback gewählt) | Passe font-size auf .note-body in Schritten von 2px an oder verbreitere .note durch Reduzieren des linken/rechten Innenabstands |
| Titel sieht dünn / nicht fett genug aus | Host hat keine SF Pro Display; System fällt auf eine hellere Schriftart zurück | Setze font-weight: 900 (bereits Standard) und überprüfe mit `fc-list |
| „Hello's“, „Let's“ werden mit geraden Anführungszeichen dargestellt | Smart-Punctuation-Vorverarbeitung deaktiviert | Überprüfe, ob smartQuotes() in generate.js vor escapeHtml aufgerufen wird |
| Bild wird nicht dargestellt (leerer Bereich) | Remote-URL blockiert oder relativer Pfad nicht aufgelöst | Verwende einen lokalen Dateipfad; render.js fügt lokale Bilder als Base64 ein |
| Autokorrektur-Unterstreichung trifft auch auf „This“, obwohl nur „this“ beabsichtigt | Regex war case-insensitiv | Der Regex ist standardmäßig case-sensitiv. Übergib exakte Groß-/Kleinschreibungs-Strings in autocorrect_underline |
| Leerer Absatz fällt zusammen (kein Cursorplatz) | <p class="note-paragraph"></p> ohne Inhalt hat Höhe Null | Das CSS setzt margin: 0 0 84px 0, sodass ein leerer Absatz immer noch einen Absatzabstand einnimmt; stelle sicher, dass du den unteren Rand nicht entfernt hast |
| Gelber Erledigt-Kreis sieht orange aus | CSS-Farbabweichung | Reines Apple-Gelb ist #FFCC00. Cursor + Erledigt teilen sich den Wert; ändere nicht auf #FFC107 (Material Amber) |
| Tastaturvorschlag „Hello's“ wird mit geradem Apostroph dargestellt | Intelligente Anführungszeichen werden nicht auf Vorschläge angewendet | Wird bestätigt über smartQuotes(s) in generate.js angewendet |
Referenz
Die visuelle Spezifikation wurde aus apple-notes-typing.MP4 extrahiert (eine 36-Sekunden-iPhone-Bildschirmaufnahme des Tippens in Apple Notes im hellen Modus). Siehe apple-notes-skill-build.html in diesem Ordner für den Side-by-Side-Nachweis – jedes Beispiel wird neben dem Referenzframe gezeigt, das es anvisiert.