usage-guide.md (2489B)
1 --- 2 label: Usage Guide 3 icon: checklist 4 order: 590 5 --- 6 7 # Comprehensive Usage Guide 8 9 How to operate Veyrix IDE effectively — file management, keyboard shortcuts, versioning, and sharing. 10 11 ## 1. Managing files 12 13 **Creating a new file** — click the `+` icon in the sidebar (or the floating button on mobile). Type your desired filename including the extension (e.g. `script.js`, `index.html`, `Dockerfile`). Veyrix auto-detects the language from the extension for syntax highlighting. Files without an extension are allowed. 14 15 **Importing an existing file** — click the Open File icon (folder with up arrow) in the top navigation bar, or press `Ctrl+O`. Select any valid text, configuration, or code file. Binary files (images, compiled `.exe` files) are rejected. 16 17 **Renaming or deleting** — hover over any file in the left sidebar and click the three-dots (`...`) icon. From the dropdown: Rename, Delete, or Download that specific file. 18 19 ## 2. Editing & formatting 20 21 **Autosave & manual save** — Veyrix caches your typing to the local database 500ms after you stop typing. A blue dot next to the filename in the top bar indicates unsaved changes. Force a save any time with `Ctrl+S` or the floppy disk icon. 22 23 **Code formatting (Prettier)** — press `Alt+Shift+F` to beautify code (fix indentation and spacing). Only supported for recognized web languages: HTML, CSS, JS/JSX, JSON, Markdown. 24 25 ## 3. Snapshots (local version history) 26 27 Veyrix has a built-in "Time Machine" for your files. 28 29 - **Save a snapshot** — click the bookmark icon top right; saves a frozen copy of your code at that moment 30 - **Limits** — max 5 snapshots per file; saving a 6th prompts you to permanently delete the oldest one 31 - **Restore** — click the clock icon to view history; clicking "Restore" on an older version immediately replaces your current editor content with the historical code 32 33 ## 4. Sharing code 34 35 Click the Share icon to open the sharing modal. Three options: 36 37 **Fast local share** — compresses your entire file into the URL; no data leaves your browser. Best for small snippets, since large files produce very long URLs. 38 39 **Cloud share** — uploads your code to an anonymous, secure Firebase database and generates a short link. Can optionally be protected with a password (hashed client-side — see [Security & Threat Model](security.md)). 40 41 **Share via device** — uses your phone or computer's native share menu (AirDrop, WhatsApp, Email, etc.) to send the raw text of your code.