Native iCloud apps for Windows and Linux, built in Rust. Notes, Reminders, Calendar, Contacts, Drive and Photos, offline and in sync with your iPhone.
Rust apple-notesapple-reminderscloudkitcrdtdesktop-appicloudicloud-calendaricloud-driveicloud-notesicloud-photosiphonelinuxlinux-desktoplocal-firstoffline-firstprivacyrusttauritauri-appwindows
Keep docs/ local: only the README's images are published
Yashwanth Kamireddi324fed803cec
diff --git a/.gitignore b/.gitignoreindex 790ee91..8c88750 100644--- a/.gitignore+++ b/.gitignore@@ -16,3 +16,9 @@ packaging/arch/*.log# Local agent workspaces, never part of the project..claude/++# docs/ is local working notes (handoffs, research, launch plans), never published. Only the+# README's images are. An ignore rule, not a note in the folder: a broad `git add` once swept+# every note into the public repo (0.1.6).+/docs/*+!/docs/media/diff --git a/.uiverify/a11y.mjs b/.uiverify/a11y.mjsindex 5925c54..355942c 100644--- a/.uiverify/a11y.mjs+++ b/.uiverify/a11y.mjs@@ -15,7 +15,7 @@ import AxeBuilder from "@axe-core/playwright";const BASE = process.env.BASE ?? "http://localhost:4173";const ONLY = process.env.ONLY ? new RegExp(process.env.ONLY, "i") : null;-const TWO_FACTOR = { trustedDeviceCount: 0, phones: [{ id: 1, maskedNumber: "+91 ••••• ••318" }], tooManyCodesSent: false };+const TWO_FACTOR = { trustedDeviceCount: 0, phones: [{ id: 1, maskedNumber: "+1 ••• ••• ••42" }], tooManyCodesSent: false };const FIXTURES = { calendarFixture: true, notesFixture: true, contactsFixture: true, driveFixture: true, remindersFixture: true };const settle = (p, ms = 300) => p.waitForTimeout(ms);diff --git a/.uiverify/assert.mjs b/.uiverify/assert.mjsindex e179ab7..c4d44fe 100644--- a/.uiverify/assert.mjs+++ b/.uiverify/assert.mjs@@ -659,9 +659,9 @@ let failures = 0;for (const [label, twoFactor, wants] of [["nowhere to send", { trustedDeviceCount: 0, phones: [], tooManyCodesSent: false },{ resend: false, text: false, says: /account\.apple\.com/ }],- ["no device, but a number", { trustedDeviceCount: 0, phones: [{ id: 1, maskedNumber: "+91 •••318" }], tooManyCodesSent: false },+ ["no device, but a number", { trustedDeviceCount: 0, phones: [{ id: 1, maskedNumber: "+1 •••42" }], tooManyCodesSent: false },{ resend: false, text: true, says: /texted/i }],- ["devices and a number", { trustedDeviceCount: 2, phones: [{ id: 1, maskedNumber: "+91 •••318" }], tooManyCodesSent: false },+ ["devices and a number", { trustedDeviceCount: 2, phones: [{ id: 1, maskedNumber: "+1 •••42" }], tooManyCodesSent: false },{ resend: true, text: true, says: /2 of your devices/ }],// A number Apple calls rather than texts (timlaing/pyicloud#210): offered as a call.["no device, a number Apple calls", { trustedDeviceCount: 0, phones: [{ id: 1, maskedNumber: "+44 •••• ••12", mode: "voice" }], tooManyCodesSent: false },diff --git a/docs/INDEX.md b/docs/INDEX.mddeleted file mode 100644index a41763f..0000000--- a/docs/INDEX.md+++ /dev/null@@ -1,20 +0,0 @@-# docs/ index (local notes, never committed except docs/media)--## Start here-- NEXT.md: current state and what's next-- ROADMAP.md: everything open, in one list--## Launch and growth-- launch-playbook.md: claim sheet (what's true), audiences, channels, risks, metrics-- research-2026-10-21.md: competitors, how similar apps grew, copy, risks (sourced)-- comparison-draft.md: "Every way to use iCloud on Linux and Windows" (draft, not published)-- good-first-issues.md: issue drafts-- skykeep-brief.md: product brief-- Posting sheet (what to post where): ~/Documents/Skykeep/GO.md (videos/ and images/ next to it)--## Engineering reference (code comments link to these paths; don't move them)-- icloud-web/: how each iCloud web service works (+ proto/)-- notes-tables-crdt.md, mount-design.md, apple-parity.md-- macos27-kit.md, ios27-kit.md: Apple design tokens-- audit/: code audits per area-- privacy-audit.py: checks the git history for his real iCloud data before publishingdiff --git a/docs/NEXT.md b/docs/NEXT.mddeleted file mode 100644index 0447819..0000000--- a/docs/NEXT.md+++ /dev/null@@ -1,176 +0,0 @@-# Next (2026-11-05, ~13:00 IST) — 0.1.5 released (verify it published)--main b235af9 "Skykeep 0.1.5" (45 commits: store automation, bug hunt ×12, data-safety, sign-in + ADP-+ one session state model + Photos zone discovery, folder download, limits ×10). Gate: 148/150 in a-netns (FUSE + one timing check failed only there); outside it: all 1,275 Rust tests green, notes-long-17 ms. CI green. Tag v0.1.5 pushed → release run 41985353284.--FIRST next session:-1. If the v0.1.5 draft isn't published: verify (17+ assets incl. Skykeep-0.1.5-x86_64.flatpak,- latest.json = 0.1.5, checksums, skykeep.exe imports no MSVCP/VCRUNTIME) then- `gh release edit v0.1.5 --notes-file ~/Documents/Skykeep/release-notes-0.1.5.md --draft=false --latest`.- Publishing triggers stores.yml (Snap, Chocolatey, Scoop push, winget via Komac, MSIX artifact).-2. Check stores.yml run: first real run of it — unproven parts listed in the agent's report.- winget job fails until PR #470370 is merged (expected).-3. Reply on issues #4 and #5 (fixed in 0.1.5; #5: test with SKYKEEP_LOG=1 if still failing).-4. His dev app = target/debug/quince-app at b235af9 (rebuild after every batch: memory note).--Then:-- Reel: render at 2× (scripts/render-narrated.sh, ~1–1.5 h CPU), then `node scripts/qc-layout.mjs 15 0.25`- (now also fails on text overlapping text). Changes made, not rendered: platforms as equal type (no Tux),- shells removed (real note instead), Drive line true on both OSes, no "Not even to Apple", anti-flicker- (render scale 2 + lanczos). out/real/* files are the OLD version — don't post.-- Flaky test: folder_download 100k bounded-memory measures whole-process RSS → measure its own.-- Folder download small items: Download button in Drive toolbar; "name 2" everywhere; resume by version- not size; real full-disk test (tiny tmpfs as Downloads).-- Complete quince → skykeep rename (2,653 occurrences / 358 files; keep PREVIOUS_IDENTIFIERS; migrate- localStorage keys and "quince:" stored ids).-- 0.2.0: docs/sync-roadmap.md steps 4–14 + shared Drive folders, Shared Photo Library, People, shared- albums contents, shared reminders/notes, Notes folder export, security-key sign-in, headless backup + Docker.-- Store reviews pending: winget #470370 (Validation-Completed, moderator), Chocolatey (moderation; VirusTotal- 1–4 false positives "Note"), Microsoft Store certification. Snap forum keyring post: his, once activated.-- Reddit account banned (spam); appeal submitted; never make a new account.-------# Next (2026-11-04, 12:25 IST) — stores--**main 4233947 pushed** (gate 140/140, workspace fmt+clippy clean). Since v0.1.3: lapse reason in-the toast, RateLimited wording, calendar-undo suite, resend/SMS errors via apple_error, session-rename waits for Defender, Snap-specific keyring message, actions on Node 24, Flatpak + Snap files.-Next release 0.1.4 = these + merge `packages` and `msix` branches (BOTH edit updates.rs-install_kind: combine — msix → Store, flatpak → Flatpak, scoop on windows → PackageManager; keep-every test).--Store status:-- **Snap**: snap.yml dispatched for v0.1.3 publish=true (run 41788122338). password-manager-service- is deny-auto-connection in snapd → users must `snap connect` until the store grants auto-connect.- Request text: ~/Documents/Skykeep/snap-keyring-request.md (HE posts on forum.snapcraft.io).-- **Flathub**: BLOCKED for AI help. flathub/flathub AGENTS.md + Generative AI policy: manifests must- not contain AI-generated/assisted content even if disclosed; AI must not open/write the PR or- replies. Our manifest is AI-written, so it can't be submitted as is. Branch add-skykeep was pushed- to his fork (YashwanthKamireddi/flathub) before I read the policy; no PR opened. HIS call; he- must write the manifest + PR himself and disclose AI-generated app code. Flatpak CI build + start- test green (run 41785901664).-- **winget** PR #470370: CLA signed; awaiting install validation + moderator.-- **Chocolatey**: CHOCOLATEY_API_KEY secret set; publish after packages branch merges (moderation days).-- **Scoop**: create YashwanthKamireddi/scoop-bucket at 0.1.4 (0.1.3 can't detect Scoop).-- **COPR**: his Fedora login hit "System error" (new-account sync); retry with username, cleared cookies.-- **MSIX**: agent adding StartupTask; last run 41786702402 failed on the startup-task check. Needs his- 3 Partner Center identity values.-- README: add each channel only once it is live (literally true).-------# Next (2026-11-04, 10:35 IST)--**v0.1.2 published 05:01 UTC** (tag d797b45 "Skykeep 0.1.2"). latest.json = 0.1.2 (AppImage + nsis + msi, signed);-all download links 200. Full local gate 137/137 before push; CI + release dry run green.-In it: SRP fix (pad A/B/S, lowercase account name in H(I)); locked keyring asked again; Apple 5xx/429-not a sign-out; p256 0.14; AppImage built on Ubuntu 22.04 (glibc 2.35, own libheif 1.19.8); Windows-drags inside windows (src/lib/drag.ts), rename retries for Defender (quince-core/files.rs); Photos copy-PNG+bitmap on Windows; Drive paste from file manager; Hidden album lock; Drive Keep Both/Replace;-Calendar month bars; Photos Date Added levels. README: Linux|Windows table, .deb/.rpm update wording,-copyright notice.-- AppImage catalog PR #11157 (opened by probonopd): commented /retest.-- Reddit user "ninjainNight": sign-in 403 with a lowercase Apple ID. If 0.1.2 still fails for them,- get the full error; consider showing Apple's full reply (currently cut at 220 chars). Never auto-retry- a rejected proof (account lockout risk).-- Needs his Windows PC: in-window drag (reminders/contacts/photos), Photos copy → Paint.-- Next: bump GitHub Actions off Node 20 (warnings only); winget submit on his go- (~/Documents/Skykeep/winget, update to 0.1.2 hashes first); 3 agent worktrees still locked in .claude/worktrees.-- Posting: ~/Documents/Skykeep/GO.md; poster ~/Documents/Skykeep/images/poster.png.-------# Next (2026-11-04, end of day)--- Posting sheet: ~/Documents/Skykeep/GO.md (only one). Step 5 = 19 Reddit posts, rules read from- each sub; start Wed with r/linux + r/software; 2 posts/day max.-- Sent/asked tonight (him): HN mod email about the flagged Show HN; r/iCloud modmail (their- "not vibecoded" rule; post only on a yes).-- HN: account 7 months, 1 karma. Don't repost. Earn ~31+ karma by commenting; later a link to a- write-up in his own words.-- README: "six real desktop apps on a native Rust engine" first (7385d50); copyright notice for- Yashwanth Kamireddi (2e4af23). He said NO to a "Use of AI" section and NO to publishing- docs/icloud-web for now. Comparison page stays local (docs/comparison-draft.md).-- Film: ~/Documents/Skykeep/videos/film-real.mp4 (v3, 44 s, real app in 4K); source- skykeep-launch src/films/LandscapeReal.tsx.-- Proof of authorship: Software Heritage save accepted 2026-11-03 18:46 UTC (running); Wayback- save sent, not yet indexed: recheck.-- Next for me: README feature table (Linux | Windows ticks, every one verified); recheck Wayback;- prove updater with 0.1.2; winget submit only on his go (manifests in ~/Documents/Skykeep/winget).-------# Next (2026-11-04)--**Launched 2026-11-03:** v0.1.1 published (v0.1.0 tag burned, no release). Repo public; profile-public. main = 6af50a7 (README: "Not icloud.com in a window"), pushed. Windows tested by him on a-real PC.--**Launch state:** day one got almost no traction. HN Show HN flagged (new account; email sent to[email protected]). r/SideProject 200 views, 0 votes. X/Threads ~0 views. Press emailed:-OMG! Ubuntu, OMG! Linux, It's FOSS. Tauri Discord done.-Posting sheet = ~/Documents/Skykeep/GO.md (the only current one). Reddit step 5 in-progress (rules scraped from Reddit in headless Chromium: /tmp/rr/).--**Open (product):**-1. Prove the updater: cut 0.1.2 and watch a 0.1.1 AppImage + Windows install update.-2. Photos Copy "random characters" report: not confirmed; retest.-3. winget (manifest being prepared, not submitted), Flathub (not submitted), AUR (registration- closed), SignPath code signing (not applied).-4. GitHub: Discussions off; no pinned "what works / next" or "install reports" issues; no- good-first-issues filed.-5. Honest comparison page draft: docs/comparison-draft.md (being written, not committed).--**Later (after launch work):** a real demo film (real iPhone + real screen, real story) good-enough for big YouTubers. He uses only film-landscape-music.mp4 until then.-------# Next (2026-10-30)--GitHub main = 8952141, pushed. EVERYTHING from the 28-29 Oct agent passes is merged and pushed:-Calendar pass, Drive live updates (all zones), outbox randomized test, Notes/Reminders, Photos/Drive,-Contacts/shell, Drive copy/paste, startup trim, updater without zip, Notes list pictures + long-list-walking + Calendar all-day <-> hours drag, Photos Years/Months/All Photos (+ WebKit jump fix),-Liquid Glass tokens + popover/segmented motion (blur only in Chromium; WebKitGTK frosted, no blur).--Gate on 8952141: rust 1085/0, clippy, fmt, tsc, node 71, browser 478 runs both engines: 475 ok, then-the 3 failures fixed (calendar-edits month-boundary test, photos-levels-scale WebKit jump = real fix,-photos-slideshow load) and re-run clean (86 photos/calendar runs). The Notes "tick race" was a test-timing artefact (shortcut 10 ms after End), not an app bug; sync-quiet's redraw count read stale fiber-halves (fixed, mutation-checked).--Worktrees left: skykeep-integrate (branch integrate = main), skykeep-linuxci (linux-ci-green).--## Next-1. Real-app check by him of the new build (launcher binary rebuilt from 8952141).-2. Open items from agents: Photos Date Added sort vs Years/Months (by date taken); Drive Ctrl+Alt+V- onto a taken name (Finder asks Keep Both/Replace); Ctrl+D naming vs Paste naming; app-library- copy/paste; clipboard paste of files on Windows/macOS; invitations accept/decline (no write path);- Month-view bar stretching; WebKit Contacts/Drive per-step style cost (~4-6 ms, CSS).-3. Release pass (after repo is public): linux-ci-green CI, v0.1.0, tag, draft release.-------# Next (2026-10-25, evening)--Local main = 457ae9d (polish-all fast-forwarded: design language, 44+ bug fixes, live-sync-smoothness, merge fixes). NOT pushed yet: 53 commits ahead of origin/main. Gate on the merge:-1054 Rust tests, fmt/clippy/tsc, 68 node tests, 418/428 browser runs then all fixed (54/54 on-affected suites), photos-paging/scroll + notes-follow both engines, a11y clean.--## Now: one day of real use (soak) on his library-Skykeep restarted 22:04 from this build. Library backup before it:-scratchpad/realbackup-polish/library.db. He uses it normally (photos from iPhone, notes typed on-the phone, events, Drive) and reports anything off.--## Then-1. If the soak is clean: push main; remove worktrees skykeep-{design,bugs-nrc,bugs-pdcs,sync,polish}- and their branches.-2. Open questions: Apple all-day alert time (9 AM vs midnight) - check on his iPhone.-3. Release pass: linux-ci-green branch needs CI (only after the repo is public, since Actions- minutes are used up), version 0.1.0 + metainfo date, tag, draft release, attach the films.-4. His part: back up ~/.tauri, make repo public, social preview, then rulesets + release.diff --git a/docs/ROADMAP.md b/docs/ROADMAP.mddeleted file mode 100644index 4168a8a..0000000--- a/docs/ROADMAP.md+++ /dev/null@@ -1,75 +0,0 @@-# Roadmap: one place for everything open--This file merges all the research and audit docs into one list. Each item names the doc it came from, so the detail is never lost. **Updated 2026-10-21.**--## Decisions already made (don't reopen)-- **No translations** or RTL for now. Locale *formats* (week start, 12/24h) come from the system.-- **Apple-only by default.**- - Add features Apple's own apps have when users need them, opt-in, with privacy copy that stays literally true.- - **No third-party calendar accounts** (CalDAV or Google) for now. Only webcal subscriptions, which need no sign-in.-- **Positive, true copy:** no "…" on labels, no rows that carry no value, never imply Apple affiliation.-- **No motion on large layers.** WebKitGTK on Hyprland flickers. The photo viewer opens and closes instantly.-- **No fruit imagery** in brand or logo (Apple v. Prepear, 2020).-- **Calendar invitations / RSVP** wait until after launch.--## Shipped on 2026-10-21 (commits 0f30b3e, 1d2d344 and later)-- **Sync and speed**- - Concurrent sync; each screen fills as its own service lands.- - Fast app windows; tray down to four items.-- **Data safety:** offline outbox, atomic applies and migrations, the note-duplication fix, merge fixes.-- **Security:** apple_only covers IPs and redirects; attachments that would run code are never run; tighter capabilities; TLS updated.-- **Windows:** AUMID, reminder chime, toast buttons, HEIC via vcpkg, Edge UI suites in CI.-- **Design:** one design system across all apps (Toast, Confirm, EmptyState, PaneTitle and the rest).-- **Per-app work**- - Calendar pass; Contacts/Drive pass; Settings with storage.- - Export Everything; GNOME/KDE search provider; .ics/.vcf import; quick capture.- - Contacts structured addresses.- - Reminders: tags, smart lists, sections shown (writes off).-- **Locked notes:** a read-only unlock backend.-- **App ID** is now io.github.yashwanthkamireddi.Pomander, with a crash-safe migration.--## Waiting on the founder-1. **Name.** Shortlist in naming-final-2026-10-21.md, plus the corrected list in chat: Nearline, Pilvi, Skykeep, Lowcloud, Hushfall. The rename is one script; see the app-ID notes in packaging/README.md.-2. **Logos.** Prompts are in the chat history; they need rewriting for the chosen name.-3. **Live tests**, each behind a flag, each needing his phone:- - **Notes table writes:** notes-tables-crdt.md. One cell in the "Table Test" note, then check the iPhone and a second device.- - **Note attachments:** `NOTE_ATTACH_WRITES`, on a throwaway note.- - **Reminders details:** `REMINDER_DETAIL_WRITES`, in both the frontend and `crates/quince-icloud/src/reminders_details.rs`. The section-move checksum is unverified.-4. **Windows retest** of the next installer.-5. **Trademark search and code signing:** only if he wants them; the project is open source.-6. **iCloud cleanup:** delete the broken five-copy note. If doubled text shows in the "Colors" note, recreate its two tables.--## Open engineering, by source-- **gaps-2026-10-21.md** (top 20)- - **Done:** #1 session lapse, #2 week start, #5 Windows alert buttons, #8 .ics/.vcf open, #10 notification app name, #16 quick capture, #17 export, #20 search provider.- - **Open:**- - #3 offline editing for events (calendar outbox);- - #4 invitations (deferred);- - #6 a Flatpak build plus portals (the manifest exists but has never been built);- - #7 Drive/Photos folders on Windows (Cloud Files API);- - #9 Reminders writes (flag);- - #11 note attachments (flag);- - #13 shortcuts (partly done per app);- - #14 locked notes UI (in progress);- - #15 contact duplicate merge;- - #18 accessibility pass;- - #19 sharing.-- **Security leftovers** (from the security audit): `note_export_markdown`, `drive_upload`, `photos_upload` and `contacts_import` should accept only paths from a dialog or a drop.-- **Durability** (from the data-integrity audit):- - repeating-reminder ticks, reminder repeat changes and contact delete still need a network;- - a calendar conflict on a repeating occurrence still errors.-- **Performance** (from the perf audit): page the Photos IPC for libraries over 20k; thumbnails on Windows use the slow custom protocol (measure on real Windows first).-- **Bugs to fix**- - ~~Contacts Birthday field renders empty in WebKit~~ (fixed 2026-10-22, 1fb59b5).- - WebKit timing suites: drive-select at 126ms vs 100ms, photos-scale. Recheck when the machine is idle.-- **Release**- - Install-test deb, rpm, AppImage and AUR.- - The first tagged release (.github/workflows/release.yml, a draft release).- - README and GitHub page (marketing-2026-10-21.md §5).- - Remove the Apple icons from git history once the new icons exist.-- **Product ideas** (apple-parity.md, product-review.md, research-2026-10-21.md): see those docs. Most parity items are done; re-audit after the per-app passes.--## Marketing (marketing-2026-10-21.md)-- **Fix before use:** the taglines must say Linux **and** Windows, and lead with the native Rust engine (instant, local-first, private). The doc's hero line "at home on Linux" is too narrow.-- **Launch hook:** a GIF of ~1s two-way sync, plus the "how we reverse-engineered CloudKit" story. Earlier "iCloud on Linux" HN posts scored 1–6.-- **Claims allowed today:** Windows = beta until tested on real Windows; Photos = preview until tested on a large library.diff --git a/docs/apple-parity.md b/docs/apple-parity.mddeleted file mode 100644index 0a0957b..0000000--- a/docs/apple-parity.md+++ /dev/null@@ -1,372 +0,0 @@-# Apple parity: Quince vs macOS Calendar, Reminders, Notes, Contacts, iCloud Drive--Sources: Apple's macOS user guides (Calendar, Reminders, Notes, Contacts; macOS 27 TOCs), each guide's-keyboard-shortcuts page, the iCloud.com user guide TOC, and the Mac Help page on iCloud Drive in Finder.-Read 2026-10-16. Quince code read at the same date. Linux mapping: Cmd = Ctrl; Apple chords using both Control and Command are written Control+Cmd+ and need a separate Linux mapping.--Feasibility key: **WEB** = the iCloud web service already exposes it (icloud.com does it). **WEB?** = probably-there, payload not yet verified. **LOCAL** = client-side only, no API needed. **NO** = impossible-(end-to-end encrypted or device-only).-------## Calendar--Quince has: Day/Week/Month/Year views, drag-to-create and double-click-to-create, popover editor-(title, location, all-day, start/end, calendar, notes), calendar show/hide checkboxes, search,-delete with undo. Backend preserves alarms/guests/recurrence when it can read the existing event.--### (a) Missing features, by daily-use impact-| # | Feature | Feasible |-|---|---|---|-| 1 | Alerts on events (set/edit "15 min before", etc.). Model has none; only preserved on edit | WEB (`alarms` array in event body, calendar.rs:443) |-| 2 | Repeating events: create/edit recurrence; "this event / all future" choice on edit and delete | WEB (`recurrence`, `changeRecurring`, calendar.rs:441-442) |-| 3 | Invitees: add guests, see RSVP state, accept/decline invitations | WEB (`invitees`, icloud.com does accept/decline) |-| 4 | Drag an existing event to move it, drag its edge to resize | LOCAL + existing `event_save` |-| 5 | Quick Event / natural language ("Dinner at 6-7", "Party 6 Feb") | LOCAL parser |-| 6 | URL and attachments fields | URL WEB; attachments WEB? |-| 7 | Travel time | WEB? (CalDAV X-APPLE-TRAVEL-*; not in icloud.com UI) |-| 8 | Per-event time zone picker / Floating | WEB (`tz` already parsed, calendar.rs:155) |-| 9 | Create, rename, recolour, delete calendars; set default calendar | WEB (icloud.com does all) |-| 10 | Share calendar (private with people, public link), manage shared | WEB |-| 11 | Subscribed calendars (webcal), holidays, birthdays calendar | Subscribe WEB?; birthdays LOCAL from Contacts (occasions.rs exists) |-| 12 | Import/export .ics | LOCAL + event_save |-| 13 | Restore deleted calendars/events (icloud.com Data Recovery) | WEB? (separate recovery endpoint) |-| 14 | Availability panel, Siri suggestions, Focus filters, lunar calendars | Availability NO via web; rest LOCAL/NO |-| 15 | Print | LOCAL |--### (b) Shortcuts missing (Apple list vs CalendarView.tsx:371-395)-Have: Ctrl+Left/Right, T/Ctrl+T, Ctrl+1..4, Ctrl+N, Ctrl+F, Esc, Delete in popover.-Missing:-- Shift+Ctrl+T go to date-- Ctrl+E edit selected event; Opt+Ctrl+I inspector window; Ctrl+I info-- Tab / Shift+Tab / arrows select next/previous event (no event selection model at all)-- Ctrl+Opt+Up/Down move event 15 min (or a week in Month); Ctrl+Opt+Left/Right move a day-- Ctrl+R refresh all calendars-- Ctrl+Plus/Minus text size-- Space toggles selected calendar; Ctrl-click checkbox toggles all; Opt+Ctrl-click shows only that one-- Shift+Ctrl+N new calendar group; Opt+Ctrl+S new subscription-- Ctrl+P print; Shift+Ctrl+A availability; Ctrl+, settings-- Return closes event editor (Quince: Return submits form, fine; Esc discards rather than saving like Apple)--### (c) UI/UX differences-- Apple: a click on an event selects it; double-click opens. Quince opens the popover straight away; no selected state.-- Apple Esc/Return closes and keeps edits; Quince Esc calls `onClose` (CalendarView.tsx:1477), verify whether edits are dropped.-- Apple's Week view can be Mon-Fri only and shows 6-24 visible hours; start/end-of-day shading. Not present.-- Month view in Apple: double-click a day, type "Dinner 6-7". Quince creates an untimed draft.-- Apple has a separate inspector window option ("Open events in separate windows"). None here.-- Hidden calendars persist only in localStorage and are "forgotten on restart" in one path (CalendarView.tsx:261). Apple syncs visibility per device.--### (d) Likely bugs / edge cases-- **Silent data loss on edit when eventdetail fails.** `event_detail` returns `None` on any network error or non-2xx (calendar.rs:414-417). `put_event` then builds a fresh body with `recurrence: null, alarms: [], invitees: []` (calendar.rs:437-447) and PUTs it over an existing event. A transient failure turns a weekly meeting with guests into a one-off with no alerts. Fix: for an event with an etag, treat `None` as an error, not as "new".-- **Recurring occurrences.** `Event` carries no recurrence/occurrence id; delete posts `{guid, pGuid, etag}` (calendar.rs:371). Deleting one occurrence of a series likely deletes the series (or 404s, depending on how iCloud names instances). Needs a live test.-- Delete on 404 does a second `event_detail`; if that also fails transiently, the 404 is surfaced as an error even though the event is gone (calendar.rs:389).-- `endsAt` clamped to start+15 min (CalendarView.tsx:294): a zero-length event (common in imported ICS deadlines) gets silently lengthened on any edit.-------## Reminders--Quince has: lists (create/rename/delete), smart lists, sections (read), search, add, tick, flag, priority,-notes, due date (with alarm written alongside, main.rs:791-806), repeat, subtasks (parent), move list,-show/hide completed, delete.--### (a) Missing features-| # | Feature | Feasible |-|---|---|---|-| 1 | Keyboard-first entry: Return creates the next reminder, Tab/Shift-Tab indent/outdent | LOCAL (edit `parent_guid` exists) |-| 2 | Drag to reorder, drag between lists, drag to nest | WEB (CloudKit list `ReminderIDs` ordering; membership code reminders.rs:706) |-| 3 | Early reminder / custom alert time separate from due date; date without time | WEB (alarm records, set_alarm_cloudkit reminders.rs:3692) |-| 4 | Tags (#tag) and tag browser; custom Smart Lists with filters | WEB (CloudKit `Hashtag` records) |-| 5 | Create/rename/move/delete sections; columns view | WEB (sections are CloudKit records; read already works) |-| 6 | URL and images on a reminder | URL WEB; images WEB? (asset upload) |-| 7 | Location-based reminders (arrive/leave) | WEB to store; triggering NO (needs device geofence) |-| 8 | Share list, assign to person, accept/leave shared lists | WEB? (CloudKit sharing; icloud.com supports it) |-| 9 | List icon/colour, list groups, pin lists, default list | WEB |-| 10 | Desktop notifications when due | LOCAL (notification queue item already in brief) |-| 11 | Grocery lists auto-categories, templates, Apple Intelligence | Grocery categorisation NO (on-device ML); templates WEB? |-| 12 | Restore recently deleted reminders (icloud.com "restore") | WEB? |-| 13 | Sort by due date/creation/priority/title | LOCAL |-| 14 | Print | LOCAL |--### (b) Shortcuts missing (RemindersView.tsx has only Enter/Esc on fields, :703, :829, :1005)-All of Apple's list is missing: Ctrl+N new reminder, Shift+Ctrl+N new list, Opt+Ctrl+N new section,-Control+Cmd+N section with selection, Ctrl+1..9 pinned list, Ctrl+] / Ctrl+[ indent/outdent, Ctrl+E / Shift+Ctrl+E-show/hide all subtasks, Shift+Ctrl+F flag, Shift+Ctrl+C complete, Shift+Ctrl+H show/hide completed,-Ctrl+T due today, Opt+Ctrl+T tomorrow, Control+Cmd+T all overdue to today, Ctrl+K this weekend,-Opt+Ctrl+K next week, Opt+Ctrl+S sidebar, Ctrl+P print. No row selection model, so none can work yet.--### (c) UI/UX differences-- Apple: the "i" button opens a details popover (notes, URL, date, time, location, flag, priority, image). Quince edits inline in the row.-- Apple shows date and time as separate toggles; Quince uses a single datetime value (`setDue`, RemindersView.tsx:328-333).-- Apple's Today/Scheduled smart lists group by time of day / date; check Quince's smart list sections match.-- Completed reminders animate out after a short delay in Apple; verify Quince does not jump rows instantly.-- Cap message "Showing the first N" (RemindersView.tsx:941) has no Apple equivalent; Apple virtualises.--### (d) Likely bugs / edge cases-- **Half-applied edit.** `reminder_edit` writes the edit, then `set_alarm_cloudkit` (main.rs:787-806). If the alarm write fails, the error returns before `refresh_reminders`, so the UI shows a failure while the date change is already on Apple, and the local library stays stale until the next sync.-- `setDue` uses `new Date(value)` (RemindersView.tsx:331): an invalid string gives `NaN` -> `Math.floor(NaN)` sent as `dueAt`; guard needed.-- Clearing a date sends `dueAt: null` -> `due_at: Some(None)` -> alarm cleared, good; but an all-day reminder (date only) has no way to be created from the UI, so Apple-created all-day reminders edited here may gain a time. Verify.-- `reminder_edit` looks up the reminder via `reminders_in(&list_guid, true)` (main.rs:778-784): if the UI's `listGuid` is stale after a move on another device, the edit fails with "no longer in the local library" instead of resyncing.-------## Notes--Quince has: folders, pinned section, search, create, plain-text edit of title+body with byte-proof rewrite-(ckdocument.rs:643-666), move, pin, delete to Recently Deleted, restore, locked notes shown as locked.--### (a) Missing features-| # | Feature | Feasible |-|---|---|---|-| 1 | Rich text: Title/Heading/Subheading/Body/Mono styles, bold/italic/underline/strike | WEB (attribute runs in the protobuf; rebuild_note already keeps runs) |-| 2 | Checklists (tick boxes), bulleted/dashed/numbered lists | WEB (paragraph style in attribute runs) |-| 3 | Show attachments: images, PDFs, scans, drawings inline (currently U+FFFC placeholders in a textarea) | WEB to read (Attachment + Media records); drawings/scans render WEB? |-| 4 | Tables | WEB? (table is a mergeable CRDT attachment, mergeable.rs exists) |-| 5 | Links, note-to-note links (>>), Option+Ctrl+[ / ] navigation | WEB |-| 6 | Add attachments (Shift+Ctrl+A) | WEB? (asset upload) |-| 7 | Create/rename/delete folders, subfolders | WEB |-| 8 | Tags and Smart Folders | WEB (hashtag inline attachments) |-| 9 | Gallery view and Attachments browser | LOCAL once attachments are read |-| 10 | Sort options (date edited/created/title), group by date | LOCAL |-| 11 | Shared notes/folders, highlights, activity list | WEB? (CloudKit share zone) |-| 12 | Locked notes | NO without the note password; with password it is client-side decrypt (PBKDF2+AES-GCM) so technically LOCAL, but high risk |-| 13 | Audio recording + transcription, Math Notes, Quick Note | Store WEB?; transcription/maths LOCAL only |-| 14 | Export (PDF/Markdown), print | LOCAL |-| 15 | Duplicate note (Ctrl+D) | WEB (create with copied body) |--### (b) Shortcuts missing (NotesView.tsx has only Ctrl+S, Enter/Arrow/Backspace title-body glue, :631-670)-General: Ctrl+N, Ctrl+D, Shift+Ctrl+N, Control+Cmd+S sidebar, Ctrl+1/2/3 list/gallery/attachments,-Opt+Ctrl+F search, Tab between panes, Return to edit selected note, Ctrl+Return back to list, Ctrl+P.-Editing: Shift+Ctrl+A attach, Ctrl+K link, Ctrl+L divider, Opt+Ctrl+T table, Shift+Ctrl+T/H/J/B/M styles,-Shift+Ctrl+7/8/9/L lists and checklist, Ctrl+' quote, Ctrl+Plus/Minus size, Ctrl+] / Ctrl+[ and Tab/Shift+Tab list level,-Shift+Ctrl+U tick checklist item, Control+Cmd+Up/Down move item, Shift+Ctrl+. , 0 zoom. All table-navigation keys.--### (c) UI/UX differences-- Apple's editor is one rich surface; Quince is two textareas glued together (title line + body). Selecting across title and body, or undo across them, will not behave like one document.-- Apple shows a format (Aa) toolbar button, checklist button, table, attachment, share and lock buttons; none here.-- List rows in Apple show date + snippet + thumbnail of first image; Quince shows snippet only (NotesView.tsx:519).-- Apple's locked note shows a lock screen with password field; Quince shows explanatory text (NotesView.tsx:679-682).--### (d) Likely bugs / edge cases-- **Formatting at the edit point.** `replace_text` swaps the whole string and rebuilds runs (ckdocument.rs:655-663). A note with a checklist or heading, edited in the middle, has to map old runs onto new text; insertions near a style boundary will likely inherit the wrong style (e.g. new line becomes a checklist item or loses one). Needs targeted tests with styled notes.-- Attachments: deleting or typing over a U+FFFC character in the textarea removes an attachment reference while its Attachment record survives (orphan) or the run lengths shift. Should be protected in the editor.-- Save happens on blur (NotesView.tsx:645-648, 671-674) and Ctrl+S only; closing the window or switching app mid-typing relies on blur firing. Check there is also a debounce/unload flush.-- Edits overwrite Apple's current text (notes.rs:408-423): a concurrent phone edit between lookup and update is protected by the change tag, but an edit made on the phone after Quince opened the note and before save is replaced wholesale, not merged (no CRDT merge, though topotext.rs exists).-------## Contacts--Quince has: list, search, detail, create/edit name, company, phone/email/url with labels, birthday,-photo display, delete; addresses shown read-only; update merges onto Apple's card (contacts.rs:350-368).--### (a) Missing features-| # | Feature | Feasible |-|---|---|---|-| 1 | Edit postal addresses (read-only now, ContactsView.tsx ~277) | WEB |-| 2 | Groups/lists: view, create, add/remove members | WEB (icloud.com does lists) |-| 3 | More fields: nickname, job title, department, related names, dates, social profiles, notes, phonetic names, prefix/suffix | WEB |-| 4 | Change contact photo | WEB |-| 5 | Import/export vCard (.vcf), archive | WEB (icloud.com imports/exports vCard) |-| 6 | My Card | WEB? |-| 7 | Merge duplicates / link cards | LOCAL merge + WEB writes |-| 8 | Sort by first/last, display order, company cards (Ctrl+\) | LOCAL / WEB for isCompany |-| 9 | Smart Lists | LOCAL |-| 10 | Actions: click phone/email/address to call/mail/map | LOCAL (tel:/mailto:/geo:) |-| 11 | Restore deleted contacts | WEB? (data recovery) |-| 12 | Print labels/envelopes | LOCAL |--### (b) Shortcuts missing (none implemented in ContactsView.tsx)-Ctrl+N new card, Shift+Ctrl+N new list, Opt+Ctrl+N smart list, Ctrl+S save, Ctrl+O import, Ctrl+P print,-Ctrl+L edit, Ctrl+1 / Control+Cmd+S toggle lists, Opt+Ctrl+L last import, Ctrl+] / Ctrl+[ next/previous card,-Shift+Ctrl+M My Card, Shift+Ctrl+L merge, Ctrl+\ company/person, Opt+Ctrl+I custom image, Ctrl+I separate window, Ctrl+, settings.-Also arrow keys in the list.--### (c) UI/UX differences-- Apple: three columns (lists | names | card) with A-Z section headers and index; Quince has no lists column.-- Apple edits in place on the card with "add field" menu; Quince has an edit draft with an add-method button only for phone (ContactsView.tsx ~330).-- Apple shows label pickers with standard labels (home, work, mobile, iPhone...) plus custom.--### (d) Likely bugs / edge cases-- `create` requires a name or company (contacts.rs:325); a contact with only an email/phone (common from phones) cannot be created, Apple allows it ("No Name").-- `delete` sends the locally cached `etag` (contacts.rs:384-387); after an edit on another device it will 412 -> `Conflict` with no auto-resync-and-retry path visible in the command.-- Clearing a field in the draft: `card_from(contact, existing)` merges onto the existing card; check that a removed phone is actually removed and not re-supplied from `existing`.-------## iCloud Drive (vs Finder + icloud.com Drive)--Quince has: folder browsing with breadcrumbs, upload (picker + drag-and-drop), download, new folder,-rename, delete to Recently Deleted, move sheet.--### (a) Missing features-| # | Feature | Feasible |-|---|---|---|-| 1 | Recently Deleted view: restore, delete permanently | WEB (icloud.com does it) |-| 2 | Preview (Quick Look) for images/PDF/text/video | LOCAL after download |-| 3 | Sort by name/kind/date/size; list vs icon view | LOCAL |-| 4 | Multi-select (Shift/Ctrl-click) for move/delete/download | LOCAL + existing calls |-| 5 | Share file/folder, collaborate, copy link, manage/stop sharing | WEB (icloud.com does it) |-| 6 | Real local sync folder (Finder-style "keep downloaded", "remove download", status icons) | LOCAL + WEB; large piece of work |-| 7 | Search across Drive | WEB? (icloud.com has search) / LOCAL over synced index |-| 8 | Folder download as zip, drag out to the desktop | LOCAL |-| 9 | Desktop & Documents folders, Optimize Storage | LOCAL concept only |-| 10 | iWork/app-library folders show correctly (Pages/Numbers/Keynote packages) | WEB (read), editing NO |-| 11 | Storage usage | WEB |-| 12 | Advanced Data Protection accounts | NO (web access disabled when ADP is on) |--### (b) Shortcuts missing (DriveView.tsx has only Esc/Enter on fields)-Finder: Shift+Ctrl+N new folder, Return rename, Ctrl+Backspace move to trash, Space Quick Look, Ctrl+Up enclosing folder,-Ctrl+Down open, Ctrl+[ / ] back/forward, Ctrl+A select all, Ctrl+C/V/Opt+Ctrl+V copy/move, Ctrl+1/2/3/4 views,-Ctrl+F search, Ctrl+I get info, Ctrl+Z undo, arrow keys and type-to-select.--### (c) UI/UX differences-- No selection state; actions are per-row buttons. Finder is select-then-act.-- No back/forward history, only breadcrumbs.-- No file-kind icons/thumbnails beyond generic; no column headers (date modified, size, kind).-- Delete asks via a confirm dialog (DriveView.tsx:165); Finder moves to Trash silently with Undo.--### (d) Likely bugs / edge cases-- Deleted items are hidden locally because "Apple's listing may still carry it" (DriveView.tsx:70, 176). If the delete actually failed server-side after the optimistic hide, the item stays hidden until restart.-- Drop of a folder onto the window: Tauri gives a directory path; check `drive_upload` rejects or recurses rather than erroring on read.-- Name collisions on upload/rename: Finder offers Keep Both/Replace; verify Quince's behaviour against Apple's auto-rename.-------## Cross-app-- No global shortcut layer: Calendar is the only screen with app-level key handling. A shared keymap (Ctrl=Cmd) plus a selection model per list is the prerequisite for most of section (b) everywhere.-- No Undo outside calendar delete.-- No settings screen (Ctrl+,) in any app.-- No print anywhere.-----------# Second pass (2026-10-16)--Read page by page: the full Reminders, Notes and Contacts guide TOCs (via `/toc`) and the behaviour-heavy-pages listed under each section below, plus the iCloud for Windows guide (TOC and the Drive, Photos,-Passwords, Calendars & Contacts, Bookmarks and Recover pages).--API names used below:-- **CK-Reminders** = CloudKit `ckdatabasews` private DB, container `com.apple.reminders` (what Quince uses now).-- **CK-Notes** = CloudKit, `com.apple.notes` container (what Quince uses now).-- **CalWS** = iCloud web calendar service `/ca/*` (calendar.rs).-- **ContactsWS** = iCloud web contacts service `/co/*` (contacts.rs). **CardDAV/CalDAV** = `contacts.icloud.com` / `caldav.icloud.com` with an app-specific password, the standards route.-- **DriveWS** = `drivews` + `docws` (drive.rs).-- **PhotosCK** = CloudKit `com.apple.photos.cloud` via `ckdatabasews` (what icloud.com Photos uses).-- **E2EE** = end-to-end encrypted with keys only on trusted Apple devices: impossible from a web session.--## Why Reminders feels slow (traced)--**Not optimistic, and every write is a chain of serial round trips before anything changes on screen.**--UI side (`src/screens/RemindersView.tsx`):-- All writes go through `write()` (:283-301): `await run()` (the Tauri command, network included), then `await readItems()`, and only then does the row change. The comment at :282 says so on purpose: "to Apple first, then re-read".-- During that time the row's controls are disabled (`busyGuid`, :979, :1002, :1058, :1080), so the tick box does nothing visible until the whole chain finishes.-- Add (`add`, :440-455) sets `syncing`, which **disables the New Reminder input** (:836). You cannot type the next reminder until the previous one has made the full round trip. Apple's Return-to-add-next flow is impossible at this speed.-- `busyGuid` is a single slot (:184): tick A, then B, and A finishing clears B's busy state (`finally setBusyGuid(null)`, :297). Not a slowdown, but rows can be re-enabled while their write is still running.--Backend side, per action (all sequential `await`s):--| Action | Round trips before the UI updates |-|---|---|-| Complete (`set_done`, main.rs:646-670) | 1 `records/lookup` (inside `update_record_signed`, cloudkit.rs:728) + 1 `records/modify` (reminders.rs:1668) + `refresh_reminders` (main.rs:74-101): >=1 `changes/zone` page, then one **asset download per List record in the delta**, one after another (`fetch_memberships`, reminders.rs:729-760) |-| Create (`reminder_create`, main.rs:726-738) | create (reminders.rs:1165) + `place_in_list` lookup + modify of the List record (reminders.rs:1210, 1216) + refresh. Because the List record itself changed, the refresh always downloads that list's memberships asset too |-| Delete (`reminder_delete`, main.rs:741-763) | 1 modify (reminders.rs:1351) + refresh |-| Edit with a due date (`reminder_edit`, main.rs:768-809) | edit (lookup + modify) + `set_alarm_cloudkit` (lookup + up to 3 writes, reminders.rs:3692ff) + refresh: about 6-8 serial requests |--Does it resync everything after every write? **Not normally**: `refresh_reminders(.., whole=false)` sends the stored sync token (main.rs:81-89), so it's an incremental `changes/zone`. But:-- if Apple says the token is stale, `all_records` falls back to a **full walk** of the zone (cloudkit.rs:229), up to 200 pages (cloudkit.rs:21, 239), inside the user's click;-- membership assets are re-downloaded for every changed List, serially, with no caching by asset checksum (reminders.rs:741-757).--Fixes, in order of effect:-1. Optimistic UI: flip the row locally (tick/strike, insert the new row with a temp id, remove the deleted row) and roll back on error. Keep the input enabled; queue creates.-2. Return from the command after the write; run `refresh_reminders` in the background (spawn) and let the existing `revision` tick (RemindersView.tsx:255-274) redraw.-3. Skip the extra `lookup` when the cached etag is fresh: try `modify` with the cached `recordChangeTag` and look up only on a conflict (cloudkit.rs:728).-4. Fetch membership assets concurrently and skip unchanged ones by the asset's `fileChecksum`.-5. Write alarm + edit in one `records/modify` batch (CloudKit accepts several operations per request).--## Are colours real?--- **Calendar:** real. `color` from Apple's `Collection` is stored as-is (calendar.rs:109) and drawn with `tint()` (CalendarView.tsx:101-102) on calendars, events, the popover and the year view (:459, :546, :857, :900, :1148, :1213, :1504, :1642). Events have no colour of their own; they use their calendar's, which matches Apple.- - Gap: `tint()` accepts only `#RRGGBB`. Any other form Apple sends (e.g. `#RRGGBBAA`, which CalDAV-created calendars can carry) falls back to hard-coded `var(--sys-blue)` silently. calendar.rs:109 does not normalise the way reminders.rs does. Unverified against a live 8-digit value.-- **Reminders:** real. `Color` on the CloudKit List is parsed by `hex_colour` (reminders.rs:479, 522-548): plain hex, the JSON `daHexString`, or RGB components. Drawn via `colourOf()` (RemindersView.tsx:28-29).- - Gap: a Color JSON holding only `ckSymbolicColorName` (no hex, no components) returns `None` -> blue.- - Smart lists use fixed system colours (RemindersView.tsx:20-25). Apple does the same, so that's correct.- - New lists created in Quince: `create_list_cloudkit` (reminders.rs:1552ff) writes no `Color`, and there's no colour picker. A list made here shows blue in Quince; what the phone shows is untested.-- Nothing random. The only hard-coded colours are the blue fallbacks above and the smart-list system colours.--## Reminders, deeper (pages: Add or change, Dates/locations, Smart Lists, Sections, Sort, Move)--| Apple behaviour | Quince | Feasible via |-|---|---|---|-| Return on a selected reminder adds another below it | No; input is disabled while saving (:836) | LOCAL |-| Details panel: Notes (rich: bold/italic/lists), URL, Date tick + optional Time tick, Time Zone, Repeat, End Repeat (on date), Early Reminder, List, Tags, Flag, Priority (!/!!/!!!), Location (arriving/leaving, radius, getting in/out of car), When Messaging, Image | Has title, notes (plain), date+time combined, repeat, flag, priority, list, parent | URL, early reminder, end repeat, tags, timezone: CK-Reminders. Images: CK-Reminders asset upload. Location: store CK-Reminders, trigger impossible (device geofence). When Messaging: impossible (Messages on device) |-| All-day reminder (date without time) | Not creatable (single datetime input, :328-333) | CK-Reminders (DueDateIsAllDay field) |-| Urgent alarm on iPhone | No | CK-Reminders field likely; ringing is device-side |-| Natural-language dates ("Pay bills on Saturday") | No | LOCAL parser |-| Custom repeat: hourly/daily/weekly on weekdays/monthly each or "on the"/yearly | Presets plus "custom" label (:125, :342) | CK-Reminders (RecurrenceRule records) |-| Custom Smart Lists: Tags (include/exclude, all/any), Date (today/after/range/relative incl. overdue), Time, Priority, Flag, Location, Lists; match all/any | Only the four built-ins | CK-Reminders (smart-list filter is a List record field) + LOCAL evaluation |-| Sections: add, add with selection, reorder via Edit Sections, rename, delete (deletes contents), Auto-Categorise | Reads sections only | Write: CK-Reminders. Auto-Categorise: impossible (on-device ML) |-| Columns view (sections as columns) | No | LOCAL |-| Sort By: deadline, creation date, priority, title (asc/desc); manual drag; dragging in a sorted list switches to manual | Fixed order | `SortingStyle` field is on the List record (seen in reminders.rs test, :3363): CK-Reminders |-| Move: drag to reorder (subtasks follow), drag onto sidebar list, Cmd-click multi-select, copy/paste between lists; in Today drag between sections changes time, in Scheduled changes date | Move via list picker only | CK-Reminders (ReminderIDs ordering on the List, memberships asset) |-| Show Suggestions (re-add completed reminder while typing) | No | LOCAL over library |-| Settings: Today notification time, show all-day as overdue next day | No | LOCAL |-| Templates, shopping lists with categories | No | Templates: CK-Reminders (Template records) likely. Categories: impossible (on-device ML) |-| Sharing, assign | No | CK-Reminders sharing (CloudKit shares); unverified |--## Notes, deeper (pages: Format, View, Sort and pin, Smart Folders, Delete, Import/export)--| Apple behaviour | Quince | Feasible via |-|---|---|---|-| Format menu: Title/Heading/Subheading/Body/Mono/Block quote; bold/italic/underline/strike; font, size, colour; Highlight with colours; alignment; divider (Cmd-L) | Plain text | CK-Notes: all are attribute-run fields in the note protobuf that ckdocument.rs already round-trips |-| Collapsible headings (collapse/expand sections) | No | CK-Notes (collapsed state is in the doc) + LOCAL UI |-| "New notes start with" default style; default text size; per-note zoom | No | LOCAL |-| Gallery view (double-click opens), separate note window, note counts beside folders | No gallery/window; counts exist (`note_counts`) | LOCAL |-| Sort per folder (More > Sort By) and a global default; click the date to toggle created/edited; date groups | Fixed sort | Per-folder sort is likely a Folder record field: CK-Notes (unverified). Grouping: LOCAL |-| Pinned section with drag between Pinned and Notes; Recently Deleted can't be pinned | Pin exists | Check Quince doesn't offer Pin inside Recently Deleted (NotesView.tsx:555 gates only on `!locked`) |-| Smart Folders: Tags, Date Created, Date Edited, Checklists, mentions; any/all; untagged-only; converting a folder tags its notes (irreversible) | No | CK-Notes (Smart Folder = Folder record with a query) + LOCAL evaluation |-| Recently Deleted: off devices after 30 days, gone from iCloud after 40; recover by dragging to a folder | Delete, restore and Delete Now exist | Show the days-left count: LOCAL from deletion date |-| Import Markdown/TXT/RTF/RTFD/HTML/ENEX; export PDF or Markdown; Copy as Markdown; print | No | LOCAL conversion + CK-Notes create |-| Locked notes | Shown as locked | Decrypting with the user's note password: the crypto is client-side (password-derived key), so technically possible locally. With Advanced Data Protection on: impossible. If notes use the device passcode instead of a separate password: impossible |-| Audio recording + transcript, Math, Quick Note | No | Audio attachment: CK-Notes asset. Transcription and maths: LOCAL only |--## Contacts, deeper (pages: Update info, Lists, Smart Lists, View, Merge)--| Apple behaviour | Quince | Feasible via |-|---|---|---|-| Edit card: Add (+) menu of fields (Profile, etc.), click a label to change it, Custom label, empty fields hidden, Remove button, Done | Edit draft with phone/email/url; addresses read-only | ContactsWS (the card JSON has all fields); CardDAV as a standards fallback |-| Lists: Add > New List, New List From Selection, drag contacts onto a list, Remove From List vs Delete, nested sublists by dragging a list onto a list | None | ContactsWS groups (`/co/groups/card`). Nested lists: iCloud groups are flat, so nesting is a Mac-local feature; likely impossible on iCloud |-| Smart Lists: field + comparison + value, any/all | None | LOCAL only; iCloud doesn't sync Smart Lists |-| Merge selected cards; Look for Duplicates | None | LOCAL detection + ContactsWS update + delete |-| Link cards across accounts | N/A (one account) | Not applicable |-| Distribution list (which email a list uses) | None | Mac-local |--## iCloud for Windows: the closest analogue to Quince--This is a desktop client for a non-Apple OS, so it's the right bar for Quince's scope.--| Windows feature | What Apple ships | Quince today | Feasible via |-|---|---|---|---|-| **Drive in the file manager** | iCloud Drive in File Explorer navigation pane; files on demand | Separate in-app browser; downloads to a chosen path | DriveWS for listing/download/upload. Linux mechanism: FUSE, or a real folder with a sync engine (rclone-style). No Linux equivalent of the Windows Cloud Files API, so "placeholders" need FUSE |-| Status icons | Cloud = online only; blue arrows = waiting; progress bar = downloading; green circle + tick = downloaded; white tick in green circle = pinned; blue share = you shared; orange share = shared with you | None | LOCAL (Nautilus/Dolphin emblems or FUSE xattrs). Share state: DriveWS item fields (`shareID`/sharing flags, unverified) |-| "Always keep on this device" per file/folder/whole drive; "Free up space" | Yes | No | LOCAL sync policy + DriveWS |-| Share files and folders | Yes | No | DriveWS sharing (icloud.com does it; CloudKit share under the hood) |-| Recover: Recycle Bin first, then iCloud.com Recently Deleted (30 days) or Account Settings "Restore Files" | Yes | Delete only | Recently Deleted: DriveWS (`/retrieveTrashItems`-style endpoint icloud.com uses; unverified name). Restore Files (Data Recovery): separate service, unverified |-| **Photos** in Explorer: thumbnails, double-click to download; Apple-side edits/deletes sync down; Windows edits don't sync back (upload as new); Shared Library (v14+); upload; Shared Albums with comments | Yes | **Not in Quince at all** | PhotosCK for the library (what icloud.com Photos uses): list, thumbnails, originals, upload, delete. Shared Albums: separate `sharedstreams` web service. With ADP on: impossible |-| **Passwords** app + browser extension: view/copy username, password, code, note; add with generated password; edit; 2FA codes; password history; delete; add to shared groups (but create groups only on Apple devices) | Yes | No | **Impossible from a web session.** iCloud Keychain is E2EE; Windows gets keys by enrolling as a trusted device. icloud.com exposes no Passwords. Only route: reverse-engineering the Windows client's device enrolment. Out of scope and fragile |-| **Calendars and Contacts in Outlook**: classic Outlook only, needs an @icloud.com address | Yes | Own Calendar/Contacts apps | Linux analogue: expose CalDAV/CardDAV to Thunderbird/Evolution/GNOME Online Accounts. Feasible today via `caldav.icloud.com`/`contacts.icloud.com` with an app-specific password, no Quince code needed. Quince could offer to set it up |-| **Bookmarks**: per-browser extension, initial Merge, ongoing two-way sync with Safari | Yes | No | Safari bookmarks live in CloudKit (`com.apple.safari.bookmarks`?) and are E2EE for most accounts since iOS 17-era changes. **Likely impossible**; unverified |-| Manage storage, sign out/uninstall removes local copies | Yes | Sign-out exists | Storage: `setup.icloud.com` storageUsageInfo (web) |-| Mail | Not in the guide | No | IMAP `imap.mail.me.com` with app-specific password: feasible, standard |--### Windows parity: priorities for Quince-1. Drive as a real folder on disk (FUSE or synced dir) with keep-downloaded/free-up-space and status. This is the core of the Windows client.-2. Photos (PhotosCK). Totally absent, and it's the second pillar of iCloud for Windows.-3. Drive Recently Deleted + restore.-4. CalDAV/CardDAV hand-off so Evolution/Thunderbird/GNOME see iCloud calendars and contacts (the Outlook equivalent).-5. Drive sharing.-Passwords and Bookmarks: say plainly in the UI that they're not possible, rather than leaving them absent.diff --git a/docs/audit/contacts-drive-settings.md b/docs/audit/contacts-drive-settings.mddeleted file mode 100644index 1a9a126..0000000--- a/docs/audit/contacts-drive-settings.md+++ /dev/null@@ -1,81 +0,0 @@-# Audit: Contacts, Drive, Settings, Drive folder (FUSE)--Read-only audit, 2026-10-22. Nothing was built or run, so every item comes from reading the code at the line given.-Ranked by how much the user feels it.--## Ranked findings--| # | Impact | Where | Problem | Minimal fix |-|---|--------|-------|---------|-------------|-| 1 | **High: items vanish** | `src/screens/DriveView.tsx:573, 828, 764, 1107` | The `gone` set is only ever added to. Moved items keep the same `drivewsid`, so after a drag into folder X, **opening X hides them**: the rows and the count both filter by `gone`. The same happens to a deleted item recovered from Recently Deleted. This lasts until restart, because the screen stays mounted. | Remove ids from `gone` once a refresh shows they have left the folder they were deleted or moved from. Or key `gone` by `folderId:drivewsid` and clear it on `here.id` change. |-| 2 | **High: Cancel does not cancel** | `src-tauri/src/main.rs:4104-4110, 4184, 3790-3806` | Abort handles are registered inside `.map()`, which `buffer_unordered(3)` runs lazily. Only the 3 files in flight are in `uploads_running`. The tray's **Cancel** (and the per-row ✕ on a *waiting* file) aborts those 3, and every other planned file goes on uploading. `cancelled(batch)` is only checked during planning. Deleting a folder that is being uploaded into has the same gap (DriveView:771-776). | At the top of `run`, return the cancelled event if `cancelled(&batch)` or the id is in a new `cancelled_ids` set. Or create and register every `AbortHandle` before `stream::iter`. |-| 3 | **High: jank every 10 s** | `DriveView.tsx:605, 661`; `main.rs:4304-4320, 4351-4358` | Every quiet refresh (10 s poll, each sync landing, each upload landing) calls `driveThumbnails`. That reads **every** cached thumbnail with blocking `std::fs::read` on the async runtime, base64-encodes them all and ships them as `data:` URLs over IPC. A folder of 500 photos is roughly 10-25 MB of JSON parsed on the WebKit main thread, and then `setThumbs({...was,...t})` re-renders all rows. | Serve thumbnails through a URI scheme the way contact photos are served (`contactPhotoSrc`). Return only `id -> version` (or nothing) and call it only when `sameItems` was false. |-| 4 | **High: Contacts reloads on every Notes/Reminders edit** | `ContactsView.tsx:311, 382, 450`; `src/lib/outbox.ts:59-62`; `outbox.rs:1096, 1105` | `quince://outbox-changed` carries no service, and it fires twice per drain cycle while *anything* waits. Contacts stays mounted while hidden and re-reads the whole book (`contactsList`), the duplicates (`contactsDuplicates`, a second whole-book load) and the addresses on every `outbox.tick`. Typing in a note therefore keeps the library lock busy with address-book loads. | Emit the service in the payload and tick only for `"contacts"`, or fold `outbox.tick` into the `due` gate so a hidden screen reads once on return. |-| 5 | **High: mount and Drive freeze on a stalled network** | `crates/quince-auth/src/lib.rs:302-306`; `main.rs:162, 3618`; `mount.rs:61` | The Apple client has **no `connect_timeout` or read timeout**. `DRIVE_PASS` is **one global lock** held across `fetch_folder`. If one fetch hangs (Wi-Fi switch, resume from suspend), every folder open, the 10 s refresh, resyncs after writes and FUSE `list()` calls queue behind it. The window spins on "Opening ..." indefinitely, and FUSE gives up only after its own 30 s `LIST_WAIT`. | Add `.connect_timeout(10s)` and `.read_timeout(30s)` to `apple_only()`. Make the pass lock per folder (`HashMap<String, Arc<Mutex<()>>>`), since the race it guards is per folder. |-| 6 | **High: slow file manager on the mount** | `crates/quince-vfs/src/fuse.rs:1117-1131, 641-648, 568-637`; `mount.rs:234-239` | Every FUSE `lookup` calls `children()`, which takes the **global library lock** (`blocking_lock`), queries the whole folder from SQLite, re-derives names and places every inode, all to find one name. With `TTL = 1s` (fuse.rs:32), a file manager stat-ing a 2,000-item folder costs O(N²) and competes with every UI IPC call for the lock. | Cache `(folder ino -> name->ino map, built_at)` in `Inner` and invalidate it on `store_folder`, writes and rename. Raise the entry/attr TTL (for example 10 s) for Apple items. |-| 7 | **Med-High: bulk delete/move is very slow and blocks Drive** | `DriveView.tsx:768-781, 831-838`; `drive.rs:545-556, 1118-1131`; `main.rs:4238-4258, 4504-4528` | Each item is one IPC call doing about 4 sequential round trips: list the parent, the write, the in-function re-read, then `resync_drive_folder` under `DRIVE_PASS`. Moving uses 5. Deleting 50 files means about 200 requests, each resync holding the global pass lock, so navigation stalls. | Add `drive_delete_many` and `drive_move_many`: one parent listing, one `deleteItems`/`moveItems` body with all items (Apple takes arrays; `delete_forever_many` already batches), one resync per affected folder. |-| 8 | **Medium: bulk contact delete is O(N x book)** | `ContactsView.tsx:691-703`; `main.rs:3433-3446` | `removeMany` awaits `contactDelete` one at a time. Each call runs `library.contacts(None)`, which loads every card with all methods and details, to find one guid. 100 deletes in a 3k book means 100 full-book loads under the library lock, then a full re-read. | Look up one row (`SELECT ... WHERE guid=?`, like `contact_photo_source`), and add a `contacts_delete(guids)` command that records them all in one transaction. |-| 9 | **Medium: unsaved card silently discarded** | `ContactsView.tsx:813-819, 954, 257-262, 586` | While a card is being edited, **⌘N**, the **New Contact** button (`disabled={busy}` only), **Edit Contact** on another row, or a global-search reveal (`setDraft(null)`) replace the draft with no prompt. | If the draft differs from `draftBase`, `confirm()` "Discard changes?" first. Or disable New Contact while `draft` is set. |-| 10 | **Medium: full upload re-renders the whole Drive list** | `DriveView.tsx:938-952, 1604, 1110, 1520` | Upload state lives in `DriveView`, and every progress event (about 100 per file, 3 at once) re-renders the screen and maps every row. Selection uses `picked.includes` per row and in `pickedItems`, so after Ctrl-A in a 3k folder each render costs about 9M comparisons. | Move the `UPLOAD` listener and state into `UploadTray` (or a `useSyncExternalStore` store). Build `const pickedSet = useMemo(() => new Set(picked))` and use `.has`. |-| 11 | **Medium: per-keystroke whole-book IPC** | `ContactsView.tsx:287-311`; `quince-core/src/contacts.rs:750-830` | Each key in search reloads every contact, every method and all details, sorts, serializes the full cards and re-sorts in JS (`sortedContacts`). The sequence number drops stale replies, but the backend still does every one under the library lock. | Debounce about 120 ms, or have the search return only matching guids and filter the list already held in memory. Drop the second sort, since the backend already orders. |-| 12 | **Medium: downloads have no progress and no cancel; spinner lies** | `DriveView.tsx:731-743`; `main.rs:3688-3738`; `drive.rs:233-262` | Opening a file streams it to Downloads with only a row spinner: no percent, no cancel. `busyGuid` is a single value, so a second download takes the spinner from the first, and the first one's `finally` clears the second's. | Emit `sent/total` from the `bytes_stream` loop (the upload already has `Progress`), make `busyGuid` a `Set`, and add an abort handle as uploads have. |-| 13 | **Low-Med: offline folder loses all thumbnails** | `main.rs:4375-4377` | If one new file needs a thumbnail and that fetch fails, `?` returns `Err` and discards `out`, which already holds every cached thumbnail. Offline, the grid shows no pictures at all. | `match` the fetch: on `Err`, return `out` as it is. |-| 14 | **Low: counts change while searching** | `ContactsView.tsx:895, 687-690` | "All Contacts" and each list count use `contacts`, which is already filtered by the search, so the sidebar numbers shrink as you type. | Count from a separate unfiltered size (one `COUNT(*)` IPC, or keep the last unfiltered list). |-| 15 | **Low: copy rule** | `DriveView.tsx:1769` "Downloading…"; `SettingsView.tsx:636` "Syncing…"; `SettingsView.tsx:706` "Clearing…" | Button labels end in "…". (`PhotoCacheGroup` already does it right: "Clearing".) | Use "Downloading", "Syncing", "Clearing". |--## Details for the top items--### 1. Moved or recovered Drive items disappear (DriveView `gone`)-`setGone((g) => new Set([...g, ...ids]))` runs in `removeAll` (764) and `moveAll` (828). Ids are only removed when Apple *refuses* the change (786-790, 840-844). The set filters `rows` (1107) and the count (1351) in **every** folder, and `DriveView` is never unmounted (Library.tsx keeps screens alive).-Steps: drag `a.pdf` onto folder `Work` → open `Work` → it is not there, and "N items" is one short. Restarting the app "fixes" it.-Fix: after the `refresh()` at 793/846, prune ids the fresh listing no longer contains:-`setGone(g => new Set([...g].filter(id => itemsRef.current.some(i => i.drivewsid === id))))`.-Or scope entries as `${here.id}:${id}` and reset on `here.id` change.--### 2. Upload Cancel leaves most of the batch running-```rust-.map(|job| { … uploads_running().lock().map(|mut m| m.insert(job.event.id.clone(), abort)) … })-.buffer_unordered(3)-```-`map` on a stream runs as items are pulled, and `buffer_unordered(3)` pulls 3 at a time, so `drive_upload_cancel` only ever sees the files in flight. Waiting files have no handle. The tray's per-file ✕ (UploadTray.tsx:211) is offered for `state === "waiting"` and does nothing. Batch Cancel stops 3 files and the other 77 upload.-Fix (smallest): inside `run`, before `app.emit(… "sending")`, add-`if cancelled(&batch_id) || cancelled_ids().contains(&id) { return cancelled }`.-Have `drive_upload_cancel` also insert the explicit `ids` into `cancelled_ids`.--### 3. Thumbnail payload on every refresh-`refresh()` (DriveView:649-668) runs every 10 s while focused, on every sync revision, and 2 s after each landed upload. Each run calls `drive_thumbnails`, which:-- reads all cached files synchronously (`std::fs::read` in an `async fn`, blocking a Tokio worker);-- base64-encodes all of them;-- returns a `HashMap<String, String>` of data URLs.--The webview parses that on the main thread, then `setThumbs((was) => ({ ...was, ...t }))` always makes a new object and redraws the list. Because of the poll, it repeats every 10 s, and that is the periodic hitch.-Fix: register a `drive-thumb://<id>?v=<etag>` handler that serves the cached file (the same pattern as `contactPhotoSrc`). `drive_thumbnails` then only fills the cache and returns the ids that have pictures. In `refresh`, skip it when `sameItems(was, next)`.--### 4. A hidden Contacts screen re-reads on every outbox event-`useOutbox` bumps `tick` on each `quince://outbox-changed`. The backend emits that with `()` as payload, twice per drain loop (outbox.rs:1096/1105), whenever *any* service has something waiting: notes, reminders or calendar. ContactsView's three effects depend on `outbox.tick` directly, not through the `due` gate that already defers sync revisions while the screen is hidden. Every note autosave therefore costs two whole-book loads plus a whole-book duplicate scan, on the same library mutex the Notes save needs.-Fix: `app.emit(CHANGED, service)` and in `useOutbox` tick only when `payload === service`. In ContactsView, also gate the tick like `due` (`if (active) seenTick.current = outbox.tick`).--### 5. No HTTP timeouts, plus one global Drive lock-`apple_only()` sets no timeouts, and reqwest's default is none. `DRIVE_PASS` (main.rs:162) is held from `fetch_folder` to store, in `drive_sync_folder` (3618), `resync_drive_folder` (3671), the background pass (refresh.rs:366) and FUSE `list` (mount.rs:61). One half-open TCP connection after resume therefore blocks all of Drive, in the window and the mount, until the kernel gives up (minutes).-Fix: `connect_timeout(Duration::from_secs(10))` and `read_timeout(Duration::from_secs(30))` on the shared builder. The read timeout is per read, so long streamed uploads and downloads still work. Make the pass lock per folder id, which keeps the stated guarantee (the re-read after a write lands last *for that folder*).--### 6. FUSE `lookup` rebuilds the folder each time-`lookup → child → children → store.children → data.0.blocking_lock() + drive_children(folder)`, then `named(&items)` and `inodes.place` for **every** entry, and only then `.find(name)`. `getattr` is cheap, but lookups repeat every second (`TTL = 1s`). Nautilus or Dolphin listing a big folder does N lookups after `readdir`, giving O(N²) SQLite rows, each one waiting on the same mutex the UI's IPC uses. With `n_threads = 4`, four such lookups fill the pool.-Fix: keep a per-folder `HashMap<String, (u64, DriveItem)>` built by `children()` with a short validity, invalidated by `store_folder` (mount.rs list), `change()`, `rename` and create/unlink. Lookups then cost O(1) without the library lock. Raise `TTL` for Apple items.--### 9. Unsaved contact edits lost without a prompt-`startNew()` (223-228) and `edit(c)` (229-243) overwrite `draft` unconditionally. They are reachable during editing from ⌘N (813), the always-enabled header button (954), a row's "Edit Contact" (586) and `useReveal` (257). Escape is a deliberate Cancel, as in Apple's Contacts, and can stay.-Fix: a `leaveDraft()` helper that returns `true` immediately when `JSON.stringify(draft) === JSON.stringify(draftBase.current)` and no address edits are pending, and otherwise `await confirm({ title: "Discard changes?", action: "Discard", danger: true })`.--## Checked and fine (not listed)-- Contact rows: `memo` + stable `rowActions` + `content-visibility: auto`. Drive list rows use the same `content-visibility: auto` pattern.-- `Face` decodes before drawing and has no fade.-- Downloads go to `.part`, then hard-link, so a broken download never leaves a truncated file. Uploads stream from disk.-- Drive folder open is cached first with a token guard against stale navigation. List writes are queued with read-back on refusal.-- FUSE writes are journaled; replace keeps the old version in Recently Deleted; conflicted copies are made.-- Settings: folder status runs in `spawn_blocking`, the 2 s poll stops when Settings unmounts, and the export state survives navigation.--## Summary-Biggest user-visible bugs: moved or recovered Drive items stay hidden (#1), and upload Cancel only stops 3 files (#2). Both are small, local fixes.-Biggest smoothness costs: thumbnail data-URL payloads every 10 s (#3), whole-address-book reloads triggered by other apps' outbox events (#4), and O(N²) FUSE lookups on the global library lock (#6).-Stability: add HTTP timeouts and make `DRIVE_PASS` per folder (#5), so one stalled request can't freeze Drive and the mount.diff --git a/docs/audit/engine.md b/docs/audit/engine.mddeleted file mode 100644index 31c7be2..0000000--- a/docs/audit/engine.md+++ /dev/null@@ -1,93 +0,0 @@-# Engine audit: sync, outbox, push, auth, SQLite--Read-only audit, 2026-10-22. Nothing was built or run, so every item comes from reading the code. Line numbers are for the tree as it stands today.--## Ranked findings--| # | Impact | Where | Problem | Minimal fix |-|---|--------|-------|---------|-------------|-| 1 | **High: app-wide freeze** | `crates/quince-auth/src/lib.rs:302-306`, `src-tauri/src/main.rs:955-959`, `:1569` | The single Apple HTTP client has no `connect_timeout`, `timeout`/`read_timeout` or `tcp_keepalive`. `keep_signed_in` and the heartbeat hold the **auth mutex** across `heartbeat().await`. After suspend/resume or a Wi-Fi change, a pooled socket can hang for the kernel's retransmit limit (roughly 15 min or more). | Build the client with `.connect_timeout(10s).read_timeout(30s).tcp_keepalive(30s).pool_idle_timeout(90s)`, and give large downloads and uploads their own per-request `.timeout()`. Also wrap `heartbeat()` in `tokio::time::timeout(20s)`. |-| 2 | **High: false "Apple signed you out"** | `quince-auth/src/lib.rs:514-528`, `:960-963`, `:474`, `:509`, `:624`, `:606`; `main.rs:968-984` | `validate` and `accountLogin` turn every non-2xx reply (503, 502, 500) into `Error::Protocol`. `resume` gives up only when **both** errors are `Network`, so an Apple 5xx outage drops into SRP sign-in and then into `clear_challenge_state(); Ok(false)`. `keep_signed_in` then emits `NEEDS_SIGNIN` and a desktop notification. `sign_in_inner` also clears `session_token` and `sign_in` persists that. | Map 5xx and 429 from `validate` and `accountLogin` to a transient error such as `Error::Unavailable`. In `resume`, return `Err` when either error was transient, before trying SRP. When `resume` calls `sign_in`, restore `before` on any error other than `BadCredentials`. |-| 3 | **High: every screen waits on sync** | `main.rs:117` (`Data(Mutex<Library>)`), `refresh.rs:607-622`, `notes.rs:268-346` (`quince-icloud`) | One `tokio::Mutex<Library>` serves every read command. A store holds it for the whole apply, and a full pass decodes every note (gzip, protobuf and topotext) inside that lock. A daily full Photos, Notes or Reminders pass, or a first sync, leaves Notes, Reminders and Contacts blank or frozen. Typing a note autosave (`note_save`, `main.rs:3083`) also queues behind it. | Serve read-only commands from `Library::open_reader` handles. That reader already exists for search (`main.rs:1315-1341`), and WAL makes it safe. Move note decoding (`note_from_record`) into `fetch_cloudkit`, which holds no lock. |-| 4 | **High: slow edits and drags** | `main.rs:128-135`, `:2606`, `:2734-2811`; `reminders_cmds.rs:209` | `resync_reminders` passes `whole = true`, so each reorder drag, tag add or remove, repeat, list create, rename, colour or delete waits for a **full zone walk** (up to 200 pages). It then runs serial list-membership downloads (`reminders.rs:740-770`, one request after another) and a whole-library apply under the lock, without `block_in_place`. | Use `refresh_reminders(…, false)`. A delta from the stored token already includes every record that moved, tombstones too, and an expired cursor falls back to a full walk by itself (`cloudkit.rs:249-257`). Fetch memberships with `buffer_unordered(8)` as Notes does. |-| 5 | **Medium-high: re-render storm** | `main.rs:5645-5651`, `refresh.rs:205` and every other `landed()` call; `src/lib/sync.tsx:128-132` | Each service landing emits `SYNCED` even when nothing changed, which makes 7 events per 5-minute pass, plus one per focus and one per push. Each event bumps a global `revision`, and Notes, Reminders, Contacts and Drive then re-read whole lists, the open note or reminder and the tables (`NotesView.tsx:219,359,377,469`). Each re-read takes the library lock, behind the next service's store. | In `store()`, compare `conn.total_changes()` before and after the apply. Emit only when rows changed, and include the service name in the payload so a screen re-reads only for its own service. |-| 6 | **Medium: duplicate passes** | `refresh.rs:174-500`; `sync.tsx:139-147`; `push.rs:250-275` | Pass locks only queue requests; they never merge them. Focus in each window (each window has its own throttle), the 5-minute timer, every push burst and each window's mount all run another full pass once the current one finishes. Each pass costs a heartbeat, a full calendar window, a contacts check and a Drive root read. | Use a per-service "in flight" flag. A second request waits on the running pass and returns its report, setting a dirty bit that causes at most one more pass afterwards. |-| 7 | **Medium: calendar refresh is ~12 serial requests** | `crates/quince-icloud/src/sync.rs:84-98` | For each 28-day chunk of the 5-month window it calls `/ca/startup` **and** `/ca/events` one after the other, but `startup.calendars` is only used from the first chunk. This runs on every ctag change, which is polled every 4 s while focused. `calendar_sync` (`main.rs:1609-1625`) does the same for the window the UI asks for, and its apply runs without `block_in_place`. | Call `startup` once and fetch the remaining chunks with `/ca/events` alone, concurrently (`try_join_all`). Better still, re-fetch only the calendars whose ctag moved. |-| 8 | **Medium: unbounded memory** | `src-tauri/src/photos.rs:21-40` | `LINKS` gains an entry (six long signed URLs) for every master on every Photos pass. Entries expire logically after 45 min (`:48`) but are never removed, so after one full pass the map holds the whole library for the life of the process. | In `remember()`, call `map.retain(\|_, (_, at)\| at.elapsed() < LINK_LIFE)` before inserting. |-| 9 | **Medium: memory spike on full Photos walk** | `crates/quince-icloud/src/photos.rs:37`, `:96-120`, `:400-405` | `PASS_PAGES = 100` × 500 records keeps about 50k `serde_json::Value` CPLMaster and CPLAsset records in memory at once, plus held records. This happens again every 24 h (`refresh.rs:65` `FULL_SYNC_EVERY` covers photos). My estimate is several hundred MB of peak RSS for a large library. I did not measure it. | Lower `PASS_PAGES` to about 10, since the walk already resumes across passes. Consider a weekly rather than daily full read for Photos. |-| 10 | **Medium: blocking keyring on every sync** | `quince-auth/src/lib.rs:537-539`, `:350-372`; `session.rs:531-557` | Each heartbeat, so each sync and focus, calls `persist()`. That makes synchronous Secret Service D-Bus writes (several chunks, deletes of old names, then a read-back), all on a tokio worker while holding the auth lock. | Persist only when the serialized session or cookie jar differs from the last write (keep a hash), and run it in `spawn_blocking`. |-| 11 | **Medium: Files app freezes during sync** | `src-tauri/src/mount.rs:237`, `:275`; `mount_photos.rs:128`, `:239`; `photo_cache.rs:464,481` | FUSE `readdir` and `lookup` call `data.0.blocking_lock()`, so Nautilus hangs for the length of any sync store. | Read from a `Library::open_reader` handle held by the mount (read-only, WAL). |-| 12 | **Low-medium: live channel can stall silently** | `crates/quince-icloud/src/courier.rs:536-546`; `push.rs:478-486` | The registry `POST` has no timeout. During the 11-hour renewal inside `run()`, a hang stops `next()` from being polled while `LIVE` is still `true`, so pushes are lost and the poller only safety-checks every 2 min. | Add `.timeout(ANSWER)` to the registry request. Item 1 also covers this. |-| 13 | **Low: heavy work for a small question** | `main.rs:4735-4762` | `warm_contact_photos` runs after every pass. It loads every contact with every contact method and calls `stat()` on each photo path **while holding the library lock**. | Query only `guid, photo_signature WHERE photo_url IS NOT NULL`, drop the lock, then check the files. |--## Details on the top items--### 1. No network timeouts, and the auth lock is held across the network--`apple_only()` (`lib.rs:1073`) sets only a resolver and a proxy, and `Client::with` adds cookies, the user agent and default headers. Nothing bounds a request. The only timeouts in the engine are in push (`push.rs:114`), the subscription fetch (`main.rs:1997`) and one 300 ms probe (`cloudkit.rs:1664`).--This is how it spreads:-- `sync_all`, `sync_some` and the 5-minute timer all `await keep_signed_in`. That function locks `auth.client` (`main.rs:955`) and awaits `heartbeat()`. When `validate` fails, `heartbeat()` falls through to `resume()`, which can mean up to three requests or a full SRP sign-in.-- While that lock is held, the following all queue: `cloudkit_context` (every write and the outbox), `calendar_context`, `drive_context`, `account_info`, `account_services`, `storage_info`, the 4-second calendar and contacts watchers (`push.rs:113,214`), the push listener and the poller.-- On a laptop the trigger is ordinary. After resume from sleep, hyper reuses a pooled connection whose peer is gone. With no keepalive and no read timeout, the request waits for TCP retransmission to give up.--To the user this looks like Skykeep stuck on "Updating" after opening the lid, with edits never leaving and the push channel dead until restart.--Fix in `Client::with`:-```rust-let http = apple_only()- .cookie_provider(Arc::clone(&jar))- .user_agent(UA)- .default_headers(defaults)- .connect_timeout(Duration::from_secs(10))- .read_timeout(Duration::from_secs(30)) // per read, so big bodies still stream- .tcp_keepalive(Duration::from_secs(30))- .pool_idle_timeout(Duration::from_secs(90))- .build()?;-```-Also wrap the call at `main.rs:959` in `tokio::time::timeout(Duration::from_secs(20), guard.heartbeat())` and treat an elapsed timeout as `Err(_) => {}`.--### 2. An Apple outage reads as a sign-out--Path: `heartbeat` → `validate` 503 → `Err(Protocol)` → `resume()` → `validate` 503 again → `account_login` 503 → `Err(Protocol)`. The guard at `lib.rs:474` requires both errors to be `Network`, so the code moves on to `sign_in`. One of two things follows:-- `CoolingDown`, if an earlier failure set a cooldown. That falls into `Err(_) => {}`.-- SRP init gets a 503. `sign_in_inner` has already run `clear_challenge_state()` (`:624`), which removes `session_token`. The failure is counted towards the cooldown, and `sign_in` persists the session without its token (`:606`).--Both end at `:509`, which returns `Ok(false)`. `keep_signed_in` then sets `LIVE = false`, emits `NEEDS_SIGNIN` and posts "Apple signed Skykeep out", even though nothing was signed out. The stored `session_token` is now gone, so the cheap `accountLogin` recovery no longer works later.--Fix: a transient class for HTTP 5xx and 429 in `validate` and `account_login`. In `resume`, use `if transient(&validated) || transient(&logged_in) { return Err(...) }`. In the `sign_in` branch of `resume`, restore `before` on every error except `BadCredentials`.--### 3. One mutex for every reader--The search path already proves the fix: `read_for_search` (`main.rs:1321`) uses `Library::open_reader` because WAL readers never block on the writer. Every other read command (`notes_in`, `note_body`, `reminders_in`, `contacts_list`, `calendar_events`, `drive_children`, the `quince://` handlers that read rows) still does `data.0.lock().await`.--`store()` correctly moves the network work outside the lock. But the apply itself, inside `block_in_place`, holds the lock for as long as the rows take to write, and for Notes that includes decoding every body (`note_from_record`, called from `apply_cloudkit_whole`). FTS triggers fire on every insert (`schema.rs:640-660`), which adds to the time.--Minimal fix: a small pool of reader connections (or a thread-local one) for read-only commands, keeping `Data` only for writes. That also covers items 11 and 13.--### 4. Reminder list operations do a full walk--`resync_reminders` passes `whole = true`. The comment says a list change moves other records too, but a delta from the stored token returns every record changed since that token, including those others. A full walk adds nothing except cost: every page, one membership download per list in series, and a whole-zone prune and apply under the lock, which in this path is not even wrapped in `block_in_place`. The drag or tag command resolves only after all of that.--Fix: `refresh_reminders(http, root, params, data, false)`. Keep the daily full pass in `refresh.rs` as the floor.--### 5. `SYNCED` is emitted with nothing changed--`refresh::on_landed` (`main.rs:5645`) emits `refresh::status` for every service as it lands. A clean 5-minute pass therefore emits 6 `SYNCED` events plus the final one. `sync.tsx` bumps `revision` on each event regardless of content, and every open screen re-reads its whole list and its open item. `NotesView.tsx:469` also re-runs `[revision, flush]`. That is the probable source of "it redraws for no reason" and of lock pile-ups.--Fix in `store()`: record `library.conn().total_changes()` before and after the apply, return `changed: bool` in `ServiceReport`, and call `landed()` only when it is true. Include `service` in the payload so a screen bumps only for its own service.--## Checked and fine (not findings)--- Outbox amend versus in-flight send: `outbox_take` bumps `tries` before sending, and `amend` and `withdraw` require `tries = 0` (`quince-core/src/outbox.rs:95-155`).-- Pass atomicity (`Library::atomically`), the account-owner guard in `store()`, outbox replay after each pass, and the busy and 503 retry with a cap (`cloudkit.rs:124-166`).-- Expired cursors start the walk over, and a partial walk never prunes (`ZoneWalk::whole`).-- Push socket: ping every 60 s, dead after 30 s, connect bounded by `ANSWER`, and the protobuf reader checks bounds.-- Indexes cover the hot list queries (notes by folder, reminders by list, photos by taken, outbox by service). WAL with `synchronous=NORMAL` is set.-- Offline start keeps `webservices` from the keyring, so the timer and watchers still run once the network is back.--## Summary--1. Two issues make the app look broken: there are no HTTP timeouts while the auth lock is held across the network (it freezes after sleep), and an Apple 5xx outage is misread as a sign-out.-2. Most visible slowness comes from the one library mutex shared by sync and UI reads, full Reminders walks after every list edit, and `SYNCED` re-render storms when nothing changed.-3. The fixes are small and local: client timeouts, a transient error class, reader connections, a delta resync, change-gated events, and a pruned `LINKS` map.diff --git a/docs/audit/notes.md b/docs/audit/notes.mddeleted file mode 100644index 442eda3..0000000--- a/docs/audit/notes.md+++ /dev/null@@ -1,54 +0,0 @@-# Notes audit (read-only)--Scope: `src/screens/NotesView.tsx`, `src/screens/notes/*`, `src-tauri/src/notes_cmds.rs`, the notes commands in `src-tauri/src/main.rs`, `src-tauri/src/outbox.rs` (notes paths), `crates/quince-icloud/src/notes*.rs`, `ckdocument.rs`, `table.rs`, `topotext.rs`, `crates/quince-core/src/{outbox,notes}.rs`.-Method: I only read the code. Nothing was built or run, so every item still needs a check in the running app. Another agent was editing `NotesView.tsx` while I read it, so line numbers there may have shifted a few lines.--## Ranked findings--| # | Impact | file:line | Problem | Minimal fix |-|---|--------|-----------|---------|-------------|-| 1 | **Duplicate note** | `src/screens/NotesView.tsx:578`, `:1503` | `adoptedKey` is set when a composed note becomes real and is never cleared. With that note still open, Ctrl+N or New Note keeps the editor key `"composing"`, so React reuses the same ProseMirror editor and it still holds the old note's text. The first keystroke sends old text + new text to `setComposing`, and `commitComposing` creates a copy of the previous note. | In `create()`, set `adoptedKey.current = null` before `setComposing(...)`. Or key the compose editor on a per-compose counter (`composing-${n}`). |-| 2 | **Formatting wiped on Apple** | `NotesView.tsx:338/372`, `:387`, `:486`, `:872` | Body and runs come from two separate IPC calls, and `canEdit` waits only for the body. The editor mounts plain (`formatSafe` false). If the user types before `noteRuns` returns, `base.current.runs` is fixed at `null`. Once runs arrive, `formatSafe` turns true and the next keystroke queues the *plain* editor runs as the note's formatting. `rewrite_for_save` (`notes.rs` ~650) then sees every line as restyled to plain, so titles, checklists and bold are removed on every device. | Load body and runs together: one `note_open(guid) -> {text, runs}` command, or add `&& runs !== null` to `canEdit`. Also fixes #4. |-| 3 | **New-note formatting lost or reverted** | `NotesView.tsx:579-587`; `src-tauri/src/outbox.rs` `lay_note_create` (`runs: None`) | After `commitComposing`, `loadedRuns` for the new guid comes back `[]`, so `formatSafe` is false. Any keystroke before the first flush (within 900 ms) replaces `pending.runs` (the Title run) with `null`. All later saves are text-only. After the next sync, the `adopted` effect (`:983-987`) calls `replace(body, Apple's plain runs)`, so headings and checklists the user set disappear on screen. Apple never received them anyway. | In `commitComposing`, also call `setLoadedRuns({guid, runs: typedRuns ?? [plainRun(latest.length)]})` so `formatSafe` is true from the start. Store runs in `lay_note_create`. |-| 4 | **Flicker on every note switch** | `NotesView.tsx:338`, `:1563`; `NoteEditor.tsx:374` | Opening a note: (a) the editor unmounts and the "Opening…" spinner shows, (b) the editor mounts plain, (c) `replace()` re-lays it formatted when runs land, (d) each attachment waits for the network (see #5). Moving through the list with the arrow keys shows this sequence on every note. | Fetch body and runs together (#2). Keep the previous editor on screen until both have arrived, rather than showing the spinner. Show the spinner only after about 300 ms. Prefetch the neighbouring notes' bodies. |-| 5 | **Slow pictures and files on every open** | `NoteEditor.tsx:374-380`; `src-tauri/src/main.rs:3032-3042` | Every attachment calls `noteTable(id)` first. For a picture, PDF or file nothing is stored, so `note_table` makes a CloudKit `lookup_record` request over the network. A null result is never cached, so this happens on every open of every note. Only after it returns does `describe()` run, which is cached on disk. Offline, the request fails first. Inline pictures wait one network round trip each. | Call `describe(id)` first and call `noteTable` only when `kind === "table"`. In the backend, return `None` straight away when `notes.attachment.{id}` is cached with a kind other than table. |-| 6 | **Every keystroke re-renders the whole screen** | `NoteEditor.tsx:680-686, 748-749`; `NotesView.tsx:476-480`, `:1512`, `:1266` | Each key produces: a `fromDoc` walk of the whole note (deferred by 0 ms only, so one walk per key), then `setDraft` + `setEdits` + `setSaved` in `NotesView`, plus `setStatus` with a new object on every transaction (cursor moves too). Each of these re-renders all folder rows (`nestFolders` recomputed) and every note row (inline JSX, no `memo`, `listDate` per row). With hundreds or thousands of notes this adds visible latency in WebKitGTK. | Extract a `React.memo` `NoteRow`/`NoteList` (props: `sections`, `openGuid`). Call `setStatus` only when a field changed (shallow compare in `NoteEditor` before `onStatus`). Debounce `reportSoon` to about 150 ms (blur, unmount and `flushChange` already flush). Drop `setEdits`/`setSaved` when they are unchanged. |-| 7 | **Autosave reloads the list and blocks controls** | `NotesView.tsx:416-425` → `write()` `:232-240` | `flush()` goes through `write()`, so every autosave sets `busy` (disabling New Note, Pin and the folder picker, and showing "Saving…") and then `await read()` (folders + `notesIn` + counts + a full list re-render). `noteSave` only writes locally (outbox), and the outbox tick then triggers another `read()` + `noteBody` + `noteRuns`. The next save waits behind this read in `inFlight`. | Call `api.noteSave` directly in `flush` (catch → `setError`). Do not set `busy` and do not call `read()`. Update only the open row's title and snippet locally. The outbox tick already refreshes. |-| 8 | **Adding an attachment waits for a full sync** | `src-tauri/src/notes_cmds.rs:164`; `notes_attach.rs:482` | `note_attach_file` awaits `resync_notes` (a network sync pass) before it returns, once per file, so N files means N syncs. The placeholder stays "adding" through all of it. The frontend then also calls `noteBody` + `noteRuns` + `read()`. The first `lookup_record` (`:482`) is an extra round trip, because the loop at `:490` looks the note up again. | Write `attached.body` into the library (`set_note_text`) and return. Run `resync_notes` in the background with `tauri::async_runtime::spawn`. Drop the first lookup, or start the upload in parallel with it. In the UI, use `added.body` instead of fetching it again. |-| 9 | **Large photos decoded at full size inline** | `src-tauri/src/main.rs:338`, `NoteEditor.tsx:180` | The editor shows `Part::File`, which is the original image (12–48 MP from an iPhone, or a JPEG converted from HEIC at full size), scaled down by CSS. A long note with several photos means large decodes and large memory use while scrolling in WebKitGTK. | Serve an inline version fitted to about 1600 px (`quince_media::fit`, cached as `{id}-inline.jpg`). Keep the full file for `NotePicture` and Open. |-| 10 | **A keystroke can be overwritten** | `NoteEditor.tsx:923-937`; `NotesView.tsx:983-987` | `replace()` replaces the whole document without first sending the 0 ms-pending report. If a refresh of `noteBody` lands in the same tick as a key (`pending` null and draft equal to base just after a save), the key is replaced, and the pending report then sends the replaced document. The caret is restored by absolute position, so after a remote edit above the cursor it jumps. | At the top of `replace`: if `later.current !== null` call `report()` and return (let the parent's `pending` guard decide). Map the selection through a minimal diff step rather than `replaceWith(0,size)`. |-| 11 | **Media cache writes in place** | `src-tauri/src/main.rs:362` | `note_media_cached` writes the final file in place (`tokio::fs::write(&path)`). A parallel request (light and dark ink of a drawing, or the viewer) can read a truncated file. The `<img>` `error` handler then permanently turns it into a file chip. The two converted variants already write to `.part` and rename. | Write to `path.with_extension("part")` then `rename`, as at `:366-369`. |-| 12 | **The edited note keeps its old place in the list** | `crates/quince-core/src/notes.rs:135` | `set_note_text` (used by `lay_note` on every local save) does not set `modified_at`, so the list's "Date Edited" order and time stay unchanged until a sync. Apple moves the note to the top at once. | Also set `modified_at = now` in `lay_note` (or in `set_note_text` for local edits). |-| 13 | Copy | `src/screens/notes/LockedNote.tsx:104` | The button label is "Unlocking…" (trailing ellipsis on a button). | "Unlocking" (the spinner already shows progress). |--Checked and fine: outbox take/amend (`tries` counts as in flight, so a save in flight is never amended), conflict retry in `edit_rich_cloudkit_from`, index-panic guards in `topotext.rs` and `ckdocument.rs` (indices are bounds-checked before use), FTS triggers, list SQL indexes, cleanup of `describe()` retry timers, no animations in `notes.css`.--## Details--### 1. Ctrl+N after creating a note duplicates it-Repro (from reading the code): New Note, type "Groceries", pause 1 s (`commitComposing` sets `adoptedKey.current = guid`; the editor key stays `"composing"`), then press Ctrl+N. `create()` sets `composing` and `openGuid=null`. The key at `:1503` is still `"composing"` and `canEdit` stays true, so `<NoteEditor>` is not remounted and still contains "Groceries". `autoFocus` and `placeholder` apply only at mount. Typing "x" calls `apply` → `setComposing({body: "Groceries…x"})`, and 900 ms later `noteCreate` makes a second note holding the first one's text.-Fix: in `create()`, `adoptedKey.current = null;` before `setComposing(...)`.--### 2. Formatting wiped when typing just after opening-- `canEdit` (`:872`) requires `body !== null` only.-- First key with runs still null: `base.current = {text, runs: null}` (`:470`), `pending.runs = null`.-- Runs arrive. The `adopted` effect is skipped because `pending` is set. `formatSafe` becomes true.-- Next key: `pending.runs = typedRuns`. These come from the plain document the editor was mounted with.-- `flush` sends `runs=plain`, `baseRuns=null`. `record_note_save` fills `base_runs` from the stored (Apple) runs. `keep_their_formatting` then sees every line changed from formatted to plain and writes plain to Apple.--The window is the gap between the `noteBody` and `noteRuns` IPC calls. It is small, but the result cannot be undone. A single `note_open` command that returns both closes it, and also removes the plain-then-formatted repaint in #4.--### 5. One network request per attachment on every open-`attachmentView` → `api.noteTable(id)` → `note_table` → `table::stored` misses for any non-table attachment → `cloudkit_context` + `lookup_record("Notes", id)`, and nothing is cached when the result is `None`. Only then does `showMedia` → `describe` (cached on disk at `main.rs:526`) run. A note with 6 photos therefore makes 6 CloudKit requests before any picture starts loading, every time it is opened. Offline, each request has to fail first. Swapping the order (describe first, table only when `kind === "table"`) makes cached notes draw their pictures straight from disk.--### 6 and 7. Typing cost-Per key today: a full `fromDoc` walk, then 3 or 4 React state updates in `NotesView` (`draft`, `edits`, `saved`, `status`). Each re-renders the folder column and every note row. Every 900 ms pause also runs `write()` → `busy` → `read()` (3 IPC calls and a full list diff), and then the outbox tick runs it again with `noteBody` + `noteRuns`. Memoising the list, comparing status before setting it, and having `flush` call `noteSave` directly should take a key back to one small re-render of the editor header.--### 8. Attachment speed-Critical path per file today: grant → `lookup_record` → upload asset → `lookup_record` → `records/modify` → **`resync_notes`** → return. Then `noteBody` + `noteRuns` + `read()`. Moving the resync into the background and using the returned `body` should leave about 3 round trips plus the upload.------**Summary**-1. Two real data bugs: Ctrl+N after a new note duplicates it (#1); typing before runs load, or in a just-created note, can wipe or drop formatting on Apple (#2, #3).-2. Slow opening comes from a CloudKit request per attachment on every open (#5), the spinner, plain and formatted repaint sequence (#4), and attachment adds that wait for a full sync (#8).-3. Typing latency on large accounts comes from whole-screen re-renders per key and a list reload on every autosave (#6, #7). All fixes are small and local.diff --git a/docs/audit/reminders-calendar.md b/docs/audit/reminders-calendar.mddeleted file mode 100644index 5b9f857..0000000--- a/docs/audit/reminders-calendar.md+++ /dev/null@@ -1,77 +0,0 @@-# Audit: Reminders and Calendar--Read-only audit, 2026-10-22. Nothing was built or run. Each finding comes from reading the code and cites file:line. Ranked by user impact.--## Ranked findings--| # | Impact | Where | Problem | Minimal fix |-|---|--------|-------|---------|-------------|-| 1 | High | `src/lib/outbox.ts:59-62`, `src-tauri/src/outbox.rs:1096,1105` | `quince://outbox-changed` has no service in it and fires twice on every drain. Every kept-mounted screen bumps `outbox.tick` whatever changed. A Notes or Contacts save therefore re-runs the Reminders read cascade and the Calendar 5-IPC `read()`. | Emit `{services:[...]}`, filter on `service` in `useOutbox`, and emit once after the drain. |-| 2 | High | `src-tauri/src/reminders_cmds.rs:98-139`, `crates/quince-core/src/reminders.rs:3517-3526`, `schema.rs:344-350` | `reminder_marks` holds the library mutex for up to 2,000 guids. Each guid costs `reminder_raw`, `reminder_parts`, `reminder_detail` (3 queries) and a full JSON parse. `reminder_parts` joins `reminder_alarms` on `reminder_guid`, which has **no index**, so every row does a full table scan. This runs on every `markKey`/`revision`/`outbox.tick`, and ticks and edits queue behind it. | Add `CREATE INDEX reminder_alarms_by_reminder ON reminder_alarms(reminder_guid)`. Batch it as one query per table with `IN (...)`, or take the lock per chunk. |-| 3 | High | `reminders_cmds.rs:141-160`, `reminders_more.rs:298-323` | The marks reply waits for up to 40 Urgent downloads from Apple, 6 at a time. Weekdays, place, person and link chips therefore show up seconds after a list opens, and the rows get taller (layout shift). A failed fetch is never cached, so every later call fetches all 40 again. Offline, each call stalls until the timeouts expire. | Return the local marks at once. Fetch Urgent in a spawned task and emit `reminders-urgent` with the results. Cache failures for a while. |-| 4 | High | `src-tauri/src/main.rs:128-135` (`whole: true`), `crates/quince-icloud/src/reminders.rs:741-770` | Each tag, link, early-alert, section, reorder, repeat and list write ends with a **full-zone** CloudKit walk. That walk also downloads each list's membership file one after another, then the whole result is applied under the library lock. `write()` awaits it (`RemindersView.tsx:563-600`), so later edits to the same reminder queue behind several seconds of re-sync. | Use `refresh_reminders(..., false)`. The delta walk already returns the other records a list change touches. |-| 5 | High | `src/screens/RemindersView.tsx:1813-2140` | Up to 1,000 rows (`MOST_AT_ONCE`) are rendered inline, with no `memo` and no windowing. All of them are rebuilt on each draft keystroke (`:1590`), search keystroke, drag-over target change (`:1935` `setDropBefore`), tick (`settling`/`leaving`/`departed`) and marks reply. Each row also does `lists.find` (`:1856`), and `markKey` joins every guid on each render (`:840`). | Extract a `memo` `ReminderRow`. Pass handlers through a ref and look lists up in a `Map`. Toggle the drop marker with a DOM class instead of state. Add `content-visibility:auto; contain-intrinsic-size:auto 44px` to `.rx-row`. |-| 6 | Med-High | `RemindersView.tsx:441-461` | `readExtras` is N+1. It makes one `reminders_tagged` IPC per tag, each returning full `Reminder` rows (up to 1,000), only to build guid→tags. It also makes one `reminders_in_smart_list` per custom list, used only for `.length`. Every call waits on the library lock. It runs on every `revision`, every `outbox.tick` (`:878-881`) and after every detail write (`:898`). | Add one command that returns `{tagsByReminder, customCounts}` from `SELECT reminder_guid,name FROM reminder_hashtags` plus a count per smart list. |-| 7 | Medium (data) | `RemindersView.tsx:766-769`, `src-tauri/src/outbox.rs:505-528` | `setNotes` writes on **every blur**, even when nothing changed, and `record_reminder_edit` has no no-op check. Clicking into Notes and back out queues an edit with the notes as shown. If the phone changed them and the pass has not landed yet, Apple gets the old text: the phone's edit is lost. | `if ((notes.trim() \|\| null) === (r.notes ?? null)) return;`. `rename` already does this. |-| 8 | Medium | `src/screens/calendar/CalendarView.tsx:768-773`, `:816-822` | Delete awaits a **network** `eventAlerts` call (kept for Undo) before the event leaves the grid. ⌘D awaits `eventAlerts` and `eventRepeat` before the copy appears. Online this takes 0.5–2 s. Offline the event stays until the request times out. | Remove first (predict), then fetch alerts in parallel for the Undo payload. For duplicate, draw the copy first and add alerts and repeat when they arrive. |-| 9 | Medium | `src-tauri/src/main.rs:1833-1838`, `:1866-1871`, `:2318-2323`; `quince-core/src/contacts.rs:750-820` | `calendar_events`, `calendar_list` and `calendar_search` each call `library.contacts(None)` under the library lock. That builds every card: three full scans, details and a natural sort. Calendar only needs birthdays, and `read()` runs two of these per refresh. `calendar_list` also awaits two more mutexes while it holds the library. | Add `contacts_with_birthdays()` (`WHERE birthday IS NOT NULL`, names only) and use `EXISTS` for the sidebar flag. Drop the library guard before awaiting the `occasions`/`feeds` locks. |-| 10 | Medium | `crates/quince-core/src/reminders.rs:591-603`, `CalendarView.tsx:550` | `reminders_due_between` returns completed reminders as well, capped at `LIMIT 1000`, and the UI drops completed ones afterwards. In Year view (whole-year range), a busy account's completed history uses up the cap, so open reminders later in the year lose their dots and rows. | Add `AND r.completed_at IS NULL` to the SQL. |-| 11 | Low-Med | `RemindersView.tsx:898` | Stale closure: `detailWrite` re-reads `readDetail(openGuid)` with the guid captured **before** the multi-second network write. If the user opens reminder B meanwhile, `detailOf` becomes A's, and B's panel shows no link, alerts or tags until the next tick. | Keep `openGuid` in a ref and read `openRef.current` after the await. |-| 12 | Low-Med | `RemindersView.tsx:1641`, `:479-525`, `:1327-1330` | Search has no debounce, unlike Calendar's 120 ms. Each keystroke runs a search IPC, a marks IPC (with Urgent fetches) and an unlisten/listen of two Tauri listeners, because `readItems` is in the listener effect's deps. Grouping results also copies arrays in the loop (`[...(byList.get()), row]`), which is O(n²). | Debounce `query` by 120 ms. Call `readItems` through a ref in the listener effect. Push into the bucket instead of spreading. |-| 13 | Low | `crates/quince-icloud/src/calendar_feeds.rs:596-598` | `c[..7]` on a 9-byte colour slices bytes, and a non-ASCII value from an untrusted feed (`#12345€`) panics. | `if c.is_ascii() && ...` or `c.get(..7)`. |-| 14 | Low (copy) | `CalendarView.tsx:3435`, `:3091`, `:3106` | Button label "Subscribing…", and pickers whose only option is "…" while loading. This breaks the no-trailing-"…" rule and gives no real loading cue. | Keep "Subscribe" (disabled while busy). Show the picker disabled with its current value, or "Loading". |--## Details: top items--### 1. Outbox ticks reach every screen, for every service-`useOutbox(service)` filters `waiting`/`refused` by service, but `tick` increments on every `CHANGED`. `CHANGED` carries no payload (`app.emit(CHANGED, ())`) and is sent before and after each drain of all four services. `Library.tsx:295-313` keeps visited screens mounted, so one Notes autosave does all of the following:-- Reminders runs `readItems` (`:541-544`), `remindersApi.marks` over every row (`:841-853`, findings 2 and 3), `readExtras` (finding 6), `reminders_ending` and `readDetail`, twice each.-- Calendar runs `read()` (`CalendarView.tsx:554-567`): events for about 3.5 months, `calendar_list`, `reminders_due_between`, `reminder_lists` and the feed list. Two of those build every contact (finding 9). The new `events` array then re-lays out Month/TimeGrid.--A reminder tick inside Reminders triggers the same cascade on top of `write()`'s own `readItems` (`:589`) and the `reminders-synced` listener (`:515`): about 4 list reads, 2 marks calls and 2 N+1 tag sweeps per tick, all waiting on one mutex. This is where the "tick feels late" and "everything stalls while typing a note" latency comes from.-**Fix:** `emit(CHANGED, ChangedPayload { services })` with the services that had pending or sent items. In `useOutbox`, `listen<{services:string[]}>(CHANGED, e => { read(); if (!e.payload?.services || e.payload.services.includes(service)) setTick(n=>n+1); })`. Drop the pre-drain emit when nothing is queued for that service.--### 2 and 3. `reminder_marks`: lock-heavy, unindexed, network-gated-- Lock: `let library = data.0.lock().await;` (`reminders_cmds.rs:103`) is held across the whole `for guid in guids.iter().take(2_000)` loop. Each guid runs 5–6 queries, `serde_json` parses the raw record (several KB), and `contact_name_for` loads the **entire** `contact_methods` table for each reminder that has a messaging person (`reminders.rs:3599-3610`).-- Index: `reminder_parts` (`reminders.rs:3518-3524`) has `JOIN reminder_alarms a ... WHERE a.reminder_guid = ?1`. The only index on that table is `reminder_alarms_by_trigger(trigger_id)` (`schema.rs:350`), so 1,000 rows mean 1,000 scans of every alarm, completed reminders' alarms included.-- Network: after the lock, up to 40 `urgent_for` calls are awaited before the IPC returns. `URGENT_SEEN` is filled only on success (`reminders_more.rs:288-291,313-317`), so a lapsed `downloadURL` or offline state retries all 40 on every call.--Visible effect: open a list and the rows draw. Seconds later the chips row (Weekdays, place, link) appears and every affected row grows by a line, which is a visible jump. Meanwhile a tick's `set_done` waits on the mutex.-**Fix:** add the index. Build marks with a few set-based queries keyed by `IN (…)`, and load `contact_methods` once. Return without Urgent, then spawn the Urgent fetch and `emit("quince://reminder-urgent", Vec<(guid,bool)>)`. The UI merges the result into `marks`. Store `None` results with a timestamp so failures are not retried on every call.--### 4. Full-zone re-sync after detail and list writes-`resync_reminders` passes `whole = true`, so `since = None` (`main.rs:173-182`). That walks the entire zone, including years of completed reminders, and `fetch_memberships` downloads one file per list in sequence (`reminders.rs:741-770`). The apply step then rewrites every row and alarm (`put_alarms(..., whole)` deletes and re-inserts all alarms) inside one transaction on the library lock. Callers include `finish()` in `reminders_cmds.rs:189-200` (tags, URL, early alert, sections), `reminder_reorder`, `reminder_set_repeat` and the list commands in `main.rs`. A drag-reorder, for example, keeps the reminder's write queue (`RemindersView.tsx:579-582`) busy for the whole walk. The comment's reason ("a list change moves records other than the one written") does not need a whole pass: a token-based walk returns every record changed since the token, the side-moved ones included.-**Fix:** `refresh_reminders(http, root, params, data, false)`. Keep `whole` for an explicit "Refresh" or a refused cursor, which `fetch_cloudkit` already detects.--### 5. 1,000-row list without memoisation-All row JSX is produced inside `sections.map(... section.rows.map(...))`, so any state change in `RemindersView` re-runs it all. Examples:-- **Typing a new reminder**: `setDraft` on each key reconciles every row's `<input>`, chips and handlers.-- **Dragging**: `setDragging` on drag start and `setDropBefore` each time the hovered row changes. Each one is a full-list render while the pointer moves.-- **Ticking**: `setItems(patch)`, then `setSettling`, then `setLeaving` 600 ms later, then `setDeparted` and the confirming `readItems`. That is 4–6 full renders per tick, plus the ones from finding 1.--WebKitGTK is the slowest engine here, and 1,000 rows of about 25 nodes each is roughly 25k nodes diffed per keystroke.-**Fix:** move the row body into `const ReminderRow = memo(...)` with props `{reminder, depth, isOpen, mark, tags, colour, dated, showList, dropBefore:boolean, ...}`. Pass actions through a single stable `actions` ref object. Build a `Map` from list guid to list once per `lists`. For the drop marker, set `el.classList.toggle("is-drop-before")` in `onDragOver` instead of React state. Add `content-visibility:auto` to `.rx-row` so off-screen rows are not laid out or painted. It is opacity-free and not a compositor animation, so it is safe for the Hyprland flicker rule.--### 6. Tag and smart-list N+1-With T tags and C custom lists, every `readExtras` call makes T + C + 2 IPC calls, and they serialise on `data.0.lock()`. Each `reminders_tagged` builds and serialises up to 1,000 full reminders. One `SELECT reminder_guid, name FROM reminder_hashtags` (already written as `all_tags_by_reminder`, `reminders.rs:2950-2960`) returns the same map in a single query.--### 7. Notes blur writes unconditionally-`onBlur={(e) => void setNotes(reminder, e.target.value)}` (`RemindersView.tsx:2098`) calls `write(r, () => api.reminderEdit(..., { notes }))` with no comparison. The backend queues it (`outbox_append`) and lays it on the library immediately, so the phone's newer notes are overwritten locally and then at Apple when the outbox sends. Pressing Tab through the detail panel is enough to trigger it.--### 8. Calendar delete and duplicate wait on Apple-`remove` (`CalendarView.tsx:761-788`) reaches `await api.eventAlerts(guid)` before `write(...)` applies the predicted removal. That command goes to Apple each time (`main.rs:1680-1697`). The same applies to ⌘D (`:811-822`). This breaks the "instant everywhere" rule: offline, Delete looks broken until reqwest times out.--### 10. Year view loses open reminders-`reminders_due_between` has `WHERE ... r.due_at >= ?1 AND r.due_at < ?2 ORDER BY r.due_at LIMIT 1000` with no completed filter. The year range covers 12 months of completed one-offs, and the client then discards them (`filter((r) => !r.completedAt)`). Once a year holds more than 1,000 dated reminders, the open ones in later months are cut off. Adding `AND r.completed_at IS NULL` uses the same `reminders_by_due` index.--## Checked and fine-- Calendar search is debounced (120 ms). TimeGrid drag renders only when the position moves to a new quarter-hour. MonthView, TimeGrid and YearView are memoised, and `byDay` is computed once.-- Date formatters are cached (`src/lib/when.ts`), the row fade uses opacity drawn by the page, and the popover has no open animation.-- Reminder tick, edit, create and delete and event save/delete go through the outbox, so they are local first.-- The repeat-tick double-click guard (`held` ref) is correct, and alarms ring once (`alarm_fired`) with a sleep and resume wake-up.-- No `unwrap` or `expect` on network input in non-test Reminders and Calendar code, apart from finding 13.--## Summary-Main causes: outbox ticks that ignore the service (1), plus a lock-heavy, unindexed `reminder_marks` that waits on the network (2, 3), stall Reminders and Calendar even while you work in Notes.-Writes run a full-zone CloudKit re-sync (4), and an unmemoised list of up to 1,000 rows re-renders on every keystroke, drag move and tick (5).-Data safety: blurring Notes can overwrite a newer phone edit (7). Calendar delete and duplicate wait on the network (8), and Year view can drop open reminders (10).diff --git a/docs/audit/shell-ux.md b/docs/audit/shell-ux.mddeleted file mode 100644index b5d90b4..0000000--- a/docs/audit/shell-ux.md+++ /dev/null@@ -1,143 +0,0 @@-# Shell and cross-app UX audit--Scope: `src/App.tsx`, `src/screens/Library.tsx`, `src/components/*`, `src/lib/*`, `src/styles/*.css`,-`src-tauri/src/apps.rs`, and the window and tray code in `src-tauri/src/main.rs`. This was a-read-only audit: nothing was built or run. Every line number below was checked against the-source on 2026-10-22.--## Ranked findings--| # | Impact | Where | Problem | Minimal fix |-|---|--------|-------|---------|-------------|-| 1 | High | `src-tauri/src/main.rs:1544-1546`, `:1501`; callers `Library.tsx:238,241`, `Account.tsx:45` | `account_services` and `account_info` `lock().await` the auth client. That mutex is held across Apple round trips by `auth_resume` (`:894-900`), by `keep_signed_in` on every `sync_all`/`sync_some` (`:955-959`) and by the heartbeat (`:1569-1577`). At launch the window is shown with an empty sidebar ("Loading…") and a blank content pane until Apple answers. | Answer both commands from a snapshot, as `auth_status` already does with `try_lock` and `auth.known` (`:871-874`). Add the service keys and the account facts to `SessionFacts`. |-| 2 | High | `src/lib/sync.tsx:74,104,128-131`; `main.rs:4558,4582,5645-5650`; `refresh.rs:205…442` | `revision` is one global counter. It ticks once for each service that lands (6), again for the `SYNCED` emitted by `sync_all`, and again in `refresh()`'s `finally`. That is 8 or more ticks per pass, sent to every window. Notes, Reminders and Calendar re-read on every tick even while hidden (`NotesView.tsx:147,219,359,377,469`; `RemindersView.tsx:539,544,828,838,853,869`; `CalendarView.tsx:566`). The result is dozens of IPC reads and re-renders per pass, mostly for services that did not change. | Keep a revision per service, derived from `report.services[x].lastSyncedAt` (`useRevision("notes")`). Drop the bump in `finally` unless the call threw. Gate hidden screens the way Photos, Contacts and Drive already do (`seen`/`active`). |-| 3 | High | `src/lib/sync.tsx:113-125`; `refresh.rs:174,216,265,311,366,405` | Every window's `SyncProvider` runs a full `sync_all` when it mounts. Opening one app from its launcher (`--app notes`) therefore walks all six services, Photos included, and first takes the client lock for a heartbeat (feeds #1). A second pass queues behind the per-service `*_PASS` mutexes and runs again instead of joining the first. | Coalesce on the backend: if a pass is running, wait for it and return its result; if the last pass finished less than about 60 s ago, return `refresh::status`. In the UI, skip the launch refresh when `report.asOf` is recent. |-| 4 | Medium | `src/App.tsx:100-110`; no `.lapsed` rule in any stylesheet | The "Apple signed you out" notice is a `.toast` drawn in normal flow before `.library`, outside `.toast-host`. `#root` and `.library` are both `height:100%`, so the notice pushes the whole library down by about 40 px. The sidebar foot (account, Update Now) and the toast area are cut off at the bottom, and the notice sits unstyled at the top left. | Send it through `toast({ tone: "error", duration: null, action: { label: "Sign In", … } })`, or give `.toast.lapsed` a fixed position inside the toast host's area. |-| 5 | Medium (data) | `src/components/ImportSheet.tsx:36,40,42,69-73,161,216,219` | (a) `key={current.file + queue.length}`: a second file arriving during "Adding" remounts the sheet. Add is enabled again and a second click imports every event twice. (b) Escape during an import calls `onDone` (Shell's Escape is not disabled while busy). When `add()` finishes it calls `onDone()` again, and `done` is `q.slice(1)`, so the **next queued file's sheet is dropped unseen**. | Give each arrival a stable id, key on it, and have `done(id)` remove that arrival by identity. Ignore Escape while `busy`. |-| 6 | Medium | `main.rs:4878` (`window_ready`, a sync command on the GTK main thread), `:5420` (CloseRequested), `:5059-5091` | `tray_reachable` opens a new blocking zbus session connection and makes a call (1 s timeout) every time. In `window_ready` it is evaluated **before** `login::stay_hidden`, so every normal launch pays a D-Bus round trip on the main thread before `show_window`. Every window close does the same, and all windows freeze while it waits. | Reorder to `login::stay_hidden(..) && tray_reachable(..)`. Cache host presence (refresh it from ksni's watcher callbacks or a background task) and read an `AtomicBool` here. |-| 7 | Medium | `src/App.tsx:21-26`; `Library.tsx:241-261,286-293,495` | `window_ready` fires as soon as `phase === "library"`. At that point `services()` has not answered (see #1) and the chunk for the selected screen has not even started loading (`Suspense fallback={null}`). The window maps onto a blank content pane. | At module load, read `LAST_KEY` and call `apps[last].fetch()` straight away. Send `window_ready` from `Library` once `ready` is true and that chunk has resolved, keeping the 3 s fallback. |-| 8 | Medium (flicker) | `src/styles/app.css:530,535` | In a narrow window (≤900 px) the sidebar slides in with a 300 ms `transform` transition on a full-height, shadowed layer. This is the exact large-layer motion that `tokens.css:105-108` records as flickering under WebKitGTK on Hyprland. | Make it instant (`transition: none`, toggle `visibility`), or fade it with the page-driven `fadeIn` from `lib/fade.ts`. |-| 9 | Medium | `Library.tsx:366-377` with `:297-299` | Arrow keys in the sidebar call `choose()` on every press, and every screen ever chosen stays mounted. Holding ↓ mounts all six apps (the Photos grid, the Notes editor) and fires all their first reads at once, so input stalls. | Move only the focus on arrow keys. Select after about 150 ms with no further arrow press (clear a timer on each key), or on Enter/Space. |-| 10 | Medium (a11y) | `Library.tsx:389` | `tabIndex={selected === key ? 0 : -1}`. With Settings in front, no app row has tabIndex 0, so Tab cannot reach the app list. | `tabIndex={selected === key \|\| (!services.includes(selected ?? "") && index === 0) ? 0 : -1}` |-| 11 | Low-Med | `GlobalSearch.tsx:204-208`; `Library.tsx:86-92,107-115` | Ctrl+K, Ctrl+, , Ctrl+/ and Ctrl+R/F5 fire while a modal sheet (Confirm, Import, Shortcuts) is open. Ctrl+K takes the focus out of the modal into the field behind the veil. Ctrl+, swaps the screen under an open sheet. | Return early when `document.querySelector('[aria-modal="true"]')` is present (or use a narrowed `overlayOpen()`). |-| 12 | Low (flicker) | `app.css:606,612`; `SignIn.tsx:87`; `CodeEntry.tsx:78` | The sign-in and code sheets still use a compositor CSS keyframe (`sheet-in`) with `backwards` fill. That is the kind of animation `lib/fade.ts` was written to replace. On first launch the window maps with the sheet at opacity 0. | Remove `.enter-sheet` or call `fadeIn(ref.current)` in a layout effect. |-| 13 | Low (perf) | `Face.tsx:275` | `decoding="sync"` on every avatar decodes on the main thread during paint, which causes jank while Contacts and search rows scroll in. | Use `decoding="async"` and set `ready` after `img.decode()` resolves. The photo is already hidden until it is ready (`.face-photo.is-loading`), so no half-drawn frame shows. |-| 14 | Low (perf) | `lib/fade.ts:363-374` | `fadeSheetsIn` watches the entire `body` subtree. Every element inserted anywhere (photo tiles, editor spans, search rows) runs `matches` and `querySelectorAll`. | Observe `document.body` with `{ childList: true }` only (all sheets are portalled to body). Fade the in-veil sheet swap in `ImportSheet` with `fadeIn` from Shell's layout effect. |-| 15 | Low (copy) | `ImportSheet.tsx:220,284`; `SettingsView.tsx:636,706`; `Account.tsx:59,66` (text of the `.sidebar-sync` button) | Button labels end in "…" ("Adding 2 of 5…", "Adding…", "Syncing…", "Clearing…", "Updating…"). This breaks the copy rule. | "Adding 2 of 5", "Adding", "Syncing", "Clearing", "Updating". Put a spinner beside the label if motion is needed. |-| 16 | Low | `QuickCapture.tsx:96`; `GlobalSearch.tsx:196-198` | Enter in quick capture before the lists load (`target === ""`) does nothing and says nothing. A search that fails is swallowed, so typing shows no results and gives no reason. | Show "Loading lists" in the status line and keep the text so Enter can be pressed again. On a search error, show "Search isn't available right now" in the panel. |-| 17 | Low (cleanup) | `Library.tsx:197-226`; `components/SyncStatus.tsx`; `app.css:1121`, `calendar.css:577` | The rail layout effect is dead (`void from`), yet `toggleRail` still forces a synchronous layout (`getBoundingClientRect` and `getComputedStyle`) on every click. `SyncStatus` is never imported. The `picker-in` and `cx-pop` keyframes are unused. | Delete them. |--## Details: top items--### 1. Startup and new app windows wait on Apple behind the auth mutex-`App.tsx:45-46` deliberately starts `api.resume()` and opens the library at once, so that "a-round trip to Apple … is never what stands between a launch and the window". The library's first-two calls do wait for it, though:--```rust-// main.rs:1544-async fn account_services(auth: State<'_, Auth>) -> UiResult<Vec<String>> {- let client = auth.client.lock().await; // held by auth_resume across resume_session().await-```-`account_info` (`:1501`) does the same. `services()` is what sets `ready`, `selected` and the-first `kept` screen (`Library.tsx:241-259`). Until it returns, the sidebar shows only "Loading…"-and the content pane is empty, in a window `window_ready` has already shown. A new app window has-the same problem with `keep_signed_in`, which holds the lock for a heartbeat at the start of every-`sync_all`. The comment on `LIVE` (`main.rs:1210-1212`) records the same class of stall ("kept-every app window waiting about five seconds"), but that fix covered only `auth_resume`.--`webservices` is part of the stored `Session` (`quince-auth/src/session.rs:83`), so the answer is-available before the resume finishes. Snapshot it into `SessionFacts` and update the snapshot in-`signed_in`. Then answer with `try_lock`, falling back to the snapshot, as `auth_status` does.--### 2. One global `revision` makes every screen re-read 8 or more times per pass-- `main.rs:5645-5650`: every `landed(service)` emits a full `SYNCED`, 6 per pass.-- `main.rs:4558`: `sync_all` emits `SYNCED` again, then returns.-- `sync.tsx:74`: `finally { setRevision(n => n + 1) }` adds one more.--Every window gets every event. In each window, Notes re-runs `read()`, `noteBody`, `noteRuns` and-`refreshTables` on each tick, even while Reminders is in front, and Reminders re-runs six-effects. A pass where nothing changed still sends 8 or more waves of IPC through all mounted-screens in every open window, which also re-renders them during scrolling. Photos, Contacts and-Drive already defer while hidden (`PhotosView.tsx:833-837`); the other three do not.--Fix: in `SyncProvider`, expose `useRevision(service)` as a counter that moves only when that-service's `lastSyncedAt` or outcome changes, and let screens depend on it. Remove the-unconditional bump in `finally`, keeping it only for the `catch` path, where no event arrives.--### 3. Every window runs its own full sync when it opens-`SyncProvider`'s mount effect always calls `refresh()` → `sync_all`. The main window and each app-window (`apps.rs:150-160`) each have their own provider. Opening Notes from the launcher, or-re-making a window after it was put away for 10 minutes, starts a six-service pass and contends-for the auth lock (#1). The backend serialises passes per service (`*_PASS` mutexes) but never-merges them, so the second caller does all the network work again. Merging the passes on the-backend fixes this for every caller, including the 30 s focus-return refresh in each window.--### 4. The "signed out" notice breaks the layout-```tsx-// App.tsx:100-{lapsed && (<div className="toast lapsed" role="alert"> … </div>)}-<Library onSignOut={signOut} />-```-`.toast` only styles a card (`kit.css:380`); positioning comes from `.toast-host`. No stylesheet-has a `.lapsed` rule. The card therefore takes up space at the top of `#root`, and-`.library { height: 100% }` overflows below it. This happens every time Apple ends the session,-which is exactly when the person most needs the window to look intact.--### 5. ImportSheet can import twice or drop a queued file-- `key={current.file + queue.length}`: a second `.ics` opened while the first is "Adding 3 of 40"- remounts `EventsSheet`, so `busy` is reset and Add is live again. The first loop is still- running.-- `Shell` passes Escape to `onCancel = onDone` with no `busy` guard. When the running `add()`- finishes it calls `onDone()` (`:161`), which does `setQueue(q => q.slice(1))` and removes the- **next** file's sheet before anyone sees it.--Fix: give each `Arrival` an id when it is queued, use `done = (id) => setQueue(q => q.filter(a => a.id !== id))`,-key on the id, and pass `onCancel={busy ? () => {} : onDone}`.--### 6. Blocking D-Bus on the main thread when showing and closing windows-`window_ready` is a synchronous `#[tauri::command]`, so it runs on the main thread. It evaluates-`tray_reachable(&app) && login::stay_hidden(..)`, and `status_notifier_host()` builds a new-blocking session-bus connection and makes a property call each time. `stay_hidden` is false-except when the app was started at login, so the D-Bus work is wasted on almost every launch, and-it happens just before the first show. The `CloseRequested` handler does the same work on every-close. Swapping the operands removes the cost at launch. Caching the result removes the cost at-close.--### 7. The first visible frame is an empty shell-Even once #1 is fixed, the screen's code is not requested until `services()` resolves and-`screenFor()` renders. The other chunks are fetched 300 ms after `ready`. Starting the last-screen's `import()` at module load runs the download and parse in parallel with `auth_status`.-Moving `window_ready` to the point where `ready` is true and that chunk has resolved means the-window maps showing real content.--### 8. Narrow-window sidebar motion-`.sidebar` at ≤900 px: `transition: transform var(--spring-quick-d) var(--spring-quick)`. The-`.sidebar` element is 196 px wide, nearly the window's height, carries a shadow, and is a-`contain: layout paint` layer. `tokens.css:105` names "the sidebar" among the layers that-flickered. Make it instant; the scrim already is.--### 9 and 10. Keyboard in the sidebar-Selection follows focus (`move()` calls `choose()`), and `keptRef` never forgets a screen, so-arrowing through the list builds every app. In Settings the roving tabindex has no stop at all.-Both are one-line fixes (see the table).--## Checked and fine-These were verified and are not listed above:-- The toast timers (pause on hover/focus, count only while visible).-- RowMenu menu aim and its Escape handling.-- Picker placement before paint.-- The `useModalFocus` trap and focus return.-- The page-driven `fadeIn`/`fadeOut`.-- Screens kept mounted with `hidden` plus `inert`, and the Portal gating.-- Out-of-order search answers being dropped.-- The window colour following the theme (`tint.ts`).-- The 3 s fallback show for hidden windows.-- Putting app windows away and freeing them after 10 minutes.-- Progress bars driven by `transform`.-- Small spinners on small layers only.--## Summary-The two biggest problems are both in the sync path. Launch and new app windows wait on Apple behind the auth mutex (#1, #3), and one global `revision` makes every mounted screen in every window re-read 8 or more times per pass (#2).-The visible glitches are the unpositioned "signed out" notice (#4), the blank first frame (#7), and the narrow-window sidebar slide on a large layer (#8).-The one data-safety bug is in ImportSheet: a remount or an Escape mid-import can import events twice or silently drop the next queued file (#5). The rest are small fixes for keyboard, accessibility and copy.diff --git a/docs/comparison-draft.md b/docs/comparison-draft.mddeleted file mode 100644index b7381c4..0000000--- a/docs/comparison-draft.md+++ /dev/null@@ -1,240 +0,0 @@-<!---DRAFT, not published. Written 2026-11-03.-Every number below was checked on 2026-11-03 (GitHub API, Snapcraft API, Microsoft Store-listing, Apple Support, project READMEs). Re-check stars, dates and versions before publishing.--->--# Every way to use iCloud on Linux and Windows--You have an iPhone. Your computer runs Linux or Windows. You want your notes, reminders,-calendar, contacts, files and photos on both.--There are several ways to do that today. Some are from Apple, some are open-source projects,-and some are standard protocols that many apps speak. Each one is good at something. This page-lists them side by side, says what each covers, and links to the source for every claim, so you-can pick what fits you.--Skykeep is one of the options. I make it, so I've tried to be fair to everyone else and plain-about what Skykeep does and doesn't cover. If something here is out of date or wrong, please-[open an issue](https://github.com/YashwanthKamireddi/Skykeep/issues).--## At a glance--| Option | What it covers | Platforms | Offline | Notes |-|---|---|---|---|---|-| [iCloud for Windows](#icloud-for-windows) (Apple) | Photos, iCloud Drive, Passwords; Calendars and Contacts through classic Outlook; Bookmarks | Windows 11 | Drive files and photos you choose to keep on the device | From Apple. The Store listing doesn't list Notes or Reminders |-| [icloud.com in a browser](#icloudcom-in-a-browser) (Apple) | Photos, Drive, Notes, Mail, Calendar, Contacts, Reminders, Pages, Numbers, Keynote, Find My and more | Any computer with a supported browser | No | From Apple. Apple names Firefox, Chrome, Edge and Opera on Windows |-| [Web app wrappers](#web-app-wrappers) | Whatever icloud.com offers, in its own window | Linux or Windows, per project | No | You sign in on Apple's own page |-| [icloud-for-omarchy and its sibling apps](#icloud-for-omarchy-and-its-sibling-apps) | Notes, Photos, Find My; Calendar, Contacts, Reminders and Mail in sibling apps | Arch Linux and Omarchy | Notes are Markdown files on disk | Sign-in on Apple's own page; CLI with JSON output |-| [icloud-drive-for-linux](#icloud-drive-for-linux) | iCloud Drive | Linux | Files in folders you choose are saved to disk | Checks for changes about every five minutes |-| [icloud-linux](#icloud-linux) | iCloud Drive as a FUSE folder | Linux | Local cache of names and files | Command-line setup |-| [icloudpd](#icloudpd) | Downloads iCloud Photos | Linux, Windows, macOS, NAS | Downloads are ordinary files | Command line. Runs well unattended |-| [rclone iCloud backend](#rclone-icloud-backend) | iCloud Drive; iCloud Photos read-only | Linux, Windows, macOS | Whatever you copy or sync | Command line. Marked experimental by rclone |-| [CalDAV and CardDAV clients](#caldav-and-carddav-clients) | Calendars and contacts | Linux, Windows, macOS | Depends on the app | App-specific password. Reminders created in the iOS 13 format aren't on CalDAV |-| [Skykeep](#skykeep) | Notes, Reminders, Calendar, Contacts, iCloud Drive, Photos | Linux and Windows 10/11 | Yes: the library is on your disk | iCloud Drive and Photos as folders on Linux |--## Each option--### iCloud for Windows--Apple's own app, from the Microsoft Store. Its listing describes iCloud Photos in the Microsoft-Photos app, iCloud Drive in File Explorer, iCloud Passwords with extensions for Chrome, Edge and-Firefox, iCloud calendars and contacts "with classic Outlook", and Safari bookmarks in Chrome,-Edge or Firefox. The latest version needs Windows 11 or later and Outlook 2021 or later. Apple-says it doesn't support Managed Apple Accounts. You can pin Drive files and photos so they stay-downloaded.--**Good for:** Windows users who want iCloud Drive in File Explorer, photos in the Photos app and-their iCloud passwords in the browser, from Apple itself.--Sources: [Microsoft Store listing](https://apps.microsoft.com/detail/9PKTQ5699M62),-[Apple: iCloud for Windows requirements](https://support.apple.com/en-us/103232),-[Apple: keep iCloud Drive files downloaded](https://support.apple.com/guide/icloud-windows/keep-files-downloaded-icw8531ad6b7/icloud)--### icloud.com in a browser--Apple's web apps. Signed in on a Windows PC, you get Photos, iCloud Drive, Notes, Mail,-Calendars, Contacts, Reminders, Pages, Numbers, Keynote and Find My, among others. On Windows,-Apple recommends the latest Firefox, Chrome, Edge or Opera. It needs a-connection. With Advanced Data Protection on, access to your data on icloud.com is off by-default, and you can turn it on.--**Good for:** everyone, on any computer, with nothing to install. It also includes Mail, Find My,-and Pages, Numbers and Keynote.--Sources: [Apple: what you can do on iCloud.com](https://support.apple.com/en-us/105119),-[Apple: Advanced Data Protection](https://support.apple.com/en-us/102651)--### Web app wrappers--Small open-source apps that open icloud.com in a window of its own, so it gets a launcher entry-and sometimes a tray icon. You sign in on Apple's own page inside the window. A few examples:--- [cross-platform/icloud-for-linux](https://github.com/cross-platform/icloud-for-linux): a Snap- for Linux, about 578 stars. Version 0.26 is in the stable channel- ([Snapcraft](https://snapcraft.io/icloud-for-linux)); the repository was last updated in- October 2025.-- [cgillinger/icloud-electron](https://github.com/cgillinger/icloud-electron): Linux. Version 2- moved from Electron to a bundled, self-updating Chromium window, and its README says "Sign in- with iPhone" and passkeys work. It says plainly that it has no file sync.-- [taylorivanoff/icloud-notes-windows](https://github.com/taylorivanoff/icloud-notes-windows):- icloud.com/notes in a Tauri window on Windows, with a tray icon and start with Windows.-- [Swe-HimelRana/icloud-notes](https://github.com/Swe-HimelRana/icloud-notes): iCloud Notes on- Linux as a Snap or `.deb`, built on Electron.--**Good for:** people who like icloud.com and want it in its own window, with Apple's sign-in-page doing the sign-in.--### icloud-for-omarchy and its sibling apps--[ferdousbhai/icloud-for-omarchy](https://github.com/ferdousbhai/icloud-for-omarchy) is a set of-apps for Omarchy and Arch Linux that share one iCloud sign-in. Notes keeps your Apple Notes as a-folder of Markdown files, synced both ways, so you can edit them in the app, in Neovim or in-Obsidian. Photos lets you browse, download, upload and delete. Find My shows your devices on a-map. Every action also works from the command line, with JSON output. You sign in on Apple's own-page, and the apps never see your password. Packages come from a signed pacman repository.--The same author has sibling apps that reuse that sign-in:-[Cloud Calendar](https://github.com/ferdousbhai/cloud-calendar) (iCloud, Google and HEY-calendars), [Cloud Contacts](https://github.com/ferdousbhai/cloud-contacts) (iCloud and Google),-[Cloud Tasks](https://github.com/ferdousbhai/cloud-tasks) (iCloud Reminders and Google Tasks) and-[Cloudmail](https://github.com/ferdousbhai/cloud-mail). These were created in late September and-October 2026.--**Good for:** Arch and Omarchy users who want their notes as plain Markdown files, scriptable-iCloud from the terminal, or Find My on the desktop.--### icloud-drive-for-linux--[taylorhayis/icloud-drive-for-linux](https://github.com/taylorhayis/icloud-drive-for-linux) is a-Linux client for iCloud Drive, created in October 2026. You choose which folders to keep, and-their files are saved into `~/iCloud Drive`, an ordinary folder that stays when you quit. It has-a GTK window, a panel icon, an Activity tab and a conflict screen. Deleting from iCloud is off-until you turn it on. Its README says iCloud doesn't push changes to it, so it checks about every-five minutes.--**Good for:** people who want chosen iCloud Drive folders as ordinary files on disk, with a-careful approach to deletes and conflicts.--### icloud-linux--[IsmaeelAkram/icloud-linux](https://github.com/IsmaeelAkram/icloud-linux) mounts iCloud Drive as-a FUSE folder, with a local cache of names and file contents, so browsing and `find` work-against the disk. If a file changed on both sides, your copy is kept as a conflict copy. Remote-changes come in on a timer or when you run `icloudctl sync`. Setup is a few commands in a-terminal. About 159 stars.--**Good for:** people comfortable in a terminal who want iCloud Drive mounted as a folder, with-control over which folders are downloaded.--### icloudpd--[icloud_photos_downloader](https://github.com/icloud-photos-downloader/icloud_photos_downloader)-is a command-line tool that downloads your iCloud Photos. It runs on Linux, Windows, macOS and-NAS boxes, and can keep watching for new photos. It has existed since 2016 and has about 12,370-stars. Its README currently says the project is looking for a maintainer.--**Good for:** backing up a whole photo library to your own disk or NAS, unattended.--### rclone iCloud backend--[rclone](https://rclone.org/iclouddrive/) added an iCloud backend in v1.69. It covers iCloud-Drive, and iCloud Photos read-only. rclone lists it as Tier 4: "Experimental: Use with care;-expect gaps/changes." It works with Advanced Data Protection. It needs your Apple Account-password (app-specific passwords are not accepted), and the trust token lasts 30 days before you-sign in again.--**Good for:** people who already use rclone and want to copy, sync or mount iCloud Drive from-scripts, next to their other clouds.--### CalDAV and CardDAV clients--iCloud calendars and contacts speak the standard CalDAV and CardDAV protocols. Thunderbird,-Evolution and GNOME (through Evolution or GNOME Online Accounts) can connect to them with an-app-specific password. Apple made app-specific passwords so that "your Apple Account password-can't be stored or collected by the app." This route doesn't cover Notes, iCloud Drive or-Photos. Reminders upgraded to the format introduced in iOS 13 no longer use CalDAV.--**Good for:** keeping iCloud calendars and contacts in the mail and calendar app you already-use, without giving that app your Apple Account password.--Sources: [Apple: app-specific passwords](https://support.apple.com/en-us/102654),-[BusyCal: Reminders and CalDAV](https://www.busymac.com/docs/faqs/112990-reminders-in-ios-13-and-macos-catalina-drops-support-for-caldav),-[Mozilla Support: CardDAV in Thunderbird](https://support.mozilla.org/en-US/questions/1347462),-[GNOME Discourse: iCloud in GNOME Settings](https://discourse.gnome.org/t/gnome-settings-carddav-caldav-icloud-account/22859)--### Skykeep--[Skykeep](https://github.com/YashwanthKamireddi/Skykeep) gives you Notes, Reminders, Calendar,-Contacts, iCloud Drive and Photos as six real desktop apps on Linux and Windows 10/11, with one-sign-in, built on a native Rust engine. Your library is kept on your computer, so it opens straight away and works offline:-notes, reminders, events and contacts can be edited offline and sync when you reconnect.--- Notes and Reminders changes from your iPhone usually arrive in about a second, over Apple's- push channel. Calendar and Contacts are checked every few seconds while you use Skykeep.-- A note edited on both sides at once is merged, not overwritten.-- On Linux, iCloud Drive and Photos are also real folders in your file manager (FUSE).-- Desktop alerts with Complete and Snooze, quick capture, a tray icon, and results in GNOME and- KDE search.-- On Windows, each app has its own Start-menu entry and taskbar button, plus a jump list.-- Export Everything saves notes as Markdown, events as iCalendar, contacts as vCard, and your- files as they are.-- It connects to Apple for your iCloud, to the calendars you subscribe to, and to GitHub's- release servers for its own updates (AppImage and Windows copies, and you can turn that off).- No Skykeep account, no Skykeep servers, no analytics, no telemetry, no crash reporting.-- Free and open source under the GPL-3.0. A native Rust engine, with Tauri 2 for the windows.--**Good for:** people who want all six iCloud apps on Linux or Windows, kept on the computer and-usable offline.--Sources: [README](https://github.com/YashwanthKamireddi/Skykeep#readme),-[SECURITY.md](https://github.com/YashwanthKamireddi/Skykeep/blob/main/SECURITY.md)--## Good to know before you install--- **Your Apple Account password.** Notes, Reminders, Drive and Photos need a full sign-in- with two-factor, so Skykeep asks for your Apple Account password, not an app-specific- password. It never sends the password, not even to Apple (Apple's SRP sign-in). It keeps your- password and session in your system keyring so it can sign back in by itself. Like any keyring- entry, programs running as you can read it. Signing out erases it.-- **Advanced Data Protection** works with **Access iCloud Data on the Web** turned on. With it- off, Apple doesn't let apps outside your devices read your iCloud data, Skykeep included.-- **Managed Apple Accounts** from a school or workplace aren't supported yet. Personal Apple- Accounts work.-- **Shared notes, shared calendars and replying to calendar invitations** are on the roadmap.-- **iCloud Drive and Photos as folders are a Linux feature.** On Windows, and in the Flatpak, they open- inside the app.-- **The Windows installer isn't code-signed yet.** Windows SmartScreen asks you to confirm (More- info, then Run anyway). Releases are built by the repository's release workflow, the release- page lists SHA-256 checksums, and in-app updates are signature-checked.-- **The library on disk isn't encrypted by Skykeep.** Use full-disk encryption, as you would on- any laptop.-- **Linux needs a recent system:** WebKitGTK 4.1, a keyring (GNOME Keyring or KWallet), glibc- 2.39 and libheif 1.17 or newer, for example Ubuntu 24.04, Debian 13 or Fedora 41. AUR and- Flathub packages are coming; for now, Arch users build from the PKGBUILD.-- **It covers six iCloud apps.** It doesn't do Mail, Find My, Passwords, or Pages, Numbers and- Keynote. For those, icloud.com and the other options above may suit you better.--## Picking one--- Want Mail, Find My, Pages and the rest, with nothing to install? Use **icloud.com**.-- On Windows 11 and want Drive in File Explorer and your passwords in the browser? Use **iCloud- for Windows**.-- Want iCloud in its own window, signing in on Apple's page? Try a **web app wrapper**.-- On Arch or Omarchy and like Markdown and the terminal? Try **icloud-for-omarchy**.-- Want iCloud Drive as files on disk? Try **icloud-drive-for-linux**, **icloud-linux** or- **rclone**.-- Want to back up your photos? Use **icloudpd**.-- Want calendars and contacts in Thunderbird or Evolution? Use **CalDAV and CardDAV** with an- app-specific password.-- Want Notes, Reminders, Calendar, Contacts, Drive and Photos as desktop apps that work offline?- Try **Skykeep**.--Many of these work well together. For example, you can use icloudpd for photo backups next to any-of the others.-------Skykeep is an independent, open-source project. It is not affiliated with or endorsed by Apple-Inc. Apple, iCloud and iPhone are trademarks of Apple Inc. The other projects named here are-their authors' own work; star counts and dates were checked on 3 November 2026.diff --git a/docs/good-first-issues.md b/docs/good-first-issues.mddeleted file mode 100644index 7433b22..0000000--- a/docs/good-first-issues.md+++ /dev/null@@ -1,310 +0,0 @@-# Good first issues: drafts--Fifteen issues to file on GitHub on launch day, each checked against the code on 2026-10-25 and sized for about an afternoon.-Every issue carries **good first issue**, or **help wanted** where it needs some specialist knowledge, plus area labels picked from the repo's existing set: `packaging`, `windows`, `rust`, `javascript`, `accessibility`, `sync`, `notes`, `drive`, `contacts`, `design`, `bug`, `enhancement`, `documentation`.-Most of them can be tested without an Apple Account. The `.uiverify/` Playwright suites run the real interface against `npx vite preview --port 4173` with a stubbed IPC and sample data (`.uiverify/stub.mjs`, plus the invented demo library in `.uiverify/readme-fixture.mjs`), and the Rust parsers have plain unit tests.-------## 1. `skykeep --help` and `--version` print and exit--**Labels:** good first issue, enhancement, rust--**Why it matters:** At the moment, `skykeep --help` starts the app, or wakes the copy that's already running. People who live in a terminal expect a short list of flags, and packagers expect `--version`.--**Where in the code**-- `src-tauri/src/main.rs`, `fn main()` (around line 5924). The first call is `updates::after_update()`, and the single-instance plugin is registered at about line 5959.-- Flags already read: `--app` and `--new` in `src-tauri/src/apps.rs` (`asked`, `new_asked`), `--background` and `--search-provider` in `src-tauri/src/login.rs`, and the `.ics`/`.vcf` paths or `file://` URIs in `apps::files_asked`.--**Acceptance criteria**-- [ ] `skykeep --help` (and `-h`) prints usage covering `--app <notes|reminders|calendar|contacts|drive|photos>`, `--new <note|reminder|event>`, `--background` and opening `.ics`/`.vcf` files, then exits 0. It opens no window and doesn't hand anything to a running Skykeep.-- [ ] `skykeep --version` (and `-V`) prints `Skykeep 0.1.0`, taking the version from the build so it can't drift, and exits 0.-- [ ] The check runs first in `main()`, before `updates::after_update()` and the single-instance plugin.-- [ ] A unit test in `apps.rs` covers the parsing (`--help`, `-h`, and `--help` combined with other flags).-- [ ] On Windows a release build has no console (`windows_subsystem = "windows"`). It's fine if Windows prints nothing; attaching to the parent console is a nice extra.--**How to test:** `cargo test -p quince-app apps`, then `cargo run -p quince-app -- --help` with and without Skykeep already running.-------## 2. A man page for `skykeep`--**Labels:** good first issue, documentation, packaging--**Why it matters:** `man skykeep` should explain the launcher flags and where Skykeep keeps its files, like any other well-packaged Linux app.--**Where in the code**-- The flags are listed in issue 1. `packaging/README.md`, under "Opening files and quick capture", describes `--new` and `--app` in prose.-- Installs: `packaging/arch/PKGBUILD` and `packaging/aur/PKGBUILD` (`package()`), `bundle.linux.deb.files` / `rpm.files` in `src-tauri/tauri.conf.json`, and `packaging/flatpak/io.github.yashwanthkamireddi.Skykeep.yml`.--**Acceptance criteria**-- [ ] `packaging/skykeep.1`, written in plain roff or scdoc, with NAME, SYNOPSIS, DESCRIPTION, OPTIONS, FILES and SEE ALSO sections. It agrees with the `--help` text from issue 1.-- [ ] The Arch and AUR PKGBUILDs and the deb/rpm file maps install it to `/usr/share/man/man1/skykeep.1`.-- [ ] Nothing is claimed that the code doesn't do. Check each flag in `apps.rs` and `login.rs`.--**How to test:** `man ./packaging/skykeep.1`, `mandoc -T lint packaging/skykeep.1` (or `groff -man -ww`), then `makepkg` in `packaging/arch` and `pacman -Ql skykeep | grep man1`.-------## 3. Brand colours for software centres (`<branding>` in the metainfo)--**Labels:** good first issue, packaging, design--**Why it matters:** GNOME Software and Flathub paint an app's banner in its brand colours, light and dark. Without them Skykeep's page falls back to a plain grey, and Flathub's linter asks for them before submission.--**Where in the code**-- `packaging/io.github.yashwanthkamireddi.Skykeep.metainfo.xml` and `packaging/flatpak/io.github.yashwanthkamireddi.Skykeep.metainfo.xml`: neither has a `<branding>` block yet. Keep the two files in step.-- The logo's own blues are in `packaging/icons/skykeep.svg` (`#1F7FE6` and `#2F9BFF`); please pick from the logo rather than new colours.--**Acceptance criteria**-- [ ] Both metainfo files have `<branding>` with a `primary` colour for `scheme_preference="light"` and one for `"dark"`.-- [ ] The icon stays clearly visible on both colours (a screenshot of each in the PR is perfect).-- [ ] `appstreamcli validate --no-net` passes on both files, and `flatpak-builder-lint appstream` no longer mentions branding if you have it (`flatpak run --command=flatpak-builder-lint org.flatpak.Builder appstream <file>`).--**How to test:** Run the validators above. `appstreamcli` can't show the banner, so to see it, hold the icon over a square of each colour in any image viewer, or preview it in GNOME Software from a local Flatpak build (`packaging/flatpak/README.md`).-------## 4. Send waiting changes as soon as the network returns, inside the Flatpak--**Labels:** good first issue, enhancement, sync, rust--**Why it matters:** When an edit is made offline, Skykeep sends it the moment the connection comes back. In the Flatpak the sandbox hides the system bus, so that wake-up never fires, and changes wait for the next retry or for a window to notice.--**Where in the code**-- `src-tauri/src/outbox.rs`, `watch_network()` (around line 1850). It listens for NetworkManager's `StateChanged` and connman's `State` on the **system** bus, then calls `kick()` and `crate::push::wake()`. `came_online()` and its test (around line 3350) handle the "was offline, now online" edge.-- `packaging/flatpak/io.github.yashwanthkamireddi.Skykeep.yml`, `finish-args`, grants no system-bus names. The window's `online` event (`src/lib/outbox.ts` → `outbox_wake`) is the only fallback.--**Acceptance criteria**-- [ ] A third watcher in `watch_network()` uses the `org.freedesktop.portal.NetworkMonitor` portal on the **session** bus: it listens for `changed` and reads availability with `GetAvailable` or `GetStatus`, using the same zbus proxy pattern as the two watchers already there.-- [ ] It goes through `came_online()`, so one reconnection wakes the outbox once, even if NetworkManager and the portal both report it.-- [ ] No new `finish-args` are needed. Where the portal is missing, it gives up quietly, as the others do.-- [ ] A unit test covers the availability → `came_online` mapping.--**How to test:** Run `cargo test -p quince-app outbox`. `gdbus monitor --session --dest org.freedesktop.portal.Desktop` shows the signal while you run `nmcli networking off` and then `on`. The end-to-end check (an edit made offline arriving after reconnect) needs a **test** Apple Account; it's optional for the PR.-------## 5. Sidebar: Tab reaches the app list while Settings is open, and the account button says "Settings"--**Labels:** good first issue, accessibility, bug, javascript--**Why it matters:** Keyboard and screen-reader users should always be able to reach the six apps. They should also know that the button with their name on it opens Settings.--**Where in the code**-- `src/screens/Library.tsx`, the `item()` row (around line 452): `tabIndex={selected === key ? 0 : -1}`. With Settings in front, no app row gets `tabIndex` 0, so Tab skips the whole list. This was first noted in `docs/audit/shell-ux.md` #10.-- `src/components/Account.tsx` (around line 139): the `.sidebar-account` button's accessible name is only the person's name. "Settings" is just a `title`.--**Acceptance criteria**-- [ ] When the selected screen isn't one of the apps, the first app row takes `tabIndex` 0. The arrow keys still move between rows as they do now.-- [ ] The account button's accessible name includes "Settings" (for example `aria-label={`${name}, Settings`}`), and `aria-current` still works.-- [ ] axe stays clean.--**How to test:** Run `npx vite preview --port 4173 --strictPort &`, then `node .uiverify/keyboard.mjs`, `node .uiverify/a11y-keys.mjs` and `node .uiverify/a11y.mjs`, and each again with `ENGINE=webkit`. Extend `keyboard.mjs` to open Settings and then Tab into the app list. The test should fail on the old code.-------## 6. A screen-reader walkthrough with Orca or NVDA--**Labels:** help wanted, accessibility--**Why it matters:** axe passes and the lists are proper list boxes, but nobody has used Skykeep end to end with a screen reader yet. One honest report from someone who uses Orca (Linux) or NVDA (Windows) every day would steer the next accessibility pass.--**Where in the code:** `src/styles/a11y.css`, `src/lib/focus.ts`, `src/lib/screen.ts` (`overlayOpen`), and the screens in `src/screens/`. Existing checks are `.uiverify/a11y.mjs` (axe) and `.uiverify/a11y-keys.mjs`.--**Acceptance criteria**-- [ ] A comment, or a Markdown report attached to the issue, covering: signing in, moving between apps, reading and writing a note, ticking a reminder, adding an event, opening a contact, and browsing a Drive folder.-- [ ] For each problem: what was said, what you expected, and the steps to reproduce. Include the screen reader, its version, and your desktop or Windows version.-- [ ] Use a test Apple Account, and don't paste real personal data into the report.--**How to test:** It's a report rather than code. I'll turn each finding into its own issue.-------## 7. Ctrl+Shift+N makes a new folder in Notes and Drive--**Labels:** good first issue, enhancement, notes, drive, javascript--**Why it matters:** Notes and Finder both use ⌘⇧N for New Folder. Skykeep follows Apple's keys with Ctrl for ⌘ (and Reminders already uses Ctrl+Shift+N for New List), but in Notes and Drive the shortcut does nothing yet.--**Where in the code**-- `src/screens/NotesView.tsx`: the key handler (around lines 1075–1110) only takes `mod && !e.shiftKey && k === "n"`. `newFolder(parent)` (around line 787) already makes a folder instantly, ready to be named.-- `src/screens/DriveView.tsx`: the Finder-style key handler (around lines 1220–1295). The toolbar's New Folder button calls `setCreatingFolder(true)` (around line 1416).-- `src/components/ShortcutsSheet.tsx`: the `SHORTCUTS` rows for Notes and Drive.--**Acceptance criteria**-- [ ] In Notes, Ctrl+Shift+N creates a folder at the top level and starts renaming it, exactly as the sidebar's add button does.-- [ ] In Drive, Ctrl+Shift+N opens the New Folder field in the folder being shown. It does nothing in Recents or Recently Deleted, or while renaming or moving, following the guards the handler already has.-- [ ] Neither fires while a sheet or menu is open (`overlayOpen()`), or while you're typing in a field.-- [ ] The Shortcuts sheet lists both.--**How to test:** Extend `.uiverify/notes-keys.mjs` (or `notes-folders.mjs`) and `.uiverify/drive-keys.mjs`, then run each in Chromium and with `ENGINE=webkit`. Run `npx tsc --noEmit` too.-------## 8. Contacts: ask before throwing away a card that's being edited--**Labels:** good first issue, bug, contacts, javascript--**Why it matters:** If you press Ctrl+N or the New Contact button while editing a card, or open a contact from global search, the text you've typed disappears without a word. Skykeep never loses someone's typing silently anywhere else.--**Where in the code** (`src/screens/ContactsView.tsx`)-- `startNew()` (around line 224) and the Ctrl+N branch of the key handler (around line 820) replace `draft` without checking it.-- The New Contact button (around line 961) is only `disabled={busy}`.-- The `useReveal("contacts", …)` callback (around line 258) calls `setDraft(null)`.-- `draftBase` (around line 194) holds the card as it was before editing. `useConfirm()` (around line 161) is the app's existing confirmation sheet.--**Acceptance criteria**-- [ ] If the draft differs from what it started as, Skykeep asks first (for example "Discard changes?" with Discard and Keep Editing). An untouched draft is replaced without asking.-- [ ] Keep Editing leaves the draft and the focus where they were.-- [ ] Escape and Cancel still leave a draft as they do today.--**How to test:** Extend `.uiverify/contacts-keys.mjs` or `contacts-fields.mjs`: type into a new card, press Ctrl+N, and expect the question. Then do the same with an untouched card and expect no question. Run them in Chromium and with `ENGINE=webkit`.-------## 9. Contacts: Outlook CSV imports keep the right title, birthday and phone labels--**Labels:** good first issue, bug, contacts, rust--**Why it matters:** For many people, a CSV from Outlook or Google is the way out of an old address book. Three details currently get lost or mixed up on the way in.--**Where in the code:** `crates/quince-icloud/src/contacts.rs`, `csv_to_vcards()` (around line 1516). Its test is `a_csv_export_becomes_vcards` (around line 2035).--**What happens now**-1. `title` is matched by `col(&["job title", "title", …])`, which takes the **first** matching column. Outlook's export starts with a `Title` column holding the name prefix ("Dr."), so "Dr." becomes the job title. It should go to the N prefix instead, and `Job Title` to TITLE.-2. Birthdays are copied as they are when they're 8 or more characters long. Outlook's `3/14/1990` ends up as `BDAY:3/14/1990`, which isn't a vCard date, and a birthday with no year (`--03-14`) is dropped.-3. Every number becomes `TEL;TYPE=CELL`, so "Home Phone" and "Business Phone" turn into mobiles.--**Acceptance criteria**-- [ ] When a header row has both `Title` and `Job Title`, `Title` fills the name prefix and `Job Title` fills TITLE.-- [ ] Birthdays come out as `YYYY-MM-DD` from `YYYY-MM-DD`, `M/D/YYYY` and `--MM-DD`. Outlook's empty `0/0/00` and anything unreadable are left out, never guessed. For a birthday with no year, match how a vCard exported from iCloud writes one (Settings → Export Everything makes one to compare against).-- [ ] Phone and email types follow the heading: home, work/business or mobile, and for Google, a `… - Label` / `… - Type` column next to the value.-- [ ] Unit tests use synthetic rows only: invented names, 555-01xx numbers, example.com addresses. For example:- ```text- Title,First Name,Last Name,Job Title,Home Phone,Business Phone,Mobile Phone,E-mail Address,Birthday- Dr.,Mira,Okafor,Pilot,(555) 010-0101,(555) 010-0102,(555) 010-0103,[email protected],3/14/1990- ```--**How to test:** `cargo test -p quince-icloud csv`. The import flow in the interface is covered by `.uiverify/contacts-vcard.mjs`.-------## 10. Contacts: import CSV and vCard files that aren't UTF-8, and CSVs separated by semicolons--**Labels:** good first issue, enhancement, contacts, rust--**Why it matters:** Excel and older Outlook versions often save CSVs as UTF-16 or Windows-1252, and in many regions they separate fields with `;`. Today those files either fail with a read error or come in as one long column.--**Where in the code**-- `src-tauri/src/main.rs`, `contacts_import` (around line 3895), reads each file with `std::fs::read_to_string`, which fails on anything that isn't valid UTF-8.-- `src-tauri/src/intake.rs`, `load()` (around line 198), the path for opening a file from the file manager, uses `String::from_utf8_lossy`, which turns accented letters in a Windows-1252 file into `�`.-- `crates/quince-icloud/src/contacts.rs`, `csv_rows()` (around line 1467), only splits on `,`.--**Acceptance criteria**-- [ ] One small decoding function, shared by both paths and unit-tested: UTF-8 (with or without a BOM), UTF-16 LE/BE with a BOM, and Windows-1252 as the fallback for bytes that aren't UTF-8. The standard library is enough here; if you'd like to add a crate, mention it in the issue first.-- [ ] `csv_rows` uses `;` when the header line contains semicolons and no commas outside quotes. Fields quoted with `"` keep working the same way.-- [ ] Tests use synthetic sample bytes, such as a `José` written in Windows-1252 and a UTF-16 file with a BOM.--**How to test:** `cargo test -p quince-icloud csv` and `cargo test -p quince-app intake`.-------## 11. Keep the winget manifest current on every release--**Labels:** good first issue, packaging, windows--**Why it matters:** `winget install` is how many Windows users install software. I'll make the first submission by hand on launch week. After that, each release should reach winget without anyone having to remember.--**Where in the code**-- `.github/workflows/release.yml` builds and publishes `*-setup.exe` and `*.msi` with `SHA256SUMS` (the `publish` job at the end).-- `src-tauri/tauri.conf.json`: `bundle.windows.nsis.installMode` is `currentUser`, so the winget manifest's scope is user.--**Acceptance criteria**-- [ ] A job that runs after a release is published and opens the winget-pkgs pull request for the new version using `komac` or `wingetcreate update`, with the package identifier from the first submission.-- [ ] It uses a token stored as a repository secret, and does nothing (successfully) when the secret isn't set, so forks stay green.-- [ ] Actions are pinned to a commit SHA, as the existing workflows do.-- [ ] A short note in `packaging/README.md`.--**How to test:** Do a dry run on a fork against a test release (`komac update --dry-run` or `wingetcreate update` without `--submit`), and attach the generated manifest to the PR.-------## 12. A Scoop manifest, in a personal bucket for now--**Labels:** good first issue, packaging, windows--**Why it matters:** Scoop users install without admin rights or installers. Scoop Extras asks for 100 stars first, so a manifest that's ready to go can live in a personal bucket until then.--**Where in the code**-- Release assets come from `.github/workflows/release.yml` (`.msi`, `-setup.exe`, `SHA256SUMS`).-- The Start-menu entries for the six apps are `skykeep.exe --app notes` and so on (`packaging/README.md`, "The six apps on Windows").-- `src-tauri/src/updates.rs`: `install_kind()` decides who updates a copy. A program taken out of the `.msi` still reports `BundleType::Msi`, so it would see itself as `Install::Here` and offer its own updates, alongside Scoop's.--**Acceptance criteria**-- [ ] `packaging/scoop/skykeep.json`, with the MSI extracted (Scoop handles that), `bin`, `shortcuts` for Skykeep and the six apps (with their `--app` arguments), `checkver` and `autoupdate` from GitHub Releases, and the hash read from `SHA256SUMS`.-- [ ] A copy installed by Scoop leaves updates to Scoop. For example, `this_install` recognises a program under `scoop\apps\`, with a case added to the `who_updates_each_kind_of_install` test.-- [ ] Notes in `packaging/README.md`, including the WebView2 runtime that Windows 10 may need.--**How to test:** `scoop install .\packaging\scoop\skykeep.json` in Windows Sandbox or a VM, then launch Skykeep and one app shortcut, check that Settings offers no in-app update, and `scoop uninstall skykeep`. Run `cargo test -p quince-app updates`.-------## 13. A Chocolatey package--**Labels:** good first issue, packaging, windows--**Why it matters:** Chocolatey is how many people and IT departments script Windows installs. A package that's reviewed and ready makes the community-repository submission quick.--**Where in the code:** Release assets from `.github/workflows/release.yml`. The NSIS installer installs per user (`installMode: currentUser`) and accepts `/S`. The uninstall entries and shortcuts it makes are covered by `packaging/windows/installer-hooks.nsh`.--**Acceptance criteria**-- [ ] `packaging/chocolatey/` holds `skykeep.nuspec` (ProjectUrl, LicenseUrl for GPL-3.0-only, an icon from `packaging/icons/`, and a description that says Skykeep isn't affiliated with Apple) plus `tools/chocolateyinstall.ps1` and `chocolateyuninstall.ps1`.-- [ ] The installer is downloaded from GitHub Releases with a SHA-256 checksum, not embedded, so no VERIFICATION.txt is needed. The install is silent.-- [ ] Uninstalling leaves no Start-menu entry behind.-- [ ] The description says that Skykeep's installer copy can also update itself (`src-tauri/src/updates.rs`).--**How to test:** `choco pack` in `packaging/chocolatey`, then `choco install skykeep -s . -y` and `choco uninstall skykeep -y` in Windows Sandbox. Attach the output to the PR.-------## 14. A Nix flake--**Labels:** help wanted, packaging--**Why it matters:** NixOS users can't use the deb, rpm or AppImage comfortably. A flake would give them `nix run github:YashwanthKamireddi/Skykeep`, and later a path into nixpkgs.--**Where in the code**-- Build dependencies are listed in `.github/CONTRIBUTING.md` under "Set up": webkit2gtk-4.1, gtk3, libsecret, libheif ≥ 1.17, GStreamer base/good/libav, fuse3 and librsvg.-- The Rust version is pinned in `rust-toolchain.toml` (1.98.1).-- The frontend is built with `npm ci && npm run build`.-- The files to install are the same ones `packaging/arch/PKGBUILD` installs: the binary as `skykeep`, the desktop entries in `packaging/` and `packaging/apps/`, the metainfo, the icons, and the search-provider files.-- On Linux, a copy built without Tauri's bundler reports `Install::PackageManager` (`updates.rs`, `install_kind`), so the in-app updater stays out of the way automatically.--**Acceptance criteria**-- [ ] `flake.nix` (and `flake.lock`) builds Skykeep with nixpkgs' Tauri tooling (for example `cargo-tauri.hook` with `fetchNpmDeps`) and wraps it with the GStreamer and GIO paths it needs.-- [ ] `nix run . -- --app notes` opens Notes, videos play, HEIC thumbnails show, and the keyring keeps the sign-in.-- [ ] Short instructions in `packaging/README.md`.--**How to test:** `nix build` and `nix flake check` on NixOS or with Nix on another distro. Launch it and sign in with a **test** Apple Account.-------## 15. Fedora COPR--**Labels:** help wanted, packaging--**Why it matters:** The release's `.rpm` installs on Fedora, but it doesn't update itself. COPR would let Fedora users get updates through `dnf upgrade` like everything else.--**Where in the code**-- The Fedora build dependencies are in `.github/CONTRIBUTING.md` ("Set up").-- `packaging/linux-compat/check.sh` and `.github/workflows/linux-compat.yml` build and install on Fedora 42 in a clean container already.-- The installed file list should match the deb/rpm maps in `src-tauri/tauri.conf.json` (`bundle.linux`).--**Acceptance criteria**-- [ ] `packaging/fedora/skykeep.spec` builds from a release source tarball. Cargo crates and npm packages are vendored, or fetched with COPR's network option switched on; please explain which you chose and why.-- [ ] It installs the binary as `skykeep`, plus the desktop entries, metainfo, icons and search-provider files.-- [ ] It builds in `mock` for the current Fedora release and Rawhide, and `rpmlint` has no errors.-- [ ] Steps for setting up the COPR project go in `packaging/README.md`. I'll create the COPR project myself.--**How to test:** `fedpkg --release f42 mockbuild` (or `mock -r fedora-42-x86_64 --rebuild <srpm>`), then install the rpm in a clean `fedora:42` container and run `packaging/linux-compat/check.sh` against it.diff --git a/docs/icloud-web/README.md b/docs/icloud-web/README.mddeleted file mode 100644index 6308de7..0000000--- a/docs/icloud-web/README.md+++ /dev/null@@ -1,76 +0,0 @@-# icloud.com web-app reference (local only, do not commit)--Taken from icloud.com's publicly served JS bundles on 2026-10-17. No sign-in was-needed. The bundles were only grepped and never executed.--## How the bundles are found-- Shell: `https://www.icloud.com/` loads `/system/icloud.com/2638Build27/en-us/main.js`.- That file holds the child-app configs (`applicationName:"notes3"`, `"reminders2"`, ...).- It builds child URLs as `/applications/<app>/current/<path>` (VERIFIED-IN-CODE).-- Each child app: `https://www.icloud.com/applications/<app>/current/en-us/index.html`- redirects to a versioned build, which lists its scripts.--| App | Bundle app name | Build | Files |-|---|---|---|---|-| Drive | iclouddrive | 2638Build17 | main.js + vendors + 40 lazy chunks |-| Notes | notes3 (CloudKit com.apple.notes) | 2638Build17 | main.js (single 7.5MB) |-| Reminders | reminders2 (CloudKit com.apple.reminders) | 2638Build16 | main.js |-| Calendar | calendar (/ca/) | 2634Build23 | main.js |-| Contacts | contacts2 (/co/) | 2638Build32 | main.js + N.main.js chunks |-| Photos | photos3 (CloudKit com.apple.photos.cloud, zone PrimarySync) | 2638Build29 | main.js + ui.main.js + 95 chunks |--Local copies (scratchpad, temporary):-`/tmp/claude-1000/-home-yash-Projects/2540edda-3efd-42b2-8acc-a7662fcef7d7/scratchpad/icloud-bundles/`-(`b/` = raw files, `pretty/` = js-beautify output; line numbers in the docs refer to `pretty/`).-The scratchpad is temporary. Re-download if it has been cleared. Build numbers change often.--## beta.icloud.com (checked 2026-10-19)-`https://beta.icloud.com/` serves newer builds: the shell is `2638BuildBeta18`. Compared app by app:-Drive **Beta31** (www 17), Contacts **Beta34** (www 32), Photos Beta15 (www 29, a separate numbering line), and-Notes, Reminders and Calendar at the same build number. The beta Drive uses a new docws `v1/item` API (see drive.md).-Beta bundles are in `~/.cache/quince-icloud-re/beta/`. From now on, prefer the beta build wherever it is newer.--## Index-| Doc | Covers |-|---|---|-| [reminders.md](reminders.md) | List/Reminder records; create, complete, due and all-day writes; Alarm/AlarmTrigger; RecurrenceRule; ResolutionTokenMap JSON; Attachment(URL)/Hashtag/Assignment; Priority; UI checklist (§12) |-| [calendar.md](calendar.md) | Event save body; alarms and recurrence; this/future/all path segment; eventdetail; invitees; attachments; all-day and tz; query params; UI checklist (§13) |-| [notes.md](notes.md) | Paragraph style enum, checklist (style 103 + todo), Aa menu, fontHints, com.apple.notes.table CRDT, UI checklist |-| [drive.md](drive.md) | item copy, download/batch and thumbnail_token, trash dateExpiration, storageUsageInfo quota, shortcuts, UI checklist |-| [photos.md](photos.md) | Container/zone, CPL record types, smart-album queries, derivative URLs, favourite/hide/delete writes, upload, UI checklist |-| [contacts.md](contacts.md) | Contacts (unchanged in this pass) |-| [mail.md](mail.md) | Mail: IMAP-backed mailws2 API, thread search/get/move/flag, send, Mail Drop, feasibility |-| [findmy.md](findmy.md) | Find My: fmipservice initClient/refreshClient, Play Sound, Lost Mode, Erase, auth token; feasibility |-| [shell-auth-account.md](shell-auth-account.md) | Sign-in methods (SRP, 2FA, passkey, security key…), session/validate, account and plan calls; Quince gaps |-| [proto/](proto/README.md) | Apple's own CRDT / topotext / versioned_document protobuf schemas |--Static analysis also ran through REA `analyze-javascript-application` (output in scratchpad `rea-out/`). The documented findings come from grep/sed on `pretty/`.--## Still unknown-- **All:** no live traffic has been captured. CloudKit JS is not bundled in reminders2, so the `records/modify` `operationType` strings there are INFERRED. Real hostnames (calendarws, photosupload, uploadimagews, setup) come from the webservices map at sign-in.-- **Reminders:** the List `Name` setter (`u.b`). All-day DueDate: the reader expects UTC midnight, the writer seems to produce local midnight. Native-only shapes (early reminder TimeInterval, RecurrenceRule creation, Hashtag/Assignment writes). Assignment `Status` and Vehicle `Event` enums.-- **Calendar:** whether all-day events are stored as `"Floating"`; how recurrence and attachments are removed; multi-position `frequencyDays`; empty-state and inbox strings; any shortcuts beyond Delete/Escape/Enter.-- **Notes:** `crTableColumnDirection` values; the `1.` auto-numbering rule; gzip vs zlib acceptance; `EncryptedValues` inner layout; Folder record naming; whether folder delete writes `DeletedDate`.-- **Drive:** callers of retrieveTrashDetails/deleteItemsInTrash; folder-as-zip download; `thumbnail_token` URL lifetime; fetch-layer query params.-- **Photos:** the newer upload path's byte-upload step and response; the remove-from-album body; decoding `*Enc` fields; `desiredKeys` and page sizes; Shared Library database scope.--Tags: **VERIFIED-IN-CODE** means it was seen in a bundle. **INFERRED** means it was-reasoned from nearby code or naming and has not been confirmed against live traffic.--## Seen live (2026-10-19, signed-in browsing, reads only; account number shown as `{dsid}`)-Hosts come from the webservices map (`p177-` is this account's partition).-| App | Calls on open |-|---|---|-| Sign-in | `idmsa /appleauth/auth/verify/device/key[/challenge]` (trusted-device key), `setup /setup/ws/1/accountLogin`, `validate` (421 = session gone) |-| Account | `setup /setup/ws/1/storageUsageInfo`, `/setup/web/family/getFamilyDetails`, `gatewayws /acsegateway/v1/accounts/{dsid}/plans/icloud/pricing`, `…/web/plans/next-larger-plan`, `…/v3/…/subscriptions/features/cloud.storage/plan-summary` |-| Shared settings | `keyvalueservice /json/sync` (POST, repeatedly) |-| Calendar | `GET /ca/state`, `/ca/allcollections`, `/ca/events`, `/ca/notifications` (invitations inbox), `/ca/serverpreferences/`, `/ca/alarmtriggers/` |-| Reminders | `GET /rd/state`, `/rd/alarmtriggers/`; CloudKit `com.apple.reminders` zones/list, records/query, records/lookup |-| Notes | CloudKit `com.apple.notes` records/query |-| Contacts | `GET /co/startup`, `/co/addressbook`, `/co/mecard/`; `POST /co/changeset`; `contactsweb /v1/co/me/interactions` |-| Drive | `docws GET /v1/enumerate/{apps,files/root,folders/root}`, `/ws/_all_/list/enumerate/{favorites,recentDocs,sharedByMe,sharedToMe}`, `/ws/_all_/list/changes/favorites`, `POST /ws/com.apple.CloudDocs/download/batch`; `drivews POST /retrieveItemDetails[InFolders]`; CloudKit `com.apple.clouddocs` subscriptions/list |-| Photos | CloudKit `com.apple.photos.cloud` private+shared zones/list, records/query, records/lookup; thumbnails from `cvws-h2…/B/<token>/public.jpeg`; `sharedstreams /{dsid}/sharedstreams/webgetalbumslist` |-| Mail | `mccgateway /mailws2/v1/thread/search`, `/mailws2/v1/geqs/query`, `/mailis/v1/mail/{recommendations,sync/VIP,sync/RECOMMENDATIONS}`, `/mpp/v1/auth-tokens/keys/latest`; `mcc /cc/mail/v1/account/{dsid}/preference/{web/all,recents,vips}`, `/unified/rule` |--Note: the new Drive web app reads through `docws /v1/enumerate/*` as well as `drivews`.-No writes were captured. The recording and its browser profile were deleted afterwards.diff --git a/docs/icloud-web/calendar.md b/docs/icloud-web/calendar.mddeleted file mode 100644index fa00ccb..0000000--- a/docs/icloud-web/calendar.md+++ /dev/null@@ -1,218 +0,0 @@-# iCloud.com Calendar web API (`/ca/`) — reverse-engineered--Source: `pretty/calendar/main.js` (build 2634Build23), read-only grep of the beautified bundle.-Line numbers refer to that file. Tags: **VERIFIED-IN-CODE** = literally present; **INFERRED** = deduced, not proven.--## 0. Transport--- All paths are built by `Kl(base, segments[], query)` → `base/seg1/seg2?k=v&...`; undefined query values dropped, segments `encodeURI`d. L64592–64600 `return e + "/" + t.map(function(e) { return encodeURI(e) }).join("/") + "?" + r` — VERIFIED-IN-CODE-- Requests go through `vI({path, serviceName: Ul, fetchOptions, zodSchema})` → `Zl.ckRequest(...)` (L78441–78470). `Ul` is the calendar service host (the `calendarws` gateway) — INFERRED (name not resolved).-- Writes are always HTTP **POST** with `methodOverride=PUT|DELETE` in the **query string**, not the body. L82566–82575 `case "removed": m = { methodOverride: "DELETE" } ... case "dirty": m = { methodOverride: "PUT" }` — VERIFIED-IN-CODE-- Optimistic concurrency: `ifMatch=<etag>` query param. L82606 `n.etag ? { ifMatch: n.etag } : {}` — VERIFIED-IN-CODE-- Common query params: `lang`, `usertz`, `requestID` (monotonic counter `qx.nextId()`), `startDate`, `endDate` (current visible window, so the server returns a ChangeSet scoped to it), optional `delegator`. L82600–82612 — VERIFIED-IN-CODE-- Attachment upload header `{"content-type": "text/plain"}` (`Xy`, L73146–73148) — VERIFIED-IN-CODE-- GUID prefix stripping `vb()`: removes `-sharedinvitation-` / `-delegator-` markers before putting a guid in a path. L73155–73156, L73251–73256 — VERIFIED-IN-CODE-- Date tuples (`qg`) are 7-number arrays `s.tuple([s.number() x7])` L72668. Order `[yyyymmdd, y, m, d, h, min, minutesOfDay]` — VERIFIED L73697 (see §12).--## 1. Endpoint list--Base-path enum, L64590 — VERIFIED-IN-CODE:-`ca/availability, ca/freebusy, ca/nextavailable, ca/collectiondetail, ca/collections, ca/collectionsetting, ca/share, ca/sharereply, ca/eventdetail, ca/events, ca/attachment, ca/idle, ca/inboxitem, ca/serverpreferences, ca/allcollections, ca/notifications, json/sync, co/addressbook, ws/v1/autocomplete`-Plus literal paths: `ca/delegation` (L83926), `ca/delegatordetails` (L85696), `ca/delegationorder` POST (L85732), `ca/delegate` GET/POST (L85769, L85829).--**There is no `ca/startup` in this build.** grep for `ca/startup` = 0 hits — VERIFIED-IN-CODE. Startup = parallel GETs of `ca/allcollections` + `ca/events` + `ca/notifications`, results merged (`Object.assign`). L83060 `i = [wj, _j, Ej], e.a(2, jj(i, r, n))`; merge L83172 `return t.ok ? Object.assign({}, e, t.value) : e` — VERIFIED-IN-CODE-Startup query: `startDate, endDate, usertz, lang, clientVersion, [bday=true if showBirthdays], requestID`. L83496–83504 — VERIFIED-IN-CODE-Startup response schema `Sj` = `{Event[], Alarm[], Collection[], InboxItem[]?, Invitee[]?}` (partial). L83043–83049 — VERIFIED-IN-CODE--| Endpoint | Method | Purpose | Line |-|---|---|---|---|-| `GET ca/events?bday&startDate&endDate&lang&usertz&requestID[&delegator]` | GET | range fetch, response `Ty` (ChangeSet updates) | L82508–82531 VERIFIED |-| `GET ca/eventdetail/<pGuid>/<guid>?lang&usertz` | GET | full event (invitees, alarms, recurrence, attachments) | L82483–82506 VERIFIED |-| `POST ca/events/<pGuid>/<guid>[/<changeRecurring>]?…&methodOverride` | POST | create / PUT update / DELETE | L82577, L82600–82618 VERIFIED |-| `POST ca/attachment/<pGuid>/<guid>?X-name&X-type&ctag&ifMatch…` | POST | upload raw file body | L82634–82659 VERIFIED |-| `GET ca/collectiondetail/<collectionGUID>` | GET | one calendar | L83707–83720 VERIFIED |-| `POST ca/collections/<guid>?methodOverride` | POST | calendar create/rename/delete | L83746–83770 VERIFIED |-| `POST ca/collectionsetting?methodOverride=PUT` | POST | order/visibility/default calendar | L83785–83803 VERIFIED |-| `POST ca/share/<guid>?methodOverride=PUT` | POST | share/publish calendar | L83821–83849 VERIFIED |-| `POST ca/sharereply/<inboxGuid>?methodOverride=PUT` | POST | accept/decline calendar share | L83866–83890 VERIFIED |-| `POST ca/inboxitem/<inboxGuid>?methodOverride=DELETE` body `{}` | POST | dismiss notification | L87611–87628 VERIFIED |-| `POST ca/idle?startDate&endDate&usertz&lang&clientVersion&requestID` | POST | long-poll for changes, response `{ChangeSet}` | L87280–87290, body L87547 VERIFIED |-| `GET/POST ca/serverpreferences` | GET/POST | server prefs | L78700–78730 VERIFIED |-| `POST json/sync` body `{"service-id":"appleprefs","apps":[{"app-id":Ul,"registry-version":""}]}` | POST | KVS prefs | L78648–78660 VERIFIED |-| `ca/availability` GET/POST, `ca/freebusy` POST, `ca/nextavailable` POST | | invitee availability | L79217–79330 VERIFIED |--## 2. Event save / delete (`nj`, L82550–82625) — VERIFIED-IN-CODE--Path segments: `g = n.changeRecurring ? [n.pGuid, f, n.changeRecurring] : [n.pGuid, f]` (L82577). So **"this / future / all" is a 3rd path segment**, e.g. `ca/events/<cal>/<guid>/future`. Enum `eb`: L73152–73153 `e.this = "this", e.all = "all", e.future = "future"`.--Body for create/update (L82588–82598):-```json-{- "Event": { ...event fields, [startDate,endDate = masterStartDate/masterEndDate when changeRecurring=="all" and !recurrenceMaster] },- "Invitee": [ ...inviteeDetails ], // only if present- "Alarm": [ ...alarmDetails ], // only if present- "Recurrence": [ recurrenceDetails ], // single-element array- "ClientState": { "Collection": [ { "guid": pGuid, "ctag": collection.ctag }, /* + oldpGuid entry when moving calendars */ ] }-}-```-- ClientState built L86858–86866 (`f = { Collection: [{ ctag: d.ctag, guid: i.pGuid }] }`, plus `oldpGuid` entry when moving).-- `all` on a non-master occurrence: L82579 `"all" === n.changeRecurring && !n.recurrenceMaster && n.masterEndDate && n.masterStartDate && (y = {startDate: n.masterStartDate, endDate: n.masterEndDate})`.-- `addedFromDelegate` gets a fresh `guid: crypto.randomUUID()` (L82581).-- Delete body (reason `removed`): `{ Event: isJunk ? {...event} : {}, ClientState }` with `methodOverride=DELETE` (L82585–82587).-- Moving calendars: set `oldpGuid` on the event (L91446 `t.oldpGuid = w.guid`) — VERIFIED-IN-CODE.-- Response schema `Ky = {ChangeSet: Dy, guid?, pGuid?}` (L72996–73000); `Dy = {UpcomingAlarm?, fullState?, updates?: Ty, inserts?: Ty, deletes?: [{pGuid?, guid}]}` (L72930–72940).-- `Ty` (ChangeSet payload) = `{Alarm?, Event?, InboxItem?, Invitee?, Recurrence?, Collection?, Participant?}` arrays (L72920–72929).--### "This / future / all" UI → param mapping — VERIFIED-IN-CODE-- Edit dialog "Change repeating event?" (L67964): `onAllEvents` → `changeRecurring: g ? "all" : "future"` (g = isRecurrenceMaster); `onOnlyThisEvent` → `{recurrenceException: true, hadRecurrence: true, changeRecurring: "this"}` (L104766–104780).-- Delete dialog: same mapping (L104822–104852). Reply to invite: `"all"` / `"this"` (L104862–104874).-- Reducer: if master and `future` is chosen, it's upgraded to `all` (L75944 `f.payload.recurrenceMaster && a === eb.future ? f.payload.changeRecurring = eb.all`).--## 3. Event shape `uy` (L72688–72735) — VERIFIED-IN-CODE-`guid, pGuid, oldpGuid?, etag, title?, location?, description?, url?, tz|null, tzname?, startDateTZOffset?, allDay, duration (number), startDate, endDate, localStartDate, localEndDate, createdDate, lastModifiedDate (all qg tuples), masterStartDate?, masterEndDate?, icon, readOnly, hasAttachments, attachments: Attachment[], alarms: string[] (alarm guids), invitees?: string[] (invitee guids), recurrence?: string|null (recurrence guid), recurrenceMaster, recurrenceException, hadRecurrence?, changeRecurring?, eventStatus?, isJunk?, organizer?, transparent? (Show as Free/Busy), extendedDetailsAreIncluded, shouldShowJunkUIWhenAppropriate, birthday* fields, delegator?`.-Event references alarms/invitees/recurrence **by guid**; the objects live in separate top-level arrays.--Client sanitises title/location/description/url to plain text before save (L91484–91500); allDay end is bumped +1 day midnight (L91480–91483). Empty title defaults to "New Event" (L91508).--## 4. Alarm shape `ly` + measurement `cy` (L72736–72751) — VERIFIED-IN-CODE-```json-{ "guid": "<eventGuid>:<uuid>", "pGuid": "<eventGuid>", "messageType": "message",- "isLocationBased": false,- "measurement": { "weeks":0, "days":0, "hours":0, "minutes":15, "seconds":0, "before": true },- "onDate": [/* qg tuple, absolute alarm; mutually exclusive with measurement */] }-```-- Creation L91536–91543 `guid: g.payload.guid + ":" + crypto.randomUUID(), messageType: "message", pGuid: "" + g.payload.guid, isLocationBased: !1`.-- Alarm `pGuid` is the **event guid**, not the calendar. On-date vs measurement: L91528–91534.-- UI max 2 alerts ("Alert", "2nd Alert", L68125/L68130; L91535 `alarms.length <= 2`).-- Presets `Zy` L73004–73087: None, 5/15/30 min, 1/2 h, 1/2 days before, At time of event (`before:false`, all zero). All-day presets `Qy = [1 day, 2 days]` with "(%{time})" labels L67806/L67809.-- Default alarm on new event from pref `defaultEventAlarm` (Cy, L72880) applied L104609.--## 5. Recurrence shape `_y` (L72838–72852) — VERIFIED-IN-CODE-```json-{ "guid": "<eventGuid>*MME-RID", "pGuid": "<eventGuid>",- "freq": "daily|weekly|monthly|yearly", "interval": 1,- "count": 5, // "After N Times"- "until": [qg tuple], // "On Date"- "weekDays": ["MO","WE"], "frequencyDays": "1st|2nd|3rd|4th|last"?,- "byDay": [15], // day-of-month numbers (not weekdays!)- "byMonth": [3], "weekStart": "SU"?, "recurrenceMasterStartDate"?, "recurrenceMaster"? }-```-- New recurrence guid: L91434 `var t = g.payload.guid + "*MME-RID"`; modifying reuses `g.payload.recurrence` (L91430). Removing dispatches `eventRecurrenceRemoved` (L91442) — wire form of removal INFERRED (probably event saved with `recurrence: null` and no Recurrence array).-- Picker defaults L74150–74180: weekly → `weekDays:[today]`; monthly "each" → `byDay:[date]`, monthly "on the" → `frequencyDays + weekDays`; yearly → `byMonth:[month]` (+ optional on-the). `frequencyDays` values from `zy = ["1st","2nd","3rd","4th","last"]` L72985 (string; format of multi values INFERRED).-- Never / After Number of Times / On Date end options L68279–68289.--## 6. Invitee shape `wy` (L72824–72837) — VERIFIED-IN-CODE-`{ guid: "<eventGuid>:<email or canonicalPhone>", pGuid: "<eventGuid>", commonName?, email?, phoneNumber?, isMe, isOrganizer, inviteeStatus: "ACCEPTED|TENTATIVE|DECLINED|NEEDS-ACTION", isSenderMe?, sentBy?, role?, cutype? }`-Built L91514–91523 (`guid: g.payload.guid + ":" + (n ? AA(n) : t)`, `inviteeStatus: "NEEDS-ACTION"`). Edit = new invitee with `oldGuid` (L91524). Status enum `ry` L72676.-Participant (calendar sharing) `by` L72810–72823. Phone canonicalisation via `ws/v1/autocomplete/canonicalizePhoneNumbers` POST (L84964) — VERIFIED.-"Save & Send" prompt for events with invitees (L67960–67963).--## 7. Attachment shape `sy` (L72680–72687) — VERIFIED-IN-CODE-`{ id?, name?, pGuid, size?: string, type?: "mime/type", url? }`-- Upload: `POST ca/attachment/<pGuid>/<eventGuid>?X-name=<file.name>&X-type=<mime|application/octet-stream>&ctag&lang&usertz&requestID&ifMatch&startDate&endDate`, body = raw File, header `content-type: text/plain`; response `{ChangeSet}`. L82626–82660.-- Limits: 20 MB per file, 20 attachments per event. L100906 `size: String(20)`, L100917 `amount: String(20)` — VERIFIED-IN-CODE.-- Delete: `eventAttachmentDeleted` removes entry from `event.attachments` locally and marks event dirty (L75412–75425); no dedicated delete endpoint exists → sent via normal event PUT — INFERRED.--## 8. Collection (calendar) `dy` (L72752–72780) — VERIFIED-IN-CODE-`guid, ctag, etag, title?, order?, color?, symbolicColor?, enabled, visible, isDefault, isFamily, readOnly, objectType, supportedType: "Event|Todo|Freebusy|null", shareTitle, isPublished, publishedUrl?, prePublishedUrl, isPrivatelyShared, sharedUrl?, participants?, description?, createdDate, lastModifiedDate, extendedDetailsAreIncluded, shouldShowJunkUIWhenAppropriate, delegator?`-- Save body: `{ Collection: <collection>, ClientState: { Collection: [{guid, ctag}], fullState: false } }`; delete body `{}` (L83760–83769).-- collectionsetting body `{ order, visible, DefaultCalendar }` (L83797–83801).-- share body `{ guid, shareTitle, shareType: "published"|"shared"|null, publishedUrl, sendNotification:false, delta:{add:[],delete:[],modify:[],reinvite:[]} }` (L83840–83847).-- sharereply body `{ guid, status ("DECLINED" if isJunk), order, shareURL, shareTitle, [isJunk:true] }` (L83882–83890).--## 9. ca/idle (push/poll)-Body: `{ ClientState: { Collection: [{ctag, guid}...], alarmRange: 60, fullState: true, userTime: 1234567890 } }` (L87547–87557), query includes `clientVersion`. — VERIFIED-IN-CODE--## 10. Preferences `Cy` (L72864–72889) — VERIFIED-IN-CODE-`visibleDays, startingWeekday, showHoursAtATime, startWithTodayInWeekView, showBirthdays, showAlternateCalendar, alternateCalendar, showDeclinedEvents?, dateFormat, timeFormat, dateSeparator, timeSeparator, isCalendarListVisible, selectedCollection, defaultCalendar, alarmsByDefault, defaultEventAlarm (measurement), enableTimeZone, lastTimeZoneSet[], hideEvents, hideEventsNum, emailParticipantsSharingChange, promptEventUpdates, viewingMode?`. Read from KVS (`Zl.getPreferences("calendar")`, L82830).--## 11. UI menus & dialogs (strings) — VERIFIED-IN-CODE-- Toolbar "+" menu: New Event / New Calendar / New Subscription… / Refresh Calendar (L67917–67920).-- Event inspector (L68085–68137): Title, "Location or Video Call", all-day, from/to, quick durations 30/60/90/120/150/180 min, sections Invitees, Calendar, Status, All Day, Starts, Ends, Time Zone, Repeat, End, Alert, 2nd Alert, Show as (Free/Busy), Organizer, Attachments, URL, Notes; buttons Cancel/OK/Save/Add/Delete/Accept/Decline/Maybe/Report as Junk. Titles: Add Event / Edit Event / Event Details.-- Repeat picker (L68279–68289): Never, Every Day, Every Week, Every Month, Every Year, Custom...; End: Never / After Number of Times (#{input} Time(s)) / On Date.-- Custom recurrence modal (L68540–68576): Daily/Weekly/Monthly/Yearly, "Every #{input} Week(s) on:", weekday toggles, Monthly Each vs On The, 1st…last, month grid.-- Alert picker: presets in §4 (L67799–67809).-- Invitee row actions: Edit, Send Email..., Remove (L68290–68292).-- Dialogs: Change repeating event? (Only This Event / All Future Events / All Events / Only Selected Events) L67964–67969; Delete repeating event? L67970–67973; Reply to this event or all events? L67974–67975; Send event update to invitees? Save & Send L67960; Delete and Notify L67933–67937; Decline and Notify L67942–67946; Report as Junk L67929–67932; calendar Delete / Stop Sharing / Leave Shared L67927–67959 (can't delete last owned calendar, L67957).-- No event right-click context-menu strings (Duplicate/Copy/Cut/Paste) found — VERIFIED-IN-CODE (grep 0 hits besides share "Copy").--## 12. Pass 2 additions — VERIFIED-IN-CODE unless tagged--- **Service name**: `Ul = Vl.CALENDAR` (L64584), `Vl.CALENDAR = "calendar"` (L64582, siblings `cksharews`, `contacts`, `keyvalue`, `feedbackws`). So requests use the `calendar` key of the webservices map (host typically `pXX-calendarws.icloud.com`, INFERRED from the webservices response, not in this bundle).-- **Common transport params** added by the CloudOS kit, not per-call: `clientBuildNumber`, `clientMasteringNumber`, `clientId` (L65413 `Ad(t, "clientBuildNumber", this.buildNumber), Ad(t, "clientMasteringNumber", r), Ad(t, "clientId", n)`) and `dsid` (L65476 `e.url.setQueryParameter("dsid", t)`).-- **Date tuple semantics resolved**: L73697 `ew = function(e,t,n,r,i){ return [1e4*e + 100*t + n, e, t, n, r, i, 60*r + i] }` → `[yyyymmdd, year, month(1-based), day, hour, minute, minutesSinceMidnight]`. The 7th element is minutes-of-day, **not** duration (duration is the separate `duration` field). Supersedes the INFERRED note in §0.-- **eventdetail response**: `GET ca/eventdetail/<pGuid>/<guid>?lang&usertz[&delegator]` parsed with `zodSchema: Ty, schemaName: "changeSetUpdates"` (L82483–82506) → same `{Event[], Alarm[], Invitee[], Recurrence[], Collection?, Participant?, InboxItem?}` arrays as a ChangeSet `updates` block; then sharedinvitation-marker transformer applied. The guid has `vb()` stripping applied.-- **Time zones / all-day**: `tz` may be an IANA name, `"UTC"`, `"Floating"`, `null` or `""`. Resolution `Sb` L73380 `null === n || "Floating" === n ? r : Mw(n) ? n : <GMT±startDateTZOffset> : r` — floating/null renders in user tz; else falls back to `"GMT"+startDateTZOffset`. Picker offers `OY = ["UTC","Floating"]` (L104255). All-day saves bump `endDate` to next-day 00:00 (L91466–91469); when an event switches from all-day to timed, `tz` is set to the user tz (L91470 `e.payload.allDay && !n.allDay && (i = t)`). Whether the server stores all-day as `"Floating"` — INFERRED (likely, not proven).-- **New-event template** (L91290–91305): `{guid:"", title:"", readOnly:false, etag:"", extendedDetailsAreIncluded:false, shouldShowJunkUIWhenAppropriate:true, tz:"", icon:0, recurrenceException:false, duration:60, allDay:false, startDateTZOffset:"", pGuid:"", hasAttachments:false, birthdayIsYearlessBday:false, alarms:[], invitees:[], recurrence:"", ...}`.-- Notification action enum L74855: `ACCEPT, DECLINE, MAYBE, OK, DECLINE_CALENDAR, JOIN_CALENDAR, JUMP_TO_EVENT, REPORT_AS_JUNK`.--## 13. UI checklist (loc key → English)--Toolbar / view (L67888–67921)-- [ ] `Toolbar.Button.Day/Week/Month/List` — Day / Week / Month / List view switch-- [ ] `Toolbar.Button.Today` — Go to today; `Toolbar.Menu.Previous/Next.Tooltip` — Previous/Next day, week, or month-- [ ] `Toolbar.Button.AddCalendar.Tooltip` — Add Calendar; "+" menu: New Event / New Calendar / New Subscription… / Refresh Calendar-- [ ] Actions menu (`Toolbar.Button.Action.*`): Go to Today, Go to Date…, Preferences…, Show/Hide Declined Events, Delete Event(s), Send Invitations…, Stop Sharing, Calendar Info, Edit/Done, Enable/Disable Local Storage, Help and Support-- [ ] Sidebar: Show calendars / Show inbox / Open actions menu (`Sidebar.Toolbar.Button.*`)--Calendar list (L67990–68010)-- [ ] Sections Subscriptions / Delegates; Birthdays calendar (+ info "Open Contacts", loading popup)-- [ ] Per-calendar action menu: Edit Calendar, Events affect availability, Delete Calendar, Edit/Delete Shared Calendar-- [ ] Inline rename placeholder "New Calendar", untitled → "Untitled", visibility checkbox, color well (palette + "Custom color...")-- [ ] Sharing popup: Private Calendar (Sharing With:, Add Person…, View & Edit / View Only, Invite Again, Remove Person, Stop Sharing), Public Calendar (Link / Email / Copy → Copied), Family Calendar, Leave Calendar-- [ ] Validation: invalid email/phone, already added, can't share with yourself, phone cannot receive invitations--Event inspector / pickers: see §11 (fields, repeat, custom recurrence, alerts, invitee row Edit/Send Email.../Remove).--Dialogs / errors-- [ ] Repeating edit / delete / reply dialogs, Save & Send, Delete and Notify, Decline and Notify, Report as Junk ("Junk invitations are automatically deleted… cannot be undone.") — §11-- [ ] Delete declined event ("…no longer appear when you choose “Show Declined Events”…")-- [ ] Calendar delete / last calendar can't be deleted / leave shared / duplicate name "A calendar with the name “%{title}” already exists."-- [ ] Quota: "Creating a new calendar would exceed the maximum number of allowed calendars."; join error variants-- [ ] Event save failed "Couldn't save changes to “%{title}”."-- [ ] Attachments: too large ("must be less than %{size}MB"), too many ("maximum of %{amount} attachments per event"), upload failed-- [ ] Availability: "No Available Time" (`AvailabilityModal.NoAvailableTime`)--Keyboard-- [ ] Delete key deletes selected event(s) (`Toolbar.Button.Action.Delete.Shortcut` "Del", backspace glyph on Mac, L67890)-- [ ] Escape cancels drag/drop (L107781); Enter/Escape commit/cancel inline edits (L113546–113547)-- No other global shortcut registry found for calendar actions (INFERRED from grep; no `key === "t"`-style handlers).--Empty states: no dedicated "No Events" / empty-list string found in the en table — VERIFIED-IN-CODE by grep (0 hits).--## Gaps-- Exact calendarws host comes from the webservices `calendar` entry at login, not this bundle; auth is cookie-based via `Zl.ckRequest`.-- Server-side tz value for all-day events ("Floating" vs user tz) not proven.-- Recurrence removal wire format and attachment removal are INFERRED (no explicit endpoint).-- `frequencyDays` encoding for multiple positions unverified.-- Inbox / notification-panel strings not enumerated.--## Invitations (VERIFIED-IN-CODE, calendar main.js, 2026-10-19)-- Statuses: `ACCEPTED | TENTATIVE | DECLINED | NEEDS-ACTION` (main.js:72676).-- Accept/Maybe/Decline in the event inspector (main.js:105007) dispatch- `eventResponseSelectedAndSaved {eventGuid, status, changeRecurring}` (76141). That runs the- **ordinary event save** (`nj`, the `ca/events` PUT) with `inviteeDetails` where my invitee- (`isMe`) carries the new `inviteeStatus` (86909–86935). There is no separate reply endpoint.- On a recurring event, `changeRecurring` is `all`/`future` as for any edit.-- Inbox: `GET ca/notifications` returns `InboxItem[]` (schema main.js:72890):- `{guid, method: REQUEST|CANCEL|REPLY|RESOURCE_CREATE|RESOURCE_UPDATE|RESOURCE_DELETE|ACCEPTED|DECLINED, objectType: Event|Collection, pGuid, collectionGuid?, lastModifiedEpoch, invitees?, initiatedBy*, acceptedBy*, shareTitle?, shareURL?, title?}`.- An Event item merges in the event's own fields.-- Dismiss an inbox item: `POST ca/inboxitem/{guid}?methodOverride=DELETE&lang&usertz&requestID&startDate&endDate` with body `{}` (87603).-- Shared-calendar invitation (objectType Collection): `POST ca/collections/{guid}?methodOverride=PUT` with body- `{guid, status: ACCEPTED|DECLINED, order, shareURL, shareTitle, isJunk?}`. Junk forces DECLINED (83860).-- Inbox text keys: `Notification.Description.EVENT_REQUEST | EVENT_UPDATE | EVENT_CANCEL | EVENT_REPLY_<status>` (118049).--## Calendars: create / rename / colour / delete (VERIFIED-IN-CODE, calendar main.js, 2026-10-19)-- `aP` (83721): `POST ca/collections/{guid}?lang&usertz&requestID&startDate&endDate[&ifMatch=<etag>][&delegator]`- - **create** (`reason: "added"`): no methodOverride; body `{Collection: <collection>, ClientState: {Collection: [{guid, ctag}], fullState: false}}`- - **rename / colour / visibility** (`"dirty"`): `methodOverride=PUT`, the same body, `ifMatch` = the collection etag- - **delete** (`"removed"`): `methodOverride=DELETE`, body `{}`- - Response schema `saveCollectionBasicResponseDetail`.-- New collection defaults (`yC`, 77328): `{title: "", guid, order: 0, visible: true, color, symbolicColor, shareTitle: "",- supportedType: "Event", objectType: "personal", extendedDetailsAreIncluded: false, readOnly: false}`.- - guid is `crypto.randomUUID()` (lowercase) (115638).- - color is the first palette colour no existing calendar uses (115640).-- Palette (`r2`, 113150): red `#ff2d55`, orange `#ff9500`, yellow `#ffcc00`, green `#65db39`, blue `#34aadc`, purple `#cc73e1`,- brown `#a2845e`, each with its `symbolicColor` name.-- Title: sanitised and **must be unique**. On a duplicate the UI shows `M0(title)` ("A calendar with the name … already exists") and does not save (115700).-- Order, visibility and default calendar: `POST ca/collectionsetting?methodOverride=PUT` (`oP`, 83777) with `{order, visible, defaultCollectionGuid}`.diff --git a/docs/icloud-web/contacts.md b/docs/icloud-web/contacts.mddeleted file mode 100644index 1d33dc9..0000000--- a/docs/icloud-web/contacts.md+++ /dev/null@@ -1,75 +0,0 @@-# iCloud.com Contacts web API (`/co/`) — reverse-engineered--Source: `pretty/contacts2/main.js` (build 2638Build32), read-only grep. Line numbers refer to `contacts2/main.js`.-Tags: **VERIFIED-IN-CODE** / **INFERRED**.--## 0. Transport (`Ri`, L30752–30790; `Fi`, L30835–30845) — VERIFIED-IN-CODE-- Service name `"contacts"`; URL from `xi.getWebServices().urlForServiceName("contacts", path)` (L30776).-- Header `{"Content-Type": "text/plain"}` with a JSON-stringified body (`ji`, L30829–30831; `Fi` L30838–30840).-- **PUT/DELETE are tunnelled**: real method becomes POST and `?method=PUT|DELETE` is appended. L30773 `"PUT" !== n.method && "DELETE" !== n.method || (s = Ni(s, "method", n.method), c = {...n, method: "POST"})`.-- Auto query params when set: `syncToken`, `prefToken`, `locale` (formatted `en_US`), `order` (`first,last` | `last,first`, L20948–20949). L30763–30770.-- Body size cap 2 MiB, 10 MiB for `co/import`. L30754 `t.startsWith("co/import") ? 10485760 : 2097152`.-- Timeouts 30 s default, 90 s for list/search/delete/export, 190 s import (L30832–30833, L31523).-- Error code map: 401 AUTH_FAILED, 403 WEB_ACCESS_DISABLED, 507 STORAGE_FULL, 520 SCHEMA_INVALID; 420/421/422 treated specially (`la`, L31043–31060).--## 1. Endpoints — VERIFIED-IN-CODE-| Call | Method | Body | Line |-|---|---|---|---|-| `co/startup` | GET | — → `StartupResponse` (`oa`) | L31173–31178 |-| `co/changeset` | POST | (no body; uses syncToken/prefToken query) → `ChangesetResponse` | L30978–30984 |-| `co/contacts/card/?offset=N&limit=M` | GET | → `{contacts: Contact[]}` | L31358–31364 |-| `co/contacts/card/?search=<q>` | GET | → `{contacts}` | L31370–31376 |-| `co/contacts/card/` | POST | `{contacts:[Contact]}` create | L31382–31384 |-| `co/contacts/card/?method=PUT` | POST | `{contacts:[Contact minus normalized/dateCreated/dateModified]}` | L31396–31398, L31224–31230 |-| `co/contacts/card/?method=DELETE` | POST | `{contacts:[{contactId}]}` | L31414–31420 |-| `co/groups/card/` | POST | `{groups:[{groupId,name,contactIds}]}` | L31453–31462 |-| `co/groups/card/?method=PUT` | POST | `{groups:[{groupId,etag,name,contactIds}]}` | L31472–31482 |-| `co/groups/card/?method=DELETE` | POST | `{groups:[{groupId}]}` | L31490–31495 |-| `co/mecardid` | **PUT** (→ POST `?method=PUT`) | `{"meCardId": "<contactId>"}` | L31501–31510 |-| `co/import/` | POST | raw vCard text → `{…changeset, importedContactIds[]}` | L31517–31531, L31239–31241 |-| `co/export/` | POST | `{contactIdsToExport:[...], exportFileName}` → vCard text | L31546–31570 |--No `co/mecard` (only `co/mecardid`) — VERIFIED-IN-CODE (grep).--## 2. Startup / changeset response `ta` (L30962–30970) + `oa` (L30985–30990) — VERIFIED-IN-CODE-```json-{ "syncToken", "prefToken", "meCardId": "…|null", "isGuardianRestricted", "restricted",- "contacts": [Contact], "groups": [Group], "collections": [{ "collectionId", "etag", "groupsOrder": [groupId] }],- "contactsOrder": [contactId], "headerPositions": {"A": 0, ...},- "deletes": { "collectionIds": [], "contactIds": [], "groupIds": [] },- "errors": [ { "contactId"|"groupId"|"collectionId" (exactly one), "etag", "errorCode": 409, "errorMessage" } ] }-```-Startup adds `sectionHeaders, sectionIndices, localizedSectionHeaders, localizedSectionIndices`. Collection `Ui` L30847–30851; deletes `ea` L30957–30961; errors `Ji` L30944–30956.--## 3. Contact shape `Yi` (L30906–30933) — VERIFIED-IN-CODE-`contactId (client crypto.randomUUID(), L26227), etag?, prefix?, firstName?, middleName?, lastName?, suffix?, nickName?, phoneticFirstName?, phoneticLastName?, companyName?, phoneticCompanyName?, isCompany?, department?, jobTitle?, birthday?: string, notes?, photo?: {url, signature?, crop?:{x,y,width,height}, "VND-63-MEMOJI-DETAILS"?}|null, emailAddresses?/phones?/urls?/relatedNames?: [{label?, field: string}], streetAddresses?: [{label?, field:{street, city, state, postalCode, country, countryCode (lowercased), subLocality, subadministrativeArea}}], dates?: [{label?, field?}], profiles?: [{label?, field?, user?, userId?, displayname?}], IMs?: [{label?, field:{userName, IMService?}}], normalized?, dateCreated?, dateModified?, isGuardianApproved?, whitelisted?, order?` (schema is `.passthrough()`, so unknown keys are kept).-Label values (e.g. `HOME`, `WORK`, `_$!<Mobile>!$_`) not enumerated in this pass — gap.--## 4. Group shape `Qi` (L30935–30943) — VERIFIED-IN-CODE-`{ groupId, name?, contactIds?: [contactId], etag?, isGuardianApproved?, whitelisted?, headerPositions? }`-- **Create**: client generates `groupId = crypto.randomUUID()` (L34546), POSTs `{groupId, name, contactIds}` (L31458–31462), then updates `groupsOrder` locally (L34557).-- **Rename / membership**: both are the same full-replace PUT `{groupId, etag, name, contactIds}` — membership is the **entire contactIds list**, no add/remove deltas on the wire (L31477–31482). The UI's "Add to List"/"Remove from List" compute the new list client-side — INFERRED from the reducer action `{groupId, addContactIds}` (L34555–34556).-- **Delete**: `{groups:[{groupId}]}` with `?method=DELETE` (L31490–31495).-- Conflicts: 412 on update triggers a `co/changeset` refetch (`Oa`, L31231–31237); per-item `errors[].errorCode` 409/412 handled (L31404–31406).-- Bulk delete >5 contacts: re-polls changeset at 1 s/4 s/16 s to confirm (`Sa`, L31238; L31425–31440).--## 5. UI menus / dialogs — VERIFIED-IN-CODE-Groups are called **Lists** in UI.-- List row menu "List actions": Rename List, Delete List; delete confirm `Delete "%{name}"?` "...will be deleted from every device..." (L34567–34572). New List dialog: "New List", "New list name", Create, default "Untitled List" (L34573–34577).-- Contact list (L47642–47705): Sort (Sort By), Select / "More options": Select All Contacts, Make This My Card, Add to List → "New List…", Remove from List, New Contact, Delete Contact(s) confirm, Remove-or-Delete prompt when in a list ("delete the card … or remove it from the list"), Import vCard, Share: Export vCard…, Print Contact(s)…. Context menu title "Contact actions". Export filenames "%{name1} and %{name2}.vcf", "iCloud vCards.vcf".-- Settings toolbar button (L34566). Sort order `first,last` / `last,first` (L20948–20949), sent as `order` query.--## Gaps-- `zi.b` preprocess applied to contacts (L30934) not inspected (likely normalisation).-- Lazy chunks `1–4.main.js` (editor UI) not mined for field label enums / custom labels.-- Pagination limits used by the app for `offset/limit` not extracted.-- Contacts beta (Beta34) vs www (32): identical API endpoint set (11 paths); the differences are UI only (checked 2026-10-19).--## Labels (VERIFIED-IN-CODE, beta contacts2 Beta34, 2026-10-19)-The editor offers a fixed list per field; each value is stored in Apple's uppercase spelling.-- Phone: `MOBILE, IPHONE, APPLE WATCH, HOME, WORK, SCHOOL, MAIN, HOME FAX, WORK FAX, PAGER`-- Email: `HOME, WORK, SCHOOL, ICLOUD` (default `HOME`)-- URL: `HOMEPAGE, HOME, WORK, SCHOOL` (default `HOMEPAGE`)-- Address: `HOME, WORK, SCHOOL` (default `HOME`)-- Dates: `ANNIVERSARY`-Anything else is a custom label, stored as typed. Quince's editor offers the same lists (ContactsView `LABELS`, 2026-10-19).diff --git a/docs/icloud-web/design.md b/docs/icloud-web/design.mddeleted file mode 100644index c76aeb7..0000000--- a/docs/icloud-web/design.md+++ /dev/null@@ -1,423 +0,0 @@-# icloud.com design reference (beta builds), light and dark--Taken on 2026-10-17 from the public, unauthenticated bundles on **beta.icloud.com**. Nothing was executed and nobody signed in.--| App | Beta build | Compared with www |-|---|---|---|-| Shell | system/icloud.com 2638BuildBeta18 | www 2638Build27. The theme tokens are identical. Beta moves most shell CSS into lazy chunks 1–9.main.css. |-| Notes | notes3 2638BuildBeta17 | CSS byte-identical to www (md5). JS differs only in build strings. |-| Reminders | reminders2 2638BuildBeta16 | CSS identical to www. JS differs only in build strings. |-| Calendar | calendar 2634BuildBeta23 | CSS differs from www mostly in minifier output (see §8). The app's own styles are **CSS-in-JS** inside main.js. |-| Contacts | contacts2 2638BuildBeta34 | main.css identical to www. Chunks 1/2/4 are shared components. |-| Drive | iclouddrive 2638BuildBeta31 | Changed: new chunks (BrowseToolbar, SharedFilePreview) and new share/request-access screens (§8). |-| Photos | photos3 2638BuildBeta15 | main.css identical to www. |--**How to read citations.** `notes3/main.css:7848` is a line in the formatted copy at-`scratchpad/icloud-bundles/pretty/beta/<app>/<file>`, which has one declaration per line. The formatter is `scratchpad/tools/cssfmt.py`. `calendar/main.js@1034282` is a byte offset in the raw minified bundle `scratchpad/icloud-bundles/beta/<app>/main.js`. The scratchpad is temporary, so re-download if it is gone. URLs: `https://beta.icloud.com/applications/<app>/<build>/en-us/main.css` and `/system/icloud.com/2638BuildBeta18/en-us/main.css`.--Tags: values without a tag were seen in the bundle. **INFERRED** means reasoned from nearby code. **UNKNOWN** means not found statically.-------## 1. Colour tokens--Every app ships the same theme block, so one copy is cited (`root/main.css`). There are four variants:-- light: `html body`, lines 8–87;-- dark: `@media (prefers-color-scheme:dark) html body`, lines 88–155;-- forced dark: `[data-appearance=dark]`, lines 156–223;-- forced light: `[data-appearance=light]`, lines 224–300.--The same block appears in `notes3/main.css:9895`, `reminders2/main.css:780`, `calendar/main.css:2519`, `contacts2/main.css:1210` and `photos3/main.css:1`. Hex values in brackets are converted from the HSL triplets.--### 1.1 Text (labels)-| Token | Light | Dark | Source |-|---|---|---|---|-| labelPrimary | rgba(0,0,0,0.88) | hsla(0,0%,100%,0.98) | root/main.css:9 / :89 |-| labelSecondary | rgba(0,0,0,0.56) | hsla(0,0%,100%,0.66) | :10 / :90 |-| labelTertiary | rgba(0,0,0,0.48) | hsla(0,0%,100%,0.5) | :11 / :91 |-| labelQuaternary | rgba(0,0,0,0.32) | hsla(0,0%,100%,0.42) | :12 / :92 |--### 1.2 Fills (hover, pressed, tracks)-| Token | Light | Dark | Source |-|---|---|---|---|-| fillPrimary | rgba(120,120,128,0.2) | hsla(0,0%,71.4%,0.3) | :13 / :93 |-| fillSecondary | rgba(120,120,128,0.16) | rgba(120,120,128,0.36) | :14 / :94 |-| fillTertiary | rgba(118,118,128,0.12) | rgba(118,118,128,0.3) | :15 / :95 |-| fillQuaternary | rgba(120,120,128,0.08) | rgba(116,116,128,0.25) | :16 / :96 |--### 1.3 Greys-| Token | Light | Dark | Source |-|---|---|---|---|-| gray1 | hsl(240,2.3%,56.7%) [#8e8e93] | same | :17–20 |-| gray2 | #aeaeb2 | #636366 | :21 / :101 |-| gray3 | hsl(240,4.7%,79%) [#c7c7cc] | hsl(240,1.4%,29%) [#49494b] | :22–25 / :102–105 |-| gray4 | hsl(240,5.7%,82.9%) [#d1d1d6] | hsl(240,1.6%,23.9%) [#3c3c3e] | :26–29 / :106–109 |-| gray5 | hsl(240,10.6%,90.8%) [#e5e5ea] | hsl(240,1.9%,20.8%) [#343436] | :30–33 / :110–113 |-| gray6 | #f2f2f7 | #2c2c2e | :34 / :114 |--### 1.4 Backgrounds and surfaces-| Token / use | Light | Dark | Source |-|---|---|---|---|-| backgroundPrimary: content, menus, popovers, sheets, list panes | hsl(0,0%,100%) [#fff] | hsl(240,3.4%,11.4%) [#1c1c1e] | :66–70 / :140–144 |-| backgroundLayer1: app toolbar (`.cloudos-toolbar.app`) | #f2f2f7 | #323236 | :71 / :145 |-| backgroundLayer2 | #fff | #434349 | :72 / :146 |-| sidebar: Notes folder panel, Calendar cells | #fbfbfd | #202023 | :82 / :151 |-| divider: Reminders sidebar edge, Notes slide-out | #d1d1d6 | #000 | :83 / :152 |-| separator: row hairlines, list headers | #d1d1d6 | #343436 | :84 / :153 |-| backdrop: modal veil | rgba(245,245,247,0.85) | rgba(10,10,10,0.8) | :81 / :150 |-| boxShadow colour | rgba(0,0,0,0.16) | rgba(0,0,0,0.65) | :77 / :149 |-| focusRing = tintBlue | rgba(0,113,227,0.7) | rgba(10,132,255,0.7) | :59,:80 / :133 |-| App toolbar bottom border | 1px gray5 | 1px gray5 | calendar/main.css:4329 |-| Split-view divider (sidebar to content) | 1px gray4 | 1px gray4 | calendar/main.css:5319 |--### 1.5 System colours-| Token | Light | Dark | Source |-|---|---|---|---|-| systemBlue | #0071e3 | #009aff | :46 / :126 |-| systemRed (destructive) | hsl(0,100%,44.5%) [#e30000] | hsl(358,100%,59.4%) [#ff3037] | :36–39 / :116–119 |-| systemGreen | #03a10e | #32d158 | :42 / :122 |-| systemOrange | #ff9500 | #ff9f0a | :40 / :120 |-| systemYellow | #fc0 | #ffd60a | :41 / :121 |-| systemPink | #ff2d55 | #ff375f | :35 / :115 |-| systemPurple | #af52de | #bf5af2 | :48 / :128 |-| systemIndigo | #5856d6 | #5e5ce6 | :47 / :127 |-| systemTeal / Mint / Cyan / Brown | #30b0c7 / #00c7be / #32ade6 / #a2845e | #40c8e0 / #63e6e2 / #64d2ff / #ac8e68 | :43–49 / :123–129 |-| tintBlueOpaque (button focus ring) | #4b9beb | #0f64bb | :60 / :134 |-| tintBlueSecondary / Tertiary | rgba(0,113,227,.28) / .12 | rgba(10,132,255,.28) / .12 | :63–66 |-| tintRed (invalid fill) | rgba(227,0,0,0.32) | rgba(244,10,10,0.48) | :61 / :135 |-| tintNotes | #ebb800 | not overridden in dark | :55 |--### 1.6 Accent per app (`--theme-color-appTint`)-| App | Light | Dark | Source |-|---|---|---|---|-| Default: Drive, Reminders, Contacts, Photos, Keynote | hsl(210,100%,44.5%) [#0071e3] | hsl(204,100%,50%) [#0099ff] | root/main.css:303–315; reminders2/main.css:1075 |-| Calendar | hsl(0,100%,44.5%) [#e30000] | hsl(358,100%,59.4%) [#ff3037] | calendar/main.css:4144, :4157 |-| Notes | hsl(47,100%,46.1%) [#ebb800], the same in dark | same | notes3/main.css:9128, :9160 |-| Notes `--key-color` (folder icons, focused selection, buttons) | rgb(235,184,0); hover #d1a400; active #ad8900; focused-hover #c09c34, with text #d6d6d6 | same | notes3/main.css:9136–9141 |-| Drive Numbers / Pages | hsl(124,96.3%,32.2%) / hsl(35,100%,50%) | hsl(134,63.3%,50.8%) / hsl(36,100%,52%) | iclouddrive/main.css:867–900 |-| Reminders list tint (`--tint-color`) | the list's own colour; title, buttons and the done tick use it | same | reminders2/main.css:7254, :7069, :7990 |--### 1.7 State model (shared)-These values come from root/main.css:73–76 and :147–148.-- **Hover** darkens lightness by 8% (`--theme-darken-background-hover:8%`). In dark it lightens by 8% (`-8%`).-- **Pressed** changes lightness by 16%.-- **Pressed tint background** is the accent at 0.16 alpha. **Pressed text** is the accent at 0.3 alpha.-- **Disabled** is opacity 0.3 in light and 0.4 in dark (calendar/main.css:4755–4766).--### 1.8 Selection colours-| App / element | Hover | Selected, unfocused | Selected, focused | Source |-|---|---|---|---|---|-| Notes folder row | fillQuaternary | fillSecondary | key colour, white text and icon; hover #c09c34 | notes3/main.css:9152–9156 vars, :7343, :7371, :7377, :7384 |-| Notes note row | none | fillSecondary | key colour, white text, snippet white | :7661, :7670, :7677, :7910 |-| Notes row with menu open | | | appTint at .3 alpha, white text | :7656, :7361 |-| Reminders list (sidebar) | fillQuaternary (`--unselected-hover-color`) | fillQuaternary (`--selection-color`); pressed fillTertiary | appTint, white text; hover tint −8%; active −16% | reminders2/main.css:10711–10726, :5941–5974 |-| Reminders reminder row | | fillQuaternary | fillTertiary (`--row-highlight-color`). Note `fillQuarternary` is misspelt in the source, so the unfocused value resolves to nothing. | :7672, :7686, :7864 |-| Drive sidebar item | fillQuaternary | gray5 | appTint, white text and icon | iclouddrive/11.main.css:356, :363, :369 |-| Drive list row | fillQuaternary, radius 10 | gray4 | appTint, white; hover `--app-accent-color-hover` (tint −8%) | iclouddrive/7.main.css:43, :46; 14.main.css:423, :426 |-| Photos sidebar | fillQuaternary | fillTertiary | systemBlue | photos3/ui.main.css:12880, :12905, :12979 |-| Menu item highlight | fillTertiary (grey, **not** the accent) | | | calendar/main.css:5562 |--## 2. Typography--**Font stack.**-- Non-Apple browsers, including Linux: `SF Pro Text, Helvetica Neue, sans-serif` for text and `SF Pro Display, …` for large titles. These are web fonts from `//www.apple.com/wss/fonts/?families=SF+Pro,v3`, linked from each app page.-- Notes uses `SFUIText` / `SFUIDisplay` (notes3/main.css:9134, :2897).-- Apple devices get `system-ui,-apple-system,BlinkMacSystemFont,…`. That stack applies only when `body[apple-system-font-capable]` is set, which JS does only on macOS ≥ 10.14 or iOS ≥ 12 (root/main.js@1362076; root/main.css:317).-- Body: 15px, weight 400 (root/main.css:303, reminders2/main.css:1075, calendar/main.css:2814). Reminders uses `.9375rem`. Notes legacy body is 15px with line-height 1.2 (notes3/main.css:12174).-- Notes body adds `font-feature-settings:"ss07"` (notes3/main.css:9132).-- **Letter-spacing: none.** Across all five apps, letter-spacing is set only to `normal`, `0` or `-.25px`, a handful of times in total. The tracking comes from the SF Text and SF Display optical cuts, not from CSS.--**Type scale.** This is the only explicit scale; it comes from Calendar's CSS-in-JS (calendar/main.js@1034282):-```-sizes micro 7 · tiny 11 · small 13 · medium 14 · regular 15 · large 17 · big 24 · bigger 26 · huge 34-weights ultralight 100 … regular 400 · medium 500 · semibold 600 · bold 700 · heavy 800 · black 900-```--| Role | Size / weight / line-height | Source |-|---|---|---|-| App title in the toolbar | 21px / 600, SF Pro Display | calendar/main.css:4226–4238 |-| Reminders list title | 2rem (32px) / 700 / 2.3125rem, in the list colour | reminders2/main.css:7283 |-| Drive folder title | 24px / 500 / 30px | iclouddrive/main.css:4858 |-| Notes editor Title / Heading / Subheading / Body (Aa menu previews) | 28/700 Display · 22/700 Display · 17/700 · 17/400 | notes3/main.css:2897–2921 (the editor itself is canvas-rendered; INFERRED to match) |-| Notes nav-bar title | 17px / 600, line-height 52px | notes3/main.css:9571 |-| Alert title / body | 19px / 600 / 1.4 · 14px labelSecondary / 1.4 | calendar/main.css:2903, :2916 |-| Card (sheet) header | 17px / 600 | calendar/main.css:8241 |-| List row primary (note title, Drive name, reminder title) | 17px / 600 / 21px (Notes) · 17px / 400 / 30px (Drive) · 1.0625rem / 1.375rem (Reminders) | notes3/main.css:7848; iclouddrive/7.main.css:72, :94; reminders2/main.css:8005 |-| List row secondary | Notes date + snippet 15px / 400 / 20px, snippet labelSecondary · Drive second row 14px labelTertiary · Reminders notes 1rem/1.25rem (.9375rem at ≥668px) labelSecondary | notes3/main.css:7872, :7900; iclouddrive/7.main.css:104; reminders2/main.css:8063, :8081 |-| Sidebar rows | 15px / 400 in Notes, Drive, Reminders and Photos | notes3/main.css:7139; iclouddrive/11.main.css:209; reminders2/main.css:6098; photos3/ui.main.css:12780 |-| Sidebar section header | 14px / 600 labelSecondary (Drive) · 14px (Photos) | iclouddrive/11.main.css:230; photos3/ui.main.css:12936 |-| Sidebar counts | 1.0625rem labelTertiary (Reminders) | reminders2/main.css:6297 |-| Notes list section header ("Today") | 15px / 700, labelSecondary | notes3/main.css:8029 |-| Drive list column headers | 14px / 400 labelTertiary | iclouddrive/14.main.css:209, :288 |-| Menu items, buttons, segmented, text fields | 14px | calendar/main.css:5486, :4748, :8549, :1277 |-| Calendar month day number | 15px / 400 (30×30 box) | calendar/main.js@2406855 |-| Calendar event text | 12px / 400, line-height 14px | calendar/main.js@2409013, @1884717 |-| Calendar week header | day number 15/600, weekday 17/400 labelTertiary | calendar/main.js@2418958 |-| Calendar now-line label | 13px, systemRed | calendar/main.js@2398430 |--## 3. Spacing and sizes--| Element | Value | Source |-|---|---|---|-| App toolbar (`.cloudos-toolbar`) | height 44px, padding-inline 16px 6px; action buttons 36×36, radius 8, 4px apart | calendar/main.css:4174, :5027 |-| Notes nav bar | 52px line box; buttons 28×28, radius 8 | notes3/main.css:9571, :9618 |-| Drive nav bar | padding 5px 15px 5px 10px; title padding-inline 9px | iclouddrive/main.css:4713, :4858 |-| Reminders sidebar width | 280px, 1px divider on the trailing edge, padding 16px 10px 0 | reminders2/main.css:5742, :5790 |-| Notes / Drive / Calendar sidebar width | UNKNOWN: set by the JS split container, not CSS | — |-| Sidebar row height | 32px for Notes folder, Drive source item and Reminders list (2rem) | notes3/main.css:7139; iclouddrive/11.main.css:316; reminders2/main.css:5895 |-| Sidebar padding | Notes folder list 10px 10px 0; rows padding-inline-end 12px | notes3/main.css:7405, :7139 |-| Sidebar icons | Notes folder 17.4×14; Drive 20px wide with 9px margin; disclosure chevron 10px | notes3/main.css:7238; iclouddrive/11.main.css:399; notes3/main.css:7292 |-| Notes note row | inset 10px each side (width calc(100% − 20px)), padding 10px; gutter 6px | notes3/main.css:7625, :7724 |-| Notes row separator | 1px, starting 33px from the row's leading edge, hidden next to the selection | notes3/main.css:7691, :7703 |-| Reminders row | padding-inline-start 14px (48px when nested); content padding 11px top and bottom, 10px end | reminders2/main.css:7689, :7806, :7920 |-| Reminders checkbox | 1.375rem (22px) circle, 12px gap before the title | reminders2/main.css:7954, :7996 |-| Reminders separator | starts at 12px + 1.375rem (34px) from the content edge | reminders2/main.css:7778 |-| Reminders list header | padding-inline 24px 10px; footer 24px | reminders2/main.css:7015, :6977 |-| Drive list rows | 41px single-line (`thin-rows`), 61px two-line (`thick-rows`); header row 44px; tbody padding-inline 20px (10px at ≤667px); list top padding 44px (20px when compact) | iclouddrive/14.main.css:326–390, :209, :271 |-| Calendar month cell | padding 6px; number box 30×30 at top left; event chip height 20px | calendar/main.js@2406855, @1942374 (`aL=20`) |-| Push button | height 30, min-width 30, padding-inline 10; large 36; icon 28×28 with a 17px svg | calendar/main.css:4685–4851 |-| Block button | height 30, padding-inline 16; large 36 | calendar/main.css:4474, :4535 |-| Text field | 36px tall, 180px default width, padding 0 10px, line-height 18px | calendar/main.css:1277, :1291 |-| Alert | compact max-width 335, padding 40px 0 20px · regular 450 wide, padding 40/40/30; icon 36px | calendar/main.css:2931–2957, :2886 |-| Popup (modal) | padding 20, margin 20, max-width 640, max-height 100vh − 40 | calendar/main.css:3407 |-| Card (bottom sheet) | max-width 600, min-height 200; header padding 20px 20px 10px | calendar/main.css:8181, :8200 |-| Menu | padding 5; min-width 130; item line-height 30, padding 0 10; leading icon box 30×30; divider 9px tall, 1px line inset 11px each side | calendar/main.css:5425, :5486, :5512, :5622, :5637 |--## 4. Shapes (corner radii)--| Element | Radius | Source |-|---|---|---|-| Menu | 12px; items 8px | calendar/main.css:5425, :5486 |-| Popover | 12px; arrow 16×10 | calendar/main.css:6937, :6989 |-| Popup / modal dialog | 11px (Calendar's availability popup is 16) | calendar/main.css:3407; calendar/main.js@2285473 |-| Card (sheet) | 10.5px 10.5px 0 0 (bottom sheet) | calendar/main.css:8181 |-| Buttons (push, block, toolbar) | 8px; focus inner ring 5px | calendar/main.css:4685, :4440, :4791 |-| Segmented | track 8px, segment 6px | calendar/main.css:8549, :8594 |-| Text field | 8px | calendar/main.css:1277 |-| Switch | pill (8.5px on a 17px track) | calendar/main.css:9009 |-| Checkbox | hit area 8px; the box itself is an SVG | calendar/main.css:6037 |-| Sidebar row selection | 10px (Notes, Drive, Reminders, Photos) | notes3/main.css:7139; iclouddrive/11.main.css:316; reminders2/main.css:5881; photos3/ui.main.css:12905 |-| List row selection | Notes 8px; Drive 10px (first and last of a contiguous run only); Reminders 10px | notes3/main.css:7625; iclouddrive/7.main.css:31–39; reminders2/main.css:7689 |-| Calendar event chip / timed block | 4px | calendar/main.js@2345946, @2346678 |-| Calendar today marker | 50% (30px circle) | calendar/main.js@2406855 |-| Reminders detail fields | 8px | reminders2/main.css:8857 |--## 5. Shadows and blur--| Element | Light | Dark | Source |-|---|---|---|---|-| Standard elevation (`--theme-boxShadow-standard`) | 0 11px 34px rgba(0,0,0,.16) | 0 11px 34px rgba(0,0,0,.65) | root/main.css:77–79 |-| Menu | standard; no border | standard (dark) | calendar/main.css:5425, :5447 |-| Popover | standard plus a .2px border in fillQuaternary | standard (dark) | calendar/main.css:6937, :6948 |-| Popup / modal | standard | standard (dark) | calendar/main.css:3407, :3453 |-| Card (sheet) | 0 0 15px rgba(0,0,0,.15) | same | calendar/main.css:8181 |-| Selected segment | 0 3px 8px fillTertiary, plus a 1px outline in fillQuaternary | 0 3px 8px rgba(0,0,0,.3) | calendar/main.css:8655, :8663 |-| Switch knob | 0 2px 4px fillPrimary, 0 2px 1px fillTertiary, .5px outline fillTertiary | same tokens | calendar/main.css:9048 |-| Sidebar | none: flat `--theme-color-sidebar` (Notes) or backgroundPrimary with a 1px divider | — | notes3/main.css:3310; reminders2/main.css:5742 |-| **Backdrop-filter** | Not used on any menu, popover, sheet or sidebar in Notes, Reminders, Calendar or Drive. The only uses are the homepage toolbar (blur 14px), the app-switcher popover (blur 50px), homepage tiles, the compact phone card (blur 15px saturate 86%) and the Notes enlarged scroll indicator (blur 10px). | | calendar/main.css:4263; root/main.css:12753, :5919; notes3/main.css:8105 |-| Modal backdrop | rgba(245,245,247,.85), a **light** frosted veil with no blur | rgba(10,10,10,.8) | calendar/main.css:3390 |--## 6. Motion--Keyframes are defined at calendar/main.css:8929–9004 and are the same in every app.--| Interaction | Duration / easing | Keyframes | Source |-|---|---|---|---|-| Context menu open and close | none: appears and disappears instantly (no CSS animation; the JS uses no `animate()`) | — | INFERRED; calendar/main.css has no `ui-menu` open rule |-| Select-button menu | in: fadeIn .2s ease · out: fadeOut .2s ease | opacity | calendar/main.css:6607, :6611 |-| Popover | in: .2s cubic-bezier(.25,.1,.25,1.3), which overshoots · out: fadeOut .2s ease | fadeInAndScale: scale .5→1, opacity 0→1 | calendar/main.css:7066, :7070, :8965 |-| Popup (modal) | in and out .2s cubic-bezier(.32,.08,.24,1) | fadeInAndBarelyScale: scale .9→1 · fadeOut | calendar/main.css:3513, :3517, :8992 |-| Alert | .2s ease-in-out (fade only under reduced motion) | scaleWithBriefFade: scale .5→1, opacity done by 80% | calendar/main.css:2995, :3000, :8977 |-| Backdrop | .2s cubic-bezier(.32,.08,.24,1); with a card .35s cubic-bezier(0,0,0,1) | fadeIn / fadeOut | calendar/main.css:3390–3399, :8283 |-| Card (sheet) | .35s cubic-bezier(0,0,0,1) | slideIn translateY 100%→0 · slideOut | calendar/main.css:8279, :8287 |-| Switch | .25s, background-color and knob inset-inline-start (knob x 1→12px) | — | calendar/main.css:9009, :9032, :9042 |-| Legacy segmented / text field | .25s colour / box-shadow | — | calendar/main.css:872, :736 |-| Scrolled-under hairline (Notes list, folder list) | border-color .12s | — | notes3/main.css:8116, :3329 |-| Reminders group disclosure chevron | transform .2s | — | reminders2/main.css:6323 |-| Image fade-in | opacity .2s ease | — | calendar/main.css:5199 |-| Calendar availability border | border-image .2s linear | — | calendar/main.js@2283854 |-| Selection change, list insert and remove, sidebar collapse | no CSS transition: these are instant | — | INFERRED (none found in any app CSS) |-| Spinner | 1s, eight nibs staggered .125s, opacity .1→.8 | — | calendar/main.css:3683–3745 |--## 7. Components--### Menu (`ui-menu.standard.icloud-mouse`)-- **Surface:** backgroundPrimary, radius 12, padding 5, min-width 130, max-width 100vw − 20, standard shadow (.16 light, .65 dark), no border, no blur. Source: calendar/main.css:5425.-- **Items:** 14px text in labelPrimary, line-height 30, padding 0 10, radius 8 (:5486).- - Hover/keyboard highlight is fillTertiary. Keyboard focus adds an inset 3px tintBlue ring (:5562, :5565).- - Pressed: background appTint @.16, icon appTint @.3 (:5996).- - Disabled: labelQuaternary (:5552).- - Leading icons are filled with appTint (:5993).-- **Destructive item:** systemRed text and icon; pressed adds a fillSecondary background (:5586–5592).-- **Link item:** systemBlue (:5601).-- **Checkmark:** a 16px icon at the trailing end, in appTint (:5614, :6004).-- **Separator:** 9px tall, 1px fillTertiary line inset 11px each side (:5622, :5637).-- **Overflow:** 18px scroller bands with 8px arrows (:5653).--### Popover (`ui-popover.standard`)-- Content uses backgroundPrimary, radius 12, overflow hidden, a .2px fillQuaternary border and the standard shadow (calendar/main.css:6937).-- The arrow is 16×10 and filled with backgroundPrimary (:6989, :6998).-- An actions footer uses a 1px gradient border in gray5 that fades out at both ends, with 19px top padding (:6969, :6986).--### Sheets-- **Popup (centred modal):** see §3–§6; radius 11, padding 20.-- **Close button:** 14px glyph in labelPrimary, radius 8 (:3422, :3447).-- **Card:** slides up from the bottom; radius 10.5 at the top only.-- **Alert:** centred title 19/600 and description 14 (:2903).--### Segmented control (`ui-segmented-control.standard`)-- **Track:** padding 2, fillTertiary background, radius 8, 14px labelPrimary text. Hover and pressed change it to fillSecondary. Focus adds a 3px tintBlue ring. Source: calendar/main.css:8549–8590.-- **Segments:** 24px tall, min-width 78, padding 0 16, radius 6 (:8594).-- **Separators:** 1×16px gray3, shown only between two unselected segments (:8632, :8652).-- **Selected segment:** backgroundPrimary in light, **gray2 (#636366) in dark**; font-weight 600; 1px outline in fillQuaternary; shadow 0 3px 8px fillTertiary (dark rgba(0,0,0,.3)) (:8655–8684).-- **Pressed segment:** fillQuaternary (:8696).--### Toggle (`ui-switch.standard`)-- **Track:** 28×17, radius 8.5. Off is gray4 (#d1d1d6 / #3c3c3e). **On is appTint, not green.** Source: calendar/main.css:9009, :9066, :9256.-- **Knob:** 15px white, 1px from the top; x is 1px off and 12px on (:9028–9048).-- **States:** hover and pressed add an inset 0 0 28px labelQuaternary shadow. Focus adds a 0 0 0 3px tintBlue ring. Disabled is opacity .3 (:9069–9088).-- **Labelled variant:** 32×17, with an "I/O" glyph (:9121).--### Checkbox (`ui-checkbox.standard`)-- **Box:** 16×16 SVG. Unchecked: a square stroked in gray3. Checked: the square fill (`checkmark-square-fill`) in appTint with the checkmark drawn over it. Source: calendar/main.css:6079–6128, :6195.-- **Hit area:** a 16px box with 6px padding, radius 8. Hover gives it fillTertiary. Focus adds fillTertiary plus an inset 3px tintBlue ring. Pressed: appTint @.16 (:6057, :6160–6198).-- **Labelled variant:** padding 7×12, 14px label (:6219, :6244).-- **Calendar list checkbox:** the fill is the calendar colour, and the checkmark is white or dark depending on contrast (calendar/main.js@2520199).-- **Reminders checkbox:** a 22px circle glyph. Unchecked it is labelTertiary; completed it is filled in the list colour (reminders2/main.css:7990–7996).--### Search field-There is no shared search field.-- **Notes:** `.notes-list-search-field` in notes3/main.css. The full metrics were not extracted (UNKNOWN).-- **Drive:** `.skybridge-searchbox` in iclouddrive/9.main.css (not re-fetched; UNKNOWN).-- **Legacy `cw-search-field`:** 36px tall, 17px text, 16px glass icon in #ccc at 10px inset, padding-inline 31 (calendar/main.css:927–1004). It is legacy and should not be used as the model.-- **Text field (`ui-text-field.standard`):** 1px gray3 border, radius 8, 36px tall, 14px text, placeholder labelTertiary. Hover overlays fillQuaternary. Focus removes the border and draws an inset 3px tintBlue ring, and the placeholder becomes labelQuaternary. Disabled is opacity .3. Source: calendar/main.css:1277–1508.--### Buttons-| Variant | Values | Source |-|---|---|---|-| Push, default (borderless) | 30px tall, radius 8, padding-inline 10, 14px, text appTint. Hover: fillTertiary. Pressed: background appTint @.16, text appTint @.3. | calendar/main.css:4685–4918 |-| Push primary / secondary | weight 600 / 400 | :4828, :4831 |-| Push destructive | systemRed text, no transition; pressed fillPrimary background, red @.3 | :4964, :4969 |-| Push "pressed" (toggled on) | appTint background, white text | :4922 |-| Block primary (filled) | appTint background, white text, radius 8, 30px, padding 16, 14px; hover tint −8% L, pressed −16% | :4669–4679, :4474 |-| Block secondary | gray5 background in light, gray4 in dark; labelPrimary text; hover/pressed darken | :4596–4619 |-| Block secondary destructive | gray5/gray4 background, systemRed text | :4624 |-| Block neutral | gray1 background, white text | :4580 |-| Toolbar icon button | 36×36, radius 8, labelPrimary; hover fillSecondary; pressed fillPrimary; open gray3 background with backgroundPrimary glyph | :5027–5066 |-| Notes toolbar button | 28×28, radius 8; icon in key colour; pressed: key colour @.16 background, icon @.3; menu open: key-colour background, white icon | notes3/main.css:9618–9665 |-| Focus (all buttons) | inset 0 0 0 3px tintBlueOpaque plus a 1px white inner ring (gray5 in dark) at 3px, radius 5 | calendar/main.css:4773–4791 |--### List rows-| App | Normal | Hover | Selected, focused | Selected, unfocused |-|---|---|---|---|---|-| Notes note | backgroundPrimary; padding 10; radius 8; title 17/600; summary 15; separator from 33px | none | key colour (yellow), all text white | fillSecondary |-| Notes folder | 32px, radius 10, 15px; yellow folder glyph | fillQuaternary | key colour, white | fillSecondary |-| Reminders list | 32px (2rem), radius 10, 15px; count 17px labelTertiary | fillQuaternary | appTint, white | fillQuaternary |-| Reminders reminder | 22px circle, 17px title, 11px vertical padding, radius 10, separator from 34px | — | fillTertiary | fillQuaternary (as intended; see §1.8) |-| Drive file | 41px (61px two-line), name 17px, meta 14px labelTertiary, separator hairline | fillQuaternary, radius 10 | appTint, white | gray4 |-| Drive sidebar | 32px, radius 10, 15px, appTint glyph | fillQuaternary | appTint, white | gray5 |--## 8. Calendar specifics (CSS-in-JS in calendar/main.js)--- **Theme constants** map straight onto the CSS variables (@1880470): `Fk=labelPrimary`, `Uk=labelTertiary`, `Jk=systemRed`, `Qk=backgroundPrimary`, `Xk=backgroundLayer1`, `fR="1px solid "+backgroundLayer1`, `uR=sidebar`.-- **Month cell:**- - Top border 1px backgroundLayer1. The highlighted cell background is `--theme-color-sidebar` (@2406614). INFERRED: this marks the weekend or the selection.- - The day number sits at top left in a 30×30 box, 15/400. In-month numbers are labelPrimary; out-of-month numbers are gray5.- - **Today** is a filled systemRed circle with backgroundPrimary text and a 6px gap (@2406855).-- **Week header:** today's number sits in a 30px red circle (15/600). The weekday name is 17px labelTertiary (@2418958).-- **Event chip in month view:**- - 20px tall, radius 4, padding-inline 5, 12px regular (@2409013, @1942374).- - **Background:** the calendar colour at **20% alpha**, or 90% when selected (`YB`, @2007511).- - **Text:** a darkened variant per calendar colour: red #932f40, orange #a24311, yellow #a24311, green #558d2f, blue #2a6193, purple #7e4d82, brown #865033 (@2008437).-- **Timed event block:** padding 3, radius 4, a **3px left border** in the calendar colour, 12px text with line-height 14 (@2346678).-- **Now line:** systemRed. Its label is 13px, right-aligned, 10px from the gutter edge (@2398430).-- **beta vs www (calendar/main.css):**- - Beta moves `border-radius:13px` on `.cw-alert.cw-modal-dialog:before` to touch mode only (www: all modes; beta: `[data-primary-interaction-mode=touch]`).- - The monogram font is now `SFUIText,Helvetica Neue` with a `system-ui` override.- - Everything else is minifier noise, for example `#c70a00` written as `rgb(199,9.5,0)`.- - The JS grew by about 14KB. The design tokens are unchanged.--## 9. Drive and Photos (brief)--- **Drive beta vs www.**- - Same values in SourceList, PathBar, Search, Move and the Grid/List leaf chunks (0 differing lines).- - The shared list chunk lost the `[data-overflow-fade]` utility (55 lines moved).- - QuickLook differs by 824 lines and main.css by 1280. These are new request-access, join-share, edit-gate and restricted-unauth screens (beta main.css). BrowseToolbar (8.main.css) and SharedFilePreview (15.main.css) are beta-only.- - No token values changed.-- **Photos:**- - The sidebar is a `tree-view.sidebar` with a fillQuaternary background. Items are 15px, radius 10. Hover fillQuaternary, selected fillTertiary, focused systemBlue (photos3/ui.main.css:12763–12979).- - Section titles are 14px.- - Photos-specific variables: sidebar-material-fill hsla(0,0%,100%,.85) in light and rgba(40,40,40,.5) in dark; sidebar border #e6e6ea / #333 (photos3/main.css:396–400, :510–514).-- **Contacts:** the app's own styles use hashed CSS-module class names (`._1SIfy45…`) that map to components only through JS. They were not resolved, so Contacts row and card metrics are UNKNOWN. Its controls are the shared components above.-- **Reminders has no smart-list tiles on icloud.com.** The CSS has no tile classes, and the JS has no Today/Scheduled/Flagged list keys (only `Date.Today` and `Reminder.Flagged.VoiceOver`). The sidebar is a plain list of lists.-------## 10. Quince vs icloud.com--Ranked by how visible each difference is. Quince files are in `src/styles/`. Rows marked **DELIBERATE** contradict a comment in Quince's own CSS, so they are listed for completeness and should not be changed without asking.--### High visibility-| # | What | Quince now | icloud.com | Where to change |-|---|---|---|---|---|-| 1 | Accent | one gold for every app: `--gold #c8912a` | per app: Notes #ebb800, Calendar #e30000 / #ff3037, Drive, Reminders and Contacts #0071e3 / #0099ff | tokens.css `:root --gold*`. **DELIBERATE** (tokens.css:1–4). |-| 2 | Focused selection | tinted: `.nav-item[aria-current] gold-tint 13%`, `.note-row[aria-current] gold 26%`, `.rx-list[aria-current] text 12%`, `.notes-folder[aria-current] text 12%` | **solid accent with white text** when the list has focus; fillSecondary (Notes) / fillQuaternary (Reminders) / gray5 (Drive) when it does not | notes.css `.note-row[aria-current]`, `.notes-folder[aria-current]`; reminders.css `.rx-list[aria-current]`; app.css `.nav-item[aria-current]`, `.drive-row.is-selected` (Drive already fills with `--sys-blue`, which matches) |-| 3 | Base text size | body 13px (`--t-13`); rows, sidebar and menus 13px | body 15px; sidebar rows 15px; list primary 17px; menus, buttons and fields 14px | tokens.css `body font-size`, and the `--t-13` uses in row selectors. **DELIBERATE** (tokens.css:30–31). |-| 4 | Sidebar material | floating glass plateau: `.sidebar` blur(28px) saturate(180%), radius 10, 8px inset, 196px | flat and opaque: `--theme-color-sidebar` #fbfbfd / #202023 (Notes) or white, a 1px gray4/divider edge, no blur, no radius; Reminders 280px | app.css `.sidebar`. **DELIBERATE** (app.css:252–253, the "Liquid Glass" chrome). |-| 5 | Sidebar row shape | `.nav-item` min-height 34, radius 7; `.notes-folder` 30 / 7; `.rx-list` 32 / 7; `.cx-cal` 26 / 6 | 32px, **radius 10**, 15px | app.css `.nav-item`; notes.css `.notes-folder`; reminders.css `.rx-list`; calendar.css `.cx-cal` |-| 6 | Notes list row | `.note-row` padding 8px 10px 9px, radius 8; title 13/700; meta 11 | padding 10, radius 8, title **17/600/21**, date and snippet **15/400/20**, snippet labelSecondary, separator from 33px | notes.css `.note-row`, `.note-row-title`, `.note-row-meta` |-| 7 | Reminders row | `.rx-tick` 20px, ring text @32%; `.rx-title` 13px / 20px; padding 7px | **22px** circle in labelTertiary, title 17px / 22px, 11px vertical padding, separator from 34px | reminders.css `.rx-tick`, `.rx-title`, `.rx-row`, `.rx-row::after left` |-| 8 | Reminders sidebar tiles | `.rx-tiles` 2×N tile grid | none on icloud.com: a plain list of lists (the tiles are a macOS/iOS feature) | reminders.css `.rx-tiles` (a design choice; keep it if macOS parity is the goal) |-| 9 | Context and row menus | `.row-menu` radius 10, item `5px 10px` radius 6; highlight **`--sys-blue` fill, white text**; `.picker-menu li.is-active` gold fill | radius **12**, padding 5, items 30px line, radius **8**, 14px; highlight **fillTertiary grey**, text stays labelPrimary; destructive in systemRed text; shadow 0 11px 34px | app.css `.row-menu`, `.row-menu-item.is-active`, `.picker-menu`, `.picker-menu li.is-active`, `.upload-menu button:hover` |-| 10 | Modal veil | `.modal-veil` rgba(0,0,0,.32) + blur(2px) | light rgba(245,245,247,.85) / dark rgba(10,10,10,.8), no blur | app.css `.modal-veil` |-| 11 | Drive list rows | `.drive-row-hit` padding 8px 10px, 13px (about 36px tall); meta 11px | 41px rows (61px two-line), name 17px, meta 14px labelTertiary; hover fillQuaternary radius 10; header 44px, 14px labelTertiary | app.css `.drive-row-hit`, `.drive-meta`, `.drive-head`, `.drive-col` |-| 12 | Calendar month cell | `.cx-daynum` top **right**, 13px in a 22px pill; weekday names right-aligned 13px | day number top **left**, 15px in a **30px** circle; today a red filled circle; out-of-month gray5 | calendar.css `.cx-daynum`, `.cx-daynum.is-today`, `.cx-weekdays span` |-| 13 | Calendar chips and blocks | `.cx-item` 18px tall, 11px, radius 4, dot + title; `.cx-bar-event` cal @24%; `.cx-block` cal @22% mixed with bg, radius 5, 11px | chip **20px**, **12px**, padding-inline 5, background cal @**20%** with a darkened per-colour text (#932f40 …); block radius **4**, 3px left border, 12px | calendar.css `.cx-item`, `.cx-bar-event`, `.cx-block`, `.cx-block-title` |--### Medium visibility-| # | What | Quince now | icloud.com | Where |-|---|---|---|---|---|-| 14 | Text colours | `--text #1d1d1f`, `--text-2 #6e6e73`, `--text-3 #8e8e93`; dark #f5f5f7 / #a1a1a6 / #8e8e93 | alpha labels: rgba(0,0,0,.88 / .56 / .48 / .32); dark hsla(0,0%,100%,.98 / .66 / .5 / .42) | tokens.css `--text`, `--text-2`, `--text-3` |-| 15 | Backgrounds | `--bg #f5f5f7` / `#1c1c1e`; `--sheet #fff` / `#2c2c2e` | content #fff / #1c1c1e; sidebar #fbfbfd / #202023; toolbar #f2f2f7 / #323236; menus and sheets #fff / **#1c1c1e** (not #2c2c2e) | tokens.css `--bg`, `--sheet` |-| 16 | Separators | `--separator rgba(0,0,0,.11)` / `rgba(255,255,255,.13)` | opaque #d1d1d6 / #343436; split divider gray4 #d1d1d6 / #3c3c3e | tokens.css `--separator` |-| 17 | System colours | `--sys-blue #007aff/#0a84ff`, `--sys-red #ff3b30/#ff453a`, `--sys-orange #ff9500/#ff9f0a`, green #34c759 | blue **#0071e3 / #009aff**, red **#e30000 / #ff3037**, orange #ff9500 / #ff9f0a, green **#03a10e / #32d158** | reminders.css `:root --sys-*`; reminders.css `.rx-switch` green fallback |-| 18 | Destructive red | `--danger #c1121f` / `#ff6b6b` | systemRed #e30000 / #ff3037 | tokens.css `--danger` |-| 19 | Primary button | `.primary` padding 5px 14px, radius 7, 13px/550, background `--gold-deep` | block primary 30px tall, padding 16, radius 8, 14px, appTint background, white | app.css `.primary` (colour **DELIBERATE**, app.css:89–94; the size and radius are not) |-| 20 | Secondary button | `.quiet` 0.5px border, field background, 4px 10px, radius 7 | borderless push (30px, tint text, hover fillTertiary) or block secondary (gray5 fill, no border) | app.css `.quiet`, `.chev`, `.today-btn`, `.cx-today`, `.picker-button` |-| 21 | Segmented control | `.segmented` padding 2, gap 2, radius 7, track text @7%; `.segment` 11px/510, 3px 10px, radius 5; selected 590 with a 0 1px 2px shadow | track fillTertiary, radius 8; segment **24px**, min-width 78, padding 0 16, radius 6, **14px**; selected 600, 0 3px 8px fillTertiary, background **gray2 #636366 in dark** | app.css `.segmented`, `.segment`, `.segment[aria-pressed]` |-| 22 | Toggle | `.rx-switch-track` 34×20, knob 16, on = green, 160ms | 28×17, knob 15, **on = appTint**, off gray4, .25s | reminders.css `.rx-switch-track` |-| 23 | Popover | `.cx-popover` radius 12, 1px glass-edge border, 110ms fade | radius 12, .2px fillQuaternary border, shadow 0 11px 34px; opens .2s scale .5→1 with cubic-bezier(.25,.1,.25,1.3) | calendar.css `.cx-popover`, `@keyframes cx-pop` |-| 24 | Modal sheet | `.modal-sheet` radius 12, padding 20px 22px, 160ms scale .98 | radius **11**, padding 20, .2s cubic-bezier(.32,.08,.24,1), scale .9→1 | app.css `.modal-sheet`, `@keyframes modal-sheet-in` |-| 25 | Shadow | `--shadow-sheet 0 14px 44px rgba(0,0,0,.15), 0 1px 3px rgba(0,0,0,.09)` / dark .55 | 0 11px 34px rgba(0,0,0,.16) / dark **.65** | tokens.css `--shadow-sheet` |-| 26 | Search fields | `.notes-search` / `.rx-search` / `.cx-search` 26–28px tall, text @7% fill | text field 36px, 1px gray3 border, radius 8, 14px; focus is an inset 3px tintBlue ring with no border | notes.css `.notes-search`; reminders.css `.rx-search`; calendar.css `.cx-search` (the iCloud search boxes themselves are UNKNOWN) |-| 27 | Titles | `.content h1` 28/600 −0.022em; `.rx-head h1` 26/700; `.notes-list-title h1` 17/700 | Reminders list title 32/700 in the list colour; Drive folder 24/500; Notes nav title 17/600 | app.css `.content h1`; reminders.css `.rx-head h1`, `.rx-head-count` |--### Low visibility-| # | What | Quince now | icloud.com | Where |-|---|---|---|---|---|-| 28 | Letter-spacing | negative tracking on titles (−0.015 to −0.022em) in app.css, notes.css and reminders.css | none; tracking comes from the SF Text/Display font cuts | `.sheet h1`, `.content h1`, `.cal-nav h1`, `.nf-title`, `.rx-head h1`, `.rx-tile-count` |-| 29 | Focus ring | 3px `--gold-ring` outline (offset varies); Reminders and Calendar use sys-blue @40% | inset 3px tintBlue rgba(0,113,227,.7); buttons add a 1px white inner ring | every `:focus-visible` rule |-| 30 | Motion curve | `--ease cubic-bezier(.32,.72,0,1)`; sidebar width 260ms; hover 120–140ms | popups .2s cubic-bezier(.32,.08,.24,1); cards .35s cubic-bezier(0,0,0,1); hover and selection instant | tokens.css `--ease`; app.css `.sidebar`, `.content` transitions |-| 31 | Menu animation | none (matches iCloud: menus are instant) | none | — (already matches) |-| 32 | Disabled | opacities vary (0.4–0.5), or `--text-3` | opacity .3 light / .4 dark | `:disabled` rules |-| 33 | Calendar checkbox | `.cx-cal input` 14px, radius 4, 1.5px border | 16px SVG checkbox with the fill in the calendar colour and a white or dark check chosen by contrast | calendar.css `.cx-cal input` |-| 34 | Notes checklist circle | `.nf-circle` 17px, 1.5px text-3 border, gold fill | Notes uses the yellow key colour (rendered by the canvas editor; size UNKNOWN) | notes.css `.nf-circle` |-| 35 | Toolbar | none (controls sit inline in the content) | 44px app toolbar, backgroundLayer1, 1px gray5 bottom border, 36px icon buttons | structural; no single selector |--## icloud.com motion, exact (VERIFIED-IN-CODE, shared ui-kit CSS in design/raw/*/*.css, 2026-10-19)-| Element | Animation |-|---|---|-| Popover opening (`ui-pane.is-opening ui-popover.standard`) | `fadeInAndScale` 200ms `cubic-bezier(.25,.1,.25,1.3)`: opacity 0→1, scale .5→1 (slight overshoot) |-| Pop-up menu opening (`ui-pane.for-ui-popup.standard.is-opening ui-popup`) | `fadeInAndBarelyScale` 200ms `cubic-bezier(.32,.08,.24,1)`: opacity 0→1, scale .9→1 |-| Select menu closing (`.ui-select-button-menu`) | `fadeOut` 200ms ease, forwards |-| Menu item chosen with the mouse | `uiMenu-standard-mouse-keyframes-flash`: a brief `--theme-color-fillTertiary` flash before close |-| Modal dialog | `cw-modal-fade-in` (backdrop) + `cw-modal-pop`: opacity 0→1 by 80%, scale .5→1 |-| Bottom sheets / toasts | `slideIn` / `slideOut`: translateY(100%)↔0 |-Every one animates **only opacity and transform**, and none of these surfaces uses `backdrop-filter`:-`.cw-modal-dialog` is an opaque `#fff` with a box-shadow. No sidebar width transition was found in the shared CSS; the-sidebar collapse is not animated in this kit.--**For Quince (WebKitGTK):** the flicker came from blur and from animating layout (width, padding). Quince now has no-blur on these surfaces, so it could bring back icloud.com's exact 200ms opacity+transform open for popovers and menus-without the old glitch. Keep the sidebar fold as a single step, which matches icloud.com. Try it in the real GTK window-first, because his machine is the judge.diff --git a/docs/icloud-web/drive.md b/docs/icloud-web/drive.mddeleted file mode 100644index c2632b0..0000000--- a/docs/icloud-web/drive.md+++ /dev/null@@ -1,266 +0,0 @@-# iCloud web Drive (iclouddrive) — reverse-engineered facts--Source: `iclouddrive/` bundles, build 2638Build17, beautified copies in the session-scratchpad (`icloud-bundles/pretty/iclouddrive/`). Line numbers refer to the beautified-files. Read-only grep; nothing executed, no sign-in. Tags: **VERIFIED-IN-CODE** (seen-literally) / **INFERRED** (deduced, not seen directly).--## Ids and constants--- Drive ids are `TYPE::zone::docwsid`, TYPE ∈ `FILE, FOLDER, SHARED_FILE, SHARED_FOLDER, FILE_IN_SHARED_FOLDER, FOLDER_IN_SHARED_FOLDER`; the special id `TRASH_ROOT` is also valid — main.js L835-840 `const O = ["FILE","FOLDER","SHARED_FILE",...]` / `if ("TRASH_ROOT" === e) return !0; const t = e.split("::"); return 3 === t.length`. VERIFIED-IN-CODE-- Root = `FOLDER::com.apple.CloudDocs::root`, trash = `TRASH_ROOT`, search = `SEARCH_RESULTS` — main.js L622-624. VERIFIED-IN-CODE-- Two client modes: `DRIVE_SERVICE_UNIFIED` (drivews) and `DRIVE_SERVICE_ENUMERATE` (docws `/v1/enumerate`); in ENUMERATE mode root id is `"root"` and trash is `"trash"` — main.js L12757-12760, L12809, L13253 `const e = L === T.ENUMERATE ? s : d`. Which mode is live for an account is decided at runtime (gap). VERIFIED-IN-CODE--## drivews (`urlForServiceName("drivews")`)--Transport: every call is `POST https://<drivews host>/<name>`, body `JSON.stringify(payload)`, header `Content-Type: text/plain` — main.js L1102-1124 `post(e,t,...) { return this.sendRequest(e,t,n,i,o,"POST") }`, `headers: {"Content-Type": "text/plain"}`. Full list of known paths — main.js L1080 `v = new Set(["/retrieveSharedItemDetailsInFolders", "/retrieveItemDetailsInFolders", "/retrieveItemDetails", "/retrieveTrashDetails", "/createFolders", "/deleteItemsInTrash", "/deleteItems", "/moveItemsToTrash", "/moveItems", "/renameItems", "/shareFolder", "/moveItemsFromTrash"])`. VERIFIED-IN-CODE. Plus `putBackItemsFromTrash` (L8236). VERIFIED-IN-CODE-HTTP errors: `402→AccountNotMigrated, 421→Unauthenticated, 423→PCSMissing, 424→PCSInvalid`, ≥500 Server — main.js L1153-1158. Read paths use an 180 s timeout (`AbortSignal.timeout(18e4)`, L1127). VERIFIED-IN-CODE--### Generic batched item op (module 2231, main.js L20327-20395)-Used for `moveItems`, `moveItemsToTrash`, `moveItemsFromTrash`, `deleteItems`, `putBackItemsFromTrash`, `renameItems`:-```-{ items: [ { drivewsid, shareID? /* only when item.share === "TO_ME" */,- etag, clientId /* = item id */ } ], ...extra }-```-- `renameItems` item = `{drivewsid, shareID?, etag, name, extension /* files only */}`; `putBackItemsFromTrash` item = `{drivewsid, shareID?, etag}` — L20349-20357 `case "renameItems": return {...n, etag:o, name:a, extension: ...}`. VERIFIED-IN-CODE-- Response `{ items: [{ drivewsid, status, etag, parentId, name, type, ... }] }`; `status === "OK"` is success. On `ETAG_CONFLICT` with unchanged `parentId`, the client retries once with the returned `etag` — L20364-20372. VERIFIED-IN-CODE. Other status seen: `UNSHARE_ERROR` (L8166), `ID_INVALID` (L14180). VERIFIED-IN-CODE-- `moveItems` extra = `{destinationDrivewsId, shareID? /* dest TO_ME share */}`; when source is trash and dest isn't, it uses `moveItemsFromTrash` with `{destinationDrivewsId}` — main.js L19586-19590. VERIFIED-IN-CODE--### retrieveItemDetailsInFolders-- Body is an **array**: `[{drivewsid, shareID?, partialData:false, includeHierarchy:true}]` (or `{item_id}` variant) — main.js L14130-14152. VERIFIED-IN-CODE-- Response array of folder objects (zod `Tn`, L14095-14121): `docwsid, drivewsid, item_id, parentId, zone, type, name, etag, assetQuota, fileCount, shareCount, shareAliasCount, directChildrenCount, shareID, share, owner, favorite_order, dateModified, dateChanged, status, syncState, numberOfItems, hierarchy:[{drivewsid,etag,name,extension}], items:[{drivewsid,item_id,name,type,...passthrough}]`. Error entries `{status, shareID?}`; `"ID_INVALID"` + shareID ⇒ unshared. VERIFIED-IN-CODE-- Trash listing in UNIFIED mode = this call with `drivewsid: "TRASH_ROOT"` — `fetchTrash` → `fetchFolderContentCore({folderId: d /*TRASH_ROOT*/})` → `zn({drivewsid: e.folderId})`, main.js L14509-14517, L14382-14386. VERIFIED-IN-CODE. `/retrieveTrashDetails` and `/deleteItemsInTrash` exist in the path set but no caller found (gap).--### retrieveItemDetails-`{ items: [{drivewsid, includeHierarchy, shareID?}] }` → `{ items: [...] }` — main.js L1455-1466. VERIFIED-IN-CODE--### createFolders (createFolder~95b965f1.js L203-219)-```-{ destinationDrivewsId, shareID?, folders: [{ name, clientId }] }-→ { folders: [{ status:"OK"|"ETAG_CONFLICT", etag, parentId, drivewsid, ... }] }-```-Retries once on `ETAG_CONFLICT`. VERIFIED-IN-CODE--### Delete / trash-- "Delete" on a normal item = `moveItemsToTrash` (main.js L8155 `gn.a("moveItemsToTrash", e)`); App Libraries and shared-to-me items instead go to `deleteItems` immediately (L8130-8178: `e || t ? o.push(s) : r.push(s)` … `yn(o, i, "deleteSharedToMe"|...)`). VERIFIED-IN-CODE-- "Delete Forever…" (purge) and "Delete All" in trash = `deleteItems` with source `deleteFromTrash` after a confirm alert — main.js L12432 `"delete" === n ? yn(e, t, "deleteFromTrash")`, L8076. VERIFIED-IN-CODE-- Recover = `putBackItemsFromTrash`; optimistic destination computed from item `restorePath` (split on `/`, walk from root) — main.js L8236, L8270-8279 `if (!e.restorePath) return j.x; const t = e.restorePath.split("/")`. VERIFIED-IN-CODE--### shareFolder-`{ drivewsid, ckShareOperation: { operationType:"create", record:{...fields, "cloudkit.type":{value:"com.apple.folder"}}, zoneID } }` → `{status:"OK", ckShareResult}` — buildShareModalConfigs~88ce8791.js L188-203, main.js L11308 `P.post("shareFolder", e)`. Only used for unshared folders (`createShareFnOverride: isFolder && !m.share`). Files and existing shares go through CloudKit JS on `ckdatabasews` (main.js L6547 `o("ckdatabasews")`), `databaseScope` Shared if `share==="TO_ME"` else Private. VERIFIED-IN-CODE--## docws (`urlForServiceName("docws")`)--| Purpose | Path / body | Cite | Tag |-|---|---|---|---|-| Download URL | `POST ws/<zone>/download/batch[/<ownerRecordName>]?token=<validateToken>`, body `[{document_id}]` (batched ≤30, or single `{document_id}`) → `[{data_token:{url}, package_token?, thumbnail_token?, manifest_token?, document_id}]` | main.js L19772 `` `ws/${c}/download/batch${l}` ``, L20833, L20787-20794 | VERIFIED |-| Download (iWork lib) | `GET /ws/<zone>/download/by_id[_etag][/<owner>]?document_id&dsid&publish=false&redirect=true&token[&double_etag]`; shared-by-link `/ws/none/download/by_token?sharing_token=` | vendors~main~64216fa6.js L24519-24545 | VERIFIED (shared lib; Drive UI uses batch) |-| Package download | `package_token.url` → filename gets `.zip` | main.js L6545-6556 | VERIFIED |-| Duplicate | `POST v1/item/copy/<item_id>?dsid=<dsid>` body `{info_to_update:{}}` → `{item_id}`; then `GET ws/<zone>/list/lookup_by_id?document_id=<item_id>&unified_format=true` → `{docwsid, drivewsid, item_id, etag, parentId, type:"FILE", size, dateChanged, dateModified, zone, name, extension, urls:{url_download,url_thumbnail}}` | main.js L19857-19880, L19689-19706, L12576 | VERIFIED |-| Lookup | `POST ws/<zone>/list/lookup_by_id[/<owner>]` body `[{etag, document_id}]` → `[{item_id, document_id, parent_id, zone, size, type, name, extension, ctime, mtime, share_id, share_info{shared, shared_publicly, share_type}, sharing_token, short_guid, status{error_message,status_code}}]` | main.js L19881-19897, L19714-19736 | VERIFIED |-| Short GUID (share URL) | `POST ws/<zone>/update/create_short_guid[/<owner>]?errorBreakdown=true&document_id=` → `{short_guid, etag}` | main.js L19898-19907, L19709 | VERIFIED |-| Update doc | `POST ws/<zone>/update/documents?errorBreakdown=true` (or `ws/<shareZone>/update/shared/<owner>`) → `{status, results:[{document:{item_id, document_id, etag, name, short_guid, size}, status}]}`; retried ×5 on 409 `ZONE_BUSY` | main.js L19814-19836, L19744-19759 | VERIFIED |-| Mark opened | update/documents body `{document_id, lastOpenedTime: Date.now(), command:"modify_file"}` | main.js L6798-6803 | VERIFIED |-| Enumerate | `GET /v1/enumerate/{files|folders}/<folderId>?limit=200&unified_format=true` → `{drive_item:[...]}`; apps `v1/enumerate/apps` | main.js L14052-14080, L14524 | VERIFIED |-| Favorites | `ws/_all_/list/enumerate/favorites?limit&unified_format=true`; delta `ws/_all_/list/changes/favorites?limit=50&nextPage=<continuationMarker>` (304 unchanged, 205 reset) | main.js L13962, L14002 | VERIFIED |-| Recents | `ws/<appId>/list/recents` | vendors~main~64216fa6.js L21262 | VERIFIED |-| Zone | `ws/com.apple.CloudDocs/internal/create_zone?create_metadata=true&errorBreakdown=true&idempotent=true` | main.js L19850 | VERIFIED |--### Upload (3 steps) — main.js L17746-17960, uploadFiles~5ad45e42.js L170-212-1. `POST ws/<zone>/upload/web?token=<validateToken>` (shared folder: `ws/<zoneName>/<ownerRecordName>/<recordName>` appended) body `{filename, type:"FILE"|"PACKAGE", content_type, size}` → `[{url, document_id, owner_id, owner?}]` (`WireCWSUploadUrlDetails`, main.js L20056-20063). VERIFIED-IN-CODE-2. XHR `POST <url>` with **raw file body** (not multipart), `Content-Type: <file.type>` — uploadFiles chunk L212 `s.open("POST", e.toString()), s.setRequestHeader("Content-Type", r.type) ... s.send(r)`. Response `{singleFile:{fileChecksum, wrappingKey, referenceChecksum, receipt?, size}}` or package form `{hexBrSyntheticChecksum, ckManifest, brManifest, ckSectionAssets}`; client checks `singleFile.size === file.size` (main.js L20038-20067, L17874-17879). VERIFIED-IN-CODE-3. `update/documents` body:-```-{ document_id, path:{ starting_document_id: <folder docwsid | shareID.recordName>, path: <filename> },- allow_conflict: true, file_flags:{is_writable:true,is_executable:false,is_hidden:false},- mtime, btime, command:"add_file",- data:{ signature, wrapping_key, reference_signature, receipt, size } }-```-Signatures are base64url→base64 converted (`l()`, L20032-20036). 413 ⇒ out of quota. VERIFIED-IN-CODE. No `sendFile` endpoint found (gap/none).--### Thumbnails / preview-- Thumbnail = `thumbnail_token.url` from download/batch; else, for png/jpg/jpeg/gif/bmp < 1 MiB, the `data_token.url` itself — main.js L4268-4274. URLs cached 10 min (`x = 6e5`, L20797). VERIFIED-IN-CODE-- iWork thumbnails: `<iworkthumbnailws>/iw/ws/<dsid>/thumbnail?document_id&etag&width&height&zone` — vendors~main~64216fa6.js L29153. VERIFIED-IN-CODE. Export: `/iw/export-ws/<dsid>/<action>` (L24604). VERIFIED-IN-CODE--## Trash "time left"--- Field: **`dateExpiration`** (ISO string) on trashed items — FolderContentsGrid~RecentsGrid~SharedGrid~988faf90.js L152-154 `let { dateExpiration: t } = e`. VERIFIED-IN-CODE-- Computation: `ms = Date.parse(dateExpiration) - Date.now()`; ≤0 → "0 minutes"; `floor(ms/day)` ≥1 → "1 day"/"%{count} days"; else hours; else minutes. Class `time-remaining warn` when < 4 days (`s = 4 * a`) — same file L147-172. VERIFIED-IN-CODE-- Items whose `dateExpiration` is ≥15 days in the past are hidden (`1296e6` ms) — main.js L20464-20467. VERIFIED-IN-CODE-- List column "Time Left" (`FolderContentsList.ColumnHeading.TimeLeft`, main.js L16388). Sidebar "Recently Deleted (%{totalNumberOfItems})" (L16353-16354). Empty: "No items" (L16128). VERIFIED-IN-CODE-- 30-day retention itself not stated in code; server sets `dateExpiration`. INFERRED--## ⋯ item action menu (ItemActionMenu~988faf90.js, module 2173)--Modes: `grid-list-item`, `quick-look`, `compact-toolbar`, `middle-toolbar`, `regular-toolbar`. `inTrash = browse && (cwd==="TRASH_ROOT" || ancestors include it)`. Order and conditions (VERIFIED-IN-CODE, chunk L350-640; labels from main.js L16107-16123, L16200-16202):--0. Header (multi-select only, disabled): "2 Selected" / "%{count} Selected" / "… (%{size})" when no folders.-1. **Open** — not trash, mode grid-list-item, any openable (folder/app lib/known ext); enabled if 1 item, not committing.-2. **Preview** — not quick-look, any item previewable (ext or has download urls); enabled if 1.-3. **Get Info** — not quick-look; enabled if exactly 1. — divider —-4. **Download a Copy…** — not trash, grid-list-item, any file; enabled if all files. — divider —-5. **Share…** / **Manage Shared File|Folder** — not trash, not toolbar modes, any shareable (not app library / homeroom); enabled if 1 item under root.-6. **Send a Copy…** — not trash, Mail service active, not regular-toolbar, any file; enabled if all files (iWork: exactly 1). — divider —-7. **Show in Enclosing Folder** — search results only; enabled if 1.-8. **Duplicate** — not trash/search/quick-look, any file; enabled if 1 file, not read-only share, parent loaded.-9. **Rename** — not trash/search/quick-look; enabled if 1, not app lib, not read-only share.-10. **Move to Folder…** — not trash/search; enabled if all movable and none read-only shared. — divider —-11. **Delete Selected** (destructive) — not trash/search/toolbars; enabled if not read-only and (browse & not committing, or 1 id).-12. **Recover** — trash only. — divider —-13. **Delete Forever…** (destructive) — trash only.-14. **Report Content** — country `au`/`gb` and all items are public TO_ME shares. — divider before.--Action ids: `open, info, rename, download, collaborate, email, send, view, move, duplicate, delete, recover, purge, report, enclosing_folder` (main.js L4403). `Open, Send, Download, Report` run sync; others async (chunk L330). VERIFIED-IN-CODE--## Toolbars, menus, dialogs--- Sort menu "Sort by": Name, Kind, Date, Size (SortMenu chunk; main.js L16389-16397). View menu "View as": Grid, List (ViewMenu chunk; L16398-16400). List columns: Name, Kind, Size, Date, Shared, Time Left (L16383-16388). VERIFIED-IN-CODE-- Trash footer (TrashFooter~2e6c9896.js): partial selection → **Recover** + **Delete** (destructive); otherwise **Recover All** + **Delete All**; disabled while loading/empty/in-flight. VERIFIED-IN-CODE-- Purge confirm: "Are you sure you want to delete “%{name}”?" / "these %{count} files|folders|items?" + "…will be immediately deleted from iCloud Drive and all your iCloud devices." buttons Delete/Cancel (main.js L15297-15306, L12408-12432). VERIFIED-IN-CODE-- Delete-to-trash confirm only for shared items, Desktop/Documents folders, App Libraries (`Alert.Delete.*`, L15332-15393). Plain items trash without a dialog. INFERRED (no generic key exists)-- Rename: inline text field (InlineTextField/RenamingTextArea chunks); validation alerts `Alert.EmptyName.*`, `Alert.HiddenName.*` (leading dot), `Alert.InvalidName.*`, `Alert.CannotRenameItem.*` ("The name “%{name}” is already taken."). VERIFIED-IN-CODE-- Move dialog: header "Choose a new location to move this item|these items" / "Item(s) will be moved to “%{selectionName}” on %{rootName}", buttons Move/Cancel; shared-item warnings `Alert.Move.*` (main.js L16507-16513). VERIFIED-IN-CODE-- New folder default name "New Folder" (`Common.NewFolder`). VERIFIED-IN-CODE--## Storage quota ("%{size} available")--- Drive does not call the quota endpoint itself: `QuotaController.fetchStorageQuota()` RPCs the parent shell (`QuotaServiceFromChildProtocol` → `fetchStorageQuota`, replies `didFetchStorageQuota`/`failedToFetchStorageQuota`) — vendors~main~64216fa6.js L1132-1144, L43896-43915. VERIFIED-IN-CODE. Refetched after uploads/deletes (main.js L1860, L10314). VERIFIED-IN-CODE-- Shell request: `POST <account/setup host>/setup/ws/1/storageUsageInfo`, `credentials:"include"`, no body — shell `js/main.js` (minified, byte offsets) @645734 `new r.QuotaLink(Object(s.j)("account","setup/ws/1/storageUsageInfo"),…)`, @650092 `this.fetch(this.quotaServiceUrl,{method:"POST",credentials:"include"})`. VERIFIED-IN-CODE-- Response (zod, same place):-```-{ storageUsageByMedia: [{ mediaKey: "photos"|"mail"|"backup"|"messages"|"docs"|"family",- displayLabel, displayColor, usageInBytes }],- storageUsageInfo: { compStorageInBytes, usedStorageInBytes, totalStorageInBytes, commerceStorageInBytes },- quotaStatus: { overQuota, haveMaxQuotaTier, "almost-full", paidQuota }, // booleans- familyStorageUsageInfo?: { mediaKey, displayLabel, displayColor, usageInBytes,- familyMembers: [{appleId, dsid:number, id, firstName, fullName, lastName, usageInBytes}] } }-```-VERIFIED-IN-CODE. Parse failure ⇒ previous value kept silently.-- Status bar text: `max(0, total - used)` → formatter → `StatusBar.Quota` "%{size} available"; with a selection `StatusBar.Text.SelectionAndQuota` "%{selectionInfo}, %{quotaSize}" — FolderStatusMessage~d3fe4a5e.js L68-82, main.js L16351-16352. VERIFIED-IN-CODE-- Formatter (main.js module 1873, L3889-3934): **decimal** (divide by 1000 while ≥1000, up to 5 steps), rounding `Math.round(x*10^p)/10^p` with default precision bytes 0, kB 0, MB 1, GB 2, TB/PB 2; key `NumberFormatter.ItemSize` with `{number, sizeUnit}`. So 5 GB plan with 1.23e9 used → "3.77 GB available". VERIFIED-IN-CODE (the shared `bytesToHumanizedFormat` in vendors L27221 is binary/1024 and only used by upsell banners).-- Banners: `quotaStatus["almost-full"]` → "Your iCloud Storage is Almost Full" / "If you run out of storage, new files and edits won't be synced to iCloud."; `overQuota` → "Your iCloud Storage is Full" / "New files and edits won't be synced." (main.js L16498-16501). Upload 413 → "Not enough space to upload."; duplicate → `Alert.Duplicate.OutOfQuota.Title`. VERIFIED-IN-CODE--## Thumbnail fetch details--- Thumbnail URL is used **verbatim** from `download/batch` → `thumbnail_token.url` (zod `WireDocWsDownloadUrlsResponse`, main.js L20766-20777); no width/height template is substituted for normal files. VERIFIED-IN-CODE-- No `thumbnail_token` + image extension: client downloads `data_token.url` after a 500 ms debounce and downscales it client-side at 0.5 (`Object(u.a)(e, .5)`), caches `{url, etag}` per item id — main.js L4202-4221. VERIFIED-IN-CODE-- Export pane reuses `urls.thumbnail_token.url` (L8331-8339). Width/height params only exist on the iWork thumbnail service (see above). VERIFIED-IN-CODE--## Keyboard shortcuts (Mod = Cmd on macOS, Ctrl elsewhere — main.js L5170-5175)--- [ ] Enter: open the single selected item (selection mode: toggle) — main.js L18342-18355-- [ ] Backspace: move selection to trash; in Recently Deleted it opens purge confirm — L18356-- [ ] Mod+A: select all — L18357-18361-- [ ] Mod+ArrowUp: go to parent folder — L18337-18341-- [ ] Alt+Space: toggle current item in selection — L18362-18364-- [ ] Arrow keys: move focus/selection in grid/list (FolderContentsGrid~8f07ba20.js L310, List chunk L96); sidebar Up/Down (SourceList~988faf90.js L317-327)-- [ ] Space on focused ⋯ button opens the action menu (Grid chunk L460); Space closes Quick Look (main.js L11489). Space-to-open-Quick-Look: INFERRED-- [ ] Rename field: Enter commits, Escape cancels (InlineTextField~abffe217.js L73-76)-- [ ] Search box: Enter runs search (DriveSearchBox~988faf90.js L140)-- [ ] Drag files from OS onto window/subfolder = upload; drag items onto folder = move; drag onto trash = trash (main.js L18319-18330)-All VERIFIED-IN-CODE unless marked.--## UI checklist (English from main.js L15183-16580)--Sidebar-- [ ] Recents / Browse / Shared / Favorites / Recently Deleted (`FilesGrid.SourceList.Source.*`, L16192-16196); "Recently Deleted (%{totalNumberOfItems})"; favorites "Loading more favorites…", "See more favorites on your device."-- [ ] Toggle: "Show Sidebar" / "Hide Sidebar"--Folder toolbar (`FolderToolbar.Button.*`, L16204-16233)-- [ ] New Folder, Upload ("Upload More" / disabled "Uploading Not Available"), Delete, Download, Email, Move ("Move Items"), Rename, Info, More, Share File|Folder|Document|Spreadsheet|Presentation / Manage Shared …-- [ ] View toggle "Show items as icons or in a list": Grid / List; Sort menu "Sort by" Name/Kind/Date/Size-- [ ] New iWork: "Create Document|Spreadsheet|Presentation" (`Menu.New.Document.*`)-- [ ] Selection mode (touch): Select, Select All, Deselect All, Done, "Select Items"/"1 Item Selected"/"%{number} Items Selected"--⋯ / context menu — see "⋯ item action menu" above (Open, Preview, Get Info, Download a Copy…, Share…/Manage Shared, Send a Copy…, Show in Enclosing Folder, Duplicate, Rename, Move to Folder…, Delete Selected, Recover, Delete Forever…, Report Content; header "%{count} Selected (%{size})"; tooltip "Actions")--Trash toolbar/footer-- [ ] Recover / Recover All / Delete / Delete All; Time Left column; "No items"--Status bar-- [ ] "0 items" / "1 item" / "%{n} items"; "%{numberOfSelectedItems} of %{totalNumberOfItems} selected"; "Loading…"; "%{size} available"; "Path Bar"--List columns-- [ ] Name, Kind, Size, Date, Shared, Time Left--Empty / error states-- [ ] Root: "Your iCloud Drive is empty." / "You can upload files by dragging them here\nor by using an iCloud Drive enabled app."-- [ ] Folder: "This folder is empty" / "You can upload files by dragging them here."-- [ ] Trash: "No items"; Search: "No results"-- [ ] Recents: "No items" / "Files which you’ve opened recently will appear here."; error "There was a problem loading your recently opened files." / "Please try again later."-- [ ] Shared: "No items" / "Shared files will appear here."; error "There was a problem loading your shared files."-- [ ] Generic: "An unexpected error has occured." / "Please try again later."--Search-- [ ] Location filter: "Anywhere in Drive", "Shared With Me", "“%{folder}”"; tokens "Name Contains “%{text}”" → "Name: %{text}", "Kind: %{text}"--Recents grouping-- [ ] Today, Yesterday, Previous 7 Days, Previous 30 Days, then month names--Dialogs-- [ ] Purge confirm (`Alert.Purge.*` L15297-15331), Delete-to-trash for shared/Desktop/Documents/App Libraries (`Alert.Delete.*` L15332-15488)-- [ ] Move picker (`MoveItems.*` L16507-16513) + shared-move warnings (`Alert.Move.*` L15394-15599, `DragDrop.Dialog.Move.FileShared.*` "Move Anyway" L15638-15649)-- [ ] Rename validation: `Alert.EmptyName/HiddenName/InvalidName/CannotRenameItem` (L15184-15196)-- [ ] Transaction errors per op: "There was a problem creating folder “%{name}”." etc. (`Alert.TransactionError.*` L15197-15234)-- [ ] Download failures: "“%{fileName}” couldn’t be downloaded." / "This file has been deleted and is no longer available." (L15235-15246)-- [ ] Can’t open: "Can’t Open File" / "%{appName} cannot open this file. Would you like to download it to this device instead?" → Download File / Cancel (L15629-15636); iWork in shared folder "This document can’t be opened." (L15600-15601)-- [ ] Share folder containing shared items: "Are you sure you want to share this folder?" (L15307-15309)-- [ ] Duplicate out of quota: "Not enough free space to duplicate file." (L15276); row status "Waiting to duplicate…" (L16564)--Uploads (L16520-16580)-- [ ] Card "Uploads" + Close; "Uploading %{count} items to iCloud", "%{count} Items Uploaded", "%{count} of %{count2} Items Not Uploaded", "Retry %{count} Items", "Keep this page open while your files upload."-- [ ] Per item: Pending, Finalizing, Canceled, Retry, "Cancel upload"; row "Waiting to upload…", "Uploading…", "Finalizing upload…"; "%{transferredSize} of %{totalSize}"-- [ ] Errors: "Filename can’t begin with a period.", "Invalid filename.", "Duplicate filename.", "Can't upload.", "Not enough space to upload.", "Can't upload folders.", "File type not supported.", "Not a supported %{appLibraryName} file.", "File can't be larger than 10 GB."--## Gaps-- No callers found for `/retrieveTrashDetails`, `/deleteItemsInTrash`, `/retrieveSharedItemDetailsInFolders` (paths only). Trash restore/purge endpoints are `putBackItemsFromTrash` / `deleteItems` (above); no extra trash-only fields beyond `dateExpiration`, `restorePath`.-- Trash item fields other than `dateExpiration`, `restorePath` are passthrough (not in a zod schema).-- Download-folder-as-zip endpoint not found; folders aren't downloadable from the menu (Download requires all files).-- Query params added by the fetch service (`clientBuildNumber`, `dsid`, etc.) not traced.-- `storageUsageInfo` host: resolved via `urlForServiceName("account", …)` (setup.icloud.com is INFERRED, not literal in code). Whether the POST needs a body or query params beyond cookies: none seen.-- `thumbnail_token.url` contents/expiry are server-defined; no size parameter is client-controlled for non-iWork files.-- Space-to-Quick-Look binding not located precisely.--## Newer docws "unified" API (VERIFIED-IN-CODE iclouddrive main.js; seen live 2026-10-19)-The current web app reads the root through docws as well as drivews:-- `GET docws /v1/enumerate/files/{id}?limit=200&unified_format=true` and `/v1/enumerate/folders/{id}`.- `{id}` is `root` for the top level (main.js:14053, 14077). The response is `DocwsUnifiedEnumerateResponse {drive_item: DriveItem[]}`.-- `GET docws /v1/enumerate/apps`: app libraries.-- `GET docws ws/{zone}/list/lookup_by_id?document_id={id}&unified_format=true` (19875).-- Favorites: `ws/_all_/list/enumerate/favorites?limit` and `ws/_all_/list/changes/favorites` (13963, 14002).- Paginated `{continuationMarker, documents[], status: CONSISTENT|MORE_AVAILABLE}`. A body `{statusCode: 205}` means "reset and enumerate again".-- Shared: `ws/_all_/list/enumerate/sharedByMe` and `sharedToMe` (19067).-- **DriveItem (unified format)** (13676): `docwsid, drivewsid, zone, shortGUID?, isChainedToParent, dateChanged?, item_id,- parentId?, type? (FILE_UNKNOWN|FILE|FOLDER|APP_LIBRARY|ALIAS|FINDER_ALIAS|SYMLINK|LINKED_FILE|SH…), name?, etag?, extension?,- dateModified?, favorite_order?, share? (TO_ME|FROM_ME), share_info {shared_publicly}, shareID {shareName, recordName, zoneID},- size?, lastOpenTime?, urls?, assetQuota?, fileCount?, shareCount?, shareAliasCount?, directChildrenCount?`. Paginated documents add `owner {firstName,lastName,ownerRecordName}`.-- Upload in this API (13650): `{item_id?, parent_item_id, size, name, content_type}` returns `DocwsDriveItemUploadResponse {item_id, url}`, and the item is created as `{item, bounce_if_exists}`.-- Errors: `{errorMessage, serverErrorCode, requestUuid}`.--Quince uses drivews `retrieveItemDetailsInFolders` and `retrieveItemDetails`, which are still served and still used by the web app.-Worth adopting: `lastOpenTime` (Recents) and `favorite_order` (Favorites).--## beta.icloud.com Drive (2638BuildBeta31, against www 2638Build17): the v1 item API (VERIFIED-IN-CODE, 2026-10-19)-Source: `~/.cache/quince-icloud-re/beta/iclouddrive/main.pretty.js:19035–19300`.-Every call goes to the **docws** host (`urlForServiceName("docws")`). The defaults are `POST`, `Content-Type: text/plain`-(the body is still JSON) and `credentials: include`. `sharing_url_key` is passed when the item is in a shared folder.-| Action | Call |-|---|---|-| Create folder | `POST v1/item?unified_format=true` with `{item: {item_info: {type: "FOLDER", name, parent_item_id}}, bounce_if_exists: false}` |-| Create file | `POST v1/item?unified_format=true` with `{item: {item_id, item_info: {type: "FILE", name, parent_item_id, data}}, bounce_if_exists: false}` |-| Upload slot | `POST v1/item/upload` with `{item_id?, parent_item_id, size, name, content_type}`, returning `{item_id, url}` |-| Duplicate | `POST v1/item/copy/{itemId}?dsid&unified_format=true` with `{info_to_update: {}}` |-| Rename / move / anything | `PUT v1/item/{itemId}` with `{info_to_update: {…}}` |-| Many at once | `PUT v1/items` with `{item_ids: [...], drive_item_update_request: {info_to_update: {…}}}`, returning `{drive_items_with_status: [{status_code: 0 OK or 1 ERROR, status_message, drive_items: {drive_item: []}}]}`. In shared folders it is done one item at a time. |-| **Trash** | `info_to_update: {parent_item_id: "trash"}` (single or many). There is no separate trash call any more. |-| **Move** | `info_to_update: {parent_item_id: <dest>}` |-| List | `GET v1/enumerate/{files or folders}/{parentId}?limit&unified_format=true`. The host is rewritten to the account partition `pNN-`. |-| Download | `GET v1/download/{itemId}?redirect=false`, returning a URL. Batched downloads build `v1/download/...` URLs directly. |-| Apps | `GET v1/enumerate/apps` |-| Lookup | `POST ws/{zone}/list/lookup_by_id` with `[{etag, document_id}]` |-| Short link | `ws/{zone}/update/create_short_guid/...?document_id&errorBreakdown=true` |-Errors: `{summary, status, serverErrorCode, reason}`.--**For Quince:** drivews (`retrieveItemDetailsInFolders`, `moveItemsToTrash`, `createFolders`, …) is still what www uses-and still works. When this beta reaches www, Drive could move to `v1/items`. That is one call with per-item status-for trash and move, which is simpler than drivews's etag dance. Check that it works on a throwaway item before switching.diff --git a/docs/icloud-web/findmy.md b/docs/icloud-web/findmy.mddeleted file mode 100644index d0f6205..0000000--- a/docs/icloud-web/findmy.md+++ /dev/null@@ -1,27 +0,0 @@-# Find My (icloud.com `find-my-iphone`), static pass 2026-10-19-Bundle: `~/.cache/quince-icloud-re/find-my-iphone/raw/main.js` (minified, single line; quoted by string).--## Endpoints (VERIFIED-IN-CODE)-Base: `urlForServiceName("findme") + "fmipservice/client/web"`, the `findme` host from the webservices map.-All calls are `POST {base}/{action}` with a JSON body.-- Every body starts from `generateBaseRequestBody`:- `{serverContext?: <hash from the last reply>, clientContext: {appName: "iCloud Find (Web)", appVersion: "2.0", apiVersion: "3.0", deviceListVersion: 1, fmly: true, timezone: "US/Pacific" (or local), inactiveTime: ms since last use}}`.-- `initClient`: the first device list, with `serverContext` returned.-- `refreshClient`: polled; returns the full device list (`processFullResp`).-- `playSound`: `{device: <id>, subject: "<localised 'Find My … alert'>", userAction?, channels? (AirPods), userConfirmedSafetyWarning?}`.-- `lostDevice`, `lostDeviceWithFamilyAuth`: Lost Mode (message, phone number, passcode).-- `remoteWipe`, `remoteWipeWithFamilyAuth`, `remoteWipeWithUserAuth`: Erase. Reply code `"2403"` is handled specially.-- `remove`, `removeWithFamilyAuth`: remove a device from the account.-- `POST /fmipwebauthenticate` returns a short-lived token that is required **before** any destructive action (Lock, Erase).- The UI refuses with "returned empty or null token" when it is missing.-- Device model keys: `deviceClass`, `features.LST` (Lost Mode supported), `snd` (play-sound activity),- `lostDevice` (Lost Mode activity), `owner` (family device), plus location and battery fields from the device list.-- Sessions: `SessionStatusCode.SESSION_INVALID` and others mean the client signs in again.--## Feasibility for Quince-Read-only device locations, battery and Play Sound need only `initClient`/`refreshClient` plus `playSound`. They are small and low-risk.-Lock, Erase and Remove are destructive and need `fmipwebauthenticate` (a password re-prompt). Leave them out, or-gate them behind an explicit confirmation. AirTags/Items and People are not in this bundle; they are only on Apple devices.--## Needs live capture-The exact device-list reply shape (location fields, timestamps, battery), the `refreshClient` cadence, and the `fmipwebauthenticate` body.diff --git a/docs/icloud-web/mail.md b/docs/icloud-web/mail.mddeleted file mode 100644index 8e33c00..0000000--- a/docs/icloud-web/mail.md+++ /dev/null@@ -1,38 +0,0 @@-# Mail (icloud.com `mail2`), static pass 2026-10-19-Bundle: `~/.cache/quince-icloud-re/mail2/pretty/main.js` (line numbers below). Hosts were seen live:-`p{NN}-mccgateway.icloud.com` (mailws2, mailis, mpp) and `p{NN}-mcc.icloud.com` (`cc/mail/v1/account/{dsid}/…`).--## Model-IMAP underneath. Every mailws2 reply carries `sessionHeaders {folder, modseq, threadmodseq, condstore, qresync, threadmode}`-(119943), which is IMAP CONDSTORE/QRESYNC state. The web client keeps `messageModSeq` and `threadModSeq` per folder and-retries `thread/get` up to 3 times on the error `[THREADMODSEQOLD]` (120083). Mail is thread-first. Folders are IMAP paths-(`INBOX`; `/VIP` is client-only and is mapped to INBOX).-INFERRED: the folder is sent in a request header, because the helper takes it as an argument separate from the body.--## Endpoints (all POST JSON to mccgateway unless noted)-| Call | Body (VERIFIED-IN-CODE) |-|---|---|-| `mailws2/v1/thread/search` | `{responseType: "THREAD_DIGEST", includeFolderStatus: true, maxResults, before?, since?, from?, searchText?, searchType?, filters?}`, returning `{threadList[{threadId, timestamp,…}], sessionHeaders, folderStatus}` (40824, 40873) |-| `mailws2/v1/thread/list` | `{responseType: "THREAD_DIGEST", includeFolderStatus: false, threadIds}` (40935) |-| `mailws2/v1/thread/get` | `{threadId, includeLabelIds}` (120083) |-| `mailws2/v1/thread/move` | `{moveMethod: "MOVE" or "DELETE", destFolder, threadIds}` (120385) |-| `mailws2/v1/thread/flag` | `{method: "ADD" or "REMOVE", flags: ["SEEN"] or ["FLAGGED"], threadIds}` (119615) |-| `mailws2/v1/message/send` | `{date (RFC 2822, "-0000"), from, to[emails], cc?, bcc?, subject, textBody, htmlBody, isHME, webmailClientBuild, …}` (120290). From is required. |-| `mailws2/v1/message/{get, list, part, preview, download, savedraft, upload, label/set, checkomit}`, `draft/send` | message-level |-| `mailws2/v1/schedule{,/create,/delete}` | Send Later |-| `mailws2/v1/maildrop/{getMailDropToken, putMailDropRecord, moveAttachmentToMailDrop, republishAttachments}` | Mail Drop (large attachments go through iCloud Drive) |-| `mailws2/v1/{smime/verify, geqs/query, event/list, folder/unseenVip, business/logo, business/merchant_category, feature_enablement/calendar_event_extraction}` | extras |-| `mailis/v1/mail/{sync, sync/VIP, sync/RECOMMENDATIONS, recommendations…, remindmelater, quota}` | categories, Remind Me, VIP |-| `mpp/v1/auth-tokens/{keys/latest, signatures}` | Mail Privacy Protection (remote-content proxy) |-| `GET mcc /cc/mail/v1/account/{dsid}/preference/{web/all, recents, vips}`, `/unified/rule` | settings, rules |-| older `wm/{folder, message, messagepart, preference, vipsender, cloudkit}` | legacy webmail API, still referenced |--## Feasibility for Quince-- iCloud Mail is also standard IMAP/SMTP (`imap.mail.me.com:993`, `smtp.mail.me.com:587`), but that path needs an- app-specific password. The web API above works with the session Quince already has, so no extra password is needed.-- The work involved: a thread list with modseq-based incremental sync, a thread view (HTML sanitising is required), compose- and send, flag/move/delete, and search. It is about as big as Notes. Risk: HTML mail rendering in WebKitGTK must be- sandboxed (no remote content unless allowed, via the mpp proxy).--## Needs live capture-Exact response shapes of `thread/get` and `message/get`; how the folder header is named; how attachments upload; the folder list call.diff --git a/docs/icloud-web/notes.md b/docs/icloud-web/notes.mddeleted file mode 100644index d39ddc7..0000000--- a/docs/icloud-web/notes.md+++ /dev/null@@ -1,180 +0,0 @@-# iCloud web Notes (notes3) — reverse-engineered facts--Source: `notes3/main.js` (build 2638Build17), beautified copy. Line numbers refer to-the beautified file. Read-only grep; nothing executed. Tags: **VERIFIED-IN-CODE**-(seen literally) / **INFERRED** (deduced, not seen directly).--## Endpoints / transport--- Base service `ckdatabasews` → `https://ckdatabasews.<servicesDomain>` — L108543 `url: "https://ckdatabasews." + c.servicesDomain`. VERIFIED-IN-CODE-- Startup query URL `database/1/com.apple.notes/production/private/records/query` — L112867. VERIFIED-IN-CODE-- Writes go through bundled CloudKit JS: `saveRecords` → `newRecordsBatch(t).createOrUpdate(e).commit()` (L147964) → `setApiEntityName("records").setApiActionName("modify")` (L147983) = `POST …/records/modify`. VERIFIED-IN-CODE-- `zones/modify` (L148037), `subscriptions/modify` (L148078), `changes/database` (L148107, `fetchDatabaseChanges`), `changes/zone` with payload `{ zones: [...] }` (L148114, `fetchRecordZoneChanges`), `records/zip/prepare` (L148125). VERIFIED-IN-CODE-- Batch op types include `"delete"` (`_pushOperations("delete", e)` L146852) alongside createOrUpdate. VERIFIED-IN-CODE. Request JSON is standard CloudKit Web Services `{operations:[{operationType, record:{recordName, recordType, recordChangeTag, fields:{X:{value}}}}], zoneID}` — INFERRED (CloudKit JS library builds it; Notes code never hand-writes it).-- Zone: private `{zoneName:"Notes", ownerName:"currentUser"}` (`PRIVATE_ZONE_ID`, L154346-154349). Shared DB used for shared-to-me zones (`isSharedToMe` → `zoneID.database === "Shared"`, L154359). VERIFIED-IN-CODE-- Record types processed from changes: `AccountData, Note, SearchIndexes, Folder, PasswordProtectedNote, User, Users, Note_UserSpecific, PasswordProtectedNote_UserSpecific, Folder_UserSpecific, cloudkit.share, Hashtag, InlineAttachment` — L129083. VERIFIED-IN-CODE-- desiredKeys for list fetch: `TitleEncrypted, SnippetEncrypted, FirstAttachmentUTIEncrypted, FirstAttachmentThumbnail(Orientation), ModificationDate, Deleted, Folders, Folder, Attachments, ParentFolder, Note, LastViewedModificationDate, MinimumSupportedNotesVersion, IsPinned` — L166140. VERIFIED-IN-CODE--## Folder record (`recordType: "Folder"`, L153366)--- Fields (model props L153452-153471): `MinimumSupportedNotesVersion`, `Title` (dataKey `TitleEncrypted`), `ParentFolder`, `ParentModificationDate`, `TitleModificationDate`, `Deleted`, `DeletedDate`, `ImportedFromLegacy`. VERIFIED-IN-CODE-- `TitleEncrypted` encoding = `EncryptedString = [string("utf-8"), Base64]` (L138346, L153363 `FolderEncodings`) — i.e. **plain UTF-8 bytes, base64**; no real encryption client-side. VERIFIED-IN-CODE-- Built-in record names: `DefaultFolder-CloudKit` ("Notes"), `TrashFolder-CloudKit` ("Recently Deleted"), `iCloudFolder` ("All iCloud", virtual) — L128787, L154365; titles L177794-177796. VERIFIED-IN-CODE-- Trash folder auto-created if missing: on `VALIDATING_REFERENCE_ERROR` while saving a note into trash, writes `{recordType:"Folder", recordName:TRASH_FOLDER, fields:{TitleEncrypted:{value:<b64 "Recently Deleted">}}}` — L168541-168553. VERIFIED-IN-CODE-- Per-user overlay record `Folder_UserSpecific::<userRecordName>/<folderRecordName>` (L154375) — holds per-user ParentFolder/Title for shared folders (L153484, L195793). VERIFIED-IN-CODE--### Create-- `onCreateNewChildFolder`: `Folder.create({Title: "New Folder"})`; if a parent id given, `setParent({recordName, action: CloudKit.ReferenceAction.VALIDATE, zoneID})`; `t.save()` — L195756-195768. So create = records/modify createOrUpdate with `TitleEncrypted` (+ `ParentFolder` reference, action VALIDATE). Record name is a client UUID — INFERRED.-- Nested folders: yes — `getChildFolders()` filters `!Deleted && parent.recordName === this.recordName` (L153473-153477); parent = `ParentFolder` reference. VERIFIED-IN-CODE--### Rename-- `onFolderRename`: no-op if built-in, empty after trim, or unchanged; else `n.Title = r; n.save()` (for shared-root-with-user, sets Title on the UserSpecific record instead) — L195787-195797. => update `TitleEncrypted` (TitleModificationDate presumably bumped — INFERRED). VERIFIED-IN-CODE--### Delete (`Folder.deleteFolder`, L153804-153868)-1. `this.Deleted = 1`; destroy UserSpecific record. 2. Fetch all children. 3. Every note in folder → `deleteOrMoveToRecentlyDeletedAsNeeded()` (i.e. moved to TrashFolder, not flagged); child folders recurse `deleteFolder()`. 4. Finally `wantsToBeDestroyed = true; save(true)` → routed to `deleteAction` (L168500) = a real **records/modify delete** of the folder record. Conflict → reload & retry; VALIDATING_REFERENCE_ERROR → full sync & retry. Shared-with-user root → `removeMeFromShare()` instead. VERIFIED-IN-CODE-- Confirmation dialog: "Are you sure you want to delete “%{name}”?" / "All notes and any subfolders will be deleted." buttons "Delete Folder"/"Cancel"; shared variants exist (L171722-171744, L177839-177844). Built-ins can't be deleted (`isBuiltIn` check). VERIFIED-IN-CODE-- Smart folders: no `SmartFolder`/query-folder record found; only Tags (Hashtag records, "All Tags") and suggested searches. INFERRED: not supported on web.--## Note record--- Fields seen: `TitleEncrypted, SnippetEncrypted, FirstAttachmentUTIEncrypted, FirstAttachmentThumbnail(+Orientation), CreationDate, ModificationDate, Deleted, DeletedDate (L139186), Folders, Folder, Attachments, TextDataEncrypted, TextDataAsset, TextRevisionNumber, IsPinned, LastViewedModificationDate` (L129084, L139169, L168535). VERIFIED-IN-CODE-- Body: `TextDataEncrypted` = topotext protobuf, **zlib-deflated** (`Zip.encode = pako.deflate`, L130003); if > `CK_INLINE_SIZE_LIMIT`, sent as `TextDataAsset` instead, and TextDataEncrypted=null (L168535-168536). VERIFIED-IN-CODE-- Move to Recently Deleted: `moveToTrash() { moveToFolder(Folder.trashFolder) }` (L139547) — updates `Folder`/`Folders` reference to `TrashFolder-CloudKit`, sets `FoldersModificationDate` (L139545). Not a flag. VERIFIED-IN-CODE-- Permanent delete (from trash): `deletePermanently(){ this.Deleted = 1; markAttachmentsForDeletion }` (L139671-139675) then save. VERIFIED-IN-CODE-- Shared note delete: unshare, reload, moveToTrash (L139813-139826). VERIFIED-IN-CODE-- Dialog: "Deleted notes are moved to the Recently Deleted folder." / "Notes are available for 30 days…" (L177745-177746). VERIFIED-IN-CODE--## Text format (topotext proto2, L126312)-- `String{string=2, substring=3, timestamp=4, attributeRun=5, attachment=6}`; `AttributeRun{length=1, paragraphStyle=2, font=3, fontHints=5, underline=6, strikethrough=7, superscript=8, link=9, color=10, writingDirection=11, attachmentInfo=12, timestamp=13, emphasis=14}`. VERIFIED-IN-CODE-- `ParagraphStyle{style=1, alignment=2, writingDirection=3, indent=4, todo=5, paragraphHints=6, startingListItemNumber=7, blockQuoteLevel=8, uuid=9}`; checklist = `Todo{todoUUID=1, done=2}`. VERIFIED-IN-CODE-- `ParagraphStyle.style` enum = `TTParagraphStyle{TITLE=0, HEADING=1, BODY=3, FIXED=4, BULLET=100, DASH=101, NUMBER=102, TODO=103}` — L181474. Editor registry adds Subheading=2: `new Map([[0,Title],[1,Heading],[2,Subheading],[3,Body],[4,FixedWidth],[100,BulletedList],[101,DashedList],[102,NumberedList],[103,TodoList]])` — L186509-186519. VERIFIED-IN-CODE. (Note: 100 is **bulleted "•"**, 101 dashed, not dotted/dashed.) Unknown/absent `style` → Body (default style, L187848-187852).-- `fontHints` bitmask `TTFontHints{BOLD=1, ITALIC=2}` — L181513. Bold/italic are fontHints, not separate fields; underline/strikethrough = `underline`/`strikethrough` ints (1 = single, L181711, L189131-189132). HTML paste: weight>400→BOLD, italic→ITALIC, text-decoration→underline 1 / strikethrough 1, `<a>`→`link` — L181700-181714. VERIFIED-IN-CODE-- `indent`: Tab/Shift-Tab (`formatIndent`/`formatOutdent`) → `indent = max(0, indent±1)`, 0 written as null — L186905-186915. VERIFIED-IN-CODE. `blockQuoteLevel`, `emphasis`, `superscript`, `color` are decoded/round-tripped (L115703, L115725) but no web UI writes them found — INFERRED read-only.--### Checklist (style 103)-- Item = `ParagraphStyle{style:103, todo:{todoUUID, done}}`. New item: `TTToDoAttribute.create({toDoUUID: UuidModule.random(), done})` — L187021-187025. VERIFIED-IN-CODE-- `toggleChecklist` (L186856-186874): for each paragraph in selection, if not all already todo → `setStyle(id(TodoList)=103).setToDo(w(false))`; else → `setStyle(3 Body).setToDo(null)`. VERIFIED-IN-CODE-- Tick box: `toggleChecklistItemForFrameModelIsDone` reads `toDo.done || false` and calls `setChecklistItemForFrameModelIsDone(!done)` → `toDo.setDone(t)`, keeping the UUID — L186876-186893. VERIFIED-IN-CODE-- Leaving checklist via style change strips todo (L186850); new line after a done item resets `done:false` (L186717); duplicate/missing todoUUIDs (e.g. paste) get fresh random UUIDs, todo dropped if no style — L180944-180949. VERIFIED-IN-CODE-- Markdown autoformat at line start: `"[ ] "`/`"[x] "` → checklist, `"- "` → dashed, `"* "` → bulleted, numbered via `1.`-style prefix — L186690-186706. VERIFIED-IN-CODE (numbered trigger regex not read — INFERRED).--## Table attachment (`com.apple.notes.table`)-- `TABLE_UTI = "com.apple.notes.table"` (L129881). It is an **Attachment record** (not InlineAttachment) with `UTI`/`UTIUnencrypted`/`UTIEncrypted` = that UTI. New table: `Title: loc("Table.Title")` ("Table"), `MinimumSupportedNotesVersion: 2`, 2 rows x 2 cols — L137920-137935. VERIFIED-IN-CODE-- Placement in note: one `U+FFFC` char on its own line with `attributeRun.attachmentInfo{attachmentIdentifier: <attachment recordName>, typeUTI:"com.apple.notes.table"}` — L187155. VERIFIED-IN-CODE-- **Read** (L129905-129911): bytes = `MergeableDataEncrypted` (base64) ?? `encryptedValues.mergeableData` (E2E/ADP path) ?? `MergeableDataAsset.downloadedData`; then `inflateMergeableData` (zlib/gzip inflate with size limit, L130002) → `ICTableVersionedDocument.initWithData`. VERIFIED-IN-CODE-- **Write** (L167491-167498): `icTableManager.find(id).saveToArchive()` → `pako.deflate` → base64 → `MergeableDataEncrypted`; if > `CK_INLINE_SIZE_LIMIT` → `MergeableDataAsset` Blob and MergeableDataEncrypted=null. With encryption info, goes into `EncryptedValues` + `CryptoTag` + `CryptoInitializationVector` and both Mergeable fields null (L167525). `TableRevisionNumber` is client-only (deleted before save). VERIFIED-IN-CODE-- Layering: `versioned_document.Document{serializationVersion=1, repeated Version version=2}`, `Version{serializationVersion=1, minimumSupportedVersion=2, bytes data=3}` (L124694) — table serializationVersion 0 (L127115). `data` = `CRDT.Document` (crframework.proto, L124696): `{version=1 VectorTimestamp, startVersion=2, repeated DocObject object=3, repeated string keyItem=4, repeated string typeItem=5, repeated bytes uuidItem=6, ttTimestamp=7}`; `DocObject` oneof `{registerLatest=1, registerGreatest=2, registerLeast=3, set=4, orderedSet=5, dictionary=6, timestamp=7, vectorTimestamp=8, index=9, string(topotext)=10, weakReference=11, oneof=12, custom=13, stringArray=14, array=15, tsOrderedSet=16}`; `CustomObject{type=1 (→typeItem idx), repeated MapEntry{key=1 (→keyItem idx), ObjectID value=2}=3}`; `ObjectID` oneof `{integerValue=1, unsignedIntegerValue=2, doubleValue=3, stringValue=4, bytesValue=5, objectIndex=6}`; `OrderedSet{Array array=1, Dictionary set=2}`; `Array{StringArray array=1, Dictionary dictionary=2}`; `Dictionary.Element{key=1, value=2, timestamp=3, index=4}`. VERIFIED-IN-CODE-- Root object = custom type `"com.apple.notes.ICTable"` (L123079) with keys `identity` (UUID), `crTableColumnDirection`, `crRows`, `crColumns`, `cellColumns` — encode L121595, decode L123097-123101. `crRows`/`crColumns` = ordered sets of row/column UUIDs; `cellColumns` = dictionary columnUUID → dictionary rowUUID → cell (L121848-121861 `cellColumns.get(col).set(row, v)`). Cell = `CRMergeableAttributedString` (topotext string) — L123091; missing cells filled with empty strings on decode (L123102-123109). VERIFIED-IN-CODE. `crTableColumnDirection` = a register (LTR/RTL) — INFERRED.-- Edits via `ICTable.insertRow/insertColumn/set(col,row,str)`, merges via `mergeWithDocument` (CRMergeResult Updated/NoChange/Fail, L127135). VERIFIED-IN-CODE--## Menus / UI strings-- Folder ⋯ menu: "Rename Folder", "Share Folder", "Manage Shared Folder", "Delete Folder"; "New Folder" default title (L177797-177811). VERIFIED-IN-CODE-- Note list context menu: "Delete", "Pin Note"/"Unpin Note"; "Pinned" section (L177812-177815). VERIFIED-IN-CODE-- Aa menu ("Choose a style to apply to text"), order from L195020: Title(0), Heading(1), Subheading(2), Body(3), Monospaced(4, key `FixedWidth`), Bulleted List • (100), Dashed List - (101), Numbered List 1. (102). Checklist (103) is NOT in Aa — separate toolbar button "Make a checklist". Labels L177646-177656. VERIFIED-IN-CODE--## UI checklist (loc keys, L177560-177900; English)-Toolbar-- [ ] `Toolbar.Button.NewNote` "Create a note" · `.Checklist` "Make a checklist" · `.Style` "Choose a style to apply to text" · `.Table` "Insert a table" · `.Delete` "Delete this note" · `.Recover`/`.RecoverTitle` "Recover this note"/"Recover" · `.Lock` "Close all locked notes" · `.Share` "Add people to this note" · `.SharedWithYou`/`.SharedByYou` "View participants…"-- [ ] `Toolbar.Button.Bold/Italic/Underline/Strikethrough`; status `Toolbar.Status.Saving` "Saving…", `.Edited`, `.Saved`, `.MovingOneNote/MultipleNotes` "Moving %{count} note(s)…"-- [ ] Touch callout: `TouchSelectionCallout.Select`, `.SelectAll`, `.BIU`, `.Bold/.Italic/.Underline/.Strikethrough`-Table context menu-- [ ] `Table.AddColumn`, `.AddColumnBefore`, `.AddColumnAfter`, `.DeleteColumn`, `.AddRow`, `.AddRowAbove`, `.AddRowBelow`, `.DeleteRow`; `Note.ContentInfo.Table(s)` "%{count} table(s)"-Folder panel / note list-- [ ] `Folders.ContextMenu.Rename/Share/ManageShared.Title`; `FolderPanel.DeleteSelectedFolder.Title` "Delete Folder"; `FolderPanel.FolderSettings.ToolTip` "Edit or delete folders"; `FolderPanel.Tags.Label` "Tags", `.TagCloud.AllTags.Label` "All Tags"-- [ ] `NotesList.ContextMenu.Delete` / `.Pin` "Pin Note" / `.Unpin`; sections `NotesList.Section.Pinned` / `.Notes`-- [ ] Search: `Note.SearchBox.Placeholder` "Search all notes", `Note.SuggestedSearch.*` (Shared, Locked, Checklists, Tags, Drawings, Scanned Documents, Attachments)-Link dialog-- [ ] `LinkModification.AddLink.Title` "Add Link"/`.EditLink.Title`; "Link To:" placeholder "Enter a URL or Note Title"; "Name:" "Optional"; "Use note title as link name"; "Remove Link"/"Cancel"/"Done"-Empty states-- [ ] `Note.Empty.Title` "New Note", `Note.Empty.Snippet` "No additional text", `Note.Empty.List` "No Notes", `Note.RecentlyDeleted.List` "Notes are available here for 30 days…", `Note.Loading` "Loading…"-Dialogs-- [ ] `Alert.DeleteNote.*`, `Alert.DeleteSharedNote.Title` + `DeleteSharedWithYouNote/SharedByYouNote.Body`, `Alert.RecentlyDeletedNoteEditing.*` "Recently deleted notes can’t be edited.", `Alert.DeleteFolder.*` (+Shared Owner/Participant), `Alert.MoveFolder.*` "Notes is limited to 5 levels of folders.", `Alert.OpenNote.NotAvailable.*`, `Alert.SharedNoteWasDeleted.*`, `Alert.FolderShare.*` (locked/shared-to-me/move variants, "Move Anyway"), `Alert.Open{Pages,Numbers,Keynote}File.*`, `Alert.PasswordProtected*`, `Alert.WebGL.*`-- [ ] Locked notes: `Notes.PasswordProtected.*` ("This note is locked.", "Enter Password", "Password incorrect.", "Hint: %{passwordHint}", "Can’t View Note")-Keyboard-- [ ] Format shortcuts come from browser `beforeinput` inputTypes `formatBold/Italic/Underline/StrikeThrough/Indent/Outdent` (L92508-92515), i.e. platform Cmd/Ctrl+B/I/U, Tab/Shift-Tab. VERIFIED-IN-CODE. No explicit custom keymap table found — INFERRED none.-- [ ] Line-start autoformat: `[ ] `, `[x] `, `- `, `* `, numbered (L186690-186706).--## Gaps-- Resolved: style enum, table CRDT schema, checklist write path.-- Open: exact CRTable column-direction values; numbered-list autoformat regex; whether `inflateMergeableData` accepts gzip as well as zlib (only "inflate" seen); E2E `EncryptedValues` inner layout; Folder record-name generation; whether DeletedDate is written on folder delete (field exists, write not found).--## Tables: empty cells (VERIFIED on his account, 2026-10-19)-Every table in the account, whether made on an iPhone or on icloud.com, holds a kind-10 text-object for **every** cell, including ones never typed in. The object has empty text (`2: bytes 0B`)-and only the two sentinel substrings. `cellColumns` maps column → `CRDictionary` (kind 6) of elements-`{1: row object ref {6: idx}, 2: value object ref, 3: timestamp {1: {1: replica idx, 2: clock}}}`.-So an empty cell is edited exactly like a typed one (`table::with_cell`). An in-memory run over-all 10 tables took text in an empty cell and read back exactly (probe `table_cell_offline`).-Web code: `setObject_columnID_rowID` (main.js:121856) makes a column's CRDictionary only when-one is missing. Quince has not needed that path yet.--## Tables: adding/removing rows and columns (VERIFIED-IN-CODE, notes3 main.js, 2026-10-19)-- `insertRow(index)` (121764): `uuid = CRUUID.UUID()`; `rows.insert(uuid, index)` puts the uuid into the **tsOrderedSet**- `crRows` (DocObject kind 16: a topotext-style array of elements carrying char IDs, replica and clock, plus a dictionary- uuid→NSUUID object). No cell objects are made; `undoablyInsertContents_atRow(null, uuid)` only records undo.- Columns are the same through `crColumns` (`insertColumn`, 121767).-- A cell gets its kind-10 text object and its `cellColumns[col][row]` dictionary element only when it is first written- (`setObject_columnID_rowID`, 121856). That creates the column's CRDictionary if it is missing.-- `removeRowAtIndex` (121776): every column's dictionary drops the row key (`a.delete(row)`), an emptied column dictionary- is removed, then `rows.delete(index)`. Columns mirror this (121799).-- UI actions (156592+): addRowAbove/Below, addColumnBefore/After, deleteRow(s), deleteColumn(s), deleteTable.- Strings: "Add Row", "Add Row Above", "Add Row Below", … (177833).-- **For Quince** this needs two writers it does not have yet:- (1) an ordered-set insert or delete (a topotext array edit plus a dictionary entry, with Quince's own replica UUID added- to `uuidItem` and a clock above every clock seen), and- (2) creating a cell object for a never-written cell.- Both must be byte-proven against Apple's own encoder (round-trip a phone-made table) and tried live on a throwaway- table before touching his.-- Measured on his 11×2 table (attachment f7e8966f…, read-only, 2026-10-19). `crRows` (kind 16) =- `OrderedSet{1: Array{1: StringArray{1: topotext.String{2: ""×11, 3: substrings (charID{replica, clock}, length,- timestamp, tombstone?, child*), 5: one attribute run per character}, 2: ArrayAttachment{1: attachmentIndex 0…10,- 2: uuid bytes}*}, 2: Dictionary uuid→NSUUID}, 2: set Dictionary}`.- A row insert is therefore: one "" inserted through the topotext CRDT (the same writer notes use), a new- ArrayAttachment (the next attachmentIndex, a fresh uuid), an NSUUID custom object and its dictionary entries, and the- document version vector raised. Still open: how `attachmentIndex` relates to character position after deletes- (tombstones). Settle it with a table on which a row was deleted on the phone.-- **Settled (2026-10-19, read-only, all 10 of his tables):** `ArrayAttachment.attachmentIndex` is the row's or column's- **live position**. Deleted rows stay in the topotext as tombstoned substrings and do not count. Table 33c73e38 has rows- substrings [(1,0,len2), (1,12,len1), (1,25,len1,TOMB)], 3 live chars, attIdx 0–2. Table f7e8966f has two tombstoned- rows, 11 live, attIdx 0–10. So an insert at k = a topotext insert at live position k (`rewrite_text_object`, the cell- writer, already does this for a String), every attachmentIndex ≥ k incremented, `{k, uuid}` added, and the uuid's- NSUUID object plus its dictionary entries added. Decoder used: scratchpad tools/ordered.py.-- **Wiring (table 33c73e38, read-only):** each row or column has two NSUUID custom objects (`UUIDIndex` → uuidItem):- an *element* (E) and an *identity* (I). In the ordered set, `Array.dictionary` holds E→I and `OrderedSet.set` holds- E→E. Each element carries a timestamp VectorTimestamp `[(replicaIndex, clock)]`. A deleted row keeps its E→I in- `Array.dictionary` but leaves `set`. `cellColumns` is column-I → column dictionary, and a column dictionary is- row-I → kind-10 cell String. Document `version` (field 1) is `[(replicaIndex into uuidItem, clock)]`; here- `[(0,6), (1,2), …, (8,4)]`, 21 uuidItems.-- **Build recipe for "add row at k":**- 1. Append Quince's replica uuid to `uuidItem` if absent. clock = (its clock in `version`, or 0) + 1.- 2. Append two uuidItems (E, I), two NSUUID objects pointing at them, the elements E→I in `Array.dictionary` and E→E in- `set`, each stamped `[(quince, clock)]`.- 3. Insert "" at live position k in the StringArray's topotext String (`rewrite_text_object`). Shift attachmentIndex- ≥ k by one and add `{k, E's uuid bytes}`.- 4. Raise Quince's entry in `version` to the clock.- 5. Optionally, per column, add row-I → a new empty kind-10 String (copy a phone-made empty cell's exact shape), so- the new cells can be typed in at once.- Prove it by applying the recipe to a copy of a phone-made table, then checking that Quince's own reader gets the- grid with the row at k. Then run it live on a throwaway table and read the table back from Apple (and on the phone).-- **Built (2026-10-19):** `table::with_row` / `with_column` (one `with_member`) follow the recipe above. Each is proven- before returning: the NSUUID object, dictionary elements and version vector are rebuilt from the table's own and- compared byte for byte, other replicas' subclocks are copied untouched, and the result must read back as the same- grid plus one empty line. Offline it took all 9 of his tables, at the top, middle and end, both axes (54/54), and- the new cells took text. Live on the throwaway table 7fcc79fb (used only by deleted Quince test notes): rows at the- top and end, a column in the middle, and text typed in each, all read back from Apple. Still unverified: the iPhone- rendering it.-- **Delete recipe (read off table 33c73e38, whose 4th row was deleted on the phone):** the row's "" is tombstoned- in the topotext; its ArrayAttachment is gone and the later indices are shifted down; E→E is removed from- `OrderedSet.set`; the row-I keys are removed from every column dictionary (obj18 and obj22 have no key 10). Only- E→I stays in `Array.dictionary`, and nothing else marks the delete. Web code agrees: `removeRowAtIndex` deletes from- each column dictionary, drops an emptied column dictionary from `cellColumns`, then `rows.delete(index)` (121776).- Column delete mirrors it: the column-I element goes from `cellColumns`. Build it on the same proven writer- (`with_member`) as a removal, and confirm on the throwaway first.-- **Correction (2026-10-19): a table's texts share one writer list.** In a table document the topotext writer list- (`replicaUUID` + clocks) is kept once at Document field 7 (`ttTimestamp`). No cell or ordered-set String carries- field 4. A CharID's replica number counts from that document-level list. Quince's text writer used to add a list of- its own to the edited text, so its characters claimed writer 1, the phone's number. That affected cell edits (shipped- earlier) and, briefly, row inserts (1a10fbf). Fixed with `table::edit_table_text`: the document's list is lent to the- text, Quince joins it as the next writer, and the list is written back to field 7. A text that already carries its- own list is refused. Damage: only the orphan table f7e8966f (one cell, "a") and the throwaway 7fcc79fb, neither in a- live note.diff --git a/docs/icloud-web/photos.md b/docs/icloud-web/photos.mddeleted file mode 100644index 5481fd3..0000000--- a/docs/icloud-web/photos.md+++ /dev/null@@ -1,296 +0,0 @@-# iCloud.com Photos web app: reverse-engineered notes--Source: beautified `photos3/` bundle (`main.js`, `ui.main.js` and about 95 route chunks).-Path: `scratchpad/icloud-bundles/pretty/photos3/`. Citations use `file:line`.-Read-only static analysis. Bundles were never executed.-Tags: **VERIFIED-IN-CODE** means the code shows it directly. **INFERRED** means it is a reasonable reading that I have not proven.--## 1. Container, database, zones, host--- **VERIFIED-IN-CODE**: the container is `com.apple.photos.cloud`, environment `production`. `main.js:12156` `const u = "com.apple.photos.cloud"`, `main.js:12158` `environment: "production"`. A second container, `com.apple.icloud-photos.fdb` (FoundationDB-backed), is built for the same dsid (`main.js:12264`). Shared links use `https://ckshare.icloud.com/ws/v1/<cid>/<env>/` (`main.js:12276`).-- **VERIFIED-IN-CODE**: the host is the `ckdatabasews` service URL (`main.js:12257` `this.urlForServiceName("ckdatabasews")`). The raw URL builder is at `main.js:10286`:- ```js- `${host}/database/1/com.apple.photos.cloud/production/${scope||"private"}/${op}?remapEnums=true&getCurrentSyncToken=true&dsid=${dsid}&clientBuildNumber=…&clientMasteringNumber=…[&sharing_url_key=…]`- ```- Requests are `POST` with `content-type: text/plain` and `credentials: "include"` (`main.js:10288-10294`).-- **VERIFIED-IN-CODE**: the endpoints used by the container client (`main.js:11763-11800`) are `/records/lookup`, `/records/query`, `/internal/records/query/batch?parallel=true`, `/records/modify`, `/records/copy/start|status`, `/records/zip/prepare`, `/zones/list` (GET), `/zones/modify`, `/changes/database`, `/changes/zone` and `/assets/upload`. Bootstrap calls `zones/list` with `&excludeSCZones=true` (`main.js:10310`).-- **VERIFIED-IN-CODE**: the main library zone is `{zoneName:"PrimarySync", zoneType: RegularCustomZone}` (`main.js:10413`) in the **private** database. The zone-state record is `records/lookup {records:[{recordName:"PrimarySync-0000-ZS"}]}` (`main.js:10317-10324`).-- **VERIFIED-IN-CODE**: zone name families are classified by prefix at `main.js:10193`: `CMM-*` (shared iCloud links / moments), `PrimarySync*`, `SharedSync*` (iCloud Shared Library), `Exit-SharedSync*` and `Unknown`. The zone store tracks the primary zone, the shared zone and CMM zones (`main.js:35845-35855`). Error enum: `NoPrimarySyncZone`, `InvalidPrimarySyncZone`, `DisabledPrimarySyncZone` (`main.js:36103`).-- **INFERRED**: the database for the SharedSync zone is per-zone (`zoneStore.getDatabaseScopeForZoneID`, `ui.main.js:20727`). It is probably `shared` for participants and `private` for the owner. I did not prove this.--## 2. Record types and fields--Record types listed in `main.js:6871`: `CPLAlbum`, `CPLMaster`, `CPLAsset`, `CPLLibraryInfo`, `CPLContainerRelation`, `IndexCountResult`, `CheckIndexingState`, `CPLZoneState`, `CMMRoot`, `Share`. Elsewhere: `CPLMemory`, `CPLMemoryAssetList`, `CPLPost`, `CPLTextComment` and `CPLReact`.--**CPLAsset** (zod at `main.js:14971-15024`, VERIFIED-IN-CODE). This is the per-photo "edit/state" record.-- `masterRef` (reference to CPLMaster), `isFavorite`, `isHidden`, `isDeleted`, `isExpunged`, `isSparsePrivateRecord`, `rating` (all numbers 0/1)-- `assetDate`, `assetDateEnc`, `addedDate`, `dateExpunged`, `timeZoneOffset(Enc)`, `timeZoneNameEnc`-- `duration(Enc)`, `orientation`, `adjustmentType`, `adjustmentRenderType`, `adjustedMediaMetaDataEnc`-- `captionEnc`, `extendedDescEnc`, `keywordsEnc`, `locationEnc`, `locationV2Enc`-- `assetSubtype(V2)`, `assetHDRType`, `burstFlags(Ext)`, `burstId`, `vidCompl*`, `videoFrameRate`-- `linkedShareRecordName/ZoneName`, `contributors[]`, `remappedRef`, `proxyState`-- It also carries the derivative groups `res{JPEGThumb,JPEGMed,JPEGLarge,JPEGFull,Original,VidSmall,VidMed,VidHDRMed,VidFull,...}` (the edited renders). See §4.-- Plugin fields (`main.js:15037-15044`): `dynamic_resJPEGThumbResScaledTemplate`, `dynamic_resJPEGFullResScaledTemplate`, `dynamic_resOriginalResScaledTemplate`, `dynamic_resVidComplResScaledTemplate`, `dynamic_HLSPlaylistURL`, `likedByCaller`, `likeCount`.-- `*Enc` fields have `_decoded` variants (`main.js:15050-15058`), which shows the server returns them encrypted or base64. INFERRED: they are plain bplist/base64, as in the other apps.--**CPLMaster** (`main.js:15270-15320`, VERIFIED-IN-CODE). This is the original file.-- `itemType(Enc)` (UTI, e.g. `public.jpeg`), `filenameEnc`, `originalOrientation`, `dataClassType`, `importedBy`, `importedByDisplayNameEnc`, `importedByBundleIdentifierEnc`, `originalCreationDate(Enc)`, `mediaMetaDataType/Enc`, `codec(Enc)` (`ProRes|HEVC|H264`), plus all the `res*` groups including `resOriginalRes`, `resOriginalVidComplRes` (Live Photo video), `resOriginalAltRes` and `resProvRes`.--**CPLAlbum** (`main.js:14923-14941`, VERIFIED-IN-CODE): `albumNameEnc`, `albumType`, `position`, `sortType`, `sortAscending`, `parentId` (folder), `isDeleted`, `userModificationDate`. The root folder id is `"----Root-Folder----"` (`main.js:14922`).--**CPLContainerRelation** (`main.js:15339-15344`, VERIFIED-IN-CODE): `itemId` (asset recordName), `position`, `containerId` (album recordName). The record name is `` `${itemId}-IN-${containerId}` `` (`ui.main.js:7953-7962`).--**Resource object** (`main.js:15241-15247`, VERIFIED-IN-CODE): `{fileChecksum, size, wrappingKey?, referenceChecksum, downloadURL}`. The upload variant omits `downloadURL` and adds `receipt` (`main.js:15248-15256`, `{singleFile:{...}}`).--## 3. Queries (Library, Favorites, Recents, Albums, Hidden, Recently Deleted)--The generic index query builder is at `main.js:15837-15883` (VERIFIED-IN-CODE):-```js-{ query: { recordType: <index>,- filterBy: [- {fieldName:"direction", comparator:"EQUALS", fieldValue:{value:"ASCENDING"|"DESCENDING", type:"STRING"}},- // smart album only:- {fieldName:"smartAlbum", comparator:"EQUALS", fieldValue:{value:"FAVORITE", type:"STRING"}},- // rating only: {fieldName:"rating", ..., type:"INT64"}- {fieldName:"startRank", comparator:"EQUALS", fieldValue:{value:<rank>, type:"INT64"}} ] },- zoneID: {zoneName:"PrimarySync"}, resultsLimit: n, desiredKeys: [...]? }-```-- **VERIFIED-IN-CODE**: the rank is `direction === Ascending ? i : listLength - 1 - i` (`main.js:15892-15894`). A negative startRank is rejected client-side (`main.js:15812`).-- **VERIFIED-IN-CODE**: the response mixes `CPLMaster` and `CPLAsset` records, which are split by recordType (`main.js:15833-15836`). Each asset is joined to its master through `masterRef`.-- **VERIFIED-IN-CODE**: the smallest example, used for bootstrap thumbnails (`main.js:10349-10363`), is `{query:{recordType:"CPLAssetAndMasterByAssetDateWithoutHiddenOrDeleted", filterBy:[{fieldName:"direction",comparator:"EQUALS",fieldValue:{value:"DESCENDING",type:"STRING"}}]}, zoneID:{zoneName:"PrimarySync"}, resultsLimit:18}`.-- **VERIFIED-IN-CODE**: counts come from `records/query {recordType:"HyperionIndexCountLookup", filterBy:[{fieldName:"indexCountID", comparator:"IN", fieldValue:{value:["CPLAssetByAssetDateWithoutHiddenOrDeleted"], type:"STRING_LIST"}}]}` (`main.js:10329-10340`). The query-index to count-index mapping is at `main.js:7060-7102`.--| View | recordType / filter | Count index | Cite |-|---|---|---|---|-| Library (date captured) | `CPLAssetAndMasterByAssetDateWithoutHiddenOrDeleted` | `CPLAssetByAssetDateWithoutHiddenOrDeleted` | `main.js:12537`, `main.js:7062` |-| Library (date added sort) / Recents | `CPLAssetAndMasterByAddedDate` or `...ByAddedDateWithoutHiddenOrDeleted` | `CPLAssetByAddedDate[WithoutHiddenOrDeleted]` | `main.js:23935`, `main.js:7056-7058` |-| Favorites | `CPLAssetAndMasterInSmartAlbumByAssetDate` + `smartAlbum="FAVORITE"` | ~~`CPLAssetInSmartAlbumByAssetDate:FAVORITE`~~ — **checked live 2026-10-20: this id answers 0; walk the smart album instead** | `main.js:12401`, `main.js:7149` |-| Media types | same with `smartAlbum` = `LIVE, VIDEO, PANORAMA, DEPTH, EXPOSURE, TIMELAPSE, SLOMO, SCREENSHOT, ANIMATED`; `BURSTS` uses `CPLBurstStackAssetAndMasterByAssetDate`. **Membership checked live on his library: SCREENSHOT = assetSubtypeV2 3, PANORAMA = assetSubtypeV2 1** (probe/examples/photos_smart_albums.rs) | | `main.js:7149`, `main.js:15849` |-| Rated | `CPLAssetAndMasterWithRatingByAssetDate` + `rating` INT64 | | `main.js:15857` |-| Hidden | `CPLAssetAndMasterHiddenByAssetDate` | `CPLAssetHiddenByAssetDate` | `main.js:12405` |-| Recently Deleted | `CPLAssetAndMasterDeletedByExpungedDate` | `CPLAssetDeletedByExpungedDate` | `main.js:12421` |-| Album contents | `CPLContainerRelationLiveByAssetDate` (or `...LiveByPosition` for manual sort, `CPLContainerRelationByAddedDateNotHiddenOrDeletedEndpoint` for date-added) + filters `startRank`, `direction`, `parentId=<album recordName>` | `CPLContainerRelationNotDeletedByAssetDate` | `main.js:7053`, `main.js:33162-33190` |-| Album list | `CPLAlbumByPositionLive` (or `CPLAlbumByUserModificationDate` when date sort is on), optional `parentId` filter, paged with `continuationMarker` | `CPLAlbumNotDeleted` | `main.js:23974`, `ui.main.js:53840-53870` |--- **VERIFIED-IN-CODE**: an album-contents response returns CPLMaster, CPLAsset and CPLContainerRelation records (`main.js:33193-33201`).-- **INFERRED**: `desiredKeys` is passed through when the caller supplies it (`main.js:15880`). I found no fixed literal list for the grid, so it most likely defaults to all keys.--## 4. Derivative / download URLs--- **VERIFIED-IN-CODE**: each derivative group is `res<Kind>{Height,Width,Fingerprint,FileType,Res}` (`main.js:15127-15226`). Kinds: `JPEGThumb, JPEGMed, JPEGLarge, JPEGFull, Original, VidSmall, VidMed, VidHDRMed, VidFull, OriginalVidCompl, OriginalAlt, Prov`.-- **VERIFIED-IN-CODE**: the URL is `fields.res<Kind>Res.downloadURL`, with `${f}` replaced by `encodeURIComponent(filename)`, which defaults to `"unknown.jpeg"` (`main.js:16211-16222`). Example: `r.split("${f}").join(encodeURIComponent(e))`.-- **VERIFIED-IN-CODE**: scaled templates come from `pluginFields.dynamic_res{JPEGThumb,JPEGFull,Original}ResScaledTemplate`, with `${f}` set to the filename and `${m}` set to the max pixel dimension (`main.js:40385-40389` `.split("${f}")...split("${m}").join(`${t}`)`).-- **VERIFIED-IN-CODE**: the thumbnail is usable if `resJPEGThumbRes.downloadURL || resJPEGMedRes.downloadURL` (`main.js:33028`). The original is `resOriginalRes.downloadURL` plus `.size` (`main.js:40315-40327`). A QuickTime master is downloaded as m4v (HEVC) or mp4 (`main.js:16203`).-- **VERIFIED-IN-CODE**: an expired URL is refreshed by matching `fileChecksum` (`main.js:32979-32986`, kinds `resJPEGThumb, resJPEGMed, resVidSmall, resVidMed`).--## 5. Writes (`records/modify`)--The update builder is at `ui.main.js:20071-20126` (VERIFIED-IN-CODE):-```js-{ atomic: true, zoneID, operations: [{ operationType: "update",- record: { recordName, recordChangeTag, recordType: "CPLAsset", fields: { isFavorite: {value: 1} } } }] }-```-Each field is wrapped as `{value}`. Special types: `assetDateEnc` → `{type:"TIMESTAMP", isEncrypted:true}`; `emojiStringEnc` → `{type:"STRING", isEncrypted:true}`. `parentId`, `cloudkit.thumbnailImageData` and `keyAssetIdentifier` are sent even when they are undefined, which clears them.--| Action | Fields | Cite |-|---|---|---|-| Favorite / unfavorite | CPLAsset `isFavorite: 1/0` (toggles to 1 if any selected asset is not a favorite) | `ui.main.js:20733-20738` |-| Hide / unhide | CPLAsset `isHidden: 1/0` | `ui.main.js:40969-40973` |-| Delete (to Recently Deleted) | CPLAsset `isDeleted: 1` | `ui.main.js:22739-22741` |-| Recover | CPLAsset `isDeleted: 0` | `ui.main.js:23058-23060` |-| Delete permanently | CPLAsset `isExpunged: 1` | `ui.main.js:51640-51642` |-| Delete album/folder | CPLAlbum `isDeleted: 1` | `ui.main.js:25914-25916` |-| Move between Personal and Shared Library | `isSparsePrivateRecord: 1` in PrimarySync, or `isDeleted: 1` in the source | `ui.main.js:41084-41088` |-| New album/folder | `create` CPLAlbum `{albumNameEnc, albumType, isDeleted:0, isExpunged:0, position, sortAscending:1, sortType:CreationDate, parentId?}` | `ui.main.js:54795-54808` |-| Add to album | read the last position with `CPLContainerRelationLiveByPosition` (`startRank=MAX_SAFE_INTEGER, endRank=0, parentId, direction=DESCENDING`, `resultsLimit:3`), then `create` CPLContainerRelation `{itemId, position, containerId}` named `itemId-IN-albumId` | `ui.main.js:49970-50070`, create builder `ui.main.js:19885-19901` |-| Force delete | `operationType:"forceDelete", record:{recordName}` | `ui.main.js:22869-22884` |--- **VERIFIED-IN-CODE** (2026-10-19), **Remove from album**: `removeCPLAssetsFromAlbum` (`ui.main.js:54398-54417`) sends- `forceDelete` for `` `${asset}-IN-${album}` `` through the builder at `ui.main.js:22869-22884`- (`{atomic:true, zoneID, operations:[{operationType:"forceDelete", record:{recordName}}]}`). It does **not** set- `isDeleted`, and the photo stays in the library. Confirm dialog: "Remove %{count} items from album?".-- **VERIFIED-IN-CODE, album title**: `encodeFieldValue(title)` = `btoa(unescape(encodeURIComponent(title)))`, i.e.- base64 of the UTF-8 bytes, sent as a plain `{value}` with no type (`main.js:36424-36433`).-- **VERIFIED-IN-CODE, New album** (`ui.main.js:54770-54840`): the create builder (`ui.main.js:19908-19921`) sends- `{recordType:"CPLAlbum", fields:{k:{value}}}` with **no recordName**, so CloudKit names it. Fields:- `albumNameEnc`, `albumType` (0 Normal, Folder for folders), `isDeleted:0`, `isExpunged:0`, `sortAscending:1`,- `sortType:1` (CreationDate; the enum is at `main.js:7136`: 0 Manual, 1 CreationDate, 2 LastModifiedDate, 3 ImportDate, 4 TrashDate,- 5 Title, 100 Custom), and `parentId` only inside a folder. `position` = max(first existing album position − 2, 0),- or `MAX_POSITION_VALUE` = `MAX_SAFE_INTEGER − 1024` when there are none (`ui.main.js:7562`, `7585-7597`). A new album therefore- sorts **first**.-- **VERIFIED-IN-CODE, Rename album** (`ui.main.js:27722-27760`): `update` CPLAlbum `{albumNameEnc, userModificationDate: Date.now()}`- with its `recordChangeTag`.-- **VERIFIED-IN-CODE, Add to album positions** (`ui.main.js:49955-50070`): the last position is read DESCENDING from- MAX_SAFE_INTEGER (`resultsLimit:3`), or 1024 when the album is empty. Each new item gets `min(prev + 1024, MAX_SAFE_INTEGER − 1024)`,- so items append at the end, 1024 apart.--## 6. Upload flow--There are two paths. The bundle picks one with a ramp flag (`z.a` at `ui.main.js:40430`; there is also an `isRamped` endpoint).--**V2 (`photosupload` service).** VERIFIED-IN-CODE.-- The base URL is `urlForServiceName("photosupload")` + `"photosupload/" + endpoint + "?dsid=<dsid>"`. Shared-collection uploads use `?callerCKUserId=&ownerCKUserId=` instead. Each request is `POST`, `Content-Type: text/plain;charset=UTF-8`, with a JSON body and up to 3 retries (`ui.main.js:6102-6140`). Endpoints: `createUploadUrl`, `putAsset`, `uploadStatus`, `isRamped` (`ui.main.js:6174-6179`).-1. `createUploadUrl` `{zoneName, assets:{<uuid>: <file size>}}` → `{uploadUrls:{<uuid>: url}}` (`ui.main.js:40017-40061`).-2. XHR upload of the bytes to that URL (`xhrRequestURL`, `ui.main.js:40409`). **INFERRED**: the response is the `{singleFile:{fileChecksum,size,wrappingKey,referenceChecksum,receipt}}` shape (`main.js:15248`).-3. `putAsset` `{zoneName, localTimeZoneId, importGroup?, assetBatchId?, files:[{fileName, lastModDate, timeZoneOffset, singleFileUploadRequest:<step 2 result>}]}` → `[{uploadJobId, cplMaster, cplAsset}]` or `{response:{status, errorMessage?, isRetryable?}}` (`ui.main.js:40083-40170`).-4. Poll `uploadStatus` `{uploadJobIds:[...]}` → `{<jobId>: {progress} | {errorCode}}`, where done means progress ≥ 100 (`ui.main.js:40172-40260`). Then the client fetches the record and, when the upload targets an album, runs the add-to-album step.--**V1 (`uploadimagews`).** VERIFIED-IN-CODE (`ui.main.js:50930-50981`).-- The URL is `${uploadimagews}upload?filename=<enc name>&dsid=<dsid>&lastModDate=<ms>&timezoneOffset=<min>&clientBuildNumber=…`. The response is `{isDuplicate, records:[{recordName,recordType}], remappedRef?, requestUUID}`.-- **INFERRED**: the host is `p*-uploadimagews.icloud.com`, taken from the webservices map rather than the bundle.--**Limits** (`ui.main.js:6250-6280`, VERIFIED-IN-CODE):-- V1: JPEG only, 100 MB.-- V2: JPEG, PNG, HEIF, HEIC, MOV, MP4, TIFF, GIF, M4V and WebP, up to 500 MB.-- Width up to 20480 px; area up to 419430400 px²; file names up to 255 characters.-- One upload at a time; 1000 files per batch.--## 7. UI checklist (loc key → English; the table is at `ui.main.js:55015-57245`)--Quince status (2026-10-20, later): built and proven — keys (F . H L = - I Z Cmd+.), slideshow,-sort menu, whole-photo grid toggle, Media Types (Videos, Panoramas, Screenshots by Apple's own-subtype rule), Rated, Hidden, Recently Deleted (days left, Delete All), Albums page and sidebar-branches, Add/Remove to album (menu, drag), upload panel, Download Options, Title/Caption,-Rating, Keywords, Adjust Date, place (read-only coordinates), search, filmstrip, zoom.-Writes proven live on throwaways: favorite, hide, delete/recover/expunge, album create/rename/-delete/add/remove, title+caption, rating, keywords, date, upload (incl. a 152 MB video,-byte-identical). Audit (probe photos_audit): every view's count matches Apple's.-Still open: location write (needs a geocoder — asked him), album folders, Live Photos playback-(none in his library), Memories, Shared Albums, iCloud Links, locked Hidden/Recently Deleted,-in-app video playback (needs GStreamer plugins — asked him).--Sidebar-- [ ] `SidebarNode.Library.Title` Library, `.Memories` Memories, `.Recents` Recents, `.Favorites` Favorites, `.Hidden` Hidden, `.RecentlyDeleted` Recently Deleted, `.MediaTypes` Media Types, `.Rated` Rated, `.MyAlbums` Albums, `.SharedAlbums` Shared Albums, `.ICloudLinks` iCloud Links-- [ ] `Sidebar.AddButton.Label` "Add an album or folder" → popover New Album / New Folder; `Sidebar.Folder.Loading` "Loading…", `Sidebar.Error.LoadFailed` "Failed to load"; Hide/Show sidebar-- [ ] Library switcher: `Library.Personal` Personal Library / `Library.Shared` Shared Library / `Library.Both` Both Libraries--Toolbar (`Toolbar.*`)-- [x] Upload, New album or folder ("Create a new album or folder"), Share, Download, Delete, Remove, Toggle favorite / Add to Favorites / Remove from Favorites, Info ("Get info about this photo"), More…, Sort-- [x] Select / Select All / Deselect All / Cancel / Edit / Done; Recover, Delete, Delete All (Recently Deleted)-- [ ] Zoom slider (Zoom in/out, "Fit", `%{value}%`), square vs full aspect thumbnails, "View months" (jump to date), Start slideshow, thumbnail strip show/hide, full screen enter/exit--Action / context menu (`ActionMenu.*`, pluralised `.1/.2/.Multiple`)-- [x] Favorite / Unfavorite, Hide / Unhide, Delete, Remove (from album), Recover, Delete (expunge), Download, More Download Options…, Add to Album…, Add to Shared Album…, Share…, Copy Image, Info, Edit Location, Edit Keywords, Show in Library, Start Slideshow-- [x] Album menus: New Album, New Folder, Rename Album/Folder, Delete Album/Folder, Make Album Cover, Reset Album Cover-- [ ] Move to Shared Library / Move to My Personal Library-- [ ] Sort menu: Sort By (Date Captured / Date Added), Direction (Newest First / Oldest First) (`Grid.Sort.*`)--Keyboard shortcuts (grid, `ui.main.js:27206-27291`; skipped while Cmd/Ctrl is held)-- [ ] `=` / `-` change thumbnail size-- [x] Space / Enter open the item-- [ ] `F` or `.` toggle favorite-- [x] Backspace / Delete delete or expunge-- [ ] `H` or `L` hide or unhide-- [ ] `I` info-- [ ] `Z` zoom to fit / full-- [x] One-up view (`oneup.js:6615-6635`, `oneup.js:7311-7320`): Left/Right navigate (mirrored in RTL); Escape or Cmd/Ctrl+`.` closes-- [ ] Slideshow: Left/Right/Space (`memory~slideshow.js:1417-1435`)--Dialogs (`Alert.*`)-- [x] Delete: "Delete %{count} items from all your devices?" / "These items will be deleted from iCloud Photos on all your devices." [Delete]-- [x] Expunge: "Are you sure you want to delete these %{count} items permanently?" / "This action cannot be undone." [Delete]-- [x] Hide: "Hide %{count} items?" / "These items can be found in the hidden album." [Hide]-- [x] Remove from album: "Remove %{count} items from album?" / "…will remain in your photo library." [Remove]-- [x] Delete album: "Are you sure you want to delete this album?" (+ the "items will still be visible" text); Delete folder: "…This will also delete all albums inside this folder…"-- [ ] Failures: "Unable to Delete/Hide/Remove/Recover Item(s)" + "…due to a server error."; Recover over quota: "…because your iCloud storage is full."; "Unable to create album. Try again later."-- [ ] Recently Deleted header note (`Grid.View.Header.Recently.Deleted.Note`): "Photos and videos show the days remaining before deletion…"--Empty states-- [ ] `Grid.EmptyPage` "No Photos or Videos"; `.PersonalLibrary` "Personal Library is Empty"; `.SharedLibrary` "Shared Library is Empty" (+ "Show Personal Library"); `.Folder` "No Albums or Folders"; `.AddButton` "Add Photos"-- [ ] `NoLibrary.Title` "Turn on iCloud Photos" + description-- [ ] `AlbumInSharedLibrary.Title` "Albums are not yet supported in Shared Library view on iCloud.com"-- [ ] Locked (Hidden / Recently Deleted): "Enter Your Password to View This Album" [View Album]--Uploader (`Uploader.*`)-- [ ] Titles: "Uploading %{count} Items to iCloud", "Finalizing Uploads", "%{count} Items Uploaded", "%{count} of %{count2} Items Not Uploaded"; "Keep this page open while your files upload."-- [ ] Buttons: Stop Upload, Retry / Retry All, Show/Hide Details, Add iCloud Storage-- [ ] Menu: Add to Album…, Show in Recents, Show in Library-- [x] Errors: "This item’s file type isn’t supported.", "Item is too large to upload.", "Duplicate item.", "Not enough space to upload item.", "File name too long."--## Gaps-- Upload host names (`photosupload`, `uploadimagews`) and `ckdatabasews` come from the webservices map at login, not from this bundle.-- I did not trace the step-2 V2 XHR (method, headers, body format) end to end. The `singleFile` receipt shape is INFERRED.-- Album writes: **proven live 2026-10-19** (`probe/examples/photos_albums_roundtrip.rs`, throwaway album- CAB752C8-…, now deleted). Unnamed create → CloudKit returns an uppercase UUID recordName; add → relations- read back as `{containerId, itemId, position:NUMBER_INT64}`; remove (forceDelete) → relation gone, asset untouched;- rename with a UTF-8 title round-trips; delete → `isDeleted:1`. Deleting an album **leaves its relation records**- in place (as icloud.com's own delete does), so a mirror must drop an album's items itself.-- `desiredKeys` lists, default `resultsLimit` per grid page and the thumbnail size thresholds (`f`/`p` at `main.js:40385`) are not extracted.-- Whether SharedSync uses the `shared` database for participants is not proven.-- Modifier shortcuts (e.g. Cmd+A select all) are handled outside the grid keydown handler. I only found the search-box Cmd+A (`infopanel~photossearchbox.js:164`), so this list may be incomplete.-- Memories, shared albums (`sharedstreams`) and iCloud Links (CMM) are not documented beyond their zone names.-- beta.icloud.com Photos (2638BuildBeta15, its own numbering) vs www 2638Build29: the core main.js uses the same CloudKit record types and queries (60 identifiers, none only in beta). The www-only names (CPLReact*, text comments, Hyperion) live in lazy chunks not fetched for beta. No sign that beta Photos is ahead. Checked 2026-10-19.--## Verified live (2026-10-19, read-only, his library)-- Paging: rank 0 is the **newest** asset. `direction=ASCENDING` from `startRank=k` walks toward older ones; DESCENDING walks- back toward the newest. `resultsLimit` counts assets and masters together. A query needs the `remapEnums=true` URL- parameter, or Apple answers "BadRequestException: Unexpected input".-- The change feed (`changes/zone` on PrimarySync) mirrors the library: 273 records (135 CPLAsset, 135 CPLMaster,- 2 CPLAlbum, 1 CPLLibraryInfo) in 8 s, with every master's derivative `downloadURL` included. From the token with no- changes it takes 0.4 s. Quince's Photos sync is built on this (quince_icloud::photos).-- Views from the mirror match Apple: Library 134 (Apple's count says 134), Favorites 3, Videos 1, Screenshots 43, Recently- Deleted 1. `${f}` in a downloadURL is replaced by the file name to ask for.-- Album contents: `CPLContainerRelationLiveByAssetDate` with filters startRank, direction and `parentId=<album>` (plus- remapEnums) is accepted. Both of his albums ("wallappaers", "test") are empty by Apple's own count- (`HyperionIndexCountLookup` on `CPLContainerRelationNotDeletedByAssetDate:<album id>` = 0). Contents are untested on a- non-empty album, so Quince lists no albums yet.-- **Writes (VERIFIED-IN-CODE, photos3 ui.main.js, 2026-10-19):** every flag change is one `records/modify`- `{atomic: true, zoneID, operations: [{operationType: "update", record: {recordName, recordType: "CPLAsset",- recordChangeTag, fields: {<field>: {value}}}}]}` (builder at 20086–20095). Favorite: `toggleCPLAssetsFavorite`- (≈20733) sets `isFavorite` to 1 when the one asset (or any of several) is not a favorite, else 0. Delete to- Recently Deleted sets `isDeleted: 1`; Recover sets `isDeleted: 0`. **Delete Now** in Recently Deleted is a- separate operation, `forceDelete` with `{recordName}` (22879), which is permanent. Quince does not offer it- until asked. Album create is `create` (19896). Quince's `photos::set_flag` sends the same update through- `ZoneClient::update_record`.-- **Upload (VERIFIED-IN-CODE, photos3 ui.main.js, 2026-10-19):** `POST ${urlForServiceName("uploadimagews")}upload- ?filename=<encodeURIComponent(name)>&dsid=<dsid>&lastModDate=<ms>&timezoneOffset=<min>&clientBuildNumber=<build>`- with the file's bytes as the body (XHR, credentials included; 50940–50956). The reply is- `{isDuplicate: bool, records: [{recordName, recordType}], remappedRef?, requestUUID}` (50922). Limits (6246–6272):- - **iCPL (v1):** JPEG only, 125 B to 100 MB, 1 to 20480 px a side, area ≤ 419,430,400 px, file name ≤ 255 characters.- - **v2** (behind a feature flag): JPEG, PNG, HEIF, HEIC, QuickTime and others, plus WebP.- - Shared albums: up to 500 MB, adding TIFF, GIF and M4V.- - Pace: `maxConcurrentUploads: 1`, `batchFileLimit: 1000`.- - Not yet traced: the v2 request itself, and which of his files v1 would refuse.-- **Upload, VERIFIED LIVE (2026-10-19, probe photos_upload_v2, a 16 KB test JPEG, then sent to Recently Deleted):**- the old `uploadimagews …/upload` answers **410 Gone**. icloud.com now uses the `photosupload` service- (ui.main.js 6100–6180, 40020–40260, 63937–64042). Every call is `POST {photosupload}/photosupload/<endpoint>?dsid=<dsid>`- with a JSON body and `Content-Type: text/plain;charset=UTF-8`. Up to 3 attempts; throttling backs off 0.5 s → 10 s.- 1. `createUploadUrl` `{zoneName: "PrimarySync", assets: {<uuid>: <bytes>}}` → `{uploadUrls: {<uuid>: <url>}}`.- 2. `POST <url>` with the raw bytes and `Content-Type: text/plain` → `{singleFile: {fileChecksum, receipt,- referenceChecksum, size, wrappingKey}, isDuplicate?}`. isDuplicate means the photo is already in the library.- 3. `putAsset` `{zoneName, localTimeZoneId: <IANA>, importGroup: <batch uuid>, files: [{fileName, lastModDate (ms),- timeZoneOffset (min), singleFileUploadRequest: <singleFile>}]}` → `[{uploadJobId: "<master>#PrimarySync:<asset>",- cplMaster, cplAsset, response: {status: 200, isRetryable}}]`, or `[{response: {status, errorMessage, isRetryable}}]`.- A shared collection uses `assetBatchId` in place of `importGroup`.- 4. `uploadStatus` `{uploadJobIds: [...]}` → `{<jobId>: {progress: 0–100}}` or `{<jobId>: {errorCode}}`. Measured: 95,- then 100 after ~5 s. Then the CPLAsset is in the zone.- Errors: an over-quota response text contains QUOTA_EXCEEDED. Status codes include BadRequest 400, Forbidden 403 and- AlbumNotFound 404.--## Shared Albums (sharedstreams) — mapped and proven live 2026-10-20-Not CloudKit: the `sharedstreams` webservice. Every call `POST {sharedstreams}/{dsid}/sharedstreams/{endpoint}`-(icloud.com's `useDSIDBaseURL`), `Content-Type: text/plain;charset=UTF-8`, JSON body, cookies; the usual-query params. Per album there is also an `albumlocation` base (`https://pNN-sharedstreams.icloud.com:443/<token>/sharedstreams/`).-Endpoints (main.js:20440): webgetalbumslist, webgetpendingalbums, webgetalbumview, webstream, webasseturls,-getcomments, getchanges, albumsummary, createalbum, deletealbum, updatealbum, unsubscribe, subscribe,-deletecomment, setalbumpublic, addcomment, share, unshare, webgetassets, deleteassets, webgetassetcount,-webputasset, webgetuploadurl, webuploadstatus, reportspam, webgetsharinginfos, webgetkeyasset, publicurl.-An optional `clientOrgKey` is spread into a body when known (main.js:23805).-- createalbum `{albumguid: <UUID upper>, attributes: {name, ispublic?: "1", allowcontributions?: "1"}}` → `{albumguid, albumctag}`.-- webgetalbumslist `{}` → `{albums:[{albumguid, albumctag, albumlocation, attributes:{name, ispublic, allowcontributions,- creationDate}, iswebuploadsupported, ownerdsid, sharingtype:"owned"|…}], callerId, rootctag}`.-- webgetalbumview `{albumguids:[…]}` → albums with `sharinginfo:[{email, firstname, fullname, invitationguid, …}]`.-- webgetassets `{albumguid, offset:"0", limit:"N", albumctag?}` → `{records:[…]}` (CPLMaster/CPLAsset-shaped).-- deletealbum `{albumguid, clientOrgKey?}` → `"OK"`.-Proven: probe/examples/shared_album_roundtrip.rs (throwaway made, listed, viewed, assets read, deleted, gone).-His account has no shared albums and no pending invitations (probe/examples/shared_albums_list.rs).--## What icloud.com beta (photos3 2638BuildBeta15) actually calls — checked 2026-10-20-- Shared Albums: the endpoint table lists putAsset/getUploadURL/getUploadStatus/deleteAssets/addComment, but- nothing in main.js calls them. The web app only *reads* a shared album (webgetassets, webgetassetcount,- webgetsharinginfos, webgetkeyasset, webgetpendingalbums). Adding photos to a shared album is unmapped;- his account has 0 shared albums, so reading contents can't be proven on real data either.-- Memories: CPLMemory records, listed by CPLMemoryNotIsRejectedByCreateDate. His count (HyperionIndexCountLookup)- is 0, favourites 0 (probe/examples/photos_memories_count.rs).-- iCloud Links (CMM zones): icloud.com only resolves/accepts links others send (resolveCMM, addAcceptedCMM);- it never creates one.diff --git a/docs/icloud-web/proto/CRDT.proto b/docs/icloud-web/proto/CRDT.protodeleted file mode 100644index 2239e25..0000000--- a/docs/icloud-web/proto/CRDT.proto+++ /dev/null@@ -1,125 +0,0 @@--syntax = "proto2";--package CRDT;--option optimize_for = LITE_RUNTIME;--message ObjectID {- oneof contents {- sint64 integerValue = 1;- uint64 unsignedIntegerValue = 2;- double doubleValue = 3;- string stringValue = 4;- bytes bytesValue = 5;- // Store objects as an index into ‘objects'- uint32 objectIndex = 6;- }-}--message Timestamp {- optional uint64 replicaIndex = 1;- optional int64 counter = 2;-}--message RegisterLatest {- optional Timestamp timestamp = 1;- optional ObjectID contents = 2;-}--message VectorTimestamp {- message Element {- optional uint64 replicaIndex = 1;- optional uint64 clock = 2;- optional uint64 subclock = 3;- }- repeated Element element = 1;-}--message Dictionary {- message Element {- optional ObjectID key = 1;- optional ObjectID value = 2;- optional VectorTimestamp timestamp = 3;- optional RegisterLatest index = 4;- }- repeated Element element = 1;-}--message Index {- message Element {- optional uint64 replicaIndex = 1;- optional int64 integer = 2;- }- repeated Element element = 1;-}--message OneOf {- message Element {- optional ObjectID value = 1;- optional Timestamp timestamp = 2;- }- repeated Element element = 1;-}--message StringArray {- optional topotext.String contents = 1;- repeated ArrayAttachment attachments = 2;- message ArrayAttachment {- optional uint64 attachmentIndex = 1;- optional bytes contents = 2;- }-}--message Array {- optional StringArray array = 1;- optional Dictionary dictionary = 2;-}--message OrderedSet {- optional Array array = 1;- optional Dictionary set = 2;-}--message Document {- // A list of all objects in the graph.- message CustomObject {- // object type as an identifier index- optional int32 type = 1;- // key as identifier index -> ObjectID- message MapEntry {- required int32 key = 1;- required ObjectID value = 2;- }- repeated MapEntry mapEntry = 3;- }- message DocObject {- oneof contents {- RegisterLatest registerLatest = 1;- RegisterLatest registerGreatest = 2;- RegisterLatest registerLeast = 3;- Dictionary set = 4;- Dictionary orderedSet = 5;- Dictionary dictionary = 6;- Timestamp timestamp = 7;- VectorTimestamp vectorTimestamp = 8;- Index index = 9;- topotext.String string = 10;- uint64 weakReference = 11;- OneOf oneof = 12;- CustomObject custom = 13;- StringArray stringArray = 14;- Array array = 15;- OrderedSet tsOrderedSet = 16;- // Note: tags 1-15 take less space- }- }-- optional VectorTimestamp version = 1;- optional VectorTimestamp startVersion = 2;- repeated DocObject object = 3;- repeated string keyItem = 4;- repeated string typeItem = 5;- repeated bytes uuidItem = 6;- optional topotext.VectorTimestamp ttTimestamp = 7;-}diff --git a/docs/icloud-web/proto/README.md b/docs/icloud-web/proto/README.mddeleted file mode 100644index d614a48..0000000--- a/docs/icloud-web/proto/README.md+++ /dev/null@@ -1,13 +0,0 @@-# Apple's own protobuf schemas (from the notes3 web bundle, 2026-10-19)-These are copied verbatim from the strings the icloud.com Notes app passes to `loadProto`-(main.js:124694–124696, 126307–126312 and 152642–152644). They are Apple's real field names-and numbers, not guesses.--| File | What it describes |-|---|---|-| `CRDT.proto` | The CRDT object graph: `Document` (version, objects, keyItem, typeItem, uuidItem, ttTimestamp), `DocObject` kinds (6 dictionary, 10 topotext string, 13 custom, 16 tsOrderedSet…), `Dictionary.Element {key, value, timestamp, index}`, `ObjectID` (field 6 = objectIndex), `Timestamp {replicaIndex, counter}`, `VectorTimestamp`. Tables use this. |-| `versioned_document.proto` | The wrapper `Document {serializationVersion, version*}` and `Version {minimumSupportedVersion, data}`. |-| `topotext-*.proto` | Note text: `String`, `Substring`, `CharID`, `AttributeRun` (1 length, 2 paragraphStyle, 3 font, 5 fontHints, 6 underline, 7 strikethrough, 8 superscript, 9 link, 10 color RGBA, 11 writingDirection, 12 attachmentInfo, 13 timestamp, **14 emphasis**, 15 systemAttachmentInfo), `ParagraphStyle` (1 style, 2 alignment, 3 writingDirection, 4 indent, 5 todo, 6 paragraphHints, 7 startingListItemNumber, 8 blockQuoteLevel, 9 uuid), `Todo`, `Color`, `Media`, `AttachmentInfo`. Where more than one variant is kept, it is the Reminders variant, which differs slightly. |--Quince (crates/quince-icloud/src/ckdocument.rs, table.rs) does not yet read these fields:-`color` (10), `superscript` (8), `alignment`, `blockQuoteLevel`, `startingListItemNumber`.diff --git a/docs/icloud-web/proto/topotext-1.proto b/docs/icloud-web/proto/topotext-1.protodeleted file mode 100644index f78a4a3..0000000--- a/docs/icloud-web/proto/topotext-1.proto+++ /dev/null@@ -1,265 +0,0 @@--syntax = "proto2";--package topotext;--option optimize_for = LITE_RUNTIME;--message String {- optional string string = 2;-- // Only needed for mergeable strings.- repeated Substring substring = 3;- optional VectorTimestamp timestamp = 4;-- repeated AttributeRun attributeRun = 5;-- // Optional attachment data.- repeated Attachment attachment = 6;-}--message VectorTimestamp {- message Clock {- optional bytes replicaUUID = 1;- message ReplicaClock {- optional uint32 clock = 1;- optional uint32 subclock = 2;- }- repeated ReplicaClock replicaClock = 2;- }- repeated Clock clock = 1;-}--message CharID {- optional uint32 replicaID = 1;- optional uint32 clock = 2;-}--message Substring {- optional CharID charID = 1;- // Length of substring in UTF-16 characters (surrogate pairs are separate characters).- optional uint32 length = 2;-- // Style timestamp.- optional CharID timestamp = 3;-- optional bool tombstone = 4;-- // Index into String.substring.- repeated uint32 child = 5;-}--message Selection {- message Range {- optional CharID fromChar = 1;- optional CharID toChar = 2;- };- repeated bytes replicaUUID = 1;- repeated Range range = 2;-- enum Affinity {- Backward = 0;- Forward = 1;- }- optional Affinity affinity = 3;-}--message AttributeRun {- // Length of run in UTF-16 characters (surrogate pairs are separate characters).- optional uint32 length = 1;-- optional ParagraphStyle paragraphStyle = 2;-- // Overrides bold, italic and paragraph styles.- optional Font font = 3;-- // Modifiers applied on-top of paragraph style.- // Bold, italic...- optional uint32 fontHints = 5;-- // Integer values for future compatibility.- // Only set as 1 or 0 currently.- optional uint32 underline = 6;- optional uint32 strikethrough = 7;-- optional int32 superscript = 8;- optional string link = 9;- optional Color color = 10;-- enum WritingDirection {- NaturalDirection = 0;- LeftToRight = 1;- RightToLeft = 2;- LeftToRightOverride = 3;- RightToLeftOverride = 4;- }-- optional WritingDirection writingDirection = 11;-- optional AttachmentInfo attachmentInfo = 12;-- optional uint64 timestamp = 13;-- // Reminders hashtags- optional HashtagInfo hashtagInfo = 14;-}--message Font {- optional string name = 1;- optional float pointSize = 2;-- // Hints for when named font does not exist on device.- optional uint32 fontHints = 3;-}--message ParagraphStyle {- enum Alignment {- Left = 0;- Center = 1;- Right = 2;- Justified = 3;- Natural = 4;- }-- optional uint32 style = 1;- optional Alignment alignment = 2;- optional AttributeRun.WritingDirection writingDirection = 3;- optional int32 indent = 4;- optional Todo todo = 5;-- // Hints for when paragraph style does not exist in this version.- optional uint32 paragraphHints = 6;-- // Only used for the initial item of a numbered list.- optional uint32 startingListItemNumber = 7;-- // The current block quote level of the paragraph. The default value is 0.- optional uint32 blockQuoteLevel = 8;-}--message HashtagInfo {- optional string objectIdentifier = 1;-}--message AttachmentInfo {- optional string attachmentIdentifier = 1;- optional string typeUTI = 2;-}--message Attachment {- optional string identifier = 2;- optional bytes mergeableData = 3;- optional float sizeHeight = 4;- optional float sizeWidth = 5;- optional string summary = 6;- optional string title = 7;- optional string typeUTI = 8;- optional string urlString = 9;-- optional Location location = 10;- optional Media media = 11;- repeated PreviewImage preview = 12;-- optional float originX = 13;- optional float originY = 14;- optional int32 orientation = 15;-- optional double previewUpdateDate = 16;- optional double modificationDate = 17;- optional string remoteFileURL = 18;- optional bool checkedForLocation = 19;- optional int64 fileSize = 20;- optional double duration = 21;-- optional int32 imageFilterType = 22;- optional bytes markupModelData = 23;- repeated Attachment subAttachment = 24;-- optional int64 minimumSupportedNotesVersion = 25;-- optional double croppingQuadBottomLeftX = 26;- optional double croppingQuadBottomLeftY = 27;- optional double croppingQuadBottomRightX = 28;- optional double croppingQuadBottomRightY = 29;- optional double croppingQuadTopLeftX = 30;- optional double croppingQuadTopLeftY = 31;- optional double croppingQuadTopRightX = 32;- optional double croppingQuadTopRightY = 33;-- optional bytes metadataData = 34;-- optional string userTitle = 35;-- optional bytes fallbackImageData = 36;-- optional bytes linkPresentationArchivedMetadata = 37;-- repeated Attachment inlineAttachment = 38;-- optional bytes systemPaperBundle = 39;-- optional bytes synapseData = 40;-- optional bytes fallbackPDFData = 41;-- optional bytes mergeablePreferredViewSize = 42;--}--message Location {- optional double latitude = 1;- optional double longitude = 2;-- optional bytes placemark = 3;-- optional bool placeUpdated = 4;-}--message Media {- optional string identifier = 1;- optional string filenameExtension = 2;- optional bytes data = 3;- optional string filename = 4;-- optional int64 minimumSupportedNotesVersion = 5;-}--message PreviewImage {- optional float scale = 1;- optional bool scaleWhenDrawing = 2;- optional bytes data = 3;- optional bytes metadata = 4;- optional int32 version = 5;- optional bool versionOutOfDate = 6;-- optional int64 minimumSupportedNotesVersion = 7;- optional int32 appearanceType = 8;-}--message Todo {- optional bytes todoUUID = 1;- optional bool done = 2;-}--message Color {- optional float red = 1;- optional float green = 2;- optional float blue = 3;- optional float alpha = 4;-}--message BoxedValue {- oneof contents {- sint64 integerValue = 1;- uint64 unsignedIntegerValue = 2;- double doubleValue = 3;- string stringValue = 4;- bytes bytesValue = 5;- bytes uuidValue = 6;- }-}--message WallClockMergeableValue {- optional double timestamp = 1;- optional BoxedValue contents = 2;-}diff --git a/docs/icloud-web/proto/topotext-2.proto b/docs/icloud-web/proto/topotext-2.protodeleted file mode 100644index 80adab9..0000000--- a/docs/icloud-web/proto/topotext-2.proto+++ /dev/null@@ -1,273 +0,0 @@--syntax = "proto2";--package topotext;--option optimize_for = LITE_RUNTIME;--message String {- optional string string = 2;-- // Only needed for mergeable strings.- repeated Substring substring = 3;- optional VectorTimestamp timestamp = 4;-- repeated AttributeRun attributeRun = 5;-- // Optional attachment data.- repeated Attachment attachment = 6;-}--message VectorTimestamp {- message Clock {- optional bytes replicaUUID = 1;- message ReplicaClock {- optional uint32 clock = 1;- optional uint32 subclock = 2;- }- repeated ReplicaClock replicaClock = 2;- }- repeated Clock clock = 1;-}--message CharID {- optional uint32 replicaID = 1;- optional uint32 clock = 2;-}--message Substring {- optional CharID charID = 1;- // Length of substring in UTF-16 characters (surrogate pairs are separate characters).- optional uint32 length = 2;-- // Style timestamp.- optional CharID timestamp = 3;-- optional bool tombstone = 4;-- // Index into String.substring.- repeated uint32 child = 5;-}--message Selection {- message Range {- optional CharID fromChar = 1;- optional CharID toChar = 2;- };- repeated bytes replicaUUID = 1;- repeated Range range = 2;-- enum Affinity {- Backward = 0;- Forward = 1;- }- optional Affinity affinity = 3;-}--message AttributeRun {- // Length of run in UTF-16 characters (surrogate pairs are separate characters).- optional uint32 length = 1;-- optional ParagraphStyle paragraphStyle = 2;-- // Overrides bold, italic and paragraph styles.- optional Font font = 3;-- // Modifiers applied on-top of paragraph style.- // Bold, italic...- optional uint32 fontHints = 5;-- // Integer values for future compatibility.- // Only set as 1 or 0 currently.- optional uint32 underline = 6;- optional uint32 strikethrough = 7;-- optional int32 superscript = 8;- optional string link = 9;- optional Color color = 10;-- enum WritingDirection {- NaturalDirection = 0;- LeftToRight = 1;- RightToLeft = 2;- LeftToRightOverride = 3;- RightToLeftOverride = 4;- }-- optional WritingDirection writingDirection = 11;-- optional AttachmentInfo attachmentInfo = 12;-- optional uint64 timestamp = 13;-- optional uint32 emphasis = 14;-- optional AttachmentInfo systemAttachmentInfo = 15;-}--message Font {- optional string name = 1;- optional float pointSize = 2;-- // Hints for when named font does not exist on device.- optional uint32 fontHints = 3;-}--message ParagraphStyle {- enum Alignment {- Left = 0;- Center = 1;- Right = 2;- Justified = 3;- Natural = 4;- }-- optional uint32 style = 1;- optional Alignment alignment = 2;- optional AttributeRun.WritingDirection writingDirection = 3;- optional int32 indent = 4;- optional Todo todo = 5;-- // Hints for when paragraph style does not exist in this version.- optional uint32 paragraphHints = 6;-- // Only used for the initial item of a numbered list.- optional uint32 startingListItemNumber = 7;-- // The current block quote level of the paragraph. The default value is 0.- optional uint32 blockQuoteLevel = 8;-- // A unique uuid- optional bytes uuid = 9;-}--message AttachmentInfo {- optional string attachmentIdentifier = 1;- optional string typeUTI = 2;-- // For system attachments, the name of the optimal class representation of this data.- optional string systemAttachmentClassName = 3;-- // For system attachments, the full attachment data.- optional bytes systemAttachmentData = 4;-}--message Attachment {- optional string identifier = 2;- optional bytes mergeableData = 3;- optional float sizeHeight = 4;- optional float sizeWidth = 5;- optional string summary = 6;- optional string title = 7;- optional string typeUTI = 8;- optional string urlString = 9;-- optional Location location = 10;- optional Media media = 11;- repeated PreviewImage preview = 12;-- optional float originX = 13;- optional float originY = 14;- optional int32 orientation = 15;-- optional double previewUpdateDate = 16;- optional double creationDate = 43;- optional double modificationDate = 17;- optional string remoteFileURL = 18;- optional bool checkedForLocation = 19;- optional int64 fileSize = 20;- optional double duration = 21;-- optional int32 imageFilterType = 22;- optional bytes markupModelData = 23;- repeated Attachment subAttachment = 24;-- optional int64 minimumSupportedNotesVersion = 25;-- optional double croppingQuadBottomLeftX = 26;- optional double croppingQuadBottomLeftY = 27;- optional double croppingQuadBottomRightX = 28;- optional double croppingQuadBottomRightY = 29;- optional double croppingQuadTopLeftX = 30;- optional double croppingQuadTopLeftY = 31;- optional double croppingQuadTopRightX = 32;- optional double croppingQuadTopRightY = 33;-- optional bytes metadataData = 34;-- optional string userTitle = 35;-- optional bytes fallbackImageData = 36;-- optional bytes linkPresentationArchivedMetadata = 37;-- repeated Attachment inlineAttachment = 38;-- optional bytes systemPaperBundle = 39;-- optional bytes synapseData = 40;-- optional bytes fallbackPDFData = 41;-- optional bytes mergeablePreferredViewSize = 42;--}--message Location {- optional double latitude = 1;- optional double longitude = 2;-- optional bytes placemark = 3;-- optional bool placeUpdated = 4;-}--message Media {- optional string identifier = 1;- optional string filenameExtension = 2;- optional bytes data = 3;- optional string filename = 4;-- optional int64 minimumSupportedNotesVersion = 5;-}--message PreviewImage {- optional float scale = 1;- optional bool scaleWhenDrawing = 2;- optional bytes data = 3;- optional bytes metadata = 4;- optional int32 version = 5;- optional bool versionOutOfDate = 6;-- optional int64 minimumSupportedNotesVersion = 7;- optional int32 appearanceType = 8;-}--message Todo {- optional bytes todoUUID = 1;- optional bool done = 2;-}--message Color {- optional float red = 1;- optional float green = 2;- optional float blue = 3;- optional float alpha = 4;-}--message BoxedValue {- oneof contents {- sint64 integerValue = 1;- uint64 unsignedIntegerValue = 2;- double doubleValue = 3;- string stringValue = 4;- bytes bytesValue = 5;- bytes uuidValue = 6;- bytes jsonValue = 7;- }-}--message WallClockMergeableValue {- optional double timestamp = 1;- optional BoxedValue contents = 2;-}diff --git a/docs/icloud-web/proto/topotext-3.proto b/docs/icloud-web/proto/topotext-3.protodeleted file mode 100644index fb38240..0000000--- a/docs/icloud-web/proto/topotext-3.proto+++ /dev/null@@ -1,270 +0,0 @@-package topotext;--option optimize_for = LITE_RUNTIME;--message String {- optional string string = 2;-- // Only needed for mergeable strings.- repeated Substring substring = 3;- optional VectorTimestamp timestamp = 4;-- repeated AttributeRun attributeRun = 5;-- // Optional attachment data.- repeated Attachment attachment = 6;-}--message VectorTimestamp {- message Clock {- optional bytes replicaUUID = 1;- message ReplicaClock {- optional uint32 clock = 1;- optional uint32 subclock = 2;- }- repeated ReplicaClock replicaClock = 2;- }- repeated Clock clock = 1;-}--message CharID {- optional uint32 replicaID = 1;- optional uint32 clock = 2;-}--message Substring {- optional CharID charID = 1;- // Length of substring in UTF-16 characters (surrogate pairs are separate characters).- optional uint32 length = 2;-- // Style timestamp.- optional CharID timestamp = 3;-- optional bool tombstone = 4;-- // Index into String.substring.- repeated uint32 child = 5;-}--message Selection {- message Range {- optional CharID fromChar = 1;- optional CharID toChar = 2;- };- repeated bytes replicaUUID = 1;- repeated Range range = 2;-- enum Affinity {- Backward = 0;- Forward = 1;- }- optional Affinity affinity = 3;-}--message AttributeRun {- // Length of run in UTF-16 characters (surrogate pairs are separate characters).- optional uint32 length = 1;-- optional ParagraphStyle paragraphStyle = 2;-- // Overrides bold, italic and paragraph styles.- optional Font font = 3;-- // Modifiers applied on-top of paragraph style.- // Bold, italic...- optional uint32 fontHints = 5;-- // Integer values for future compatibility.- // Only set as 1 or 0 currently.- optional uint32 underline = 6;- optional uint32 strikethrough = 7;-- optional int32 superscript = 8;- optional string link = 9;- optional Color color = 10;-- enum WritingDirection {- NaturalDirection = 0;- LeftToRight = 1;- RightToLeft = 2;- LeftToRightOverride = 3;- RightToLeftOverride = 4;- }-- optional WritingDirection writingDirection = 11;-- optional AttachmentInfo attachmentInfo = 12;-- optional uint64 timestamp = 13;-- optional uint32 emphasis = 14;-- optional AttachmentInfo systemAttachmentInfo = 15;-}--message Font {- optional string name = 1;- optional float pointSize = 2;-- // Hints for when named font does not exist on device.- optional uint32 fontHints = 3;-}--message ParagraphStyle {- enum Alignment {- Left = 0;- Center = 1;- Right = 2;- Justified = 3;- Natural = 4;- }-- optional uint32 style = 1;- optional Alignment alignment = 2;- optional AttributeRun.WritingDirection writingDirection = 3;- optional int32 indent = 4;- optional Todo todo = 5;-- // Hints for when paragraph style does not exist in this version.- optional uint32 paragraphHints = 6;-- // Only used for the initial item of a numbered list.- optional uint32 startingListItemNumber = 7;-- // The current block quote level of the paragraph. The default value is 0.- optional uint32 blockQuoteLevel = 8;-- // A unique uuid- optional bytes uuid = 9;-}--message AttachmentInfo {- optional string attachmentIdentifier = 1;- optional string typeUTI = 2;-- // For system attachments, the name of the optimal class representation of this data.- optional string systemAttachmentClassName = 3;-- // For system attachments, the full attachment data.- optional bytes systemAttachmentData = 4;-}--message Attachment {- optional string identifier = 2;- optional bytes mergeableData = 3;- optional float sizeHeight = 4;- optional float sizeWidth = 5;- optional string summary = 6;- optional string title = 7;- optional string typeUTI = 8;- optional string urlString = 9;-- optional Location location = 10;- optional Media media = 11;- repeated PreviewImage preview = 12;-- optional float originX = 13;- optional float originY = 14;- optional int32 orientation = 15;-- optional double previewUpdateDate = 16;- optional double creationDate = 43;- optional double modificationDate = 17;- optional string remoteFileURL = 18;- optional bool checkedForLocation = 19;- optional int64 fileSize = 20;- optional double duration = 21;-- optional int32 imageFilterType = 22;- optional bytes markupModelData = 23;- repeated Attachment subAttachment = 24;-- optional int64 minimumSupportedNotesVersion = 25;-- optional double croppingQuadBottomLeftX = 26;- optional double croppingQuadBottomLeftY = 27;- optional double croppingQuadBottomRightX = 28;- optional double croppingQuadBottomRightY = 29;- optional double croppingQuadTopLeftX = 30;- optional double croppingQuadTopLeftY = 31;- optional double croppingQuadTopRightX = 32;- optional double croppingQuadTopRightY = 33;-- optional bytes metadataData = 34;-- optional string userTitle = 35;-- optional bytes fallbackImageData = 36;-- optional bytes linkPresentationArchivedMetadata = 37;-- repeated Attachment inlineAttachment = 38;-- optional bytes systemPaperBundle = 39;-- optional bytes synapseData = 40;-- optional bytes fallbackPDFData = 41;-- optional bytes mergeablePreferredViewSize = 42;--}--message Location {- optional double latitude = 1;- optional double longitude = 2;-- optional bytes placemark = 3;-- optional bool placeUpdated = 4;-}--message Media {- optional string identifier = 1;- optional string filenameExtension = 2;- optional bytes data = 3;- optional string filename = 4;-- optional int64 minimumSupportedNotesVersion = 5;-}--message PreviewImage {- optional float scale = 1;- optional bool scaleWhenDrawing = 2;- optional bytes data = 3;- optional bytes metadata = 4;- optional int32 version = 5;- optional bool versionOutOfDate = 6;-- optional int64 minimumSupportedNotesVersion = 7;- optional int32 appearanceType = 8;-}--message Todo {- optional bytes todoUUID = 1;- optional bool done = 2;-}--message Color {- optional float red = 1;- optional float green = 2;- optional float blue = 3;- optional float alpha = 4;-}--message BoxedValue {- oneof contents {- sint64 integerValue = 1;- uint64 unsignedIntegerValue = 2;- double doubleValue = 3;- string stringValue = 4;- bytes bytesValue = 5;- bytes uuidValue = 6;- bytes jsonValue = 7;- }-}--message WallClockMergeableValue {- optional double timestamp = 1;- optional BoxedValue contents = 2;-}diff --git a/docs/icloud-web/proto/versioned_document-2.proto b/docs/icloud-web/proto/versioned_document-2.protodeleted file mode 100644index afe6a08..0000000--- a/docs/icloud-web/proto/versioned_document-2.proto+++ /dev/null@@ -1,19 +0,0 @@-package versioned_document;--option optimize_for = LITE_RUNTIME;--message Document {- // Just in case.- optional uint32 serializationVersion = 1;-- repeated Version version = 2;-}--message Version {- optional uint32 serializationVersion = 1;- optional uint32 minimumSupportedVersion = 2;-- // Interpreted as a topotext.String- // Archived as bytes to ensure bit-perfect backward compatibility.- optional bytes data = 3;-}diff --git a/docs/icloud-web/proto/versioned_document.proto b/docs/icloud-web/proto/versioned_document.protodeleted file mode 100644index 94348f8..0000000--- a/docs/icloud-web/proto/versioned_document.proto+++ /dev/null@@ -1,22 +0,0 @@--syntax = "proto2";--package versioned_document;--option optimize_for = LITE_RUNTIME;--message Document {- // Just in case.- optional uint32 serializationVersion = 1;-- repeated Version version = 2;-}--message Version {- optional uint32 serializationVersion = 1;- optional uint32 minimumSupportedVersion = 2;-- // Interpreted as a topotext.String- // Archived as bytes to ensure bit-perfect backward compatibility.- optional bytes data = 3;-}diff --git a/docs/icloud-web/reminders.md b/docs/icloud-web/reminders.mddeleted file mode 100644index 2514a46..0000000--- a/docs/icloud-web/reminders.md+++ /dev/null@@ -1,221 +0,0 @@-# iCloud.com Reminders web app: reverse-engineered notes--Source: beautified `reminders2/main.js` (build 2638Build16), CloudKit container `com.apple.reminders`.-Path: `scratchpad/icloud-bundles/pretty/reminders2/main.js`. Line numbers refer to that file.-Read-only static analysis. Bundles were never executed.-Tags: **VERIFIED-IN-CODE** means the code shows it directly. **INFERRED** means it is a reasonable reading that I have not proven.--## 1. Transport, zones, record types--- **VERIFIED-IN-CODE**: the service host is `ckdatabasews.<servicesDomain>`. L24238: `d.set("ckdatabasews", { url: "https://ckdatabasews." + l.servicesDomain`.-- **VERIFIED-IN-CODE**: the app uses the embedded CloudKit JS library (`oi.create({... databaseType, partition, services:{fetch: ckFetch}})`) and builds Public, Private and Shared databases (L95500-95520). Private URLs match `"/" + ckEnvironment + "/private/"` (L95528).-- **INFERRED**: the bundle contains no literal `records/modify` or `changes/zone` strings, because CloudKit JS assembles the endpoint paths internally. The endpoints match standard CK web services: `records/modify`, `changes/zone`, `records/lookup`. The decode work in `quince-cloudkit-reminders` memory independently confirms `changes/zone`.-- **VERIFIED-IN-CODE**: the zone is `"Reminders"` (L58400 `i = "Reminders"`, L58443, L95783-95824). Shared lists use the share's `zoneID` (L108350 `v = t.share, y = v ? v.zoneID`).-- **VERIFIED-IN-CODE**: the record types are `Account` (L47771), `Reminder` (L49301), `Hashtag` (L56555), `Alarm` (L56589), `AlarmTrigger` (L56716), `RecurrenceRule` (L56913), `Assignment` (L57873), `cloudkit.share` (L58364), `Attachment` (L105812) and `List` (L108211).-- **VERIFIED-IN-CODE**: record names are prefixed. `RECORD_NAME_PREFIX: "Reminder/"` (L49302) and `"List/"` (L108212), each followed by a UUID (`List/` + `Object(l.a)()`, L108278).--## 2. List record (`List`)--The model is at L108208-108380.--| Field | Encoding | Cite |-|---|---|---|-| `Name` | `type: ArrayBuffer, serviceValueSetter: u.b` (bytes, most likely encrypted or bytes-string, see INFERRED below) | L108318 |-| `Color` | **JSON string** (`getServiceValueFromDataValue: JSON.stringify`). It is parsed back with JSON. Default is blue. | L108307-108313 |-| `BadgeEmblem` | `type: String` | L108304 |-| `Deleted`, `Imported`, `IsGroup`, `IsLinkedToAccount` | boolean (`Object(y.a)()`) | L108314-108317 |-| `ParentList` | reference, `action: VALIDATE, strong, readOnly`. This is the **list group** parent. | L108322 |-| `ReminderIDs` | JSON string array of reminder UUIDs **without** the `Reminder/` prefix. If it is too large, `ReminderIDsAsset` (an `application/json` Blob) is used instead. | L108330-108378 |-| `ResolutionTokenMap` | JSON string | L108380 |--- **VERIFIED-IN-CODE**: the ResolutionTokenMap keys for a list are `reminderIDsMergeableOrdering`, `name`, `parentAccount`, `badgeEmblem` and `color` (L108213-108219).-- **INFERRED**: `Name` is an ArrayBuffer with a custom setter, which probably makes it an ENCRYPTED_BYTES field. This fits the memory note that ENCRYPTED_BYTES is actually gzip/plain bytes. I did not trace `u.b`.--### Color JSON (L58044-58102)--**VERIFIED-IN-CODE**: each palette entry is frozen as follows:-```js-{ daSymbolicColorName: i /* or "custom" */, ckSymbolicColorName: n,- daHexString: t.rrggbb(), red: t.r, green: t.g, blue: t.b, alpha: 1, colorRGBSpace: 2 }-```-The palette is listed in the table. The columns are the RGB value, `ckSymbolicColorName` and `daSymbolicColorName`. An entry without a `daSymbolicColorName` gets `"custom"`.--| RGB | ck | da |-|---|---|---|-| 255,59,48 | red | red |-| 255,149,0 | orange | orange |-| 255,204,0 | yellow | yellow |-| 52,199,89 | green | green |-| 81,170,242 | lightBlue | custom |-| 0,122,255 | blue | blue |-| 88,86,214 | indigo | custom |-| 234,66,106 | pink | custom |-| 192,119,219 | purple | purple |-| 162,132,94 | brown | custom |-| 91,103,112 | gray | custom |-| 217,166,159 | rose | custom |--- **VERIFIED-IN-CODE**: the default color is the `blue` entry (L58074-58078).-- **VERIFIED-IN-CODE**: colors are resolved to hex by `l(e)` (L58090-58102). It lowercases `ckSymbolicColorName` and then `daSymbolicColorName`. If either one matches a palette entry, it returns that entry's `daHexString`. Otherwise it falls back to `e.daHexString`. Equality is `l(a) === l(b)` (L58086). In practice the symbolic name wins over the hex.-- **VERIFIED-IN-CODE**: `red`/`green`/`blue` are written as 0-255 ints, because they are `t.r` from `new Color(255,59,48)`. The hex is `rrggbb` (`c()` at L58080 strips any leading `#`).-- **Not present**: `isUserGenerated` is never referenced (0 grep hits). The web app neither writes nor reads it. **INFERRED**: native clients may add it. If you round-trip, preserve unknown keys.--### BadgeEmblem (L69159-69200)--- **VERIFIED-IN-CODE**: the allowed values (`cl`, L69159) are `default`, `bookmarks1-2`, `celebration1-2`, `education1-5`, `finance1-3`, `fitness`, `sport1-6`, `food`, `wine`, `health1-2`, `lifestyle1-2`, `location1-3`, `media1-5`, `nature1-2`, `people1-3`, `pet1-3`, `shopping1-4`, `transport1-4`, `vacation`, `weather1-5`, `work1-5`, `concept1-3`, `symbol1-7` and `emoji`.-- **VERIFIED-IN-CODE**: the renderer first tries `JSON.parse(badgeEmblem).Emoji` (L69176 `Object(fs.c)(a, hs.t.any()).Emoji`). If that works, it draws the emoji over the list color. If it fails, it uses the SVG icon for the name, falling back to `default` (`ul`, L69161). A plain string is therefore a symbol name, and an emoji emblem is the JSON string `{"Emoji":"<char>"}`.-- **VERIFIED-IN-CODE**: `ll(a,b)` (L69165) treats a missing value and `"default"` as equal.--### Show List Info dialog (L71520-71580)--- **VERIFIED-IN-CODE**: the dialog seeds its state from the list's `Name`, `Color` (blue if missing) and `BadgeEmblem` (`"default"` if missing) (L71525-71526). The color picker is keyed by `ckSymbolicColorName` (L71403), so it offers palette entries only and has no custom picker. The emblem picker grid shows `cl`.-- **VERIFIED-IN-CODE**: for a new list it calls `writeDataProperty(l,"Name",d)`, then `"Color"` with the full palette object, then `"BadgeEmblem"`, then `saveNewReminderList` (L71572-71574).-- **VERIFIED-IN-CODE**: for an existing list it writes only the fields that changed, each through `updatePropertyAndResolutionTokenForModel(List, pk, ResolutionTokenMapField.Name|Color|BadgeEmblem, value)` (L71580). Every edit therefore also bumps the ResolutionTokenMap entry for that field.-- **VERIFIED-IN-CODE**: a new list starts as `Name: "New List"` (localized), `Color: blue`, `IsLinkedToAccount: true`, `ReminderIDs: []` and a fresh ResolutionTokenMap, in the `remindersZone` (L108275-108293).--## 3. Reminder record (`Reminder`)--The model is at L49299-49720.--- **VERIFIED-IN-CODE**: the fields are `AllDay`, `Completed`, `Flagged` and `Imported` (booleans); `CompletionDate`, `CreationDate`, `DueDate`, `StartDate` and `LastModifiedDate` (Number, ms epoch); `Priority` (Number); `TimeZone` (String); `List` (reference, VALIDATE, strong); `ParentReminder` (reference); `Deleted` (bool); `ImportedICSData` (bytes); `ResolutionTokenMap` (JSON string); `TitleDocument`/`NotesDocument` (+`…Asset`). Cite L49592-49720.-- **VERIFIED-IN-CODE**: the ResolutionTokenMap keys are `allDay`, `titleDocument`, `notesDocument`, `parentReminder`, `priority`, `icsDisplayOrder`, `creationDate`, `list`, `flagged`, `completed`, `completionDate`, `lastModifiedDate`, `recurrenceRuleIDs`, `dueDate` and `timeZone` (L49303-49319).-- **VERIFIED-IN-CODE**: TitleDocument and NotesDocument hold a CRDT (`isCRDT` returns true for these two, L49321). On read, `N()` (L49270) applies `l.inflate(base64decode(str))` (zlib) to get a `TTMergeableStringVersionedDocument`. On write, `x()` archives it, deflates it and base64-encodes it. If the result is larger than half the field limit, it is sent as `TitleDocumentAsset` (an `application/octet-stream` Blob) instead (L49704-49720). A new reminder gets an empty `TTMergeableAttributedString`.-- **VERIFIED-IN-CODE**: `Deleted` arrives on the wire as `1`. The service value only wins if it is newer than the local copy: `return o < u.LastModifiedDate ? n : !!l` (L49601-49619).-- **VERIFIED-IN-CODE**: `ParentReminder` is written as `{recordName, zoneID, action}`. To clear it, the app sends `null`, but only if the original record had a parent (L49658-49690). Subtasks are the non-deleted reminders whose `ParentReminder` equals the pk (L49325-49331).-- **VERIFIED-IN-CODE**: a new reminder gets `recordName "Reminder/"+uuid`, `List`, `CreationDate`, `LastModifiedDate`, empty Title/Notes docs and a ResolutionTokenMap (L49333-49355). Ordering does not live on the reminder. It is the parent List's `ReminderIDs`.-- **VERIFIED-IN-CODE**: `Priority` uses the EventKit values. L73424: `PRIORITY_NONE = 0, PRIORITY_LOW = 9, PRIORITY_MEDIUM = 5, PRIORITY_HIGH = 1`. The labels come from `ip()` (L73402-73411): "Low Priority", "Medium Priority", "High Priority", and "None" as the fallback (L88721). **INFERRED**: the web UI only displays priority, because I found no writer.--## 4. Show Completed, delete, groups--- **VERIFIED-IN-CODE**: **Show Completed is local UI state, not a list field.** It lives in a React reducer as `showCompletedReminders: {}` keyed by list pk (L62621-62645), toggled by `SetShowCompletedReminders` (L73202). Nothing writes it to CloudKit. **INFERRED**: it is not persisted, apart from possible sessionStorage use at L93231, which I did not trace.-- **VERIFIED-IN-CODE**: **Deleting a list is a soft delete.** `TransactionalReminderList.delete` (L72199-72206) does three things. It writes `Deleted` to `true` (`writeDataProperty(storeId,key,previousValue,nextValue)`, L71907). It sets `IsLinkedToAccount` to `false`. It removes the list id from the Account's `ListIDsMergeableOrdering` CRDT (`removeReminderList`, L71995-72005). A list is viewable only if `IsLinkedToAccount && !Deleted` (L70620).-- **INFERRED**: the list-delete path does not touch the reminders inside the list. They become unreachable because their List is Deleted. Reminder delete is separately a `Deleted` flag write (L71968, L72529).-- **VERIFIED-IN-CODE**: **List groups** use `IsGroup` (bool) plus `ParentList` (a reference on child lists). Expanded state is local (`expandedGroups`, L62629). Groups get no action menu (`!n.IsGroup && ...`, L71049). **INFERRED**: the web app cannot create groups, because I found no writer for `IsGroup` or `ParentList` (`ParentList` is `readOnly`).--## 5. UI menus and dialogs--- **VERIFIED-IN-CODE**: the list menu (L73155-73175) contains "Show List Info" (`ReminderList.Menu.ListAppearance`), "Show Completed" or "Hide Completed" (a toggle) and "Delete List" (destructive). The sidebar row also has its own Delete List menu (L71060-71079).-- **VERIFIED-IN-CODE**: the error alerts are `Alert.Error.ReminderListDeleteMessage` ("Unable to Delete Reminder List"), `ReminderListCreateMessage` and `ReminderDeleteMessage` (L60241-60250).-- **VERIFIED-IN-CODE**: the reminder detail reducer (L77870-77890) handles the actions `modifyFlag`, `deleteLocation` and `deleteDate` (alarm triggers). The detail panel has the fields Notes, Due Date, Tags, Location, List and Attachments (strings at L60286-60299, L60421).-- **VERIFIED-IN-CODE**: there is no right-click context menu for reminders. Indent and outdent are Cmd/Ctrl+`]` and Cmd/Ctrl+`[` (L89696-89720). See §12.--## 6. ResolutionTokenMap (all record types)--The helpers are module `2042` (L33938-33986) and `2043` (L33997-34034).--- **VERIFIED-IN-CODE**: the field value is a JSON **string** (`getServiceValueFromDataValue: JSON.stringify`, L49689-49696) that wraps a `map` object. Each key in the map is a lowercase token name from `ResolutionTokenMapField` (for example `dueDate`, `completed`, `reminderIDsMergeableOrdering`).-- **VERIFIED-IN-CODE**: a new token is `{counter: 1, modificationTime: u(), replicaID: <UUID>}` (L34001-34005). A bump is `{...old, counter: old.counter + 1, modificationTime: u()}` (L34008-34013). A bump keeps the old `replicaID`. Rollback decrements `counter` and deletes the entry when it reaches 0 (L34016-34020, L33965-33971).-- **VERIFIED-IN-CODE**: `modificationTime` is **seconds since the Apple reference date (2001-01-01Z)**, as a float. L34032: `return (Date.now() - 9783072e5) / 1e3`. `replicaID` is an uppercase UUID (L34041 `Object(r.a)().toUpperCase()`).-- **VERIFIED-IN-CODE**: tokens are compared by `counter`, then `modificationTime` (with an epsilon), then `replicaID` using the UUID TTCompare (L34022-34029). The higher token wins the merge.-- **VERIFIED-IN-CODE**: when a record is created, every field in `ResolutionTokenMapField` gets a fresh token (`i(e)` L33949-33955, called at L49351 and L108290). A missing token is backfilled with a new one (`s()` L33976-33985).-- **VERIFIED-IN-CODE**: `updatePropertyAndResolutionTokenForModel(Model, pk, field, value)` (L71896-71906) does two things. It writes the field (`field.name`, for example `DueDate`) and it bumps `map[field.value]` (for example `dueDate`). `writeReminderFields` (L72267-72276) uses the token path for any key that has a token and a plain write otherwise. It always bumps `lastModifiedDate` as well.--Exact wire value:-```json-"ResolutionTokenMap": {"value": "{\"map\":{\"dueDate\":{\"counter\":2,\"modificationTime\":813931200.123,\"replicaID\":\"6F1C…-UUID\"},\"completed\":{\"counter\":1,\"modificationTime\":813900000.5,\"replicaID\":\"…\"}}}"}-```-(The values here are illustrative, but the shape is the one in the code.)--## 7. Reminder writes--### Create (L49333-49355, L72212-72229, L72142-72197)-- **VERIFIED-IN-CODE**: a new Reminder carries `recordName "Reminder/"+UUID`, `List` (ref), `CreationDate` and `LastModifiedDate` (ms epoch, both `Date.now()`), empty `TitleDocument` and `NotesDocument` CRDTs, and a full fresh `ResolutionTokenMap`. A child reminder ("create after" a subtask) also gets `ParentReminder` through the token path (L90642).-- **VERIFIED-IN-CODE**: the same transaction inserts the reminder's id into the parent List's `ReminderIDs` at `start` (0), `end` (length) or `after` a given pk (`insertReminder`, L72142-72155). It then bumps the list token `reminderIDsMergeableOrdering` (L72176-72196). `PlaceholderAtEnd` and `PlaceholderAtPosition` are local-only flags (L72214, L90656).-- **VERIFIED-IN-CODE**: a new Reminder or List is committed in an **atomic** batch. Parents are ordered before children (`ot()` L92458-92466, `orderTheAtomicChanges` L92416-92425, `n.atomic = a` L92373). Updates that touch `Deleted`, `Completed`, List `ReminderIDs` or Account `ListIDsMergeableOrdering` are also atomic. Everything else goes in a non-atomic batch.--### Complete (L72230-72265)-- **VERIFIED-IN-CODE**: `writeCompletionProperty` writes exactly three fields per reminder, each through the token path: `CompletionDate` = `Date.now()` (or `undefined` when un-completing), `Completed` = bool, `LastModifiedDate` = `Date.now()` (L72232). **List ordering (`ReminderIDs`) is not touched.**-- **VERIFIED-IN-CODE**: completing a parent cascades to every incomplete child. Un-completing restores only the children whose `CompletionDate` equals the parent's (`childrenPKsToUpdateCompletion`, L72277-72289).-- **VERIFIED-IN-CODE**: **recurring reminders are not completed by a field write.** The app runs a server-side query with the virtual record type `CompleteRecurringReminder` (L72449-72498):-```json-{"recordType":"CompleteRecurringReminder","filterBy":[- {"comparator":"EQUALS","fieldName":"Reminder","fieldValue":{"value":{"recordName":"Reminder/<id>","action":"VALIDATE"},"type":"REFERENCE"}},- {"comparator":"EQUALS","fieldName":"RecurrenceRule","fieldValue":{"value":{"recordName":"RecurrenceRule/<id>","action":"VALIDATE"},"type":"REFERENCE"}},- {"comparator":"EQUALS","fieldName":"TimeZone","fieldValue":{"value":"<IANA tz>","type":"STRING"}}]}-```- The query is sent to `zoneID {zoneName, ownerRecordName}` and the records it returns are ingested. That means the server rolls the due date forward.-- **VERIFIED-IN-CODE**: other server-side virtual queries are `TreeDeletion` (`recordIds` REFERENCE, for list delete, L70716), `LookupValidatingReferences` (L92596), `Lists` (L92671, L95732), `SearchIndexes` (L95766) and `reminderList` (with filters `List`, `includeCompleted` INT64 and `LookupValidatingReference` INT64 1, L58476-58502).--### Due date and all-day (L90583-90612, L75059-75080, L88490-88582)-- **VERIFIED-IN-CODE**: the date picker produces `dateComponentData = {year, month, day, hour, minute, second: 0, timeZone: {identifier}}` (L88553-88567). The identifier is the browser's IANA zone (`tC()` L83704, `Intl.DateTimeFormat().resolvedOptions().timeZone`).-- **VERIFIED-IN-CODE**: `handleEditDate` first deletes the existing date Alarm and its AlarmTrigger and clears `DueDate`, `AllDay` and `TimeZone`. It then sets `DueDate = Mg(components)`, `AllDay = allDay` and `TimeZone = components.timeZone.identifier`. **A timed date (`!allDay`) also creates an Alarm plus an AlarmTrigger of type `Date`. An all-day date creates no alarm** (L90606-90609). When the date is removed, `RecurrenceRuleIDs = []` and the RecurrenceRule records are deleted (L90591-90601).-- **VERIFIED-IN-CODE**: `Mg()` converts wall-clock components in the given zone to UTC ms: `Date.UTC(y, m-1, d, h, min, s)` minus the zone offset (L75059-75078).-- **VERIFIED-IN-CODE**: on read, an all-day `DueDate` is treated as a **floating UTC-midnight** value. L88497: `t && e.setMinutes(e.getMinutes() + e.getTimezoneOffset())` (applied when `allDay`). A timed reminder displays the AlarmTrigger's `DateComponentsData` in preference to `DueDate` (L89069-89081).-- **INFERRED**: for all-day the web writer builds midnight components in the *local* zone and runs them through `Mg`, which gives local midnight rather than UTC midnight. The reader expects UTC midnight. **For Quince, write all-day `DueDate` = UTC midnight of the date, `AllDay = 1`, and `TimeZone` = the IANA zone, which matches the reader and EventKit's floating semantics.** Verify this against a natively created all-day reminder.--## 8. Alarm and AlarmTrigger (L56589-56870)--**Alarm** (`Alarm/<UUID>`):-| Field | Value | Cite |-|---|---|---|-| `AlarmUID` | the same UUID as the record name suffix | L56598, L56620 |-| `Reminder` | REFERENCE, VALIDATE, strong | L56634-56639 |-| `TriggerID` | the AlarmTrigger record name **without** the `AlarmTrigger/` prefix | L56643-56662 |-| `DueDateResolutionTokenAsNonce` | `counter * 1e11 + modificationTime` of the reminder's `dueDate` token | L56603-56607 |-| `CreationDate`, `LastModifiedDate` | ms epoch | L56614-56615 |-| `Deleted`, `Imported` | false | L56621-56622 |--**AlarmTrigger** (`AlarmTrigger/<UUID>`):-- **VERIFIED-IN-CODE**: `Alarm` is a REFERENCE (VALIDATE, strong) and `Deleted` is set. `Type` is one of `Date`, `Location`, `TimeInterval` or `Vehicle` (L56873-56875).-- `Date`: `DateComponentsData` holds base64 of JSON `{year,month,day,hour,minute,second,timeZone:{identifier}}` (L56785-56797), and `Imported: 0`.-- `Location`: `Latitude`, `Longitude` (encrypted DOUBLE), `Radius` (m), `Proximity` (0 NONE / 1 ENTER = arriving / 2 LEAVE = leaving, L75124), `Title`, `Address` and `ReferenceFrameString: "1"` (encrypted STRING), plus `LocationUID`. It may also carry `MapKitHandle` and `Routing` (bytes) and `ContactLabel`.-- `Vehicle`: `Event` (Number, enter or exit car).-- `TimeInterval`: `TimeInterval` (Number). **INFERRED**: this is a relative or early alarm. The web app never creates one.-- **VERIFIED-IN-CODE**: the encrypted setters set `fields[k].isEncrypted = true` and type `STRING` or `DOUBLE` (L56880-56894).-- **VERIFIED-IN-CODE**: the links are `Reminder.AlarmIDs` (alarm UUIDs without prefix, L49567) → `Alarm.TriggerID` → `AlarmTrigger`, and back-references go `AlarmTrigger.Alarm` → `Alarm.Reminder`. On delete, the app sets `Deleted = true` on both records and clears `Alarm.Reminder` and `AlarmTrigger.Alarm` (L90507-90515).-- **INFERRED**: there is no "early reminder" field in this bundle. Native clients most likely model it as a second Alarm of type `TimeInterval`.--## 9. RecurrenceRule (L56899-57040)--- **VERIFIED-IN-CODE**: the fields are `Frequency`, `Interval`, `OccurrenceCount`, `EndDate` (ms), `FirstDayOfTheWeek` (Number), `Imported` (Number), `Deleted`, `Reminder` (REFERENCE, VALIDATE). The fields `DaysOfTheWeek`, `DaysOfTheMonth`, `DaysOfTheYear`, `WeeksOfTheYear`, `MonthsOfTheYear` and `SetPositions` each hold **base64(JSON)**.-- **VERIFIED-IN-CODE**: `Frequency` maps 0 = daily, 1 = weekly, 2 = monthly, 3 = yearly, 4 = hourly, 5 = minutely and 6 = secondly (`_m`, L76871-76887).-- **VERIFIED-IN-CODE**: each `DaysOfTheWeek` entry is `{dayOfTheWeek: 1..7 (1 = Sunday), weekNumber?: n}` (`wm` L76888-76906, `Cm` L76915-76929). The `nth` value comes from `weekNumber` or the first `SetPositions` entry. `-1` means last (L76933-76947).-- **VERIFIED-IN-CODE**: the link is `Reminder.RecurrenceRuleIDs` (UUIDs without prefix). The app uses only `[0]` (L71697, L89063).-- **INFERRED**: the web app only reads and deletes RecurrenceRules (it has `lE.delete` and no create path). Its NewFeature string says it "complete[s] recurring reminders". Native clients create the rules.--## 10. Hashtag, Assignment, Attachment/URL--- **VERIFIED-IN-CODE** Hashtag (`Hashtag/…`, L56553-56568): `Name` (String, readOnly, no `#`), `Deleted` and `Reminder` (REFERENCE, readOnly). The reminder lists them in `HashtagIDs`. The UI renders `"#" + Name` (L89133). **INFERRED**: the web UI is read-only for tags.-- **VERIFIED-IN-CODE** Assignment (`Assignment/…`, L57871-57897): `AssignedDate` (Number), `EncryptedAssigneeIdentifier` and `EncryptedOriginatorIdentifier` (String), `OwningReminderIdentifier` (String), `Status` (bool), `MinimumSupportedAppVersion`, `Imported`, `Deleted` and `Reminder` (ref, readOnly). These are listed in `AssignmentIDs`, and only `[0]` is used (L89082).-- **VERIFIED-IN-CODE** Attachment (`Attachment/…`, L105799-105910): `Type` is one of `File`, `Image` or `URL` (L105785). The other fields are `URL` (base64 string, decoded and validated, L105888-105899), `FileName` (base64 string), `FileAsset` and `MetadataAsset` (assets; the metadata is a bplist with `icon` or `image` data), `Metadata` (base64 bplist), `FileSize`, `Width`, `Height`, `UTI`, `Imported`, `Deleted` and `Reminder` (ref, readOnly). These are listed in `Reminder.AttachmentIDs`. **The reminder "URL" is therefore an Attachment record of `Type: "URL"`, not a Reminder field.** Every service setter on this model is a no-op, so the web app is read-only for attachments.--## 11. CloudKit JS request building--- **VERIFIED-IN-CODE**: the CloudKit JS library is **not** in this bundle. `newRecordsBatch` is only called (L92374) and never defined, and `operationType` appears only in app error contexts. The app calls `db.newRecordsBatch({zoneID,…, atomic}).createOrUpdate(records).delete(records).commit()` (L92372-92385). A record counts as a create when it has no `recordChangeTag`, and as an update when it has one (`rt` and `it`, L92450-92457). The serialized record is `{recordName, recordType, recordChangeTag, fields:{K:{value[,type,isEncrypted]}}}` (L108970-108980, L56700 setter `e.fields[t].value = n`). After a commit, the app saves `httpResponse.body.syncToken` for the zone (L92412-92413).-- **INFERRED** (standard CK JS behaviour): `createOrUpdate` emits `operationType: "create"` when there is no change tag and `"update"` (with `recordChangeTag`) when there is one. It posts `records/modify` with `{operations, zoneID, atomic}`. Quince should send `update` with the last-seen `recordChangeTag` and handle `CONFLICT` by refetching and merging through the ResolutionTokenMap.--## 12. UI checklist--Menus and actions:-- [ ] List menu: Show List Info (`ReminderList.Menu.ListAppearance`), Show Completed / Hide Completed (`…ShowCompleted` / `…HideCompleted`), Delete List (`…DeleteList`) (L73155-73175)-- [ ] Sidebar row menu: Delete List (L71060-71079); no menu on groups-- [ ] "Add List" button (`Button.AddList`); new list default name "New List"-- [ ] List Info dialog: title "List Info" / "“%{name}” Info", "List Color" picker (12 swatches), "List Icon" emblem grid, Done/Cancel-- [ ] Delete confirmation: "Delete list “%{listName}”?" + "This will delete all reminders in this list." ; shared variants "Delete shared list “%{listName}”?" with SharedByMe / SharedToMe descriptions-- [ ] "New Reminder" row (`ReminderList.NewReminder`); placeholder title "New Reminder", notes placeholder "Notes"-- [ ] Details popover ("Details", Save/Cancel): "Remind me on a Day" switch, Date + Time fields, Repeat (read-only text) + End ("Never"), Location ("Remind at Location", Arriving/Leaving, Radius "%{radius} m", "Current Location", "Getting in/out of Car", "Custom…", search "Search or Enter Address", Confirm), Priority (display), List, Tags, URL, Images, "Assign Reminder"-- [ ] Shared labels: "Shared by %{name}", "Shared with …" variants, fallback "This list is shared"-- [ ] Touch selection callout: Select / Select All--Keyboard (L89458-89720, L66096-66121):-- [ ] Row: Enter = edit title / open details, Escape = return focus to row, Space = toggle complete (no Ctrl)-- [ ] List: ArrowUp/ArrowDown move selection (Shift = extend, Cmd/Ctrl = move item), Home/End, Cmd/Ctrl+A select all, Ctrl+Space toggle selection, Backspace delete selected-- [ ] Cmd/Ctrl+`]` indent (make subtask), Cmd/Ctrl+`[` outdent-- [ ] Click modifiers: Shift-click extend, Cmd/Ctrl-click inclusive select-- [ ] Menus: arrows, Home/End, Enter/Space activate, type-ahead by letter-- [ ] No right-click context menu (only `preventDefault` on calendar cells, L87376)--Empty and loading states:-- [ ] "No List Selected", "No Reminders", "All Items Completed", "Loading Reminders…", "Loading…"-- [ ] Sidebar empty: "No Lists" + "Use Reminders on iOS, iPadOS, or macOS to create a new list."-- [ ] Dates: Today/Tomorrow/Yesterday (+ ", %{time}"), "%{date}, Overdue"; recurrence strings `Reminder.Date.Recurring.*` (Daily/Weekly/Monthly/Yearly, "Every %{interval} …", nth weekday)--Error alerts (`Alert.Error.*`, L60200-60260): ReminderList Add/Create/Update/Delete/Accept, Reminder Create/Update/Delete/Completion, Reminder.Save ("Unable to Save Changes"), ReminderCompletionRecurringDescription ("This is a repeating reminder. Complete repeating reminders using Reminders for iOS, iPadOS, and macOS."), Location errors, WebGL alert.--## Gaps--- I have not captured a real `records/modify` body, because the CK JS library is external to this bundle. The `operationType` values are INFERRED.-- I did not resolve the `Name` serviceValueSetter (`u.b`) on List.-- The all-day write semantics conflict: the writer produces local midnight and the reader expects UTC midnight. Confirm against a native record.-- Native clients may set early-reminder (`TimeInterval`) alarms, `Priority`, hashtags, assignments and RecurrenceRule creation. The web app writes none of these, so the exact native shapes still need to be observed.-- I did not trace the `Status` and `Event` enum values (Assignment and Vehicle).diff --git a/docs/icloud-web/shell-auth-account.md b/docs/icloud-web/shell-auth-account.mddeleted file mode 100644index bad79d2..0000000--- a/docs/icloud-web/shell-auth-account.md+++ /dev/null@@ -1,33 +0,0 @@-# Sign-in, session and account: static pass + live capture, 2026-10-19-Sign-in bundle: `~/.cache/quince-icloud-re/shell/pretty/idmsa/` (Apple's `idmsa.apple.com/appleauth` widget). All paths are under-`https://idmsa.apple.com/appleauth` (`urlContext`), POST JSON unless noted.--## Methods the web widget supports (VERIFIED-IN-CODE path strings)-| Method | Calls | In Quince? |-|---|---|---|-| Password (SRP-6a, worker `webSRPClientWorker.js`) | `/auth/signin/init` → `/auth/signin/complete` | yes |-| Code from a trusted device | `/auth/verify/trusteddevice/securitycode` | yes |-| SMS / phone | `/auth/verify/phone`, `/auth/verify/phone/securitycode` | yes |-| Trust this browser | `/auth/2sv/trust` (`/auth/2sv/donttrust`) | yes |-| **Passkey** (WebAuthn assertion) | `getDeviceChallange` → `POST /auth/verify/device/key/challenge {passkeyAutofill}`, then `verifyClientDeviceAssertion` → `POST /auth/verify/device/key?isRememberMeEnabled={bool}` with `{…assertion, rememberMe, accountName?, passkeyAutofill}`. **Seen live: this is how he signs in on the web.** | no |-| Security key (FIDO) | `/auth/verify/security/key`, `/auth/verify/securitykey` | no |-| Email code | `/auth/verify/email/securitycode`, `/auth/verify/email/resend` | no |-| Recovery key | `/auth/verify/recoverykey` | no |-| QR sign-in | `/signin/qrcode` | no |-| Account repair (terms, privacy) | `/auth/repair/complete`, `/auth/bridge/step/{n}` | no (shown as an error) |-| Other | `/auth/token/complete`, `/auth/push/complete`, `/auth/otp/{generate,validate}`, `/auth/escrow/{init,complete}`, `/auth/federate/*`, `/auth/obo`, `/auth/supportpin` | no |--## iCloud session (setup.icloud.com, seen live)-- `POST /setup/ws/1/accountLogin {dsWebAuthToken, accountCountryCode, extended_login}` returns dsInfo + webservices (+ `isWebAccessAllowed`).-- `POST /setup/ws/1/validate`: **421 means the session has expired**, so sign in again (seen live after an idle period).-- `POST {partition}-setup /setup/ws/1/storageUsageInfo`, `GET /setup/web/family/getFamilyDetails`.-- Plans: `gatewayws /acsegateway/v1/accounts/{dsid}/plans/icloud/pricing`, `…/web/plans/next-larger-plan`,- `/v3/accounts/{dsid}/subscriptions/features/cloud.storage/plan-summary`.-- Shared web settings: `keyvalueservice /json/sync` (POSTed repeatedly).-- `logoutFromAllBrowsers` is referenced in the shell.--## Quince gaps worth doing-1. Passkey sign-in. Hard on Linux: WebKitGTK has no WebAuthn platform authenticator. A phone passkey would need the- caBLE/hybrid QR flow. Low priority; password + 2FA already works.-2. Email-code and recovery-key fallbacks: small additions to quince-auth if an account has no trusted devices.-3. Repair (`bridge/step`): today an account with unaccepted iCloud terms just fails. Detect it and send the user to icloud.com.diff --git a/docs/ios27-kit.md b/docs/ios27-kit.mddeleted file mode 100644index f5927d5..0000000--- a/docs/ios27-kit.md+++ /dev/null@@ -1,1614 +0,0 @@-# iOS and iPadOS 27 — tokens from Apple's Figma kit---## Variables: Mode-Modes: Compact, Regular--| Name | Compact | Regular |-|---|---|---|--## Variables: Colors-Modes: Light, Dark--| Name | Light | Dark |-|---|---|---|-| Labels/Secondary | #3c3c4399 | #ebebf5b2 |-| Accents/Blue | #0088ff | #0091ff |-| Labels/Primary | #000000 | #ffffff |-| Backgrounds/Primary | #ffffff | #000000 |-| Fills/Primary | #78787833 | #7878805c |-| Separators/Opaque | #c6c6c8 | #38383a |-| Labels/Tertiary | #3c3c434d | #ebebf54d |-| Labels/Quaternary | #3c3c432e | #ebebf529 |-| Backgrounds/Primary - Elevated | #ffffff | #1c1c1e |-| Backgrounds/Tertiary | #ffffff | #2c2c2e |-| Backgrounds/Secondary | #f2f2f7 | #1c1c1e |-| Backgrounds (Grouped)/Primary | #f2f2f7 | #000000 |-| Backgrounds (Grouped)/Secondary | #ffffff | #1c1c1e |-| Backgrounds (Grouped)/Tertiary | #f2f2f7 | #2c2c2e |-| Accents/Red | #ff383c | #ff4245 |-| Accents/Orange | #ff8d28 | #ff9230 |-| Accents/Yellow | #ffcc00 | #ffd600 |-| Accents/Green | #34c759 | #30d158 |-| Accents/Mint | #00c8b3 | #00dac3 |-| Accents/Teal | #00c3d0 | #00d2e0 |-| Accents/Cyan | #00c0e8 | #3cd3fe |-| Accents/Brown | #ac7f5e | #b78a66 |-| Accents/Indigo | #6155f5 | #6d7cff |-| Accents/Purple | #cb30e0 | #db34f2 |-| Accents/Pink | #ff2d55 | #ff375f |-| Grays/Black | #000000 | #000000 |-| Grays/White | #ffffff | #ffffff |-| Grays/Gray | #8e8e93 | #8e8e93 |-| Grays/Gray 2 | #aeaeb2 | #636366 |-| Grays/Gray 3 | #c7c7cc | #48484a |-| Grays/Gray 4 | #d1d1d6 | #3a3a3c |-| Grays/Gray 5 | #e5e5ea | #2c2c2e |-| Grays/Gray 6 | #f2f2f7 | #1c1c1e |-| Fills/Secondary | #78788029 | #78788052 |-| Fills/Quaternary | #74748014 | #7676802e |-| Fills/Tertiary | #7676801f | #7676803d |-| Separators/Non-opaque | #0000001f | #ffffff2b |-| Mode | Light | Dark |-| Overlays/Default | #00000033 | #0000007a |-| Miscellaneous/Bar border | #0000004d | #ffffff26 |-| 🚧Miscellaneous/Button - Disabeld Label | #ffffff1f | #ff000040 |-| 🚧Miscellaneous/Button - Tinted Fill | #007aff26 | #0a84ff26 |-| Miscellaneous/Tab - Unselected | #ff00a6 | #ff00a6 |-| 🚧Miscellaneous/Menu - Font Size - Section Title | #8080808c | #808080b2 |-| 🚧Miscellaneous/Menu - Inset - Section Title | #00000014 | #00000029 |-| Miscellaneous/Keyboards/Emoji + Mic | #000000 | #ffffff |-| Overlays/Activity View Controller | #00000033 | #0000004a |-| 🚧Miscellaneous/_Kit Section Fill | #ff9999 | #ff9999 |-| Miscellaneous/Floating Tab - Text Selected | → Accents/Blue | #ffffff |-| Miscellaneous/Floating Tab - Text Unselected | #090909 | #ababb1ed |-| Miscellaneous/Floating Tab - Pill Shadow | #00000014 | #00000000 |-| Miscellaneous/Floating Tab - Pill Fill | #ffffff | #ffffff12 |-| Miscellaneous/Toggle/Fill - Selected | #ffffff | #8e8e9340 |-| Miscellaneous/Sidebar/Text - Selected | → Accents/Blue | → Grays/White |-| Miscellaneous/Sidebar/Shadow - Drag Over | #00000033 | #000000e5 |-| Separators/Vibrant | #e6e6e6 | #1a1a1a |-| Miscellaneous/Buttons/Label - Destructive - Disabled | #ff383c80 | #ff424580 |-| Miscellaneous/Buttons/BG - Destructive - Prominent | #ff383c33 | #ff424533 |-| Miscellaneous/Buttons/BG - Destructive | #ff383c24 | #ff424524 |-| Labels - Vibrant/Primary | #1a1a1a | #f5f5f5 |-| Labels - Vibrant/Secondary | #727272 | #8a8a8a |-| Labels - Vibrant/Tertiary | #bfbfbf | #404040 |-| Fills - Vibrant/Primary | #cccccc | #333333 |-| Fills - Vibrant/Secondary | #e0e0e0 | #1f1f1f |-| Fills - Vibrant/Tertiary | #ededed | #121212 |-| Labels - Vibrant/Quaternary | #d9d9d9 | #262626 |-| Miscellaneous/Segmented Control - Selected Fill | #ffffff | #ffffff45 |-| Backgrounds/Primary - Elevated | #ffffff | #1c1c1e |-| Backgrounds/Secondary - Elevated | #f2f2f7 | #2c2c2e |-| Backgrounds/Tertiary - Elevated | #ffffff | #3a3a3c |-| Backgrounds (Grouped)/Primary - Elevated | #f2f2f7 | #1c1c1e |-| Backgrounds (Grouped)/Secondary - Elevated | #ffffff | #2c2c2e |-| Backgrounds (Grouped)/Tertiary - Elevated | #f2f2f7 | #3a3a3c |-| Labels - Vibrant - Controls/Tertiary | #bfbfbf | #404040 |-| Labels - Vibrant - Controls/Secondary | #727272 | #8a8a8a |-| Labels - Vibrant - Controls/Primary | #1a1a1a | #f5f5f5 |-| Miscellaneous/Tab Bar Selection | → Accents/Blue | #ffffff |-| Miscellaneous/Toggle/AX Label - Off | #b3b3b3 | #a6a6a6 |-| Miscellaneous/Sidebar/Sidebar - BG - Active | #dae6f2 | #141517 |-| Miscellaneous/Sidebar/Sidebar - BG - Inactive | #edf4fa | #131414 |--## Variables: Icons-Modes: Light, Dark, Clear Light--| Name | Light | Dark | Clear Light |-|---|---|---|---|-| Mode | Light | Dark | Clear Light |--## Variables: Liquid Glass-Modes: Bright, Dim--| Name | Bright | Dim |-|---|---|---|-| BG Context | Bright | Dim |-| ❌Labels - Controls/Primary XXXX | #ffff00 | #00ffff |-| ❌Labels - Controls/Tertiary XXXX | #ffff00 | #00ffff |-| ❌Labels - Controls/Secondary XXXX | #ffff00 | #00ffff |-| ❌Labels/Primary YYYY | #ffff00 | #00ffff |-| ❌Labels/Secondary YYYY | #ffff00 | #00ffff |-| ❌Fill/Tertiary ZZZZ | #ffff00 | #00ffff |--## Variables: Kit-Modes: Mode--| Name | Mode |-|---|---|-| Component Fill | #0000001a |-| Component Stroke | #c399ff |-| Subcomponent Fill (BG Context = Bright) | #ffcc99 |-| Subcomponent Stroke | #00000066 |-| Subcomponent Fill (BG Context = Dim) | #902220 |-| Subcomponent Fill | #0000001a |-| Section Fill | #0000001a |-| Section Stroke | #00000066 |-| Scroll Edge Effect/Blur Radius | 10 |-| Liquid Glass/Light Angle | 0 |-| Liquid Glass/Refraction | 70 |-| Liquid Glass/Frost - Regular | 6 |-| Liquid Glass/Depth - Regular | 30 |-| Liquid Glass/Dispersion | 20 |-| Liquid Glass/Splay - Regular | 20 |-| Liquid Glass/Splay - Medium and Large | 20 |-| Liquid Glass/Depth - Medium and Large | 30 |-| Liquid Glass/Frost - Large | 16 |-| Liquid Glass/Frost - Medium | 16 |-| Top | 27 |-| Bottom | 62 |-| Liquid Glass/Opacity | 25 |-| Link | #98ccff |-| Margin/iPhone | 16 |-| Typography/Font family/SF Pro | SF Pro |-| Typography/Font Weight/Medium | Medium |-| Typography/Font Weight/Regular | Regular |-| Typography/Font Weight/Regular-italic | Regular Italic |-| Typography/Font Weight/Semibold | Semibold |-| Typography/Font Weight/Bold | Bold |-| Typography/Font Weight/Medium-italic | Medium Italic |-| Typography/Font Weight/Semibold-italic | Semibold Italic |-| Typography/Letter spacing/Footnote | -0.08 |-| Typography/Letter spacing/Subheadline | -0.23 |-| Typography/Letter spacing/Callout | -0.31 |-| Typography/Letter spacing/Title-3 | -0.45 |-| Typography/Letter spacing/Title-2 | -0.26 |-| Typography/Letter spacing/Title-1 | 0.38 |-| Typography/Letter spacing/Body | -0.43 |-| Typography/Letter spacing/Headline | -0.43 |-| Typography/Letter spacing/Caption-2 | 0.06 |-| Typography/Letter spacing/Caption-1 | 0 |-| Typography/Letter spacing/Large-title | 0.4 |--## Variables: Colors-Modes: Light, Dark--| Name | Light | Dark |-|---|---|---|--## Variables: Dimensions-Modes: iPhone, iPad, iPhone Duo Inner Landscape, iPhone Duo Inner Portrait, iPhone Duo Outer Landscape, iPhone Duo Outer Portrait--| Name | iPhone | iPad | iPhone Duo Inner Landscape | iPhone Duo Inner Portrait | iPhone Duo Outer Landscape | iPhone Duo Outer Portrait |-|---|---|---|---|---|---|---|-| Margin | 16 | 20 | 20 | 20 | 20 | 20 |-| Sheet Top Radius | 38 | 32 | 38 | 38 | 38 | 38 |-| Sheet/iPad/Radius | 38 | 38 | 38 | 38 | 38 | 38 |-| Sheet Bottom Radius | 58 | 32 | 58 | 58 | 58 | 58 |-| Grabber Width | 60 | 60 | 60 | 60 | 60 | 60 |-| Grabber Height | 4 | 4 | 4 | 4 | 4 | 4 |-| Menus/Section Titles/Font Size | 13 | 12 | 13 | 13 | 13 | 13 |-| Menus/Section Titles/Top Padding | 4 | 5 | 4 | 4 | 4 | 4 |-| Menus/Section Titles/Bottom Padding | 10 | 7 | 10 | 10 | 10 | 10 |-| Menus/Control Group/Padding Top | 6 | 9 | 6 | 6 | 6 | 6 |-| Menus/Control Group/Item Spacing | 5 | 1 | 5 | 5 | 5 | 5 |-| Menus/Control Group/Symbol Height | 22 | 19 | 22 | 22 | 22 | 22 |-| Menus/Menu Items/Subtitle Line Height | 18 | 16 | 18 | 18 | 18 | 18 |-| Menus/Menu Items/Title Font Size | → Size/Body | 15 | → Size/Body | → Size/Body | → Size/Body | → Size/Body |-| Menus/Menu Items/Padding Top + Bottom | 10 | 11 | 10 | 10 | 10 | 10 |-| Menus/Menu Items/Label and Subtitle Padding Left | 0 | 4 | 0 | 0 | 0 | 0 |-| Menus/Menu Items/Padding Sides | 16 | 8 | 16 | 16 | 16 | 16 |-| Menus/Menu Items/Title Line Height | 20 | 18 | 20 | 20 | 20 | 20 |-| Menus/Menu Items/Separator Padding Top | 10 | 8 | 10 | 10 | 10 | 10 |-| Menus/Menu Items/Separator Padding Bottom | 10 | 9 | 10 | 10 | 10 | 10 |-| Status Bar/Height | 62 | 32 | 62 | 62 | 62 | 62 |-| Readable Content Margin | 260 | 260 | 260 | 260 | 260 | 260 |-| Home Indicator/Portrait Width | 144 | 273 | 144 | 144 | 144 | 144 |-| Home Indicator/Landscape Width | 226 | 315 | 226 | 226 | 226 | 226 |-| Home Indicator/Height | 5 | 5.5 | 5 | 5 | 5 | 5 |-| Popover Corner Radius | 38 | 38 | 38 | 38 | 38 | 38 |-| Other/Cut Corners TL | 30 | 2 | 20 | 20 | 0 | 0 |-| Other/Cut Corners TR | 30 | 2 | 20 | 20 | 0 | 20 |-| Other/Cut Corners BL | 30 | 2 | 20 | 20 | 20 | 0 |-| Other/Cut Corners BR | 30 | 2 | 20 | 20 | 20 | 20 |-| Activity View/Icon Spacing | 25.33 | 23 | 20 | 19 | 38 | 34 |-| Activity View/Row Margin Sides | 15 | 14 | 8 | 5 | 28 | 22 |-| Activity View/Row Margin Top | 16 | 18 | 16 | 16 | 16 | 16 |-| Activity View/Corner Radius Top | 38 | 38 | 40 | 40 | 42 | 40 |-| Activity View/Corner Radius Bottom | 0 | 0 | 40 | 40 | 0 | 0 |-| Activity View/Padding Top | → Status Bar/Height | 62 | 90 | 106 | 8 | 90 |-| Activity View/Padding Bottom | 0 | 0 | 90 | 106 | 0 | 0 |-| Activity View/Width | 402 | 402 | 541 | 541 | 402 | 402 |-| Activity View/Close Button WxH | 44 | 44 | 48 | 48 | 48 | 48 |-| Activity View/Margin Top | 16 | 16 | 16 | 16 | 16 | 16 |-| Activity View/Padding Sides | 0 | 0 | 206 | 64 | 68 | 8 |-| Activity View/Thumbnail Inset | 16 | 16 | 8 | 8 | 28 | 22 |--## Variables: Text Leading-Modes: Default, Loose, Tight--| Name | Default | Loose | Tight |-|---|---|---|---|-| xSmall/Large Title | 38 | 40 | 36 |-| xSmall/Title 1 | 31 | 33 | 29 |-| xSmall/Title 2 | 23 | 25 | 21 |-| xSmall/Title 3 | 22 | 24 | 20 |-| xSmall/Headline | 19 | 21 | 17 |-| xSmall/Body | 19 | 21 | 17 |-| xSmall/Callout | 18 | 20 | 16 |-| xSmall/Subheadline | 16 | 18 | 14 |-| xSmall/Footnote | 16 | 18 | 14 |-| xSmall/Caption 1 | 13 | 15 | 11 |-| xSmall/Caption 2 | 13 | 15 | 11 |-| Small/Large Title | 39 | 41 | 37 |-| Small/Title 1 | 32 | 34 | 30 |-| Small/Title 2 | 24 | 26 | 22 |-| Small/Title 3 | 23 | 25 | 21 |-| Small/Headline | 20 | 22 | 18 |-| Small/Body | 20 | 22 | 18 |-| Small/Callout | 19 | 21 | 17 |-| Small/Subheadline | 18 | 20 | 16 |-| Small/Footnote | 16 | 18 | 14 |-| Small/Caption 1 | 13 | 15 | 11 |-| Small/Caption 2 | 13 | 15 | 11 |-| Medium/Large Title | 40 | 42 | 38 |-| Medium/Title 1 | 33 | 35 | 31 |-| Medium/Title 2 | 28 | 30 | 26 |-| Medium/Title 3 | 24 | 26 | 22 |-| Medium/Headline | 21 | 23 | 19 |-| Medium/Body | 21 | 23 | 19 |-| Medium/Callout | 20 | 22 | 18 |-| Medium/Subheadline | 19 | 21 | 17 |-| Medium/Footnote | 16 | 18 | 14 |-| Medium/Caption 1 | 13 | 15 | 11 |-| Medium/Caption 2 | 13 | 15 | 11 |-| xLarge/Large Title | 43 | 45 | 41 |-| xLarge/Title 1 | 36 | 38 | 34 |-| xLarge/Title 2 | 30 | 32 | 28 |-| xLarge/Title 3 | 28 | 30 | 26 |-| xLarge/Headline | 24 | 26 | 22 |-| xLarge/Body | 24 | 26 | 22 |-| xLarge/Callout | 23 | 25 | 21 |-| xLarge/Subheadline | 22 | 24 | 20 |-| xLarge/Footnote | 20 | 22 | 18 |-| xLarge/Caption 1 | 19 | 21 | 17 |-| xLarge/Caption 2 | 18 | 20 | 16 |-| xxLarge/Large Title | 46 | 48 | 44 |-| xxLarge/Title 1 | 39 | 41 | 37 |-| xxLarge/Title 2 | 32 | 34 | 30 |-| xxLarge/Title 3 | 30 | 32 | 28 |-| xxLarge/Headline | 26 | 28 | 24 |-| xxLarge/Body | 26 | 28 | 24 |-| xxLarge/Callout | 24 | 26 | 22 |-| xxLarge/Subheadline | 24 | 26 | 22 |-| xxLarge/Footnote | 22 | 24 | 20 |-| xxLarge/Caption 1 | 21 | 23 | 19 |-| xxLarge/Caption 2 | 20 | 22 | 18 |-| xxxLarge/Large Title | 48 | 50 | 46 |-| xxxLarge/Title 1 | 41 | 43 | 39 |-| xxxLarge/Title 2 | 34 | 36 | 32 |-| xxxLarge/Title 3 | 32 | 34 | 30 |-| xxxLarge/Headline | 29 | 31 | 27 |-| xxxLarge/Body | 29 | 31 | 27 |-| xxxLarge/Callout | 28 | 30 | 26 |-| xxxLarge/Subheadline | 28 | 30 | 26 |-| xxxLarge/Footnote | 24 | 26 | 22 |-| xxxLarge/Caption 1 | 23 | 25 | 21 |-| xxxLarge/Caption 2 | 22 | 24 | 20 |-| AX1/Large Title | 52 | 54 | 50 |-| AX1/Title 1 | 46 | 48 | 44 |-| AX1/Title 2 | 41 | 43 | 39 |-| AX1/Title 3 | 38 | 40 | 36 |-| AX1/Headline | 34 | 36 | 32 |-| AX1/Body | 34 | 36 | 32 |-| AX1/Callout | 32 | 34 | 30 |-| AX1/Subheadline | 31 | 33 | 29 |-| AX1/Footnote | 29 | 31 | 27 |-| AX1/Caption 1 | 28 | 30 | 26 |-| AX1/Caption 2 | 25 | 27 | 23 |-| AX2/Large Title | 57 | 59 | 55 |-| AX2/Title 1 | 51 | 53 | 49 |-| AX2/Title 2 | 51 | 53 | 49 |-| AX2/Title 3 | 44 | 46 | 42 |-| AX2/Headline | 40 | 42 | 38 |-| AX2/Body | 40 | 42 | 38 |-| AX2/Callout | 39 | 41 | 37 |-| AX2/Subheadline | 37 | 39 | 35 |-| AX2/Footnote | 33 | 35 | 31 |-| AX2/Caption 1 | 32 | 34 | 30 |-| AX2/Caption 2 | 30 | 32 | 28 |-| AX3/Large Title | 61 | 63 | 59 |-| AX3/Title 1 | 57 | 59 | 55 |-| AX3/Title 2 | 52 | 54 | 50 |-| AX3/Title 3 | 51 | 53 | 49 |-| AX3/Headline | 48 | 50 | 46 |-| AX3/Body | 48 | 50 | 46 |-| AX3/Callout | 46 | 48 | 44 |-| AX3/Subheadline | 43 | 45 | 41 |-| AX3/Footnote | 40 | 42 | 38 |-| AX3/Caption 1 | 39 | 41 | 37 |-| AX3/Caption 2 | 35 | 37 | 33 |-| AX4/Large Title | 66 | 68 | 64 |-| AX4/Title 1 | 62 | 64 | 60 |-| AX4/Title 2 | 59 | 61 | 57 |-| AX4/Title 3 | 51 | 53 | 49 |-| AX4/Headline | 56 | 58 | 54 |-| AX4/Body | 56 | 58 | 54 |-| AX4/Callout | 52 | 54 | 50 |-| AX4/Subheadline | 50 | 52 | 48 |-| AX4/Footnote | 46 | 48 | 44 |-| AX4/Caption 1 | 44 | 46 | 42 |-| AX4/Caption 2 | 41 | 43 | 39 |-| AX5/Large Title | 70 | 72 | 68 |-| AX5/Title 1 | 68 | 70 | 66 |-| AX5/Title 2 | 66 | 68 | 64 |-| AX5/Title 3 | 65 | 67 | 63 |-| AX5/Headline | 62 | 64 | 60 |-| AX5/Body | 62 | 64 | 60 |-| AX5/Callout | 60 | 62 | 58 |-| AX5/Subheadline | 58 | 60 | 56 |-| AX5/Footnote | 52 | 54 | 50 |-| AX5/Caption 1 | 51 | 53 | 49 |-| AX5/Caption 2 | 48 | 50 | 46 |-| letterSpacing/large-title | 0.4 | 0.4 | 0.4 |-| letterSpacing/title-1 | 0.38 | 0.38 | 0.38 |-| letterSpacing/title-2 | -0.26 | -0.26 | -0.26 |-| letterSpacing/title-3 | -0.45 | -0.45 | -0.45 |-| letterSpacing/headline | -0.43 | -0.43 | -0.43 |-| letterSpacing/body | -0.43 | -0.43 | -0.43 |-| letterSpacing/callout | -0.31 | -0.31 | -0.31 |-| letterSpacing/subheadline | -0.23 | -0.23 | -0.23 |-| letterSpacing/footnote | -0.08 | -0.08 | -0.08 |-| letterSpacing/caption-1 | 0 | 0 | 0 |-| letterSpacing/caption-2 | 0.06 | 0.06 | 0.06 |-| fontFamily/sf-pro | SF Pro | SF Pro | SF Pro |-| fontStyle/regular | Regular | Regular | Regular |-| fontStyle/bold | Bold | Bold | Bold |-| fontStyle/semibold | Semibold | Semibold | Semibold |-| fontStyle/semibold-italic | Semibold Italic | Semibold Italic | Semibold Italic |-| fontStyle/regular-italic | Regular Italic | Regular Italic | Regular Italic |-| fontStyle/medium | Medium | Medium | Medium |-| fontStyle/medium-italic | Medium Italic | Medium Italic | Medium Italic |-| Large (Default)/Large Title | 41 | 43 | 39 |-| Large (Default)/Title 1 | 34 | 36 | 32 |-| Large (Default)/Title 2 | 28 | 30 | 26 |-| Large (Default)/Title 3 | 25 | 27 | 23 |-| Large (Default)/Headline | 22 | 24 | 20 |-| Large (Default)/Body | 22 | 24 | 20 |-| Large (Default)/Callout | 21 | 23 | 19 |-| Large (Default)/Subheadline | 20 | 22 | 18 |-| Large (Default)/Footnote | 18 | 20 | 16 |-| Large (Default)/Caption 1 | 16 | 18 | 14 |-| Large (Default)/Caption 2 | 13 | 15 | 11 |--## Variables: Dynamic Type-Modes: xSmall, Small, Medium, Large (Default), xLarge, xxLarge, xxxLarge, AX1, AX2, AX3, AX4, AX5--| Name | xSmall | Small | Medium | Large (Default) | xLarge | xxLarge | xxxLarge | AX1 | AX2 | AX3 | AX4 | AX5 |-|---|---|---|---|---|---|---|---|---|---|---|---|---|-| Size/Large Title | 31 | 32 | 33 | 34 | 36 | 38 | 40 | 44 | 48 | 52 | 56 | 60 |-| Size/Title 1 | 25 | 26 | 27 | 28 | 30 | 32 | 34 | 38 | 43 | 48 | 53 | 58 |-| Size/Title 2 | 19 | 20 | 21 | 22 | 24 | 26 | 28 | 34 | 43 | 44 | 50 | 56 |-| Size/Title 3 | 17 | 18 | 19 | 20 | 22 | 24 | 26 | 31 | 37 | 43 | 43 | 55 |-| Size/Headline | 14 | 15 | 16 | 17 | 19 | 21 | 23 | 28 | 33 | 40 | 47 | 53 |-| Size/Body | 14 | 15 | 16 | 17 | 19 | 21 | 23 | 28 | 33 | 40 | 47 | 53 |-| Size/Callout | 13 | 14 | 15 | 16 | 18 | 20 | 22 | 26 | 32 | 38 | 44 | 51 |-| Size/Subheadline | 12 | 13 | 14 | 15 | 17 | 19 | 21 | 25 | 30 | 36 | 42 | 49 |-| Size/Footnote | 12 | 12 | 12 | 13 | 15 | 17 | 19 | 23 | 27 | 33 | 38 | 44 |-| Size/Caption 1 | 11 | 11 | 11 | 12 | 14 | 16 | 18 | 22 | 26 | 32 | 37 | 43 |-| Size/Caption 2 | 11 | 11 | 11 | 11 | 13 | 15 | 17 | 20 | 24 | 29 | 34 | 40 |-| Leading/Large Title | → xSmall/Large Title | → xSmall/Large Title | → Medium/Large Title | → Large (Default)/Large Title | → xLarge/Large Title | → xxLarge/Large Title | → xxxLarge/Large Title | → AX1/Large Title | → AX2/Large Title | → AX3/Large Title | → AX4/Large Title | → AX5/Large Title |-| Leading/Title 1 | → xSmall/Title 1 | → xSmall/Title 1 | → Medium/Title 1 | → Large (Default)/Title 1 | → xLarge/Title 1 | → xxLarge/Title 1 | → xxxLarge/Title 1 | → AX1/Title 1 | → AX2/Title 1 | → AX3/Title 1 | → AX4/Title 1 | → AX5/Title 1 |-| Leading/Title 2 | → xSmall/Title 2 | → xSmall/Title 2 | → Medium/Title 2 | → Large (Default)/Title 2 | → xLarge/Title 2 | → xxLarge/Title 2 | → xxxLarge/Title 2 | → AX1/Title 2 | → AX2/Title 2 | → AX3/Title 2 | → AX4/Title 2 | → AX5/Title 2 |-| Leading/Title 3 | → xSmall/Title 3 | → xSmall/Title 3 | → Medium/Title 3 | → Large (Default)/Title 3 | → xLarge/Title 3 | → xxLarge/Title 3 | → xxxLarge/Title 3 | → AX1/Title 3 | → AX2/Title 3 | → AX3/Title 3 | → AX4/Title 3 | → AX5/Title 3 |-| Leading/Headline | → xSmall/Headline | → xSmall/Headline | → Medium/Headline | → Large (Default)/Headline | → xLarge/Headline | → xxLarge/Headline | → xxxLarge/Headline | → AX1/Headline | → AX2/Headline | → AX3/Headline | → AX4/Headline | → AX5/Headline |-| Leading/Body | → xSmall/Body | → xSmall/Body | → Medium/Body | → Large (Default)/Body | → xLarge/Body | → xxLarge/Body | → xxxLarge/Body | → AX1/Body | → AX2/Body | → AX3/Body | → AX4/Body | → AX5/Body |-| Leading/Callout | → xSmall/Callout | → xSmall/Callout | → Medium/Callout | → Large (Default)/Callout | → xLarge/Callout | → xxLarge/Callout | → xxxLarge/Callout | → AX1/Callout | → AX2/Callout | → AX3/Callout | → AX4/Callout | → AX5/Callout |-| Leading/Subheadline | → xSmall/Subheadline | → xSmall/Subheadline | → Medium/Subheadline | → Large (Default)/Subheadline | → xLarge/Subheadline | → xxLarge/Subheadline | → xxxLarge/Subheadline | → AX1/Subheadline | → AX2/Subheadline | → AX3/Subheadline | → AX4/Subheadline | → AX5/Subheadline |-| Leading/Footnote | → xSmall/Footnote | → xSmall/Footnote | → Medium/Footnote | → Large (Default)/Footnote | → xLarge/Footnote | → xxLarge/Footnote | → xxxLarge/Footnote | → AX1/Footnote | → AX2/Footnote | → AX3/Footnote | → AX4/Footnote | → AX5/Footnote |-| Leading/Caption 1 | → xSmall/Caption 1 | → xSmall/Caption 1 | → Medium/Caption 1 | → Large (Default)/Caption 1 | → xLarge/Caption 1 | → xxLarge/Caption 1 | → xxxLarge/Caption 1 | → AX1/Caption 1 | → AX2/Caption 1 | → AX3/Caption 1 | → AX4/Caption 1 | → AX5/Caption 1 |-| Leading/Caption 2 | → xSmall/Caption 2 | → xSmall/Caption 2 | → Medium/Caption 2 | → Large (Default)/Caption 2 | → xLarge/Caption 2 | → xxLarge/Caption 2 | → xxxLarge/Caption 2 | → AX1/Caption 2 | → AX2/Caption 2 | → AX3/Caption 2 | → AX4/Caption 2 | → AX5/Caption 2 |--## Text styles-| Style | Font | Size | Line height | Tracking |-|---|---|---|---|---|-| Body/Regular | SF Pro Regular | 17 | 22px | -0.43px |-| Light/Body/Secondary | SF Pro Regular | 17 | 22px | 0px |-| Body/Emphasized | SF Pro Semibold | 17 | 22px | -0.43px |-| Body/Italic | SF Pro Regular Italic | 17 | 22px | -0.43px |-| Body/Emphasized Italic | SF Pro Semibold Italic | 17 | 22px | -0.43px |-| Dark/Body - Primary | SF Pro Regular | 17 | 22px | 0px |-| Large Title/Regular | SF Pro Regular | 34 | 41px | 0.4px |-| Large Title/Emphasized | SF Pro Bold | 34 | 41px | 0.4px |-| Title1/Regular | SF Pro Regular | 28 | 34px | 0.38px |-| Title1/Emphasized | SF Pro Bold | 28 | 34px | 0.38px |-| Title2/Regular | SF Pro Regular | 22 | 28px | -0.26px |-| Title2/Emphasized | SF Pro Bold | 22 | 28px | -0.26px |-| Title3/Regular | SF Pro Regular | 20 | 25px | -0.45px |-| Title3/Emphasized | SF Pro Semibold | 20 | 25px | -0.45px |-| Headline/Regular | SF Pro Semibold | 17 | 22px | -0.43px |-| Headline/Italic | SF Pro Semibold Italic | 17 | 22px | -0.43px |-| Callout/Regular | SF Pro Regular | 16 | 21px | -0.31px |-| Callout/Emphasized | SF Pro Semibold Italic | 16 | 21px | -0.31px |-| Callout/Italic | SF Pro Regular Italic | 16 | 21px | -0.31px |-| Callout/Emphasized Italic | SF Pro Semibold Italic | 16 | 21px | -0.31px |-| Subheadline/Regular | SF Pro Regular | 15 | 20px | -0.23px |-| Subheadline/Emphasized | SF Pro Semibold | 15 | 20px | -0.23px |-| Subheadline/Italic | SF Pro Regular Italic | 15 | 20px | -0.23px |-| Subheadline/Emphaized Italic | SF Pro Semibold Italic | 15 | 20px | -0.23px |-| Footnote/Regular | SF Pro Regular | 13 | 18px | -0.08px |-| Footnote/Emphasized | SF Pro Semibold | 13 | 18px | -0.08px |-| Footnote/Italic | SF Pro Regular Italic | 13 | 18px | -0.08px |-| Footnote/Emphasized Italic | SF Pro Semibold Italic | 13 | 18px | -0.08px |-| Caption1/Regular | SF Pro Regular | 12 | 16px | 0px |-| Caption1/Emphasized | SF Pro Semibold | 12 | 16px | 0px |-| Caption1/Italic | SF Pro Regular Italic | 12 | 16px | 0px |-| Caption1/Emphasized Italic | SF Pro Semibold Italic | 12 | 16px | 0px |-| Caption2/Regular | SF Pro Regular | 11 | 13px | 0.06px |-| Caption2/Emphasized | SF Pro Semibold | 11 | 13px | 0.06px |-| Caption2/Italic | SF Pro Regular Italic | 11 | 13px | 0.06px |-| Caption2/Emphasized Italic | SF Pro Semibold Italic | 11 | 13px | 0.06px |-| Footnote/Regular | SF Pro Regular | 13 | 18px | -0.08px |-| XLTitle1 | SF Pro Bold | 48 | 56px | 0px |-| Large Title/Emphasized | SF Pro Bold | 340 | 41px | 0.4px |-| Loose Leading/asdf | Irish Grover Regular | 300 | 100% | 0% |-| Tight Leading/asdf | Irish Grover Regular | 300 | 100% | 0% |-| Tight Leading/Large Title/Regular | SF Pro Regular | 34 | 41px | 0.4px |-| Tight Leading/Large Title/Emphasized | SF Pro Bold | 34 | 41px | 0.4px |-| Tight Leading/Emphasized | SF Pro Bold | 34 | 41px | 0.4px |-| Tight Leading/Title 1/Regular | SF Pro Regular | 28 | 34px | 0.38px |-| Tight Leading/Title 1/Emphasized | SF Pro Bold | 28 | 34px | 0.38px |-| Tight Leading/Title 2/Regular | SF Pro Regular | 22 | 28px | -0.26px |-| Tight Leading/Title 2/Emphasized | SF Pro Bold | 22 | 28px | -0.26px |-| Tight Leading/Title 3/Regular | SF Pro Regular | 20 | 25px | -0.45px |-| Tight Leading/Title 3/Emphasized | SF Pro Semibold | 20 | 25px | -0.45px |-| Tight Leading/Headline/Regular | SF Pro Semibold | 17 | 22px | -0.43px |-| Tight Leading/Headline/Italic | SF Pro Semibold Italic | 17 | 22px | -0.43px |-| Tight Leading/Body/Regular | SF Pro Regular | 17 | 22px | -0.43px |-| Tight Leading/Body/Emphasized | SF Pro Semibold | 17 | 22px | -0.43px |-| Tight Leading/Body/Italic | SF Pro Regular Italic | 17 | 22px | -0.43px |-| Tight Leading/Body/Emphasized Italic | SF Pro Semibold Italic | 17 | 22px | -0.43px |-| Tight Leading/Callout/Regular | SF Pro Regular | 16 | 21px | -0.31px |-| Tight Leading/Callout/Emphasized | SF Pro Semibold | 16 | 21px | -0.31px |-| Tight Leading/Callout/Italic | SF Pro Regular Italic | 16 | 21px | -0.31px |-| Tight Leading/Callout/Emphasized Italic | SF Pro Semibold Italic | 16 | 21px | -0.31px |-| Tight Leading/Subheadline/Regular | SF Pro Regular | 15 | 20px | -0.23px |-| Tight Leading/Subheadline/Emphasized | SF Pro Semibold | 15 | 20px | -0.23px |-| Tight Leading/Subheadline/Italic | SF Pro Regular Italic | 15 | 20px | -0.23px |-| Tight Leading/Subheadline/Emphaized Italic | SF Pro Semibold Italic | 15 | 20px | -0.23px |-| Tight Leading/Footnote/Regular | SF Pro Regular | 13 | 18px | -0.08px |-| Tight Leading/Footnote/Emphasized | SF Pro Semibold | 13 | 18px | -0.08px |-| Tight Leading/Footnote/Italic | SF Pro Regular Italic | 13 | 18px | -0.08px |-| Tight Leading/Footnote/Emphasized Italic | SF Pro Semibold Italic | 13 | 18px | -0.08px |-| Tight Leading/Caption1/Regular | SF Pro Regular | 12 | 16px | 0px |-| Tight Leading/Caption1/Emphasized | SF Pro Medium | 12 | 16px | 0px |-| Tight Leading/Caption1/Italic | SF Pro Regular Italic | 12 | 16px | 0px |-| Tight Leading/Caption1/Emphasized Italic | SF Pro Medium Italic | 12 | 16px | 0px |-| Tight Leading/Caption2/Regular | SF Pro Regular | 11 | 13px | 0.06px |-| Tight Leading/Caption2/Emphasized | SF Pro Semibold | 11 | 13px | 0.06px |-| Tight Leading/Caption2/Italic | SF Pro Regular Italic | 11 | 13px | 0.06px |-| Tight Leading/Caption2/Emphasized Italic | SF Pro Semibold Italic | 11 | 13px | 0.06px |-| Loose Leading/Large Title/Regular | SF Pro Regular | 34 | 41px | 0.4px |-| Loose Leading/Large Title/Emphasized | SF Pro Bold | 34 | 41px | 0.4px |-| Loose Leading/Emphasized | SF Pro Bold | 34 | 41px | 0.4px |-| Loose Leading/Title 1/Regular | SF Pro Regular | 28 | 34px | 0.38px |-| Loose Leading/Title 1/Emphasized | SF Pro Bold | 28 | 34px | 0.38px |-| Loose Leading/Title 2/Regular | SF Pro Regular | 22 | 28px | -0.26px |-| Loose Leading/Title 2/Emphasized | SF Pro Bold | 22 | 28px | -0.26px |-| Loose Leading/Title 3/Regular | SF Pro Regular | 20 | 25px | -0.45px |-| Loose Leading/Title 3/Emphasized | SF Pro Semibold | 20 | 25px | -0.45px |-| Loose Leading/Headline/Regular | SF Pro Semibold | 17 | 22px | -0.43px |-| Loose Leading/Headline/Italic | SF Pro Semibold Italic | 17 | 22px | -0.43px |-| Loose Leading/Body/Regular | SF Pro Regular | 17 | 22px | -0.43px |-| Loose Leading/Body/Emphasized | SF Pro Semibold | 17 | 22px | -0.43px |-| Loose Leading/Body/Italic | SF Pro Regular Italic | 17 | 22px | -0.43px |-| Loose Leading/Body/Emphasized Italic | SF Pro Semibold Italic | 17 | 22px | -0.43px |-| Loose Leading/Callout/Regular | SF Pro Regular | 16 | 21px | -0.31px |-| Loose Leading/Callout/Emphasized | SF Pro Semibold | 16 | 21px | -0.31px |-| Loose Leading/Callout/Italic | SF Pro Regular Italic | 16 | 21px | -0.31px |-| Loose Leading/Callout/Emphasized Italic | SF Pro Semibold Italic | 16 | 21px | -0.31px |-| Loose Leading/Subheadline/Regular | SF Pro Regular | 15 | 20px | -0.23px |-| Loose Leading/Subheadline/Emphasized | SF Pro Semibold | 15 | 20px | -0.23px |-| Loose Leading/Subheadline/Italic | SF Pro Regular Italic | 15 | 20px | -0.23px |-| Loose Leading/Subheadline/Emphaized Italic | SF Pro Semibold Italic | 15 | 20px | -0.23px |-| Loose Leading/Footnote/Regular | SF Pro Regular | 13 | 18px | -0.08px |-| Loose Leading/Footnote/Emphasized | SF Pro Semibold | 13 | 18px | -0.08px |-| Loose Leading/Footnote/Italic | SF Pro Regular Italic | 13 | 18px | -0.08px |-| Loose Leading/Footnote/Emphasized Italic | SF Pro Semibold Italic | 13 | 18px | -0.08px |-| Loose Leading/Caption1/Regular | SF Pro Regular | 12 | 16px | 0px |-| Loose Leading/Caption1/Emphasized | SF Pro Medium | 12 | 16px | 0px |-| Loose Leading/Caption1/Italic | SF Pro Regular Italic | 12 | 16px | 0px |-| Loose Leading/Caption1/Emphasized Italic | SF Pro Medium Italic | 12 | 16px | 0px |-| Loose Leading/Caption2/Regular | SF Pro Regular | 11 | 13px | 0.06px |-| Loose Leading/Caption2/Emphasized | SF Pro Semibold | 11 | 13px | 0.06px |-| Loose Leading/Caption2/Italic | SF Pro Regular Italic | 11 | 13px | 0.06px |-| Loose Leading/Caption2/Emphasized Italic | SF Pro Semibold Italic | 11 | 13px | 0.06px |--## Effect styles (shadows, blurs)-- **Material Blur**: BACKGROUND_BLUR #00000040 x0 y4 blur50 spread0-- **Drop Shadow**: DROP_SHADOW #00000040 x0 y4 blur4 spread0; DROP_SHADOW #00000040 x0 y4 blur20 spread0--## Fill styles-- Colors/Red: #ff383c-- Colors/Red - Dark: #ff453a-- Colors/Orange: #ff8d28-- Colors/Orange - Dark: #ff9f0a-- Colors/Yellow: #ffcc00-- Colors/Yellow - Dark: #ffd60a-- Colors/Green: #34c759-- Colors/Green - Dark: #30d158-- Colors/Mint: #00c8b3-- Colors/Mint - Dark: #63e6e2-- Colors/Teal: #00c3d0-- Colors/Teal - Dark: #40cbe0-- Colors/Cyan: #00c0e8-- Colors/Cyan - Dark: #64d2ff-- Colors/Blue: #0088ff-- Colors/Blue - Dark: #0a84ff-- Colors/Indigo: #6155f5-- Colors/Indigo - Dark: #5e5ce6-- Colors/Purple: #cb30e0-- Colors/Purple - Dark: #bf5af2-- Colors/Pink: #ff2d55-- Colors/Pink - Dark: #ff375f-- Colors/Brown: #ac7f5e-- Colors/Brown - Dark: #ac8e68-- Labels/Primary: #000000-- Labels/Secondary: #3c3c4399-- Labels/Tertiary: #3c3c434d-- Labels/Quaternary: #3c3c432e-- Labels/Primary - Dark: #ffffff-- Labels/Secondary - Dark: #ebebf599-- Labels/Tertiary - Dark: #ebebf54d-- Labels/Quaternary - Dark: #ebebf529-- Grays/Black: #000000-- Grays/Black - Dark: #000000-- Grays/Gray: #8e8e93-- Grays/Gray - Dark: #8e8e93-- Grays/Gray 2: #aeaeb2-- Grays/Gray 2 - Dark: #636366-- Grays/Gray 3: #c7c7cc-- Grays/Gray 3 - Dark: #48484a-- Grays/Gray 4: #d1d1d6-- Grays/Gray 4 - Dark: #3a3a3c-- Grays/Gray 5: #e5e5ea-- Grays/Gray 5 - Dark: #2c2c2e-- Grays/Gray 6: #f2f2f7-- Grays/Gray 6 - Dark: #1c1c1e-- Grays/White: #ffffff-- Grays/White - Dark: #ffffff-- Backgrounds/Primary: #ffffff-- Backgrounds/Secondary: #f2f2f7-- Backgrounds/Tertiary: #ffffff-- Backgrounds/Primary - Dark Elevated: #1c1c1e-- Backgrounds/Primary - Dark Base: #000000-- Backgrounds/Secondary - Dark Elevated: #2c2c2e-- Backgrounds/Secondary - Dark Base: #1c1c1e-- Backgrounds/Tertiary - Dark Elevated: #3a3a3c-- Backgrounds/Tertiary - Dark Base: #2c2c2e-- Backgrounds Grouped/Primary: #f2f2f7-- Backgrounds Grouped/Primary - Dark Elevated: #1c1c1e-- Backgrounds Grouped/Primary - Dark Base: #000000-- Backgrounds Grouped/Secondary: #ffffff-- Backgrounds Grouped/Secondary - Dark Elevated: #2c2c2e-- Backgrounds Grouped/Secondary - Dark Base: #1c1c1e-- Backgrounds Grouped/Tertiary: #f2f2f7-- Backgrounds Grouped/Tertiary - Dark Elevated: #3a3a3c-- Backgrounds Grouped/Tertiary - Dark Base: #2c2c2e-- Fills/Primary: #78787833-- Fills/Primary - Dark: #7878805c-- Fills/Secondary - Dark: #78788052-- Fills/Secondary: #78788029-- Fills/Tertiary - Dark: #7676803d-- Fills/Tertiary: #7676801f-- Fills/Quaternary - Dark: #7474802e-- Fills/Quaternary: #74748014-- Separators/Opaque: #c6c6c8-- Separators/Opaque - Dark: #38383a-- Separators/Non-opaque: #0000001f-- Separators/Non-opaque - Dark: #545458a6-- Image: IMAGE-- Ultrathin: #171717, #ffffff33-- Materials (Delete Me!!!!) XXXXX/Thick: #ff0000f7-- Materials (Delete Me!!!!) XXXXX/Regular: #ff0000-- Materials (Delete Me!!!!) XXXXX/Thin: #ff0000-- Materials (Delete Me!!!!) XXXXX/Ultrathin: #ff0000-- Materials (Delete Me!!!!) XXXXX/Thick - Dark: #ff0000-- Materials (Delete Me!!!!) XXXXX/Regular - Dark: #ff0000-- Materials (Delete Me!!!!) XXXXX/Thin - Dark: #ff0000-- Materials (Delete Me!!!!) XXXXX/Ultrathin - Dark: #ff0000-- Materials (Delete Me!!!!) XXXXX/Chrome: #ff0000bf-- Materials (Delete Me!!!!) XXXXX/Chrome - Dark: #ff0000bf-- Vibrant Labels/Light/Vibrant Primary: #000000-- Vibrant Labels/Light/Vibrant Secondary: #7f7f7f80, #3d3d3d-- Vibrant Labels/Light/Vibrant Tertiary: #7f7f7f66, #3d3d3d80-- Vibrant Labels/Light/Vibrant Quaternary: #7f7f7f33, #3d3d3d80-- Vibrant Labels/Vibrant Primary - Dark: #ffffff-- Vibrant Labels/Vibrant Secondary - Dark: #7f7f7f80, #c2c2c2-- Vibrant Labels/Vibrant Tertiary - Dark: #7f7f7f66, #c2c2c280-- Vibrant Labels/Vibrant Quaternary - Dark: #7f7f7f33, #c2c2c280-- Vibrant Fills/Dark/Vibrant Primary: #333333-- Vibrant Fills/Dark/Vibrant Secondary: #1f1f1f-- Vibrant Fills/Dark/Vibrant Tertiary: #121212-- Vibrant Fills/Vibrant Primary - Dark: #7f7f7f80, #c2c2c2-- Vibrant Fills/Vibrant Secondary - Dark: #7f7f7f66, #c2c2c280-- Vibrant Fills/Vibrant Tertiary - Dark: #7f7f7f33, #c2c2c280-- Materials/Thick - Dark: #252525e5, #7c7c7c-- _Template/Sheet Fill: #cccccc-- _Template/Component Fill: #8080804d-- _Template/Subcomponent Fill: #007aff4d-- _Template/Submcomponent Stroke: #007aff-- _Template/Guides/Layout Margin: #5ac8fa-- _Template/Guides/Safe Area: #4cd964-- Labels/Secondary: #3c3c4399-- Vibrant Labels/Dark/Vibrant Primary: #ffffff-- Vibrant Labels/Dark/Vibrant Secondary: #999999-- Vibrant Labels/Dark/Vibrant Tertiary: #404040-- Vibrant Labels/Dark/Vibrant Quaternary: #262626-- Vibrant Fills/Light/Vibrant Primary: #cccccc-- Vibrant Fills/Light/Vibrant Secondary: #e0e0e0-- Vibrant Fills/Light/Vibrant Tertiary: #ededed-- Colors/Gray: #98989d--## Components (by page): size, corner radius, padding, gap--### Colors (6)-- Mode=Light, Type=Color: 100×100-- _Swatch - Light and Dark: 160×160-- Mode=Dark, Type=Color: 100×100-- Mode=Light, Type=Label: 100×100-- Mode=Dark, Type=Label: 100×100-- _Swatch Grid: 659×370--### System (78)-- Mode=Light: 402×874-- Mode=Light: 1210×834-- Widgets=None: 402×874 VERTICAL pad 0/0/0/0 gap 0-- Device=iPhone, Orientation=Portrait: 402×34 VERTICAL pad 0/0/8/0 gap 0-- Device=iPad, Orientation=Portrait: 402×21 VERTICAL pad 0/0/7.75/0 gap 0-- Widgets=None: 1210×834 VERTICAL pad 0/0/0/0 gap 0-- Device=iPad, Orientation=Landscape: 402×21 VERTICAL pad 0/0/8/0 gap 0-- Device=iPhone, Orientation=Landscape: 402×21 VERTICAL pad 0/0/8/0 gap 0-- Lock Screen - iPad: 1210×834-- Lock Screen - iPhone: 402×874-- Mode=Light: 300×103-- _Dock - iPad: 740×153 HORIZONTAL pad 18/0/28/0 gap 0-- _Dock - iPhone: 402×140 HORIZONTAL pad 20/17/17/17 gap 0-- Widgets=Large: 402×874 VERTICAL pad 0/0/0/0 gap 0-- Widgets=Medium: 402×874 VERTICAL pad 0/0/0/0 gap 0-- Widgets=Small: 402×874 VERTICAL pad 0/0/0/0 gap 0-- Widgets=Extra Large: 1210×834 VERTICAL pad 0/0/0/0 gap 0-- Widgets=Large: 1210×834 VERTICAL pad 0/0/0/0 gap 0-- Widgets=Medium: 1210×834 VERTICAL pad 0/0/0/0 gap 0-- Widgets=Small: 1210×834 VERTICAL pad 0/0/0/0 gap 0-- Control Center - iPhone: 402×874-- On=True: 70×70-- On=False: 70×70-- On=True, Type=Toggle: 155×70 r100 HORIZONTAL pad 0/14/0/14 gap 8-- On=False, Type=Toggle: 155×70 r100 HORIZONTAL pad 0/14/0/14 gap 8-- On=True, Type=Menu: 155×70 r100 HORIZONTAL pad 0/14/0/14 gap 8-- On=False, Type=Menu: 155×70 r100 HORIZONTAL pad 0/14/0/14 gap 8-- On=False: 155×155 VERTICAL pad 14/14/14/14 gap 8-- On=True: 155×155 VERTICAL pad 14/14/17/14 gap 45-- Control Center - iPad: 1210×834-- On=True: 66×66-- On=False: 66×66-- On=False, Type=Menu: 142×66 HORIZONTAL pad 0/14/0/14 gap 8-- On=True, Type=Menu: 142×66 HORIZONTAL pad 0/14/0/14 gap 8-- On=False, Type=Toggle: 142×66 HORIZONTAL pad 0/14/0/14 gap 8-- On=True, Type=Toggle: 142×66 HORIZONTAL pad 0/14/0/14 gap 8-- On=False: 142×142 VERTICAL pad 14/13/17/13 gap 8-- On=True: 142×142 VERTICAL pad 14/13/17/13 gap 45-- Home Screen Quick Actions - iPhone: 402×874-- Home Screen Quick Actions - iPad: 1210×834-- _Home Screen Quick Actions: 250×350 r12 VERTICAL pad 10/0/8/0 gap 0-- _Controls - Lock Screen: 58×58 r100-- Mode=Light: 68×68 r12 VERTICAL pad 0/0/0/0 gap 4.5-- Mode=Dark: 68×68 r12 VERTICAL pad 0/0/0/0 gap 3.5-- Mode=Light, State=Default: 200×42 HORIZONTAL pad 2/26/2/26 gap 14-- Mode=Light: 250×38 HORIZONTAL pad 0/17/0/17 gap 0-- Mode=Light, State=Destructive: 200×42 HORIZONTAL pad 2/26/2/26 gap 14-- Mode=Dark, State=Destructive: 200×42 HORIZONTAL pad 2/26/2/26 gap 14-- Mode=Dark, State=Default: 200×42 HORIZONTAL pad 2/26/2/26 gap 14-- Mode=Light, Item=App,Selected=False, Selected=: 38×38 HORIZONTAL pad 10/10/10/10 gap 10-- Mode=Dark, Item=App, Selected=False: 38×38 HORIZONTAL pad 10/10/10/10 gap 10-- On=True: 66×66-- On=False: 66×66-- On=True: 66×66 r296-- On=False: 66×66 r296-- Mode=Dark: 402×874-- Mode=Dark: 1210×834-- Mode=Dark: 300×103-- Mode=Light, Item=App, Selected=True: 38×38 r8 HORIZONTAL pad 10/10/10/10 gap 10-- Mode=Dark, Item=App, Selected=True: 38×38 r8 HORIZONTAL pad 10/10/10/10 gap 10--### Color Pickers (11)-- Color Picker - iPhone: 402×874 VERTICAL pad 8/8/8/8 gap 0-- Size=Large, Selected=False: 36×36-- Size=Large, Selected=True: 36×36-- Size=Small, Selected=False: 28×28-- Size=Small, Selected=True: 28×28-- Color Picker - iPad: 402×691-- _Toolbar: 402×49 VERTICAL pad 0/0/5/0 gap 5-- Mode=Light: 24×44 r100 HORIZONTAL pad 0/4/0/4 gap 12-- Mode=Dark: 24×44 r100 HORIZONTAL pad 0/4/0/4 gap 12-- Mode=Light: 52×22 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark: 52×22 HORIZONTAL pad 0/0/0/0 gap 10--### Widgets (29)-- Size=Small: 165×165 r28-- Size=Medium: 350×164 r28-- Size=Large: 350×365 r28-- Size=Small: 136×136 r28-- Size=Medium: 300×136 r28-- Size=Large: 300×300 r28-- Size=Extra Large: 628×300 r28-- Lock Screen Widget / Circular / Open Gauge 2: 72×72 VERTICAL pad 7/7/7/7 gap 0-- Lock Screen Widget / Circular / Open Gauge: 72×72 HORIZONTAL pad 7/7/7/7 gap 0-- Lock Screen Widget / Circular / Stack 3 Rows: 72×72 HORIZONTAL pad 7/7/7/7 gap 0-- Lock Screen Widget - Inline: 327×26 VERTICAL pad 0/0/0/0 gap 0-- Lock Screen Widget - Modular with Bar: 162×72 HORIZONTAL pad 8/8/8/0 gap 3-- Lock Screen Widget - Rectangular with Chart: 162×72 VERTICAL pad 7/8/7/8 gap 12-- Lock Screen Widget - Rectangular Text Gauge: 160×72 VERTICAL pad 8/8/13/8 gap 0-- Lock Screen Widget - Tall Body with Icon: 162×72 VERTICAL pad 6/8/8/8 gap -3-- Lock Screen Widget - Tall Body: 162×72 VERTICAL pad 6/8/5/8 gap 4-- Lock Screen Widget - Modular Columns: 162×72 VERTICAL pad 8/8/6/8 gap -1-- Lock Screen Widget - Modular Table: 162×72 VERTICAL pad 0/6/0/6 gap 0-- Lock Screen Widget - Modular Standard: 162×72 VERTICAL pad 8/8/6/8 gap 1-- Lock Screen Widget - Modular List: 162×72 VERTICAL pad 0/8/0/8 gap 0-- Lock Screen Widget - Clock: 72×72 HORIZONTAL pad 7/7/7/7 gap 0-- Lock Screen Widget / Circular / Icon: 72×72 r100 HORIZONTAL pad 7/7/7/7 gap 0-- Lock Screen Widget / Circular / Stack 2 Rows - Icon and Label: 72×72 r100 HORIZONTAL pad 7/7/7/7 gap 0-- Lock Screen Widget / Circular / Stack 2 Rows - Labels: 72×72 r100 HORIZONTAL pad 7/7/7/7 gap 0-- Lock Screen Widget / Circular / Open Gauge 3: 72×72 HORIZONTAL pad 7/7/7/7 gap 0-- Lock Screen Widget / Circular / Closed Gauge: 72×72 VERTICAL pad 7/7/7/7 gap 0-- Lock Screen Widget/2x2/Clock Big (iPad Only): 162×162-- Lock Screen Widget/2x2/Date (iPad Only): 162×162-- Size=Extra Large: 350×566 r28--### Menus (48)-- Mode=Light: 160×29 HORIZONTAL pad 4/8/10/8 gap 10-- Mode=Light: 238×578 VERTICAL pad 10/0/10/0 gap 0-- Mode=Light, Destructive=False: 70×57 r20 VERTICAL pad 6/4/6/4 gap 5-- Mode=Light, Destructive=True: 70×57 r20 VERTICAL pad 6/4/6/4 gap 5-- Mode=Light: 160×21 VERTICAL pad 10/8/10/8 gap 0-- Mode=Light, State=Disabled, Open=False, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light, State=Default, Open=False, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Text Selection: 94×22-- Mode=Dark, Destructive=True: 70×57 r20 VERTICAL pad 6/4/6/4 gap 5-- Mode=Dark, Destructive=False: 70×57 r20 VERTICAL pad 6/4/6/4 gap 5-- Mode=Light, State=Default: 63×18 HORIZONTAL pad 0/16/0/0 gap 16-- Edit Menu: 232×44 r100 HORIZONTAL pad 0/4/0/20 gap 0-- Mode=Light, State=Destructive: 63×18 HORIZONTAL pad 0/16/0/0 gap 16-- Mode=Dark, State=Destructive: 63×18 HORIZONTAL pad 0/16/0/0 gap 16-- Mode=Dark, State=Default: 63×18 HORIZONTAL pad 0/16/0/0 gap 16-- Mode=Light, State=Destructive, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light, State=Disabled, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light, State=Default, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light, State=Destructive, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light, State=Disabled, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light, State=Default, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light: 36×36 r100-- Mode=Dark: 36×36 r100-- Mode=Light, State=Disabled, Open=True, Menu has Selection=False: 190×40 r100 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light, State=Default, Open=True, Menu has Selection=False: 190×40 r100 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Light: 40×28 r1-- Mode=Dark: 40×28 r1-- Mode=Dark, State=Destructive, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Disabled, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Default, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Destructive, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Disabled, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Default, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Disabled, Open=True, Menu has Selection=False: 190×40 r100 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Default, Open=True, Menu has Selection=False: 190×40 r100 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Disabled, Open=False, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark, State=Default, Open=False, Menu has Selection=False: 190×40 HORIZONTAL pad 0/8/0/6 gap 6-- Mode=Dark: 160×29 HORIZONTAL pad 4/8/10/8 gap 10-- Mode=Dark: 160×21 VERTICAL pad 10/8/10/8 gap 0-- Mode=Light, State=Disabled, Open=True, Menu has Selection=True: 190×40 r100 HORIZONTAL pad 0/8/0/36 gap 6-- Mode=Light, State=Default, Open=True, Menu has Selection=True: 190×40 r100 HORIZONTAL pad 0/8/0/36 gap 6-- Mode=Light, State=Disabled, Open=False, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/36 gap 6-- Mode=Light, State=Default, Open=False, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/36 gap 6-- Mode=Dark, State=Disabled, Open=True, Menu has Selection=True: 190×40 r100 HORIZONTAL pad 0/8/0/36 gap 6-- Mode=Dark, State=Default, Open=True, Menu has Selection=True: 190×40 r100 HORIZONTAL pad 0/8/0/36 gap 6-- Mode=Dark, State=Disabled, Open=False, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/36 gap 6-- Mode=Dark, State=Default, Open=False, Menu has Selection=True: 190×40 HORIZONTAL pad 0/8/0/36 gap 6-- Mode=Dark: 238×578 VERTICAL pad 10/0/10/0 gap 0--### Keyboards (299)-- Mode=Light, Type=2 Storey Punctuation: 82×74 r13 VERTICAL pad 4.5/0/4.5/0 gap 0-- Mode=Light, Type=2 Storey Lower: 82×74 r13 VERTICAL pad 6.5/0/6.5/0 gap 0-- Enabled=True: 28×28-- Enabled=False: 28×28-- Type=Lower Case: 402×332 VERTICAL pad 24/0/24/0 gap 0-- Mode=Light, Type=Number + ABC: 125×47 r8.5 VERTICAL pad 3/0/4/0 gap 4-- Mode=Light, Type=Number: 125×47 r8.5-- Mode=Light, Type=Delete: 125×47 r8.5-- Type=Number Pad: 402×308 r27 VERTICAL pad 24/7.670000076293945/74/7.666666507720947 gap 6-- Mode=Light: 300×25-- Type=Emoji: 402×392 r27 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Enabled=True: 24×22-- Mode=Light, Enabled=True: 24×22-- Mode=Light, Enabled=False: 24×22-- Mode=Light, Enabled=False: 24×22-- Mode=Light, Type=Lower Case: 50×43 r8.5-- Type=Default: 1210×428 r27 VERTICAL pad 6/13.5/30/13.5 gap 16-- Mode=Light, Type=Lowercase: 1210×332 VERTICAL pad 0/0/0/0 gap 12-- Mode=Light: 116×28 HORIZONTAL pad 0/0/0/0 gap 16-- Type=Shift: 1210×428 r27 VERTICAL pad 6/13.5/30/13.5 gap 16-- Property 1=Light, Property 2=Uppercase: 1210×332 VERTICAL pad 0/0/0/0 gap 12-- Mode=Light, Type=1 Story Punctuation: 82×74 r13 HORIZONTAL pad 0.5/0/0.5/0 gap 0-- Mode=Light, Type=2 Storey Upper: 82×74 r13 VERTICAL pad 6.5/0/6.5/0 gap 4-- Mode=Light, Align=Left: 105×74 r13 HORIZONTAL pad 0/13/12.5/13 gap 0-- Mode=Light, Align=Right: 105×74 r13 HORIZONTAL pad 0/13/12.5/13 gap 0-- Mode=Light, Prominent=True: 105×74 r13 HORIZONTAL pad 0/12.5/10/0 gap 0-- Mode=Light, Prominent=False: 105×74 r13 HORIZONTAL pad 0/12.5/10/0 gap 0-- Mode=Light: 200×200 r27 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark: 200×200 r27-- Mode=Light, Type=Symbol: 50×43 r8.5-- Mode=Light, Type=Return - Default: 50×43 r8.5-- Mode=Light, Type=Return - Prominent: 50×43 r8.5-- Mode=Light, Type=Punctuation: 50×43 r8.5-- Mode=Light, Type=Upper Case: 50×43 r8.5-- Mode=Light, Type=Special Charaters (not capitalized): 50×43 r8.5-- Mode=Light, Type=Keyboard Switch - 123: 50×43 r8.5-- Mode=Light, Type=Keyboard Switch - ABC: 50×43 r8.5-- Mode=Light, Type=Number and Punctuation Switch - #+: 50×43 r8.5-- Mode=Light, Type=Number and Punctuation Switch - 123: 50×43 r8.5-- Property 1=Dark, Property 2=Uppercase: 1210×332 VERTICAL pad 0/0/0/0 gap 12-- Mode=Dark, Type=Lowercase: 1210×332 VERTICAL pad 0/0/0/0 gap 12-- Mode=Dark, Type=Upper Case: 50×43 r8.5-- Mode=Dark, Type=Lower Case: 50×43 r8.5-- Mode=Dark, Type=Punctuation: 50×43 r8.5-- Mode=Dark, Type=Special Charaters (not capitalized): 50×43 r8.5-- Mode=Dark, Type=Symbol: 50×43 r8.5-- Mode=Dark, Type=Return - Default: 50×43 r8.5-- Mode=Dark, Type=Return - Prominent: 50×43 r8.5-- Mode=Dark, Type=Keyboard Switch - 123: 50×43 r8.5-- Mode=Dark, Type=Keyboard Switch - ABC: 50×43 r8.5-- Mode=Dark, Type=Number and Punctuation Switch - #+: 50×43 r8.5-- Mode=Dark, Type=Number and Punctuation Switch - 123: 50×43 r8.5-- Mode=Dark, Type=Delete: 125×47 r8.5-- Mode=Dark, Type=Number + ABC: 125×47 r8.5 VERTICAL pad 3/0/4/0 gap 4-- Mode=Dark, Type=Number: 125×47 r8.5-- Mode=Dark, Prominent=True: 105×74 r13 HORIZONTAL pad 0/12.5/10/0 gap 0-- Mode=Dark, Prominent=False: 105×74 r13 HORIZONTAL pad 0/12.5/10/0 gap 0-- Mode=Dark, Type=2 Storey Lower: 82×74 r13 VERTICAL pad 6.5/0/6.5/0 gap 0-- Mode=Dark, Type=2 Storey Upper: 82×74 r13 VERTICAL pad 6.5/0/6.5/0 gap 4-- Mode=Dark, Type=2 Storey Punctuation: 82×74 r13 VERTICAL pad 4.5/0/4.5/0 gap 0--### Notifications (9)-- Stack=1: 386×66 r24 HORIZONTAL pad 14/14/14/14 gap 10-- Notification - Collapsed - List: 402×337 r5 VERTICAL pad 16/14/16/14 gap 8-- Notification - Expanded: 402×552 VERTICAL pad 0/16/68/16 gap 10-- Stack=2: 386×71 r24 HORIZONTAL pad 12/14/21/14 gap 10-- Mode=Light: 51×20 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark: 51×20 HORIZONTAL pad 0/0/0/0 gap 10-- Stack=3: 386×77 r24 HORIZONTAL pad 12/14/27/14 gap 10-- Mode=Dark: 100×100 r30-- Mode=Light: 100×100 r30--### Popovers (12)-- Edge=Top (Center): 200×200-- Edge=Bottom (Center): 200×200-- Edge=Leading (Top): 200×200-- Edge=Bottom (Trailing): 200×200-- Edge=Trailing (Top): 200×200-- Edge=Top (Trailing): 200×200-- Edge=Bottom (Leading): 200×200-- Edge=Top (Leading): 200×200-- Edge=Trailing (Middle): 200×200-- Edge=Leading (Middle): 200×200-- Edge=Trailing (Bottom): 200×200-- Edge=Leading (Bottom): 200×200--### Toolbars (141)-- Style=Default: 402×54 HORIZONTAL pad 0/16/10/16 gap 0-- Type=Buttons: 402×84 HORIZONTAL pad 4/28/32/28 gap 0-- Mode=Light,State=Disabled: 36×36 r100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, State=Selected: 36×36 r100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light,State=Tinted: 36×36 r100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light,State=Default: 36×36 r100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light,State=Disabled: 57×36 r100 HORIZONTAL pad 0/6/0/6 gap 0-- Mode=Light,State=Tinted: 57×36 r100 HORIZONTAL pad 0/6/0/6 gap 0-- Mode=Light,State=Default: 57×36 r100 HORIZONTAL pad 0/6/0/6 gap 0-- Mode=Light,State=Disabled: 36×36 r100 HORIZONTAL pad 0/8/0/8 gap 2-- Mode=Light,State=Default: 36×36 r100 HORIZONTAL pad 0/8/0/8 gap 2-- Mode=Light, State=Selected: 57×36 r100 HORIZONTAL pad 0/6/0/6 gap 0-- Type=Text: 73×44 r296 HORIZONTAL pad 0/8/0/8 gap 12-- Type=Button Group: 160×44 r296 HORIZONTAL pad 0/6/0/6 gap 0-- Type=Symbol: 44×44 r296 HORIZONTAL pad 0/4/0/4 gap 20-- Type=Back: 44×44 r296 HORIZONTAL pad 0/2/0/2 gap 12-- Type=Symbol - Prominent: 44×44 r296 HORIZONTAL pad 0/4/0/4 gap 20-- Type=Text - Prominent: 73×44 r296 HORIZONTAL pad 0/8/0/8 gap 12-- Type=Search: 402×84 HORIZONTAL pad 4/28/32/28 gap 0-- Type=Search + Trailing Item: 402×84 HORIZONTAL pad 4/28/32/28 gap 12-- Type=Search + Leading Item: 402×84 HORIZONTAL pad 4/28/32/28 gap 12-- Type=Search with Focus: 402×84 HORIZONTAL pad 4/28/32/28 gap 12-- Mode=Light, State=Placeholder: 190×48 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Light, State=Typing: 190×48 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Style=Compact Large: 402×54 HORIZONTAL pad 0/16/10/16 gap 5-- Style=Title 2 Line: 402×54 HORIZONTAL pad 0/16/10/16 gap 10-- Style=Title 2 Line Left: 402×54 HORIZONTAL pad 0/16/10/16 gap 10-- Style=Large Title: 402×125 VERTICAL pad 0/0/10/0 gap 10-- Mode=Light, State=Value: 190×48 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Style=Title 2 Line, Tab Bar=False: 820×54 HORIZONTAL pad 0/10/10/10 gap 0-- Style=Title 2 Line Left, Tab Bar=False: 820×54 HORIZONTAL pad 0/10/10/10 gap 0-- Style=Large Title, Tab Bar=False: 820×131 VERTICAL pad 0/10/10/10 gap 10-- Style=Compact Large, Tab Bar=False: 820×54 HORIZONTAL pad 0/10/10/10 gap 0-- Mode=Dark, State=Typing: 190×44 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Dark, State=Value: 190×44 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Dark, State=Placeholder: 190×44 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Dark, State=Disabled: 36×36 r100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, State=Selected: 36×36 r100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, State=Tinted: 36×36 r100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, State=Default: 36×36 r100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, State=Disabled: 57×36 r100 HORIZONTAL pad 0/6/0/6 gap 0-- Mode=Dark, State=Tinted: 57×36 r100 HORIZONTAL pad 0/6/0/6 gap 0-- Mode=Dark, State=Selected: 57×36 r100 HORIZONTAL pad 0/6/0/6 gap 0-- Mode=Dark, State=Default: 57×36 r100 HORIZONTAL pad 0/6/0/6 gap 0-- Mode=Dark,State=Disabled: 36×36 r100 HORIZONTAL pad 0/8/0/8 gap 2-- Mode=Dark,State=Default: 36×36 r100 HORIZONTAL pad 0/8/0/8 gap 2-- Mode=Dark, State=Typing: 190×48 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Dark, State=Value: 190×48 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Dark, State=Placeholder: 190×48 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Light, State=Typing: 190×44 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Light, State=Value: 190×44 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Mode=Light, State=Placeholder: 190×44 r296 HORIZONTAL pad 0/10/0/11 gap 4-- Type=Text - Prominent, Preferred Axis=Horizontal: 69×48 r296 HORIZONTAL pad 0/6/0/6 gap 12-- Type=Text, Preferred Axis=Horizontal: 69×48 r296 HORIZONTAL pad 0/6/0/6 gap 12-- Type=Button Group, Preferred Axis=Horizontal: 164×48 r296 HORIZONTAL pad 0/10/0/10 gap 0-- Type=Symbol, Preferred Axis=Horizontal: 48×48 r296 HORIZONTAL pad 0/6/0/6 gap 18-- Type=Symbol - Prominent, Preferred Axis=Horizontal: 48×48 r296 HORIZONTAL pad 0/6/0/6 gap 18-- Style=Title 2 Line Left, Tab Bar=True: 820×98 VERTICAL pad 0/10/10/10 gap 6-- Style=Title 2 Line, Tab Bar=True: 820×103 VERTICAL pad 0/10/10/10 gap 11-- Style=Large Title, Tab Bar=True: 820×131 VERTICAL pad 0/10/10/10 gap 10--### Tab Bars (73)-- Minimized=False, Tabs=2, Type=Default: 402×95 HORIZONTAL pad 16/111/25/111 gap 0-- Tab Bar - iPad: 491×44 HORIZONTAL pad 4/4/4/4 gap 0-- Mode=Light, Selected=True: 72×54-- Mode=Light, Selected=False: 72×54 VERTICAL pad 6/8/7/8 gap 0.5-- Mode=Light, Is Selected=True: 54×54 VERTICAL pad 6/8/7/8 gap 1-- Minimized=False, Tabs=2, Type=Search Role: 402×95 HORIZONTAL pad 16/25/25/25 gap 16-- Mode=Light, Is Selected=False: 54×54 VERTICAL pad 6/8/7/8 gap 1-- Mode=Dark, Selected=True: 72×54-- Mode=Dark, Selected=False: 72×54 VERTICAL pad 6/8/7/8 gap 1-- Mode=Dark, Is Selected=True: 54×54 VERTICAL pad 6/8/7/8 gap 1-- Mode=Dark, Is Selected=False: 54×54 VERTICAL pad 6/8/7/8 gap 1-- Mode=Light, Selected=True: 77×36 r100 HORIZONTAL pad 8/18/8/18 gap 10-- Mode=Light, Selected=False: 75×36 HORIZONTAL pad 8/18/8/18 gap 10-- Mode=Dark, Selected=False: 75×36 HORIZONTAL pad 8/18/8/18 gap 10-- Mode=Dark, Selected=True: 77×36 r100 HORIZONTAL pad 8/18/8/18 gap 10-- Mode=Light, Selected=False: 54×36 HORIZONTAL pad 8/16/8/16 gap 0-- Mode=Light, Selected=True: 54×36 r100 VERTICAL pad 8/16/8/16 gap 0-- Mode=Dark,Selected=False, Selected=: 54×36 HORIZONTAL pad 8/16/8/16 gap 0-- Mode=Dark,Selected=True, Selected=: 54×36 r100 HORIZONTAL pad 8/16/8/16 gap 0-- Minimized=True, Tabs=2, Type=Default: 402×88 HORIZONTAL pad 16/32/32/32 gap 0-- Minimized=True, Tabs=2, Type=Search Role: 402×88 HORIZONTAL pad 16/32/32/32 gap 16-- Minimized=False, Tabs=2, Type=Prominent Tab: 402×95 HORIZONTAL pad 16/25/25/25 gap 16-- Minimized=True, Tabs=2, Type=Prominent Tab: 402×88 HORIZONTAL pad 16/32/32/32 gap 16-- Minimized=True, Tabs=3, Type=Default: 402×88 HORIZONTAL pad 16/32/32/32 gap 0-- Minimized=True, Tabs=3, Type=Search Role: 402×88 HORIZONTAL pad 16/32/32/32 gap 16-- Minimized=True, Tabs=3, Type=Prominent Tab: 402×88 HORIZONTAL pad 16/32/32/32 gap 16-- Minimized=False, Tabs=3, Type=Default: 402×95 HORIZONTAL pad 16/68/25/68 gap 0-- Minimized=False, Tabs=3, Type=Search Role: 402×95 HORIZONTAL pad 16/25/25/25 gap 16-- Minimized=False, Tabs=3, Type=Prominent Tab: 402×95 HORIZONTAL pad 16/25/25/25 gap 16-- Minimized=False, Tabs=4, Type=Prominent Tab: 402×95 HORIZONTAL pad 16/25/25/25 gap 16-- Minimized=True, Tabs=4, Type=Default: 402×88 HORIZONTAL pad 16/32/32/32 gap 0-- Minimized=True, Tabs=4, Type=Search Role: 402×88 HORIZONTAL pad 16/32/32/32 gap 16-- Minimized=True, Tabs=4, Type=Prominent Tab: 402×88 HORIZONTAL pad 16/32/32/32 gap 16-- Minimized=False, Tabs=4, Type=Default: 402×95 HORIZONTAL pad 16/25/25/25 gap 0-- Minimized=False, Tabs=4, Type=Search Role: 402×95 HORIZONTAL pad 16/25/25/25 gap 16-- Minimized=True, Tabs=5, Type=Default: 402×88 HORIZONTAL pad 16/32/32/32 gap 0-- Minimized=True, Tabs=5, Type=Search Role: 402×88 HORIZONTAL pad 16/32/32/32 gap 16-- Minimized=True, Tabs=5, Type=Prominent Tab: 402×88 HORIZONTAL pad 16/32/32/32 gap 16-- Minimized=False, Tabs=5, Type=Default: 402×95 HORIZONTAL pad 16/25/25/25 gap 0-- Minimized=False, Tabs=5, Type=Search Role: 402×95 HORIZONTAL pad 16/25/25/25 gap 16-- Minimized=False, Tabs=5, Type=Prominent Tab: 402×95 HORIZONTAL pad 16/25/25/25 gap 16-- Minimized=False, Tabs=2, Type=Default: 48×110 VERTICAL pad 6/0/6/0 gap 2-- Minimized=True, Tabs=2, Type=Default: 48×48 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=3, Type=Default: 48×177 VERTICAL pad 6/0/6/0 gap 2-- Minimized=True, Tabs=3, Type=Default: 48×48 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=4, Type=Default: 48×210 VERTICAL pad 6/0/6/0 gap 2-- Minimized=True, Tabs=4, Type=Default: 48×48 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=5, Type=Default: 48×260 VERTICAL pad 6/0/6/0 gap 2-- Minimized=True, Tabs=5, Type=Default: 48×48 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=2, Type=Search Role: 48×120 VERTICAL pad 0/0/0/0 gap 12-- Minimized=True, Tabs=2, Type=Search Role: 48×108 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=3, Type=Search Role: 48×170 VERTICAL pad 0/0/0/0 gap 12-- Minimized=True, Tabs=3, Type=Search Role: 48×108 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=4, Type=Search Role: 48×220 VERTICAL pad 0/0/0/0 gap 12-- Minimized=True, Tabs=4, Type=Search Role: 48×108 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=5, Type=Search Role: 48×270 VERTICAL pad 0/0/0/0 gap 12-- Minimized=True, Tabs=5, Type=Search Role: 48×108 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=2, Type=Prominent Tab: 48×120 VERTICAL pad 0/0/0/0 gap 12-- Minimized=True, Tabs=2, Type=Prominent Tab: 48×108 VERTICAL pad 0/0/0/0 gap 12-- Minimized=False, Tabs=3, Type=Prominent Tab: 48×170 VERTICAL pad 0/0/0/0 gap 12--### Buttons (176)-- Size=Large, Style=Bordered - Prominent, Label Style=Title only, Is Enabled=True, Destructive=False: 73×50 r1000 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Medium, Style=Bordered - Prominent, Label Style=Title only, Is Enabled=True, Destructive=False: 57×34 r1000 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Medium, Style=Bordered - Prominent, Label Style=Title only, Is Enabled=False, Destructive=False: 57×34 r1000 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Small, Style=Bordered - Prominent, Label Style=Title only, Is Enabled=True, Destructive=False: 49×28 r1000 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Small, Style=Bordered - Prominent, Label Style=Title only, Is Enabled=False, Destructive=False: 49×28 r1000 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Large, Style=Bordered, Label Style=Title only, Is Enabled=True, Destructive=False: 73×50 r1000 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Large, Style=Bordered, Label Style=Title only, Is Enabled=False, Destructive=False: 73×50 r1000 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Medium, Style=Bordered, Label Style=Title only, Is Enabled=True, Destructive=False: 57×34 r1000 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Medium, Style=Bordered, Label Style=Title only, Is Enabled=False, Destructive=False: 57×34 r1000 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Small, Style=Bordered, Label Style=Title only, Is Enabled=True, Destructive=False: 49×28 r1000 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Small, Style=Bordered, Label Style=Title only, Is Enabled=False, Destructive=False: 49×28 r1000 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Large, Style=Borderless, Label Style=Title only, Is Enabled=True, Destructive=False: 73×50 r12 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Large, Style=Borderless, Label Style=Title only, Is Enabled=False, Destructive=False: 73×50 r12 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Medium, Style=Borderless, Label Style=Title only, Is Enabled=True, Destructive=False: 57×34 r40 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Medium, Style=Borderless, Label Style=Title only, Is Enabled=False, Destructive=False: 57×34 r40 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Small, Style=Borderless, Label Style=Title only, Is Enabled=True, Destructive=False: 49×28 r40 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Small, Style=Borderless, Label Style=Title only, Is Enabled=False, Destructive=False: 49×28 r40 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Small, Style=Borderless, Label Style=Icon only, Is Enabled=True, Destructive=False: 28×28 r500-- Size=Medium, Style=Borderless, Label Style=Icon only, Is Enabled=True, Destructive=False: 34×34 r500-- Size=Small, Style=Borderless, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 66×28 r40 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Medium, Style=Borderless, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 75×34 r40 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Large, Style=Borderless, Label Style=Icon only, Is Enabled=True, Destructive=False: 50×50 r500-- Size=Large, Style=Borderless, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 92×50 r12 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Small, Style=Borderless, Label Style=Icon only, Is Enabled=False, Destructive=False: 28×28 r500-- Size=Small, Style=Borderless, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 66×28 r40 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Medium, Style=Borderless, Label Style=Icon only, Is Enabled=False, Destructive=False: 34×34 r500-- Size=Medium, Style=Borderless, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 75×34 r40 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Large, Style=Borderless, Label Style=Icon only, Is Enabled=False, Destructive=False: 50×50 r500-- Size=Large, Style=Borderless, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 92×50 r12 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Small, Style=Bordered, Label Style=Icon only, Is Enabled=True, Destructive=False: 28×28 r500-- Size=Small, Style=Bordered, Label Style=Icon only, Is Enabled=False, Destructive=False: 28×28 r500-- Size=Small, Style=Bordered, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 66×28 r1000 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Small, Style=Bordered, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 66×28 r1000 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Medium, Style=Bordered, Label Style=Icon only, Is Enabled=True, Destructive=False: 34×34 r500-- Size=Medium, Style=Bordered, Label Style=Icon only, Is Enabled=False, Destructive=False: 34×34 r500-- Size=Medium, Style=Bordered, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 75×34 r1000 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Medium, Style=Bordered, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 75×34 r1000 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Large, Style=Bordered, Label Style=Icon only, Is Enabled=True, Destructive=False: 50×50 r500-- Size=Large, Style=Bordered, Label Style=Icon only, Is Enabled=False, Destructive=False: 50×50 r500-- Size=Large, Style=Bordered, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 92×50 r1000 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Large, Style=Bordered, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 92×50 r1000 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Small, Style=Bordered - Prominent, Label Style=Icon only, Is Enabled=True, Destructive=False: 28×28 r500-- Size=Small, Style=Bordered - Prominent, Label Style=Icon only, Is Enabled=False, Destructive=False: 28×28 r500-- Size=Small, Style=Bordered - Prominent, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 66×28 r1000 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Small, Style=Bordered - Prominent, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 66×28 r1000 HORIZONTAL pad 4/10/4/10 gap 3-- Size=Medium, Style=Bordered - Prominent, Label Style=Icon only, Is Enabled=True, Destructive=False: 34×34 r500-- Size=Medium, Style=Bordered - Prominent, Label Style=Icon only, Is Enabled=False, Destructive=False: 34×34 r500-- Size=Medium, Style=Bordered - Prominent, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 75×34 r1000 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Medium, Style=Bordered - Prominent, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 75×34 r1000 HORIZONTAL pad 7/14/7/14 gap 4-- Size=Large, Style=Bordered - Prominent, Label Style=Icon only, Is Enabled=True, Destructive=False: 50×50 r500-- Size=Large, Style=Bordered - Prominent, Label Style=Icon only, Is Enabled=False, Destructive=False: 50×50 r500-- Size=Large, Style=Bordered - Prominent, Label Style=Title and Icon, Is Enabled=True, Destructive=False: 92×50 r1000 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Large, Style=Bordered - Prominent, Label Style=Title and Icon, Is Enabled=False, Destructive=False: 92×50 r1000 HORIZONTAL pad 14/20/14/20 gap 4-- Size=Large, Style=Borderless, Label Style=Icon only, Is Enabled=False, Destructive=True: 50×50 r500-- Size=Medium, Style=Borderless, Label Style=Icon only, Is Enabled=False, Destructive=True: 34×34 r500-- Size=Small, Style=Borderless, Label Style=Icon only, Is Enabled=False, Destructive=True: 28×28 r500-- Size=Large, Style=Borderless, Label Style=Icon only, Is Enabled=True, Destructive=True: 50×50 r500-- Size=Medium, Style=Borderless, Label Style=Icon only, Is Enabled=True, Destructive=True: 34×34 r500-- Size=Small, Style=Borderless, Label Style=Icon only, Is Enabled=True, Destructive=True: 28×28 r500-- Size=Large, Style=Borderless, Label Style=Title only, Is Enabled=False, Destructive=True: 73×50 r12 HORIZONTAL pad 14/20/14/20 gap 4--### Progress Indicators (14)-- Value=100%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=90%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=80%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=70%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=60%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=50%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=40%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=30%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=20%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=10%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Value=0%: 402×44 VERTICAL pad 20/16/20/16 gap 3-- Size=Regular: 20×20 HORIZONTAL pad 0/0/0/0 gap 8-- Size=Small: 14×14 HORIZONTAL pad 0/0/0/0 gap 4-- Size=Large: 35×35 HORIZONTAL pad 0/0/0/0 gap 8--### Lists (49)-- State=Unselected: 25×22 HORIZONTAL pad 0/1/0/2 gap 10-- State=Remove: 25×22 HORIZONTAL pad 0/1/0/2 gap 10-- State=Add: 25×22 HORIZONTAL pad 0/1/0/2 gap 0-- State=Selected: 25×22 HORIZONTAL pad 0/1/0/2 gap 0-- Type=Fill: 52×52 VERTICAL pad 0/0/0/0 gap 0-- Type=Circular: 42×42 r100 VERTICAL pad 0/0/0/0 gap 0-- Type=Rounded: 30×30 VERTICAL pad 0/0/0/0 gap 0-- _Swipe Actions/Symbol and Label Stacked: 60×68 r100 VERTICAL pad 6/0/6/0 gap 5-- _Swipe Actions/Symbol only: 60×44 r100 HORIZONTAL pad 12/8/12/8 gap 10-- Type=Default: 182×22 HORIZONTAL pad 0/0/0/0 gap 16-- Type=Stepper: 92×32 HORIZONTAL pad 0/0/0/0 gap 0-- Type=Toggle: 64×28 HORIZONTAL pad 0/0/0/0 gap 0-- Type=Button: 52×16 HORIZONTAL pad 0/0/0/0 gap 0-- Type=Picker - Date: 106×34 HORIZONTAL pad 0/0/0/0 gap 0-- Type=Picker - Time: 86×34 HORIZONTAL pad 0/0/0/0 gap 8-- Type=Picker - Date and Time: 198×34 HORIZONTAL pad 0/0/0/0 gap 6-- Type=Pop-up: 97×22 HORIZONTAL pad 0/16/0/0 gap 10-- Type=Disclosure: 64×32 HORIZONTAL pad 0/0/0/0 gap 12-- Type=Symbol: 28×20 VERTICAL pad 0/0/0/0 gap 0-- Grouped Table Footer: 300×32 VERTICAL pad 8/16/6/16 gap 0-- Type=Disclosure Open: 63×22 HORIZONTAL pad 0/0/0/0 gap 4-- Device=iPad: 30×700 VERTICAL pad 0/0/0/0 gap 9-- Device=iPhone: 16×700 VERTICAL pad 0/0/0/0 gap -2-- Section Title: 300×39 HORIZONTAL pad 0/16/0/16 gap 10-- Type=Symbol: 28×20 VERTICAL pad 0/0/0/0 gap 0-- Type=Rounded: 44×44 VERTICAL pad 0/0/0/0 gap 0-- Type=Circular: 60×60 r100 VERTICAL pad 0/0/0/0 gap 0-- Type=Fill: 68×68 VERTICAL pad 0/0/0/0 gap 0-- Type=Extra Prominent: 402×48 HORIZONTAL pad 10/16/10/16 gap 0-- Type=Prominent: 402×45 HORIZONTAL pad 10/16/10/16 gap 0-- Type=Nested: 402×42 HORIZONTAL pad 10/16/10/16 gap 0-- Value=Disabled: 300×52 VERTICAL pad 0/16/1/16 gap 0-- Value=Destructive: 300×52 VERTICAL pad 0/16/1/16 gap 0-- Value=Default: 300×52 VERTICAL pad 0/16/1/16 gap 0-- Type=Symbol and Label Tall, Swipe=Right: 402×68 HORIZONTAL pad 0/16/0/16 gap 10-- Type=Symbol Only, Swipe=Right: 402×52 HORIZONTAL pad 0/16/0/16 gap 10-- Type=Symbol and Label Tall, Swipe=Left: 402×68 HORIZONTAL pad 0/16/0/0 gap 10-- Type=Symbol Only, Swipe=Left: 402×52 HORIZONTAL pad 0/16/0/0 gap 10-- Height=Tall: 300×68 HORIZONTAL pad 0/16/0/16 gap 0-- Height=Regular: 300×52 HORIZONTAL pad 0/16/0/16 gap 0-- Mode=Dark: 370×1-- Mode=Light: 370×1-- _Grabber: 34×25 VERTICAL pad 0/12/0/12 gap 10-- Type=Action: 45×20 HORIZONTAL pad 0/0/0/0 gap 4-- Type=Image: 42×42 r10 HORIZONTAL pad 0/0/0/0 gap 0-- Type=Button: 44×44-- _Swipe Actions/Symbol and Label: 84×44 r100 HORIZONTAL pad 12/4/12/4 gap 8-- Type=Symbol and Label, Swipe=Right: 402×52 HORIZONTAL pad 0/16/0/16 gap 10-- Type=Symbol and Label, Swipe=Left: 402×52 HORIZONTAL pad 0/16/0/0 gap 10--### Toggles (8)-- State=Idle, Is On=True, Is Enabled=True: 64×28 r100-- State=Idle, Is On=False, Is Enabled=True: 64×28 r100-- State=Pressed, Is On=False, Is Enabled=True: 64×28 r100-- State=Pressed, Is On=True, Is Enabled=True: 64×28 r100-- State=Idle, Is On=False, Is Enabled=False: 64×28 r100-- State=Idle, Is On=True, Is Enabled=False: 64×28 r100-- State=Pressed, Is On=False, Is Enabled=False: 64×28 r100-- State=Pressed, Is On=True, Is Enabled=False: 64×28 r100--### Date and Time Pickers (10)-- State=Default: 204×34 r6 HORIZONTAL pad 0/0/0/0 gap 6-- State=Default: 38×38-- State=Current: 38×38-- State=Selected: 38×38 r100-- State=Current and Selected: 38×38 r100-- _Week: 338×38 r5 HORIZONTAL pad 0/0/0/0 gap 0-- State=Null: 38×38-- Style=Inline: 370×377 VERTICAL pad 0/16/0/16 gap 0-- Style=Compact: 370×377 r13 VERTICAL pad 0/12/0/12 gap 0-- State=Selected: 204×34 r6 HORIZONTAL pad 0/0/0/0 gap 6--### Alerts (14)-- Button Layout=Stacked: 300×419 VERTICAL pad 14/14/14/14 gap 0-- Button Layout=Side-by-Side: 300×307 VERTICAL pad 14/14/14/14 gap 0-- Mode=Light, Role=None: 86×48 r100 HORIZONTAL pad 13/16/13/16 gap 10-- Mode=Light, Role=Default: 86×48 r100 HORIZONTAL pad 13/16/13/16 gap 10-- Mode=Light, Role=Destructive: 86×48 r100 HORIZONTAL pad 13/16/13/16 gap 10-- Mode=Dark, Role=Destructive: 86×48 r100 HORIZONTAL pad 13/16/13/16 gap 10-- Mode=Dark, Role=None: 86×48 r100 HORIZONTAL pad 13/16/13/16 gap 10-- Mode=Dark, Role=Default: 86×48 r100 HORIZONTAL pad 13/16/13/16 gap 10-- Mode=Dark: 160×52 r26 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light: 160×52 r26 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Role=Cancel: 86×48 r100 HORIZONTAL pad 13/16/13/16 gap 10-- Mode=Dark, Role=Cancel: 86×48 r100 HORIZONTAL pad 13/16/13/16 gap 10-- Text Field: 272×123 r26 VERTICAL pad 0/0/19/0 gap 10-- _Overlay - Alerts: 100×100 r20--### Face ID (2)-- State=Success: 402×190-- State=Authenticating: 402×190--### Contextual Menus (5)-- Alignment=Vertical, Side=Leading: 351×160-- Alignment=Vertical, Side=Trailing: 351×160-- Context Menu - Dimming Overlay: 200×200 r30-- Alignment=Horizontal (iPad only), Side=Trailing: 351×161-- Alignment=Horizontal (iPad only), Side=Leading: 351×161--### Activity Views (24)-- Mode=Light: 200×52 HORIZONTAL pad 0/16/0/16 gap 8-- Mode=Light, People=1: 66×102-- Mode=Light, People=2: 66×102-- Activity View - iPhone/Light: 402×1046 VERTICAL pad 62/0/62/0 gap 0-- Activity View - iPad/Light: 402×983-- Mode=Light: 48×48 HORIZONTAL pad 0/16/10/16 gap 10-- Mode=Dark: 48×48 HORIZONTAL pad 0/16/10/16 gap 10-- Mode=Dark: 108×34 r1000 HORIZONTAL pad 6/10/6/14 gap 4-- Mode=Light: 108×34 r1000 HORIZONTAL pad 6/10/6/14 gap 4-- Mode=Light: 402×133 HORIZONTAL pad 0/0/0/0 gap 16-- Mode=Dark: 200×52 HORIZONTAL pad 0/16/0/16 gap 8-- Mode=Dark: 402×133 HORIZONTAL pad 0/0/0/0 gap 16-- Overlay: 100×100 r30-- Mode=Dark: 200×1 HORIZONTAL pad 0/15/0/15 gap 0-- Mode=Light: 200×1 HORIZONTAL pad 0/15/0/15 gap 0-- _Apps: 500×101 HORIZONTAL pad 16/15/16/15 gap 25.33300018310547-- _Actions: 500×120 HORIZONTAL pad 16/15/16/15 gap 25.33300018310547-- Mode=Dark: 66×85-- Mode=Light: 66×85-- _Contacts: 500×118 HORIZONTAL pad 16/15/16/15 gap 25.33300018310547-- Mode=Dark, People=2: 66×102-- Mode=Dark, People=1: 66×102-- Mode=Dark: 66×104-- Mode=Light: 66×104--### Sidebars (76)-- Section Header: 260×54 HORIZONTAL pad 0/0/0/0 gap 0-- State=Default, Indent Level=0: 320×44 HORIZONTAL pad 0/8/0/10 gap 8-- State=Selected, Indent Level=0: 320×44 r100 HORIZONTAL pad 0/8/0/10 gap 8-- Floating Window=False: 320×802 VERTICAL pad 32/10/10/10 gap 0-- State=Default, Indent Level=1: 320×44 HORIZONTAL pad 0/8/0/30 gap 8-- State=Selected, Indent Level=1: 320×44 r100 HORIZONTAL pad 0/8/0/30 gap 8-- State=Selected, Indent Level=2: 320×44 r100 HORIZONTAL pad 0/8/0/50 gap 8-- State=Default, Indent Level=2: 320×44 HORIZONTAL pad 0/8/0/50 gap 8-- Mode=Light, State=Default, Image=Symbol: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Default, Image=Bitmap: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Default, Image=Collection: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- State=Disabled, Indent Level=2: 320×44 HORIZONTAL pad 0/8/0/50 gap 8-- State=Disabled, Indent Level=1: 320×44 HORIZONTAL pad 0/8/0/30 gap 8-- State=Disabled, Indent Level=0: 320×44 HORIZONTAL pad 0/8/0/10 gap 8-- Open=True: 18×18-- Open=False: 18×18-- Mode=Light, Type=Delete: 21×21 r100-- Mode=Light, State=Default, Type=Detail: 52×44 HORIZONTAL pad 0/8/0/0 gap 8-- Mode=Light, State=Default, Type=Disclosure: 70×44 HORIZONTAL pad 0/4/0/0 gap 4-- Mode=Light, State=Default, Type=Info: 82×44 HORIZONTAL pad 0/0/0/0 gap 6-- Mode=Light, State=Default, Type=Toggle: 64×44 HORIZONTAL pad 11/0/11/0 gap 8-- Mode=Light, State=Default, Type=Checkmark: 82×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Default, Type=Symbol: 86×44 HORIZONTAL pad 0/4/0/0 gap 8-- Mode=Light, State=Selected, Type=Detail: 54×44 HORIZONTAL pad 0/8/0/0 gap 8-- Mode=Light, State=Selected, Type=Checkmark: 84×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Selected, Type=Info: 84×44 HORIZONTAL pad 0/0/0/0 gap 6-- Mode=Light, State=Selected, Type=Disclosure: 76×44 HORIZONTAL pad 0/4/0/0 gap 8-- Mode=Light, State=Selected, Type=Symbol: 88×44 HORIZONTAL pad 0/4/0/0 gap 8-- Mode=Light, State=Selected, Type=Toggle: 64×44 HORIZONTAL pad 11/0/11/0 gap 8-- Mode=Light, State=Selected, Image=Collection: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Selected, Image=Bitmap: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Selected, Image=Symbol: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, Type=Selected: 21×21 r100-- Mode=Light, Type=Selectable: 21×21 r100-- Mode=Dark, Type=Selectable: 21×21 r100-- Mode=Dark, Type=Selected: 21×21 r100-- Mode=Dark, Type=Delete: 21×21 r100-- Mode=Dark, State=Selected, Image=Collection: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Selected, Image=Bitmap: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Selected, Image=Symbol: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Default, Image=Collection: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Default, Image=Bitmap: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Default, Image=Symbol: 85×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Selected, Type=Detail: 54×44 HORIZONTAL pad 0/8/0/0 gap 8-- Mode=Dark, State=Selected, Type=Checkmark: 84×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Selected, Type=Info: 84×44 HORIZONTAL pad 0/0/0/0 gap 6-- Mode=Dark, State=Selected, Type=Disclosure: 76×44 HORIZONTAL pad 0/4/0/0 gap 8-- Mode=Dark, State=Selected, Type=Symbol: 88×44 HORIZONTAL pad 0/4/0/0 gap 8-- Mode=Dark, State=Selected, Type=Toggle: 64×44 HORIZONTAL pad 11/0/11/0 gap 8-- Mode=Dark, State=Default, Type=Detail: 52×44 HORIZONTAL pad 0/8/0/0 gap 8-- Mode=Dark, State=Default, Type=Checkmark: 82×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Default, Type=Info: 82×44 HORIZONTAL pad 0/0/0/0 gap 6-- Mode=Dark, State=Default, Type=Disclosure: 74×44 HORIZONTAL pad 0/4/0/0 gap 8-- Mode=Dark, State=Default, Type=Symbol: 86×44 HORIZONTAL pad 0/4/0/0 gap 8-- Mode=Dark, State=Default, Type=Toggle: 64×44 HORIZONTAL pad 11/0/11/0 gap 8-- Mode=Light, State=Default, Image=Hidden: 34×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Default, Image=Hidden: 34×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Selected, Image=Hidden: 34×44 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Selected, Image=Hidden: 34×44 HORIZONTAL pad 0/0/0/0 gap 8-- State=Disclosable, Indent Level=2: 320×44 r100 HORIZONTAL pad 0/8/0/50 gap 8--### Pop-up Buttons (2)-- Is Enabled=True: 65×44 HORIZONTAL pad 13/0/13/0 gap 3-- Is Enabled=False: 65×44 HORIZONTAL pad 13/0/13/0 gap 3--### Product Bezels (36)-- Color=Silver: 1210×834-- Color=Silver: 1376×1034-- iPad mini: 1133×744-- Color=Deep Blue: 402×874-- Color=Cosmic Orange: 402×874-- Color=Silver: 402×874-- Color=Deep Blue: 440×956-- Color=Cosmic Orange: 440×956-- Color=Silver: 440×956-- Color=Cloud White: 420×912-- Color=Sky Blue: 420×912-- Color=Space Black: 420×912-- Color=Light Gold: 420×912-- Color=Black: 402×874-- Color=Lavendar: 402×874-- Color=Mist Blue: 402×874-- Color=Sage: 402×874-- Color=White: 402×874-- Color=Space Gray: 1210×834-- Color=Space Gray: 1376×1034-- Color=Black: 402×874-- Color=Burgundy: 402×874-- Color=Glacier: 402×874-- Color=Black: 440×956-- Color=Burgundy: 440×956-- Color=Glacier: 440×956-- Color=Silver: 402×874-- Color=Silver: 440×956-- Display=Inner, Color=Night Sky, Orientation=Portrait: 669×951-- Display=Outer, Color=Star White, Orientation=Portrait: 466×678-- Display=Outer, Color=Star White, Orientation=Landscape: 678×466-- Display=Inner, Color=Star White, Orientation=Portrait: 669×951-- Display=Inner, Color=Star White, Orientation=Landscape: 951×669-- Display=Outer, Color=Night Sky, Orientation=Portrait: 466×678-- Display=Outer, Color=Night Sky, Orientation=Landscape: 678×466-- Display=Inner, Color=Night Sky, Orientation=Landscape: 951×669--### Segmented Controls (6)-- Size=Small, Is Enabled=False: 370×32 r100 HORIZONTAL pad 0/0/0/0 gap 0-- Is Selected=False: 80×28 r1000 HORIZONTAL pad 3/6/3/6 gap 0-- Is Selected=True: 80×28 r1000 HORIZONTAL pad 3/6/3/6 gap 0-- Size=Large, Is Enabled=False: 370×50 r100 HORIZONTAL pad 0/0/0/0 gap 0-- Size=Small, Is Enabled=True: 370×32 r100 HORIZONTAL pad 0/0/0/0 gap 0-- Size=Large, Is Enabled=True: 370×50 r100 HORIZONTAL pad 0/0/0/0 gap 0--### Materials (44)-- Mode=Light, Style=Ultrathin: 100×100-- Mode=Light, Style=Thin: 100×100-- Mode=Light, Style=Regular: 100×100-- Mode=Light, Style=Thick: 100×100-- Mode=Light, Style=Chrome: 100×100 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Style=Chrome: 100×100-- Mode=Dark, Style=Thick: 100×100-- Mode=Dark, Style=Regular: 100×100-- Mode=Dark, Style=Thin: 100×100-- Mode=Dark, Style=Ultrathin: 100×100-- Style=Ultrathin: 100×100-- Style=Chrome: 100×100-- Style=Thick: 100×100-- Style=Regular: 100×100-- Style=Thin: 100×100-- Mode=IC - Dark, Style=Chrome: 100×100-- Mode=IC - Dark, Style=Thick: 100×100-- Mode=IC - Dark, Style=Regular: 100×100-- Mode=IC - Dark, Style=Thin: 100×100-- Mode=IC - Dark, Style=Ultrathin: 100×100-- Mode=IC - Light, Style=Chrome: 100×100 VERTICAL pad 0/0/0/0 gap 0-- Mode=IC - Light, Style=Thick: 100×100-- Mode=IC - Light, Style=Regular: 100×100-- Mode=IC - Light, Style=Thin: 100×100-- Mode=IC - Light, Style=Ultrathin: 100×100-- Mode=Dark, Active=True, Prominent=False: 48×48-- Mode=Dark, Active=True, Prominent=True: 48×48-- Mode=Light, Active=True, Prominent=True: 48×48-- Mode=Light, Active=True, Prominent=False: 48×48-- Mode=Light: 160×160-- Mode=Dark: 160×160-- Mode=Light: 160×160-- Mode=Dark: 160×160-- Edge=Top: 200×200-- Edge=Bottom: 200×200-- Mode=Light, Edge=Bottom: 200×200-- Mode=Light, Edge=Top: 200×200-- Liquid Glass - Clear: 160×160-- Mode=Dark, Active=False, Prominent=False: 48×48 r100-- Mode=Light, Active=False, Prominent=False: 48×48 r100-- Mode=Dark, Active=False, Prominent=True: 48×48 r100-- Mode=Light, Active=False, Prominent=True: 48×48 r100-- Mode=Dark,Edge=Bottom: 200×200-- Mode=Dark,Edge=Top: 200×200--### Sliders (20)-- _Knob - Idle: 2×24 r100-- State=Idle, Value=100%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Idle, Value=75%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Idle, Value=50%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Idle, Value=25%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- _Track: 282×6-- _Ticks: 282×4 HORIZONTAL pad 0/0/0/0 gap 16-- _Fill: 282×6-- State=Idle,Value=0%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Pressed, Value=100%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Pressed, Value=75%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Pressed, Value=50%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Pressed, Value=25%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Pressed, Value=0%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Disabled, Value=100%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Disabled, Value=75%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Disabled, Value=50%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Disabled, Value=25%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- State=Disabled, Value=0%: 400×52 VERTICAL pad 0/16/1/16 gap 0-- _Knob - Pressed: 2×24 r100--### Text Fields (4)-- State=Placeholder: 402×52 HORIZONTAL pad 0/16/0/16 gap 0-- State=Value Entered: 402×52 HORIZONTAL pad 0/16/0/16 gap 0-- State=Typing: 402×52 HORIZONTAL pad 0/16/0/16 gap 0-- State=Focused: 402×52 HORIZONTAL pad 0/16/0/16 gap 0--### App Icons (96)-- _Icon Grid: 256×256-- Icon=Weather, Mode=Default: 66×66-- Icon=Weather, Mode=Dark: 66×66-- Icon=Watch, Mode=Default: 66×66-- Icon=Watch, Mode=Dark: 66×66-- Icon=Wallet, Mode=Default: 66×66-- Icon=Wallet, Mode=Dark: 66×66-- Icon=Voice Memos, Mode=Default: 66×66-- Icon=Voice Memos, Mode=Dark: 66×66-- Icon=TV, Mode=Default: 66×66-- Icon=TV, Mode=Dark: 66×66-- Icon=Translate, Mode=Default: 66×66-- Icon=Translate, Mode=Dark: 66×66-- Icon=Stocks, Mode=Default: 66×66-- Icon=Stocks, Mode=Dark: 66×66-- Icon=Shortcuts, Mode=Default: 66×66-- Icon=Shortcuts, Mode=Dark: 66×66-- Icon=Settings, Mode=Default: 66×66-- Icon=Settings, Mode=Dark: 66×66-- Icon=Safari, Mode=Default: 66×66-- Icon=Safari, Mode=Dark: 66×66-- Icon=Reminders, Mode=Default: 66×66-- Icon=Reminders, Mode=Dark: 66×66-- Icon=Podcasts, Mode=Default: 66×66-- Icon=Podcasts, Mode=Dark: 66×66-- Icon=Photos, Mode=Default: 66×66-- Icon=Photos, Mode=Dark: 66×66-- Icon=Phone, Mode=Default: 66×66-- Icon=Phone, Mode=Dark: 66×66-- Icon=Pages, Mode=Default: 66×66-- Icon=Pages, Mode=Dark: 66×66-- Icon=Number, Mode=Default: 66×66-- Icon=Number, Mode=Dark: 66×66-- Icon=Notes, Mode=Default: 66×66-- Icon=Notes, Mode=Dark: 66×66-- Icon=News, Mode=Default: 66×66-- Icon=News, Mode=Dark: 66×66-- Icon=Music, Mode=Default: 66×66-- Icon=Music, Mode=Dark: 66×66-- Icon=Messages, Mode=Default: 66×66-- Icon=Messages, Mode=Dark: 66×66-- Icon=Measure, Mode=Default: 66×66-- Icon=Measure, Mode=Dark: 66×66-- Icon=Maps, Mode=Default: 66×66-- Icon=Maps, Mode=Dark: 66×66-- Icon=Mail, Mode=Default: 66×66-- Icon=Mail, Mode=Dark: 66×66-- Icon=Keynote, Mode=Default: 66×66-- Icon=Keynote, Mode=Dark: 66×66-- Icon=iTunes Store, Mode=Dark: 66×66-- Icon=Home, Mode=Default: 66×66-- Icon=Home, Mode=Dark: 66×66-- Icon=Health, Mode=Default: 66×66-- Icon=Health, Mode=Dark: 66×66-- Icon=Games, Mode=Default: 66×66-- Icon=Games, Mode=Dark: 66×66-- Icon=Freeform, Mode=Default: 66×66-- Icon=Freeform, Mode=Dark: 66×66-- Icon=Fitness, Mode=Default: 66×66-- Icon=Fitness, Mode=Dark: 66×66--### Status Bars and Menu Bars (15)-- Full Screen=True,Menu Expanded=False,Background=Light: 1210×32 HORIZONTAL pad 0/16/0/16 gap 966-- Type=App,Selected=False: 59×32 r100 HORIZONTAL pad 0/10/0/10 gap 0-- Type=App,Selected=True: 59×32 r100 HORIZONTAL pad 0/10/0/10 gap 0-- iPhone=iPhone 18 Pro: 402×62 HORIZONTAL pad 3/8/3/8 gap 0-- Full Screen=True,Menu Expanded=True,Background=Light: 1210×32 HORIZONTAL pad 0/16/0/16 gap 966-- Type=File,Selected=True: 59×32 r100 HORIZONTAL pad 0/10.5/0/10.5 gap 0-- Type=File,Selected=False: 59×32 r100 HORIZONTAL pad 0/10.5/0/10.5 gap 0-- iPad - Trailing Accessories: 90×16 HORIZONTAL pad 0/0/0/0 gap 5-- iPad - Leading Accessories: 132×16 HORIZONTAL pad 0/0/0/0 gap 8-- Full Screen=False,Menu Expanded=True,Background=Light: 1210×32 HORIZONTAL pad 0/16/0/16 gap 966-- Full Screen=False,Menu Expanded=False,Background=Light: 1210×32 HORIZONTAL pad 0/16/0/16 gap 966-- Type=Vertical: 48×83 VERTICAL pad 11/0/1/0 gap 6-- Type=Horizontal: 98×48 HORIZONTAL pad 1/1/1/2 gap 3-- iPhone=iPhone 17 Pro: 402×62 HORIZONTAL pad 3/0/3/0 gap 0-- iPhone=iPhone 18 Pro Max: 402×62 HORIZONTAL pad 3/8/3/8 gap 0--### Steppers (7)-- Style=Disabled: 46×32-- Style=Pressed: 46×32-- Style=Default: 46×32-- Style=Disabled: 46×32-- Style=Pressed: 46×32-- Style=Default: 46×32-- Stepper: 92×32 r100--### Action Sheets (1)-- Action Sheet: 300×296 VERTICAL pad 14/14/14/14 gap 0--### Sheets (7)-- Overlay: 100×100 r30-- Sheet - iPad: 936×852 r32 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light: 60×4 r100-- Mode=Dark: 60×4 r100-- Detent=Medium: 402×874 r38-- Detent=Large: 402×874 VERTICAL pad 62/0/62/0 gap 0-- Detent=Large (Stacked): 402×874 HORIZONTAL pad 62/0/62/0 gap 0--### Windows (7)-- Window State=Inactive: 41×22 r100 HORIZONTAL pad 0/0/0/0 gap 4.5-- Window State=Active: 41×22 HORIZONTAL pad 0/0/0/0 gap 4.5-- Window: 720×400 r34-- Window=Floating: 32×32 HORIZONTAL pad 0/6.670000076293945/6.670000076293945/0 gap 0-- Window=Full Screen: 32×32 HORIZONTAL pad 0/6/6/0 gap 0-- Mode=Active: 720×400 r34 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Inactive: 720×400 r34 HORIZONTAL pad 0/0/0/0 gap 0--### Empty States (3)-- Type=Large Symbol: 402×874 r44 VERTICAL pad 0/36/36/36 gap 0-- Type=Symbol in Circle: 402×874 r44 VERTICAL pad 0/36/36/36 gap 0-- Type=Title and Subtitle: 402×874 r44 VERTICAL pad 0/36/36/36 gap 0--### Page Controls (9)-- Is Active=True, Type=Default: 8×8 r50-- Is Active=False, Type=Default: 8×8 r50 HORIZONTAL pad 0/0/0/0 gap 0-- Pages=1-6: 402×44-- Pages=7: 402×44-- Pages=8+: 402×44-- Is Active=False, Type=Adjacent: 8×8 r50 HORIZONTAL pad 1/1/1/1 gap 0-- Is Active=True, Type=Adjacent: 8×8 r50-- Is Active=True, Type=Overflow: 8×8 r50-- Is Active=False, Type=Overflow: 6×6 r50 HORIZONTAL pad 1/1/1/1 gap 0--### Examples (138)-- Expanded=True: 1210×834-- Expanded=False: 1210×834-- Size=Small: 1210×834-- Size=Medium: 1210×834-- Size=Large: 1210×834-- Size=Extra Large: 1210×834-- Type=2 Line - Left Aligned: 1210×834-- Type=2 Line - Center Aligned: 1210×834-- Type=2 Line - Large Title Inline: 1210×834-- Type=2 Line - Large Title: 1210×834-- Type=Without Search: 1210×834-- Type=With Search: 1210×834-- Type=Edit Menu: 1210×834-- Type=Menu and Submenu: 1210×834-- Type=Text (Upper Case): 1210×834-- Type=Text (Lower Case): 1210×834-- Keyboard=True: 1210×834-- Keyboard=False: 1210×834-- Type=Title 2 Line Left: 402×874-- Type=Title 2 Line: 402×874-- Type=Large Title: 402×874-- Type=Compact Large Title: 402×874-- Type=Default: 402×874-- Type=Search: 402×874-- Type=Symbols: 402×874-- Type=Text: 402×874-- Split Search=False: 402×874-- Split Search=True: 402×874-- Type=Fullscreen: 402×874 r48-- Type=Fullscreen Stack: 402×874 r48-- Type=Inspector: 402×874 r48-- Type=Inline: 402×874-- Type=Compact: 402×874-- Type=Edit Medium: 402×874-- Type=Menu: 402×874-- Type=Inset: 402×874-- Type=Full Width: 402×874-- Type=Full Width + Section Headers: 402×874-- Type=Lowercase: 402×874-- Type=Uppercase: 402×874-- Type=Punctuation: 402×874-- Type=Numberic: 402×874-- Type=Find: 402×874-- Type=Find and Replace: 402×874-- Type=Email: 402×874-- Type=Web Search: 402×874-- Type=URL: 402×874-- Type=Number Pad: 402×874-- Type=Emoji: 402×874-- Examples/Face ID: 402×874-- Expanded=True: 402×874 r32-- Expanded=False: 402×874 r32-- Config=Title and Subtitle: 402×874 r44-- Config=Symbol in Circle: 402×874 r44-- Config=Large Symbol: 402×874 r44-- Size=Small: 402×874 r48-- Size=Medium: 402×874 r48-- Size=Large: 402×874 r48-- Size=XL: 402×874 r48-- Examples/Alert: 402×874--### Layout Guides (15)-- Type=Layout Margin: 100×100-- Type=Safe Area Inset: 100×100-- Type=Reserved Region: 100×100-- iPhone Duo/Sheets/Outer - Portrait: 466×678 r48-- iPhone Duo/Sheets/Outer - Landscape: 678×466 r48-- iPhone Duo/Sheets/Inner - Portrait: 669×951 r48-- iPhone Duo/Sheets/Inner - Landscape: 951×669 r48-- iPhone Duo/Standard/Outer - Portrait: 466×678 r44-- iPhone Duo/Standard/Outer - Landscape: 678×466 r48-- iPhone Duo/Standard/Inner - Portrait: 669×951 r20-- iPhone Duo/Standard/Inner - Landscape: 951×669 r48-- iPhone Duo/Standard/Inner - Landscape - Folded: 951×669 r48-- iPhone Duo/Standard/Inner - Portrait - Folded: 669×951 r20-- iPhone Duo/Sheets/Inner - Portrait - Folded: 669×951 r48-- iPhone Duo/Sheets/Inner - Landscape - Folded: 951×669 r48\ No newline at end of filediff --git a/docs/launch-playbook.md b/docs/launch-playbook.mddeleted file mode 100644index e1ffc1c..0000000--- a/docs/launch-playbook.md+++ /dev/null@@ -1,1147 +0,0 @@-# Skykeep launch playbook--Local working notes, written 2026-10-24. **Never commit `docs/`.** This replaces the launch-sections of `marketing-2026-10-21.md`, `launch-plan.md` and `product-review.md` §7. Those were-written before the rename, the updater and the Windows work, so several of their claims are no-longer true (see §0).--Research for this file was done live on 2026-10-24: Hacker News (Algolia API), GitHub,-creators' channels, and the outlets' own contact pages. **Reddit blocks automated reading, so-every subreddit rule below came from third-party scrapes.** Read each sidebar yourself before-posting. Anything not verified is marked *unverified*.-------## Update 2026-11-03 (read first; overrides older lines below)--**State:** main 8952141, 579 commits, about 116k lines of Rust, 33k of TypeScript, 1,092 Rust-tests, 255 browser suites. Full history scanned on 2026-11-03: no secrets (gitleaks --all), one-author (the no-reply address), no AI or Claude trailers (the only two Co-authored-by lines are-Dependabot's own), no org strings, no account ids, no real phone numbers or addresses (only-placeholders), no file over 3 MB. Safe to make public.--**New, literally true claims (since 24 Oct):**-- iCloud Drive changes made elsewhere show within seconds, folder by folder, including the Pages,- Numbers and Shortcuts folders (CloudKit change feed; measured 0.4 s for the check).-- Copy a photo straight to the clipboard (as PNG, never HEIC).-- Photos: Years, Months and All Photos, as on a Mac; smooth on 50,000 photos (test suite).-- Drive: Copy and Paste between folders, as Finder; paste files copied in the Linux file manager.-- Calendar: Ctrl+Z undo; drag between the all-day row and the hours; all-day alerts at 9 AM.-- Notes: search marks the words found; picture thumbnails in the list.-- Reminders: the Completed list; drag a reminder to another list; folding subtasks.-- Glass on menus, popovers and sheets (blurred on Windows; frosted, unblurred on Linux).--**Competition moved (check again on launch day):** two new Rust clients since late Sept, both-single-purpose: taylorhayis/icloud-drive-for-linux (Drive only, created 27 Oct, 4 stars, says-iCloud does not push changes, so edits show on the next check) and ferdousbhai/icloud-for-omarchy-(Notes, Photos, Find My on Arch, 5 stars). cross-platform/icloud-for-linux (577 stars) is a web-wrapper, last pushed Oct 2025. "Six apps in one, live sync, offline" is still unmatched. Never-attack them; credit them if asked.--**Channel rules changed:**-- **Hacker News:** since March 2026 new accounts can't post Show HN (/showlim), and the- guidelines forbid posting or editing any text with an LLM: the post and every comment must be- written by Yashwanth himself. Building with AI is fine. So the HN copy in §2.3 is a list of- facts to use, not text to paste. If his account is new, post the dev-story blog post as an- ordinary link (it was the stronger route anyway, §2.0).-- **r/opensource:** since 24 Oct 2026 bans AI-built projects and requires a year of maintenance- and several contributors. Skip it.-- **r/selfhosted:** projects under three months old go in the weekly New Project Megathread only.-- **Product Hunt:** the homepage is now chosen by editors (Useful, Novel, High craft, Creative);- only Featured launches get traffic, and votes from established accounts count far more. Put a- direct download link and the SmartScreen note in the maker comment (installs, not upvotes).-- **YouTube:** don't pitch Brodie Robertson (May 2026 controversy). Look at TechHut, The Linux- Experiment, DistroTube, Linux Lounge via their About-page business emails.-- **Press:** OMG! Ubuntu takes developer pitches at [email protected] (tip form for- others); OMG! Linux at [email protected]; It's FOSS through itsfoss.com/contact-us/.--**AI question:** expect "was this vibe-coded?" on HN and Reddit. Never deny it. Have one honest-line ready in his own words: what he designed and decided, that AI tools helped write code, and-what proves it works (1,092 Rust tests, 255 browser suites, a full-history CI gate run locally).--**Recommended order:** make the repo public quietly now (history is clean, Actions minutes become-free, the release pipeline and Flathub need it, and a public timestamp establishes the work);-then the launch gates below (v0.1.0 built by CI and install-tested, updater proven with a test-v0.1.1, a real Windows PC run, films ready); then Day 1 on a Tuesday (17 Nov 2026 is realistic).--## 0. The claim sheet--Every line of copy in this playbook comes from the "true" column. If a sentence isn't backed by-this table, it doesn't ship.--### Literally true (2026-10-24, main at `bf7ac8c`)--| Claim | Evidence |-|---|---|-| Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos, as desktop apps on Linux and Windows 10/11 | README, Features table |-| Six apps, one sign-in. Each app has its own launcher entry on Linux. On Windows each has its own Start-menu entry and taskbar button, plus a jump list (New Note, New Reminder, New Event, the six apps) | `99a400a`, `c6d9d62`, `taskbar.rs`, `apps.rs` |-| Notes and Reminders changes from the iPhone usually arrive in **about a second**, over Apple's push channel | README FAQ, `push.rs` |-| Calendar and Contacts are checked **every few seconds** while Skykeep is in use | README FAQ |-| The library lives on your computer: it opens instantly and works offline. Notes, reminders, events and contacts can be edited offline and sync on reconnect | README Privacy/FAQ, outbox |-| A note edited on both sides at once is **merged**, not overwritten | README Features ("Edits from your phone merge with yours") |-| On Linux, iCloud Drive (and Photos) is also a real folder in the file manager (FUSE) | README, SECURITY.md |-| Quick capture, results in GNOME and KDE search, a tray icon, alerts with Complete and Snooze | README "Everywhere" |-| **Export Everything** to Markdown, iCalendar, vCard and your original files | README |-| It connects to **Apple** for your iCloud, **the calendars you subscribe to**, and **GitHub's release servers** for its own updates. Each has a connection locked to its own hosts in code (`apple_only()`, `listed_only()`, `releases_only()`) | SECURITY.md |-| `.deb`, `.rpm`, AUR and Flatpak copies never contact GitHub; their package manager updates them | SECURITY.md |-| **No Skykeep account, no Skykeep servers, no analytics, no telemetry, no crash reporting** | SECURITY.md |-| Updates are signed and checked (minisign, pinned key), never a downgrade, and never installed mid-sync or while you type | SECURITY.md |-| Your password is never sent, not even to Apple: sign-in is Apple's SRP. Two-factor sign-in is Apple's own | README FAQ, SECURITY.md |-| Your password and session are kept **in the system keyring** so Skykeep signs back in by itself. Cookies are encrypted with a key held in the keyring | SECURITY.md (say this plainly; never imply the password isn't stored) |-| Advanced Data Protection works with **Access iCloud Data on the Web** turned on | README FAQ |-| Free and open source, GPL-3.0. Rust engine plus Tauri 2 | LICENSE, README |-| Installs per user on Windows, no administrator password | README Install |-| Engineering scale: **457 commits; about 111k lines of Rust in 5 crates plus the app; about 30k lines of TypeScript; about 1,000 Rust test functions** | `git rev-list --count HEAD`, line counts, `#[test]` count on 2026-10-24. **Re-run on launch day.** |--### Retired claims: never use these again--- "Talks only to Apple" / "It can only talk to Apple" / "Apple-only, enforced in code". Now it is- Apple, your calendar subscriptions, and GitHub for updates.-- "No update check". There is now a daily update check in the AppImage and Windows copies, and- it can be turned off.-- "Beta" / "preview" for Windows or Photos. The labels were removed. Still, don't claim- "stable" or "production-ready" either: let v0.1.0 speak for itself.-- "Native UI". It is a Rust engine with Tauri webviews. Say **"desktop apps"**, **"a native- Rust engine"** or **"real apps, not a website in a window"**. HN *will* ask "is Tauri native?"-- "First native iCloud client on Linux". ferdousbhai/icloud-for-omarchy (native Notes, Photos- and Find My on Arch) came first. Say **"Notes, Reminders, Calendar, Contacts, Drive and Photos- in one app"**, which is true and unmatched.-- Any regional-account statement. Don't mention it in copy at all.-- Translations or other languages. There are none, and none are planned for launch.-- Anything implying Apple approval, partnership or endorsement. No Apple logo, no fruit, no- Apple product renders, no "official".--### Stale lines to fix in other docs before launch (I didn't edit them)--- `github-setup.md` §2: the About description still says "(beta)" and "Talks only to Apple".- Use the one in §5.2 below.-- `github-setup.md` §6–7: the release notes and pinned issue still say "Windows is beta,- Photos is a preview". Use §2.10 and §5.4 below.-- The README hero `alt` text says "a note that has just arrived from an iPhone". The hero is- rendered from the demo fixture, not filmed from a phone. This is acceptable as alt text for- an illustration. But the **launch film must be a real phone and a real desktop, filmed in- real time** (§4.1). That's the one asset where staging would be a lie.--### Launch gates (all true before Day 1)--1. Repo public; privacy audit, history purge and secrets scan done (`github-setup.md` §9).-2. **v0.1.0 published** with the `.exe`, `.msi`, `.deb`, `.rpm`, `.AppImage`, SHA256SUMS,- `latest.json` and `.sig` files. Each package install-tested once on a clean system- (`OPEN-ITEMS` #4 is still open).-3. **The updater is proven end to end:** a v0.1.0 AppImage and a Windows install both pick up a- test v0.1.1 and update. Only you can cut that fix release if launch day breaks something,- so prove the path works before you need it.-4. **Windows run on a real Windows PC**, yours or a friend's: install, sign in, 2FA, edit a note,- Start-menu entries, jump list, update. CI smoke-tests on GitHub's runners; a real machine is- still the bar before pitching Windows creators.-5. AUR `skykeep-git` live. Flathub submitted (it's a separate launch moment when accepted;- the manifest has never been built and the metainfo lacks `<screenshots>`, per `OPEN-ITEMS` #6).-6. The real-phone film recorded (§4.1).-7. `~/.tauri` updater key backed up offline. Losing it means no updates, ever.-8. You've blocked out Day 1 from 12:00 to 04:00 IST, and Days 2–3 evenings.-------## 1. The narrative--### 1.1 One-sentence pitch--> **Skykeep is a free, open-source app that puts your iCloud Notes, Reminders, Calendar,-> Contacts, Drive and Photos on Linux and Windows as fast desktop apps, kept on your computer-> and in sync with your iPhone.**--The ten-word version is for titles and bios: *Your iPhone's iCloud, as real apps on Linux and-Windows.*--### 1.2 The villain is the wall, not a company--The villain is **the wall between your iPhone and your computer**. On Linux and Windows,-iCloud lives in a browser tab. It's online-only, has no alerts, isn't in your file manager, and-gets lost among twenty other tabs. Apple builds superb apps for its own devices; Skykeep exists-because many people love their iPhone *and* choose Linux or Windows.--Rules for the villain:--- **Never attack Apple**, Apple's Windows app or icloud.com. Describe what's missing, never- what's bad. "iCloud for Windows has no Notes or Reminders app" is a fact. "iCloud for Windows- is terrible" is an attack, and it invites a pile-on that drowns the launch.-- **Never attack other projects** (web wrappers, icloud-for-omarchy, rclone, icloudpd). Credit- them when asked; they proved the demand.-- The hero is **the user**, who no longer has to choose. Skykeep is the bridge.--### 1.3 The story arc (Apple-keynote shape, honest)--Use this shape for the film, the blog post, the PH maker comment and every talk. It's the-keynote shape: one message, problem before product, demo before features, rule of three, and a-held-back reveal.--1. **The world as it is.** "My notes live on my iPhone. My work lives on my Linux laptop."-2. **The wall.** "On the desktop, my notes lived in a browser tab: online-only, no alerts, gone- when the Wi-Fi drops."-3. **The turn.** "So I built the apps Apple makes for the Mac, for my computer."-4. **The magic moment (demo, no words).** Type on the iPhone; a second later it's on the- desktop.-5. **Three proofs:** *Instant* (it's on your disk), *Offline* (keep working, it syncs later),- *Yours* (open source, no account, no analytics, export everything).-6. **"And the rest of your iCloud."** Calendar, Contacts, Drive as a real folder, Photos.-7. **One more thing** (only if true on launch day): "And it's on Windows too, with each app in- your Start menu." For a Linux audience, the Windows reveal is the surprise. For a Windows- audience, flip it: the reveal is "and Notes and Reminders, which iCloud for Windows doesn't- have."-8. **The close.** "Free. Open source. Yours."--### 1.4 Emotional beats to film and write toward (all real)--- The note typed on the phone appearing on the desktop. **The core moment: hold on it.**-- A reminder ticked on the laptop, then the phone checks it off.-- Wi-Fi off on a train, still editing; Wi-Fi on, it syncs.-- A Linux file manager showing an "iCloud Drive" folder, then dragging a photo out of it.-- Searching "dentist" from the GNOME/KDE launcher and the reminder appearing.-- The Windows Start menu: typing "Reminders" brings up Skykeep Reminders.--### 1.5 Three taglines, ranked--1. **"Your iCloud, at home on Linux and Windows."** Already the README line. Warm, says who and- where, works for every audience. Use it on GitHub, PH, the press kit and the social preview.-2. **"Write it on your iPhone. Read it on your PC a second later."** The magic moment as a- sentence. Best for the film end card and short-form video. True for Notes and Reminders- only, so only pair it with them.-3. **"iCloud, out of the browser tab."** The villain line. Best for Linux and developer- audiences and for headlines. Don't use it where it reads as a dig at icloud.com: keep it next- to the positive claim ("…and onto your desktop: instant and offline").--Also usable: *Instant. Offline. Yours. Open source.* (the rhythm line), and *Your cloud, kept-safe on your own computer* (the name's meaning; good for the About section and press).--### 1.6 Messaging per audience--| Audience | Identity line | Lead claim | Proof to show | Avoid |-|---|---|---|---|---|-| **Linux users with iPhones** (core) | "For people who love their iPhone and their Linux desktop." | Notes and Reminders on Linux as real apps, live in about a second | The split-screen clip; Drive as a folder in Nautilus/Dolphin; GNOME/KDE search; AUR/deb/rpm/AppImage | "Apple on Linux" (they chose Linux on purpose); "native UI" |-| **Windows users** | "Your iPhone and your PC, finally on the same page." | The Notes and Reminders apps iCloud for Windows doesn't include; each app in your Start menu | Start menu → "Reminders" → Skykeep Reminders; the jump list; tick on PC, ticks on phone | Disparaging Apple's Windows app; hiding the SmartScreen prompt (say it up front) |-| **iPhone + PC families** | "Everyone keeps their iPhone. The family PC finally keeps up." | Shared lists and the family calendar on the computer, no new account | Reminders/Calendar on a Windows laptop; one sign-in | Jargon (CRDT, Rust, FUSE); anything about passwords that isn't in SECURITY.md |-| **Privacy-minded people** | "Your data on your disk, in software you can read." | No Skykeep account, no servers, no analytics; every connection listed and locked in code | SECURITY.md's host list; `apple_only.rs`, `releases.rs`; updates off with a switch; Export Everything | "Talks only to Apple" (retired); implying the keyring is unreadable by your own programs (SECURITY.md says it is readable) |-| **Developers** | "A hard problem, solved in the open." | One Rust engine, six apps; reverse-engineered CloudKit for Notes (gzip in `ENCRYPTED_BYTES`, protobuf, a topotext CRDT); push sync; locked connections | The blog post; crate map; ~1,000 tests; `./check.sh`; good-first-issues | Leading with "built fast" or tooling stories (§6.6) |-------## 2. Launch sequence and copy--### 2.0 Strategy in five lines (why this order)--1. **Hacker News is cold to this category's Show HN posts.** In 2026, every iCloud-on-Linux Show- HN got about 1 point, and Tether (iMessage on Linux) got about 10 as a Show HN. **But- Tether's blog post, posted as a plain link, reached 549 points**, and "iCloud Photos- Downloader" reached 653 in Jan 2026. HN wants the *story and the engineering*, not a repo- link. So the dev-story post is a first-class launch asset, not an afterthought.-2. **Linux press is the most reliable engine.** It's FOSS covered Tether within a week, and- OMG! Ubuntu covers polished new Linux apps. Pitch under embargo so Day 1 has articles.-3. **Concentrate Day 1** (repo, r/linux, Show HN, socials, press) so GitHub Trending sees one- spike of star velocity, not a trickle.-4. **Sunday is the iPhone day.** r/apple allows developer self-promotion only on Sundays- (Pacific time), and weekend HN posts break out more often than weekday ones (Myriade, 157k- Show HN posts: Sunday 11.75% vs weekdays ~9.5%).-5. **Windows gets its own wave on Days 9–10**, after a real-PC check and the winget listing.- It's a second launch moment, not a footnote.--**Day 1 is a Tuesday.** Times are in UTC with conversions. *After 1 Nov 2026 (US standard-time): 13:00 UTC = 08:00 ET = 05:00 PT = 14:00 CET = 18:30 IST.* Before 1 Nov, ET and PT are an-hour later on the clock (09:00 ET). Europe leaves summer time on 25 Oct 2026.--### The bigger plan (2026-11-03): no Reddit karma needed, every kind of user--Ready-to-send messages for subreddit mods, Discord servers, forums and Lemmy: docs/outreach-messages.md.--What actually made comparable launches break out:-- **Beeper Mini** (iMessage on Android, Dec 2023): a launch-day *exclusive* with one big tech outlet- (TechCrunch), a consumer pain everyone knows ("blue bubbles"), a reverse-engineering story.- 100,000 downloads in 48 hours. Apple cut it off within three days, because it impersonated an- Apple device. Lesson for us: mainstream tech press reaches far beyond Linux, and the framing- must stay "uses iCloud.com's own web service, the same one your browser uses", never "hacked".-- **Delta** (emulator, App Store #1): short videos by ordinary users and news accounts (IGN's- TikTok: 164k likes) in a surprised tone: "wait, you can do this on your phone?".-- **Wealthfolio** (solo, open-source, local-data desktop app): Product Hunt, then the HN front page,- then GitHub Trending, then a package manager listing (Homebrew), then Google search as the- steady, lasting source.-- **Tether** (iPhone Continuity on Linux): It's FOSS covered it; that single article was the spread.--Channels by audience, none needing Reddit karma:-1. **Mainstream tech press, one exclusive** (the Beeper move): The Verge, 9to5Mac, MacRumors,- AppleInsider, Ars Technica, XDA, How-To Geek, Windows Central, Neowin. Offer one of them the- story 48 hours early under embargo: "a student built the iCloud apps Apple doesn't make for- Windows and Linux, free and open source". iPhone + Windows is a far bigger audience than Linux.-2. **Linux press** (embargo, same day): OMG! Ubuntu, OMG! Linux, It's FOSS, Linuxiac, GamingOnLinux- (no), Phoronix (no: kernel/hardware), LWN (only for the engineering post).-3. **Short video, made by him** (the Delta move): 15-30 s vertical clips, phone in hand, real- screen: "I type on my iPhone... and it's on my Linux laptop." One idea per clip: Notes live;- iCloud Drive in the file manager; Windows Start menu "Reminders"; offline on a train; copy a- photo straight from Photos. Post the same clip to YouTube Shorts, TikTok, Instagram Reels, X,- Threads, Bluesky, LinkedIn. The films in skykeep-launch/out/ are the long versions.-4. **His own accounts, as the builder**: X, Bluesky, Mastodon (Fosstodon), Threads, LinkedIn (the- student-builder angle also feeds the Masters and placement story). A short thread: problem,- the 10-second clip, three proofs, link. Written by him.-5. **Federated and forum communities** (no karma): Lemmy ([email protected], !opensource, a- !skykeep community of its own), Discourse forums (Ubuntu, Fedora, KDE, GNOME, CachyOS,- EndeavourOS, Manjaro) in their app-announcement categories, distro Discord servers.-6. **Discovery that compounds** (the Wealthfolio long tail): Flathub (the biggest Linux app store),- AUR, winget, AlternativeTo (its "iCloud for Linux" page is empty today: list Skykeep there and- as an alternative to iCloud on Windows), Google (a docs page answering "how to use iCloud- Notes on Linux / Windows"), honest Stack Exchange and forum answers to the years-old "iCloud on- Linux?" questions, with disclosure.-7. **Newsletters and podcasts**: This Week in Rust (the engineering post), Console.dev, Changelog- News, It's FOSS's FOSS Weekly, OMG! Ubuntu's monthly app roundup; Linux Unplugged, Late Night- Linux, Destination Linux, Linux Matters (pitch as a guest: the story is the hook).-8. **YouTube creators** (they bring the non-technical users): TechHut, The Linux Experiment,- DistroTube, Linux Lounge, Chris Titus (Windows + Linux audience); Windows-side creators for the- Windows wave. Email a 30 s clip and a one-line ask; never pay, never script them.-9. **Reddit, without his own karma**: articles from steps 1-2 get posted to Reddit by readers;- meanwhile he can build karma by genuinely helping in r/linux, r/iphone, r/Windows11 threads- asking about iCloud for two weeks, and post r/apple on a Sunday later.-10. **Hacker News**: the engineering story as a plain link, written and answered by him.--The order: quiet public repo -> v0.1.0 + gates -> embargoed pitches (Day -5) -> Day 1: exclusive-article and Linux press go live, his clip and thread everywhere, Lemmy and forums, HN link ->-Days 2-14: one new clip a day, creators, Flathub, newsletters, Windows wave -> long tail: listings-and search. No single post decides it.--### What the biggest open-source breakouts did, across every field (2026-11-03)--| Project | How it broke out | What we take |-|---|---|---|-| **OpenClaw** (fastest-growing repo ever, 9k to 195k stars in 66 days) | Other people's demo videos and posts ("it bought a car by itself") spread across social media; stars rose by thousands an hour. Lost its @handle to snipers during a forced rename (Anthropic trademark). | One astonishing, *shareable* moment, shown by others. Secure every handle before going public; no third-party marks in the name (Skykeep is clean). |-| **Supabase** (100k stars) | Growth started the day the tagline became "the open-source Firebase alternative". Launch Weeks: one feature a day for a week, every few months; each one spikes stars. Founder messaged 3,000 developers one by one. | Tagline in the "open-source X alternative" form. **Six apps = a natural Launch Week: one app a day.** Talk to users one by one. |-| **Omarchy** (DHH; 46k stars, 1.3M ISO downloads in year one) | A famous builder's essays, HN (776 points), ThePrimeagen's show; users sharing their setups, themes and plugins. A second, bigger wave at version 4. | The Omarchy crowd left macOS and many keep iPhones: an iCloud-for-Omarchy project already exists (5 stars). Make Skykeep look at home on Hyprland/Omarchy and pitch that community and DHH. Plan a second wave (v0.2/1.0). |-| **Ghostty** | Years of devlogs on the builder's blog, a private beta in Discord (28k members waiting), a pre-announcement two months ahead, first public release already called 1.0, podcasts. | Tell the build story in public before launch (blog, X, Mastodon). A Discord or Matrix community from Day 1. Ship as finished, set expectations openly. |-| **Immich** (87k stars) | Mainstream reviewers wrote first-person "I replaced Google Photos" pieces (XDA, Android Police, MakeUseOf); r/selfhosted and self-hosting YouTubers. | Pitch the *first-person* angle to XDA, MakeUseOf, How-To Geek, Android Police writers: "I finally use iCloud Notes on my Linux PC". |-| **Zen Browser** (500k users) | Word of mouth among power users; its own subreddit; a community vote crowning it; mods and themes by users. | Our own community space early; let users share setups. |-| **PostHog** | Ready-before-HN (strangers succeeding unaided), founder blog posts on everything behind the scenes, an honest "best tools" comparison page (its most-read post ever). | Write the honest "every way to use iCloud on Linux and Windows" page (crediting the others) for search. |-| **Beeper Mini** | Launch-day exclusive in TechCrunch; 100k downloads in 48 h; Apple blocked it in 3 days. | One exclusive with a big tech outlet; say "uses iCloud.com's own web service", never "hacked". |-| **Wealthfolio, LocalSend** | HN front page, then GitHub Trending, then package managers and search; LocalSend hit HN three times over three years. | Package listings are lasting traffic; every big release is another HN moment. |--**The ten moves, in order of leverage for Skykeep**-1. Secure the name everywhere first: X, Bluesky, Mastodon, Threads, Instagram, TikTok, YouTube,- a Discord server, and a domain. (OpenClaw lost its handle.)-2. Tagline in the proven form: "The open-source iCloud apps for Linux and Windows."-3. One 10-second clip that makes people say "wait, what": phone types, laptop shows it.-4. A Launch Week: Day 1 the suite; then one app a day (Notes, Reminders, Calendar, Contacts,- Drive, Photos), each with its own clip, post and story. Six launch moments, not one.-5. One mainstream exclusive (The Verge / 9to5Mac / XDA), Linux press the same day.-6. The engineering story on his blog and HN; This Week in Rust.-7. Communities that care most: Omarchy and Hyprland users, Arch/CachyOS, iPhone+Windows people.-8. First-person reviewers and YouTubers (they reach non-technical users).-9. Lasting discovery: Flathub, AUR, winget, AlternativeTo (empty page today), the comparison page.-10. A second wave at the next big release (1.0), as Omarchy, LocalSend and Ghostty did.--### 2.1 Before Day 1--| When | What |-|---|---|-| **T-21** | Gates 2–5 started. Record the real-phone film (§4.1). Submit to Flathub. File 12–15 good-first-issues (§5.5). Write the dev-story blog post (§2.9) **in your own words**. |-| **T-14** | Press kit ready (§4). Cut the 16:9, 9:16 and 1:1 versions. Final README pass (§5.1). |-| **T-7 (Tue)** | Send personal pitches to the Tier 1 creators and press (§3) with: "Public from <T-2>; free to cover from Day 1, 13:00 UTC; happy to answer anything before." **One email each, personalised.** |-| **T-5** | Dry run: two friends install on Ubuntu/Fedora/Windows from the draft-release files and sign in. Fix what they hit. |-| **T-3** | v0.1.0 tagged; draft release checked; `latest.json` and signatures verified; test-update to a v0.1.0-hotfix rehearsal tag on a throwaway fork **or** a local updater test. |-| **T-2 (Sun)** | **Repo goes public quietly.** Publish v0.1.0. Upload the social preview. Pin the two issues. Discussions categories set. No announcement anywhere: press can now try it, and if someone finds it early, the README is already the launch page. |-| **T-1 (Mon)** | Freeze. Every post saved as a draft (HN text written by you). Sleep early. Check the AUR package builds from the public repo. |--### 2.2 Day 1 (Tuesday), hour by hour--| UTC | ET / CET / IST | What |-|---|---|---|-| 07:00 | 02:00 / 08:00 / 12:30 | Wake. Check overnight issues and Discussions. Smoke-test the release downloads once more on your own machine. |-| 11:30 | 06:30 / 12:30 / 17:00 | Final checks: README renders, release assets download, badges live. Phone and laptop ready for live GIF replies. |-| **12:00** | **07:00 / 13:00 / 17:30** | **Show HN** (§2.3). Weekday HN breakouts cluster at 11–13 UTC. Post it and **don't tell anyone to vote**. |-| 12:05 | | Post your first comment on the HN thread: how and why you built it, plus the honest limits (§2.3). |-| **13:00** | **08:00 / 14:00 / 18:30** | **r/linux** (§2.4). Press embargo lifts. Mastodon thread (§2.6) from a mastodon.social or hachyderm account; Bluesky thread; X thread. |-| 13:30 | | LinkedIn post (§2.6). Pin Discussions → Announcements "Skykeep 0.1.0 is out". |-| 13:00–17:00 | US morning, EU afternoon | **Answer every comment within 10 minutes**, HN first, then Reddit, then GitHub issues. Technical, short, humble, and the same facts everywhere. |-| 15:00 | 10:00 / 16:00 / 20:30 | Quick scan of issues by label: anything tagged `sign-in` or `data-loss` jumps the queue (§6.3). Reply to press emails. |-| 17:00 | 12:00 / 18:00 / 22:30 | Thank the outlets that published, and share their articles from your own accounts. (Never post links to your own HN thread anywhere: that reads as vote-seeking.) |-| 19:00 | 14:00 / 20:00 / 00:30 | **Hotfix window.** If a release-blocking bug is confirmed, ship v0.1.1 via the release pipeline (§6.3). Otherwise keep answering. |-| 22:00 | 17:00 / 23:00 / 03:30 | Snapshot numbers (§7). Write three lines on what people asked most; they become the FAQ and Day 2's fixes. |-| 23:00 | | Stop. The thread will keep going; answer the rest in the morning. |--### 2.3 Hacker News--**Read this first.** Since 2026-03-28, HN's own Show HN guidance asks that the post text **not-be written or polished by an LLM**. HN readers spot it instantly, and it would sink the launch-and your account's standing. So this section gives you the **title, structure and facts only**.-Write the prose yourself, in your own voice, the way you'd explain it to a friend. Typos are-fine. Marketing tone is not.--**Title options (pick one; HN titles: no caps-lock, no exclamation marks, max 80 chars):**-- `Show HN: Skykeep – Apple Notes, Reminders and iCloud Drive on Linux and Windows`-- `Show HN: Skykeep – iCloud as real desktop apps for Linux and Windows (open source)`-- `Show HN: I built the iCloud apps I wanted for my Linux desktop`--The URL field is the GitHub repo (people can try it right away, which Show HN requires).--**Text, in this order (bullets for you to write from):**-1. Who you are, one line. The itch: iPhone plus Linux; notes stuck in a browser tab.-2. What it is: six apps on one Rust engine (Tauri for the windows), local SQLite library,- opens instantly, works offline.-3. The magic: Notes and Reminders come over Apple's push channel, usually in about a second;- simultaneous edits to a note are merged.-4. One or two engineering details: `ENCRYPTED_BYTES` that turned out to be gzip, then protobuf,- then a topotext CRDT; tables as a CRDT within a CRDT. Link the blog post.-5. Trust, plainly: SRP sign-in (password never sent), password and session kept in the system- keyring so it can sign back in; what it connects to (Apple, subscribed calendars, GitHub for- updates) and that each connection is locked to its hosts in code; no account, no analytics.- Link SECURITY.md.-6. Limits, plainly: ADP needs "Access iCloud Data on the Web"; Managed Apple Accounts aren't- supported yet; on Windows, Drive and Photos open inside the app (the folder is Linux-only);- the Windows installer shows a SmartScreen prompt; not affiliated with Apple.-7. Ask for what you want to learn: "I'd love bug reports on sync edge cases."--**If the Show HN stalls** (under about 5 points after 2 hours): don't delete it, don't repost-it, and don't ask anyone for votes. HN moderators run a "second-chance pool": you can email-**[email protected]** once, politely, asking whether it might be considered. Put an email in-your HN profile so they can send a repost invite.--**Day 6 (Sunday), 13:00 UTC:** submit the dev-story post (§2.9) as a **plain link**, not a Show-HN. It's different content, and it's the genre that worked for Tether. Use the article's real-title. Don't post it if the Show HN is still on the front page.--### 2.4 Reddit--**Universal rules:**-- One subreddit per day per audience, and **different text each time**. The same post in- five subs on one day trips Reddit's spam filter.-- Post from your own account, aged with real participation. Keep self-promotion to about 10% of- your activity: mods check your profile.-- Reply to every comment. Never ask for upvotes. Never use a second account to comment.-- Read the sidebar and pinned rules yourself first: **all rules below are unverified scrapes.**-- Lead with the video clip uploaded natively (Reddit autoplays native video; links don't).--#### r/linux (Day 1, 13:00 UTC)-Rules (unverified): news-style titles, no blatant adverts. Open source is fine.--> **Title:** Skykeep 0.1.0: Apple Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos as desktop apps on Linux (GPL-3.0)->-> I use an iPhone and a Linux laptop, and the only way to get to my notes on the desktop was a browser tab. So I built Skykeep.->-> It keeps a copy of your iCloud on your computer, so everything opens instantly and works offline. Notes and Reminders arrive over Apple's push channel, usually in about a second. iCloud Drive (and Photos) also show up as real folders in your file manager, and Skykeep shows up in GNOME and KDE search.->-> [the 16:9 clip]->-> - Packages: .deb (Ubuntu 24.04+, Mint 22, Debian 13), .rpm (Fedora 41+, openSUSE Tumbleweed), AppImage, AUR (`skykeep-git`).-> - Privacy: no Skykeep account, no servers, no analytics. It connects to Apple, the calendars you subscribe to, and (AppImage only) GitHub for updates, and each connection is locked to its hosts in code. SECURITY.md lists every one.-> - Limits: Advanced Data Protection needs "Access iCloud Data on the Web" on; Managed Apple Accounts aren't supported yet. It's an independent project, not affiliated with Apple.->-> Repo: <link>. Happy to answer anything about how it works, including how Apple Notes stores text.--#### r/software (Day 2, Wednesday)-Rules (unverified): own software only if open source, **Wednesdays only, with the right flair**.--> **Title:** [Open source] Skykeep: your iCloud Notes, Reminders, Calendar and Drive as desktop apps on Windows and Linux->-> Skykeep puts your iCloud on your computer as six small apps (Notes, Reminders, Calendar, Contacts, iCloud Drive, Photos) with one sign-in. On Windows, each one has its own Start-menu entry. Your library is kept on your computer, so it opens instantly and works offline, and changes from your iPhone show up in seconds.->-> Free, GPL-3.0, no account, no analytics. Windows 10/11 and Linux. [clip] Repo and downloads: <link>--#### r/coolgithubprojects (Day 2) and r/SideProject (Day 4)-r/coolgithubprojects is link posts to GitHub only. The title is the post:-> **Skykeep – iCloud Notes, Reminders, Calendar, Contacts, Drive and Photos as desktop apps for Linux and Windows (Rust + Tauri)**--r/SideProject wants the maker story. Two paragraphs: why (iPhone plus Linux), what was hardest-(reverse-engineering how Notes stores text; making edits merge with the phone), and what you'd-like feedback on. Clip, then link.--#### r/opensource (Day 3, Thursday)-Rules (unverified): **Promotional flair required**; AI-written posts reportedly treated as-ban-worthy. **Write this one yourself.** Facts to cover: GPL-3.0, why GPL, contribution-on-ramps (good-first-issues, packaging help wanted: Nix, COPR, Flathub), how to run `./check.sh`.--#### r/apple (Day 6, Sunday, Pacific time)-Rules (unverified): developer self-promotion **Sundays only (California time), self-posts-only**, with activity requirements; must relate directly to Apple. Read the detailed rules page-first.--> **Title:** For iPhone owners whose computer isn't a Mac: I made an open-source app that brings Notes, Reminders and the rest of iCloud to Windows and Linux->-> A lot of us have an iPhone and a Windows or Linux PC. On the PC, Notes and Reminders have meant icloud.com in a browser.->-> Skykeep is a free, open-source app with Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos. Your library is kept on the computer so it opens instantly and works offline, and a note you type on your iPhone usually appears in about a second. Sign-in is Apple's own, with your usual two-factor code.->-> [9:16 or 16:9 clip of phone and PC side by side]->-> It's an independent project, not affiliated with Apple. It works with Advanced Data Protection when "Access iCloud Data on the Web" is on. Free, no account of its own, no analytics. Link: <repo>->-> I'm the developer, so ask me anything.--#### r/rust (Day 8, Tuesday)-Rules (unverified): self-promotion must clear a bar such as an OSI/FSF license **or** a blog-post about using Rust. Lead with engineering, not features.-> **Title:** Reverse-engineering Apple Notes' CloudKit format in Rust: gzip in a field called ENCRYPTED_BYTES, protobuf, and a CRDT->-> Body: a 6–8 line summary of the blog post, the crate layout (`quince-auth`, `quince-icloud`, `quince-core`, `quince-vfs`, `quince-media`), what Tauri 2 on WebKitGTK taught you (video through a loopback server; `WEBKIT_GST_USE_PLAYBIN3`), and the link to the post. Repo at the end.--(The crates keep their `quince-` prefix internally; if anyone asks, say it was the codename.)--#### r/Fedora or r/Ubuntu or r/linuxmint (Day 10, one sub only)-Install showcase: "Skykeep on Fedora 41: the .rpm, HEIC via RPM Fusion, and iCloud Drive in-Files". Screenshots on that distro's default desktop. Rules are unverified: modmail first if in-doubt.--#### r/windows / r/Windows11 (Day 9, only after modmail says yes)-> **Title:** Apple Notes and Reminders on Windows: an open-source app with a Start-menu entry for each iCloud app->-> Body: the Start-menu clip; that it installs per user with no admin password; the SmartScreen-> prompt stated up front ("the installer isn't code-signed yet, so Windows asks you to confirm:-> More info → Run anyway; the checksums are on the release page"); winget command once live.--#### r/selfhosted (optional, Friday megathread only)-Projects younger than 3 months may only appear in the **New Project** megathread, and the fit is-weak (Skykeep isn't a server). If you post, one comment in the megathread: "Not self-hosted, but-local-first: a full offline copy of your iCloud on your own disk, exportable to Markdown/ICS/vCard."--#### Skip-r/productivity (self-promotion and links banned), r/privacy (app promotion on hold; modmail-only if you have a technical post they've approved), r/linux_gaming (off-topic), r/kde and-r/gnome (it's not a KDE or GTK app; only "feedback on integration" posts after modmail),-r/archlinux (the AUR page is the announcement).--### 2.4a Reddit from a new account (14 karma today)--Many subreddits silently remove posts from accounts below a hidden karma or account-age bar-(AutoModerator): the poster still sees the post, nobody else does. Plan around it:--1. **Ask the moderators first (T-7 to T-3).** "Message the mods" on each target subreddit:- "Hi! I'm the developer of Skykeep, a free, open-source (GPL) app for iCloud Notes, Reminders,- Calendar, Contacts, Drive and Photos on Linux/Windows. My account is new — may I post it on- <date>, and is there anything I should follow?" Approval or a whitelist bypasses the filter.-2. **Earn real karma in the week before**, where you have real experience: answer questions and- leave useful comments in r/linux, r/archlinux, r/hyprland, r/unixporn. A few good comments a- day reaches 100+ quickly. Never buy karma or accounts — Reddit bans the account and can- block the GitHub link site-wide.-3. **Order:** lenient, project-friendly subs first (r/opensource — note its no-LLM-text rule,- r/coolgithubprojects, r/SideProject), then the large ones only after mods have answered.-4. **Check each post is visible** from a logged-out browser window a few minutes after posting;- if not, message the mods politely with the link.-5. Disclose "I made this", reply to every comment, and never post the same text to many subs at- once (spread per §2.7).--### 2.5 Product Hunt (Day 12, Saturday, 00:01 PT)--Why Saturday: weekend launches need far fewer upvotes for a top spot (vendor and founder data,-unverified), and PH's audience is weaker for Linux, so the cheaper slot makes sense. Only about-10% of launches get featured since 2024, so treat PH as a bonus.--- **Name:** Skykeep-- **Tagline (≤60):** `Your iCloud, at home on Linux and Windows` (41 chars)-- **Description (≤260):**- > Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos as fast desktop apps for Linux and Windows. Your library lives on your computer, so it opens instantly and works offline. Free, open source, no account, no analytics. Not affiliated with Apple.-- (255 chars. Re-count after any edit.)-- **Topics:** Productivity, Open Source, Linux, Windows, Privacy.-- **Pricing:** Free.-- **Links:** the GitHub repo, and the release page.-- **Gallery, in order:**- 1. The 16:9 film (or a 30 s cut): the phone-to-desktop moment in the first 3 seconds.- 2. Notes (light), with the phone beside it (the social preview works).- 3. Reminders, with an alert showing Complete and Snooze.- 4. Calendar, week view.- 5. The Windows Start menu with the six Skykeep apps and the jump list.- 6. Drive as a folder in a Linux file manager.- 7. Settings → Account / Software Update (the "what it connects to" trust shot).- 8. Contacts or Photos.-- **First comment (maker), posted the same minute. Edit it into your own voice:**- > Hi Product Hunt, I'm Yashwanth.- >- > I have an iPhone and a Linux laptop, and for years my notes and reminders on the computer meant a browser tab. Skykeep is what I wanted instead: six small apps, Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos, with one sign-in, on Linux and Windows.- >- > Three things I cared about:- > • **Instant.** Your library lives on your computer, so every app opens immediately and works offline.- > • **Live.** A note or reminder from your iPhone usually shows up in about a second.- > • **Yours.** Free and open source, with no Skykeep account and no analytics. Export Everything gives you Markdown, calendar and contact files whenever you like.- >- > It's an independent project that works with iCloud, not an Apple product. If you use Advanced Data Protection, turn on "Access iCloud Data on the Web" first.- >- > I'd love to hear which app you'd use most, and what's missing for you.-- **Rules:** you may ask people to "check it out and leave feedback". You may **not** ask for- upvotes, in any channel. Hunt it yourself (a third-party hunter gives no advantage).--### 2.6 Social threads (Day 1, 13:00–13:30 UTC)--Post the clip natively on every platform, with alt text written out. Use no more than 3–4-hashtags on Mastodon, and none in the X thread body.--**Mastodon (500 chars per post). Use mastodon.social or hachyderm.io: Fosstodon is invite-only-and bans commercial promotion.**-1. > Skykeep 0.1.0 is out: your iCloud Notes, Reminders, Calendar, Contacts, Drive and Photos as desktop apps on Linux and Windows.- >- > Type a note on your iPhone; it's on your desktop about a second later. Your library lives on your disk, so it opens instantly and works offline.- >- > Free, GPL-3.0, no account, no analytics.- >- > <repo> #Linux #OpenSource #Rust #iPhone- >- > [video, alt: "An iPhone and a laptop side by side. Text typed into a note on the phone appears in Skykeep Notes on the laptop a moment later."]-2. > On Linux, iCloud Drive and Photos also appear as real folders in your file manager, and Skykeep answers in GNOME and KDE search. Packages: deb, rpm, AppImage, AUR.-3. > Privacy, in one list: it connects to Apple, the calendars you subscribe to, and (AppImage/Windows only) GitHub for updates. Each connection is locked to its hosts in code. SECURITY.md has every host: <link>-4. > Not affiliated with Apple, just someone who loves his iPhone and his Linux laptop. Bug reports very welcome.--Tag in reply posts, not the first one, and only accounts that are active: @[email protected],-it's on Flathub, @[email protected]. Tagging once is a courtesy; tagging repeatedly is spam.--**Bluesky (300 chars per post):** posts 1–3 above, trimmed. Tag @itsfoss.bsky.social,[email protected], @9to5linux.com, @brodierobertson.xyz in a reply.--**X:** same as Bluesky. One post plus the clip, with the details in replies.--**LinkedIn (one post, first person, no hashtag wall):**-> Today I'm releasing Skykeep, a free, open-source app that brings iCloud Notes, Reminders, Calendar, Contacts, Drive and Photos to Linux and Windows as desktop apps.->-> The problem was personal: I use an iPhone and a Linux laptop, and on the computer my notes lived in a browser tab. Skykeep keeps your library on your computer, so it opens instantly and works offline, and a note typed on the iPhone usually appears in about a second.->-> Under the hood: one Rust engine shared by six apps, a reverse-engineered reading of how Apple Notes stores text (a CRDT inside protobuf inside gzip), and network connections locked in code to the hosts they need.->-> It's GPL-3.0 and independent, not affiliated with Apple. If you have an iPhone and a Windows or Linux PC, I'd love your feedback: <repo>--### 2.7 Days 2–14--| Day | Main move | Also |-|---|---|---|-| **2 (Wed)** | r/software (Wednesday rule, flair); r/coolgithubprojects | Submit the winget manifest (no popularity bar; installer from GitHub Releases is fine). Fix the top Day-1 issue. |-| **3 (Thu)** | Publish the **dev-story blog post** (§2.9) on your site; cross-post to dev.to `#showdev` with the canonical URL | r/opensource (Promotional flair, your own words). Chocolatey package submitted (human-reviewed). |-| **4 (Fri)** | r/SideProject | Follow up **once** with any Tier 1 creator who replied "maybe". Optional r/selfhosted megathread comment. |-| **5 (Sat)** | **Rest and triage.** Ship v0.1.1 if fixes are ready | Release notes thank reporters by handle (with their OK). The updater turns the release into a visible event for AppImage and Windows users. |-| **6 (Sun)** | **iPhone day:** r/apple Sunday self-post (Pacific Sunday); HN plain link to the dev-story post, 13:00 UTC | Mastodon/Bluesky: the offline clip. |-| **7 (Mon)** | Retrospective against §7 | Update README FAQ with the three most-asked questions. Email [email protected] about the Show HN only if it stalled and you haven't yet. |-| **8 (Tue)** | r/rust engineering post; This Week in Rust PR (blog post under community links) | Reply to every new issue within 24 h. |-| **9 (Wed)** | **Windows wave** (gate 4 must be true): r/windows or r/Windows11 after modmail; pitch Tier 2 Windows creators and XDA (§3) | Announce `winget install` once merged. |-| **10 (Thu)** | One distro sub (§2.4); AlternativeTo listing (alternative to iCloud for Windows and the iCloud web apps) | PRs to 0PandaDEV/awesome-windows and cuongtk8/awesome-linux-apps (§5.6). |-| **11 (Fri)** | Newsletters: Changelog News submit; It's FOSS follow-up if they haven't covered it; selfh.st only if the angle fits | Podcasts: LINUX Unplugged and Linux Matters contact forms with the blog post. |-| **12 (Sat)** | **Product Hunt, 00:01 PT** (§2.5) | Be at the keyboard for 08:00–20:00 PT replies (that's 21:30–09:30 IST, so plan sleep). |-| **13 (Sun)** | Thank-you post on Mastodon/Bluesky naming first contributors (with permission) | Write the 14-day numbers. |-| **14 (Mon)** | Release **v0.1.2 / v0.2.0** with the most-requested fix | If ≥50★: awesome-rust PR. If ≥100★: Scoop Extras request (issue first). If Flathub is live, announce it on Mastodon/Bluesky and tip OMG! Ubuntu; not another r/linux post (one a month at most). |--### 2.8 Partner and neighbour outreach (Days 3–10)--These people are genuine neighbours with the same users. Offer, don't ask:-- **Tether** (iMessage/SMS on Linux; zackbartel.com). The obvious "iPhone + Linux kit" pairing.- Offer a mutual "see also" line in READMEs.-- **LocalSend** (AirDrop alternative) and **iDescriptor** (iPhone device tool, Rust). Same offer.-- Only add a "see also" if they agree, and only for projects you've actually tried.--### 2.9 Dev-story blog post: outline--**Title options:** "How Apple Notes stores your text (and how I got it onto Linux)" or "I wanted my-iPhone notes on Linux. Here's what was inside ENCRYPTED_BYTES." Write it yourself; same HN rule-as §2.3. Host it on your own site (yashwanthkamireddi.dev) so the HN link isn't a repo.--1. **Hook (3 lines):** the browser tab; the moment you decided to build it.-2. **The first wall:** the legacy Notes API returned an Apple placeholder, not your notes. Real- records live in CloudKit's `changes/zone`.-3. **The puzzle:** `ENCRYPTED_BYTES` that was actually gzip; inside, protobuf; inside that, a- topotext CRDT. A diagram of the layers. (Use synthetic note text only.)-4. **Merging with a phone typing at the same moment:** what a CRDT gives you, where it bit you.- Tables as a CRDT within a CRDT.-5. **Making it feel instant:** the local library, optimistic writes with rollback, push for- Notes and Reminders, the outbox for offline edits.-6. **Locking the network down:** how `apple_only()`, `listed_only()` and `releases_only()` refuse- other hosts, IP literals and redirects; why the update client can't reach Apple and vice versa.-7. **Tauri on WebKitGTK:** video through a loopback server, the playbin3 stall, why animations- came out (flicker on Wayland).-8. **What's next and how to help:** good-first-issues, packaging, the honest limits.-9. **Close:** the note appearing on the desktop: the moment it all worked.--### 2.10 GitHub release notes, v0.1.0--```markdown-# Skykeep 0.1.0--Your iCloud, at home on Linux and Windows.----Skykeep brings Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos to your computer as-six desktop apps with one sign-in. Your library lives on your computer, so everything opens-instantly and works offline, and changes from your iPhone arrive on their own: Notes and-Reminders usually in about a second.--## Highlights-- **Notes:** headings, styles, checklists; pictures, scans, PDFs and tables shown in place;- edits from your phone merge with yours.-- **Reminders:** lists, smart lists, subtasks, due dates, repeats, flags; alerts with- Complete and Snooze.-- **Calendar:** day, week, month and year; drag to create and move; repeats, time zones,- birthdays; subscribe to any webcal calendar.-- **Contacts:** every field; lists; find and merge duplicates; vCard and CSV import.-- **iCloud Drive and Photos:** browse, upload, preview; on Linux, also real folders in your- file manager.-- **Everywhere:** search across every app, quick capture, GNOME and KDE search, a tray icon,- **Export Everything** to Markdown, iCalendar and vCard.-- **Windows:** each app has its own Start-menu entry and taskbar button, plus a jump list.-- **Updates:** the Windows installer and the AppImage update themselves, after a signature- check, never while you're typing or a change is still on its way.--## Install-| System | Download |-|---|---|-| Windows 10 and 11 | `Skykeep_0.1.0_x64-setup.exe` (or the `.msi`) |-| Ubuntu 24.04+, Debian 13, Linux Mint 22 | `Skykeep_0.1.0_amd64.deb` |-| Fedora 41+, openSUSE Tumbleweed | `Skykeep-0.1.0-1.x86_64.rpm` |-| Arch, CachyOS, EndeavourOS, Manjaro | `paru -S skykeep-git` |-| Any other distribution | `Skykeep_0.1.0_amd64.AppImage` |--Check your download against `SHA256SUMS`. The Windows installer isn't code-signed yet, so-Windows may ask you to confirm: **More info → Run anyway**.--## Good to know-- Advanced Data Protection: turn on **Access iCloud Data on the Web** (iPhone: Settings → your- name → iCloud).-- Managed Apple Accounts from a school or workplace aren't supported yet.-- On Windows, Drive and Photos open inside the app.-- Skykeep connects to Apple, the calendars you subscribe to, and GitHub for its own updates.- No Skykeep account, no analytics. [SECURITY.md](SECURITY.md) lists every host.--Skykeep is an independent open-source project, not affiliated with or endorsed by Apple.-```-(Fix the asset file names to the exact names the pipeline produces before publishing.)-------## 3. Creator and press outreach--### 3.1 Rules--- **Personalise the first line for real:** name a specific recent video or article you- actually watched or read. The references below were found on 2026-10-24; **open each one- before citing it.**-- Pitch **T-7** with "free to cover from Day 1, 13:00 UTC". One follow-up at most, after 5 days.-- Never pay, never offer anything for coverage, never ask a creator to tell viewers to star.-- Send the right cut: YouTube long-form gets the 16:9 film plus a download link to raw- footage; Shorts/Reels creators get the 9:16; news sites get the 1:1 loop or GIF (they embed it).-- Contacts: most YouTube business emails sit behind the About tab's "View email address"- captcha; open it yourself. "Not found" below means no address is published on their own page.--### 3.2 Prioritised table--| # | Name | Platform | Link | Audience | Why they'd care | Cut | Route |-|---|---|---|---|---|---|---|---|-| 1 | **It's FOSS** (Sourav Rudra, news) | Site, newsletter, socials | [itsfoss.com](https://itsfoss.com) | Newsletter 20K–37K; Mastodon 59.8K; X 110K; IG 40K | Covered **Tether** (iPhone continuity on Linux) on 31 Aug 2026; the contact form has an "open source product that should reach more people" option | 1:1 + 16:9 | [contact form](https://itsfoss.com/contact-us/) |-| 2 | **OMG! Ubuntu** (Joey Sneddon) | Site | [omgubuntu.co.uk](https://www.omgubuntu.co.uk) | Mastodon 17K, Bluesky 11.3K | Writes up polished new Linux apps; the tip page asks for app tips with screenshots | 1:1 + screenshots | [tip form](https://omgubuntu.co.uk/tip) |-| 3 | **Snazzy Labs** (Quinn Nelson) | YouTube | [@snazzylabs](https://youtube.com/@snazzylabs) | 1.27M | Apple power users; posted "Open Source Is Beating Paid Mac Apps" (2 Oct 2026) | 16:9 | About tab |-| 4 | **The Linux Experiment** (Nick) | YouTube + Mastodon | [@thelinuxexp](https://youtube.com/@thelinuxexp) | 432K; Mastodon 32.9K | Weekly news show features new apps; "left the Mac, kept the iPhone" fits | 16:9 | About tab; [Mastodon](https://mastodon.social/@thelinuxEXP) |-| 5 | **LINUX Unplugged** (Jupiter Broadcasting) | Podcast | [show](https://www.jupiterbroadcasting.com/show/linux-unplugged/) | YouTube 53.5K + podcast | Reads listener tips on air; Rust, local-first | 16:9 link | [contact](https://linuxunplugged.com/contact) |-| 6 | **Brodie Robertson** | YouTube | [@BrodieRobertson](https://youtube.com/@BrodieRobertson) | 125K | Daily commentary; likes reverse-engineering stories and "what if Apple changes it" | 16:9 + blog post | About tab; [Bluesky](https://bsky.app/profile/brodierobertson.xyz) |-| 7 | **TechHut** | YouTube | [@TechHut](https://youtube.com/@TechHut) | 284K | App demos; Drive as a real folder | 16:9 | About tab |-| 8 | **The Linux Cast** | YouTube | [@thelinuxcast](https://youtube.com/@thelinuxcast) | 75.4K | Desktop workflow; real apps vs web wrappers | 16:9 | [Mastodon](https://fosstodon.org/@thelinuxcast) |-| 9 | **Switched to Linux** | YouTube | [@switchedtolinux](https://youtube.com/@switchedtolinux) | 90.6K | His audience is people leaving Windows/Mac | 16:9 | About tab |-| 10 | **This Week in Rust** | Newsletter | [repo](https://github.com/rust-lang/this-week-in-rust) | Mastodon 4.7K + newsletter | A shipped Rust + Tauri desktop app; the blog post | blog link | PR (community links) |-| 11 | **9to5Linux** (Marius Nestor) | Site | [9to5linux.com](https://9to5linux.com) | Mastodon 21.1K | Versioned release news; best on a release (v0.1.x/v0.2) | 1:1 | [contact](https://9to5linux.com/contact-us) |-| 12 | **Linux Matters** (Popey, Wimpress, Johnson) | Podcast | [linuxmatters.sh](https://linuxmatters.sh) | Mastodon 1.5K, Bluesky 1.9K | Popey cares about app packaging (Flathub) | link | [contact](https://linuxmatters.sh/contact) |-| 13 | **Late Night Linux** | Podcast | [latenightlinux.com](https://latenightlinux.com) | Mastodon 3.9K | Picks/discoveries style (segment unverified) | link | [contact](https://latenightlinux.com/contact/) |-| 14 | **DistroTube** | YouTube | [@DistroTube](https://youtube.com/@DistroTube) | 276K | GPL-3.0, no account, no analytics | 16:9 | About tab |-| 15 | **Mental Outlaw** | YouTube | [@MentalOutlaw](https://youtube.com/@MentalOutlaw) | 798K | Privacy; covered an open-source Adobe clone on 17 Oct 2026 | 16:9 + SECURITY.md | About tab |-| 16 | **Chris Titus Tech** | YouTube | [@christitustech](https://youtube.com/@christitustech) | 782K | Windows + Linux crossover. **Windows wave** | 16:9 | About tab |-| 17 | **Brian Burgess (XDA)** | Site | [his iCloud-on-Windows article](https://www.xda-developers.com/using-icloud-on-windows-doesnt-need-to-be-a-nightmare/) | XDA | Wrote "Using iCloud on Windows doesn't need to be a nightmare". **Windows wave** | 1:1 + 16:9 | XDA author page |-| 18 | **Britec09** | YouTube | [@Britec09](https://youtube.com/@Britec09) | 905K | Daily Windows; "no account to sign up for" angle. **Windows wave** | 16:9 | About tab |-| 19 | **ThioJoe** | YouTube (+ Shorts) | [@thiojoe](https://youtube.com/@thiojoe) | 3.14M | "The iCloud apps Windows doesn't have". **Windows wave, long shot** | 9:16 + 16:9 | About tab |-| 20 | **Brandon Butch** | YouTube | [@brandonbutch](https://youtube.com/@brandonbutch) | 1.44M | iPhone tips; "your iPhone's Notes on a PC" | 9:16 + 16:9 | About tab |-| 21 | **Windows Central** | Site + video | [@windowscentral](https://youtube.com/@windowscentral) | 420K | iPhone users on Windows. **Windows wave** | 1:1 | site tips |-| 22 | **Linux Tex** | YouTube | [@linuxtex](https://youtube.com/@linuxtex) | 143K | Beginner "apps you need" lists | 16:9 | About tab |-| 23 | **Veronica Explains** | YouTube | [@VeronicaExplains](https://youtube.com/@VeronicaExplains) | 187K | Owning your data | 16:9 | About tab |-| 24 | **Changelog News** | Newsletter/podcast | [submit](https://changelog.com/news/submit) | unpublished | The engineering story | blog link | form |-| 25 | **Linuxiac** | Site | [linuxiac.com](https://linuxiac.com) | Mastodon 3.5K | App releases | 1:1 | contact page (couldn't load it) |--**Short-form (9:16):** reach was the weakest part of the research. TikTok is blocked in India,-so plan for **YouTube Shorts and Instagram Reels**. Most channels above also post Shorts, so the-9:16 cut goes with every YouTube pitch. Small TikTok accounts found (sizes unverified):-@lordgains418 (Windows→Linux apps), @emanschi_games (Arch apps), @28_all_day (Linux Mint).-Low priority; a short DM with the 9:16 is enough. The best short-form channel is **your own**:-post the 9:16 on YouTube Shorts and Reels on Day 1, with the magic moment in the first 2 seconds.--**Skip for now:** ExplainingComputers (distro-focused), Learn Linux TV (sysadmin), Phoronix-(kernel/hardware), GamingOnLinux (gaming), The Verge/Ars (only if it becomes news), Console.dev-(dev tools only), Keep Productive/Ali Abdaal (unverified, weak fit).--### 3.3 Pitch templates (short, respectful, edit each one)--**Press (It's FOSS / OMG! Ubuntu / 9to5Linux / Linuxiac)**-> **Subject:** Skykeep: iCloud Notes, Reminders and Drive as desktop apps on Linux (open source)->-> Hi <name>,->-> Your piece on <specific article, e.g. Tether bringing iPhone continuity to Linux> is why I'm writing: Skykeep is the other half of that story.->-> Skykeep is a free, GPL-3.0 app that brings iCloud Notes, Reminders, Calendar, Contacts, Drive and Photos to Linux (and Windows) as desktop apps. Your library lives on your disk, so it opens instantly and works offline; a note typed on an iPhone usually shows up in about a second; and iCloud Drive appears as a real folder in Files or Dolphin.->-> [embedded 1:1 loop]->-> It goes public on <T-2 date>, and you're welcome to cover it from <Day 1>, 13:00 UTC. Press kit (film, screenshots, logo, fact sheet): <link>. Packages: deb, rpm, AppImage, AUR.->-> Honest limits: Advanced Data Protection users need "Access iCloud Data on the Web" on, and it's an independent project, not affiliated with Apple.->-> Happy to answer anything.-> Yashwanth Kamireddi--**YouTube, Linux (Linux Experiment / TechHut / Linux Cast / Switched to Linux)**-> **Subject:** iPhone + Linux: Notes and Reminders as real apps (for a news segment?)->-> Hi <name>, I enjoyed <specific video>. I think your viewers who kept their iPhone after switching might like Skykeep: iCloud Notes, Reminders, Calendar, Contacts, Drive and Photos as desktop apps on Linux, open source, with a note from the phone appearing in about a second.->-> 60-second film (16:9) and raw real-time footage you're free to use: <press kit>. It's public from <date>; coverage welcome from <Day 1>.->-> No account, no analytics, GPL-3.0. Thanks either way.-> Yashwanth--**Snazzy Labs (Apple-power-user angle)**-> **Subject:** Open source, from the other direction: iCloud on Linux and Windows->-> Hi Quinn, your "Open Source Is Beating Paid Mac Apps" video stuck with me. I built something for the people on the other side of the wall: Skykeep, a free, open-source app that puts iCloud Notes, Reminders, Calendar, Contacts, Drive and Photos on Linux and Windows as desktop apps, with a note from the iPhone landing on the PC in about a second.->-> Film and press kit: <link>. Public from <date>. Not affiliated with Apple; it signs in the way icloud.com does, with Apple's own two-factor.->-> Thanks for reading,-> Yashwanth--**Privacy channel (Mental Outlaw / DistroTube)**-> **Subject:** An iCloud client with no account, no analytics, and every connection listed->-> Hi <name>, after <specific video> I thought you might find this one interesting to pick apart. Skykeep brings iCloud Notes, Reminders and Drive to Linux. It has no account and no analytics; SECURITY.md lists every host it connects to (Apple, your calendar subscriptions, GitHub for updates), each locked in code, with tests. It also says plainly what it stores in your keyring and who can read it.->-> Repo and SECURITY.md: <link>. Press kit: <link>. GPL-3.0.-> Yashwanth--**Windows wave (Chris Titus / Britec / ThioJoe / XDA / Windows Central)**, send on Day 9 only-after the real-PC gate-> **Subject:** Apple Notes and Reminders on Windows, in the Start menu (open source)->-> Hi <name>, <specific video/article line>. iCloud for Windows covers Drive and Photos, but there's no Notes or Reminders app. Skykeep fills that in: free, open-source desktop apps for Notes, Reminders, Calendar, Contacts, Drive and Photos, each with its own Start-menu entry and taskbar button, installing per user with no admin password.->-> 16:9 and 9:16 cuts: <press kit>. The installer isn't code-signed yet, so SmartScreen asks once; I'd rather say that up front.-> Yashwanth--**Podcast (LINUX Unplugged / Linux Matters / Late Night Linux)**: three lines via the contact-form: what it is, the one-sentence engineering hook (Apple Notes' text is a CRDT in protobuf in-gzip), and the links.-------## 4. Press kit--Host it **in the repo** at `press/` (or a GitHub Pages page) once public, so the link is stable-and nothing goes to a third-party cloud. Link it from the README footer and every pitch.--### 4.1 Contents--**Films** (all with burned-in captions, plus an `.srt`; no music needed, or royalty-free with-the licence noted):-1. **Launch film, 16:9, 60–75 s, 1080p/4K 60 fps.** The storyboard in- `marketing-2026-10-21.md` §5 still works, with **one change**: shot 7 now shows SECURITY.md's- host list ("Apple, your calendars, GitHub for updates — nothing else") instead of "talks only- to Apple".-2. **Vertical, 9:16, 20–30 s.** The magic moment in the first 2 seconds: phone in hand, type,- the laptop behind it updates. Then Reminders tick, then Start menu, then the end card- "Skykeep. Free and open source." Real time, with a small "real time, not sped up" caption.-3. **Square loop, 1:1, 6–8 s, as MP4 and GIF (<5 MB).** Just the phone-to-desktop moment.-4. **Raw footage**, unedited and real time: phone-to-desktop Notes, phone-to-desktop Reminders,- offline edit and resync, Windows Start menu and jump list, Drive in a Linux file manager.- Creators like raw B-roll.--**Filming rules:** a **demo Apple Account with synthetic data only**; a real iPhone filmed on a-tripod and a real screen, never mockups; no Apple logo in frame (cover or angle the phone's-back); no notification banners showing real names; no university or workplace names anywhere.--**Screenshots:** the 14 WebPs in `docs/media/` plus PNG exports at 2560×1600 (light and dark):-Notes, Reminders, Calendar, Contacts, Drive, Photos, Settings, Sign-in. Add: the Windows Start-menu with the six apps; the jump list; Drive in Nautilus and in Dolphin; a reminder alert with-Complete and Snooze; GNOME search showing a Skykeep result.--**Logo:** `packaging/icons/skykeep-1024.png`, plus SVG; the small tray/notification variant;-on light, on dark, and the mark alone. Usage note: don't recolour or pair it with Apple marks.--**Fact sheet** (§4.2), **maker bio and quotes** (§4.3), **FAQ** (link to the README FAQ and-SECURITY.md), and **the disclaimer**.--### 4.2 Fact sheet (all literally true as of 2026-10-24; re-check numbers on launch day)--> **Skykeep — fact sheet**->-> **What it is:** a free, open-source desktop app that brings iCloud Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos to Linux and Windows as six apps with one sign-in.->-> **Made by:** Yashwanth Kamireddi, an independent developer. Solo project.->-> **First release:** v0.1.0, <date>.->-> **Platforms:** Windows 10 and 11 (installs per user, no administrator password). Linux: Ubuntu 24.04+, Linux Mint 22, Debian 13, Fedora 41+, openSUSE Tumbleweed and later (.deb, .rpm, AppImage), Arch-based systems via the AUR; GNOME, KDE and other desktops, Wayland or X11.->-> **Price:** free. **Licence:** GPL-3.0. **Source:** github.com/YashwanthKamireddi/Skykeep->-> **Key facts:**-> - Your library lives on your computer: every app opens instantly and works offline; edits made offline sync when you reconnect.-> - Notes and Reminders changes from an iPhone usually arrive in about a second (Apple's push channel); Calendar and Contacts are checked every few seconds while in use.-> - Notes edited on the phone and the computer at the same moment are merged.-> - On Linux, iCloud Drive and Photos also appear as real folders in the file manager; Skykeep answers in GNOME and KDE search.-> - On Windows, each app has its own Start-menu entry and taskbar button, plus a jump list.-> - Export Everything: notes to Markdown, events to iCalendar, contacts to vCard, files as they are.-> - Privacy: no Skykeep account, no Skykeep servers, no analytics or telemetry. It connects to Apple, the calendars you subscribe to, and GitHub's release servers for its own updates; each connection is locked to its hosts in code. Sign-in uses Apple's SRP protocol, so the password is never sent; the password and session are kept in the system keyring.-> - Signed in-app updates for the Windows installer and AppImage; package-manager installs update through the package manager.->-> **Built with:** Rust (a five-crate engine) and Tauri 2, with a TypeScript interface. About 457 commits and about 1,000 Rust tests at launch.->-> **Works with Advanced Data Protection** when "Access iCloud Data on the Web" is on. Managed Apple Accounts aren't supported yet.->-> **Name:** *Sky* for the cloud; a *keep* is a castle's safest tower. Your cloud, kept safe on your own computer.->-> **Contact:** <launch email or GitHub Discussions>. Security reports: GitHub private vulnerability reporting.->-> *Skykeep is an independent project and has not been authorized, sponsored or otherwise approved by Apple Inc. Apple, iCloud and iPhone are trademarks of Apple Inc., registered in the U.S. and other countries and regions.*--### 4.3 Maker quotes--Press will quote you, so **write two or three short quotes yourself, in your own words**, and-only say things you mean. Suggested themes (not words to copy):-- Why: the browser tab, and loving both the iPhone and Linux.-- What you're proudest of: the first time a note from the phone landed on the desktop.-- On trust: "Read SECURITY.md; if a line in it stops being true, that's a bug."--**Social proof:** add real user quotes and creator mentions to the press kit and README **only-after they exist**, with permission and a link to the source. Never invent, paraphrase into-something stronger, or imply a quote from someone who only starred the repo.-------## 5. GitHub growth--### 5.1 README conversion checklist--What turns a visitor into a star, in the first screen: **what it is, proof it works, how to get-it.** Current README status:--- [x] Logo, name, one line ("Your iCloud, at home on Linux and Windows.").-- [x] Hero animation in the first screen; six-app grid with light/dark.-- [x] Honest FAQ (password, ADP, Managed accounts, offline, speed).-- [x] Privacy section with the real host list and a link to SECURITY.md.-- [ ] **Download buttons in the first screen** (above the six-app grid): "Download for Windows"- and "Download for Linux" linking to the latest release. Visitors who can't find the download- in 5 seconds leave.-- [ ] **A real-phone clip near the top** (GIF or a short video), *in addition to* the hero: the- phone-to-desktop moment is the proof that converts, and the hero shows the desktop only.-- [ ] **A one-line trust row** under the tagline: "Free and open source · No account · No- analytics · Works offline". All true.-- [ ] Uncomment the dynamic badges once public (release, build, AUR when live, Flathub when- live). Leave the stars badge out until it isn't tiny.-- [ ] A short "How it works" link to the blog post (developers star the engineering).-- [ ] winget line in Install once merged.-- [ ] Keep it calm: no wall of badges, no emoji headings, no "blazingly fast".--### 5.2 About box, topics, social preview--**Description (replaces the stale one in `github-setup.md` §2):**-```text-Your iCloud, at home on Linux and Windows: Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos as fast desktop apps. Local-first, so everything opens instantly and works offline. No account, no analytics. Free and open source, built with Rust + Tauri. Not affiliated with Apple.-```--**Topics (20 max):** `icloud`, `icloud-drive`, `icloud-photos`, `icloud-notes`, `apple-notes`,-`apple-reminders`, `apple-calendar`, `linux`, `linux-desktop`, `linux-app`, `windows`,-`desktop-app`, `local-first`, `offline-first`, `privacy`, `rust`, `tauri`, `tauri-app`,-`cloudkit`, `crdt`.--**Social preview:** `docs/media/social-preview.png` is ready (1280×640, 296 KB, under GitHub's-1 MB limit). Upload it right after going public.--**Website field:** your blog post or a project page once it exists; never a personal homepage.--### 5.3 Discussions--Announcements, Q&A, Ideas, Show and tell (screenshots of Skykeep on people's desktops become-real, shareable social proof). Pin a welcome post.--### 5.4 Pinned issues (up to three)--1. **"Skykeep 0.1 — what works, what's next"**: the roadmap in plain words (Drive/Photos- folders on Windows; editing tables; attachments; accessibility pass; Flathub), and links to- good-first-issues. **No beta/preview labels.**-2. **"Install reports: tell us your distro, desktop and Windows version"**: one place for- "works on X" comments; it doubles as honest social proof.-3. During launch week only: **"Known issue: <x>"** if something real comes up (§6.3).--### 5.5 Good-first-issues (file 12–15 before launch, each an afternoon)--From the open lists in `ROADMAP.md` and `OPEN-ITEMS-2026-10-22.md`:-- Packaging recipes: **Nix flake**, **Fedora COPR**, **Scoop manifest** (a personal bucket until- Extras' 100★ bar), **Chocolatey** package, **winget** manifest updates.-- Wake the offline outbox when the network returns (NetworkManager `StateChanged` / the- NetworkMonitor portal), labelled S in OPEN-ITEMS.-- Accessibility labels on toolbar buttons; an Orca or NVDA walkthrough report (`help wanted`).-- Keyboard shortcuts missing per app (pick specific ones).-- vCard and CSV import edge cases (attach synthetic sample files).-- A man page or `--help` text for the command-line flags (`--app`, `--new`).-- Screenshots for the Flathub metainfo (`<screenshots>` is required and missing).-- Docs: CONTRIBUTING code map per crate.--**help wanted** for expertise: Windows Cloud Files API (Drive as a folder on Windows), Flatpak-portals, a code-signing route (SignPath Foundation).--**Never** file translation issues; translations aren't wanted for now.--### 5.6 Lists and directories--| Where | Link | Rules (read 2026-10-24) | When |-|---|---|---|---|-| winget | [docs](https://learn.microsoft.com/en-us/windows/package-manager/package/repository) | Silent install, installer from the publisher (GitHub Releases is fine), clean uninstall, AV scan; one version per PR | Day 2 |-| Chocolatey | [moderation](https://docs.chocolatey.org/en-us/community-repository/moderation/) | Human-reviewed; ProjectUrl, LicenseUrl, checksums; VERIFICATION.txt for embedded binaries | Day 3 |-| AlternativeTo | [FAQ](https://alternativeto.net/faq) | "Suggest new application"; many declined; no tracking tags | Day 10 |-| 0PandaDEV/awesome-windows | [CONTRIBUTING](https://github.com/0PandaDEV/awesome-windows/blob/main/CONTRIBUTING.md) | One item per PR, title case, alphabetical, or the "Add Application" issue form; rejects "vibecoded slop" | Day 10 |-| cuongtk8/awesome-linux-apps | [repo](https://github.com/cuongtk8/awesome-linux-apps) | `[Name](link) - Short description. 👏` (👏 = open source), one per PR, alphabetical | Day 10 |-| rust-unofficial/awesome-rust | [CONTRIBUTING](https://github.com/rust-unofficial/awesome-rust/blob/main/CONTRIBUTING.md) | **Needs >50 stars** (or >2,000 downloads); Applications section; alphabetical; CI badge | Day 14 if ≥50★ |-| Scoop Extras | [request form](https://github.com/ScoopInstaller/Extras/blob/master/.github/ISSUE_TEMPLATE/package-request.yml) | **≥100 stars and/or 50 forks**; open an issue first; portable install, `checkver`/`autoupdate` | When ≥100★ |-| OpenAlternative | [submit](https://openalternative.co/submit) | Feeds piotrkulpinski/open-source-alternatives; free queue reported at ~5 months (unverified) | Day 10 (free queue) |-| Lissy93/awesome-privacy | [CONTRIBUTING](https://github.com/Lissy93/awesome-privacy/blob/main/.github/CONTRIBUTING.md) | **First stable release must be >4 months old**; human-written PR text; fit is arguable | Not before ~Mar 2027 |-| Flathub | [requirements](https://docs.flathub.org/docs/for-app-authors/requirements) | Builds, portals, screenshots in metainfo, verified via GitHub | Submit T-21; announce when live |--**Not open:** luong-komorebi/Awesome-Linux-Software (archived May 2026 over self-promotion),-tauri-apps/awesome-tauri (no longer accepts applications), Awesome-Windows/Awesome (404), both-awesome-local-first lists (closed or stale), opensourcealternative.to (self-hosted only),-Privacy Guides (needs a threat model; poor fit), Lobsters (invite-only; new accounts can't-self-promote for 70 days).--### 5.7 When to ask for stars, honestly--- **In the README footer, once:** "If Skykeep saves you a trip to the browser, a star helps- other iPhone owners on Linux and Windows find it." True and specific.-- **In release notes**, the same single line.-- **Never** in HN, Reddit or PH posts (on PH and HN that's vote solicitation), never in DMs,- never as a condition for support, and never as a pop-up in the app. A star prompt inside the- app would also contradict the calm brand.-- Stars are a by-product of the real work: fast replies to issues, visible fixes and good- release notes.-------## 6. Risks and responses--### 6.1 Likely objections and calm, true answers--Same facts everywhere. Short. Link the source. Never argue twice with the same person.--**"Isn't this against Apple's terms?"**-> Skykeep signs in the way icloud.com does, with Apple's own two-factor, and syncs your own data when you use it. It doesn't scrape, bulk-download for others, or pretend to be an Apple device. Unofficial iCloud clients like icloudpd and rclone's iCloud backend have existed for years. I can't promise how Apple reads its terms. It's your account, and it's open source, so you can see exactly what it does.--(Never say "Apple allows this" or "it's legal". Neither is yours to claim.)--**"Why should I give a stranger's app my Apple password?"**-> You shouldn't on trust alone, which is why it's open source. Sign-in uses Apple's SRP protocol, so the password is never sent, not even to Apple. It's kept in your system keyring so Skykeep can sign back in by itself. SECURITY.md is explicit that any program running as you can read keyring entries. There's no Skykeep server for it to go to; the code that limits each connection is in `apple_only()` and its tests.--**"Why not an app-specific password?"**-> Apple's app-specific passwords only reach mail, contacts and calendars. Notes, Reminders, Drive and Photos need the full sign-in with two-factor, the same one icloud.com uses. rclone's iCloud backend has the same requirement.--**"Why not just use icloud.com?"**-> If it works for you, great. Skykeep is for when you want your library on your disk: instant, offline, desktop alerts, Drive as a folder, search from your launcher, and an export whenever you want.--**"It's Tauri, so it's not native."**-> Fair: the windows are Tauri webviews. The engine (sync, storage, CloudKit decoding, the network locks) is Rust. "Native" in the README means real apps on your machine, not a website in a window.--**"Apple will break it."**-> Possibly. When Apple changes something, your library stays readable offline, Skykeep tells you instead of failing silently, and the fix ships as a signed update (AppImage and Windows) or through your package manager.--**"It phones home to GitHub."**-> Only the AppImage and Windows installer copies, once a day, for `latest.json`, and you can turn it off in Settings ▸ Software Update. It sends nothing about you, though GitHub sees your IP like any website. deb, rpm, AUR and Flatpak copies never contact GitHub.--**"Windows says it's unsafe."**-> The installer isn't code-signed with a certificate yet, so SmartScreen asks you to confirm. The checksums are on the release page, the builds come from the public CI, and in-app updates are signature-checked. Signing is on the roadmap (SignPath Foundation for open source).--**"Is my data encrypted on disk?"**-> Cookies are encrypted with a key in your keyring. The library itself isn't encrypted by Skykeep; use full-disk encryption, as you would on a Mac.--**"Advanced Data Protection?"**-> Works with "Access iCloud Data on the Web" turned on. With it off, Apple doesn't let any app outside your devices read the data, Skykeep included, and Skykeep says so instead of working around it.--**"Was this built with AI?"** If asked, answer truthfully and briefly, in your own words.-Don't lead with it, and don't deny it. What matters to readers is that it works, is tested,-and that you stand behind it.--**"Another iCloud-on-Linux project already exists."**-> Yes, and they're good work: icloud-for-omarchy does native Notes on Arch, rclone does Drive, icloudpd does Photos. Skykeep puts the six apps together with one sign-in and an offline library, on Linux and Windows.--### 6.2 Tactics that would backfire (don't)--- **Asking anyone to upvote** on HN, Reddit or PH, including friends, a WhatsApp group or your- class. HN and PH detect voting rings and penalise or ban the post, account and domain.-- Sharing the HN link with "go comment". Same rule.-- **Second accounts** to comment, upvote or post "I tried it, it's great". That's- astroturfing; mods compare IPs and account age.-- **Bought stars, star exchanges or bot stars.** An ICSE 2026 study found about 6M fake stars,- and the boost fades within two months and then becomes a liability.-- **LLM-written posts on HN** (explicitly asked against since March 2026), r/opensource,- Privacy Guides and awesome-privacy (human-written text required).-- Cross-posting the same text to many subs on one day.-- False urgency ("launch-day only"), fake scarcity, or countdown timers. Nothing about Skykeep- is scarce: it's free.-- Any superlative you can't prove ("first", "only", "fastest"), any Apple imagery, any- "official".-- Deleting and reposting a flopped HN post.-- Arguing with critics. Answer once, with facts, then thank them.--### 6.3 Crisis plan for launch day--**Before Day 1:** a `v0.1.1` hotfix rehearsal done (gate 3); a pinned-issue template ready; the-README's top line editable in one commit.--| Situation | First 30 minutes | Then |-|---|---|---|-| **Sign-in broken for many** (Apple changed something, or a bug) | Pin "Known issue: sign-in" with what's affected and what's safe ("your library stays readable offline; nothing is deleted"). One reply in each thread linking it. | Fix; ship v0.1.1 through the release pipeline; the updater reaches AppImage/Windows users; post the fix in the same threads. |-| **Data-loss report** (a note or reminder lost or duplicated) | Treat as P0. Ask for steps, never for passwords or token logs. If it's real, say so publicly and advise the safe action (e.g. avoid that edit path). | Fix with a test that fails without it; release; write a short, honest postmortem in the issue. |-| **Installer fails on a distro or on Windows** | Confirm the reproduction; add a line to the pinned issue with the workaround (e.g. AppImage `--appimage-extract-and-run`). | Fix the package in v0.1.1. |-| **The HN thread turns hostile** (ToS, password, "AI slop") | Reply once with facts and links (§6.1). Don't defend twice. Upvote nothing. | Let the work answer: fix what's fair, credit the critic in release notes. |-| **A trademark or legal email** | Don't reply in public. Read it carefully, change any wording or imagery it reasonably asks for, and get advice if it's more than that. | Note it in a private file, not in the repo. |-| **You're overwhelmed** | Use the pinned issues as single places to collect reports. Reply "thanks, tracking in #N" and move on. | Turn off notifications for starred-only events; sleep. A 24-hour response time is fine after Day 2. |--There are **no Skykeep servers**, so launch traffic can't take the app down. The only-dependency is GitHub Releases. Say that if anyone asks about scaling.-------## 7. Metrics and targets--**Sources only:** public counters. No telemetry in the app, ever.-- GitHub stars, forks, watchers, traffic (Insights → Traffic: views, unique visitors, referrers).-- Release asset download counts (GitHub API). **`latest.json` downloads** count the daily update- checks from AppImage and Windows copies: a rough, anonymous proxy for active installs, counted- by GitHub, not by Skykeep. Describe it that way if you ever cite it.-- AUR votes and popularity; Flathub install stats once live; winget has no public counts.-- HN points and rank (manual); Reddit upvotes; PH rank.-- Issues: median first response; ratio of "it works" install reports to "it failed".-- Coverage log: articles, videos, podcasts, with links.--**Targets.** These are planning numbers, not forecasts, in three bands. The category's HN-history (most Show HNs at 1–10 points) makes "floor" the honest base case. Press and Reddit-carry the launch.--| Day | Stars (floor / good / breakout) | Downloads (all assets, excl. `latest.json`) | Other |-|---|---|---|---|-| 1 | 75 / 300 / 1,500 | 150 / 600 / 3,000 | ≥1 article live; r/linux post ≥100 upvotes; every comment answered |-| 2 | 125 / 450 / 2,200 | 250 / 900 / 4,500 | winget PR open |-| 3 | 175 / 600 / 2,800 | 350 / 1,200 / 5,500 | Blog post live; 2 articles |-| 5 | 225 / 750 / 3,300 | 450 / 1,500 / 6,500 | v0.1.1 shipped if needed; median issue response <12 h |-| 7 | 300 / 900 / 3,800 | 600 / 1,800 / 7,500 | 3 pieces of coverage; ≥1 external PR |-| 10 | 375 / 1,100 / 4,300 | 750 / 2,300 / 9,000 | Windows wave sent; winget merged |-| 14 | 450 / 1,300 / 5,000 | 900 / 2,800 / 10,000 | ≥50★ unlocks awesome-rust; ≥100★ unlocks Scoop; AUR ≥20 votes; 3 external contributors |-| 30 | 700 / 1,800 / 6,500 | 1,500 / 4,000 / 14,000 | 6 coverage items; 0 open data-loss bugs |--**Daily leading indicators (watch these over stars):**-1. Issues mentioning **sign-in** or **sync wrong**. Trust breaks faster than stars grow.-2. Install success ratio (pinned install-report issue): aim above 5:1.-3. Median first response to issues: under 12 h in week 1, under 24 h after.-4. Referrers in GitHub Traffic: tells you which channel actually worked. Double down there.--**Review on Day 7** and reset the bands to what really happened.-------## 8. One-page checklist--- [ ] Gates 1–8 (§0) true-- [ ] Film shot on a demo account with a real phone (§4.1); 16:9, 9:16, 1:1 cut-- [ ] Press kit in `press/`; fact sheet numbers re-run-- [ ] Stale lines in `github-setup.md` replaced (§0)-- [ ] README: download buttons, phone clip, trust row (§5.1)-- [ ] About box, topics, social preview (§5.2); Discussions; pinned issues; 12–15 good-first-issues-- [ ] T-7 pitches sent (Tier 1: rows 1–10)-- [ ] HN text written **by you** (§2.3); blog post written by you (§2.9)-- [ ] Day 1 blocked out; hotfix path rehearseddiff --git a/docs/macos27-kit.md b/docs/macos27-kit.mddeleted file mode 100644index a45acac..0000000--- a/docs/macos27-kit.md+++ /dev/null@@ -1,1300 +0,0 @@-# macOS 27 — tokens from Apple's Figma kit---## Variables: Colors-Modes: Light, Dark--| Name | Light | Dark |-|---|---|---|-| Accents/Red | #ff383c | #ff4245 |-| Accents/Orange | #ff8d28 | #ff9230 |-| Accents/Yellow | #ffcc00 | #ffd600 |-| Accents/Green | #34c759 | #30d158 |-| Accents/Mint | #00c8b3 | #00dac3 |-| Accents/Teal | #00c3d0 | #00d2e0 |-| Accents/Cyan | #00c0e8 | #3cd3fe |-| Accents/Blue | #0088ff | #0091ff |-| Accents/Indigo | #6155f5 | #6d7cff |-| Accents/Purple | #cb30e0 | #db34f2 |-| Accents/Pink | #ff2d55 | #ff375f |-| Accents/Brown | #ac7f5e | #b78a66 |-| Fills - Opaque/Primary | #0000001a | #ffffff1a |-| Fills - Opaque/Secondary | #00000014 | #ffffff14 |-| Fills - Opaque/Tertiary | #0000000d | #ffffff0d |-| Fills - Opaque/Quaternary | #00000008 | #ffffff08 |-| Fills - Opaque/Quinary | #00000005 | #ffffff05 |-| Fills - Vibrant (Use Plus Lighter | Darker)/Primary | #d9d9d9 | #242424 |-| Fills - Vibrant (Use Plus Lighter | Darker)/Secondary | #e6e6e6 | #141414 |-| Fills - Vibrant (Use Plus Lighter | Darker)/Tertiary | #f2f2f2 | #0d0d0d |-| Fills - Vibrant (Use Plus Lighter | Darker)/Quaternary | #f7f7f7 | #090909 |-| Fills - Vibrant (Use Plus Lighter | Darker)/Quinary | #fbfbfb | #070707 |-| Labels/Primary | #000000d9 | #ffffffd9 |-| Labels/Secondary | #00000080 | #ffffff8c |-| Labels/Tertiary | #00000040 | #ffffff40 |-| Labels/Quaternary | #0000001a | #ffffff1a |-| Labels/Quinary | #0000000d | #ffffff0d |-| Labels/White | #ffffff | #ffffff |-| Labels - Vibrant (Use Plus Lighter | Darker)/Primary | #1a1a1a | #f5f5f5 |-| Labels - Vibrant (Use Plus Lighter | Darker)/Secondary | #727272 | #8a8a8a |-| Labels - Vibrant (Use Plus Lighter | Darker)/Tertiary | #bfbfbf | #404040 |-| Labels - Vibrant (Use Plus Lighter | Darker)/Quaternary | #d9d9d9 | #262626 |-| Labels - Vibrant (Use Plus Lighter | Darker)/Quinary | #e6e6e6 | #111111 |-| Material/Ultra Thick | #f6f6f6d6 | #282828cc |-| Material/Thin | #f6f6f67a | #28282880 |-| ❌Checkbox/Checkbox Disabled | #ff9900 | #ff9900 |-| ❌Miscellaneous/Arrow Button Background - Enabled | #ff0000 | #ff0000 |-| ❌Miscellaneous/Arrow Button Background - Disabled | #ff0000 | #ff0000 |-| Mode | Light | Dark |-| Grays/Black | #000000 | #000000 |-| Grays/White | #ffffff | #ffffff |-| Labels/Seximal | #00000008 | #ffffff08 |-| Grays/Gray | #8e8e93 | #98989f |-| Glyphs/Primary - Idle | #ffffff | #ffffff |-| Glyphs/Primary - Disabled | #ffffff80 | #ffffff80 |-| Accents - Vibrant/Red | #f52f32 | #ff4747 |-| Accents - Vibrant/Orange | #f58625 | #ff9e33 |-| Accents - Vibrant/Yellow | #f5c200 | #ffe014 |-| Accents - Vibrant/Green | #26bf4d | #3bdb63 |-| Accents - Vibrant/Mint | #00bda9 | #2de0cd |-| Accents - Vibrant/Teal | #00b3bf | #2dd7e0 |-| Accents - Vibrant/Cyan | #00abcf | #47d8fc |-| Accents - Vibrant/Blue | #0078f0 | #0a99ff |-| Accents - Vibrant/Indigo | #5c50e6 | #7163ff |-| Accents - Vibrant/Purple | #b72bc9 | #e647fc |-| Accents - Vibrant/Pink | #f5234b | #ff4169 |-| Accents - Vibrant/Brown | #9e7354 | #c29672 |-| Controls/Tint | #ff00aa | #ff00aa |-| Window Background | #ffffff | #1e1e1e |-| Miscellaneous/Tooltips/Inner Stroke | #ffffff00 | #ffffff26 |-| Miscellaneous/Alerts/Overlay | #ababab99 | #1717179e |-| Miscellaneous/Scrollbar | #00000080 | #ffffff8c |-| Miscellaneous/Progress Bars/Track - Stroke | #00000012 | #ffffff0a |-| Miscellaneous/Tables/BG - Selected + Inactive | #00000024 | #ffffff2e |-| Miscellaneous/Tables/Alternating Row Color | #0000000d | #ffffff0d |-| Miscellaneous/Tables/BG - Selected + Active | #0165e2 | #0158d2 |-| Miscellaneous/Tables/Column Separator | #0000001a | #ffffff1a |-| Miscellaneous/Tooltips/Sidebar - BG - Active | #dae6f2 | #141517 |-| Miscellaneous/Tooltips/Sidebar - BG - Inactive | #edf4fa | #131414 |-| Miscellaneous/Sidebar/Label - Inactive | #878787 | #666666 |-| String | String value | String value |--## Variables: Colors-Modes: Light, Dark, IC - Light, IC - Dark--| Name | Light | Dark | IC - Light | IC - Dark |-|---|---|---|---|---|--## Variables: Sizes-Modes: Mini, Small, Medium, Large, XL--| Name | Mini | Small | Medium | Large | XL |-|---|---|---|---|---|---|-| Global/Height | 16 | 20 | 24 | 28 | 36 |-| Global/Radius | 4 | 5 | 6 | 7 | 9 |-| Button/Padding - Horizontal | 7 | 10 | 16 | 16 | 16 |-| Button/Vertical Padding | 2 | 3 | 4 | 6 | 10 |-| Button/Radius | → Global/Radius | → Global/Radius | → Global/Radius | 1000 | 1000 |-| Toggle (Switch)/Track - Height | → Global/Height | → Global/Height | → Global/Height | → Global/Height | → Global/Height |-| Toggle (Switch)/Track - Width | 36 | 44 | 54 | 64 | 80 |-| Toggle (Switch)/Knob - Inset | 1.5 | 2 | 2 | 2 | 3 |-| Toggle (Switch)/Knob - Width | 21 | 26 | 32 | 38 | 47 |-| Cursor/Height | 14 | 16 | 18 | 18 | 18 |-| Global/Font Size | 10 | 11 | 13 | 13 | 13 |-| Fields/Inset - Left | 6 | 6 | 8 | 8 | 10 |-| Fields/Inset - Right | 6 | 6 | 8 | 8 | 10 |-| Fields/Font Size - Search Glyph | 11 | 13 | 13 | 13 | 13 |-| Fields/Leading - Search Glyph | 13 | 15 | 15 | 15 | 15 |-| Dial/Height - Knob | 4 | 5 | 6 | 6 | 7 |-| Dial/Inset - Knob | 2 | 2.5 | 3 | 3 | 3 |-| Disclosure/Font Size | 10 | 10 | 13 | 13 | 13 |-| Disclosure/Height - Symbol | 16 | 21 | 25 | 29 | 38 |-| Arrow Button/Font Size | 11 | 13 | 13 | 13 | 13 |-| Popup/Font Size - Chevron | 10 | 11 | 11 | 13 | 13 |-| Popup/Inset - Left | 7 | 10 | 12 | 14 | 18 |-| Menu/Height | 19 | 22 | 24 | 24 | 24 |-| Menu/Font Size | 10 | 11 | 13 | 13 | 13 |-| Menu/Font Size - Symbol | 11 | 11 | 13 | 13 | 13 |-| Menu/Width - Symbol | 6 | 10 | 12 | 12 | 12 |-| Menu/Inset - Top - Header | 3 | 4 | 5 | 5 | 5 |-| Menu/Inset - Bottom - Header | 2 | 3 | 4 | 4 | 4 |-| Menu/Inset - Left - Header | 14 | 18 | 20 | 20 | 20 |-| Radio Button/Width | 12 | 14 | 16 | 18 | 18 |-| Radio Button/Width - Dot | 4 | 4.8 | 4.8 | 5 | 5 |-| Radio Button/Width - Dash | 5.5 | 6.5 | 6.5 | 8 | 8 |-| Radio Button/Height - Dash | 1.7 | 2 | 2 | 2 | 2 |-| Radio Button/Spacing | 3 | 3 | 3 | 5 | 7 |-| Checkboxes/Width | → Radio Button/Width | → Radio Button/Width | → Radio Button/Width | → Radio Button/Width | → Radio Button/Width |-| Checkboxes/Width - Checkmark | 7.78 | 9.31 | 9.31 | 11.72 | 11.72 |-| Checkboxes/Height - Checkmark | 7.55 | 8.93 | 8.93 | 11.3 | 11.3 |-| Checkboxes/Radius | 3.5 | 4.5 | 5.5 | 6.5 | 6.5 |-| Segmented Control/Margins | 6 | 8 | 10 | 12 | 14 |-| Segmented Control/Height - Separator | 10 | 12 | 14 | 18 | 20 |-| Combo Button/Inset | 2 | 2 | 2 | 2 | 3 |-| Combo Button/Width - Button | 16 | 20 | 24 | 24 | 30 |-| Combo Button/Radius - Button | 2.5 | 3.5 | 4.5 | 5.5 | 6.5 |-| Combo Button/Font Size - Chevron | 9 | 10 | 11 | 12.5 | 13 |-| Slider/Knob - Non-ticked Slider/Width | 16 | 18 | 20 | 24 | 24 |-| Slider/Track/Inset - Vertical | 1 | 1 | 1 | 0 | 0 |-| Slider/Track/Inset - Horizontal | 1 | 1 | 1 | 0 | 0 |-| Slider/Knob - Non-ticked Slider/Inset | 2 | 1 | 0 | -2 | -2 |-| Slider/Knob - Non-ticked Slider/Height | 12 | 14 | 16 | 20 | 20 |-| Slider/Knob - Ticked Slider/Height - Clicked | 20 | 23 | 20 | 25 | 25 |-| Slider/Knob - Ticked Slider/Width - Clicked | 10 | 13 | 25 | 30 | 30 |-| Slider/Knob - Ticked Slider/Width | 8 | 10 | 20 | 24 | 24 |-| Slider/Knob - Ticked Slider/Height | 16 | 18 | 16 | 20 | 20 |-| Slider/Track/Tick Spacing | 2 | 2 | 2 | 3 | 3 |-| Stepper/Width | 13 | 17 | 20 | 23 | 30 |-| Stepper/Radius | 4 | 5 | 6 | 7 | 9 |-| Stepper/Font Size | 8 | 9 | 12 | 12 | 12 |-| Stepper/Width - Separator | 9 | 11 | 14 | 15 | 20 |-| Color Well/Width | 32 | 40 | 48 | 56 | 72 |-| Color Well/Height | 16 | 20 | 24 | 28 | 36 |-| Disclosure/Radius | 4 | 5 | 6 | 1000 | 1000 |-| Toggle (Switch)/Knob - Height | 13 | 16 | 20 | 24 | 30 |-| Toggle (Switch)/Knob - Clicked - Height | 20 | 26 | 31 | 37 | 46 |-| Toggle (Switch)/Knob - Clicked - Width | 33 | 40 | 50 | 59 | 73 |-| Mode | Mini | Small | Medium | Large | XL |-| Slider/Knob - Non-ticked Slider/Height - Clicked | 15 | 18 | 20 | 25 | 25 |-| Slider/Knob - Non-ticked Slider/Width - Clicked | 20 | 23 | 25 | 30 | 30 |-| Combo Button/Text - Inset - Right | 20 | 24 | 28 | 28 | 34 |--## Variables: Kit-Modes: Mode 1--| Name | Mode 1 |-|---|---|-| Component Fill | #0000001a |-| Component Stroke | #c399ff |-| Subcomponent Fill | #0000001a |-| Subcomponent Stroke | #00000066 |-| Section Fill | #0000001a |-| Section Stroke | #00000066 |-| Liquid Glass/Depth - Regular | 30 |-| Liquid Glass/Dispersion | 20 |-| Liquid Glass/Frost - Regular | 6 |-| Liquid Glass/Splay - Regular | 20 |-| Liquid Glass/Light Angle | 0 |-| Liquid Glass/Refraction | 70 |-| Liquid Glass/Frost - Medium | 16 |-| Liquid Glass/Depth - Medium and Large | 30 |-| Liquid Glass/Frost - Large | 16 |-| Liquid Glass/Splay - Medium and Large | 20 |-| Liquid Glass/Opacity | 25 |-| Link | #98ccff |--## Variables: Context-Modes: Content Area, Over-glass--| Name | Content Area | Over-glass |-|---|---|---|-| Mode | Content Area | Over-glass |--## Variables: Colors-Modes: Light, Dark, IC - Light, IC - Dark--| Name | Light | Dark | IC - Light | IC - Dark |-|---|---|---|---|---|--## Variables: Kit-Modes: Mode--| Name | Mode |-|---|---|--## Text styles-| Style | Font | Size | Line height | Tracking |-|---|---|---|---|---|-| Large Title/Regular | SF Pro Regular | 26 | 32px | 0% |-| Large Title/Emphasized | SF Pro Bold | 26 | 32px | 0% |-| Title 1/Regular | SF Pro Regular | 22 | 26px | 0% |-| Title 1/Emphasized | SF Pro Bold | 22 | 26px | 0% |-| Title 2/Regular | SF Pro Regular | 17 | 22px | 0% |-| Title 2/Emphasized | Inter Bold | 17 | 22px | 0% |-| Title 3/Regular | SF Pro Regular | 15 | 20px | 0% |-| Title 3/Emphasized | SF Pro Semibold | 15 | 20px | 0% |-| Headline/Regular | SF Pro Bold | 13 | 16px | 0% |-| Headline/Emphasized | SF Pro Heavy | 13 | 16px | 0% |-| Body/Regular | SF Pro Regular | 13 | 16px | 0% |-| Body/Emphasized | SF Pro Semibold | 13 | 16px | 0% |-| Callout/Regular | SF Pro Regular | 12 | 15px | 0% |-| Callout/Emphasized | SF Pro Semibold | 12 | 15px | 0% |-| Subheadline/Regular | SF Pro Regular | 11 | 14px | 0% |-| Subheadline/Emphasized | SF Pro Semibold | 11 | 14px | 0% |-| Footnote/Regular | SF Pro Regular | 10 | 13px | 0% |-| Footnote/Emphasized | SF Pro Semibold | 10 | 13px | 0% |-| Caption 1/Regular | SF Pro Regular | 10 | 13px | 0% |-| Caption 1/Emphasized | SF Pro Medium | 10 | 13px | 0% |-| Caption 2/Regular | SF Pro Medium | 10 | 13px | 0% |-| Caption 2/Emphasized | SF Pro Semibold | 10 | 13px | 0% |-| Large Title/2 | Inter Regular | 12 | 100% | 0% |-| XLTitle1 | SF Pro Bold | 48 | 56px | 0px |--## Effect styles (shadows, blurs)-- **Shadows - Light/Primary**: DROP_SHADOW #0000008c x0 y0 blur3 spread0; DROP_SHADOW #00000066 x0 y36 blur100 spread0-- **Shadows - Light/Secondary**: DROP_SHADOW #0000008c x0 y0 blur3 spread0; DROP_SHADOW #00000040 x0 y8 blur40 spread0-- **Shadows - Light/Tertiary**: DROP_SHADOW #0000008c x0 y0 blur3 spread0; DROP_SHADOW #00000040 x0 y36 blur100 spread0-- **Shadows - Light/Quaternary**: DROP_SHADOW #0000008c x0 y0 blur3 spread0; DROP_SHADOW #00000040 x0 y4 blur20 spread0-- **Shadows - Light/WIndow Inner Shadow**: INNER_SHADOW #ffffff1a x0 y0 blur3 spread0-- **Medium Background Blur**: BACKGROUND_BLUR #00000040 x0 y4 blur30 spread0-- **Shadows - Dark/Primary**: DROP_SHADOW #000000b2 x0 y36 blur100 spread0; DROP_SHADOW #000000 x0 y0 blur1 spread1-- **Shadows - Dark/Secondary**: DROP_SHADOW #000000b2 x0 y8 blur40 spread0; DROP_SHADOW #000000 x0 y0 blur1 spread1-- **Shadows - Dark/Tertiary**: DROP_SHADOW #00000073 x0 y36 blur100 spread0; DROP_SHADOW #000000 x0 y0 blur1 spread1-- **Shadows - Dark/Quaternary**: DROP_SHADOW #00000073 x0 y4 blur20 spread0; DROP_SHADOW #000000 x0 y0 blur1 spread1-- **Shadows - Dark/Window Inner Shadow**: INNER_SHADOW #ffffff33 x0 y0 blur1 spread1--## Fill styles-- Accents/Default: #007aff-- Accents/Blue: #007aff-- Accents/Brown: #a2845e-- Accents/Cyan: #55bef0-- Accents/Gray: #8e8e93-- Accents/Green: #28cd41-- Accents/Indigo: #5856d6-- Accents/Mint: #00c7be-- Accents/Orange: #ff9500-- Accents/Pink: #ff2d55-- Accents/Purple: #af52de-- Accents/Red: #ff3b30-- Accents/Teal: #59adc4-- Accents/Yellow: #ffcc00-- Accents/Default - Dark: #0a84ff-- Accents/Blue - Dark: #0a84ff-- Accents/Brown - Dark: #ac8e68-- Accents/Cyan - Dark: #5ac8f5-- Accents/Gray - Dark: #98989d-- Accents/Green - Dark: #32d74b-- Accents/Indigo- Dark: #5e5ce6-- Accents/Mint - Dark: #66d4cf-- Accents/Orange - Dark: #ff9f0a-- Accents/Pink - Dark: #ff375f-- Accents/Purple - Dark: #bf5af2-- Accents/Red - Dark: #ff453a-- Accents/Teal - Dark: #6ac4dc-- Accents/Yellow - Dark: #ffd60a-- Accents - Vibrant/Default: #0070f5-- Accents - Vibrant/Blue: #0070f5, #0070f566-- Accents - Vibrant/Brown: #987a54, #987a5466-- Accents - Vibrant/Cyan: #41afdc, #41afdc66-- Accents - Vibrant/Gray: #848489, #84848966-- Accents - Vibrant/Green: #1ec337, #1ec33766-- Accents - Vibrant/Indigo: #5452cc, #5452cc66-- Accents - Vibrant/Mint: #00bdb4, #00bdb466-- Accents - Vibrant/Orange: #f58b0066, #f58b00-- Accents - Vibrant/Pink: #f5234b, #f5234b66-- Accents - Vibrant/Purple: #9f4bc9, #9f4bc966-- Accents - Vibrant/Red: #f5312666, #f53126-- Accents - Vibrant/Teal: #2ea7bd, #2ea7bd66-- Accents - Vibrant/Yellow: #f5c20066, #f5c200-- Accents (Vibrant) - Dark/Default: #148eff-- Accents - Vibrant/Blue - Dark: #148eff-- Accents - Vibrant/Brown - Dark: #b69872-- Accents - Vibrant/Cyan - Dark: #5acdfa-- Accents - Vibrant/Gray - Dark: #a2a2a7-- Accents - Vibrant/Green - Dark: #3ce155-- Accents - Vibrant/Indigo - Dark: #6361f2-- Accents - Vibrant/Mint - Dark: #6ce0db-- Accents - Vibrant/Orange - Dark: #ffa914-- Accents - Vibrant/Pink - Dark: #ff4169-- Accents - Vibrant/Purple - Dark: #cc65ff-- Accents - Vibrant/Red - Dark: #ff4f44-- Accents - Vibrant/Teal - Dark: #44d4fa-- Accents - Vibrant/Yellow - Dark: #ffe014-- Fills/Primary: #ff0000-- Fills/Secondary: #ff0000-- Fills/Tertiary: #ff0000-- Fills/Quaternary: #ff0000-- Fills/Quinary: #ff0000-- Fills/Primary - Dark: #ffff00-- Fills/Secondary - Dark: #ffff00-- Fills/Tertiary - Dark: #ffff00-- Fills/Quaternary - Dark: #ffff00-- Fills/Quinary - Dark: #ffff00-- Fills - Vibrant/Primary: #ffaa00-- Fills - Vibrant/Secondary: #ffaa00-- Fills - Vibrant/Tertiary: #ffaa00-- Fills - Vibrant/Quaternary: #ffaa00-- Fills - Vibrant/Quinary: #ffaa00-- Fills - Vibrant/Primary - Dark: #8239ff-- Fills - Vibrant/Secondary - Dark: #8239ff-- Fills - Vibrant/Tertiary - Dark: #8239ff-- Fills - Vibrant/Quaternary - Dark: #8239ff-- Fills - Vibrant/Quinary - Dark: #8239ff-- Text/Primary: #000000d9-- Text/Secondary: #00000080-- Text/Tertiary: #00000040-- Text/Primary - Dark: #ffffffd9-- Text/Secondary - Dark: #ffffff8c-- Text/Tertiary - Dark: #ffffff40-- Text - Vibrant/Primary: #4d4d4d-- Text - Vibrant/Secondary: #808080-- Text - Vibrant/Tertiary: #c6c6c6-- Text - Vibrant/Primary - Dark: #e5e5e5-- Text - Vibrant/Secondary - Dark: #7c7c7c-- Text - Vibrant/Tertiary - Dark: #414141-- Medium: #f6f6f699-- Text/Quinary: #0000000d-- Text/Quaternary: #0000001a-- Text/Quaternary - Dark: #ffffff1a-- Text/Quinary - Dark: #ffffff0d-- Text - Vibrant/Quaternary: #bfbfbf-- Text - Vibrant/Quinary: #bfbfbf-- Text - Vibrant/Quaternary - Dark: #414141-- Text - Vibrant/Quinary - Dark: #414141-- Colors/Black: #000000-- Colors/Blue: #0a84ff-- Labels/Primary: #000000-- Colors/Gray: #98989d-- _Template/Section Fill: #ff99ff-- Materials - Controls/Header View: #ffffffcc-- Materials - Controls/Header View - Dark: #1e1e1ecc, #2852ad14-- Materials - Controls/Menu - Dark: #f6f6f6b8-- Materials - Controls/Menu: #28282894-- Materials - Controls/Popover - Dark: #f6f6f699-- Materials - Controls/Popover: #00000047-- Materials - Controls/Fullscreen - Dark: #28282880-- Materials - Controls/HUD - Dark: #28282880-- Materials - Controls/Selection Focused - Dark: #0a82ff, #0a82ffbf-- Materials - Controls/Selection Focused: #0069f9-- Materials - Controls/Selection Unfocused: #f6f6f6d6, #0000001a-- Materials - Controls/Selection Unfocused - Dark: #282828a6, #ffffff1a-- Materials - Controls/Sidebar: #eaeaead6-- Materials - Controls/Sidebar - Dark: #00000073-- Materials - Controls/Title Bar: #eaeaeacc-- Materials - Controls/Title Bar - Dark: #3c3c3ccc-- Materials - Controls/Tooltip: #ff000099-- Materials - Controls/Tooltip - Dark: #ff0000cc-- Materials - Controls/Under Window Background: #f6f6f6d6-- Materials - Controls/Under Window Background - Dark: #00000073-- Materials/Ultrathick: #333333, #ececece0-- Materials/Ultrathick - Dark: #00000080-- Materials/Thick: #f6f6f6b8-- Materials/Thick - Dark: #00000066-- Materials/Medium: #f6f6f699-- Materials/Medium - Dark: #0000004a-- Materials/Thin: #f6f6f67a-- Materials/Thin - Dark: #00000033-- Materials/Ultrathin: #f6f6f65c-- Materials/Ultrathin - Dark: #0000001a-- Material - Light/Material - Dark: #d9d9d9-- White: #ffffff-- Materials - Controls: #d9d9d9-- Text - Vibrant/Primary: #4c4c4c-- Text - Vibrant/Secondary: #808080-- Text - Vibrant/Tertiary: #bfbfbf-- aaa Test: #ff00ff, #00ffff33-- Content Area/Bordered Neutral/On, Disabled: #0000000f-- Content Area/Bordered Neutral/Off, Idle: #0000000d-- Content Area/Bordered Neutral/On, Clicked: #00000033-- Content Area/Bordered Neutral/On, Idle: #00000021-- Content Area/Bordered Neutral/Off, Disabled: #0000000a-- Content Area/Bordered Neutral/Off, Clicked: #00000026-- Content Area/Bordered Colored/Active, On, Disabled: #e6e6e640, #0088ff38-- Content Area/Bordered Colored/Inactive, On, Idle: #0088ff80, #0088ff80, #0088ff-- Content Area/Bordered Colored/Inactive, On, Clicked: #0088ff80, #0088ff80, #00000014, #0088ff80-- Content Area/Bordered Colored/Inactive, On, Disabled: #0088ff40-- Content Area/Bordered Colored/Active, On, Idle: #0088ff80, #0088ff80, #0000001a, #0088ff-- Content Area/Bordered Colored/Active, On, Clicked: #0088ff80, #0088ff80, #0000002e, #0088ff-- Colors/Blue: #0091ff--## Components (by page): size, corner radius, padding, gap--### Lists and Tables (41)-- Group Title: 150×45 HORIZONTAL pad 24/8/7/50 gap 16-- First Column=True, Selected=True: 150×19 HORIZONTAL pad 0/6/0/50 gap 0-- First Column=True, Selected=False: 150×19 HORIZONTAL pad 0/6/0/50 gap 0-- First Column=False, Selected=False: 150×19 HORIZONTAL pad 0/6/0/8 gap 0-- First Column=False, Selected=True: 150×19 HORIZONTAL pad 0/6/0/8 gap 0-- Expanded=False: 5×20-- Expanded=True: 5×20-- Expanded=False: 5×20-- Expanded=True: 5×20-- State=Selected + Active: 60×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- State=Selected + Inactive: 60×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- State=Alternating Row Color: 60×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Type=Folder: 18×18 HORIZONTAL pad 2/2/2/2 gap 10-- Type=Thumbnail: 18×18 HORIZONTAL pad 2/2/2/2 gap 10-- Type=Custom: 18×18 HORIZONTAL pad 2/2/2/2 gap 10-- Level=0, Type=Selected + Active: 600×20 HORIZONTAL pad 0/0/0/0 gap 0-- Level=0, Type=Selected + Inactive: 600×20 HORIZONTAL pad 0/0/0/0 gap 0-- Level=0, Type=Alternating Row Color: 600×20 HORIZONTAL pad 0/0/0/0 gap 0-- Level=0, Type=Default: 600×20 HORIZONTAL pad 0/0/0/0 gap 0-- Alternating Row=True: 600×20 HORIZONTAL pad 0/0/0/0 gap 0-- Alternating Row=False: 600×20 HORIZONTAL pad 0/0/0/0 gap 0-- Level=1, Type=Selected + Active: 600×20 HORIZONTAL pad 0/15/0/15 gap 0-- Level=2, Type=Selected + Active: 600×20 HORIZONTAL pad 0/30/0/30 gap 0-- Level=3, Type=Selected + Active: 600×20 HORIZONTAL pad 0/45/0/45 gap 0-- Level=4, Type=Selected + Active: 600×20 HORIZONTAL pad 0/60/0/60 gap 0-- Level=1, Type=Selected + Inactive: 600×20 HORIZONTAL pad 0/15/0/15 gap 0-- Level=2, Type=Selected + Inactive: 600×20 HORIZONTAL pad 0/30/0/30 gap 0-- Level=3, Type=Selected + Inactive: 600×20 HORIZONTAL pad 0/45/0/45 gap 0-- Level=4, Type=Selected + Inactive: 600×20 HORIZONTAL pad 0/60/0/60 gap 0-- Level=1, Type=Alternating Row Color: 600×20 HORIZONTAL pad 0/15/0/15 gap 0-- Level=2, Type=Alternating Row Color: 600×20 HORIZONTAL pad 0/30/0/30 gap 0-- Level=3, Type=Alternating Row Color: 600×20 HORIZONTAL pad 0/45/0/45 gap 0-- Level=4, Type=Alternating Row Color: 600×20 HORIZONTAL pad 0/60/0/60 gap 0-- Level=1, Type=Default: 600×20 HORIZONTAL pad 0/15/0/15 gap 0-- Level=2, Type=Default: 600×20 HORIZONTAL pad 0/30/0/30 gap 0-- Level=3, Type=Default: 600×20 HORIZONTAL pad 0/45/0/45 gap 0-- Level=4, Type=Default: 600×20 HORIZONTAL pad 0/60/0/60 gap 0-- Outline View: 900×450 VERTICAL pad 0/0/0/0 gap 3-- Column Header: 600×28 HORIZONTAL pad 4/0/5/0 gap 0-- Order=Descending: 13×19-- Order=Ascending: 13×19--### Tooltips (3)-- Tooltip: 49×18 HORIZONTAL pad 3/6/2/6 gap 0-- Mode=Light: 37×13 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark: 37×13 HORIZONTAL pad 0/0/0/0 gap 0--### Sidebars (253)-- Mode=Light, Size=Small,First Section=True, Active=True: 210×19 HORIZONTAL pad 0/4/5/4 gap 4-- Mode=Light,Expanded=True: 12×24-- Mode=Light,Expanded=False: 12×24-- Size=Small: 240×560 VERTICAL pad 0/0/10/0 gap 0-- Mode=Light,Size=Medium,First Section=True, Active=True: 210×22 HORIZONTAL pad 0/4/8/4 gap 4-- Mode=Light, Size=Large,First Section=True, Active=True: 210×25 HORIZONTAL pad 0/4/9/4 gap 4-- Size=Small, State=Disabled,Active=True, Level=0: 270×24 r5 HORIZONTAL pad 0/2/0/0 gap 4-- Size=Small, State=Selected,Active=True, Level=0: 270×24 r5 HORIZONTAL pad 0/2/0/0 gap 4-- Size=Small, State=Idle,Active=True, Level=0: 270×24 r5 HORIZONTAL pad 0/2/0/0 gap 4-- Mode=Light, Expanded=True: 24×14-- Mode=Light, Expanded=False: 24×14-- Size=Medium, State=Disabled,Active=True, Level=0: 270×32 r5 HORIZONTAL pad 0/2/0/0 gap 4-- Size=Medium, State=Selected,Active=True, Level=0: 270×32 r5 HORIZONTAL pad 0/2/0/0 gap 4-- Size=Medium, State=Idle,Active=True, Level=0: 270×32 r5 HORIZONTAL pad 0/2/0/0 gap 4-- Size=Large, State=Disabled,Active=True, Level=0: 270×36 r8 HORIZONTAL pad 0/2/0/0 gap 4-- Size=Large, State=Selected,Active=True, Level=0: 270×36 r8 HORIZONTAL pad 0/2/0/0 gap 4-- Size=Large, State=Idle,Active=True, Level=0: 270×36 r8 HORIZONTAL pad 0/2/0/0 gap 4-- Size=Medium: 240×560 VERTICAL pad 0/0/10/0 gap 0-- Size=Large: 240×560 VERTICAL pad 0/0/10/0 gap 0-- Mode=Light, Size=Small,Active=True, Enabled=True: 31×14 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Size=Small,Active=True, Enabled=False: 31×14 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Size=Small,Active=True, Enabled=True: 31×14 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Size=Small,Active=True, Enabled=False: 31×14 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light,Active=True: 100×24 r8-- Mode=Dark,Active=True: 100×24 r8-- Mode=Light, Size=Small, Active=True, Icon=Image, Enabled=True, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Medium, Active=True, Icon=Image, Enabled=True, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Large, Active=True, Icon=Image, Enabled=True, Level=0: 80×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Large, Active=True, Icon=Symbol, Enabled=True, Level=0: 80×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Medium, Active=True, Icon=Symbol, Enabled=True, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Small, Active=True, Icon=Symbol, Enabled=True, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Large, Active=True, Icon=Image, Enabled=True, Level=0: 80×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Medium, Active=True, Icon=Image, Enabled=True, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Small, Active=True, Icon=Image, Enabled=True, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Large, Active=True, Icon=Symbol, Enabled=True, Level=0: 80×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Medium, Active=True, Icon=Symbol, Enabled=True, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Small, Active=True, Icon=Symbol, Enabled=True, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark,Expanded=True: 12×24-- Mode=Dark,Expanded=False: 12×24-- Mode=Dark, Size=Large, Active=True, Icon=Image, Enabled=False, Level=0: 80×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Medium, Active=True, Icon=Image, Enabled=False, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Small, Active=True, Icon=Image, Enabled=False, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Large, Active=True, Icon=Symbol, Enabled=False, Level=0: 80×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Medium, Active=True, Icon=Symbol, Enabled=False, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Dark, Size=Small, Active=True, Icon=Symbol, Enabled=False, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Large, Active=True, Icon=Image, Enabled=False, Level=0: 80×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Medium, Active=True, Icon=Image, Enabled=False, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Small, Active=True, Icon=Image, Enabled=False, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Large, Active=True, Icon=Symbol, Enabled=False, Level=0: 80×20 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Medium, Active=True, Icon=Symbol, Enabled=False, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Small, Active=True, Icon=Symbol, Enabled=False, Level=0: 80×16 r8 HORIZONTAL pad 0/0/0/0 gap 4-- Mode=Light, Size=Medium,Active=True, Enabled=True: 37×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Size=Medium,Active=True, Enabled=True: 37×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Size=Medium,Active=True, Enabled=False: 37×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Size=Medium,Active=True, Enabled=False: 37×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Size=Large,Active=True, Enabled=False: 42×20 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Size=Large,Active=True, Enabled=True: 42×20 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Size=Large,Active=True, Enabled=True: 42×20 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Size=Large,Active=True, Enabled=False: 42×20 HORIZONTAL pad 0/0/0/0 gap 10-- Size=Medium, State=Disabled,Active=True, Level=1: 270×32 r5 HORIZONTAL pad 0/2/0/12 gap 4--### Alerts (9)-- Mode=Light, Type=Primary: 160×28 r100 HORIZONTAL pad 0/8/0/8 gap 0-- Mode=Light, Type=Secondary: 160×28 r100 HORIZONTAL pad 0/8/0/8 gap 0-- Type=Side-by-side: 260×152 r10 VERTICAL pad 20/16/16/16 gap 14-- Type=Stacked: 260×216 r10 VERTICAL pad 20/16/16/16 gap 14-- Mode=Light, Type=Destructive: 160×28 r100 HORIZONTAL pad 0/8/0/8 gap 0-- Mode=Dark, Type=Destructive: 160×28 r100 HORIZONTAL pad 0/8/0/8 gap 0-- Mode=Dark, Type=Secondary: 160×28 r100 HORIZONTAL pad 0/8/0/8 gap 0-- Mode=Dark, Type=Primary: 160×28 r100 HORIZONTAL pad 0/8/0/8 gap 0-- Overlay: 100×100--### Group Boxes (1)-- Group Box: 200×200 r12--### Popovers (25)-- Mode=Light, Edge=Trailing (Bottom): 200×200-- Mode=Light, Edge=Trailing (Middle): 200×200-- Mode=Light, Edge=Trailing (Top): 200×200-- Mode=Light, Edge=Bottom (Trailing): 200×200-- Mode=Light, Edge=Bottom (Center): 200×200-- Mode=Light, Edge=Bottom (Leading): 200×200-- Mode=Light, Edge=Top (Trailing): 200×200-- Mode=Light, Edge=Top (Center): 200×200-- Mode=Light, Edge=Top (Leading): 200×200 r10-- Mode=Light, Edge=Leading (Bottom): 200×200-- Mode=Light, Edge=Leading (Middle): 200×200-- Mode=Light, Edge=Leading (Top): 200×200 r10-- Popover: 200×200-- Mode=Dark, Edge=Trailing (Bottom): 200×200-- Mode=Dark, Edge=Trailing (Middle): 200×200-- Mode=Dark, Edge=Trailing (Top): 200×200-- Mode=Dark, Edge=Bottom (Trailing): 200×200-- Mode=Dark, Edge=Bottom (Center): 200×200-- Mode=Dark, Edge=Bottom (Leading): 200×200-- Mode=Dark, Edge=Top (Trailing): 200×200-- Mode=Dark, Edge=Top (Center): 200×200-- Mode=Dark, Edge=Top (Leading): 200×200 r10-- Mode=Dark, Edge=Leading (Bottom): 200×200-- Mode=Dark, Edge=Leading (Middle): 200×200-- Mode=Dark, Edge=Leading (Top): 200×200 r10--### Sheets (2)-- Mode=Light: 300×300 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark: 300×300 r16 VERTICAL pad 0/0/0/0 gap 0--### Toolbars (135)-- Mode=Light,State=Idle,Size=XL,Active=True: 50×36 HORIZONTAL pad 0/8/0/8 gap 2-- Mode=Light,State=Idle,Size=XL,Active=True: 63×36 HORIZONTAL pad 6.5/8/7.5/8 gap 2-- Utility Panel Tab Bar: 220×30 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, Size=XL, State=Placeholder,Active=True: 130×36 r100 HORIZONTAL pad 0/10/0/10 gap 6-- Mode=Light,State=Idle: 32×28 r100 HORIZONTAL pad 0/4/0/4 gap 0-- Mode=Light,State=Selected: 32×28 r100 HORIZONTAL pad 0/4/0/4 gap 0-- Mode=Light,State=Disabled: 32×28 r100 HORIZONTAL pad 0/4/0/4 gap 0-- Mode=Light, Size=XL, Active=True: 145×36 HORIZONTAL pad 4/4/4/4 gap 0-- Mode=Light, Size=Medium, Active=True: 121×24 HORIZONTAL pad 2/2/2/2 gap 0-- Mode=Light,State=Idle,Size=Medium,Active=True: 39×24 HORIZONTAL pad 0/6/0/6 gap 2-- Mode=Light,State=Idle,Size=Medium,Active=True: 57×24 HORIZONTAL pad 0/6/0/6 gap 2-- Mode=Light, Size=Medium, State=Placeholder,Active=True: 130×24 r100 HORIZONTAL pad 0/6/0/6 gap 4-- Mode=Light,State=Disabled: 24×20 r100 HORIZONTAL pad 3/6/3/6 gap 0-- Mode=Light,State=Selected: 24×20 r100 HORIZONTAL pad 3/6/3/6 gap 0-- Mode=Light,State=Idle: 24×20 r100 HORIZONTAL pad 3/6/3/6 gap 0-- Mode=Light, Size=Medium, Active=True: 72×24 HORIZONTAL pad 2/2/2/2 gap 4-- Mode=Light, Size=XL, Active=True: 100×36 HORIZONTAL pad 4/4/4/4 gap 4-- Mode=Light,Active=True, Size=Medium, State=Idle: 24×24 HORIZONTAL pad 2/2/2/2 gap 4-- Mode=Light,Active=True, Size=XL, State=Idle: 36×36 HORIZONTAL pad 4/4/4/4 gap 4-- Mode=Light,Active=True, Size=Medium, State=Disabled: 24×24 HORIZONTAL pad 2/2/2/2 gap 4-- Mode=Light,Active=True, Size=XL, State=Disabled: 36×36 HORIZONTAL pad 4/4/4/4 gap 4-- Mode=Light, Size=Medium, State=Placeholder + Disabled,Active=True: 130×24 r100 HORIZONTAL pad 0/6/0/6 gap 4-- Mode=Light, Size=XL, State=Placeholder + Disabled,Active=True: 130×36 r100 HORIZONTAL pad 0/10/0/10 gap 6-- Mode=Light, Size=Medium, State=Value + Disabled,Active=True: 130×24 r100 HORIZONTAL pad 0/6/0/6 gap 4-- Mode=Light, Size=XL, State=Value + Disabled,Active=True: 130×36 r100 HORIZONTAL pad 0/10/0/10 gap 6-- Mode=Light, Size=Medium, State=Value,Active=True: 130×24 r100 HORIZONTAL pad 0/6/0/6 gap 4-- Mode=Light, Size=XL, State=Value,Active=True: 130×36 r100 HORIZONTAL pad 0/10/0/10 gap 6-- Mode=Light, Size=Medium, State=Typing,Active=True: 130×24 r100 HORIZONTAL pad 0/6/0/6 gap 4-- Mode=Light, Size=XL, State=Typing,Active=True: 130×36 r100 HORIZONTAL pad 0/10/0/10 gap 6-- Mode=Light, Size=Medium, State=Focused,Active=True: 130×24 r100 HORIZONTAL pad 0/6/0/6 gap 4-- Mode=Light, Size=XL, State=Focused,Active=True: 130×36 r100 HORIZONTAL pad 0/10/0/10 gap 6-- Mode=Light,State=Disabled, Size=Medium,Active=True: 57×24 HORIZONTAL pad 0/6/0/6 gap 2-- Mode=Light,State=Disabled, Size=XL,Active=True: 63×36 HORIZONTAL pad 6.5/8/7.5/8 gap 2-- Mode=Light,State=Disabled, Size=Medium,Active=True: 39×24 HORIZONTAL pad 0/6/0/6 gap 2-- Mode=Light, Size=XL,Active=True, State=Disabled: 50×36 HORIZONTAL pad 0/8/0/8 gap 2-- Mode=Dark,Active=True, Size=Medium, State=Disabled: 24×24 HORIZONTAL pad 2/2/2/2 gap 4-- Mode=Dark,Active=True, Size=Medium, State=Idle: 24×24 HORIZONTAL pad 2/2/2/2 gap 4-- Mode=Dark,Active=True, Size=XL, State=Disabled: 36×36 HORIZONTAL pad 4/4/4/4 gap 4-- Mode=Dark,Active=True, Size=XL, State=Idle: 36×36 HORIZONTAL pad 4/4/4/4 gap 4-- Mode=Light,Size=XL, Next to Selected=False: 3×20 HORIZONTAL pad 0/1/0/1 gap 10-- Mode=Light,Size=Medium, Next to Selected=False: 3×16 HORIZONTAL pad 0/1/0/1 gap 10-- Mode=Light,Size=XL, Next to Selected=True: 3×20 HORIZONTAL pad 0/1/0/1 gap 10-- Mode=Light,Size=Medium, Next to Selected=True: 3×16 HORIZONTAL pad 0/1/0/1 gap 10-- Mode=Dark, Size=Medium, Active=True: 121×24 HORIZONTAL pad 2/2/2/2 gap 0-- Mode=Dark, Size=XL, Active=True: 145×36 HORIZONTAL pad 4/4/4/4 gap 0-- Mode=Dark, Size=Medium, Active=True: 72×24 HORIZONTAL pad 2/2/2/2 gap 4-- Mode=Dark, Size=XL, Active=True: 100×36 HORIZONTAL pad 4/4/4/4 gap 4-- Mode=Dark, Size=Medium, Next to Selected=True: 3×16 HORIZONTAL pad 0/1/0/1 gap 10-- Mode=Dark, Size=Medium, Next to Selected=False: 3×16 HORIZONTAL pad 0/1/0/1 gap 10-- Mode=Dark, Size=XL, Next to Selected=True: 3×20 HORIZONTAL pad 0/1/0/1 gap 10-- Mode=Dark, Size=XL, Next to Selected=False: 3×20 HORIZONTAL pad 0/1/0/1 gap 10-- Mode=Dark, State=Disabled: 32×28 r100 HORIZONTAL pad 0/4/0/4 gap 0-- Mode=Dark, State=Selected: 32×28 r100 HORIZONTAL pad 0/4/0/4 gap 0-- Mode=Dark, State=Idle: 32×28 r100 HORIZONTAL pad 0/4/0/4 gap 0-- Mode=Dark, State=Disabled: 24×20 r100 HORIZONTAL pad 3/6/3/6 gap 0-- Mode=Dark, State=Selected: 24×20 r100 HORIZONTAL pad 3/6/3/6 gap 0-- Mode=Dark, State=Idle: 24×20 r100 HORIZONTAL pad 3/6/3/6 gap 0-- Mode=Dark, Size=Medium,Active=True, State=Idle: 39×24 HORIZONTAL pad 0/6/0/6 gap 2-- Mode=Dark, Size=Medium,Active=True, State=Disabled: 39×24 HORIZONTAL pad 0/6/0/6 gap 2-- Mode=Dark, Size=XL,Active=True, State=Idle: 50×36 HORIZONTAL pad 0/8/0/8 gap 2--### Windows (67)-- Mode=Light,Active=True: 68×14 HORIZONTAL pad 0/8/0/0 gap 9-- Mode=Light,With Sidebar=False: 111×30 HORIZONTAL pad 0/0/0/0 gap 3-- Mode=Light,Active=False: 68×14 HORIZONTAL pad 0/8/0/0 gap 9-- Mode=Light,Active=False: 44×10 HORIZONTAL pad 0/0/0/0 gap 7-- Mode=Light,Active=True: 44×10 HORIZONTAL pad 0/0/0/0 gap 7-- Mode=Light,Active=True: 300×200 r16-- Mode=Light: 300×300 r15-- Window Titles/Utility Panel: 48×16 HORIZONTAL pad 0/0/0/0 gap 3-- Mode=Dark,Active=True: 300×200 r16-- Mode=Light,With Sidebar=True: 111×30 HORIZONTAL pad 0/0/0/0 gap 3-- Mode=Dark, With Sidebar=False: 111×30 HORIZONTAL pad 0/0/0/0 gap 3-- Mode=Dark, With Sidebar=True: 111×30 HORIZONTAL pad 0/0/0/0 gap 3-- Window Type=Default + Title,Active=True,Mode=Light: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Window Type=Default without Title,Active=True,Mode=Light: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Window Type=Default + Title + Sidebar,Active=True,Mode=Light: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, Active=True, Window Type=Unified Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=True, Window Type=Unified Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=True, Window Type=Unified Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Window Type=Unified Compact Toolbar + Title + Sidebar,Active=True,Mode=Light: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Window Type=Unified Compact Toolbar without Title,Active=True,Mode=Light: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Window Type=Unified Compact Toolbar + Title,Active=True,Mode=Light: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=True, Window Type=Expanded Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, Active=True, Window Type=Expanded Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=True, Window Type=Expanded Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Expanded Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Expanded Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Expanded Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Unified Compact Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Unified Compact Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Unified Compact Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Unified Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Unified Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Unified Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Default + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Default without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Light, Active=False, Window Type=Default + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Expanded Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Expanded Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Expanded Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Expanded Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Expanded Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Expanded Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Unified Compact Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Unified Compact Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Unified Compact Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Unified Compact Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Unified Compact Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Unified Compact Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Unified Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Unified Toolbar + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Unified Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Unified Toolbar without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Unified Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Unified Toolbar + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Default + Title + Sidebar: 870×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Default + Title + Sidebar: 840×400 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Default without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Default without Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=True, Window Type=Default + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0-- Mode=Dark, Active=False, Window Type=Default + Title: 840×400 r16 VERTICAL pad 0/0/0/0 gap 0--### Buttons (207)-- Active=True, Context=Over-Glass, State=Idle, Style=Bordered, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- State=Disabled: 24×24 r1000 VERTICAL pad 0/0/0/0 gap 0-- State=Clicked: 24×24 r1000 VERTICAL pad 0/0/0/0 gap 0-- State=Idle: 24×24 r1000 VERTICAL pad 0/0/0/0 gap 0-- Active=True, Context=Over-Glass, State=Idle, Style=Bordered - Tinted, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Idle, Style=Bordered - Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Idle, Style=Bordered - Prominent (Default) D, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Idle, Style=Bordered - Prominent (Default) Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Idle, Style=Borderless, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Clicked, Style=Bordered, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Disabled, Style=Bordered, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Clicked, Style=Borderless, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Clicked, Style=Bordered - Prominent (Default) Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Clicked, Style=Bordered - Prominent (Default) D, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Clicked, Style=Bordered - Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Clicked, Style=Bordered - Tinted, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Disabled, Style=Bordered - Tinted, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Disabled, Style=Borderless, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Disabled, Style=Bordered - Prominent (Default) Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Disabled, Style=Bordered - Prominent (Default) D, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=True, Context=Over-Glass, State=Disabled, Style=Bordered - Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Disabled, Style=Borderless, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Disabled, Style=Bordered - Prominent (Default) Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Disabled, Style=Bordered - Prominent (Default) D, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Disabled, Style=Bordered - Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Disabled, Style=Bordered - Tinted, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Disabled, Style=Bordered, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Clicked, Style=Borderless, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Clicked, Style=Bordered - Prominent (Default) D, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Clicked, Style=Bordered - Prominent (Default) Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Clicked, Style=Bordered - Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Clicked, Style=Bordered - Tinted, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Clicked, Style=Bordered, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Idle, Style=Borderless, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Idle, Style=Bordered - Prominent (Default) D, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Idle, Style=Bordered - Prominent (Default) Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Idle, Style=Bordered - Destructive, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Idle, Style=Bordered - Tinted, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Active=False, Context=Over-Glass, State=Idle, Style=Bordered, On=False: 67×24 r6 VERTICAL pad 0/16/0/16 gap 0-- Mode=Light, Active=Active, Context=Over-Glass, State=Clicked, Style=Bordered, On=False: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Active=Active, Context=Over-Glass, State=Idle, Style=Bordered, On=False: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Active=Active, Context=Over-Glass, State=Disabled, Style=Bordered, On=False: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Disabled, Window State=Active: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Clicked, Window State=Active: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Idle, Window State=Active: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Disabled: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Clicked: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Idle: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Disabled: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Clicked: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Idle: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Active=True, Context=Over-Glass, State=Disabled, On=True: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Active=True, Context=Over-Glass, State=Clicked, On=True: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Active=True, Context=Over-Glass, State=Idle, On=True: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Disabled: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Clicked: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Light, Context=Over-Glass, State=Idle: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Context=Over-Glass, State=Disabled, Window State=Active: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Context=Over-Glass, State=Disabled: 35×16 HORIZONTAL pad 0/0/0/0 gap 10-- Mode=Dark, Context=Over-Glass, State=Disabled: 35×16 HORIZONTAL pad 0/0/0/0 gap 10--### Sliders and Dials (156)-- Context=Over-Glass, State=Disabled: 24×24 r100 HORIZONTAL pad 3/0/3/0 gap 0-- Context=Over-Glass, State=Idle: 24×24 r100 HORIZONTAL pad 3/0/3/0 gap 0-- Context=Over-Glass, State=Clicked: 24×24 r100 HORIZONTAL pad 3/0/3/0 gap 0-- State=Disabled, Style=Non-Ticked: 1×20 VERTICAL pad 0/0/0/0 gap 0-- State=Clicked, Style=Non-Ticked: 1×20 VERTICAL pad 0/0/0/0 gap 0-- State=Idle, Style=Non-Ticked: 1×20 VERTICAL pad 0/0/0/0 gap 0-- Active=True, State=Idle, Ticks=False, Value=0%, Center-biased=False: 100×24-- Active=True, State=Idle: 50×6-- Active=True, State=Clicked: 50×6-- Active=True, State=Disabled: 50×6-- State=Disabled: 50×6-- State=Clicked: 50×6-- State=Idle: 50×6-- Active=True, State=Idle, Ticks=False, Value=25%, Center-biased=False: 100×24-- Active=True, State=Idle, Ticks=False, Value=50%, Center-biased=False: 100×24-- Active=True, State=Idle, Ticks=False, Value=75%, Center-biased=False: 100×24-- Active=True, State=Idle, Ticks=False, Value=100%, Center-biased=False: 100×24-- State=Disabled, Style=Ticked: 1×20 VERTICAL pad 0/0/0/0 gap 0-- State=Clicked, Style=Ticked: 1×20 VERTICAL pad 0/0/0/0 gap 0-- State=Idle, Style=Ticked: 1×20 VERTICAL pad 0/0/0/0 gap 0-- Active=True, State=Clicked, Ticks=False, Value=100%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=False, Value=75%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=False, Value=50%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=False, Value=25%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=False, Value=0%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=False, Value=100%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=False, Value=75%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=False, Value=50%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=False, Value=25%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=False, Value=0%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=True, Value=100%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=True, Value=75%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=True, Value=50%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=True, Value=25%, Center-biased=False: 100×24-- Active=True, State=Disabled, Ticks=True, Value=0%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=True, Value=100%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=True, Value=75%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=True, Value=50%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=True, Value=25%, Center-biased=False: 100×24-- Active=True, State=Clicked, Ticks=True, Value=0%, Center-biased=False: 100×24-- Active=True, State=Idle, Ticks=True, Value=100%, Center-biased=False: 100×24-- Active=True, State=Idle, Ticks=True, Value=75%, Center-biased=False: 100×24-- Active=True, State=Idle, Ticks=True, Value=50%, Center-biased=False: 100×24-- Active=True, State=Idle, Ticks=True, Value=25%, Center-biased=False: 100×24-- Active=True, State=Idle, Ticks=True, Value=0%, Center-biased=False: 100×24-- Active=True, State=Disabled: 50×6-- Active=True, State=Clicked: 50×6-- Active=True, State=Idle: 50×6-- Active=True, State=Disabled, Ticks=False, Value=100%: 100×24-- Active=True, State=Disabled, Ticks=False, Value=75%: 100×24-- Active=True, State=Disabled, Ticks=False, Value=50%: 100×24-- Active=True, State=Disabled, Ticks=False, Value=25%: 100×24-- Active=True, State=Disabled, Ticks=False, Value=0%: 100×24-- Active=True, State=Clicked, Ticks=False, Value=100%: 100×24-- Active=True, State=Clicked, Ticks=False, Value=75%: 100×24-- Active=True, State=Clicked, Ticks=False, Value=50%: 100×24-- Active=True, State=Clicked, Ticks=False, Value=25%: 100×24-- Active=True, State=Clicked, Ticks=False, Value=0%: 100×24-- Active=True, State=Idle, Ticks=False, Value=100%: 100×24-- Active=True, State=Idle, Ticks=False, Value=75%: 100×24--### Steppers (12)-- State=Disabled: 20×24 r6-- State=Default: 20×24 r6-- State=Clicked - Up: 20×24 r6-- State=Clicked - Down: 20×24 r6-- State=Disabled: 62×24 HORIZONTAL pad 0/0/0/0 gap 0-- State=Clicked - Down: 62×24 HORIZONTAL pad 0/0/0/0 gap 0-- State=Clicked - Up: 62×24 HORIZONTAL pad 0/0/0/0 gap 0-- State=Default: 62×24 HORIZONTAL pad 0/0/0/0 gap 0-- State=Disabled: 66×24 HORIZONTAL pad 0/0/0/0 gap 4-- State=Clicked - Down: 66×24 HORIZONTAL pad 0/0/0/0 gap 4-- State=Clicked - Up: 66×24 HORIZONTAL pad 0/0/0/0 gap 4-- State=Default: 66×24 HORIZONTAL pad 0/0/0/0 gap 4--### Toggles (111)-- Active=True, State=Idle, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Idle, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Idle, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Idle, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Idle, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Idle, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Disabeld, Selection=Off: 54×24 r1000-- Active=True, State=Idle, Selection=On: 54×24 r1000-- Active=True, State=Idle, Selection=Off: 54×24 r1000-- Active=True, State=Disabeld, Selection=On: 54×24 r1000-- Active=True, State=Clicked, Selection=Off: 54×24 r1000-- Active=True, State=Clicked, Selection=On: 54×24 r1000-- Active=False, State=Disabeld, Selection=On: 54×24 r1000-- Active=False, State=Clicked, Selection=On: 54×24 r1000-- Active=False, State=Idle, Selection=On: 54×24 r1000-- Active=False, State=Disabeld, Selection=Off: 54×24 r1000-- Active=False, State=Clicked, Selection=Off: 54×24 r1000-- Active=False, State=Idle, Selection=Off: 54×24 r1000-- Size=Medium, State=Disabled, Selection=False: 54×24 r100-- Size=Medium, State=Clicked, Selection=False: 54×24 r100-- Size=Medium, State=Idle, Selection=False: 54×24 r100-- Active=True, State=Clicked, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Clicked, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Clicked, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Disabled, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Disabled, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Disabled, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Clicked, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Clicked, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Clicked, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Disabled, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Disabled, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Disabled, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Idle, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Clicked, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Disabled, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Idle, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Clicked, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Disabled, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Idle, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Clicked, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=False, State=Disabled, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Idle, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Clicked, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Disabled, Selection=Off: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Idle, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Clicked, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Disabled, Selection=Mixed: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Idle, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Clicked, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Active=True, State=Disabled, Selection=On: 54×16 HORIZONTAL pad 0/0/0/0 gap 3-- Mode=Light, Active=True, State=Selected, Is Enabled=True: 16×16 r5.5 HORIZONTAL pad 6/6/6/6 gap 0-- Mode=Light, Active=True, State=Mixed, Is Enabled=True: 16×16 r5.5 HORIZONTAL pad 7/5/7/5 gap 0-- Mode=Light, Active=True, State=Selected, Is Enabled=True: 16×16 r100 HORIZONTAL pad 6/6/6/6 gap 0-- Mode=Light, Active=True, State=Mixed, Is Enabled=True: 16×16 r100 HORIZONTAL pad 7/5/7/5 gap 0-- Mode=Light, Active=True, State=Mixed, Is Enabled=False: 16×16 r5.5 HORIZONTAL pad 7/5/7/5 gap 0-- Mode=Light, Active=True, State=Selected, Is Enabled=False: 16×16 r5.5 HORIZONTAL pad 6/6/6/6 gap 0-- Mode=Light, Active=True, State=Mixed, Is Enabled=False: 16×16 r100 HORIZONTAL pad 7/5/7/5 gap 0-- Mode=Light, Active=True, State=Selected, Is Enabled=False: 16×16 r100 HORIZONTAL pad 6/6/6/6 gap 0-- Mode=Dark, Active=True, State=Mixed, Is Enabled=True: 16×16 r5.5 HORIZONTAL pad 7/5/7/5 gap 0--### Progress Indicators (46)-- Size=Medium, Active=True, Percentage=0%: 100×10 r100-- Size=Medium, Active=True, Percentage=25%: 100×10 r100-- Size=Medium, Active=True, Percentage=50%: 100×10 r100-- Size=Medium, Active=True, Percentage=75%: 100×10 r100-- Size=Medium, Active=True, Percentage=100%: 100×10 r100-- Size=Small, Active=True, Percentage=0%: 100×6 r100-- Size=Small, Active=True, Percentage=25%: 100×6 r100-- Size=Small, Active=True, Percentage=50%: 100×6 r100-- Size=Small, Active=True, Percentage=75%: 100×6 r100-- Size=Small, Active=True, Percentage=100%: 100×6 r100-- Size=Medium, Active=True: 100×10 r100-- Size=Small, Active=True: 100×6 r100-- Size=Medium, Active=False, Percentage=0%: 100×10 r100-- Size=Medium, Active=False, Percentage=25%: 100×10 r100-- Size=Medium, Active=False, Percentage=50%: 100×10 r100-- Size=Medium, Active=False, Percentage=75%: 100×10 r100-- Size=Medium, Active=False, Percentage=100%: 100×10 r100-- Size=Small, Active=False, Percentage=0%: 100×6 r100-- Size=Small, Active=False, Percentage=25%: 100×6 r100-- Size=Small, Active=False, Percentage=50%: 100×6 r100-- Size=Small, Active=False, Percentage=75%: 100×6 r100-- Size=Small, Active=False, Percentage=100%: 100×6 r100-- Size=Small, Active=False: 100×6 r100-- Size=Medium, Active=False: 100×10 r100-- Size=Large, Active=True, Progress=0%: 32×32-- Size=Large, Active=True, Progress=25%: 32×32-- Size=Large, Active=True, Progress=50%: 32×32-- Size=Large, Active=True, Progress=75%: 32×32-- Size=Large, Active=True, Progress=100%: 32×32-- Size=Small, Active=True, Progress=0%: 16×16-- Size=Small, Active=True, Progress=25%: 16×16-- Size=Small, Active=True, Progress=50%: 16×16-- Size=Small, Active=True, Progress=75%: 16×16-- Size=Small, Active=True, Progress=100%: 16×16-- Size=Large, Active=False, Progress=100%: 32×32-- Size=Small, Active=False, Progress=100%: 16×16-- Size=Large, Active=False, Progress=75%: 32×32-- Size=Small, Active=False, Progress=75%: 16×16-- Size=Large, Active=False, Progress=50%: 32×32-- Size=Small, Active=False, Progress=50%: 16×16-- Size=Large, Active=False, Progress=25%: 32×32-- Size=Small, Active=False, Progress=25%: 16×16-- Size=Large, Active=False, Progress=0%: 32×32-- Size=Small, Active=False, Progress=0%: 16×16-- Size=Small: 16×16-- Size=Large: 32×32--### Text Fields (12)-- State=Idle, Show Text=False: 120×24 HORIZONTAL pad 0/8/0/8 gap 0-- State=Focused, Show Text=False: 120×24 HORIZONTAL pad 0/8/0/8 gap 0-- State=Disabled, Show Text=False: 120×24 HORIZONTAL pad 0/8/0/8 gap 0-- State=Idle, Show Text=True: 120×24 HORIZONTAL pad 0/8/0/8 gap 0-- Mode=Light, State=Disabled: 20×20-- Mode=Light, State=Focused: 20×20-- Mode=Light, State=Idle: 20×20-- State=Disabled, Show Text=True: 120×24 HORIZONTAL pad 0/8/0/8 gap 0-- State=Focused, Show Text=True: 120×24 HORIZONTAL pad 0/8/0/8 gap 0-- Mode=Dark, State=Disabled: 20×20-- Mode=Dark, State=Focused: 20×20-- Mode=Dark, State=Idle: 20×20--### Color Wells (5)-- Color Selected=False: 28×28 r100-- Color Selected=True: 28×28 r100-- Mode=Light, State=Disabled: 48×24 r100 VERTICAL pad 3/3/3/3 gap 0-- Mode=Light, State=Selected: 48×24 r100 VERTICAL pad 3/3/3/3 gap 0-- Mode=Light, State=Idle: 48×24 r100 VERTICAL pad 3/3/3/3 gap 0--### Image Wells (2)-- Enabled=True: 30×30 r3-- Enabled=False: 30×30 r3--### Menus (45)-- Mode=Light, Hover + Key=False: 25×16 HORIZONTAL pad 0/0/0/0 gap 1-- Mode=Light, State=Idle, Menu has Selection=False, Type=Action: 160×24 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light: 100×11-- Mode=Light, State=Disabled, Menu has Selection=False, Type=Action: 160×24 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Hover + Key, Menu has Selection=False, Type=Action: 160×24 r8 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Idle, Menu has Selection=False, Type=Submenu: 160×24 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Disabled, Menu has Selection=False, Type=Submenu: 160×24 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Hover + Key, Menu has Selection=False, Type=Submenu: 160×24 r8 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Idle, Menu has Selection=True, Type=Action: 160×24 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Light, State=Disabled, Menu has Selection=True, Type=Action: 160×24 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Light, State=Hover + Key, Menu has Selection=True, Type=Action: 160×24 r8 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Light, State=Idle, Menu has Selection=True, Type=Submenu: 160×24 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Light, State=Disabled, Menu has Selection=True, Type=Submenu: 160×24 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Light, State=Hover + Key, Menu has Selection=True, Type=Submenu: 160×24 r8 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Light, Hover + Key=True: 25×16 HORIZONTAL pad 0/0/0/0 gap 1-- Mode=Light, Inset=True: 100×25 VERTICAL pad 5/20/4/20 gap 10-- Menu: 244×284 VERTICAL pad 5/12/5/12 gap 0-- Mode=Light: 120×120-- Mode=Light, State=Hover, Menu has Selection=False, Type=Submenu: 160×24 r8 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Light, State=Hover, Menu has Selection=True, Type=Submenu: 160×24 r8 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark: 120×120-- Mode=Dark, State=Disabled, Menu has Selection=True, Type=Submenu: 160×24 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark, State=Hover + Key, Menu has Selection=True, Type=Submenu: 160×24 r8 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark, State=Hover, Menu has Selection=True, Type=Submenu: 160×24 r8 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark, State=Idle, Menu has Selection=True, Type=Submenu: 160×24 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark, State=Disabled, Menu has Selection=False, Type=Submenu: 160×24 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Hover + Key, Menu has Selection=False, Type=Submenu: 160×24 r8 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Hover, Menu has Selection=False, Type=Submenu: 160×24 r8 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Idle, Menu has Selection=False, Type=Submenu: 160×24 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Disabled, Menu has Selection=True, Type=Action: 160×24 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark, State=Hover + Key, Menu has Selection=True, Type=Action: 160×24 r8 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark, State=Idle, Menu has Selection=True, Type=Action: 160×24 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark, State=Disabled, Menu has Selection=False, Type=Action: 160×24 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Hover + Key, Menu has Selection=False, Type=Action: 160×24 r8 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Idle, Menu has Selection=False, Type=Action: 160×24 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, Inset=True: 100×25 VERTICAL pad 5/20/4/20 gap 10-- Mode=Dark: 100×11-- Mode=Dark, Hover + Key=True: 25×16 HORIZONTAL pad 0/0/0/0 gap 1-- Mode=Dark, Hover + Key=False: 25×16 HORIZONTAL pad 0/0/0/0 gap 1-- Mode=Light, Inset=False: 100×25 VERTICAL pad 5/0/4/0 gap 10-- Mode=Dark, Inset=False: 100×25 VERTICAL pad 5/0/4/0 gap 10-- Mode=Light, State=Hover, Menu has Selection=True, Type=Action: 160×24 r8 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Dark, State=Hover, Menu has Selection=True, Type=Action: 160×24 r8 HORIZONTAL pad 0/12/0/12 gap 8-- Mode=Light, State=Hover, Menu has Selection=False, Type=Action: 160×24 r8 HORIZONTAL pad 0/0/0/0 gap 8-- Mode=Dark, State=Hover, Menu has Selection=False, Type=Action: 160×24 r8 HORIZONTAL pad 0/0/0/0 gap 8--### Forms (56)-- Color=Black: 20×20 r5-- Color=Blue: 20×20 r5-- Color=Teal: 20×20 r5-- Color=Dark Gray: 20×20 r5-- Color=Light Gray: 20×20 r5-- Color=Green: 20×20 r5-- Color=Orange: 20×20 r5-- Color=Pink: 20×20 r5-- Color=Purple: 20×20 r5-- Color=Red: 20×20 r5-- Color=White: 20×20 r5-- Color=Yellow: 20×20 r5-- Color=Black: 26×26 r5-- Color=Blue: 26×26 r5-- Color=Teal: 26×26 r5-- Color=Dark Gray: 26×26 r5-- Color=Light Gray: 26×26 r5-- Color=Green: 26×26 r5-- Color=Orange: 26×26 r5-- Color=Red: 26×26 r5-- Color=Indigo: 26×26 r5-- Color=Pink: 26×26 r5-- Color=White: 26×26 r5-- Color=Yellow: 26×26 r5-- Content=Radio Buttons: 54×102 VERTICAL pad 0/0/0/0 gap 6-- Content=Disclosure + Large Icon: 92×32 HORIZONTAL pad 0/0/0/0 gap 8-- Content=Symbol: 49×16 HORIZONTAL pad 0/0/0/0 gap 6-- Content=Disclosure + Small Icon: 86×32 HORIZONTAL pad 0/0/0/0 gap 8-- Content=Button: 67×24 VERTICAL pad 0/0/0/0 gap 10-- Type=Switch: 36×16 HORIZONTAL pad 0/0/0/0 gap 8-- Type=Label: 35×16 HORIZONTAL pad 0/0/0/0 gap 8-- Type=Pop-Up Button: 63×16 HORIZONTAL pad 0/0/0/0 gap 12-- Type=Label + Info Button: 60×16 HORIZONTAL pad 0/0/0/0 gap 8-- Type=Stepper: 97×24 HORIZONTAL pad 0/0/0/0 gap 6-- Type=Text Field: 120×24 HORIZONTAL pad 0/0/0/0 gap 8-- Type=Radio Buttons: 124×16 HORIZONTAL pad 0/0/0/0 gap 16-- Type=Combo Box: 100×24 HORIZONTAL pad 0/0/0/0 gap 8-- Type=More Button: 59×16 HORIZONTAL pad 0/0/0/0 gap 8-- Type=Button: 110×24 HORIZONTAL pad 0/0/0/0 gap 8-- Disclosed=False: 8×16-- Disclosed=True: 8×16-- Type=Detail Disclosure: 51×16 HORIZONTAL pad 0/0/0/0 gap 8-- Type=Checkboxes: 124×16 HORIZONTAL pad 0/0/0/0 gap 16-- Content=Checkbox + Large Icon: 100×32 HORIZONTAL pad 0/0/0/0 gap 8-- Content=Checkbox + Small Icon: 94×32 HORIZONTAL pad 0/0/0/0 gap 8-- Content=Title and Subtitle: 42×32 VERTICAL pad 0/0/0/0 gap 2-- Color=Mint: 20×20 r5-- Color=Cyan: 20×20 r5-- Color=Indigo: 20×20 r5-- Color=Brown: 20×20 r5-- Color=Mint: 26×26 r5-- Color=Cyan: 26×26 r5-- Color=Purple: 26×26 r5-- Color=Brown: 26×26 r5-- Form: 400×504 r12 VERTICAL pad 0/10/0/10 gap 0-- Form Row: 380×42 HORIZONTAL pad 2/0/2/0 gap 16--### Menu Bar and Dock (114)-- Mode=Light: 36×47 VERTICAL pad 0/0/4/0 gap 3-- Selected=True: 33×24 r4-- Selected=False: 33×24 r4-- Selected=True: 90×24 r4 HORIZONTAL pad 4/9/4/11 gap 10-- Selected=False: 90×24 r4 HORIZONTAL pad 4/9/4/11 gap 10-- Selected=True: 47×24 r4 HORIZONTAL pad 4/9/4/9 gap 10-- Selected=False: 47×24 r4 HORIZONTAL pad 4/9/4/9 gap 10-- Color Mode=Over Dark: 1008×34 HORIZONTAL pad 5/20/5/10 gap 98-- Color Mode=Over Light: 1008×34 HORIZONTAL pad 5/20/5/10 gap 98-- Color Mode=Dark: 1512×982-- Color Mode=Light: 1512×982-- Color Mode=Light: 1512×982-- Selected=True: 33×24 r4-- Selected=False: 33×24 r4-- Selected=True: 90×24 r4 HORIZONTAL pad 4/9/4/11 gap 10-- Selected=False: 90×24 r4 HORIZONTAL pad 4/9/4/11 gap 10-- Selected=True: 47×24 r4 HORIZONTAL pad 4/9/4/9 gap 10-- Selected=False: 47×24 r4 HORIZONTAL pad 4/9/4/9 gap 10-- Mode=Light, App Icon=Apps: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Trash Empty: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Trash Full: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Folder: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Apple TV: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=App Store: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Contacts: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Books: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Calendar: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Calculator: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Home: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=FaceTime: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Finder: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Find My: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Final Cut Pro: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Freeform: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Keynote: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Mail: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Maps: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Messages: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Music: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=News: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Notes: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Numbers: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Pages: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Photo Booth: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Photos: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Podcasts: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Preview: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Quicktime Player: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Reminders: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Safari: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Siri: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Stocks: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Settings: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=TextEdit: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Terminal: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Voice Memos: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Xcode: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Shortcuts: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Light, App Icon=Custom: 72×72 HORIZONTAL pad 0/0/0/0 gap 0-- Mode=Dark, App Icon=Apps: 72×72 HORIZONTAL pad 0/0/0/0 gap 0--### Notifications (6)-- Mode=Dark, Stack=False: 344×77 HORIZONTAL pad 12/14/12/10 gap 8-- Mode=Light, Stack=False: 344×77 HORIZONTAL pad 12/14/12/10 gap 8-- Liquid Glass - Notification - Dark: 100×100-- Liquid Glass - Notification - Light: 100×100-- Mode=Dark, Stack=True: 344×77 HORIZONTAL pad 12/14/12/10 gap 8-- Mode=Light, Stack=True: 344×77 HORIZONTAL pad 12/14/12/10 gap 8--### Dialogs (3)-- Small: 390×318 r16 VERTICAL pad 0/0/0/0 gap 0-- Large: 1000×448 r16 HORIZONTAL pad 0/0/0/0 gap 0-- Overlay: 100×100 r26--### Pop-up and Pull-down Buttons (9)-- State=Idle: 100×24 r6 HORIZONTAL pad 0/12/0/12 gap 8-- State=Disabled: 100×24 r6 HORIZONTAL pad 0/12/0/12 gap 8-- State=Idle, Show Label=True: 100×24 r6 HORIZONTAL pad 0/12/0/12 gap 8-- State=Disabled, Show Label=True: 100×24 r6 HORIZONTAL pad 0/12/0/12 gap 8-- State=Clicked, Show Label=True: 100×24 r6 HORIZONTAL pad 0/12/0/12 gap 8-- State=Clicked: 100×24 r6 HORIZONTAL pad 0/12/0/12 gap 8-- State=Disabled, Show Label=False: 24×24 r100 HORIZONTAL pad 0/0/0/0 gap 8-- State=Clicked, Show Label=False: 24×24 r100 HORIZONTAL pad 0/0/0/0 gap 8-- State=Idle, Show Label=False: 24×24 r100 HORIZONTAL pad 0/0/0/0 gap 8--### Combo Boxes (4)-- State=Idle: 100×24 HORIZONTAL pad 2/2/2/0 gap 0-- State=Field Clicked: 100×24 HORIZONTAL pad 2/2/2/0 gap 0-- State=Disabled: 100×24 HORIZONTAL pad 2/2/2/0 gap 0-- State=Button Clicked: 100×24 HORIZONTAL pad 2/2/2/0 gap 0--### Search Fields (9)-- State=Disabled, Text=True: 120×24 HORIZONTAL pad 0/8/0/8 gap 2-- State=Focused, Text=True: 120×24 HORIZONTAL pad 0/8/0/8 gap 2-- State=Idle, Text=True: 120×24 HORIZONTAL pad 0/8/0/8 gap 2-- Text=False,State=Disabled: 120×24 HORIZONTAL pad 0/8/0/8 gap 2-- Text=False,State=Focused: 120×24 HORIZONTAL pad 0/8/0/8 gap 2-- Text=False,State=Idle: 120×24 HORIZONTAL pad 0/8/0/8 gap 2-- _Magnifying Glass: 16×15-- State=Idle: 16×15-- State=Clicked: 16×15--### Materials (28)-- Mode=Dark: 160×160-- Mode=Light: 160×160-- Mode=Dark: 160×160-- Mode=Light: 160×160-- Mode=Light, Active=True, State=Primary: 48×48-- Mode=Light, Active=True, State=Default: 48×48-- Mode=Dark, Active=True, State=Primary: 48×48-- Mode=Dark, Active=True, State=Default: 48×48-- Mode=Dark, Type=Ultra Thin: 100×100-- Mode=Dark, Type=Thin: 100×100-- Mode=Dark, Type=Medium: 100×100-- Mode=Dark, Type=Thick: 100×100-- Mode=Dark, Type=Ultra Thick: 100×100-- Mode=Light, Type=Ultra Thin: 100×100-- Mode=Light, Type=Thin: 100×100-- Mode=Light, Type=Medium: 100×100-- Mode=Light, Type=Thick: 100×100-- Mode=Light, Type=Ultra Thick: 100×100-- Mode=Dark, Active=False, State=Primary: 48×48-- Mode=Light, Active=False, State=Primary: 48×48-- Mode=Dark, Active=False, State=Default: 48×48-- Mode=Light, Active=False, State=Default: 48×48-- Edge=Bottom: 200×200-- Edge=Top: 200×200-- Mode=Light, Edge=Bottom: 200×200-- Mode=Light, Edge=Top: 200×200-- Edge=Bottom,Mode=Dark: 200×200-- Mode=Dark,Edge=Top: 200×200--### Colors (4)-- _Swatch - Light and Dark: 160×160-- _Swatch - Light and Dark (Vibrant): 160×160-- _Swatch - Text - Light and Dark (Vibrant): 160×160-- _Swatch - Text - Light and Dark (Vibrant): 160×160--### Scrollbar (18)-- Page Height=x 2, Position=Top: 12×64-- Page Height=x 4, Position=Top: 12×64-- Page Height=x 8, Position=Top: 12×64-- Page Height=x 8, Position=Middle: 12×64-- Page Height=x 4, Position=Middle: 12×64-- Page Height=x 2, Position=Middle: 12×64-- Page Height=x 8, Position=Bottom: 12×64-- Page Height=x 4, Position=Bottom: 12×64-- Page Height=x 2, Position=Bottom: 12×64-- Page=800%, Position=Leading: 64×12-- Page=800%, Position=Center: 64×12-- Page=800%, Position=Trailing: 64×12-- Page=400%, Position=Center: 64×12-- Page=400%, Position=Leading: 64×12-- Page=200%, Position=Center: 64×12-- Page=400%, Position=Trailing: 64×12-- Page=200%, Position=Leading: 64×12-- Page=200%, Position=Trailing: 64×12--### Segmented Controls (24)-- Active=True, State=Idle, Selected=True: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=True, State=Clicked, Selected=True: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=True, State=Idle, Selected=False: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=True, State=Disabled, Selected=True: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=True, State=Disabled, Selected=False: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=True, State=Clicked, Selected=False: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=False, Selectable=False: 267×24 r6 HORIZONTAL pad 0/0/0/0 gap -1-- Active=False, State=Idle, Selected=False: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=False, State=Disabled, Selected=False: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=False, State=Clicked, Selected=False: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=False, State=Disabled, Selected=True: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=False, State=Clicked, Selected=True: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=False, State=Idle, Selected=True: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Show=True: 1×14-- Show=False: 1×14-- Active=True, Selectable=False: 267×24 r6 HORIZONTAL pad 0/0/0/0 gap -1-- Active=False, Selectable=True: 267×24 r6 HORIZONTAL pad 0/0/0/0 gap -1-- Active=True, Selectable=True: 267×24 r6 HORIZONTAL pad 0/0/0/0 gap -1-- Active=False, State=Disabled: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=False, State=Clicked: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=False, State=Idle: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=True, State=Disabled: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=True, State=Clicked: 56×20 HORIZONTAL pad 0/10/0/10 gap 0-- Active=True, State=Idle: 56×20 HORIZONTAL pad 0/10/0/10 gap 0--### Pointers (21)-- Type=Beachball: 28×28-- Type=Cross: 28×28-- Type=Default with Menu Badge: 28×28-- Type=Default: 28×28-- Type=Hand (Grabbing): 28×28-- Type=Resize (Left-Right): 28×28-- Type=Hand (Open): 28×28-- Type=Hand (Pointing): 28×28-- Type=Move: 28×28-- Type=Resize (Down): 28×28-- Type=Resize (Left): 28×28-- Type=Resize (Right): 28×28-- Type=Resize (Up-Down): 28×28-- Type=Resize (Up): 28×28-- Type=Resize North-East South-West: 28×28-- Type=Resize North-South: 28×28-- Type=Resize North-West South-East: 28×28-- Type=Resize West-East: 28×28-- Type=Text Cursor: 28×28-- Type=Zoom In: 28×28-- Type=Zoom Out: 28×28--### Disclosure Controls (6)-- State=Disabled, Disclosed=True: 24×24 r6 VERTICAL pad 0/0/0/0 gap 0-- State=Clicked, Disclosed=True: 24×24 r6 VERTICAL pad 0/0/0/0 gap 0-- State=Idle, Disclosed=True: 24×24 r6 VERTICAL pad 0/0/0/0 gap 0-- State=Disabled, Disclosed=False: 24×24 r6 VERTICAL pad 0/0/0/0 gap 0-- State=Clicked, Disclosed=False: 24×24 r6 VERTICAL pad 0/0/0/0 gap 0-- State=Idle, Disclosed=False: 24×24 r6 VERTICAL pad 0/0/0/0 gap 0--### Examples (26)-- Examples/Alert/Side-by-side: 1512×982-- Examples/Alert/Side-by-side - Window Modal: 1512×982-- Examples/Alert/Side-by-side: 1512×982-- Examples/Alert/Side-by-side - Window Modal: 1512×982-- Examples/Dialog/Save - Small: 1512×982-- Examples/Dialog/Save - Large: 1512×982-- Examples/Dialog/Save - Small: 1512×982-- Examples/Dialog/Save - Large: 1512×982-- Examples/Form: 1512×982-- Examples/List: 1512×982-- Examples/Form: 1512×982-- Examples/List: 1512×982-- Examples/Menubar: 1512×982-- Examples/Menubar: 1512×982-- Examples/Notifications: 1512×982-- Examples/Notifications: 1512×982-- Examples/Windows/Unified Toolbar + Title: 1512×982-- Examples/Windows/Unified Toolbar + Title: 1512×982-- Examples/Windows/Expaned Toolbar + Title: 1512×982-- Examples/Windows/Expaned Toolbar + Title: 1512×982-- Examples/Windows/Unified Compact Toolbar + Title: 1512×982-- Examples/Windows/Unified Compact Toolbar + Title: 1512×982-- Examples/Windows/Default with Titlebar and Sidebar: 1512×982-- Examples/Windows/Default with Titlebar and Sidebar: 1512×982-- Examples/Utility Window: 1512×982-- Examples/Utility Window: 1512×982\ No newline at end of filediff --git a/docs/mount-design.md b/docs/mount-design.mddeleted file mode 100644index 6ca227e..0000000--- a/docs/mount-design.md+++ /dev/null@@ -1,142 +0,0 @@-# iCloud Drive and Photos as folders — design (2026-10-20)--The goal: other apps (file managers, terminals, LibreOffice, image editors) see iCloud Drive-and iCloud Photos as ordinary folders, on Linux (FUSE) and Windows (Cloud Files API). Files-download on demand, writes feel local, and nothing is ever lost or silently overwritten.--## Prior art studied--- **rclone mount**, the reference VFS (virtual filesystem layer). It has iCloud Drive and- iCloud Photos backends, the latter "Tier 4, experimental, read-only".- - Directory cache with a poll interval.- - Cache modes off/minimal/writes/full. "full" keeps sparse files with known byte ranges- and reads ahead.- - Write-back: upload on close after a 5 s idle delay, up to 4 in parallel; retried with- backoff; uploaded on the next run if not done before exit.- - LRU eviction by max-size, max-age and min-free-space; open files are never evicted.- - attr-timeout of 1 s, because a longer one risks truncated reads after a remote change.- - Two processes must never share a cache.- - systemd: Type=notify, absolute paths. AppArmor on Ubuntu can block fusermount3.-- **icloud-linux** (IsmaeelAkram, Python FUSE, 149 stars).- - Metadata in SQLite, kept separate from hydrated content (content downloaded locally).- - One hydration transition for lazy reads and bulk "make available offline".- - Writes durable locally first, then a background queue that survives restarts.- - Tombstones so deletes are not resurrected.- - Conflicts kept and shown, never resolved by magic.- - Filename normalization repair; a CLI for status.-- **Windows: Cloud Files API (cfapi)**, used by OneDrive, iCloud for Windows and Nextcloud.- - A sync-root registration; placeholders; hydration callbacks (FETCH_DATA).- - Pin/unpin ("Always keep on this device" / "Free up space").- - Status icons in Explorer.- - Rust: the `cloud-filter` crate (0.0.6, young — audit before use).-- **GLib (glocalfile.c):** `is_remote_fs_type` treats only nfs, nfs4, cifs, smb, smb2 and- fuse.sshfs as remote.- - A `fuse.quince` mount counts as local, so GNOME Files thumbnails every file it lists,- which means downloading each one in full. KDE is similar.--## Decisions--1. **One engine, two front ends.** A platform-free core (`quince-vfs`) covers the inode- table, metadata, hydration, cache, write queue and conflicts. Linux uses `fuser` 0.18;- Windows uses cfapi later.-2. **Metadata from the library DB, never the network, on the kernel path.**- - lookup, getattr and readdir are answered from SQLite.- - A folder never opened before is fetched once, asynchronously, with a timeout. Its- listing is then cached and refreshed by Apple's push and the existing poll.- - The kernel is told of remote changes with `notify_inval_entry` / `notify_inval_inode`.-3. **Content: full mode, sparse cache files with ranges** (as in rclone).- - The first read of a range fetches it with HTTP Range requests, chunking and read-ahead.- - Whole-file hydration only when asked ("Keep on this computer").- - LRU eviction with a size budget; pinned and open files are never evicted.-4. **Writes: local first.**- - Written to the cache file; on close, plus a 5 s idle delay, an upload job goes into the- existing persistent outbox (it survives restarts).- - Retries use backoff. Uploads verify with retrieveItemDetails, as Quince's Drive does- now.- - Renames, moves, mkdir and delete become outbox jobs keyed by Apple's drivewsid, with- tombstones until Apple confirms.-5. **Conflicts.** When both sides changed, keep both: "name (conflict on <host> <date>).ext".- Never overwrite.-6. **Thumbnails without downloads.**- - Write freedesktop thumbnail-cache entries from Apple's own thumbnails, under- ~/.cache/thumbnails/{normal,large}/<md5(file URI)>.png with Thumb::URI and Thumb::MTime.- - Additionally, for a file whose content isn't local, a read from a known thumbnailer- process is refused (requester pid from FUSE, process name from /proc/<pid>/comm).- The list: gnome-thumbnail-factory children, totem-video-thumbnailer,- evince-thumbnailer, ffmpegthumbnailer, gst-thumbnailer, KIO thumbnail workers.-7. **Photos folder: read-only first.**- - Library/<year>/<month>/, Albums/<album>/, Favorites/, Videos/.- - Originals on demand, with the original file name and dates.- - Later, possibly: copying into an album folder uploads (Quince already uploads).-8. **Safety.**- - The mount point is owner-only. No allow_other.- - A stale mount ("Transport endpoint is not connected") is detected and lazily unmounted- at start; AutoUnmount is set.- - A crash never loses a write: the outbox and cache are on disk before close() returns.- - Never two engines on one cache: a lock file.-9. **Names.** Apple's names are NFC-normalized for lookup. Names illegal on the platform are- mapped reversibly. Case: Linux is case-sensitive and iCloud is case-insensitive, so two- names that differ only by case are surfaced as a conflict, never silently merged.--## Steps (one per tick, each proven on throwaways in a scratch mount)--1. Core plus a read-only Drive mount on Linux: list, stat, read with on-demand ranges.-2. Thumbnail-cache filling and the thumbnailer guard; checked with Nautilus' own thumbnailer.-3. Writes: create, write, truncate, rename, mkdir, delete through the outbox; conflict- handling.-4. Eviction, pinning ("Keep on this computer"), settings UI, a status line in the app.-5. Photos folder (read-only).-6. Windows cfapi front end.--## Proven live--- 2026-10-20 (probe/examples/drive_range_read.rs, read-only): Drive download URLs honour HTTP- Range requests. Two ranges of an 11,710-byte docx each came back "206 Partial Content" with- the correct Content-Range, and both matched the same bytes from a whole download. Reading- ranges on demand works.-- 2026-10-20 (probe/examples/drive_mount_live.rs): his real iCloud Drive mounted read-only in a- scratch folder.- - Root listing: 0.5 s the first time, 4 ms after.- - A never-opened folder (Downloads): 1.2 s once.- - An 11,710-byte .docx read byte-exact in 1.4 s; `file` and `unzip` confirm a valid Word- document.- - A thumbnailer-named process was refused (EACCES) before the file was local, and allowed- once it was.- - Folder dates (Apple lists none) now show the mount time instead of 1970.--## Separate folders, no extra installs (his requirement, 2026-10-20)--- iCloud Drive and iCloud Photos are two folders, each with its own switch, each depending- only on its own service.- - A user with iCloud Photos off gets Drive and is never asked about Photos, and the- reverse. They share the engine, cache and settings.-- Linux needs only FUSE: the kernel module plus fusermount3 (fuse3). Mainstream desktops ship- it, because gvfs/GNOME and KIO depend on it. Quince checks for it, and Settings says what is- missing in one line if it is absent.-- Windows needs only the Cloud Files API, part of Windows 10 1709 and later.-- Flatpak: a sandbox cannot mount FUSE without extra permissions. Either the Flatpak asks for- them, or the folders are offered in native packages only (deb/rpm/AUR/AppImage). To settle- at packaging.-- 2026-10-20: new folder, rename, move and delete proven live on his Drive through the mount,- inside a throwaway folder, with plain shell commands (mkdir, mv, rmdir).- - rmdir of a non-empty folder was refused with ENOTEMPTY.- - The 3 throwaways were deleted forever from Recently Deleted afterwards; a re-check found 0.-- 2026-10-20: writes proven live on his Drive in a throwaway folder: a new file, an append, and- an editor's save (GLib-style temporary file renamed over the original) arriving while the- append's send was still under way.- - The first live run left "note 2.txt" beside the note. The append's three steps (send,- delete the old version, rename the new one) were interrupted by the save, which took the- free name.- - Fixed with one send at a time per name (the per-name upload lock). The regression test was- slowed to Apple's real pace and fails without the fix and passes with it.- - Re-run live: one file, and a fresh mount with an empty cache read the editor's bytes from- Apple. The vim .swp was never sent. Throwaways were cleared from Recently Deleted; 0 left.-- 2026-10-20: iCloud Photos folder (read-only) checked in the real app, isolated, on a copy of- his library.- - Layout: Library/<year>/<MM Month>, Albums (he has none), Favorites (1), Videos (17).- - Two cached originals read byte-identical (SHA-256) to the app's cache.- - touch and rm were refused.- - 36 of 36 photos in a month showed GLib-valid thumbnails from the app's own, with nothing- downloaded.- - SIGTERM left nothing mounted.- - Live Photo motion (.MOV) is not shown yet: its size is not known until it is fetched.diff --git a/docs/notes-tables-crdt.md b/docs/notes-tables-crdt.mddeleted file mode 100644index c5dd46d..0000000--- a/docs/notes-tables-crdt.md+++ /dev/null@@ -1,156 +0,0 @@-# Notes tables: the CRDT, and what a phone writes--Measured 2026-10-21 on the iPhone's own tables in the note "Table Test"-(`EACC6CE8-…`), read only, plus a structure-only census of every table attachment on-the account (`probe/examples/notes_table_writers.rs`, `notes_table_replicas.rs`). No-cell text is reproduced here.--Evidence set:--| attachment | what the phone did | doc size |-|---|---|---|-| `913885E6`, `A2E4F35E`, `FDC89AFA`, `C185424B` (deleted) | made a blank 2×2 | 1817 B |-| `017CA145` | made a blank 2×2, typed one character and deleted it (2.4 s later) | 1839 B |-| `043907AA` | made a 2×2, typed three cells; a row was added and the first row removed | 4001 B |--`t2-before.bin` ("Colors" before the bad edit) was not on disk; the live "Colors"-tables and the conflict copies were read from Apple instead (below).--## Document layout--```-Document { 1: 0, 2: Version { 1: 0, 2: 0, 3: Data } } // field 2 may repeat (see b00ea4f)-Data {- 1: VersionVector { 1: { 1: replica, 2: clock } * } // replica = index into field 6- 2: <empty> // present once a phone has edited- 3: Object * // one-field messages: 1 register, 6 dictionary, 10 text, 13 custom, 16 ordered set- 4: key name * 5: type name * 6: uuid (16 B) *- 7: Writers { 1: { 1: uuid, 2: { 1: next char }, 2: { 1: next timestamp } } * }-}-```--Dictionary elements carry a stamp `{1: {1: replica, 2: clock}}` (replica = field-6 index).-Texts (cells, and the ordered sets' `""` strings) are topotext:-`{2: string, 3: substring *, 5: run *}`, substring `{1: id{1: writer, 2: clock}, 2: length,-3: stamp{1: writer, 2: clock}, 4: deleted?, 5: next}`, start marker `(0,0)`, end marker-`(0, 0xFFFFFFFF)`.--## What a phone's cell edit changes (blank → touched → typed)--Blank → touched (`017CA145`), a text-only edit, changes exactly:--1. **The cell's text object.** A new substring `id (1, 2), len 1, stamp (1, 8), deleted`- linked between the start and end markers. The cached string is the new text.-2. **Data field 7** (writers): the phone's entry `[2, 1] → [3, 9]` — next character after- the one it used (2 → 3), next timestamp after the one it stamped (8 → 9).-3. **Data field 2**: an empty field 2 appears right after field 1.--Nothing else: the **version vector (field 1) stays `{0: 1}`**, the uuid list (field 6)-is unchanged, every other object is byte-identical.--Blank → typed (`043907AA`) shows the same for text, plus structure:--- Version vector `{0: 1} → {0: 3}`. The structure changed (a row element and its cells- added, the first row's element removed from the ordered set, its array entry- re-stamped `(0, 2)`). New dictionary elements are stamped `(0, 1)`, so the stamp is- not simply "the clock at write"; field 1 moves with structure, not with text.-- Writers `[2, 1] → [158, 76]`: next char = last char id + length (`(1,150)+8`), next- timestamp = last stamp + 1 (75 + 1).-- Each deleted substring carries its own stamp — the timestamp of the deletion (single- backspaces give one stamp per character, a selection delete one stamp for the range).- Live substrings carry either `(1, 0)` or a per-insertion stamp.-- **Runs.** A blank cell has none. Every run the phone writes in a cell is- `{1: length, 2: {9: paragraph uuid (16 B)}, 13: unix seconds}`, one run per typing- burst. Field 13 is the time of the edit (e.g. 1792589418 against a CreationDate of- 1792589407870 ms). The paragraph uuid is shared by a cell's runs (and was seen shared- between two cells of one column), and is fresh for a cell typed into for the first time.-- The attachment record's `SummaryEncrypted` changes from `CgoKCg==` (`"\n\n\n\n"`) to a- summary of the cells' text (length fits: cell texts + one `\n` each). Pomander does not- write it yet; it should not affect merging.--## Replicas--- **The doc's writer list (field 7) is a map uuid → clocks, kept sorted by uuid- (byte order), and a writer number in a text is the 1-based place in that sorted list.**- Evidence: every multi-writer list an Apple device wrote is sorted (`[1dc1…, e308…]`,- `[23ab…, 28d3…, 766e…, e308…, ef77…]`); only lists Pomander last wrote are not.-- The phone's replica is `e3081e68…` on every table it made: field 6 `[0]`, field 7- `[0]`, version-vector replica 0. A device is one stable uuid across documents.-- **A new writer registering for text** is just an entry in field 7 at its sorted- place. Text-only writers are not added to field 6 or field 1: Apple's own rewrite of a- table Pomander had edited kept Pomander's text writers out of field 6. A writer that- changes structure is in field 6 and gets a version-vector entry (`1dc1…` in the- "Colors" tables).-- **`ReplicaIDToNotesVersionDataEncrypted`** is not per document. It is plain (not- gzipped) CRDT data, byte-identical on the note and all six attachments: a dictionary- replica-uuid → `NSNumber{integerValue: 36}` for three devices (`e3081e68…` the- iPhone, `62d4d8fa…`, `6a0af31c…`), version vector `{0: 3}`. `ReplicaIDToUserIDEncrypted`- (on the note) maps the same uuids to the user record. No edit in the evidence changed- either; the earlier finding (notes.rs) is that Apple drops client writes of them. A- table edit must leave them alone.--## Why Pomander's table edits doubled text--The conflict-copy note `B5459772` (deleted) holds three tables created by a second Apple-device (CloudKit deviceID `1BA2…`, not the iPhone `FE8C…`, not the web `"2"`) at-1792552406, between Pomander's writes to "Colors". Copy `015AB30E` has its writer list-**sorted** — `[23ab, 28d3, 766e, e308, ef77]` — while every substring keeps the numbers-of the list Pomander had **appended to** — `[e308, 23ab, ef77, 28d3, 766e]`. Read by-sorted place, the phone's own two characters in each ordered set, `(1, 0..1)`, became-`23ab`'s; Pomander's 11-character cell became `28d3`'s; and so on. The clocks show the-same remap: the copy's clocks are the element-wise max of the uuid-keyed and the-place-keyed values (`[11, 11, 1, 7, 1]` from `[2, 11, 1, 7, 1]` by place and-`{23ab: 11, 28d3: 7, …}` by uuid). The same characters then existed under two ids — one-copy from the phone, one from the misread document — so the merge kept both: doubled-rows and doubled/tripled cell text, and conflict copies.--So the cause is **appending a new writer to field 7 instead of inserting it at its-sorted place and renumbering every text**, made worse by a fresh writer uuid per run-(probe runs never called `set_writer`): each write landed at a different sorted place.-It is not the version vector — the phone itself leaves field 1 alone on a text edit.--The live "Colors" tables `FE5372D5` and `5E44E504` were last written by Pomander and-still have unsorted lists (`[e308, 23ab, ef77, 28d3, 766e, 6109]`, `[1dc1, e308, 4dcf]`);-an Apple device reading them now misattributes their text the same way. The new writer-refuses such a list rather than guess.--Pomander's stable writer (`documents.writer` in the app's library) is `6bc6a71d…`, which-sorts **before** the phone's `e3081e68…`: an append would shift every phone character.--## The write path (`table::with_cell_by`)--Exactly what the phone's text edit does:--1. Read field 7; refuse unless sorted and re-encoding byte-identical.-2. Insert Pomander's replica at its sorted place with clocks `[0, 0]` if new; if any- writer moved up, renumber every text in the table (cells, kind 10; ordered sets,- kind 16 → 1 → 1 → 1) — ids and stamps ≥ that place go up by one. Objects of other- kinds than 1/6/10/13/16 make it refuse.-3. Edit the cell: removed units marked deleted and stamped `(me, next ts)`; typed units- a new substring `(me, next char)`, stamped `(me, next ts)`; clocks advanced.-4. Runs: the removed span cut out; the typed span a new run patterned on its neighbour- (paragraph style carried), field 13 = now; in a cell with no runs,- `{1: n, 2: {9: fresh uuid}, 13: now}`.-5. Field 2 (empty) added after field 1 if absent. Field 1, field 6, every other object,- `ReplicaIDToNotesVersionDataEncrypted`: untouched.-6. The result must read back as the same table with only that cell changed.--Rows and columns (`with_row`, `with_column`, `without_*`) still append and are now-refused whenever that would leave field 7 unsorted. They were not re-measured here.--## Proposed live test (not run; flags stay off)--One cell, the blank table `913885E6` in "Table Test", by Pomander's stable writer:--1. Turn `TABLE_CELL_WRITES` on in a local build only. Quit Notes on the iPhone and Mac- first so nothing edits the note concurrently, then set cell (row 0, column 0) to- `Pomander 1`.-2. Read it back with `notes_table_writers` / `notes_note_tables`: field 7 must be- `[6bc6a71d… [10, 1], e3081e68… [2, 1]]`, the ordered sets' two characters numbered- 2 (the phone), field 1 still `{0: 1}`.-3. On the iPhone: open "Table Test" and wait for sync. Check: the table shows- `Pomander 1` once, no other cell changed, **no conflict copy note** appears in the- folder, and the note list shows one "Table Test". Then type `X` after it on the phone,- wait, and read the attachment again: the phone's write must keep `6bc6a71d…` in- field 7 at place 1, the cell must read `Pomander 1X`, still no conflict copy.-4. Check the other Apple device too (CloudKit deviceID `1BA2…`, which made the earlier conflict copies).diff --git a/docs/privacy-audit.py b/docs/privacy-audit.pydeleted file mode 100644index 776aded..0000000--- a/docs/privacy-audit.py+++ /dev/null@@ -1,80 +0,0 @@-#!/usr/bin/env python3-"""Privacy audit before publishing Quince: does any of his real iCloud data appear in the git-history? Kept in docs/ (never committed).--Reads his library (read-only) and every version of every committed file, and reports matches-in truncated form only. Nothing personal is printed in full or written anywhere.-- python3 docs/privacy-audit.py--Also checks the session's cookie values and the account's dsid, the credentials that matter-most. Run it again after any history rewrite (git filter-repo) to prove it is clean.-"""-import json-import os-import re-import sqlite3-import subprocess-from collections import Counter--# The app's data folder: its identifier since the rename, or the old one on an install the-# rename has not moved yet (src-tauri/src/migrate.rs).-DATA = next(- (d for d in map(os.path.expanduser, ["~/.local/share/io.github.yashwanthkamireddi.Skykeep",- "~/.local/share/io.github.yashwanthkamireddi.Skykeep"])- if os.path.exists(os.path.join(d, "library.db"))),- os.path.expanduser("~/.local/share/io.github.yashwanthkamireddi.Skykeep"),-)-history = subprocess.run(["git", "log", "--all", "-p", "--no-color"], capture_output=True, text=True, errors="ignore").stdout-digits = re.sub(r"\D", "", history)-db = sqlite3.connect(f"file:{DATA}/library.db?mode=ro", uri=True)-found = Counter()-examples = {}---def hit(kind, value):- found[kind] += 1- examples.setdefault(kind, set()).add(value[:3] + "…")---for (v,) in db.execute("select value from contact_methods where kind='phone'"):- d = re.sub(r"\D", "", v)[-10:]- if len(d) == 10 and d in digits:- hit("phone number", d)-for (v,) in db.execute("select value from contact_methods where kind in ('email','address')"):- for part in re.split(r"[,\n]", v or ""):- p = part.strip()- if len(p) >= 8 and p in history:- hit("email/address part", p)-for (f, l) in db.execute("select coalesce(first_name,''), coalesce(last_name,'') from contacts"):- n = f"{f} {l}".strip()- if len(n) >= 6 and n in history:- hit("contact name", n)-GENERIC = {"Reminders", "Calendar", "Home", "Work", "Daily", "Study", "Notes", "New Reminder", "New Folder"}-for label, q in [- ("reminder title", "select title from reminders"),- ("note title", "select title from notes"),- ("event title", "select title from events"),- ("drive file name", "select name from drive_items where kind='FILE'"),- ("photo file name", "select filename from photos"),- ("album name", "select name from photo_albums"),-]:- for (v,) in db.execute(q):- v = (v or "").strip()- if len(v) >= 8 and v not in GENERIC and v in history:- hit(label, v)-try:- # The jar is encrypted at rest now; a plaintext copy (taken before the first encrypted run)- # can be named with COOKIES=... to keep checking that no cookie value reached git.- cookies = json.dumps(json.load(open(os.environ.get("COOKIES", f"{DATA}/cookies.json"))))- for v in set(re.findall(r'"([A-Za-z0-9+/=_%.-]{24,})"', cookies)):- if v in history:- hit("session cookie value", v)- for d in set(re.findall(r"dsid[^0-9]{0,6}(\d{6,})", cookies)):- if d in history:- hit("account dsid", d)-except (OSError, ValueError):- print("(cookies not checked: the jar is encrypted; set COOKIES to a plaintext copy)")-print("clean" if not found else "FOUND:")-for kind, n in found.items():- print(f" {kind}: {n} e.g. {sorted(examples[kind])[:5]}")diff --git a/docs/research-2026-10-21.md b/docs/research-2026-10-21.mddeleted file mode 100644index 1852d5b..0000000--- a/docs/research-2026-10-21.md+++ /dev/null@@ -1,344 +0,0 @@-# Quince market research (2026-10-21)--Local working notes, never committed. Every number here was checked against the cited source on-2026-10-20/21. GitHub star counts come from the GitHub API on 2026-10-20. Where something could-not be verified, the text says so.-------## 0. The five findings that matter most--1. **The gap is real, and nobody serious occupies it.** Apple's Windows app covers Drive, Photos,- Passwords and Bookmarks, plus Calendar and Contacts through *classic* Outlook only. It has no- Notes and no Reminders app ([Microsoft Store listing data](https://storeedgefd.dsx.mp.microsoft.com/v9.0/products/9PKTQ5699M62?market=US&locale=en-us&deviceFamily=Windows.Desktop)).- Linux has nothing from Apple. Flathub has **no iCloud client at all**: a search for "icloud"- returns rclone GUIs and note apps ([Flathub search API](https://flathub.org/api/v2/search)).- The Linux and Windows projects that do exist are tiny (under 600 stars) or are web wrappers.-2. **Windows is the bigger audience.** PhotoCraft v0.10.0's Windows x64 .msi has 127,546- downloads, against 53,660 for the macOS .dmg and 16,756 for the Linux x86_64 AppImage- ([GitHub releases API](https://api.github.com/repos/storytold/photocraft/releases)).- iDescriptor, an iPhone tool, shows the same split: Windows .msi 7,853 against Linux AppImage- 2,440 ([releases](https://github.com/iDescriptor/iDescriptor/releases)).-3. **The name "Quince" collides with a $10.1B company** that has an App Store app called- "Quince: Luxury Essentials" (9,411 ratings). The .com, .app and .dev domains are all taken.- Apple-variety names (Bramley, Russet) read as an Apple "takeoff". Orchard collides with an- Apple-ecosystem app. Details in §5.-4. **Windows signing is solvable for free.** Two routes: a Microsoft Store MSIX (the Store signs- it, and individual developer accounts are now free), or SignPath Foundation for open source.- Azure Artifact Signing is **not** open to individuals in India: individuals must be in the USA- or Canada ([Microsoft Learn](https://learn.microsoft.com/en-us/windows/apps/package-and-deploy/code-signing-options)).-5. **The main threat is Apple changing its auth.** icloudpd (12.3k stars) was locked out for- about 2 weeks in Dec 2023 when Apple changed sign-in. In Mar–May 2026 it went about 12 weeks- with 2FA codes not arriving ([#729](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/729),- [#1322](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/1322)).- Apple blocked Beeper Mini within days in Dec 2023 because it used "fake credentials"- ([Tom's Guide](https://www.tomsguide.com/news/game-over-apple-blocks-android-imessage-app-beeper-mini)).- Quince must look exactly like a browser on icloud.com and never impersonate a device.-------## 1. Competitors and alternatives--| Option | What it is | Traction (verified) | Good | Bad |-|---|---|---|---|---|-| **iCloud for Windows** (Apple) | Native app from the Microsoft Store | 4.2★ from 32,016 ratings, last updated 2026-09-24 ([Store data](https://storeedgefd.dsx.mp.microsoft.com/v9.0/products/9PKTQ5699M62?market=US&locale=en-us&deviceFamily=Windows.Desktop)) | Drive in File Explorer, Photos, Passwords with browser extensions, official | No Notes and no Reminders. Calendar and Contacts work only "with classic Outlook" (same listing). Requires Windows 11 and Outlook 2021+ for the latest version, and "doesn't support Managed Apple Accounts" ([Apple](https://support.apple.com/en-us/103232)). Recurring photo-sync failures ([Apple Community, 2026](https://discussions.apple.com/thread/256334413); [2023 CPU churn](https://discussions.apple.com/thread/255345048)). A 2022 bug showed users other people's photos ([HN, 377 pts](https://news.ycombinator.com/item?id=33697284)). |-| **icloud.com in a browser** | Apple's web apps | — | Notes, Reminders, Calendar, Contacts, Drive and Photos all work in Firefox, Chrome, Edge and Opera on Windows ([Apple](https://support.apple.com/en-us/105119)) | Not offline, no notifications or tray, no real folder. With ADP on, web access is off by default ([Apple](https://support.apple.com/en-us/102651)). |-| **cross-platform/icloud-for-linux** | Snap that wraps icloud.com | 577★, last push 2025-10-22, snap v0.26 ([GitHub](https://github.com/cross-platform/icloud-for-linux), [Snapcraft](https://snapcraft.io/icloud-for-linux)) | One-command install, lists 12 services | It is only the website. Its HN post got 1 point ([HN](https://news.ycombinator.com/item?id=41308568)). |-| **Other web wrappers** | Tauri/Electron/Chromium shells | taylorivanoff/icloud-notes-windows 41★ ([GitHub](https://github.com/taylorivanoff/icloud-notes-windows)); Swe-HimelRana/icloud-notes 61★ ([GitHub](https://github.com/Swe-HimelRana/icloud-notes)); cgillinger/icloud-electron 2★, where "Sign in with iPhone" works ([GitHub](https://github.com/cgillinger/icloud-electron)) | Apple's own login page, so no password handling | Not offline, no native integration. Flathub rejects "simple web wrapper applications" ([Flathub](https://docs.flathub.org/docs/for-app-authors/requirements)). Most put "iCloud" in the name, which is a trademark problem. |-| **ferdousbhai/icloud-for-omarchy** | **Closest real competitor.** Rust; native Notes (as Markdown, two-way), Photos and Find My; one shared sign-in daemon | 5★, created 2026-09-29; its Show HN got 1 point ([GitHub](https://github.com/ferdousbhai/icloud-for-omarchy), [HN](https://news.ycombinator.com/item?id=49976125)) | Real API, CLI with JSON, signed pacman repo | Arch/Omarchy only, no Reminders/Calendar/Contacts/Drive, "iCloud" in the name |-| **IsmaeelAkram/icloud-linux** | Python FUSE mount of iCloud Drive with a local-first cache | 149★ ([GitHub](https://github.com/IsmaeelAkram/icloud-linux)) | Real folder, conflict copies | Drive only. Polling sync, not push. |-| **icloudpd** | CLI that downloads iCloud Photos | 12,331★, since 2016 ([GitHub](https://github.com/icloud-photos-downloader/icloud_photos_downloader)) | Proven demand; runs on NAS boxes | Download only. Repeated auth breakages (§7). |-| **rclone iCloud backend** | Drive plus read-only Photos, added in v1.69 | rclone itself has 60,442★; the iCloud backend is "Tier 4", i.e. experimental ([rclone docs](https://rclone.org/iclouddrive/)) | SRP sign-in, ADP via PCS cookies | Trust token expires after 30 days ("you will have to reauthenticate"). Photos is read-only. App-specific passwords are not accepted. |-| **CalDAV/CardDAV** (Thunderbird, Evolution, GNOME) | Standard protocols with an app-specific password | — | No password sharing: app-specific passwords exist so that "your Apple Account password can't be stored or collected by the app" ([Apple](https://support.apple.com/en-us/102654)) | Reminders created since the iOS 13 upgrade are **not on CalDAV** ([BusyCal](https://www.busymac.com/docs/faqs/112990-reminders-in-ios-13-and-macos-catalina-drops-support-for-caldav)). No Notes, Drive or Photos. GNOME Settings setup for iCloud is flaky ([GNOME Discourse](https://discourse.gnome.org/t/gnome-settings-carddav-caldav-icloud-account/22859)). |-| **Notes exporters** | kzaremski/apple-notes-exporter, a macOS app | 746★ ([GitHub](https://github.com/kzaremski/apple-notes-exporter)) | — | Needs a Mac. I found nothing on Windows or Linux that reads Apple Notes natively apart from Quince and icloud-for-omarchy. |-| **iDescriptor / libimobiledevice** | USB device tools, not iCloud | iDescriptor 4,664★ (created 2025-07); libimobiledevice 8,275★ ([GitHub](https://github.com/iDescriptor/iDescriptor), [GitHub](https://github.com/libimobiledevice/libimobiledevice)) | Shows that a Rust, privacy-first iPhone tool can grow fast | Not a competitor. They are a **cross-promotion partner**, since their users are Quince's users. |--**Weakness to be blunt about:** Apple's own guidance says third-party apps should use-app-specific passwords so they never see your main password. Quince takes the real Apple ID-password. SRP means the password is never sent, but the user still types it into Quince. rclone-does the same and documents it openly ([rclone](https://rclone.org/iclouddrive/)). Quince must-explain this before sign-in, not hide it (§6).-------## 2. How comparable open-source desktop apps got popular--| Project | Villain / hook | Headline | Channels that worked | Distribution | What hurt them |-|---|---|---|---|---|---|-| **ArtCraft *Craft suite** (Oct 2026) | Adobe's $69.99/mo and its cancellation fees ([Al Jazeera](https://www.aljazeera.com/news/2026/10/14/how-ai-apps-are-offering-free-substitutes-for-big-tech-software)) | "open-source, clean-room reimplementation of Adobe Photoshop, rebuilt in pure Rust" ([README](https://github.com/storytold/photocraft)) | Reddit (u/ai_art_is_art, per Al Jazeera). HN, posted by someone else before he was ready: 180 pts / 246 comments ([HN](https://news.ycombinator.com/item?id=49958850)), plus a second post at 144 pts ([HN](https://news.ycombinator.com/item?id=49981449)). Then press: Phoronix, TechRadar, TechSpot, Al Jazeera. | One repo per app: photocraft 69,392★, artcraft 34,350★, pdfcraft 16,571★, filmcraft 15,261★, wordcraft 14,991★, lightcraft 14,004★, plus about 10 more and a `craft-launcher` (3,613★) ([GitHub API](https://api.github.com/orgs/storytold/repos)). Each release ships msi/portable/dmg/AppImage/deb/rpm/flatpak plus SHA256SUMS. | Shipped as "early alpha". The top HN reply was "very broken software produced by AI… deceptive" ([HN](https://news.ycombinator.com/item?id=49958850)). photocraft has 2,939 open issues (API). A law professor questioned the "clean-room" claim (Al Jazeera). TechRadar's tester: it "failed for me at the very first hurdle" ([TechRadar](https://techradar.com/pro/one-dev-is-recreating-7-adobe-apps-in-rust-for-free-so-i-tested-it-out)). |-| **Cider** (Apple Music client) | No Apple Music app on Linux ([OMG! Ubuntu](https://www.omgubuntu.co.uk/2022/07/cider-is-an-open-source-apple-music-client-for-linux-desktops)) | "open-source, community-oriented Apple Music client" | Linux press (OMG! Ubuntu, Ubunlog). HN posts all scored 1–4 pts ([HN search](https://hn.algolia.com/?q=cider%20apple%20music)). | deb, AppImage, Flathub, AUR, Microsoft Store, winget (OMG! Ubuntu) | Cider 1 is archived (7,122★). Cider 2 went closed-source and paid: **$8.49 on itch.io**, 235 ratings at 4.3 ([itch.io](https://cidercollective.itch.io/cider), [AlternativeTo](https://alternativeto.net/software/cider/about)). Users complained about paying twice and about Linux install bugs (itch comments). Lesson: the name has **no Apple mark** in it, and the disclaimer says it holds no rights to "Apple Music". |-| **LocalSend** | AirDrop works only inside Apple's world | "An open-source cross-platform alternative to AirDrop" | HN, three times: 563 pts (2023), 447 (2024), **923 (2026)** ([HN](https://news.ycombinator.com/item?id=47933208)). 95,038★. | winget, Scoop, Chocolatey, Microsoft Store, Flathub, Snap, AUR, Nix, deb, AppImage. Windows binaries signed by **SignPath Foundation** ([CODE_SIGNING.md](https://github.com/localsend/localsend/blob/main/CODE_SIGNING.md)). | Commenters said it is slower than AirDrop and needs the same network (HN thread). |-| **AppFlowy** | Notion lock-in | "open-source Notion Alternative" | HN 304 pts (2021) ([HN](https://news.ycombinator.com/item?id=29234805)) → 77,607★ | — | Early HN replies mocked its maturity ("roadmap hosted on Trello"). |-| **Ente Photos** | Big-tech photo lock-in. The founder says Apple "locks all of our data to their ecosystem" and that he could not see his own photos on Linux ([It's FOSS](https://itsfoss.com/news/vishnu-ente-founder-interview/)) | "End-to-end encrypted cloud for everything" | Founder interviews; TechCrunch ([TechCrunch](https://techcrunch.com/2025/04/01/ente-wants-to-take-on-google-photos-with-its-privacy-first-photo-storage-service)) → 29,492★ | All platforms | Slow, steady growth. Its Show HN was small (6 pts, [HN](https://news.ycombinator.com/item?id=43516081)). |-| **Zed** | Slow editors | "a collaborative code editor, is now open source" | HN 1,576 pts ([HN](https://news.ycombinator.com/item?id=39119835)) | — | — |-| **Thunderbird revival** | — | — | In-app donation appeals took revenue from about $700k to $9.1M ([LWN](https://lwn.net/Articles/982337/)) | — | — |-| **Joplin** | Evernote price and limit changes | — | Its first Show HN got 7 pts ([HN](https://news.ycombinator.com/item?id=15599908)). Growth came from waves of Evernote refugees ([Joplin forum](https://discourse.joplinapp.org/t/evernote-is-contemplating-limiting-free-account-to-50-notes-we-may-get-a-surge-of-en-refugees/33620)). | — | — |--I could not find verifiable, sourced launch stories for Obsidian, Raycast, Signal Desktop,-Bitwarden or the Proton apps in the time available, so they are left out rather than guessed.--**Patterns that apply to Quince**-- The headline that wins is **"open-source alternative to {thing people already use}"**- (LocalSend, AppFlowy). The iCloud-for-Linux posts that led with "iCloud for Linux" got- 1 point each (Hacker News results above).-- The **villain must be concrete**: a price, a missing app, a lock-in. Quince's is clear:- *Apple ships no Notes or Reminders app for Windows or Linux.*-- **HN launches can happen before you are ready** (ArtCraft's creator: "I wasn't ready to post- this"). Ship the README and the honest status *before* any public link exists.-- **The quality backlash is the main risk.** For an app that holds people's Apple ID and data, one- "it deleted my notes" thread is fatal.-------## 3. Suite architecture and positioning (six apps, one engine)--**How the others do it**-- ArtCraft: one repo, one store page and one site page per app (`getartcraft.com/apps/photocraft`- and so on, 13 pages), plus a launcher, all under one brand ([getartcraft.com/apps](https://getartcraft.com/apps), [craft-launcher](https://github.com/storytold/craft-launcher)).-- Microsoft 365: one installer, a separate Start-menu shortcut per app (Word.lnk, Excel.lnk),- shared account and engine ([Kraft Kennedy](https://www.kraftkennedy.com/office-365-shortcut-name-change/)).--**Recommendation: one binary, one engine and one sign-in, presented as six apps**--*Linux*-- Ship **six .desktop files**: `<appid>.Notes.desktop`, `<appid>.Reminders.desktop`, and so on,- each with `Exec=quince --app notes`. That gives one search hit per app ("Reminders" finds- Quince Reminders), its own icon and its own name.-- Also add `Actions=` to the main entry, which launchers show as a jump list ([freedesktop spec §11](https://specifications.freedesktop.org/desktop-entry/latest/extra-actions.html)).-- `tauri-plugin-single-instance` is already a dependency (src-tauri/Cargo.toml). Use it to route- `--app X` to the running engine so a second sign-in never happens.-- Verify before building: on Wayland the taskbar groups by app_id. Separate per-app taskbar- icons need each window to carry its own app_id, which GTK sets per process. That may force- one lightweight UI process per app on top of the shared engine. Test this on GNOME and KDE.-- Flatpak: each extra .desktop file must be named with the app-ID prefix (my understanding of- Flatpak export rules; confirm with Flathub reviewers).--*Windows*-- **MSI/NSIS (winget, direct download):** create six Start-menu shortcuts, each with its own- AppUserModelID of the form `Company.Product.SubProduct`. Microsoft documents that "SubProduct- allows a main application that consists of several subapplications to provide a separate- taskbar button for each subapplication" ([Microsoft Learn](https://learn.microsoft.com/en-us/windows/win32/shell/appids)).- - MSI sets these through the MsiShortcutProperty table (same page).- - The windows must set the same ID at runtime (`SHGetPropertyStoreForWindow`).-- **Jump list:** add Tasks via `ICustomDestinationList::AddUserTasks` (for example New Note, New- Reminder, Open Drive folder). Keep the list static ([Microsoft Learn](https://learn.microsoft.com/en-us/windows/win32/shell/taskbar-extensions)).-- **Microsoft Store MSIX:** a package can declare up to 100 `<Application>` entries, but- "packages that contain multiple apps won't pass the Store certification process"- ([Microsoft Learn](https://learn.microsoft.com/en-us/uwp/schemas/appxpackage/uapmanifestschema/element-applications)).- So the Store build gets **one** tile, and the six apps are reached through the jump list and- in-app navigation.-- **Drive as a real folder on Windows:** this needs the Cloud Files API. Microsoft says sync- engines "are designed to use the Desktop Bridge as an implementation requirement", which means- package identity ([Microsoft Learn](https://learn.microsoft.com/en-us/windows/win32/cfapi/build-a-cloud-file-sync-engine)).- So MSIX (or a sparse package) is needed for Drive anyway. Test side by side with Apple's own- iCloud Drive sync root.--*Web and SEO*-- One page per app: `/notes`, `/reminders`, `/calendar`, `/contacts`, `/drive`, `/photos`.-- Each page targets the query people actually type, e.g. "Apple Notes on Windows",- "iCloud Reminders on Linux". Use referential wording only (§5).-------## 4. Distribution in practice (2026)--| Channel | Cost / process | Notes |-|---|---|---|-| **Microsoft Store** | Free for individuals since 2025. Verification is by ID plus selfie; no card needed ([Windows blog](https://blogs.windows.com/windowsdeveloper/2025/09/10/free-developer-registration-for-individual-developers-on-microsoft-store/), [AlternativeTo](https://alternativeto.net/news/2025/9/microsoft-finally-drops-microsoft-store-publishing-fee-for-individual-developers-globally)) | With **MSIX, Microsoft re-signs the package: free, worldwide, no SmartScreen warnings** ([Microsoft Learn](https://learn.microsoft.com/en-us/windows/apps/package-and-deploy/code-signing-options)). Tauri natively emits only EXE/MSI. MSI/EXE Store listings must be signed by you, use an offline WebView2 installer and install silently ([Tauri](https://v2.tauri.app/distribute/microsoft-store/)). For MSIX, use Microsoft's **winapp CLI**, which has a Tauri guide and, since 0.3.2, msixbundle output ([Microsoft Learn](https://learn.microsoft.com/en-us/windows/apps/dev-tools/winapp-cli/guides/tauri), [devblog](https://devblogs.microsoft.com/ifdef-windows/windows-app-development-cli-v0-3-2-bundling-support-smarter-initialization-and-more/)). **This is the best route for a student in India.** |-| **Azure Artifact Signing** (formerly Trusted Signing) | $9.99/mo | **Individuals: USA and Canada only.** Organizations: USA, Canada, EU, UK (Microsoft Learn, same page). **Not available to him.** |-| **SignPath Foundation** | Free for OSS ([signpath.org](https://signpath.org/)) | Conditions: an OSI license with no commercial dual-licensing and no proprietary parts; already released; builds from CI; manual approval of every release; MFA; a "Code signing policy" section on the site. The certificate is issued to **"SignPath Foundation"**, not to you ([terms](https://signpath.org/terms)). LocalSend uses it. |-| **OV certificate** | $150–300/yr, hardware token or HSM | Same SmartScreen behaviour as Artifact Signing. **EV no longer bypasses SmartScreen (since 2024)** (Microsoft Learn). |-| **SmartScreen** | — | Reputation builds per signing identity over time; expect warnings at first (Microsoft Learn). Keep one identity across releases. |-| **winget** | Free. PR to microsoft/winget-pkgs; automated antivirus/install scan, then moderator review ([Microsoft Learn](https://learn.microsoft.com/en-us/windows/package-manager/package/repository)) | Needs: HTTPS installer URL straight from the publisher (GitHub Releases is fine), silent install, clean uninstall, one package per PR. Content policy 2.2 covers third-party names and logos. Tools: `wingetcreate` / `komac`. |-| **Scoop / Chocolatey** | Free | LocalSend ships both (README). Low effort once a portable zip exists. |-| **Flathub** | Free | **No iCloud client exists there today.** Rules: app ID `io.github.<user>.<App>` or a domain you control. The name and icon "must not violate any trademarks", and the docs' own example is that a WhatsApp client "cannot have WhatsApp in its name". Thin web wrappers are rejected. Permissions must be minimal and use portals where they exist. Host-component dependencies (FUSE) are case-by-case ([requirements](https://docs.flathub.org/docs/for-app-authors/requirements)). Verification is by website token, DNS, or GitHub repo ownership ([verification](https://docs.flathub.org/docs/for-app-authors/verification)). |-| **AUR** | Free | A PKGBUILD already exists (packaging/aur). Today the AUR has `icloud-for-linux-git` (5 votes) and `icloud-notes-git` (0) ([AUR RPC](https://aur.archlinux.org/rpc/v5/search/icloud?by=name-desc)). |-| **AppImage / .deb / .rpm** | Free (`tauri build`) | Publish SHA256SUMS like PhotoCraft. AppImage plus zsync for updates. |-------## 5. Naming and branding--**Apple's rules (verbatim, [Apple guidelines](https://www.apple.com/legal/intellectual-property/guidelinesfor3rdparties.html))**-- "You may not use or register, in whole or in part, Apple, iPod, iTunes, Macintosh, iMac, or- any other Apple trademark … as or as part of a company name, trade name, product name, or- service name". iCloud, iCloud+, iCloud Drive and iCloud Keychain are on Apple's list- ([Apple trademark list](https://www.apple.com/legal/intellectual-property/trademark/appletmlist.html)).-- "Third parties cannot use a variation, phonetic equivalent, foreign language equivalent,- takeoff, or abbreviation of an Apple trademark for any purpose."-- "You may not use an image of a real apple or other variation of the Apple logo for any purpose."-- **Allowed:** a word mark "in a referential phrase such as 'runs on,' 'for use with,' 'for,' or- 'compatible with'", less prominent than the product name, without implying endorsement.-- **Trade dress:** "You may not imitate the distinctive Apple packaging, web site design, logos,- or typefaces."-- **⚠ Quince today:**- - It ships Apple's own icons. Commit `ea9faea`'s message says "Apple icons", and the files are- in `src/assets/app-icons/`.- - Its design brief is "Liquid Glass / macOS 27 design".- - The icons must be replaced **and removed from git history** before the repo goes public.- - A distinct visual identity also protects against the copying criticism ArtCraft got.--**"Quince" collisions**-- Quince (formerly Last Brand) raised $500M at a **$10.1B valuation** in Mar 2026- ([Yahoo Finance](https://finance.yahoo.com/news/quince-secures-500m-series-e-101840556.html)).-- Its App Store app "Quince: Luxury Essentials" (Lastbrand Inc.) has **9,411 ratings**- ([iTunes Search API](https://itunes.apple.com/search?term=quince&entity=software)).-- A QUINCE word-mark application, serial 99095113 filed 2025-03-20, covers classes 18, 20 and 35- ([Justia](https://trademarks.justia.com/990/95/quince-99095113.html)). I could not confirm the- applicant or whether any QUINCE filing covers class 9 or 42. The USPTO's TSDR needs an API key- and returned 401/429, so **check this yourself on tmsearch.uspto.gov**.-- quince.com (1998), quince.app (2021) and quince.dev (2021) are all registered; the GitHub user- "quince" is taken (RDAP and GitHub API).-- Verdict: the legal risk is probably low (different goods), but the **search risk is fatal**:- "Quince app" will always mean the clothing app.--**Candidates checked** (RDAP domain lookups, GitHub API, App Store search API, Flathub search, AUR)--| Name | .com / .app / .dev | Software collisions | Verdict |-|---|---|---|---|-| Quince | all taken | $10B brand with a 9.4k-rating app | Rename |-| Bramley | all taken (.app/.dev registered Jul 2026; live "Bramley" site) | GitHub user "bramley" (phplist plugins) | Out. It is an **apple cultivar**, which invites the "takeoff" reading. |-| Russet | all taken | App Store "Russet: OpenRouter & Local AI" | Out. Also an apple variety. |-| Orchard | all taken | OrchardCMS 8.2k★; **andrew-waters/orchard 1.7k★, "native UI for Apple Containers"**; AUR orchard-bin | Out |-| Medlar | .dev free; .app = "Medlar — AI Workflow Automation" | — | Out (live software product) |-| Larkspur / Ferrule / Kumquat / Sorrel / Loquat / Mooring / Tessel / Satchel / Almanac / Hearth / Kestrel | all taken | various | Out |-| **Pomander** | .com taken (2002, no site); **.app and .dev unregistered** | Only tamagokun/pomander, a PHP deploy tool (196★); no App Store, Flathub or AUR hit | **Best of those checked** |--**Recommendation: Pomander** (with the "Notes", "Reminders" etc. app names under it), on these-conditions:-1. A USPTO and EUIPO class 9/42 search comes back clean. I could not access either.-2. He likes it.--Why:-- It is a small case that holds precious things, which matches "your library, kept locally".-- The domains are free, it is unique in software stores, and it has no i-prefix and no cloud or- Apple word.-- Honest caveat: the word comes from French *pomme d'ambre* ("apple of amber"). It is not a- translation of Apple's mark, but expect someone to point it out.-- If he rejects it, the fallback is to keep Quince with a qualifier domain. `getquince.app`,- `quinceapp.dev` and `quincedesk.com` are unregistered (RDAP), but this does not fix the- search collision.-------## 6. Copywriting--**Hero headlines** (honest, referential, no endorsement)-1. **"Your Notes and Reminders, finally on Windows and Linux."**-2. "The iCloud apps Apple never made for your PC." (descriptive; "iCloud" used referentially)-3. "Notes, Reminders, Calendar, Contacts, Drive and Photos, as real desktop apps that work with iCloud."-4. "Your iPhone's stuff, on every computer you own."-5. "Open source. Offline first. Talks only to Apple."--**One-liners (README subtitle / store short description)**-- "An open-source desktop client for iCloud: Notes, Reminders, Calendar, Contacts, Drive and- Photos on Windows and Linux. Not affiliated with Apple."-- "Works with your iCloud account. Keeps a full offline copy. Changes arrive in about a second."--**Required disclaimer** (adapted from Apple's own template):-"Pomander is an independent project and has not been authorized, sponsored, or otherwise approved-by Apple Inc. iCloud is a trademark of Apple Inc., registered in the U.S. and other countries and-regions."--**Trust lines. Only use what is literally true, and link each one to code:**-- "Open source, every line." (link to the repo)-- "No servers of ours. The app talks only to Apple's servers." (link to a generated list of hosts)-- "No telemetry, no analytics."-- "Your password never leaves your computer: sign-in uses Apple's SRP protocol, and only a session- token is stored, in your system keyring." Confirm the exact keyring behaviour before writing this.-- "Two-factor authentication is Apple's own flow."-- Say plainly *why* it needs your real Apple ID password and not an app-specific one: Notes,- Reminders, Drive and Photos are not reachable with app-specific passwords. rclone has the same- limitation ([rclone](https://rclone.org/iclouddrive/)).--**README structure** (modelled on PhotoCraft's, minus the hype)-1. Logo (light/dark), name, the one-liner, an honest status badge.-2. One huge real screenshot with synthetic data, captioned "the real app".-3. A row of six app tiles, each linking to its section and site page.-4. Four pillars, each with a number:- - "≈1 s live updates"- - "works offline"- - "6 apps, 1 sign-in"- - "0 servers"-5. Download table: Windows (Store, winget, msi, portable), Linux (Flathub, AUR, AppImage, deb,- rpm), plus SHA256SUMS.-6. "What works / what doesn't" table, including ADP, China accounts and Managed Apple Accounts.-7. Privacy and security section: hosts contacted, keyring, SECURITY.md.-8. FAQ: "Is this allowed?", "Why my real password?", "What if Apple changes something?"-9. Build from source; licence; disclaimer.--**10-second demo video script**-- 0–2 s: A Windows desktop. Start menu, type "Reminders", and **Pomander Reminders** opens.-- 2–5 s: Add "Buy milk" on the PC. Cut to an iPhone in frame: it appears about 1 s later.-- 5–8 s: Tick it on the iPhone; it ticks on the PC.-- 8–10 s: Quick cuts of Notes, Calendar and the Drive folder in Explorer, then end card:- "Open source · Windows & Linux · works with iCloud".-- Real-time footage, no speed-up. Say so in the caption.--**Show HN titles**-- "Show HN: Apple Notes and Reminders on Windows and Linux (open source, Rust)"-- "Show HN: An open-source iCloud client for Linux and Windows – Notes, Reminders, Drive"-- "Show HN: I built the iCloud apps Apple doesn't ship for Windows and Linux"--**Launch-day checklist**-- [ ] Repo public, with history scrubbed (Apple icons; personal fixtures, as in launch-plan §5).-- [ ] gitleaks run clean.-- [ ] Signed Windows build (Store MSIX live, or SignPath) and Flathub/AUR live on the same day.-- [ ] Site with six app pages, the hosts list, SECURITY.md and the disclaimer.-- [ ] A "Known limitations" issue pinned. ADP, China and Managed accounts are stated up front.-- [ ] Show HN, posted Tue–Thu morning US time, with a first comment explaining the- password/SRP design and what's unsupported.-- [ ] r/linux, r/windows, r/iphone, r/apple. Read each sub's self-promotion rule first.-- [ ] Email OMG! Ubuntu, It's FOSS and Phoronix (they covered Cider and ArtCraft).-- [ ] An issue template that asks for the account region and whether ADP is on. **Never ask for a- password or a log that contains tokens.**-- [ ] Be online for 12 hours to answer.-------## 7. Risks--| Risk | Evidence | Mitigation |-|---|---|---|-| **Apple changes auth or 2FA** | icloudpd broken Dec 6–20, 2023 ("most likely related to some changes on Apple side") and Mar 9–May 30, 2026 (2FA codes not arriving after iOS 26.4) ([#729](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/729), [#1322](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/1322)) | **Offline-first is the defence:** the library stays readable when sign-in breaks. Detect auth failures and show a status banner. Keep an auto-update channel so fixes ship in hours. Run a nightly CI probe against a test account. |-| **Apple actively blocks the client** | Apple blocked Beeper Mini for "techniques that exploit fake credentials" ([Tom's Guide](https://www.tomsguide.com/news/game-over-apple-blocks-android-imessage-app-beeper-mini)). I found no record of Apple acting against icloudpd (since 2016), pyicloud or rclone's backend, though not finding one is not proof. | Never spoof device serials or push certificates. Behave as the icloud.com web client. Respect rate limits; no aggressive polling. |-| **ToS** | iCloud terms ban "accessing the Service through any automated means, like scripts or web crawlers" under "interfere with or disrupt" (last revised 2026-09-14, [Apple](https://www.apple.com/legal/internet-services/icloud/en/terms.html)) | User-initiated sync of the user's own data is the normal reading, but it is a grey zone. Say in the FAQ: "uses the same endpoints as icloud.com; at your own risk". Do not offer bulk or scraping features. Not legal advice. |-| **Trademark / trade dress** | Apple guideline text above; Flathub's naming rule | Rename. Own icons and visual identity. Referential phrasing only. Disclaimer everywhere. |-| **Advanced Data Protection** | With ADP, web access is off by default; Notes, Reminders, Photos and Drive become end-to-end encrypted ([Apple](https://support.apple.com/en-us/102651)). icloudpd's ADP issue is still open ([#687](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/687)). rclone requests PCS cookies after 2FA ([rclone](https://rclone.org/iclouddrive/)). | Quince already explains ADP. Publish exactly what works when "Access iCloud Data on the Web" is on and when it is off. |-| **China mainland accounts** | Run by GCBD since 2018 ([CNN](https://money.cnn.com/2018/01/10/technology/apple-china-icloud/index.html)). icloudpd needed a separate domain and still has an open 503 issue ([#392](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/392), [#1256](https://github.com/icloud-photos-downloader/icloud_photos_downloader/issues/1256)). | Mark as "not supported at launch". Detect and show a clear message. |-| **Managed Apple Accounts** | Cannot use Windows iCloud sign-in. iCloud.com access only if the organization allows it ([Apple Business Manager guide](https://support.apple.com/en-gb/guide/business/axm171b3ee95/web)). | Not supported; detect and say so. |-| **Support load** | icloudpd's most-discussed issues are all auth: 87, 47, 43 and 42 comments (GitHub search). | Self-serve troubleshooting page. Issue templates. A Discussions board, not DMs. |-| **The "AI-built" backlash** | ArtCraft's HN reaction (above). | Lead with reliability and verification, not with how it was built. Ship at daily-driver quality, not alpha. |-------## 8. Prioritized action list (by impact on adoption)--1. **Pick the final name now** (recommended: Pomander). Run USPTO and EUIPO class 9/42- searches; register the .app and .dev domains and the GitHub org the same day.-2. **Replace every Apple icon and Apple-imitating asset** with an original identity. Purge them- from git history before the repo goes public.-3. **Ship Windows first-class:** a Microsoft Store MSIX via the winapp CLI (free account, free- signing, no SmartScreen) plus winget. Windows is where the downloads are.-4. **Apply to SignPath Foundation** for the msi and portable builds. Add the required "Code- signing policy" section to the site.-5. **Get onto Flathub**, the first iCloud client there, as `io.github.<user>.<App>` with- minimal permissions and portals. Verify through GitHub.-6. **Present six apps:** six .desktop entries plus Actions on Linux; six Start-menu shortcuts- with SubProduct AppUserModelIDs plus jump-list Tasks on Windows. Test Wayland grouping.-7. **Write the README per §6.** Real synthetic-data screenshots; a "works / doesn't" table.-8. **Publish the trust page:** a list of hosts generated from code, the keyring and SRP- explanation, the honest reason it needs the real password, SECURITY.md.-9. **Harden against Apple auth changes:** a failure banner, a fast auto-update channel, a nightly- CI auth probe against a throwaway account.-10. **Detect and message unsupported cases** (China mainland, Managed accounts, ADP with web- access off) instead of failing silently.-11. **Record the 10-second real-time demo** (§6) and use it on the README, HN and Reddit.-12. **One page per app on the site**, targeting "Apple Notes on Windows", "iCloud Reminders- Linux" and similar searches.-13. **Launch day** per the checklist: every package channel live first, then Show HN (title- framed as an alternative), Linux press, and Reddit.-14. **Cross-promote with neighbours:** iDescriptor and LocalSend users are the same people.- Offer to link to each other.-15. **Plan Drive on Windows through the Cloud Files API** (needs package identity, so it fits- the MSIX route). Until then, say clearly that Drive on Windows is in-app only.diff --git a/docs/skykeep-brief.md b/docs/skykeep-brief.mddeleted file mode 100644index e5bf73f..0000000--- a/docs/skykeep-brief.md+++ /dev/null@@ -1,46 +0,0 @@-# Skykeep: product brief--**What it is:** Skykeep is a free, open-source desktop app that brings your iCloud (Notes, Reminders, Calendar, Contacts, iCloud Drive and Photos) to Linux and Windows computers as fast, native apps.--**The name:** *Sky* is the cloud, where your iCloud lives. A *keep* is the strongest, safest tower of a castle, where precious things are kept. Skykeep means **your cloud, kept safe on your own computer.**--**Who it's for:** People who use an iPhone but whose computer runs Linux or Windows. That includes everyday users who switched from a Mac and miss their notes and reminders, power users who want speed and keyboard control, and developers and privacy-minded people who want open, verifiable software.--**The problem it solves:** Apple only makes iCloud apps for its own devices. On Linux there's nothing official, and on Windows there's only a slow website or a limited app. Skykeep fixes that.--## What it offers-- **Six apps, one engine:** Skykeep Notes, Skykeep Reminders, Skykeep Calendar, Skykeep Contacts, Skykeep Drive and Skykeep Photos. Each opens as its own app, all sharing one sign-in and one sync.-- **Instant:** a copy of your iCloud lives on your computer, so every screen opens immediately, with no loading from the internet.-- **Works offline:** read and edit without a connection; changes are sent when you're back online, and nothing is lost.-- **Two-way sync:** a change on your iPhone shows up in seconds, and a change in Skykeep shows up on your iPhone.-- **Private by design:**- - your password never leaves your computer;- - there's no Skykeep account and no Skykeep server;- - it talks only to Apple;- - your sign-in is stored in your system's keyring;- - your data stays yours.-- **Fast and native:** built in Rust, a modern, high-performance programming language, rather than as a heavy web wrapper.-- **Feels at home:** a calm, polished design, light and dark mode, system notifications with sounds and action buttons, a tray icon, quick capture for a new reminder or note from anywhere, results in your desktop's search, and opening calendar and contact files.-- **Your data, exportable:** export everything to open formats (Markdown, calendar files, contact cards) whenever you want.-- **Open source:** anyone can read the code, check the privacy claims, and contribute.--## Per app-- **Notes:** rich text, checklists, tables, pictures and drawings, folders, pinned notes, search, Markdown export.-- **Reminders:** lists and groups, smart lists, tags, sections, due dates and repeating reminders, flags and priorities, alerts with Complete and Snooze.-- **Calendar:** day, week, month and year views, drag to create and move events, repeating events, alerts, time zones, a birthdays calendar, calendar subscriptions.-- **Contacts:** every field, groups, editable addresses, import and export of contact cards.-- **Drive:** browse, upload, move, rename, quick preview, keep files for offline use.-- **Photos:** your whole library, albums, favourites, videos and Live Photos, search, download.--## Personality-Calm, trustworthy, crafted and quietly premium. Confident but never loud. Simple enough for a beginner, fast enough for an expert, open enough for a developer.--## Taglines-- *Native iCloud apps for Linux and Windows.*-- *Your cloud, kept safe on your own computer.*-- *Instant. Offline. Private. Open source.*--## Platforms-Linux (every major distribution and desktop) and Windows. Free and open source.--**Not affiliated with Apple.** Skykeep is an independent project that works with iCloud.diff --git a/docs/sync-roadmap.md b/docs/sync-roadmap.mddeleted file mode 100644index ebc893b..0000000--- a/docs/sync-roadmap.md+++ /dev/null@@ -1,70 +0,0 @@-# Sync engine: Dropbox / Google Photos-grade roadmap (assessment 5 Nov 2026)--Read-only assessment of main, benchmarked with the real quince-core schema on synthetic data-(tmpfs, release build). Correctness is strong (outbox in the same transaction, idempotent sends,-moreComing/expired tokens handled, prune only after a complete walk, checksummed uploads,-conflicted copies, crash-safe caches). What breaks for heavy users is cost per operation: linear-in collection size, often under the single writer lock.--## Blockers, worst first-1. Photo thumbnail fetches take the writer lock (src-tauri/src/photos.rs ~391, ~847); a sync round- holds it 2.9–8.3 s and photo_counts() costs 4.4 s at 1M, up to 10 rounds per refresh.-2. Every mutation in the mounted Drive folder re-lists the whole folder synchronously- (fuse.rs:304 change, :496 relist): 1.4 s at 10k items, 19.6 s at 100k → rm -rf of 10k files ≈ hours.-3. Opening a Drive file read-write without O_TRUNC blocks a FUSE thread for the whole download- (fuse.rs:749–787, rt.block_on); only 4 FUSE threads (fuse.rs:1884).-4. Re-storing unchanged rows rewrites the FTS index (ON CONFLICT DO UPDATE fires AFTER UPDATE OF- triggers, schema.rs:738): 50k unchanged notes = 27 s. Fix: WHERE change_tag IS NOT excluded…-5. Daily full walk of every service (refresh.rs:89 FULL_SYNC_EVERY): ~2.2M records / ~4,400- requests a day at 1M photos; new photos wait for the walk.-6. Notes/Reminders walks cap at 100k records and buffer everything in memory (cloudkit.rs:18,21);- above the cap a full walk never completes, deletions behind an expired token never pruned.-7. Release builds keep no sync log (quiet! debug-only).--## Measured (100k / 1M photos)-put_photos first sync 5.6 s / 101 s · re-store 50k 6.5 / 8.3 s · photo_index 109 ms / 1.99 s ·-index JSON to window 5.1 MB / 50.9 MB · photo_page middle 56 ms / 994 ms (OFFSET) ·-photo_counts 257 ms / 4.4 s · photo_months 206 ms / 2.9 s · search_photos (LIKE) 290 ms / 4.3 s ·-FTS search 8 / 533 ms · DB 87 / 694 MB. Drive folder 10k/100k: store 1.0/10.7 s, relist 1.4/19.6 s,-children read 89 ms/1.27 s. 50k notes: first store 14.5 s, unchanged re-store 27.3 s, DB 803 MB.-Recents/Favorites/Videos have no index (temp B-tree sort).--## Roadmap (independently shippable, each with its scale/chaos test)-1. Stop FTS churn (upsert WHERE / trigger WHEN). Test: unchanged re-put 27 s → <1 s.-2. Thumbnail fetches off the writer lock (Reader connection); no photo_counts in the pass report.- Test: 1M DB + concurrent pass, thumbnail p99 < 50 ms.-3. Photo indexes (recents/favorites/videos), keyset paging on (taken_at,id), maintained counts- table, FTS photo search. Test: every call < 20 ms at 1M.-4. Mounted folder: async optimistic mutations, no relist per change; open-for-write without- block_on. Test: rm -rf / mv of 10k files < 60 s, constant relists.-5. Privacy-safe rotating sync.log (JSONL), Sync Activity panel (pending/active/paused/failed,- Pause/Cancel), health chip.-6. Streamed zone cursors for every service (ZoneCursor table, per-page transactions, no cap) and- a separate reconcile cursor with seen_epoch pruning; drop the daily full walk; desiredKeys for- reconcile; Contacts per-card diff; bulk deletes from the local mirror. Test: 2.5M-record- wiremock with token expiry mid-walk, RSS cap, no transaction > 200 ms.-7. Batched records/lookup (200) for photo links + viewport priority scheduler (visible > overscan- > idle), cancellable.-8. Windowed photo grid (recycled tile pool) + compact binary index (~4 MB at 1M vs 51 MB JSON).- Test: Playwright fling across 1M, bounded DOM, ≥ 55 fps.-9. Outbox v2: next_at, depends_on, group_id, lanes; per-record ordering; 200-op CloudKit batches;- Drive and Photos operations moved into the outbox; per-change backoff + jitter; poison items- in a Pending panel. Test: seeded model + kill -9 chaos (no loss/dup, per-record order).-10. TransferManager: durable transfers table; resumable parallel Range downloads (4–8 chunks),- FUSE read-ahead, version pinning; journaled uploads with per-file retry; priority classes;- bandwidth token bucket; verify downloads with Apple's salted SHA-1. Test: fault-injecting- proxy, 5 GB sparse files, resume not restart.-11. Cache index table (cache_entries): O(1) accounting, free-space floor, refuse pins without- room, sharded evictable thumbnail tiers, pinned "keep offline" albums, checksum verification.-12. Video through the sparse chunk cache with seek (Range to Apple).-13. Resilience: shared AppleBudget (token bucket + per-host breaker), logind PrepareForSleep- listener, reauth barrier that pauses transfers. Test: 5xx/429 storms + simulated suspend.-14. Windows Drive/Photos folder via the Cloud Files API (cfapi) on quince-vfs's Remote/Store/Cache- split; longPathAware manifest.-Also: journal each step of a Drive replace (sent → trashed → renamed); notes > 700 KB via-TextDataAsset; index photo_album_items(asset).--## Unknowns (one live check each)-package_token downloads (bug-hunt commit b26489d addresses it) · Range on Photos video URLs ·-Live Photo pairing via the web uploader · partial Contacts changes · Shared Library zones-(SharedSync-*) · moov-atom placement in iPhone videos · crash mid-Drive-replace recovery.