History / FAQ

Manual: Add: Recipe / Add: Equipment button wording

skialpine committed Oct 6, 2026

Platform minimums, Nearby devices permission, Tailscale startup note - iOS 18 / iPadOS 18 and macOS 14.4 minimums in Installation; widget pages corrected from iOS 17 to iOS 18. - Android 17+ Nearby devices permission (web server, MQTT, WiFi scale, device transfer). - Remote Access: "Funnel is on — waiting for Tailscale" right after startup is normal and clears by itself.

skialpine committed Oct 3, 2026

Manual/FAQ: a ratio survives a switch only within a drink kind; Find page & get info A dialed ratio now carries only to another espresso, filter or tea profile; switching kind drops it and the recipe's or bean's saved ratio applies (Kulitorum/Decenza#1941, #1945). Also documents the Find page & get info button for a bag with no URL (#1923). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

skialpine committed Sep 14, 2026

Manual/FAQ: the steam heater's two settings and the built-in Heater off Rewrites "Steam Heater Management" around the two settings that replace "Keep heater on when idle" — Keep warm when idle, and Let the recipe decide — with a four-state table for what they add up to, and notes that selecting Heater off in the pitcher row overrides both. Also: recipe activation and the milk-hold bullet now describe the recipe deciding the heater; the presets paragraph covers the built-in Heater off entry being unrenameable and unremovable; the Machine settings contents list names both switches; and the settings path is corrected to "Settings → Machine → Steam Heater" (the card is labelled Steam Heater, not Steam). Screenshots: settings-machine-1 and -2 retaken with the new switches, settings-machine-3 added for the bottom of the tab (Shot Map, Maintenance, Screen Zoom, Simulation Mode), and settings-steam-heater added as a crop of the Steam Heater card beside the section that explains it.

skialpine committed Aug 10, 2026

Manual: recipe-first rewrite, trim 13%, refresh screenshots Restructure the manual around recipes as the primary way the app is used, cut accumulated verbosity, and move troubleshooting into the FAQ. Structure - Recipes promoted to chapter 4, Profiles to 5; Profiles now reads as the engine inside a recipe rather than the main entry point. - New chapter 5 "Beans, Equipment and Grind" — these lived inside "The Idle Screen", where nobody would look for them. - Idle screen leads with the recipes-first layout instead of apologising for Profiles-led screenshots. - Bean Base linking was documented in four places; now one, with pointers. - Auto-Load Profile and Auto-Load Recipe merged into one section. - Chapter anchors rewritten across Manual, FAQ and Quick-Start. Trimming (25,963 -> 22,494 words) - Dropped changelog-style prose explaining what the app used to do, stale 1.x version gates, and meta-commentary about the wiki itself. - Installation chapter collapsed to a pointer at the Installation page. - Troubleshooting moved to the FAQ, which is now the troubleshooting page. Corrections found by checking screenshots and source against the text - Bottom bar is Sleep/Flush/History/Equipment/Profiles/Settings, not "Profiles, History, Favorites, and Settings". - Pill rows page by available space, not "five at a time". - Background chooser has four sections, not two. - settings-history-data.png and settings-calibration-2.png had swapped contents; the Data Management chapter was showing the Themes tab. - Settings tab is "History & Data", not "Data" (13 occurrences). - D-Flow and Advanced editor docs were nested under "Renaming Profiles". - FAQ contradicted the manual on AI provider choice, search syntax, MCP version, language path, and the ratio dialog. Newly documented - Quality dots on shot history rows (ShotHistoryPage.qml). - Backup time, retention, location, and Export Shots to File. - Shot Map manual city; 97 MCP tools. MCP chapter now leads with Remote Access, states that only one of the two setups is needed, and calls out that it is the only route reaching the mobile and tablet apps. Screenshots: 12 refreshed or added, 4 obsolete files removed.

skialpine committed Aug 2, 2026

Document the dose precedence ladder: recipe -> bean -> profile Manual's Recommended Dose section and the matching FAQ entry both said a profile's recommended dose is applied whenever that profile is selected. As of the dose-source-precedence change an active recipe or a dosed bean outranks it, so loading a profile leaves the dose alone. Adds the ladder, why it exists (a dose edit writes through, so the old behaviour rewrote what the bean or recipe remembered), the skip-if-empty rule, and where to actually change a dose. Also adds an FAQ entry for the symptom users will hit first: 'I loaded a profile with a recommended dose and my dose didn't change.' Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

skialpine committed Jul 26, 2026

Document the tablet setup Remote Control needs, and stop calling it browser control

skialpine committed Jul 25, 2026

Manual/FAQ: document the live steaming screen; fix stale stop-and-purge setting Adds a "The Live Steaming Screen" section covering the on-screen controls during a steam session -- countdown, +/-5s, live flow slider, preset pills, Purge, Stop, and the chart toggle. Purge and Stop are now available in both the timer and chart views. The manual previously documented the steaming workflow but never this screen. Also corrects four references to a setting that no longer exists. The docs told users to enable "Headless - Single press to stop & purge" to combine stop and purge. That option was unified into steamTwoTapStop, surfaced in the app as "Two-tap to stop steaming" with the opposite polarity -- single press is now the default and the toggle SPLITS the steps. As written the docs pointed at a name users cannot find, to enable behaviour they already have.

skialpine committed Jul 20, 2026

2.0 docs: Recipes section, Quick Start, and refreshed screenshots Manual: - New §5 Recipes (whole-drink one-tap model, recipes-first idle, wizard, tea, search-first/URL-backup bean lookup, bag links/relink, activation, Shot Plan/Recipe Card widget); renumbered §6–§21. - Bean Bags rewrite (Add Coffee/Tea, thumbnails, revert-to-canonical, URL pull, archive-vs-delete); new Bean Base (canonical linking) subsection. - Equipment: baskets + puck prep. Steam: Live Steam Coaching. AI: full model roster (Sonnet 4.6/5, GPT-5.4 mini/full, Gemini 2.5/3.5 Flash). - Settings: °C/°F toggle. MCP: recipe/bag/equipment tools. Temp override documented as a per-step delta. §3 notes the recipes-first default. New Quick-Start page (install → connect → first drink via a Recipe), linked from Home and a banner atop the Manual. FAQ: Recipes & Beans section and updated idle-screen answers. Home: dropped "coming soon". Screenshots captured from the macOS app: 17 new + 3 refreshed. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

skialpine committed Jul 10, 2026

manual: add Section 15 — Home Screen Widget (new in v1.7.6) Documents what the widget shows, how to add it on iOS and Android, the connection/staleness behaviour, refresh model per platform, and troubleshooting. Read-only widget, opens the app on tap. Inserts as new section 15 between Automation and Data Management; the remaining sections (Data Management, Settings, Themes, Accessibility, Troubleshooting) shift to 16-20. Updates Manual.md internal anchor links and the FAQ.md cross-references to match. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

skialpine committed May 19, 2026

docs(manual): promote MCP Server to its own section §12 with expanded coverage The MCP Server was buried as a subsection under §11 AI Assistant. Promote it to its own top-level §12 and expand the body to cover the full capability surface: BLE device management, full settings parity across every Settings tab, housekeeping (backup, theme, MQTT, debug log), live SSE resources for push notifications, hybrid in-app/chat confirmation, steam health metrics, and the actual security limits (60/min, 8 sessions, 4 SSE, 30-min idle). Renumbered sections 13–19 in the body and TOC, and updated cross-references in Manual.md (3 links) and FAQ.md (10 links) to match. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

skialpine committed Apr 27, 2026

docs: add headless machine section to Manual and FAQ - Manual §5: add "Headless Machines (no GHC)" subsection covering on-screen pill interaction model, Mini GHC layout widget, keyboard shortcuts, single-press stop+purge, and web/Pocket remote control - FAQ: add dedicated headless Q&A in Idle Screen section - Fix remaining "Settings → Preferences" → "Settings → Machine" paths for auto-flush and heater settings in Manual steam section Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Jeff Heller committed Apr 23, 2026

docs: accuracy pass on FAQ and Manual from agent review FAQ fixes: - Scale scan path: "Bluetooth tab / Scan for scales" → "Connections / Scan for Devices" - Scale list: add Atom Heart Éclair, Difluid, Hiroia, Solo Barista, Timemore, Varia Aku - Teclast: remove stale "somewhat slow" note (memory leak fixed) - Linux: remove incorrect "occasionally delayed" CI note - Auto-Favorites: remove wrong "Settings → Shot History" path - SAW calibration path: "Settings → Options" → "Settings → Calibration → Weight Stop Timing" - Shot comparison: "up to 3 shots" → sliding 3-shot window with navigation - Steam auto-flush location: "Settings → Preferences" → "Settings → Machine" - Auto-Wake location: "Settings → Preferences" → "Settings → Screensaver" - MCP version: v1.6.0 → v1.5.5 - Screensavers: remove non-existent CRT/Pip-Boy type, fix list - MQTT settings location: "Settings → Options" → "Settings → MQTT" Manual fixes: - Auto-Favorites: remove wrong Settings path - Shot comparison: update "up to 3" to sliding window description - Screensavers: replace non-existent CRT/Pip-Boy with Strange Attractors - Custom text variables: add missing %PROFILE%, %DOSE%, %RATIO%, %TIME%, %DATE% - MCP shot comparison description updated - Scales appendix: add 6 missing scale models - AppData paths: Kulitorum → DecentEspresso (matches setOrganizationName in main.cpp) - Font Scaling: remove non-existent "Settings → Accessibility" path Home.md: - Replace old intro video with Decenza 1.5.5 intro video - Add Layout Editor walkthrough video - Add community tour video (March 2026) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Jeff Heller committed Apr 23, 2026

fix(faq): correct Visualizer credentials — username/password not API key, Settings → Visualizer not History

Jeff Heller committed Apr 23, 2026

docs(faq): add cross-reference links to Manual sections Each FAQ section now opens with a → Manual pointer to the corresponding manual section. Key individual answers (SAW, MCP, layout editor, scales) also link directly to the relevant manual subsection.

Jeff Heller committed Apr 23, 2026

Add Home page and FAQ (compiled from 1,100+ community comments)

Jeff Heller committed Apr 23, 2026

Initial Home page

skialpine committed Apr 23, 2026