performance.mdx

performance.mdx (1752B)
      1 ---
      2 title: "Performance & Benchmarks"
      3 sidebarTitle: "Performance & Errors"
      4 ---
      5 
      6 import Copyright from "/snippets/copyright.mdx";
      7 
      8 By stripping away Webpack overhead, Virtual DOM reconciliation, and heavy language servers, Veyrix operates on a fraction of the hardware requirements of modern cloud IDEs.
      9 
     10 | Environment | Base RAM (idle) | Editor engine | Time to interactive |
     11 |---|---|---|---|
     12 | Veyrix IDE | ~30MB – 42MB | Ace Editor (vanilla) | < 0.5 seconds |
     13 | VS Code Web | ~350MB+ | Monaco + Web Workers | 2.5 – 4 seconds |
     14 | CodeSandbox | ~500MB+ | Monaco + Container VM | 4 – 8 seconds |
     15 
     16 ## Why it's better for mobile / low-end devices
     17 
     18 - **Debounced I/O** — IndexedDB writes are debounced by 500ms, ensuring zero main-thread blockage during rapid typing
     19 - **No Monaco overhead** — Monaco is powerful but struggles on low-end Androids due to heavy worker threading; Ace Editor is substantially lighter
     20 - **Visual viewport anchoring** — PWA implementations often suffer layout thrashing when the soft keyboard appears; Veyrix anchors directly to the `window.visualViewport` API, freezing the reflow
     21 
     22 # Error Handling Behavior
     23 
     24 ## "Incognito" / Private Mode restraints
     25 
     26 Safari and Firefox frequently restrict or completely block IndexedDB access in Private Browsing. If `DB.init()` fails, Veyrix degrades gracefully to an in-memory volatile state. A UI toast warns the user that files will be lost when the tab closes, prompting manual downloads.
     27 
     28 ## DOMException: QuotaExceededError
     29 
     30 Triggered when the device runs out of disk space, or the browser's origin quota is exceeded. Veyrix catches this in the `DB.save()` promise rejection, halting autosave and notifying the user to clear space or delete older snapshots.
     31 
     32 <Copyright />