update docs (#6)

* update ui to latest

* 🚚 smaller

Signed-off-by: peter szemraj <[email protected]>

* 📝 validate/update to current

Signed-off-by: peter szemraj <[email protected]>

* 🎨

Signed-off-by: peter szemraj <[email protected]>

* Make GUI the primary quick-start path in docs

Highlight cargo run with gui features; add --release optimization note.
Update README and dev guide to establish as recommended entry point.

Signed-off-by: peter szemraj <[email protected]>

---------

Signed-off-by: peter szemraj <[email protected]>

Author: pszemraj

README.md

@@ -4,35 +4,35 @@
 
 A fast, localhost-only pastebin with a modern editor, built in Rust.
 
-![LocalPaste Screenshot](assets/ui.png)
+![LocalPaste Screenshot](assets/ui.jpg)
 
 ---
 
 ## Features
 
-- **Native Desktop App** – egui-based editor with palette-matched theming
-- **Automatic Language Detection** – cached detection + offline syntax highlighting
-- **Auto-Save** – debounce to disk; manual export for sharing
-- **Semantic Naming** – auto-generates memorable names (e.g., “mythic-ruby”)
-- **Folder Organization** – nested folders with drag & drop
-- **Keyboard Shortcuts** – Ctrl+N (new), Ctrl+K (search), Ctrl+D (delete)
-- **Zero Runtime Dependencies** – single binary, embedded Sled database
+- **Native Desktop App** - egui-based editor with palette-matched theming
+- **Automatic Language Detection** - cached detection + offline syntax highlighting
+- **Auto-Save** - debounce to disk; manual export for sharing
+- **Semantic Naming** - auto-generates memorable names (e.g., "mythic-ruby")
+- **Folder Organization** - nested folders with drag & drop and cycle-safe parenting
+- **Keyboard Shortcuts** - Ctrl+N (new), Ctrl+K (search), Ctrl+D (delete)
+- **Zero Runtime Dependencies** - single binary, embedded Sled database
 
 ## Quick Start
 
 LocalPaste.rs provides multiple ways to interact with your pastes:
 
-- `localpaste-gui` – Native egui desktop application (primary experience)
-- `localpaste` – Axum HTTP API + legacy browser UI
-- `lpaste` – Command-line interface for terminal usage
+- `localpaste-gui` - Native egui desktop application (primary experience)
+- `localpaste` - Axum HTTP API + legacy browser UI
+- `lpaste` - Command-line interface for terminal usage
 
 ### Run the Desktop App
 
 ```bash
-cargo run --bin localpaste-gui --features gui --release
+cargo run --bin localpaste-gui --features="gui"
 ```
 
-The compiled binary `target/release/localpaste-gui` can be launched directly.
+Add `--release` once you’re ready to ship or benchmark; during development the command above starts the latest GUI build immediately.
 
 ### Run the Web Server / API
 

assets/ui.jpg

@@ -2,7 +2,7 @@
 
 ## Project Structure
 
-`
+```text
 localpaste.rs/
 ├── Cargo.toml
 ├── src/
@@ -19,7 +19,7 @@ localpaste.rs/
 ├── docs/                       # Project documentation
 ├── assets/                     # Screenshots / design references
 └── target/                     # Build artifacts (git-ignored)
-`
+```
 
 ## Key Design Decisions
 
@@ -54,8 +54,11 @@ RESTful endpoints:
 - `GET /api/search?q=` - Search pastes
 - `POST /api/folder` - Create folder
 - `GET /api/folders` - List folders
+- `PUT /api/folder/:id` - Update folder (rename or re-parent; rejects cycles)
 - `DELETE /api/folder/:id` - Delete folder
 
+Folder operations enforce tree integrity: the API returns `400 Bad Request` if a move would introduce a cycle in the hierarchy.
+
 ## Development Workflow
 
 ### Building the Project
@@ -80,7 +83,8 @@ cargo build --release --bin lpaste
 
 ```bash
 # Run the desktop app
-cargo run --bin localpaste-gui --features gui --release
+cargo run --bin localpaste-gui --features="gui"
+# (append --release when you need an optimized build)
 
 # Run the server/API (legacy web UI)
 cargo run --bin localpaste --release

assets/ui.png

@@ -16,4 +16,4 @@ These canonical values are applied inside `src/gui/mod.rs` and should be reused
 | `COLOR_DANGER`         | `#F85149` | Destructive actions        |
 | `COLOR_BORDER`         | `#30363D` | Divider strokes            |
 
-The screenshot at `assets/ui.png` shows the original layout these colors came from.
+The screenshot at `assets/ui.jpg` shows the original layout these colors came from.