Yapped 1.1.2 Apr 2026

All flags are additive to the existing CLI – they can be combined with --watch , --output , etc. | Situation | Handling | |-----------|----------| | Huge files (≥10 MB) | Debounce parsing to 300 ms and fall back to “preview disabled – file too large” banner. | | Invalid schema | Show a non‑intrusive warning in the preview header; continue editing without validation. | | Multiple documents in a single file (YAML --- separator) | Render each document as a separate top‑level node; allow per‑document schema selection via a tiny dropdown. | | Binary or non‑text files | Detect via MIME sniffing; hide preview and show a “cannot preview binary data” notice. | | Performance on low‑end machines | Offer --preview=off as fallback; the UI component can be lazy‑loaded only when the flag is present. | 6. Sample User Flow (Markdown for Docs) ## Live‑Preview Demo

| Angle | Talking point | |-------|---------------| | **User‑experience** | “Our users spend ~30 % of their time toggling between editor and external linter. Live‑preview eliminates that friction.” | | **Competitive edge** | “Competitors like `vscode-yaml` require a full IDE. yapped stays lightweight yet now offers the same instant feedback.” | | **Revenue / adoption** | “A polished visual mode makes yapped more attractive for non‑dev teams (ops, data‑science), expanding our user base.” | | **Future‑proofing** | “The preview framework is a solid foundation for upcoming features: schema‑guided autocompletion, inline documentation, or even a “run‑as‑test” button.” |

### 7. How to Pitch It Internally

It’s designed to be valuable to both existing users and newcomers, while staying modest enough to ship quickly in a point‑release. 1. What it does When a user opens a YAML (or JSON) file in yapped’s editor pane, a live preview pane is displayed side‑by‑side that:

> **Add a side‑by‑side, real‑time “Live‑Preview” tree view (with validation, diff, search & export) to yapped 1.1.2** – a low‑effort UI boost that instantly shows users the effect of every edit, catches schema errors early, and makes config‑review workflows dramatically faster. yapped 1.1.2

~12 person‑days (≈2 weeks for a single dev, or 1 week with a small pair). 4. API / Configuration Additions | Flag / Setting | Description | Default | |----------------|-------------|---------| | --preview / -p | Launch yapped with the live‑preview pane enabled. | false | | --schema <path> | Path to a JSON‑Schema or OpenAPI spec for validation. | null | | --preview-theme <light|dark|auto> | Choose preview styling. | auto | | --diff-on-save | Enable diff highlighting after each save. | true |

If you’d like a more detailed design (e.g., component tree, CSS themes, or a sample PR checklist), just let me know and I’ll draft it! All flags are additive to the existing CLI

## ✅ TL;DR – One‑sentence summary